HanneLEE/dsh-agent-state

README 摘要

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，即插即用） 装完即生效：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…

分类