@local/dsh-taskforce
DSH Imperator (dsh指挥官) — 主会话统御决策、子代理军团执行的多 agent 生产工具（DSH agent preset）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:86cloudyun-afk/dsh-imperator#3b88ba73f65379ca77cde0ff2ad2978638ff199bTaskforce 以 @local/dsh-taskforce 发布，当前版本为 0.4.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
He who speaks — and legions march.
dsh指挥官 · 主会话统御决策，子代理军团执行 · 版本 0.4.1；固定兼容验收目标为官方 DSH 0.2.0-rc.2 / 0.2.1-alpha.2，Node 22/24。alpha.2 为预发布版。工作目录兼容旧宿主的原生 cwd 变量与新宿主的必需目录上下文，覆盖新建及恢复后的子代理。
0.4.1 修复当前及旧版本历史交付绕过返工、冻结证据恢复指引不可执行、控制日志失联或回包畸形后的重复派发风险、未知结果误判为连续失败，以及统计、提交时间、作用域和运维 schema 检查；启动诊断按未归属回执范围查找，避免扫描全部已归属历史。严格回执支持可信根目录别名，仍拒绝外逃链接和搬迁后的旧回执。逐项实测与审核证据见 全面审计记录。
0.4.0 增加控制操作持久日志、检查点与时间线；编码任务通过计划、实际执行回执、独立审核和主会话验收推进。可信宿主可调用持久调度队列；操作员可使用只读诊断、在线 WAL 备份、迁移预演及新目录恢复。性能改动保留分页与可变历史的完整语义，具体测量和限制见 性能记录。
一个 DeepSeek Harness 的 agent preset（附带 host 插件）：主会话亲自做只读调查、方案比较、决策和验收，子代理负责有边界的执行任务。优先复用已有执行者，不再为每个信息缺口新建代理；写文件、命令执行和宿主变更的限制保持不变。
详见 研究型编排与思考保护：当前包含派发前决策、任务合并、复用与独立审查纪律、软预算，以及 STALL 观察模式。0.3 提供独立可信宿主 durable governor core；原生 managed adapter 仍无条件关闭：0.4 已验证独立的 H01 创建准备及 H03 严格持久化读回接口，H02/H04/H05/H06 的完整宿主能力仍缺证据，预设派发没有全树硬额度保证。
真实 owner 与事实作者取自宿主 session，昵称不授予权限；可信 session/run ID 保留原值，包括首尾空白。旧未绑定任务保留兼容路径并显示警告，历史版本已裁掉的 ID 空白无法自动还原，须管理员核对迁移。
普通 task_open 的严格执行验收仍是 opt-in；新增 task_workflow_create 编码任务默认强制实际执行验证、版本比较、前置任务就绪与独立子会话审核，不能用 waiver 绕过。主会话在 task_workflow_submit 上批准计划、修改未批准计划的依赖或要求返工，owner 记录当前产物回执，独立审核者绑定当前 revision；最终仍由 task_accept 决定。见 工作流。
主会话普通开任务时设置 evidence_policy: "execution"、文件清单与固定命令，当前真实子会话 owner 用 task_verify 走原生 bash 与 approval/sandbox/guards。仅最新实际 exit 0、完整日志与当前文件/代数/owner 一致的回执可通过；默认 legacy 不升级成已执行验证，人工豁免明确标为非验证通过。见 事实库与回执。
task_board 默认25项、最大100项；默认/summary 完整工具 JSON 上限65536 UTF-8 bytes，展示截短显式标记，独立晚到 blocker 游标及详情/历史页可取回原文。详情/原文页只限条数，不承诺同一字节上限；旧宿主 board API 保持兼容。
可证明不可变的普通原生事件追加使用增量 reducer，避免复制历史前缀并增量保留 TODO 状态；中段 replacement、可变恢复 seed、Proxy、访问器、非原生迭代器与策略变化回到全量重放。前缀完整性检查仍为 O(n)，不承诺整步 O(1)，可变历史也没有统一加速承诺。执行者修改已有文件前须自己 native read；新任务/续作重新读，成功 native write/edit 后不需为连续编辑机械重读；观察缺失/版本变化须 read 并复核，shell cat/grep 不替代原生观察。固定四阶段真实模型回归需显式 opt-in；普通测试不产生付费模型请求。版本与验收状态见 0.3 验收记录。
修正候选 c237ab8 的精确解压包已通过 Node 22.23.2/24.19.0 全量原生闸和显式四阶段模型验收：58条 native stream 请求、215946ms，1名执行者复用两次、3任务owner匹配且accepted、无waiver，strict回执有效；全部运行/usage/路由错误计数为0。验证器在公开全局stream边界核对8192容量并拒绝辅助调用，生产compaction保持原样。历史55条普通agent样本及六次失败278条（合计333条）保留，旧辅助调用覆盖不完整、发生情况与usage未知；不能用新58条证明历史provider总量完整。这属于历史 0.3 验收，不能作为 0.4 真实模型回归证据。精确 SHA、用量观察范围和非受控比较限制见验收记录。0.4 的独立审核、实际 CI 及未验证项见 升级交付记录。
imperator doctor 只读检查，backup 包含已提交 WAL，preflight 在副本上迁移预演，restore 只发布到新目录。恢复保留历史路径审计，严格证据须在新位置重新验证；已交付编码工作流须先由主会话要求返工，消耗剩余额度，再重新认领、验证、交付和独立审核。node tools/imperator.mjs doctor --root /absolute/taskforce --json
node tools/imperator.mjs backup --root /absolute/taskforce --out /absolute/new-backup --json
node tools/imperator.mjs preflight --root /absolute/taskforce --json
node tools/imperator.mjs restore --backup /absolute/backup --out /absolute/new-staging-root --json
0.4 普通验收不发模型请求。当前开发运行环境启动失败，生产部署入口、失败 run/child ID、日志和模型凭据就绪状态未提供；实际生产崩溃复现、升级部署与本版本付费模型长任务验收尚未完成。隔离原生测试和故障压力测试的结论只适用于其记录的范围。
| 层 | 学自 | 管什么 |
|---|---|---|
| 编排层 | dsh-redteam-mode（github.com/Jueze-2019） | 谁派活、派给谁、并发、事实落库、核对纪律 |
| 注意力层 | 梁神模式 @linxin666/dsh-liangshen（MIT） | 工具面多大、系统提示词多长、事实钉在哪、退化如何熔断 |
redteam 解决"谁干活"，梁神解决"干活时脑子还清不清醒"。两者叠加才是长任务多 agent 的完整形态。
orchestrator-scope 的工具过滤和执行守卫继续阻止命令、写入及宿主变更。continuable：工具只返回 childId 不返回结果；子代理结算由 runtime 作为服务通知投进父会话 turn stream。所以主会话天然不阻塞，且能在干别的活时收到结果。host 平面（cordis.patch.yml）
taskforce → lib/index.js 声明 agent preset 给 ctx.agentPresets.register
taskforce-store → lib/store/ SQLite 事实库，发布 ctx.taskforceStore
agent 平面（lib/preset.js 的 29 行）
persona 编排者人设（本 preset 的全部系统提示词基底）
tool-presentation native（执行守卫独立于呈现模式）
agent-instructions 工作区指令（AGENTS.md 链）
tool-bash/fs/fs-search/str-replace-editor/jobs/skills/goal/plan/todo/web/ask-user
delegation（isolate: workflowEngine）
subagent(subagent) maxDepth: 2 · continuable · 执行者 persona
subagent_fork(fork) maxDepth: 2 · continuable · 执行者 persona
subagent-control / list-agents
compaction（isolate: compaction+toolResultPruner）
taskforce-tools ← 消费 ctx.taskforceStore，注册 15 个模型可见工具
taskforce-working-context ← 每步钉一行客观状态
taskforce-guard ← 运行时退化断路器
taskforce-orchestrator-scope ← 只收窄主会话，子代理不受影响
为什么 store 在 host 平面：preset 是 standing mount、被 roster 挂一次而覆盖每个 join 上来的 agent；preset 内任何 provide() 服务的行必须位于带 isolate 的 group 内，否则 mountPreset 直接抛 Preset services require isolate realms。跨会话服务按 registry 要求落在 host。
操作员决定"子代理侧限制不照搬 redteam"，已落实为：
| 项 | redteam | 任务部队 |
|---|---|---|
| 子代理层级 | maxDepth: 1（叶子） | maxDepth: 2（保留能力，默认不主动嵌套） |
| 委派工具可见性 | toolFilter.deny [subagent_fork, workflow, ralph] | 零 deny |
| 并发 | 自建闸门压到 3、默认顺序派 | 纪律上限：只读 ≤6 / 含写默认 ≤2 / 同资源串行；不是已实现的硬闸门 |
并发值是可调整的编排纪律，不是经过负载实验得出的最优值。spawn/fork 都显式指定最大深度 2，不依赖第三方宿主补丁。
三条原生通道里，派活只保证"已启动"、消息只保证"已接受"、结算通知只投一次 —— 只有共享状态是持久的。
$DSH_HOME/taskforce/taskforce.db（config.root > $TASKFORCE_HOME > $DSH_HOME/taskforce > $HOME/.dsh/taskforce）task / fact（kind ∈ fact,artifact,decision,blocker；confidence ∈ CONFIRMED,PLAUSIBLE,REFUTED）/ handoff + 视图 v_task_boardctx.taskforceStore）：openTask / claimTask / recordFact / recordHandoff / closeTask / submitTask / acceptTask / rejectTask / taskOf / board / stats / workingStatetask_open / task_claim / task_fact / task_submit / task_accept / task_reject / task_close（submit 的兼容别名）/ task_board / task_child_send / task_child_stop / task_verify / task_checkpoint / task_workflow_create / task_workflow_submit / task_workflow_statetask_child_send / task_child_stop，见 docs/CONTROL.md。状态机与验收门槛（docs/STORE.md 有完整的状态 × 动作表）
open → claimed → submitted → accepted，另有 rejected；终态 = accepted / cancelled / done / partial / failed。
task_submit（提交待验收）；只有主会话能 task_accept / task_reject（身份判据在工具层强制，不靠提示词）task_accept 被拒（E_EVIDENCE_MISSING，不是 warning）；自动写入的验收记录是 decision + PLAUSIBLE，不会冒充 CONFIRMED 事实。合法的人工豁免走 waiver_reason，来源可辨rejected 任务更换 owner；状态、decision 与 handoff 同事务写入。close(failed) 先查原状态，对终态一律 E_TERMINAL）blocker 允许落库并标 late=true，任务出现在看板的 late_blockers 区（不静默隐藏），但结论不变；要推翻已验收结论，走显式重新复核（主会话 task_reject，任务回到待办）accept；解阻塞 = 落一条 decision 且带 resolves_fact_id 指向它E_CROSS_RUN（读 / 落事实 / 结任务三条路径共用同一拒绝点，文案点名双方 run）。注意区分：跨会话操作别人的子代理是子代理平面的 E_CHILD_NOT_OWN，两码不合并落库契约：子代理的交付物是库里的行，不是它说的话。主会话核对 = 读 task_board 并对证据文件，不是复述汇报。
taskforce-working-context：每步把一行客观状态钉在最新消息尾部，从持久事件流折叠（resume / 压缩后结果一致），只在变化时重发布。taskforce-guard：区分 STALL（零输出长推理的启发式信号）与 ECHO（同工具同参数连续失败）。本 preset 显式设置 stallAction: 'observe'、stepDownRequests: 0：STALL 只记录诊断、不注入打断消息；ECHO 仍提示停止重复失败调用；两者都不降低路由选定的 reasoning effort。独立使用 guard 且不提供新配置时，保留旧版打断与降档默认值。taskforce-orchestrator-scope：可见性过滤与执行守卫分开，主控在 native 和 PTC/both 下均拒绝 run_code、命令、写工具及默认宿主变更入口；子代理保留执行权限。推理长度和没有可见输出不能证明思考无效。观察模式保护正常研究，但也不自动终止真实的零输出循环；宿主的超时、取消和预算控制仍然必要。
见 整仓补强与验收边界：事实与任务双重归属过滤、异常验收保护、回滚失败的连接清理、单查询工作投影、派发估计去重和超时判定。CI 保留与实际检出版本绑定的源码及日志验证包 7 天；不是部署记录或真实模型效果报告。
安装包包含源码、文档和完整验证脚本；CI 解压实际 npm 归档后再进行真实宿主验收。 详见 安装、验证与回滚。
npm test
npm run test:all -- --install-anchor /absolute/path/to/@deepseek-ai/dsh/package.json
不传 anchor 时可从 PATH 的 dsh 安装发现；显式路径错误时不会悄悄回退。
npm test 中的宿主 UNVERIFIED 和仅宿主用例 SKIP 不算原生通过；test:all 要求预设契约、原生边界、真实 web boot 和 standard/TaskForce 切换隔离均成功。
在仓库根目录执行，原生验收需官方 DSH 0.2.0-rc.2 或 0.2.1-alpha.2 + Node 22.23.2 / 24.19.0。子 shell 保留调用者环境，退出时只清理本次创建并验证的临时目录；全程使用临时 DSH_HOME，不发模型请求、不需要 API key。
(
set -euo pipefail
# 1. 先创建并验证本次专用目录，再打包；任一步失败立即中止
SMOKE_PARENT="$(cd "${TMPDIR:-/tmp}" && pwd -P)" || exit 1
SMOKE_ROOT="$(mktemp -d "$SMOKE_PARENT/dsh-taskforce-smoke.XXXXXXXX")" || exit 1
SMOKE_NAME="${SMOKE_ROOT##*/}"
case "$SMOKE_NAME" in dsh-taskforce-smoke.????????) ;; *) exit 1 ;; esac
[ "$SMOKE_ROOT" = "$SMOKE_PARENT/$SMOKE_NAME" ] && [ -d "$SMOKE_ROOT" ] && [ ! -L "$SMOKE_ROOT" ] || exit 1
readonly SMOKE_ROOT
cleanup() { rm -rf -- "$SMOKE_ROOT"; }
trap cleanup EXIT
PACK_NAME="$(npm pack --ignore-scripts --pack-destination "$SMOKE_ROOT")" || exit 1
case "$PACK_NAME" in ''|.*|*[!A-Za-z0-9._-]*) exit 1 ;; esac
case "$PACK_NAME" in *.tgz) ;; *) exit 1 ;; esac
TGZ="$SMOKE_ROOT/$PACK_NAME"
[ -f "$TGZ" ] && [ ! -L "$TGZ" ] || exit 1
# 2. 装进临时 DSH_HOME 的 web profile（首次会自动初始化该 profile）
export DSH_HOME="$SMOKE_ROOT/home" DSH_TELEMETRY_DISABLED=1
mkdir "$DSH_HOME"
dsh plugin --profile web add "$TGZ"
dsh --profile web --dump-config | grep taskforce # 应出现 taskforce 与 taskforce-store 两行
# 3. 回环试挂：日志应出现 [taskforce] preset "taskforce" declared (21 rows)，
# 且无 failed to import / activate；确认后 Ctrl-C 停止试挂并继续验收
trap ':' INT
dsh --profile web --host 127.0.0.1 --port 0 --no-open || [ "$?" -eq 130 ]
# 4. 全量原生验收（自建并清理自己的临时 home）；anchor 取自 PATH 上的 dsh
ANCHOR="$(dirname "$(dirname "$(realpath "$(command -v dsh)")")")/package.json"
npm run test:all -- --install-anchor "$ANCHOR" # 须见 HOST_VERIFIED 与 ISOLATION_VERIFIED
)
21 rows 是预设顶层行数；verify-preset 报告的 29 rows 含嵌套 group 内的行，两者不矛盾。生产实例的安装、备份与回滚仍按 DELIVERY.md 执行。
待办与晚到阻塞的续页须携带上页 page_token（晚到区为 late_page_token）；成员变化返回 E_PAGE_CHANGED，需丢弃该区游标和 token、重读第一页。旧数字游标调用方需同步更新；事实/交接历史游标不变。事实总数在看板、统计和每步工作上下文中采用同一可见性规则，排除错父域和孤儿事实。
读取快照、证据归属与验收约束已保留；默认 STALL 仅观察、不降档。ECHO 统一按调用发起顺序判断，旧成功不能清空新失败；native/PTC 的调用 ID 按所属 turn/step 区分，外层传输成功不代替内层工具成功。已匹配的 15 个任务工具通过成功文本传输返回完整 ok:false/error/code/hint 回执时，确定失败计入 ECHO；完整且一致的持久 rejected 停止回执重放计入确定拒绝，即使兼容回包仍带 E_CONTROL_OUTCOME_UNKNOWN。TOOL_OUTCOME_UNKNOWN、持久控制的 pending/unknown、日志不可用及缺失或矛盾的结果元数据保留未知结果并截断连续失败，不能据此建议换参数重复执行。外部工具、引用或嵌套错误文本不参与这项语义判定。派发计数保留全部尝试与回执。默认未结算估计按非空 senderSessionId 去重抵扣初始派发，同一子代理续作的多次结算仍保留通知总数；缺少发送者的通知和 TOOL_OUTCOME_UNKNOWN 不证明派发已结算，确定失败才抵扣。此估计不冒充实际存活代理数。新开的空待办页省掉 3 次 SQL 查询，已有续页仍校验完整成员 token。node tools/bench-board.mjs 1000 5000 输出 9 类场景的查询数、返回 JavaScript 的行数、输出大小、执行计划及完整读板 p50/p95；耗时只供比较，不作通过阈值。
服务层 run 隔离不是文件系统隔离；有文件权限的执行者仍可能直接读取共享 SQLite 文件。模型默认看板有界并可分页；旧宿主完整 board 仍随任务数增长。durable governor core 与新增持久 FIFO 调度服务仅由可信宿主显式调用，尚未接入原生自动派发；未知结果保留资源占用，不自动重试或释放。隔离宿主验收不发送模型请求，不能替代真实模型、长期并发、费用或目标生产实例验收。安装包不会自动修改正在运行的 DSH，也不会自动重启它。
dsh-redteam-mode（github.com/Jueze-2019）—— 主会话只指挥、事实落库、汇报节流。@linxin666/dsh-liangshen（MIT）—— 本包的 working-context / guard / 工具面策略为机制照搬、代码自研。ctx.agentPresets.register，不往 harness home 写任何文件（旧式 $DSH_HOME/.agent-presets/ 目录在当前 DSH 已无人读取）。TaskForce 只作用于选择该预设的会话。切换回 standard/minimal 时撤销本插件自己的 guard/restrict；不会删除宿主或其他插件的安全限制。新建、并存、反复切换、持久恢复及预设重载由原生隔离验收覆盖。详见 docs/PRESET_ISOLATION.md。
| 层 | 名称 | 状态 |
|---|---|---|
| 项目对外名 | dsh指挥官 / DSH Imperator | 本仓库发布名 |
| 包名 | @local/dsh-taskforce | 固定 —— profile 的 link: 依赖与 CI 的 npm pack 产物名直接引用 |
| preset 标识符 | taskforce | 固定 —— 被用户配置、ctx.agentPresets.register 与三套验证脚本引用 |
| preset 显示名 / persona 自称 | 任务部队 | 固定 —— lib/preset.js 与运行时状态行使用，verify-isolation / verify-p3 对其有硬断言 |
| 事实库路径 | $DSH_HOME/taskforce/taskforce.db | 固定 —— 既有数据所在 |
改名只作用于发布门面（仓库名、README 标题、包描述）。技术标识符与运行时可观测字符串一律不动——它们是既有部署、CI 与验收契约的一部分，改动会打断正在运行的宿主。