4.5 KiB

Raw Blame History

实施进度

配合 DESIGN.md 阅读。本文件只记录 phase 状态、决策偏差、文件量、下一步。

最后更新:2026-05-12(§7 改写为 user-direct SaaS 草案)

状态

Phase	标题	状态	备注
1-3	骨架 + Skill + run_python	✅	三个 skill;CoreCoder 唯一匹配 edit;敏感 env 过滤
4	演化性能力	🟡	Model Profile + Probing ✅;版本化 prompt 未做
5	Eval Suite	⏸ 不做	dogfooding 替代,probe 覆盖健康检查
6	长任务工程化	🟡	task + state.json + 恢复 ✅;双层记忆 ✅;context 压缩未做
7	打磨	❌	Docker 沙盒 / 更多 skill
§7 SaaS 化	DESIGN §7 路线	🟡	A 事件流化 ✅;B (Storage 落 PG + task_dir 双形态 + Folder API + no-subtask) 可立刻开,本地与 SaaS 共用同一种 storage

已完成关键能力

2026-Q1 ~ 05-06:Phase 1-4 —— 骨架 / 三个 skill(coding/ppt/proposal)/ run_python 范式 / Model Profile + Capability Probing。ppt v3:商务红约束 + apply_brand + Iconify + render_icon/quality_check;素材摄取改 markitdown CLI。

2026-05-06:Phase 6 部分 —— task + state.json + tokens 累计;CLI tasks + REPL /status /done /abandon /desc;移除 legacy workspace/sessions/。

2026-05-07:TUI 打磨 + task_dir 落地 —— rich Markdown 渲染;thinking spinner 显实时耗时+累计 token;system prompt 注入 task_dir 绝对路径,skill 产物全收敛 workspace/tasks/<id>/;.gitignore 删 bandaid 行。

2026-05-08:REPL task 切换 + 懒创建 —— /resume [last|<id>];build_agent 不预占文件,首条 user 消息触发 save;_cleanup_if_empty 三条件守门防误删。

2026-05-09 → 05-10:§7 草案 + 对话导出 —— DESIGN §7 初版 SaaS 草案(后于 05-12 重写);cli.py export <task_id> + core/export_docx.py 导对话成 docx。

2026-05-11:原子写 + 双层记忆 + §7 A —— atomic_write_text 接管 save;core/memory.py 双层记忆(core.md 入 prompt,extended/* 走索引);loop 事件流化(sink.emit)铺 SSE 路。

2026-05-12:§7 改写 —— 原 platform/core 多租户方案废弃,改 user-direct(folder-centric,task/messages 入 PG,no-subtask 约束,hard cascade delete)。

关键决策与偏差

项	决策	备注
工具基目录	cwd(读)+ task_dir(写)	system prompt 同时注入两者绝对路径
Workspace 布局	`tasks/<id>/` + `memory/{core.md, extended/}`	memory 跨 task 共享
Eval Suite	不做	个人工具用 dogfooding
版本化 prompt	直接 `general_v1.md`	Windows 软链接麻烦,真要切再做
run_python 沙盒	subprocess + env 过滤	Docker 在 §7 C 阶段

文件清单(代码量)

core/capabilities.py        71
core/llm.py                 89
core/loop.py               152   ← §7 A: sink.emit
core/sinks.py              101   ← §7 A
core/ui.py                  38
core/probe.py              243
core/session.py             93   ← +atomic_write_text
core/skills.py              81
core/task.py                64
core/memory.py              76
core/export_docx.py        372
tools/base.py               34
tools/fs.py                182
tools/shell.py              94
tools/run_python.py         84
tools/skill_tool.py         45
main.py                    210
cli.py                     439
─────────────────────────────────
Python 合计              ~2429 行

加 skills/ppt 脚本 ~600 行 + SKILL.md / references / config / prompts,总仓库约 3000 行。

下一步候选(性价比排序)

§7 B 阶段(~1 周)—— Storage 落 PG(单一实现,无 adapter 抽象)+ task_dir 双形态 + Folder API + No-subtask。dogfood 即生效(messages 进 DB → 全文搜立刻可用)。
- 前置:repo 加 docker-compose.yml(docker compose up -d postgres 起本地 dev PG)或 ZCBOT_DB_URL 指向远端测试 PG
- 里程碑:① schema + alembic 初版迁移 ② SQLAlchemy ORM 接入 Session / TaskState ③ CLI 适配(去 .json 读写,加 _cleanup_if_empty 新逻辑)④ cli migrate-from-fs 工具(把现有 workspace/tasks/*/ 导入 PG)⑤ Folder API + no-subtask SQL 校验 ⑥ 本地单用户 sentinel(user_id='00000000-...')init 流程
Phase 6 context 三层压缩(~1 天)—— 兜底,V4 长上下文一般用不到
Phase 7 更多 skill / 模型档案(持续)
Proposal mermaid 流程图预渲染(~半天)—— ASCII 透传不够用时再上 mmdc(Node.js 依赖)

4.5 KiB Raw Blame History