zcdsj
/
zcbot
5
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
zcbot/PROGRESS.md

35 KiB
Raw Blame History

实施进度

配合 DESIGN.md。本文件只记 phase 状态、决策偏差、文件量、下一步。每条 1-2 句:做了啥 + 关键判断;细节查 git log / git diff / DESIGN §7.9。

最后更新:2026-06-03(默认镜像源改清华 —— 腾讯 PyPI 吐损坏 litellm wheel)

状态

Phase 标题 状态 备注
1-3 骨架 + Skill + run_python ✅ 多 skill(coding/proposal/ppt/research/documents/imagegen/videogen/review/patent);CoreCoder 唯一匹配 edit;敏感 env 过滤
4 演化性能力 🟡 Model Profile + Probing ✅;版本化 prompt 未做
5 Eval Suite ⏸ 不做 dogfooding 替代,probe 覆盖健康检查
6 长任务工程化 🟡 task + 恢复 ✅;双层记忆 ✅;context 压缩未做
7 打磨 ❌ Docker 沙盒 / 更多 skill
§7 SaaS DESIGN §7 路线 🟡 A 事件流化 ✅;B 完工 ✅;D /v1 JSON API ✅;D' 过渡 auth + dev SPA ✅;单活 run 锁 + cancel ✅;0004 schema 瘦身 ✅;入口归位 ✅;真 OIDC 待;C Step 1-3 + 3d ✅(Executor + Docker 池 + DockerExecutor + fs 工具进容器)+ Step 5 部署前置对账 ✅ + 容器资源 yaml + 应用层磁盘配额(scan+gate)✅ + dogfood 网络放开 + 容器内 pip/npm 源持久化 ✅;Step 4 完整 egress proxy + Step 3b PGID kill 协议延后到外部用户开放前;外部用户开放仍需 egress proxy + xfs project quota OS 层硬化(§7.5 落地清单 #2 #4)。

已完成关键能力

2026-06-03

  • 默认镜像源改清华(pip+apt)/ 腾讯(npm):腾讯 PyPI 吐损坏 litellm wheel(index 声明 sha256 与文件实际字节不符,非篡改 = 镜像端文件损坏)。deploy/update.sh 三默认值改清华(境内稳 + 同步及时;npm 无清华源走腾讯);换默认让下次 build pip 层全量重跑一次。
  • 回退 ZCBOT_WORKSPACE_DIR env 覆盖,workspace 落数据盘改用 bind mount:env 覆盖与 core/paths.py 锚 ROOT 的相对存储冲突 —— env 指向 ROOT 外致文件面板 / agent resume / 新建 task 三家分叉。resolve_workspace 回退成 arg > cfg > 默(均 ROOT 内),数据盘改用 bind mount(/data/zcbot/workspace → ROOT/workspace,DB 不改、dev 不受影响)。

2026-06-02

  • 【已于 06-03 回退,见上】resolve_workspace 加 env 覆盖 ZCBOT_WORKSPACE_DIR:prod 想把 workspace 落独立数据盘且不碰共用 yaml,改优先级 arg > env > cfg > 默。回退因与相对存储锚点冲突(见上)。
  • 修 embed 模式"登录页一闪而过"(绘制时机,非鉴权):#login 在 embedInit 标记 embed-mode 前已被绘制;在 <body> 首行加同步内联脚本,?embed=1 时立即加 embed-mode class,赶在 #login 绘制前隐藏。只挪绘制闸门,底部握手逻辑不动。

2026-06-01

  • deploy/update.sh 加自更新重跑守卫:git pull 会改脚本自身,首次拉到"改 update.sh"那轮跑的还是旧脚本行为。pull 后 diff 检出本脚本变更则 exec 用新版本从头重跑(标记防死循环),修"改了源仍报旧错"根因。
  • deploy/update.sh 默认源改腾讯 + build 跳过改 --skip-build + 进度可见:根因 = 阿里 PyPI 同步滞后缺 litellm>=1.83。默认镜像源改腾讯(host venv pip 显式拼 --index-url)、跳过 sandbox build 由 env 改 CLI flag、pip 去 -q 让进度可见。
  • 修 MP host 工具的全量下载(IP 被封根因):mp_search_summary 没传分页 → mp-api 默认翻完所有页 = 每搜一次整库级下载,MP 判 abusive 封 host IP。改 num_chunks=1, chunk_size=limit 服务端限量;mp_get_entries 天然全量(相图用途)只在 description 警示。注:宿主 IP 仍被 MP 临时封,需邮件 support 人工解封后才能联网复测。
  • 加一键部署脚本 deploy/update.sh(Ubuntu / systemd):git pull → pip install → db upgrade → docker build sandbox → restart → curl /healthz。两处钉死:migration 从 .env 抠 ZCBOT_DB_URL 喂 alembic;build 必须在 restart 之前(容器复用,restart 才换新镜像)。前置守卫:非 root / 非 git / 工作区脏 / 缺 .env 中止。
  • sandbox 镜像加中文字体,修 matplotlib / mermaid 出图中文方块:根因 = deploy/sandbox/Dockerfile 从 slim 起一个 CJK 字体都没装。加 fonts-noto-cjk fonts-wqy-microhei + style.py 候选首位加 Noto。改 Dockerfile 须重 build + 清旧容器才生效。
  • documents / Materials Project 带 key 能力改 host-side tools,key 不进 sandbox:新增 tools/documents.py + tools/materials_project.py 各三工具,仅宿主 env 有 key 时注册;写文件绑定 task_dir,模型不能传 working_dir。
  • 删 skills/pymatgen/materials.py::mp_rester():sandbox 内读 key 的旧入口,host tool 化后多余且违背"key 不进 sandbox",直接删;smoke 改走 host tool。换 next-gen MP key 后端到端复测通过。

