# Tools 升级执行清单

本清单用于追踪 Tools 升级计划的执行进度。

---

## 总进度

| Phase | 名称 | 状态 | 工作量 |
|-------|------|------|--------|
| T.0 | 现状与目标 | ✅ 完成 | - |
| T.1 | Manifest 驱动系统 | ⬜ 待开始 | 3 天 |
| T.2 | 工具注册中心 | ⬜ 待开始 | 2 天 |
| T.3 | 核心工具实现 | ⬜ 待开始 | 5 天 |
| T.4 | 高级特性 | ⬜ 待开始 | 4 天 |
| **总计** | | | **14 天** |

---

## Phase T.1：Manifest 驱动系统

### 目标
建立 Jarvis 的 Manifest 驱动工具系统，定义标准化工件声明。

### 任务清单

#### Schema 定义
- [ ] 创建 `tools/schemas/manifest.py`
  - [ ] 定义 `ToolManifest` Schema
  - [ ] 定义 `ToolType` 枚举
  - [ ] 定义 `RuntimeType` 枚举
  - [ ] 定义 `InvocationCommand` Schema
- [ ] 创建 `tools/schemas/tool_call.py`
  - [ ] 定义 `ToolCallRequest` Schema
  - [ ] 定义 `ToolCallResponse` Schema
  - [ ] 定义 `ToolExecutionLog` Schema

#### 验证器
- [ ] 创建 `tools/schemas/validator.py`
  - [ ] 实现 `validate_manifest` 函数
  - [ ] 实现 `validate_tool_call` 函数
  - [ ] 实现错误类

#### 配置系统
- [ ] 创建 `tools/configs/loader.py`
  - [ ] 实现 `ConfigLoader` 类
  - [ ] 实现配置缓存
  - [ ] 实现配置重载

#### Manifest 文件
- [ ] 创建 `tools/manifests/file_operator.yaml`
- [ ] 创建 `tools/manifests/web_search.yaml`
- [ ] 创建其他工具 Manifest

#### 测试
- [ ] 单元测试

### 产出文件
- `tools/schemas/manifest.py`
- `tools/schemas/tool_call.py`
- `tools/schemas/validator.py`
- `tools/configs/loader.py`
- `tools/manifests/*.yaml`

### 验收
- [ ] Schema 验证正常工作
- [ ] 配置加载器正常工作
- [ ] Manifest 文件格式正确
- [ ] 单元测试通过

---

## Phase T.2：工具注册中心

### 目标
实现工具的动态注册、发现和管理。

### 任务清单

#### 注册中心
- [ ] 创建 `tools/registry.py`
  - [ ] 实现 `ToolMetadata` dataclass
  - [ ] 实现 `ToolRegistry` 类
  - [ ] 实现注册/注销方法
  - [ ] 实现查询方法
  - [ ] 实现统计方法

#### 工具发现
- [ ] 创建 `tools/discovery.py`
  - [ ] 实现 `ToolDiscovery` 类
  - [ ] 实现自动发现
  - [ ] 实现热重载

#### 描述生成
- [ ] 创建 `tools/description.py`
  - [ ] 实现 AI 友好描述生成
  - [ ] 实现工具列表生成

#### 权限控制
- [ ] 创建 `tools/permissions.py`
  - [ ] 实现 `ToolPermission` 枚举
  - [ ] 实现 `ToolPermissionChecker` 类

#### LangChain 集成
- [ ] 创建 `tools/langchain_adapter.py`
  - [ ] 实现适配器
  - [ ] 集成到 Agent

#### 测试
- [ ] 单元测试

### 产出文件
- `tools/registry.py`
- `tools/discovery.py`
- `tools/description.py`
- `tools/permissions.py`
- `tools/langchain_adapter.py`

### 验收
- [ ] 注册中心正常工作
- [ ] 工具发现正常工作
- [ ] 权限检查正常工作
- [ ] LangChain 适配器正常工作
- [ ] 单元测试通过

---

## Phase T.3：核心工具实现

### 目标
实现文件操作、搜索、网页抓取等核心工具。

### 任务清单

#### 文件操作工具
- [ ] 创建 `tools/implementations/file_operator.py`
  - [ ] 实现 `FileOperator` 类
  - [ ] 实现 read_file
  - [ ] 实现 write_file
  - [ ] 实现 list_directory
  - [ ] 实现 search_files
  - [ ] 实现路径安全检查
- [ ] 实现多格式支持（PDF/DOCX/XLSX）

#### 搜索工具
- [ ] 创建 `tools/implementations/web_search.py`
  - [ ] 实现 `WebSearch` 类
  - [ ] 实现 search 方法
  - [ ] 实现 deep_search 方法

#### 网页抓取工具
- [ ] 创建 `tools/implementations/web_fetch.py`
  - [ ] 实现 `WebFetch` 类
  - [ ] 实现 fetch 方法
  - [ ] 实现 screenshot 方法

#### 任务管理工具
- [ ] 创建 `tools/implementations/task_manager.py`
  - [ ] 实现 `TaskManager` 类
  - [ ] 实现任务 CRUD

#### Manifest 绑定
- [ ] 更新 Manifest 文件
- [ ] 注册到工具中心

#### 测试
- [ ] 单元测试

### 产出文件
- `tools/implementations/file_operator.py`
- `tools/implementations/web_search.py`
- `tools/implementations/web_fetch.py`
- `tools/implementations/task_manager.py`

### 验收
- [ ] 文件操作工具正常工作
- [ ] 搜索工具正常工作
- [ ] 网页抓取工具正常工作
- [ ] 任务管理工具正常工作
- [ ] 单元测试通过

---

## Phase T.4：高级特性

### 目标
实现多运行时支持、Agent 协作和定时任务。

### 任务清单

#### 运行时系统
- [ ] 创建 `tools/runtime/base.py`
  - [ ] 定义 `BaseRuntime` 抽象基类
- [ ] 创建 `tools/runtime/python_runtime.py`
- [ ] 创建 `tools/runtime/js_runtime.py`
- [ ] 创建 `tools/runtime/native_runtime.py`
- [ ] 创建 `tools/runtime/manager.py`

#### Agent 协作
- [ ] 创建 `agents/tools/collaboration.py`
  - [ ] 定义 `CollaborationMessage`
  - [ ] 实现 `CollaborationProtocol` 类
  - [ ] 实现请求/响应机制

#### 定时任务
- [ ] 创建 `tools/scheduler.py`
  - [ ] 实现 `ScheduledTask`
  - [ ] 实现 `ToolScheduler` 类
  - [ ] 实现多种调度类型

#### 测试
- [ ] 单元测试

### 产出文件
- `tools/runtime/*.py`
- `agents/tools/collaboration.py`
- `tools/scheduler.py`

### 验收
- [ ] 多运行时正常工作
- [ ] Agent 协作正常工作
- [ ] 定时任务正常工作
- [ ] 单元测试通过

---

## 完成标准

- [ ] 所有 Phase T.1-T.4 任务完成
- [ ] 所有单元测试通过
- [ ] API 文档更新完成
- [ ] 部署验证通过

---

## 风险与注意事项

| 风险 | 影响 | 缓解措施 |
|------|------|----------|
| 多运行时复杂性 | 开发成本增加 | 优先实现 Python 运行时 |
| JS 运行时依赖 Node | 部署环境要求 | 提供降级方案 |
| 定时任务精度 | 任务延迟 | 使用专业调度库 |
| 安全漏洞 | 系统风险 | 严格权限控制 |

---

## 更新日志

| 日期 | Phase | 变更内容 |
|------|-------|----------|
| 2026-04-04 | T.0 | 创建文档 |