前言¶

在 DeepSeek Harness（DSH）里，常见用法是一条指令占满主 agent 一整轮：你发任务，它忙完，你再发下一条。若目标是「把某件事做到指定标准，并在预算内反复试错改进」，人就要一直盯着对话、一次次催进度。

dsh-loom 把「一句目标 + 预算」变成后台可重复执行的工作链，在子会话里一轮轮迭代，主 agent 大部分时间保持空闲；只有晋升补丁、预算不足或循环卡住等判断，才通过检查点叫醒你。全过程落在 append-only 事件日志里，便于回放与审计。下面介绍它是什么、能做什么、如何安装与启动一次典型战役。

这是什么¶

dsh-loom 是维护者 DarknessLED 发布的 DSH 工作流插件（社区目录：skillhub 条目，源码：GitHub）。定位是 Human-in-the-loop recursive self-improvement for DeepSeek Harness：主 agent 交出一个客观目标与预算后，插件在 child session 中执行「侦察 → 多候选 → 机械验证 → 评分 → 晋升」链条，并在多轮中于上一轮产地上继续改进。

名字取自「织机」：经线是目标与预算，纬线是每一轮工作链，人主要负责换梭与验收（接受补丁、调预算、解开卡点）。

当前 README 标明能力已贯通 M0–M8 阶段（战役生命周期、事件日志、worktree 隔离、检查点、成本核算、知识树、Lean 数学门、链条自优化、侧栏 RSI 面板、多窗口与 chaos 加固等）。插件版本 0.2.1（2026-11-10），许可证 MIT；依赖 dsh >=0.2.0-rc.2 <0.3.0-0，Node ^22.19 || >=24。

它解决什么问题¶

与普通「一问一答占满主回合」相比，RSI 形态期望：

1. 人说一句「把 X 做到 Y 水平，预算 Z」；
2. 系统把这句话变成可重复执行的工作链；
3. 链条在后台一轮轮跑，在前一轮产地上继续改进；
4. 主 agent 不参与每一轮，大部分时间为空闲；
5. 仅在补丁是否接受、预算是否加码、循环是否卡住等节点通过检查点唤醒人；
6. 每轮写入 append-only 事件日志，可回放、审计、复现。

README 强调：这是 DSH 里的真实能力（工具、子会话派发、面板），而不是提示词模板。

核心功能（资料已核实部分）¶

战役与工作链¶

• 战役（campaign）：创建、暂停、恢复、停止、改预算、加约束。
• 工作链 spec 含 agent / verifier / human / map 四类节点，并提供经验模板（如 code-fix）。
• 每轮：git worktree 隔离 → 子 agent（provider spawn）→ 机械验证 → diff → 评分 → 晋升门；验证通过、有补丁且不劣于 incumbent 时可 autoApply，否则挂检查点等人决策。

可观测性与工具面¶

插件向主会话暴露一组工具，包括但不限于：rsi_start、rsi_status、rsi_control（含全局循环开关）、rsi_run、rsi_chain、rsi_evalset、rsi_decide、rsi_report、rsi_lean、rsi_replay、rsi_dashboard、rsi_export、rsi_doctor。

• rsi_doctor：开工自检（git 仓库、工作区是否干净、Node、loom home 可写、当前窗口是否持有循环等），失败项附带可执行 fix。
• 事件日志：append-only ledger + 纯函数 reduce，物化视图 views/state.json。
• 成本：汇总子会话 assistant/message.usage，按可配置单价折 USD，双预算闸门。

人与主 agent 的交互边界¶

需要人拍板时写入 checkpoint.raised，并通过 sessionController.prompt(mode:"queue") 向发起战役的会话投递消息——README 写明这是唯一会叫醒主 agent 的路径。人可用 rsi_decide(decision:"approve" | "reject" | "stop") 处理；approve 时插件将补丁 git apply 进工作区。

循环调度与总开关¶

• 默认约每 20 秒 tick 一次，对 running 战役推进一轮（一次最多 candidates 个候选，各自 worktree + 子会话）。
• 全局开关写在 ~/.dsh/loom/switch.json，翻转不写进战役日志；rsi_control(action:"disable" | "enable") 控制是否继续派发，历史 seq 不偏移。

