caoxiaozhu/JARVIS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
bfe3b6bb9d5e700353206c4da32198c6b977776e
JARVIS/development-doc/plan/tool-update/checklist.md

5.9 KiB
Raw Blame History

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 创建文档
2026-04-05 T.1-T.4 完成所有 Phase 实现
Reference in New Issue View Git Blame Copy Permalink