完善文档

docs/tools/README.md

@@ -0,0 +1,3 @@
+# Tools
+
+工具系统文档目录。

docs/tools/built-in-tools.md

@@ -0,0 +1,15 @@
+# Built-in Tools
+
+初始工具类别：
+
+- File
+- HTTP
+- Web
+- Database
+- Vector
+- Graph
+- Code Sandbox
+- Shell
+- Search
+
+工具必须保持单一职责，复杂业务流程应通过 Agent Workflow 组合，而不是制作超大工具。

docs/tools/overview.md

@@ -0,0 +1,19 @@
+# Tools
+
+Tool System 是 Agent 与外部世界之间的执行边界。
+
+核心组件：
+
+- Registry
+- Discovery
+- Permission
+- Validation
+- Runtime
+- Audit
+
+工具来源：
+
+- Built-in
+- MCP
+- Local Desktop
+- External API

docs/tools/permissions.md

@@ -0,0 +1,12 @@
+# Tool Permissions
+
+权限至少区分：
+
+- User Permission
+- Agent Permission
+- Tool Permission
+- Resource Permission
+
+采用最小权限原则。
+
+权限检查必须发生在 Tool 执行之前。

docs/tools/registry.md

@@ -0,0 +1,14 @@
+# Tool Registry
+
+注册信息：
+
+- name
+- version
+- description
+- schema
+- permissions
+- timeout
+- retry
+- tags
+
+Registry 支持发现、版本控制和能力过滤。

docs/tools/sandbox.md

@@ -0,0 +1,14 @@
+# Tool Sandbox
+
+代码执行、Shell、文件系统等高风险工具必须运行在受控环境。
+
+安全目标：
+
+- 文件隔离
+- 网络限制
+- 资源限制
+- 超时
+- 进程隔离
+- 输出限制
+
+桌面端使用 Tauri Capabilities 控制本地系统能力；服务端使用独立 Sandbox。