Repository navigation

TASKS.md — 任务清单

最后更新：2026-07-03 图例：⬜ Pending | 🔄 In Progress | ✅ Done | ❌ Blocked

阶段 1：项目骨架

ID	任务	状态	负责人	备注
1.1	初始化 pnpm workspace	⬜	—	根 package.json + pnpm-workspace.yaml
1.2	创建 manifest.json	⬜	—	完整字段声明
1.3	初始化 ui/ 前端项目	⬜	—	Vite + React + TS
1.4	最小前端 Hello World	⬜	—	AnnaAppRuntime.connect()
1.5	初始化 executa/ 项目	⬜	—	package.json + tsconfig
1.6	最小 Executa Tool	⬜	—	initialize + describe
1.7	创建 executa.json	⬜	—	Executa manifest
1.8	配置 Host API 权限	⬜	—	storage + tools
1.9	validate --strict	⬜	—	必须通过
1.10	dev --no-llm	⬜	—	确认可加载

阶段 2：Executa Tool 核心

ID	任务	状态	负责人	备注
2.1	stdio 通信框架	✅	—	readline + JSON parse + flush
2.2	initialize handler	✅	—	v2 + sampling capability
2.3	describe handler	✅	—	完整 tool manifest
2.4	health handler	✅	—
2.5	shutdown handler	✅	—
2.6	invoke handler	✅	—	summarize 处理 + envelope
2.7	sampling/createMessage	✅	—	反向 JSON-RPC 请求
2.8	sampling 响应处理	✅	—	同一 reader 接收
2.9	错误处理	✅	—	无效请求/未知 method
2.10	stderr 日志	✅	—
2.11	ESM→CJS 修复	✅	—	模块解析修复
2.12	手动 RPC 测试脚本	✅	—	21 项断言全部通过

阶段 3：前端核心

ID	任务	状态	负责人	备注
3.1	runtime.ts 连接层	✅	—
3.2	storage.ts 封装	✅	—	get/set
3.3	tools.ts 封装	✅	—	invoke (tool-dev-mini-notes)
3.4	useNotes hook	✅	—	状态管理 (loading/ready/error)
3.5	NoteInput 组件	✅	—	输入 + 验证 + Enter + 清空
3.6	NoteList 组件	✅	—	列表展示 + 序号
3.7	NoteItem 组件	✅	—	内容 + 删除
3.8	EmptyState 组件	✅	—	无笔记引导
3.9	ErrorBanner 组件	✅	—	错误 + 重试
3.10	Summarize 组件	✅	—	按钮 + loading + 结果 + 错误
3.11	App.tsx 组装	✅	—	连接状态 + 组件组合
3.12	Vite 构建配置	✅	—	输出到 bundle/
3.13	manifest bundle 指向	✅	—	entry: index.html

阶段 4：Mock Fixture

ID	任务	状态	负责人	备注
4.1	sampling-mock.jsonl	✅	—	3 条 mock 响应（含内容匹配）

阶段 5：集成测试

ID	任务	状态	负责人	备注
5.1	validate --strict 通过	✅	—
5.2	创建笔记测试	✅	—	storage.set 调用确认
5.3	查看笔记测试	✅	—	storage.get 调用确认
5.4	删除笔记测试	✅	—	storage.set 更新确认
5.5	Summarize 错误测试	✅	—	[-32603] 预期错误
5.6	executa dev mock 测试	✅	—
5.7	sampling 证据确认	✅	—	Sending sampling/createMessage
5.8	手动 RPC 测试	✅	—	21/21 全部通过

阶段 6：打包与发布

ID	任务	状态	负责人	备注
6.1	确定打包方案	✅	—	esbuild + SEA
6.2	build-executa.sh	✅	—
6.3	build-executa.ps1	✅	—
6.4	archive 结构验证	✅	—	manifest.json + bin/
6.5	release.yml	✅	—	GitHub Actions
6.6	smoke test 集成	✅	—	describe 验证
6.7	workflow 测试	✅	—	workflow_dispatch + tag

阶段 7：文档

ID	任务	状态	负责人	备注
7.1	项目结构	✅	—
7.2	安装说明	✅	—
7.3	构建说明	✅	—
7.4	validate 说明	✅	—
7.5	dev --no-llm 说明	✅	—	含 [-32603] 解释
7.6	executa dev mock 说明	✅	—
7.7	手动 RPC 测试说明	✅	—
7.8	storage 链路确认	✅	—
7.9	summary 链路确认	✅	—
7.10	打包说明	✅	—
7.11	release 说明	✅	—
7.12	平台概念解释	✅	—

统计

总任务数：62
已完成：62
进行中：0
待开始：0
阻塞：0

🎉 全部 7 阶段 62 项任务完成！

阻塞：0