Skill: haibaraaiaptx/remote-console (version 1.0.0)

--- name: remote-console description: | 通过手机/浏览器远程访问主机上的 Claude Code 或其他 CLI 工具。使用此技能来启动、停止和管理远程开发环境。 **必须触发此技能的场景**： - 用户提到"远程控制台"、"远程终端"、"远程开发"、"ttyd"、"SSH 隧道" - 用户想用手机/平板访问电脑上的开发环境 - 用户提到"移动端编程"、"手机写代码"、"远程编码" - 用户要添加/删除/查看项目路径 - 用户要添加/设置/查看命令配置 - 用户要关闭或停止远程控制台 - 用户询问如何在外出时继续编程 **不要触发**：普通 SSH 连接、服务器部署、日志查看等非远程控制台任务。 --- # 远程控制台 Skill 通过 ttyd + SSH 隧道，在手机浏览器中访问主机上的 Claude Code。 ## ⚠️ 重要：优先使用 Python 脚本 **所有操作必须通过 Python 脚本执行，禁止直接拼接 Shell 命令！** 脚本目录：`./scripts/`（与 SKILL.md 同目录） ### 前置依赖 ```bash pip install psutil ``` --- ## 快速命令 ### 启动远程控制台 ```bash python ./scripts/start_console.py <项目名> python ./scripts/start_console.py <项目名> -c <命令名> python ./scripts/start_console.py --path /path/to/project ``` ### 停止远程控制台 ```bash python ./scripts/stop_console.py ``` ### 检查状态 ```bash python ./scripts/check_tunnel.py python ./scripts/check_tunnel.py --json ``` ### 验证配置 ```bash python ./scripts/validate_config.py ``` --- ## 用户操作指南 ### 1. 启动远程控制台 **触发**: "打开 {项目名} 的远程控制台" **执行**: ```bash python ./scripts/start_console.py {项目名} ``` **返回格式**: ``` ✅ 远程控制台已启动 📁 项目：{项目名称} 🔗 访问地址：http://{host}:{port} 📂 工作目录：{project.path} 🚀 启动命令：{command} ``` ### 2. 停止远程控制台 **触发**: "关闭远程控制台" / "停止远程终端" **执行**: ```bash python ./scripts/stop_console.py ``` ### 3. 检查状态 **触发**: "远程控制台状态" / "检查隧道" **执行**: ```bash python ./scripts/check_tunnel.py ``` ### 4. 验证配置 **触发**: "验证远程控制台配置" **执行**: ```bash python ./scripts/validate_config.py ``` ### 5. 项目管理 **查看所有项目**: ```bash python ./scripts/start_console.py ``` --- ## 配置文件 配置文件：`./config.json`（与 SKILL.md 同目录） ```json { "servers": { "default": { "name": "my-server", "host": "your-server.com", "port": 2222, "user": "your-username", "ssh_alias": "ssh-config-alias" } }, "ttyd": { "port": 7681, "path": "ttyd", "options": "-W -t fontSize=16" }, "defaults": { "command": "claude", "server": "default" }, "commands": { "claude": "claude", "claude-bypass": "claude --dangerously-skip-permissions", "codex": "codex" }, "projects": { "项目名": { "path": "/path/to/project", "command": "claude-bypass" } } } ``` --- ## 预定义命令 | 名称 | 实际命令 | 说明 | |------|---------|------| | claude | `claude` | 标准 Claude Code | | claude-bypass | `claude --dangerously-skip-permissions` | ⚠️ 跳过权限检查 | | codex | `codex` | OpenAI Codex | | cursor | `cursor-agent` | Cursor Agent | --- ## ⚠️ 安全警告 ### claude-bypass 命令风险 `claude-bypass` 使用 `--dangerously-skip-permissions` 标志，会**跳过所有权限检查**。 **仅在以下情况使用**： - ✅ 完全信任的私有网络环境 - ✅ 个人非敏感项目 - ✅ 你了解并接受所有操作将自动执行 **绝不使用于**： - ❌ 生产环境或敏感数据处理 - ❌ 公共或共享网络 - ❌ 不确定安全性的项目 --- ## 故障排查 | 问题 | 解决方案 | |------|---------| | 链接无法访问 | 运行 `check_tunnel.py` 检查隧道状态 | | 配置错误 | 运行 `validate_config.py` 验证配置 | | 端口被占用 | 运行 `stop_console.py` 先停止再启动 | --- ## 架构 ``` 手机浏览器 → 服务器:{port} → SSH 隧道 → 主机 ttyd → Shell + Claude Code ``` --- ## 首次使用检查清单 1. **安装依赖**: `pip install psutil` 2. **配置文件**: 修改 `config.json` 中的服务器信息 3. **SSH 密钥**: 确保免密登录 `ssh {ssh_alias} echo test` 4. **ttyd 安装**: Windows `scoop install ttyd`，Linux `sudo apt install ttyd` 5. **服务器配置**: `GatewayPorts yes` 和 `AllowTcpForwarding yes` 6. **验证**: 运行 `python ./scripts/validate_config.py`

path: scripts/requirements.txt
content: psutil>=5.9.0


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)