dsh-tree-harness
DSH(DeepSeek Harness)树形任务分解执行 Harness + 插件集合。 A tree-structured task decomposition & execution harness for DeepSeek Harness, plus a small collection of DSH plugins.
本仓不是一个单一插件,而是一组围绕「树形任务执行」的包、规约与文档:任务分解 → 分层派发(子智能体嵌套)→ 执行 → 分任务类型验证 → 收割回流,外加自省层与会话树视图。
🗺️ 项目全景地图:一页看懂本项目的组件全景、工具面、真机流程、机制与已知边界——docs/project-map-2026-11-11.html(单文件 HTML,离线可读;在线版)。 Project map: one page covering components, tool surface, real-machine flows and known boundaries — open docs/project-map-2026-11-11.html.
- 许可证:MIT(见 LICENSE)
- 状态与测试数字为 2026-11-15 实测快照(各包
package.json版本为准;Wave-2 收口见 docs/reports/wave2-closeout-2026-11-12.md) - 公开范围:仓库内资料公开(公开前已排除隐私截图与第三方源码,见 agent.md 决策 D7)
- 代码零 npm 依赖:不 import 任何
@deepseek-ai/*包,仅通过宿主ctx使用 DSH 原生服务(subagents/timer/storage/tools/sessionQuery等)
组件与状态
| 包 | 版本 | 能力 | 测试 | 当前状态 |
|---|---|---|---|---|
packages/dsh-tree-engine |
0.13.0 | 执行层:9 个 tree_* 工具(tree_plan / tree_node / tree_dispatch / tree_report / tree_status / tree_verify / tree_log / tree_maintain / tree_doctor 只读自检),含依赖编排、竹节接力(上下文自动换棒)、对抗式验证、差分金标准、leaf 写面护栏(LEAF_WRITE_MATRIX);Wave-2 增补:W2.1 会话预算计入竹节链(runtime.segmentChain 归一化去重)、W2.3 RC2 兼容层抽 src/compat.js(双形探测 + 11 测)、W2.6 root/主会话 id 归一化(session- 前缀与裸 UUID 等价比较);v0.8.0 组合修复:per-leaf relay 开关(tree_node {action:"set-relay"})、tokenMeter 测量端口修复、sweep 跨实例(热更僵尸)生命周期、relay parent 重解析;v0.8.1 深度预算:派发/竹节接力/攻击审计会话显式传 maxDepth(缺省 5,TREE_ENGINE_CONFIG.max_subagent_depth 可覆盖;此前插件派发路径无平台深度兜底);v0.9.0 硬安全与可观测性:跨进程 .lock 文件锁(O_EXCL + 陈旧接管 + 心跳)、nudge 强制 prune 走状态机、leaf:add 字段白名单(13 键 fail-closed)、tree_log 事件 meta 机读化、tree_maintain {action:"verify-delegate"} 验证授权委托;v0.10.0 flash 审计第二批:依赖闸「已验证失败不放行」+ sweep stale-done 判据、set-verification verdicts/pass 一致性、竹节接力会话预算/唯一性预检 + 单账本口径、audit_meta 严格校验与放宽留痕(含 #23 阈值回退修复)、subagent_spawn 仅 owner、fsStore.read .tmp 灾备恢复、tree_maintain {action:"gc"}(archived 账本截断)+ call-log 10MB 滚动;v0.10.1 宿主 rc.3 适配:startActivation 扁平 spec(buildActivationSpec,嵌套形状真机全量失败修复);v0.11.0 /tree-panel 只读 HTTP 投影路由:GET /tree-panel/trees、/trees/<treeId>、/trees/<treeId>/events(webServer 可选注入缺席降级不阻断工具面;Host/Origin/Sec-Fetch-Site 三重校验 + no-store + 不回 ACAO;投影纯函数 src/panel-view.js 脱敏截断——不透出 prompt/meta/环境变量,preview 120/200 字符上限);v0.12.0 派生展示态:status 改为派生口径(runtime.state + verification.pass + last_event_type=done;raw 存 rawStatus),counts/byStatus 同口径,完成叶不再显示 pending;v0.13.0 树级状态:投影新增 state(treeStateOf 派生——root 容器只参与失败判定,不再把已完成的树标成 running;真实 36 棵树的 running 徽标 29→7);随包 tree-commander/tree-worker Skill |
258/258 | ✅ 运行中(本机 desktop profile 已装载) |
packages/dsh-agent-introspect |
0.1.0 | 自省层:self_spec 工具,投影当前会话的 model / permissions / sandbox / cwd / token 用量 |
—(无单测) | ✅ 运行中 |
packages/dsh-session-tree |
1.8.1 | 会话树单包:左栏嵌套会话树 + 会话界面底部元数据条(model / reasoning effort / 上下文 %;子会话补官方缺失的 model/effort,只读子会话用标题栏 chip 兜底) + Tree Runs 面板(v1.5.0):conversation.composer.dock 入口 pill(order:6)+ 右栏页签席位(kind tree-runs,右栏服务缺席降级 shell.overlay 并延迟补挂;数据 = 同源 fetch /tree-panel/*)+ v1.6.0 面板 v2:Flow Runs 同款多区域面板(列表+树图+详情分栏同屏、依赖 DAG 树图可缩放平移)+ v1.6.1 修复:面板裸文本(样式表自打 data-plugin 归属 + 陈旧 sheet 就地刷新)与入口 pill 内联照抄 Flow Runs+ v1.6.2 树形任务链:按 parent 链分层出从属关系(实线 parent 边 + 虚线依赖边,重合只画实线)、点节点/行在下方看 17 项属性(selectLeaf 状态、切树归零、幽灵详情清理)+ v1.7.0 树级状态与自证:列表徽标改用服务端派生 state(root 容器不再恒 running)、详情栅格拆 Tree state / Leaf states 两行、页头渲染客户端构建版本(旧 bundle 一眼可辨)+ v1.8.0 树图高度:视口显式高度(默认 420px、拖 10px 分隔条调 220–900px、localStorage 记忆)+ 打开/换树即按视口 fit 全图(不再被 flex 挤成一条缝),TreeGraph 收成单个 graph section+ v1.8.1 图内节点点击:视口曾把 pointerdown 直接 setPointerCapture,浏览器把后续 click 重定向到视口 → 节点 onClick 永不触发(列表行未捕获所以能点);改为拖拽 4px 阈值后才武装捕获,点图内节点即选中并出属性+ tree_send 跨层级消息工具(v1.4.0 起仅同树投递、移除 parent 入参、调用者谱系校验)+ session_handoff 会话自交接(同层级接替,继承工作区 / Agent 预设 / 权限模式 / 模型 / 思考等级)+ 随包 session-handoff Skill;接替提示语跟随 DSH 界面语言(zh/en);工作区排序 / 隐藏恢复 / 检索召回;v1.4.1 修复:rail 收起态 hook 数量崩溃(React #300/#310,侧栏收起即触发,v1.1.0 起潜伏) |
包内 9 个测试入口(handoff 41/41、tree-send 25/25、meta 41/41、render 153/153 + 9/9 + 11/11、panel-render 98/98、style-guard 51/51、verify-bundle 0 fail、provider-conformance 29/29) | 🌐 GitHub 公开(镜像 v1.4.0 = 0343f0c,main + tag,21/21 SHA)、社区市场已收录;npm 未发布;v1.5.0 / v1.6.0 / v1.6.1 / v1.6.2 / v1.7.0 / v1.8.0 / v1.8.1 未发布镜像 |
状态口径:
- 运行中 = 当前本机 desktop profile 已装载,并通过活体检查(
cordis_inspect_*读到对应工具 / provider)。 - npm 未发布 = 刻意的安装策略(只走 Git /
link:),见 docs/guides/publishing.md;决策 D3。
快速开始
只想用 Skill、不想读源码? 直接看 docs/guides/skills-usage.md——三个随包 Skill(
tree-commander/tree-worker/session-handoff)的安装、发现、最小提示词、三层任务树、50% 交接、语言与排障都在那一页。
三条安装路线(按需选择)
| 路线 | 适合 | 得到 | 入口 |
|---|---|---|---|
| A. Git URL 装 session-tree | 普通用户/只想要会话树与交接 | 侧栏会话树 + tree_send + session_handoff + session-handoff Skill |
Plugins 页粘贴仓库 URL;Agent 看 AGENT-INSTALL.md |
| B. 本地链接 monorepo(全栈) | 要完整树体系(任务树/竹节/验收)或参与开发 | A 的全部 + tree-engine 9 个 tree_* 工具 + tree-commander/tree-worker Skill + self_spec |
安装指南 §3 |
| C. 市场/社区目录 | 已在第三方 DSH 插件目录里浏览 | 同 A(按 package.json.version 判断更新) |
市场 listing 指向公开镜像仓 |
完整、逐步的人类安装指南:docs/guides/install-guide.md。给 AI Agent 的安装/验收/排障矩阵:packages/dsh-session-tree/AGENT-INSTALL.md(随包发布到公开镜像仓)。
前置
- DSH 桌面版
0.2.2-rc.1(Cordis 插件宿主 + Web GUI) - DSH 自带的 Node v24 runtime(实测 v24.21.0),无需额外安装;各包无 npm 依赖
- 本仓
packages/建议放在 desktop profile 的hmr.root覆盖范围内(本机即为D:/Codes/dsh-tree-harness/packages),客户端半改动刷新页面即可;宿主半(index.js)改动在本机实测需对该 bundle 做一次 disable→enable(或用新包名/重启 DSH)才加载新实现——Loader 对已导入宿主模块按包名缓存,逐条证据见 agent.md §0.2。
安装到 profile
两种方式,二选一:
A. link: 依赖 + 一次性 pnpm install(开发态推荐)
// %USERPROFILE%\.dsh\profiles\desktop\package.json(示例,按实际 profile 调整)
{
"dsh": {
"profile": {
"bundles": [
"@local/dsh-tree-engine",
"@local/dsh-agent-introspect",
"@orphiczhou/dsh-session-tree"
// 注意:bundle 顺序即装载顺序;新增 bundle 追加到此处
]
}
},
"dependencies": {
"@local/dsh-tree-engine": "link:D:/Codes/dsh-tree-harness/packages/dsh-tree-engine",
"@local/dsh-agent-introspect": "link:D:/Codes/dsh-tree-harness/packages/dsh-agent-introspect",
"@orphiczhou/dsh-session-tree": "link:D:/Codes/dsh-tree-harness/packages/dsh-session-tree"
}
}
然后使用 DSH 自带 runtime 的 pnpm 安装:
node "$env:USERPROFILE\.dsh\dsh-runtimes\dsh-primary-runtime\dependencies\pnpm\bin\pnpm.cjs" install
新增包后需一次 pnpm install;客户端半改动刷新页面生效;宿主半(index.js)改动需 disable→enable 该 bundle 条目(或重启 DSH)——2026-11-11 实测 hmr.root 并未让已加载包的宿主模块重新求值。
B. plugin_manager 热装载
// 伪调用:实际以当前宿主 plugin_manager 工具参数为准
plugin_manager({ action: "install_bundle", target: "D:/Codes/dsh-tree-harness/packages/dsh-tree-engine" })
每个包自带 cordis.patch.yml,向 profile 贡献一条 insert 行(id 分别为 tree-engine / agent-introspect / session-tree)。plugin_manager 需要宿主授予较高权限;若只想改源码热更,走方式 A 即可。
跑测试
cd packages/dsh-tree-engine
node --test tests/*.test.js # tests 258 / pass 258 / fail 0(62 引擎 + 4 技能打包 + 1 B1 回归 + 9 tree_doctor + 8 写面护栏 + 16 compat + 10 identity + 7 budget + 12 relay + 17 token-meter + 7 usage-port + 9 validate + 8 sweep + 4 depth-cap + 8 store-lock + 6 nudge-gate + 8 leaf-add-whitelist + 5 tree-log-render + 14 verify-delegate + 12 audit-p2a + 31 panel-view)
14 个
.test.js;Wave-2 新增tests/compat.test.js(11)、tests/identity.test.js(10)、tests/budget.test.js(7),原 84 项不回归;v0.8.0 再增 relay/token-meter/usage-port/validate/sweep 至 19 个.test.js/ 165 项。
⚠️ 不要写成 node --test tests:Node 24 会把 tests 当文件路径,报 test at tests:1:1 的假失败。要机器可读计数加 --test-reporter=tap,且必须放在位置参数之前(放后面会被静默忽略)。
会话树单包(packages/dsh-session-tree/)自带 9 个测试入口(其中 provider-conformance 依赖 DSH asar 解包 fixture,属环境依赖):
cd packages/dsh-session-tree
node test/handoff.test.js # 宿主半 session_handoff:41/41(交接层级矩阵/继承/工作区归属/闸门/失败可追溯)
node test/tree-send.test.js # v1.4.0 同树投递/谱系校验:25/25(跨树/显式 parent/fail-closed)
node test/meta.test.cjs # 会话元数据纯函数/只读判定(model/effort/context%):41/41
node test/skills.test.cjs # 随包 Skill 打包回归:3/3(frontmatter/files/patch 行)
node test/render.test.cjs # 确定性夹具渲染检查(153/153 + 夹具自检 9/9 + 实时附加 11/11)
node test/panel-render.test.cjs # Tree Runs 面板渲染:98/98(v1.6.0 pill/页签/降级三态 + V2 判定;v1.6.2 新增分层从属边/点击节点看属性 12 条;v1.7.0 新增树级派生态/版本标记/头部新鲜度/root 容器标注 5 条,v1.8.0 新增视口高度夹紧/Fit 缩放/持久化/resizeGraph/拖拽渲染面 5 条(V2-33..37);v1.8.1 新增拖拽阈值/指针接线/图内节点选中 3 条(V2-38..40);三态 hook 恒定按公式 A/B 断言)
node test/style-guard.cjs # 样式注入 / 所有权 / SSR 边界检查:51/51(A8=10 + A8b/c/d + A8e–i;v1.6.1 新增 A1g 自打标 + D 守卫旗标不烧毁 + E 迁移补标 + F 陈旧 sheet 就地刷新;v1.8.0 A8f 改视口高度契约 + A8f2 分隔条)
node scripts/verify-bundle.mjs # 清单自检:0 fail
node test/provider-conformance.cjs [asar 解包目录]
# fixture 解析顺序:DSH_RC2_FIXTURE_DIR → %TEMP%\dsh-asar-inspect\out-rc2-compat → out
# rc.2 兼容 fixture(schema 引擎内联布局)→ 29/29,exit 0
# 缺 fixture 或只拿到当前宿主的 shared-chunk 拆包布局 → exit 2 + 可操作报错(不崩溃);
# 属测试环境依赖,不是包内容缺陷(取证见 docs/reports/conformance-rc2-2026-11-12.md)
验证运行
| 手段 | 用途 |
|---|---|
self_spec |
返回当前会话的 model / permissions / sandbox / cwd / token 投影(effort、温度显式标注不可读) |
cordis_inspect_list / cordis_inspect_query |
可编程活体观测:列出 provider、查询 host Tool / Service / Config 与 client provider |
tree_status {action:"validate"} |
校验树状态(迁移闭集 / 依赖 / 会话 id 唯一性等) |
tree_status {action:"harvest"} |
显式收割:立即强制一轮(不必等定时 sweep;后台 timer 仍在跑) |
tree_doctor {action:"run"} |
只读自检(7 项:package / tool-count / skills / tree-data / stale / sweep / env);给 tree_id 时额外校验该树并统计停滞节点;FAIL 不 throw,只返回 summary + hint |
node scripts/check-version-consistency.mjs |
版本/文档一致性检查(W2.4,23 checks):包版本、工具数、测试数、README / SKILL / 文档索引口径是否互相对齐;--json 机读,--run-tests 追加执行测试并比对数量;0 失败才算过 |
架构要点
宿主半 / 客户端半
一个 DSH bundle 由两半组成,声明都在 package.json:
- 宿主半:
dsh.bundle.patch指向cordis.patch.yml。bundle 装载时向 profile 追加一行insert(id+ 包名),Loader 据此 import 宿主模块(exports["."])。 - 客户端半:
dsh.client(platform: "web",可带inject客户端包,如@deepseek-ai/dsh-client-ui-sidebar)。浏览器侧经window.__ModuleLoader__.load({id, factory})物化;缺inject依赖则客户端半边不加载,而宿主半边照常。
客户端半契约(踩坑记录,写进 docs/archive/handoff-2026-10-14.md §5):
factory必须return module.exports(插件对象含apply),否则整页客户端启动冲突;- 所有 DOM 副作用放在
apply(ctx)里; - 客户端半热更会残留旧实例:用单例注册表 + 令牌仲裁压制,彻底干净仍需刷新一次页面。
随包 Skill(SKILL 工程化,v0.13.0 / v1.8.1)
Skill 是插件工程的一部分,与工具同包、同版本、同发布:
| 包 | 随包 Skill | 挂载方式 |
|---|---|---|
packages/dsh-tree-engine v0.13.0 |
skills/tree-commander/SKILL.md、skills/tree-worker/SKILL.md |
cordis.patch.yml 第 2 行 insert @deepseek-ai/dsh-skill-filesystem(providerName: tree-engine、includeDefaultRoots:false、bundledSkillDir 经安装包身份解析到包内 skills/) |
packages/dsh-session-tree v1.8.1 |
skills/session-handoff/SKILL.md |
同模式,providerName: session-tree |
- 效果:新会话的 Skill 目录直接出现
tree-commander/tree-worker/session-handoff,模型在极简提示词下即可发现「分层分解 / 逐层干活 / 上下文 50% 自主交接」的用法,不需要先把工具名喂给它;真机验证见 docs/reports/skill-e2e-2026-11-11.md。 - 版本:
tree-commander/tree-worker两份 SKILL 随 tree-engine v0.5.0 引入、v0.8.0 升到 v2.2、v0.9.0 同步补「验证授权委托 / 日志机读化 / 建点白名单 / 锁语义」、v0.10.0 同步补「依赖闸/验证落账加固 / 竹节预算与唯一性 / audit_meta 校验 / GC」(9 工具、会话 id 归一化、预算口径、per-leaf relay 开关tree_node {action:"set-relay"}、tree_maintain {action:"verify-delegate"}/{action:"gc"});session-handoffSKILL 随会话树 v1.4.0(补tree_send仅同树 / 无parent入参说明)。 - 打包回归:
packages/dsh-tree-engine/tests/skills.test.js(4 项)与packages/dsh-session-tree/test/skills.test.cjs(3 项)校验 frontmatter、package.json.files、patch provider 行与旧路径清理。 - 发布:会话树单包的
skills/随package.json.files发布到公开插件仓(v1.4.0 =0343f0c,release-plugin 21/21 SHA 一致);tree-engine 为仓内插件,Skill 随本仓公开。 - 热更:新增/修改 patch 行受 D12 约束——对相应 bundle entry 做一次 disable→enable 或重启 DSH。
Loader 包名缓存(关键机制)
DSH Loader 对宿主模块按包名缓存:
- 已装载包的
index.js改动 → 单纯保存文件不会重新求值(即使包在hmr.root内;2026-11-11 实测:改packages/dsh-session-tree/index.js后活体工具仍是旧实现)。对相应 bundle 条目做一次 disable→enable(plugin_manager({action:"set_plugin", target:"include:session-tree", enabled:false})再enabled:true;tree-engine 用include:tree-engine)可加载新模块;重启 DSH 同样有效。 - 新包名没有缓存 → 普通安装即可生效。
- 本仓
packages/虽位于 profile 的hmr.root内(本机D:/Codes/dsh-tree-harness/packages),但不要把 hmr.root 当作宿主半热更保证:客户端半(client.js)刷新页面即生效;宿主半(index.js)与 bundle patch(新增/修改 insert 行,例如 Skill provider)改动请走 disable→enable 该 bundle 条目或重启 DSH,并逐条验证活体工具面/Skill 目录。 - 由于缓存按包名生效,把新功能并入已有包时不会自动替换已加载的旧宿主半;安装/升级后必须重载该 bundle 条目(本机实测 disable→enable 有效;其它路径未经实测不要依赖)。
目录结构
packages/
dsh-tree-engine/ 执行层:src/ 纯逻辑(含 compat.js / lock.js / guards.js / token-meter.js / sweep.js / panel-view.js)+ index.js 宿主适配 + tests/(27 个 .test.js + 偏差登记)
dsh-agent-introspect/ 自省层:index.js(self_spec)
dsh-session-tree/ 会话树单包(发布产物,与公开镜像仓同步;含 tree_send + session_handoff)
docs/ 规约、设计、交接(operations/)、一次性报告(reports/)、发布与审计文档
demo/ logs/ 演示产物、运行日志(SKILL 资产已随包迁入 packages/*/skills/)
scripts/ asar-tool / release-plugin / release-all(W2.7 一条命令发布)/ check-version-consistency(W2.4)
/ check-doc-links / check-md-tables / e2e/run-release-e2e(W2.5 三条真机断言编排)
文档索引
| 文档 | 内容 |
|---|---|
| agent.md | 项目代理手册(开工必读):角色授权(Lead=指挥官+架构师)、决策 D1–D17、路线图 R1–R14、工程命令、发布门禁与回滚 |
| docs/README.md | 文档总索引 + 归档规范:按 architecture / guides / operations / reports / archive 分类,新增或迁移文档先读这里 |
| docs/guides/install-guide.md | 人类安装指南:三条安装路线(Git 镜像仓 / 本地 monorepo 全栈 / 市场)、组件矩阵、验收、升级卸载 |
| packages/dsh-session-tree/AGENT-INSTALL.md | AI Agent 安装指南(随包发布到公开镜像仓):预检、装/重载/验收/排障矩阵、回滚与回报模板 |
| docs/project-map-2026-11-11.html | 项目全景地图(单文件 HTML):图文混合讲清组件/架构/真机流程/机制/边界,并分析下一步功能(离线可看,内联 SVG;在线版) |
| docs/operations/handoff-2026-11-12.md | 当前交接:Wave-2 收口状态、决策速查(D1–D14/D16/D17)、关键路径、测试/验活命令、发布流程、风险与回滚、已知边界、下一轮议程 |
| docs/operations/wave2-plan-2026-11-12.md | Wave 2 开发计划:项目地图 §9 的下一步建议/波次安排 + Wave-1 剩余项 + 新发现,逐项给 DoD 与风险 |
| docs/reports/wave2-closeout-2026-11-12.md | Wave-2 收口证据报告:W2.1–W2.8 结论表、代码变更清单、测试增量 84→112 逐文件拆分、三条脚本实测退出码、W2.6 活体前后对比 |
| docs/reports/conformance-rc2-2026-11-12.md | W2.2 provider-conformance rc.2 fixture 取证:29/29 复验、fixture 来源与 SHA-256、缺 fixture 的 exit 2 行为 |
| docs/reports/e2e-release-runner-2026-11-12.md | W2.5 发布前真机 E2E 统一 runner:三条断言的编排/汇总/artifacts、离线故障注入、replay 边界与真机触发方式 |
| docs/reports/release-automation-2026-11-12.md | W2.7 发布自动化:一条命令(预检 → 同步/SHA → 本仓 commit → 镜像 commit/tag → ls-remote)、失败即停与回滚提示、凭据纪律、沙箱演练 |
| docs/architecture/session-tree-ui.md | 会话树 UI 设计与迭代规范:client.js 代码地图、改哪里速查、GUI 迭代 7 步流程、变更记录 |
| docs/guides/skills-usage.md | 随包 Skill 完整使用指南:三个 Skill 的安装/发现/最小提示词/三层任务树/50% 交接/语言/排障/索引(GitHub 用户入口) |
| docs/architecture/session-handoff-2026-11-11.md | 会话自交接:v0.1.0 设计 + v1.2.0 并入会话树/继承修复 + v1.3.0 随包 Skill + v1.3.1 语言跟随 + v1.3.5 洁净室收口 |
| docs/reports/e2e-handoff-2026-11-11.md | 交接真机 E2E 取证:修复前 root FAIL 5/12 基线 → 修复后 root PASS 14/14 / sibling PASS 12/12 |
| docs/reports/e2e-kickoff-language-2026-11-11.md | 接替提示语语言真机 E2E:修复前 lang=en 基线 → v1.3.1 lang=zh + 接替首条中文 PASS |
| docs/reports/skill-cleanroom-2026-11-11.md | Skill 文档洁净室多轮评审:独立子会话对 GitHub 用户材料的第一/二/三轮检查与修订记录 |
| docs/reports/skill-e2e-2026-11-11.md | Skill 工程化真机 E2E:极简提示词 → skill 识别 → 三层分解/逐层干活/中间层 50% 交接(A/B/C 组) |
| docs/reports/audit-tree-system-2026-11-11.md | tree 体系一致性审计:4 BLOCK / 12 需修 / 15 建议(file:line 证据 + 修复状态) |
| docs/guides/publishing.md | 发布状态与流程:GitHub 两仓、社区市场、npm 冻结、版本纪律、公开前检查清单 |
| PLAN.md | 开发方案(工作版):范围、接口缝、验证策略层、里程碑 |
| docs/architecture/engine-spec.md | 引擎行为规约(S0 冻结):工具面、数据模型、状态机闭集、断言 |
| docs/architecture/tools-mapping.md | 工具面整合表(S0 设计稿):上游工具 → 复合工具的映射与设计 action 集;实际注册的 9 个工具以 index.js schema 为准 |
| docs/architecture/segment-handoff.md | 竹节生长机制设计(上下文接力 / 竞争语义 / 配置键) |
| docs/archive/project-restart-brief-2026-11-11.html | 项目重启简报(单文件 HTML,离线可读,含系统全景/依赖矩阵/发布现状) |
| docs/archive/handoff-2026-11-11.md | 上一版交接(已归档:已被 2026-11-12 版取代;Wave-1 状态与历史证据保留) |
| docs/archive/handoff-2026-10-14.md | 更早一版交接(历史参考:客户端模块契约 / DSH API 踩坑 / 工程纪律) |
已知边界(诚实清单)
- tree-engine sweep:宿主
timer服务可用时用它的 interval;不可用时systemClock()的进程内 60s interval 兜底(sweepMode恒为timer)。tree_status {action:"harvest"}仍可立即强制一轮;不要假设 harvest 是唯一收割手段。(早期版本的degraded:no-timer说明已过时。) - npm 冻结(决策 D3):
@orphiczhou/*候选包名在 npm registry 均 404;安装只走 Git /link:。解冻需项目所有者显式批准(条件见 docs/guides/publishing.md)。 - RC2 兼容层已补单测(v0.7.0,后续 v0.8.0 全套 165/165):DSH 0.2.1-rc.2 起
subagents.startContinuable被移除,tree-engine 的双形探测已抽到src/compat.js,tests/compat.test.js11 例覆盖双形探测 / interrupt authority 顺序 / sendMessage-prompt 回退(全套 165/165);宿主再升级仍建议先cordis_inspect_query读方法表。 - provider-conformance 依赖 DSH asar 解包 fixture,且存在版本布局漂移:fixture 解析顺序
DSH_RC2_FIXTURE_DIR→%TEMP%\dsh-asar-inspect\out-rc2-compat→out;rc.2 兼容布局(schema 引擎内联)→ 29/29,缺 fixture 或只拿到当前宿主的 shared-chunk 拆包布局 → exit 2 + 可操作报错(不再崩溃)。属测试环境依赖,不是包内容缺陷;fixture 来源与 SHA-256 见 docs/reports/conformance-rc2-2026-11-12.md,布局背景见 docs/architecture/merge-session-tree-2026-11-11.md §5。 - Wave-2 预算口径边界:
max_sessions已计入runtime.segmentChain(W2.1),但接力前旧会话只存runtime.history、暂不计(每个发生过接力的 leaf 约漏 1 个首派会话);且bambooRelay/dispatch:start本身不预检预算,只有leaf:add/set-session/segment:append/tree:register-session拒绝超限——高频接力仍可静默越过上限。详见 docs/operations/handoff-2026-11-12.md §7。 - 更细的历史边界(
artifactglob 取首个匹配可能命中node_modules、leaf.status与 runtime 终态脱节、flash 审计积压、tree_maintain gc未实现等)见 docs/operations/handoff-2026-11-12.md §7。
License
MIT © 2026 orphiczhou
No comments yet. Be the first to write one.