2026-05-29

  • Seedream 5.0 i2i base64 通路 probe + DESIGN §8.1 落册:实测豆包 Seedream 5.0 /images/generations 接受 image_urls base64 data URL → 内网部署无需对象存储中介。选 E+C 组合(seedream 加 reference_images + 新增 look_at_image 豆包 vision tool),本版仅 probe + design,tool 改造未启动。
  • web 端 tool_call 标题行改显中文活动描述:实时流分支读错字段(arguments vs 后端 emit 的 args)致 <pre> 一直空。修字段 + 新增 toolActivityLabel(name,args) 按 12 工具套中文动词(读取文件 / 执行命令 / 运行 Python / 联网搜索…)。纯前端,刷新即生效。

2026-05-28

  • skills/review/SKILL.md 加"长文档处理"段:阶段 1 骨架扫描(只出目录 + 全局问题,不出修改稿,停下等用户挑章节)→ 阶段 2 分章深审 + 中间文件落盘。解长稿一轮处理易略读 / 覆盖不全 / 超输出限制。
  • 新增 config/models/local.yaml(family=local,variant r1 / qwen3)接内网 OpenAI 兼容推理服务,涉密任务专用:model_id 加 openai/ 前缀走兼容协议,api_base 指内网。关键 thinking_mode=false(R1 / Qwen3 天生推理,发 reasoning_effort 本地 vLLM 多半 400)。不改默认模型,涉密显式选;qwen3 跑通,r1 服务端调试中 500。
  • 修 LoadSkillTool 在 docker backend 返 host 绝对路径致容器内 fs 工具找不到 references:skills/ bind mount 到容器 /sandbox/skills,容器内无 host 路径。加 container_skills_dir 参数,docker backend 时返 /sandbox/skills/<name>。所有 references-heavy skill 自动 work,不用逐个改 SKILL.md。
  • 新增 analyze skill(科学问题分析 / 拆解 / 引导):服务建材院 R&D 早期模糊问题翻译。四段式:PICO 规范化 → Issue Tree 拆解 → 按叶子类型分支(Fishbone / First-principles+TRIZ / DoE)→ 实施路线图。定位协调器不执行任务,接力下游 skill;不硬编"能力 → skill"映射(靠 runtime skill discovery 自匹配)。
  • Python 3.10→3.12 升级(host + Dockerfile)+ DockerExecutor PYTHONPATH 修:mp-api 依赖链 from typing import NotRequired(3.11+)在 3.10 import 不进;选 3.12(ML 生态默认 + wheel 覆盖全)。顺手修 executor_docker PYTHONPATH /workspace→/sandbox:/workspace(docker backend 下 import skills.xxx 找不到的历史 bug)。3 科学 skill smoke A/B/C 通过,D 因 MP 封 IP 返 403。
  • 新增 3 个科学计算 skill(pymatgen / stats_ml / plot_pub):服务无机非金属材料 R&D。pymatgen 带 CEMENT_PHASES 中英文相名映射 50+;stats_ml 纯指南(sklearn / statsmodels / PyMC 场景导航,无 helper);plot_pub 带 apply_pub_style() 出版级中文字体跨平台 fallback。挑 4 个 ★★★ fork 单装,不一键装 138 个。
  • DESIGN §7.5 增"image 体积 / 多 user 资源 / 后续加包策略"决策段:① image 大 ≠ 吃更多 RAM(layer 共享);② 多 user 瓶颈在并发 exec 不在 idle 容器数;③ 新增依赖走"base 收敛 + per-user 持久化 venv + 使用频次沉淀"。

