pc-control

# PC Control Windows电脑控制工具，开箱即用，带完整安全防护。 ## 快速安装 ```bash # 1. 安装 skill clawhub install pc-control-luken # 2. 安装依赖（Windows环境） pip install -r skills/pc-control/scripts/requirements.txt # 3. 配置 API Key（可选，推荐） cd skills/pc-control/scripts python generate_key.py # 生成新的 API Key # 或直接编辑 security_config.json 设置你自己的 key # 4. 启动 API 服务 python api.py ``` ## 安全认证 API 默认需要认证。调用时需要在 Header 中携带： ``` Authorization: Bearer <your_api_key> ``` 未携带 key 或 key 错误将返回 `401/403`。 ## 代码文件 | 文件 | 说明 | |------|------| | `scripts/pc.py` | CLI 命令行入口 | | `scripts/api.py` | HTTP API 服务 | | `scripts/generate_key.py` | API Key 生成器 | | `scripts/security_config.json` | 安全配置文件 | | `scripts/modules/` | 功能模块（含安全沙箱） | | `scripts/requirements.txt` | Python 依赖 | ## 安全功能 - **API Key 认证** — 全局 token 验证 - **Shell 黑名单** — 拦截危险命令（del/shutdown/reg add等） - **文件沙箱** — 禁止访问系统目录和危险文件类型 - **进程保护** — 系统关键进程无法被操作 - **操作日志** — 每次操作详细记录到 `security.log` ## 常用功能速查 | 功能 | 命令 | |------|------| | 截图 | `GET /screenshot` | | 键盘按键 | `POST /key/press {"key":"enter"}` | | 输入文本 | `POST /key/type {"text":"..."}` | | 鼠标移动 | `POST /mouse/move {"x":100,"y":200}` | | 鼠标点击 | `POST /mouse/click {"x":100,"y":200}` | | 剪贴板读/写 | `GET /clipboard/read` / `POST /clipboard/write` | | 进程列表 | `GET /process/list` | | 结束进程 | `POST /process/kill {"name":"notepad"}` | | 窗口列表 | `GET /window/list` | | 关闭窗口 | `POST /window/close {"title":"..."}` | | Shell执行 | `POST /shell/run {"command":"...","shell":"powershell"}` | | 浏览器导航 | `POST /browser/navigate {"url":"..."}` | | 浏览器点击 | `POST /browser/click {"text":"按钮文字"}` | ## 详细文档 - [完整API文档](references/api-doc.md)