侧栏 RSI 面板（M7）¶

重启 DSH 后，侧栏可出现 RSI 入口；面板约每 5 秒轮询状态，支持 pause / resume / stop 与 approve / reject。多窗口时仅心跳最新的窗口驱动循环，旧窗口只读观察。面板文案为中文，状态词有固定译名。

数据目录¶

战役与账本数据默认在 ~/.dsh/loom/，可用环境变量 LOOM_HOME 覆盖；删除该目录即清空插件数据，不影响 DSH 本体。

安装与启用¶

从 GitHub 安装（README 给出的当前可用方式）：

dsh plugin --profile desktop add DarknessLED/dsh-loom

也可将 dsh-loom 手工加入 profile 的 dsh.profile.bundles；仓库根目录的 cordis.patch.yml 为 bundle manifest，dsh plugin add 会识别。

README 另说明：收录插件市场后，可在「设置 → 插件 → 插件市场」搜索 dsh-loom 一键安装；目录元数据见 awesome-dsh-plugin 仓库中的 data/plugins/DarknessLED__dsh-loom.yml。

安装后需重启 DeepSeek Harness 方可生效。

典型用法¶

下面步骤摘自 README 的「一次典型使用」，展示立项、注册评测任务、激活链条并启动循环。

1. 立项（可自动提议 code-fix 模板链）

rsi_start(objective:"把 src/parser 的测试覆盖率做到 90% 以上，不许改公开 API",
          workspace:"C:/Projects/demo", budgetUsd:3, budgetRounds:10, template:"code-fix")

2. 注册任务集（每任务含提示词与机械验证器）

rsi_evalset(action:"register", tasks:[
  { id:"t1", prompt:"补 parser 对行内注释的测试", verify:{ cmd:"npm test -- --coverage", timeoutMs:600000 } },
  { id:"t2", prompt:"补 parser 对嵌套模板字符串的测试", verify:{ cmd:"npm test -- --coverage", timeoutMs:600000 } }
], holdout:["t2"])

3. 激活链条并开跑

rsi_chain(action:"activate", version:1)
rsi_control(action:"start")

之后插件按 tick 自行推进；可随时 rsi_status / rsi_report 查看，不打断循环。若需暂停整夜派发：

rsi_control(action:"disable", reason:"今晚不跑")
rsi_control(action:"enable")

开工前建议先跑 rsi_doctor，确认 git、Node、loom 目录与窗口所有权满足运行条件。

适用场景与注意¶

适合谁

• 已在 DSH 上开发或运维 agent，希望在美元与轮次预算内，让代码修复、测试补强等任务自动多轮候选与机械验证，且只愿在晋升、卡点处介入的人。
• 需要可审计、可回放迭代过程，而不是单次对话里口头总结进度的人。
• 愿意维护 git 干净工作区、为评测任务编写 verify.cmd 等机械门的人。

务必注意

1. 权限：插件以当前 DSH 进程权限运行，子会话可执行你配置的验证命令、改写 worktree；安装前应阅读源码与 MIT 许可证，确认命令与路径可信。
2. 环境：目标 workspace 应为 git 仓库；验证器超时、预算耗尽会触发检查点或停止，需提前设好 budgetUsd / budgetRounds。
3. 版本：package.json 要求 dsh >=0.2.0-rc.2 <0.3.0-0 与 Node ^22.19 || >=24，与 README 徽章一致。
4. 生态：DSH 社区插件目录（如 skillhub.cn）为独立站点，与 DeepSeek / 幻方无官方从属关系；本文安装命令以 README 原文为准，勿自行拼接未在资料中出现的 dsh plugin add github:... 形式。

结尾¶

dsh-loom 把 RSI 做成 DSH 内可持续运转的工作链：主 agent 空闲，子会话迭代，人只在检查点决策，事件日志全程留痕。若你要在 Harness 里试一轮「目标 + 预算 + 可验证任务集」，可按上文安装、自检后 rsi_start 立项。

• 目录页：https://www.skillhub.cn/plugins/DarknessLED/dsh-loom
• GitHub：https://github.com/DarknessLED/dsh-loom