mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-10 05:10:45 +08:00
新增目录列举、文件/目录操作、内容搜索、cwd/env 管理与进程管理工具,并在本地适配层统一实现与测试覆盖,保持风险门控策略一致。 Made-with: Cursor
41 lines
1 KiB
Markdown
41 lines
1 KiB
Markdown
# Local Public Tools
|
|
|
|
This project exposes local atomic capabilities as shared `public` tools for all agents.
|
|
|
|
## Included P0 tools
|
|
|
|
- `local_run_command`
|
|
- `local_read_file`
|
|
- `local_write_file`
|
|
- `local_edit_file`
|
|
|
|
## Included P1/P2/P3 tools
|
|
|
|
- `list_directory`
|
|
- `move_file`
|
|
- `delete_file`
|
|
- `mkdir`
|
|
- `search_files`
|
|
- `get_cwd`
|
|
- `cd`
|
|
- `get_env`
|
|
- `set_env`
|
|
- `list_processes`
|
|
- `kill_process`
|
|
|
|
## Loading path
|
|
|
|
- Files live under `runtime/tools/public/`.
|
|
- They are auto-discovered by `runtime/tools/public_registry.py` (`*_tool` factory naming).
|
|
- Final exposure is controlled in `runtime/tools/catalog.py`.
|
|
|
|
## Risk gating
|
|
|
|
- `local_read_file` is `risk_level=low` and visible by default.
|
|
- `local_run_command`, `local_write_file`, `local_edit_file` are `risk_level=high`.
|
|
- High-risk public tools are hidden unless `AIA_PUBLIC_TOOLS_ALLOW_HIGH=1`.
|
|
|
|
## Local backend adapter
|
|
|
|
- Adapter path: `runtime/tools/local_sdk/adapter.py`.
|
|
- Uses a self-implemented local backend (cross-platform) with a stable tool contract.
|