\r \r

builtin-tools — 跨平台基础工具集\r

\r

定位\r

\r 当宿主 Agent 平台缺少某个基础工具时，用本技能的脚本补足。\r 所有脚本纯 Python 标准库实现，零外部依赖，跨 Windows/macOS/Linux。\r \r

核心规则\r

\r

1. 优先用宿主平台内置工具 — 仅在平台不支持时回退到本技能脚本\r
2. 通过 execute_command 调用 — 所有脚本接受 JSON 输入，输出 JSON 结果\r
3. 自举设计 — execute_command.py 可调度所有其他脚本，只需平台支持执行一条 Python 命令\r \r

脚本清单\r

\r | 脚本 | 功能 | 调用方式 |\r |------|------|---------|\r | execute_command.py | 自举入口 + 命令执行 + 管道串联 | 见下方详细说明 |\r | list_dir.py | 目录浏览 | python list_dir.py '{"path":".","ignore":["*.log"]}' |\r | search_file.py | 文件名搜索 | python search_file.py '{"pattern":"*.py","recursive":true}' |\r | read_file.py | 读取文件 | python read_file.py '{"path":"f.txt","offset":0,"limit":50}' |\r | write_file.py | 写入文件 | python write_file.py '{"path":"f.txt","content":"hello"}' |\r | replace_in_file.py | 精确替换 | python replace_in_file.py '{"path":"f.txt","old":"a","new":"b"}' |\r | delete_file.py | 删除文件 | python delete_file.py '{"path":"f.txt"}' |\r | search_content.py | 正则内容搜索 | python search_content.py '{"pattern":"TODO","path":"."}' |\r | web_search.py | 网页搜索 | python web_search.py '{"query":"Python","engine":"duckduckgo"}' |\r | web_fetch.py | 网页抓取 | python web_fetch.py '{"url":"https://..."}' |\r | preview_url.py | 浏览器预览 | python preview_url.py '{"url":"https://..."}' |\r | install_binary.py | 运行时安装 | python install_binary.py '{"type":"python","version":"3.13.12"}' |\r | update_memory.py | 持久化记忆 | python update_memory.py '{"action":"create","title":"...","content":"..."}' |\r | automation_update.py | 定时任务 | python automation_update.py '{"mode":"create","name":"...","prompt":"...","rrule":"..."}' |\r | todo_write.py | 任务管理 | python todo_write.py '{"todos":[{"id":"1","status":"in_progress","content":"..."}]}' |\r \r

execute_command.py 详细用法\r

\r

模式 1：执行系统命令\r

\r

{"mode": "command", "command": "ls -la", "timeout": 30, "cwd": "/tmp"}\r
```\r
\r
### 模式 2：执行内置脚本\r
\r
```json\r
{"mode": "script", "script": "list_dir", "params": {"path": "."}}\r
```\r
\r
### 模式 3：打开 URL/文件\r
\r
```json\r
{"mode": "open", "url": "https://example.com"}\r
```\r
\r
### 模式 4：管道串联多个脚本\r
\r
```json\r
{"mode": "pipe", "chain": ["search_file", "search_content"], "params": {"pattern": "*.py"}}\r
```\r
\r
### 快捷模式\r
\r
```bash\r
python execute_command.py search_file '{"pattern":"*.py"}'\r
python execute_command.py --command "echo hello"\r
```\r
\r
## JSON 协议\r
\r
所有脚本遵循统一协议：\r
\r
- **输入**：JSON 字符串（命令行第一个参数 或 stdin）\r
- **输出**：`{"status":"ok","data":{...},"message":"ok"}` 或 `{"status":"error","code":N,"message":"..."}`\r
- **Exit Code**：0=成功, 1=参数错误, 2=执行失败, 3=不支持的平台\r
\r
## 目录结构\r
\r
```\r
builtin-tools/\r
├── SKILL.md                    # 本文件\r
├── scripts/\r
│   ├── common.py               # 公共层（Shell执行/JSON协议/路径处理）\r
│   ├── execute_command.py      # 自举入口\r
│   ├── list_dir.py             # 目录浏览\r
│   ├── search_file.py          # 文件名搜索\r
│   ├── read_file.py            # 读取文件\r
│   ├── write_file.py           # 写入文件\r
│   ├── replace_in_file.py      # 精确替换\r
│   ├── delete_file.py          # 删除文件\r
│   ├── search_content.py       # 正则内容搜索\r
│   ├── web_search.py           # 网页搜索\r
│   ├── web_fetch.py            # 网页抓取\r
│   ├── preview_url.py          # 浏览器预览\r
│   ├── install_binary.py       # 运行时安装\r
│   ├── update_memory.py        # 持久化记忆\r
│   ├── automation_update.py    # 定时任务\r
│   └── todo_write.py           # 任务管理\r
└── references/\r
    └── protocol.md             # 接口协议详细文档\r
```\r
\r
## 安全策略\r
\r
- `execute_command.py` 不使用 `shell=True`（Windows 用 list 参数传递给 powershell.exe）\r
- `delete_file.py` 禁止删除根目录和用户主目录\r
- `replace_in_file.py` 默认限制替换次数（防止误操作）\r
- `install_binary.py` 下载后校验文件完整性\r