2026-05-27

  • ppt skill 歧义反问 + general_v1 加"产物形式歧义先问"通用原则:"汇报方案"仍被路由命中(LLM 把"汇报"联想成 PPT)。把"汇报 / 方案 / 材料"从反例摘出,改成先反问用户"PPT 还是文档",并把原则升格到 system prompt 让新 skill 继承。
  • ppt skill description 收紧路由:原文含"方案 / 生成"被误命中,改显式白名单(PPT / 幻灯片 / .pptx / slide / deck)+ 显式反例(报告 / 文档 / 纪要不触发)。
  • skill 热更新:/v1/skills 每次现扫:原 lifespan 启动扫一次的静态快照 → 加新 skill 须重启。改每次现扫(构造 ~3ms,非热路径);build_agent 早已每次重建 registry,本次仅补前端下拉这一处。
  • dev SPA "导出对话记录" / "清空对话"按钮改成只要选中 task 就常亮:原按 n_messages===0 禁用,清空后前端计数不刷致两键一直灰。改导出常亮、清空仅在 run 进行时禁;0 条时点也不会出错。
  • 修 dev SPA embed + task_id 模式模型下拉不显示:embed 带 task_id 时 selectTask 早于 loadModels resolve,renderModelDropdown 空 models 直接返空。loadModels 尾部加一行:若已有 task 选中则补一次 chat-meta 重渲。
  • Stage C 收尾包:容器资源 yaml 化 + 应用层磁盘配额 + dogfood 网络放开 + 容器内 pip/npm 源持久化:① agent.yaml sandbox 段(memory/cpus/pids,env>yaml>默);② migration 0008 + core/storage/disk_quota.py 周期扫描 + write/upload gate(race-tolerant);③ 去 --internal(dogfood 能 pip install)+ /etc/pip.conf /etc/npmrc 让运行时也走 mirror。iptables 红线不动。Step 4 完整 egress proxy 延后到外部开放前(沉淀为升级触发信号)。
  • Stage C Step 3d:fs 工具(read/write/edit/glob/grep)进容器 + DESIGN §7.5 #6 重写:dogfood 发现 host 工具 base_dir=Path.cwd() 漏底(模型 glob 列出 zcbot 源码),且原 DESIGN 写的 resolve_user_path 是假命题根本没那函数。选"物理边界替代代码护栏"走 docker exec,tool_runner.py 从 stdin 接 JSON args(CJK 路径透明传)。留 host:load_skill / web_* / seedream / seedance(持 key 或跨 user)。
  • Stage C Step 3 hotfix:exec_user 改 username + Dockerfile 加 Node/Chromium/mermaid-cli:① 写死 --user 1000:1000 与 bind mount owner(host uid 1001)错配致 EACCES,改 username zcbot 让 docker 查 passwd;② proposal/patent 渲 mermaid 缺 Node 退公网 API 又被 --internal 堵,Dockerfile 加 chromium/nodejs/npm + mermaid-cli + puppeteer --no-sandbox config。
  • Stage C Step 5:main.py sandbox check 部署前置对账 + lifespan fs quota WARN:5 项探测(docker daemon / 镜像 / network / 镜像内 uid 与 host 对齐 / workspace fs 可 quota)。err = 启动会 fail-fast 的根因(daemon/镜像/uid,exit 1);warn = 外部开放前要清(network 缺 / fs 不可 quota,exit 0)。detect_fs_quota 抽出给 lifespan 复用。
  • Stage C Step 3:DockerExecutor 集成 AgentLoop + web lifespan(ZCBOT_SANDBOX_BACKEND=host|docker env 切):shell / run_python 走 docker exec,其他工具直通 host;run_python tmp .py 落 <user_root>/.zcbot_tmp/ dotfile(/v1/files 天然过滤)。cancel 杀 docker CLI 不杀容器内进程,靠 idle reaper 兜底。pool.py asyncio.Lock→threading.Lock。Windows dogfood 默 host 零变化。
  • Stage C Step 2:Docker per-user 容器 + iptables blocklist(§7.5 #1 + #3 基底,未接入 AgentLoop):deploy/sandbox/{Dockerfile,init.sh}(non-root + 任一 iptables 失败 fail-fast + 6 段红线 DROP)+ core/sandbox/{network,pool}.py(--internal 网络 + per-user 容器 ensure/reap/shutdown + hardening flags --read-only --cap-drop=ALL --memory=2g 等)。docker CLI via subprocess 非 SDK;last_active 落内存 dict(Docker 23+ 移除 runtime label 改)。
  • Stage C Step 1:Executor 接口骨架 + HostExecutor in-process backend(§7.5 #5):core/executor.py Executor ABC + ExecCtx + ToolResult,AgentLoop 改接 executor 而非 tools dict。接口刻意 backend 无关(不泄漏 docker 假设),Step 3 切 docker 时 AgentLoop 零改动。
  • REVISIONS.md 修订日志机制(覆盖 proposal/patent/ppt 三个产物型 skill):<task_dir>/REVISIONS.md 紧凑 changelog —— spec=宪法(定调一次),REVISIONS=实施日志(每次卡点累加)。三 skill 各加"用户确认实质改动后追加一行" + 独立小节;单行 bullet 倒序追加,首次起草 / 错别字微调 / 模型自撤不记。
  • 新增 patent skill(中国发明专利技术交底书):skills/patent/ 6 文件,五阶段 workflow(摄取 → 挖点 → 检索 → spec → 逐章起草 → 自查渲染,同 proposal BLOCKING 节奏)。复用 markitdown / proposal 的 render_diagrams+render_docx / web_search+documents+research,不造 CNIPA 爬虫,源 repo 8 Python tools 减到 0。
  • §7.5 沙盒落地清单 6 条写入 DESIGN(Stage C 实施硬协议):网络 blocklist 硬编码(含 PG IP 单独再 block)/ egress proxy 模型 / 进程组清理(setsid + PGID kill)/ 磁盘配额硬化时点 / Executor backend driver / 工具按信任域二分 dispatch;并写死 gVisor / Firecracker / 容器内 tool-runner 三档升级触发信号,反向兜底"无信号不升级"。

2026-05-25

  • dev SPA 前端依赖 CDN 本地化 + 升级稳定版:markdown 渲染(marked@16.2.1 / dompurify@3.2.6 / highlight.js@11.11.1)从 jsDelivr 改本地 vendor/,避免内网 / 跨境 CDN 抖动致渲染 / sanitizer 不可用;tests/test_static_vendor.py 回归检查 HTML 无 cdn.jsdelivr.net + vendor 文件存在。
  • dev SPA 一批上传 / 布局交互打磨(同质合并):三类上传入口(粘贴 / 按钮 / 拖拽)改 XMLHttpRequest 显进度 + 粘贴上传 chip 可预览(#mini-preview-modal 不覆盖主预览)可删除;三栏支持右栏折叠 + 左右分隔线拖拽调宽(localStorage 持久化);右侧文件长名 hover 显全路径;左栏滚动条只覆盖 task 列表(IntersectionObserver root 移到 #task-scroll)。
  • 接入博查 Web Search + Web Fetch 两个 tool:tools/web_search.py(Bocha POST /v1/web-search,Bearer)+ tools/web_fetch.py(httpx + html2text,SSRF 内网屏蔽,截断 8000);web_fetch 无条件挂,web_search 仅 env 有 BOCHA_API_KEY 时挂。

2026-05-22

  • dev SPA 加 iframe embed 模式(?embed=1&parent_origin=...):父页 postMessage 握手拿 JWT(zcbot-ready → 父端用 PLATFORM_KEY 换 token → zcbot-token 推回),event.origin 白名单双向校验,PLATFORM_KEY 不下发浏览器;藏 brand / 顶栏 / 退出。401 发 zcbot-401 等父端重换 token。web/EMBED.md 对接手册。
  • embed 模式接受 task_id URL 参数定位 task:首次签发 token 后 selectTask,once 标记只生效一次(401 重签不重置用户中途切的 task);task_id 错或不属于当前 user 走原 401/404 分支。
  • 媒体生成每账号每日配额(yaml 可配,默 20 图 / 5 视频):quotas 段 + check_daily_quota 按服务器本地今日 00:00 计;tool 超额返中文提示不调远端不烧钱。跨 task 跨 variant 账号级合计,失败不计,软上限不加事务锁。tool 返串只暴露已用 / 上限 + 重置时间,不贴 yaml 路径(防 LLM 复述泄漏内部 schema)。
  • 对外路径协议刚性化(system 强约束 + SKILL 简化 + UI 一次性兼容):general_v1.md 规定助手 echo 产物路径用 user_root 相对全形式 <wd_name>/<rel>(简写致 Web UI chip 失效),跨所有产物 skill 统一;imagegen/videogen SKILL 改"照抄 saved 行";dev.html::extractArtifactRels 一次性兼容历史简写。术语用 <wd_name>(working_dir 末段)而非 <task_name>(允许两者不等)。
  • 豆包 Seedance 2.0 Fast 视频生成接入(文生视频)+ videogen skill:config/media/doubao.yaml video 段 + tools/seedance.py(ark 建任务 → 5s 轮询 → download mp4,失败 / cancel 不计费);build_agent 加 video_variant + cancel_check(build 阶段传,轮询期响应停止);web/app.py + dev.html 第三下拉。skill 六维诊断把"光线"换成"运动 + 镜头",BLOCKING 门槛更严(¥4 vs ¥0.22)。phase 1 仅 t2v,fast 上限 720p。
  • dev SPA 移动端自适应 + 交互打磨(同质合并):手机两档断点(平板 rail / 手机单列 + .mobile-tabs 切 pane,100vh→100dvh 解 iOS、输入 ≥16px 防 focus 缩放)+ 顶栏 / chat-meta 紧凑化;"+ 新建任务"按钮从 header 挪到任务面板通栏;chat-input 支持 Ctrl+V 粘贴文件上传;文件预览弹框让出 chat-form 高度(打开期输入区仍可点可打字)。

2026-05-21

  • dev SPA UI 打磨(同质合并):修 primary 按钮 hover 文字消失(.primary:hover 补 background:var(--accent),原 fallback 到浅灰 + 白字消失);CSS 精简 + 圆角降档 + 4 个 modal 抽 .modal 基类(style 块 589→522 行,功能 0 改);新建任务弹窗 / 顶部 filter 工作目录回原生 <select> + sentinel + 新建「<name>」 + 二级 input(combobox 方案试过又推翻 —— 原生 select 更稳)。
  • sandbox 阻塞地位写进 DESIGN(§7.7 hard prereq / §7.8 风险行 / §7.9 取舍):tools/shell.py::BLOCKED_PATTERNS 是 trivial-bypass 装饰品(命令注入图灵完备,黑名单 fundamentally broken),不继续加规则。正确防线在 OS 层 §7.5(docker exec + drop ALL caps + read-only + egress allowlist)。本地 dogfood blast radius 限自身;SaaS 外部开放才是 hard prereq。
  • system prompt 注入 task 预选 skill 提示:_build_system_prompt 加 task_skill 参数,非空时加一行事实,与 general_v1 已有"对应 skill 先 load"规则组合 → 主动 load。否决"完整 SKILL.md 预注入"(把 skill 从 metadata 升格成 binding,投产比不划算)。
  • imagegen skill 加 ⛔ 调 tool 前必须贴 prompt + BLOCKING 等确认硬约束:清楚的描述也可能模型与用户脑里对不上,事后看图才发现白烧 ¥0.22 —— 把"模型脑内装配"摊到对话层让用户最后过一眼(装配 ≠ 授权调用)。诊断五维 → 六维加"比例 / 尺寸";general_v1 改"调 seedream 前必须先 load_skill('imagegen')",description 扩 17 触发词。
  • 新增 imagegen skill(引导用户说清楚生图需求):单文件五步法(诊断模糊度 → 给推断 + 待确认 → 用户拍板 → 装配 prompt → 调 seedream),防一句"画个 XX"直接烧 ¥0.22;mermaid vs seedream 选型三段式。
  • 登录页加"+ 管理员添加用户"入口 + 删 chat meta 条/tok 显示:web/auth.py::create_user(CLI / web 共用)+ POST /v1/auth/admin/create_user 校验 ZCBOT_ADMIN_TOKEN 共享口令。否决 User 表加 is_admin 列 + 管理员 JWT(开发期成本不划算)。
  • 新增 documents skill(内部材料学科知识库 document_search API):skills/documents/{SKILL.md, client.py} 四函数,Bearer 认证;search 返整篇 Markdown(50K-200K 字符),反模式约束只 print 前 300 字防爆上下文。库实为 7 材料学科英文学术论文 21W+ 文件 + 跨语言语义检索(原写"主语料中文"是错的);与 research(OpenAlex)互补。
  • dev SPA SSE 客户端重连(覆盖 --reload 抖动):fetchSse 拆 consume + 重连壳(1/2/4s 退避 ×3);后端 stream_events 入口检 run_status,非 running 立即吐 done 关流(防进程重启后无限挂 ping)。断开期 LLM delta 丢失,接受。
  • research skill fetch_pdf 改走静态直链:从 paper["pdf_url"] 流式下载,绕开 paper_pdf_view 路径 bug(disk 路径计算错);smoke 5/5。
  • research skill list 端点加 pdf_url / xml_url 直链 + 新增 fetch_xml + pg_trgm GIN 索引:后端拼直链(避免 stale URL),GIN 把 ?search 从 30s timeout 降到几十 ms;SKILL.md 加"XML 优先 PDF"(已结构化免 OCR)。
  • 顶栏 token 累计修(sync_task_tokens 改走 messages SUM):切 streaming 后内存计数器永不更新,删 TokenCounter 类改 SELECT SUM(...) FROM messages 现算,backfill 4 task。
  • 同 wd 并发软警告 banner + /v1/tasks 加 run_status 筛选:Claude Code 同款"信任 + 软警告",selectTask + SSE 收尾拉同 wd running task 黄底提示。否决硬挡 / short_id 全产物隔离 / clone task 三方案(DESIGN §7.9)。
  • paper_server → research skill:范式判断走 skill(非 tool / MCP / 裸 httpx),skills/research/{SKILL.md, paper.py} 三函数;run_python 注入 PYTHONPATH=base_dir;paper_server 补 retrieve 端点 + serializer 加 abstract。

2026-05-20

  • dev SPA artifact chip 演进(同质合并):对话内 tool_call/result 挂产物 chip,extractArtifactRels 正则锚 <wd>/... + 末段需含 .;门控多次校准后落到产物工具白名单 ARTIFACT_PRODUCING_TOOLS={seedream,seedance}(通用工具 echo 路径不误挂),assistant 正文不门控走 seenRels 去重 + allowInlineMedia 防同图二次 inline;.art-chip 点击委托 openFilePreview。
  • CLAUDE.md 加"实施前先对方案"段:非平凡改动动手前先口头对方案。
  • loop.py tool message 补 name 字段 + backfill 历史:OpenAI tool spec 本有 name,缺它致历史回放无 banner / chip,一行 fix + 幂等回填 17 条。
  • dev SPA 输入区删上传按钮 + 加"✨ 润色"按钮:POST /v1/tasks/{id}/optimize_prompt 走 task model_profile 装配 LLM(meta-prompt 含当前模型 + image variant),计费 kind=prompt_optimize,不调 sync_task_tokens 不污染顶栏。
  • 顶栏加生图模型下拉 + 中间产物图片/视频内联展示:GET /v1/image_models 扫 yaml image 段,build_agent(image_variant=...) 装 SeedreamTool;renderArtifactBarHtml 按 _categorize image/video 走 blob URL inline,切 task 回收 blob。
  • LLM 调用切 streaming(cancel 秒退)+ 发送/停止合并单按钮:chat_stream(stream=True, include_usage=True) + litellm.stream_chunk_builder 拼回,chunk 间 poll cancel;前端打字机靠 _emit("text", delta=...);#chat-action 按 state.streaming 切三态。
  • dev SPA seedream tool 透明性 banner:tool 返串首行 [seedream] model=... · size=... · cost=¥... · elapsed=...s,前端正则 parse 挂折叠态徽章。
  • 豆包 Seedream 5.0 接入 + 0007 cost_usd → cost_cny 全表统一币种:config/media/doubao.yaml 独立命名空间(ARK_API_KEY),tools/seedream.py 走 ark_client 调 /images/generations,产物落 <wd>/figures/;record_image_usage snapshot 单价进 units(调价防漂移);0007 全表 ×7.2 折 CNY;仅 ARK_API_KEY 设了才挂。
  • POST /v1/files/delete 加 recursive + 顶层目录 task 引用闸:recursive=True 走 shutil.rmtree;顶层目录被 task 引用 → 409"先 DELETE task 再清"。
  • fs tool 输出渲染 user_root-relative 路径:tools/base.py::Tool 加 user_root + _display(p) helper,fs 五 tool 走 helper;chip 锚点取末段。消 chip 404 + 防 uuid / 部署根泄漏。
  • POST /v1/tasks/{id}/clear 清空对话:同事务 lock + 检 running 状态 + DELETE messages + reset task 三列累计 + run_status='idle';usage_events 全不动(账单 source of truth)。

2026-05-19

  • 0006 模型切换(c 模式 task 级 A 粒度)+ usage_events v2 表:tasks.model_profile 变 source-of-truth,顶栏下拉 PATCH 即换(下条 send 生效);GET /v1/models 扫 yaml;message 历史按 messages.model_profile 切换点画 ── DeepSeek V4 Pro ──;usage_events 重建多态形态(units jsonb,chat 已接入,媒体扩展位预留)。
  • dev SPA 登录撤回 邮箱+密码,删 invites 表:前两条"邀请码 env → invites 表"一日游撤回;复用 users.email + bcrypt;/v1/auth/login_password + user add CLI;dev SPA 双 tab 登录(last-used LS 持久化)。
  • SENTINEL user 彻底撤(数据 + 代码):web 必走 JWT 后 sentinel 无角色;DB CASCADE 删 + 10 处代码删;build_agent 加 * 让 user_id 必填(typechecker 拦多 user 函数)。
  • 任务/文件行 ⋯ 下拉菜单 + tool_result debounce 刷新右侧:单例浮层菜单(#floating-menu position:fixed)避开 pane overflow 裁剪;tool_result 事件 debounce 500ms 刷新文件 panel。
  • proposal skill mermaid 强制 + quality_check 加图相关 4 拦截 + /v1/files/download 加 Cache-Control: no-cache:模型曾写满 ASCII 字符画从未用 mermaid;render_diagrams caption 强制必填 + 同 task 唯一;quality_check 加四条(figures 有 png 但 sections 0 引用 / 围栏含 box-drawing / mermaid 缺首行 caption / caption 撞名)。
  • dev SPA 文件预览弹框:点击不再直接下载,90vw 模态按扩展名分派(image/pdf/text/md 已有 / docx 用 docx-preview / xlsx 用 SheetJS);vendor 入 git(~1MB)。

2026-05-18

  • 入口归位:cli.py→main.py,原 main.py→core/agent_builder.py,删 CLI REPL,§7 E 撤:main.py 原混三角色按 SoC 拆;git mv + 5 处 import 修;CLI 只剩 db / probe / web / user。dev SPA 已是 dogfood 主路径,REPL 无 --remote 双 transport 维护税。
  • 0004 schema 大瘦身:删 runs / usage_events 旧版,合 run_status / run_error 入 tasks;路由 run_id → task_id:单活 run 形态下客户端只需 task_id;broker 全 task_id 索引 + 加 start(task_id) 清上轮 done 标记。
  • POST /v1/files/rename + 顶层目录 delete 加 task 引用闸:/v1/files/* 升格为唯一目录树 mutation 入口,DB-FS 一致性服务端内化;顶层目录走 DB-aware 分支(SELECT FOR UPDATE + running/cancelling 409 + check_no_subtask + UPDATE 先于 FS rename)。
  • task-level cancel + AgentLoop 协作式 cancel + dev SPA stop 按钮:Broker 加 request_cancel / is_cancelled / clear_cancel(per-task threading.Event + setdefault);Loop 加 cancel_check callable + _fill_cancelled_tool_results 补 cancelled tool message;LLM 同步 call 本身不可中断(后接 streaming 修)。
  • POST /v1/tasks/{id}/messages 单活 run 锁 + 孤儿 reaper:同事务 SELECT FOR UPDATE + 活跃状态检查 + 标 running 三步原子;lifespan reaper 清进程 crash 留下的 running/cancelling 孤儿。
  • proposal skill 流程图/结构图管线:render_diagrams.py 扫 mermaid 块 → mmdc / mermaid.ink → png;render_docx add_picture 识别 ![](...) 单行 + mermaid 围栏特判;图编号 ctx['fig_no'] 递增。
  • system prompt skill 机制改"可选辅助":第 14 行从"永远 load 一下"改"简单问答/读代码/改 bug 不必硬套 skill";接 GET /v1/skills 下拉。
  • GET /v1/skills + dev SPA skill 字段改下拉:lifespan 启动扫一次挂 app.state(FS 静态运行中不变);<select> 首项空值,option 文案 name — description。
  • dev SPA 全套 UI 中文化:静态 + 动态文案全本地化;技术字段(UUID / token / SSE event 名 / API 字段)不动。

2026-05-17

  • 0003 schema:name + working_dir + skill 三件套:任务标识与工作目录解耦;TRUNCATE tasks CASCADE + 字段改名 + 加 name TEXT NOT NULL;GET /v1/folders 给 dev SPA modal datalist。
  • GET /v1/tasks 分页 + 多维筛选 + ordering:{page,page_size,count,results} + 6 个 query(status/skill/working_dir/q ILIKE/ordering);allowlist 防注入;默认 -created_at。
  • task 硬删 API + dev SPA delete 按钮 + 文件 per-row 删:DELETE /v1/tasks/{id} user_id 校验 + DB 行删(messages CASCADE)+ FS task_dir 不动(同 name 多 task 共享时 rmtree 易擦素材)。
  • files API 全面 user-rooted(去掉 task_id 前置):_safe_join 边界改 user_root + dotfile 过滤(.memory/ 隐藏);dev SPA loadFiles() 不再 gate on task_id。
  • files 面板 UX 项目名 + 修 root crumb bug:cur_rel == "." 不追加无意义 "." crumb;crumbs 第一格 label 从 "/" 改项目名。
  • task_dir 改 eager mkdir:build_agent 新建分支 + create_task 都 mkdir(parents=True, exist_ok=True);name = 项目声明,目录该 task 创建时存在。
  • task = name-based 项目目录 + memory dotfile:废 UUID 派生 + tasks/ 中间层;task_dir = workspace/users/<uid>/<name>/,同 name 多 task 共享;memory 搬 .memory/ dotfile;validate_task_name 拒 . 起头。

2026-05-15

  • §7 D 阶段 /v1 JSON API 落地;Phase G Jinja2/HTMX UI 路线撤:删 templates + CSS + jinja2/markdown-it-py/pygments 依赖;SSE event 由 HTML 片段切 JSON(event: <type> + data: <JSON>);dev SPA web/static/dev.html 留作本地 dogfood 主路径。
  • §7 D' 过渡 auth(PLATFORM_KEY → JWT)+ dev SPA:pyjwt HS256 + AuthConfig.from_env() fail-fast;数据隔离全 Task.user_id == user_id,跨 user 视 404;SSE 走 fetch + ReadableStream 手解(EventSource 不支持自定义 header)。
  • task_dir 改相对存储:DB 存 ROOT 内→相对 posix / ROOT 外→保留绝对;core/paths.py::{ROOT, to_db_path, from_db_path} 三出口;alembic 0002 一次 UPDATE backfill。CLAUDE.md 加"开发期不写兼容层"心智。
  • workspace 布局统一 per-user:workspace/users/<user_id>/{tasks/<uuid>,memory/}/;清旧数据不留兼容。
  • litellm 启动 cost map 网络警告兜底:LITELLM_LOCAL_MODEL_COST_MAP=True 走本地 cost map,冷启动 ~5s → <1s。
  • Phase G G1-G6 Jinja2/HTMX Web UI (全撤,被 D + dev SPA 替换;沉淀的 sink / broker / no-subtask / files 安全归一保留)

2026-05-14

  • §7.1 心智模型修正:Folder-centric → Task 一等公民 + Dir 文件副视图:dir 不是 task 父容器,双视图正交;task_dir 留空 = 一次性对话 / 指定 = 项目化。
  • §7 B Steps 1-4 + 6:core/storage/{engine,models}.py SQLAlchemy 2.x ORM(5 表)+ alembic + cli db {upgrade,downgrade,current};state.json 全废,messages/TaskState 入 PG;check_no_subtask 同 user 下查前缀嵌套。

2026-05-12

  • §7 改写:platform/core 多租户方案废弃,改 user-direct(folder-centric → task-primary;task/messages 入 PG;no-subtask;hard cascade)。

历史(2026-Q1 → 05-11)

  • Phase 1-4:骨架 / 三 skill / run_python / Model Profile + Probing;ppt v3 加商务红 + apply_brand + Iconify;素材摄取改 markitdown CLI。
  • 05-06 → 05-08:Phase 6 部分(task + state.json + tokens 累计);TUI rich Markdown + spinner 实时耗时;/resume [last|<id>] + 懒创建 + _cleanup_if_empty。
  • 05-09 → 05-10:DESIGN §7 初版(05-12 重写);cli.py export + core/export_docx.py。
  • 05-11:atomic_write_text + core/memory.py(core.md 入 prompt,extended/* 索引);loop 事件流化 sink.emit 铺 SSE 路。

关键决策与偏差

项 决策 备注
工具基目录 cwd(读)+ working_dir(写) system prompt 同时注入两者绝对路径
Workspace 布局 workspace/users/<user_id>/{.memory/, <name>/} per-user 隔离;memory dotfile 防撞;同 name 多 task 共享
Eval Suite 不做 个人工具 dogfooding
版本化 prompt 直接 general_v1.md Windows 软链接麻烦,真要切再做
run_python 沙盒 subprocess + env 过滤 Docker 在 §7 C 阶段
兼容层 开发期不写 DB schema / 字段 / API 改动直接切,见 CLAUDE.md
/v1/files/* 与 DB files API 作目录树唯一 mutation 入口,DB-FS 一致性服务端内化 rename / delete 顶层目录 DB-aware
单活 run task 同时最多 1 个活 run gate 在 post_message 同事务 SELECT FOR UPDATE
LLM 调用走 streaming chat_stream + litellm.stream_chunk_builder 拼回;cancel 在 chunk 间 + tool_call 之间 poll cancel 延迟 100ms 级;content delta 即时 emit 给前端打字机
发送/停止单按钮 UI 按 state.streaming 切态;streaming 期间 Enter 不触发停止 防误触

文件清单

core/capabilities.py        71
core/llm.py                151   ← litellm 离线 cost map env + chat_stream(stream=True + include_usage)
core/loop.py               268   ← §7 A sink.emit + _stream_llm(chunk 间 poll cancel + emit delta)
core/sinks.py              101   ← §7 A
core/ui.py                  38
core/paths.py               50   ← task_dir db form 归一
core/probe.py              243
core/session.py            153   ← §7 B Step 2-3: ORM
core/skills.py              81
core/task.py                82   ← §7 B Step 3: PG-backed TaskState
core/memory.py              81   ← per-user `.memory/` dotfile
core/export_docx.py        383
core/storage/__init__.py    29
core/storage/engine.py      80
core/storage/models.py     130   ← 4 表(0004 删 runs;0005 email UNIQUE;0006 usage_events v2 + messages.model_profile;0007 cost_usd→cny)
core/storage/usage.py      125   ← record_chat_usage(USD→CNY ×7.2)+ record_image_usage(单价 snapshot 进 units)
core/storage/utils.py      136
core/ark_client.py         105   ← 火山方舟 HTTP 客户端(seedream / 后续 seedance 共享)
core/agent_builder.py      325   ← 装配 lib(有 ARK_API_KEY 才挂 SeedreamTool)
tools/{base,fs,shell,run_python,skill_tool,seedream}.py  ~640 行
main.py                    ~210  ← 入口:web / db / probe / user
db/migrations/env.py        61
db/migrations/versions/
  0001_initial_schema.py   125
  0002_task_dir_relative.py 61
  0003_task_name_and_working_dir.py 51
  0004_drop_runs_usage_events.py 77
  0005_users_email_unique.py 28
  0006_usage_events_v2_and_message_model.py 60
  0007_cost_usd_to_cny.py    40
web/__init__.py              5
web/app.py                ~1320  ← /v1 JSON API + user_id 隔离 + run lock + cancel + files copy/move
web/auth.py                ~190  ← 邮箱密码 + platform_key → JWT
web/broker.py              121   ← in-process pub/sub + cancel signal(全 task_id 索引)
web/sinks.py                21
web/static/dev.html       ~2480  ← dev SPA(3 栏 + 文件预览 + 双 tab 登录 + 选入弹框 + 发送/停止单按钮 + 流式打字机)
web/static/vendor/        ~1 MB  ← jszip / docx-preview / xlsx
─────────────────────────────────
Python 合计              ~3400 行(+ dev.html 1700 静态 + vendor 1MB)

加 skills/ppt|proposal|coding|research/ 脚本 ~700 行 + SKILL.md / references / config / prompts(含 config/media/doubao.yaml)+ alembic.ini,总仓库约 3800 行。

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

  1. 真 OIDC 接入 + CORS 收紧(~1 天)—— /v1/auth/login 内部换 OIDC ID token 校验(路由层 Depends 不动);CORS 改 platform 域名 allowlist。真发布给真实用户前必做。
  2. §7 C Executor + sandbox(~3-5 天,按 DESIGN §7.5 落地清单 6 条逐项实施)—— run_python/shell → Executor.run(...),本地保留 subprocess、SaaS 走 docker;api_key_env → KeyProvider 运行时注入。多用户在线跑代码前置。Stage C 完成 DoD = 6 条落地清单全完成 + 红队回归用例通过:① 容器内 curl http://169.254.169.254/... → timeout / connection refused;② 容器内 psql postgresql://<zcbot_pg_host>... → IP block(连接失败);③ 容器内 nohup sleep 1000 & exec 退出后 docker top <user_container> 看不到残留进程;④ 跨 user 容器互访(A 容器 curl http://<B_container_ip>:*)→ 网络隔离阻断;⑤ 出网走 proxy 时未在 allowlist 的域名 → 403。原 ~2-3 天估值未含 egress proxy 部署 / xfs project quota 升级 / 红队用例,补回真实工程量。
  3. Phase 6 context 三层压缩(~1 天)—— 兜底,V4 长上下文一般用不到。

§7 B + D + D' + 单活 run 锁 + cancel + 0004 schema 瘦身 + 入口归位 主体已完工。剩余:真 OIDC → C(Executor)→ F(deploy / billing)。§7 E CLI 双模式撤;Phase G Jinja2/HTMX 撤(详见 DESIGN §7.9)。