dsh-agent-state — 让 Agent 长时间独立作业的状态机插件

面向超长程自主任务的 DSH（DeepSeek Harness）外置插件：把任务过程变成一份被守卫链仲裁的结构化状态，让 agent 少打扰、无人值守地推进——前后一致、有据可查、可恢复、可继续。

为什么用状态机约束 Agent（设计思路）

① 上下文前后不一致 → 守卫链强制 每次状态变更必须通过守卫链仲裁（转移合法性 → 最终状态守卫 → 计划完整性 → 验证守卫 → 模型不变量）并持久化为快照，每一步把完整状态注入请求；改口必须走合法路径、必须留痕。

② 无中生有、过度自信、凭空捏造（幻觉）→ 三道闸

1. 陈述必须结构化落账：事实、决策、假设、教训写入状态，不能只写在回复里；
2. 验证必须执行器证据背书：run_verification 的判定由 shell/fs 真实输出注入，模型不能自己宣布"通过"；
3. 过度自信被守卫⑤ + 两轮对抗审查兜底：独立 LLM 审视证据是否真的支撑结论，连续失败强制 FAILED。

③ 上下文爆炸 → 状态替代一部分上下文 状态即记忆（每步注入紧凑快照而非对话历史）· 长历史折叠 · 证据指针化（完整 stdout 落盘、状态只留 stdoutRef）· 快照即恢复（断点续跑、子代理继承 intent）。

修正即教训：事实/假设与实际不符时，修正沉淀为经验教训，跨轮次、跨恢复保留。

完整设计思路 + 优缺点权衡 + 模型可见面/配置/限制：见 agent-state/README.md

安装（bundle，即插即用）

dsh plugin --profile <name> add https://github.com/HanneLEE/dsh-agent-state/releases/latest/download/deepseek-ai-dsh-agent-state-0.1.0-rc.10.tgz
dsh --profile <name> --dump-config   # 验证出现 "# == @deepseek-ai/dsh-agent-state" 层
dsh --profile <name>

装完即生效：bundle 的 patch 把状态机挂到 host 平面，无需编辑 preset。@deepseek-ai/* peers 由所装 dsh 运行时提供。

文档 / 开发 / 发布

• 配置、守卫链、审批模式、测试：agent-state/README.md
• 开发：agent-state/ 为独立 pnpm 工程（pnpm install → pnpm dev:link → pnpm typecheck → pnpm test → pnpm build → pnpm pack）
• 发布：pnpm release（build + pack + tag + push + Release 上传 tarball；lib/ 不入库）

与 DSH 主仓的关系

依赖 DSH 的 @deepseek-ai/* 包（cordis、dsh-tools、dsh-agent、dsh-shell、dsh-fs、dsh-llm、dsh-session、dsh-system-prompt、dsh-user-questions、dsh-invariants），不随主仓发布；构建、测试与安装需要可用的 DSH 环境。