LoopX与DeepSeek Harness（dsh）集成指南：无头分段回合的治理方式

LoopX与DeepSeek Harnessdsh集成指南无头分段回合的治理方式【免费下载链接】loopxLong-horizon agent control plane for durable, governed work across Codex, Claude Code, and other harnesses.项目地址: https://gitcode.com/GitHub_Trending/lo/loopxLoopX 是一款长程 Agent 控制平面而本指南讲的核心是如何把 DeepSeek Harnessdsh接入 LoopX实现无头headless分段回合Turn的治理方式dsh 负责真正干活模型调用、工具、沙箱LoopX 负责发号施令目标、待办、配额、验证与写回。两者各守边界任何一段无头执行都跑不出治理范围。为什么要给 dsh 套上 LoopX 控制平面dsh 本身是一个优秀的 Agent 执行宿主机harness但它更关注怎么把这一轮跑完而不是这个长任务还剩下什么、该不该继续、配额是否允许。LoopX 补上的正是后者职责归属具体做什么目标 / 待办 / 配额 / 证据LoopX持久化 Goal 与 Todo 状态判断现在该不该跑模型调用 / 工具 / 沙箱 / 会话日志dsh在一个有界的工作分段内执行任务并返回结构化结果结果验证LoopX独立校验器在写回和扣配额之前先验证 typed 结果完整连接器说明见 docs/integrations/deepseek-harness-connector.md适配器源码位于 loopx/dsh_goal_mode/ 子包python -m loopx.dsh_goal_mode即可运行。一次被治理回合的完整链路整个集成可以浓缩成一条单向流水线每一环都有明确契约LoopX quota should-run ← 配额先审该不该跑 → loopx turn run-once ← 启动一次受治理的 Turn → loopx.dsh_goal_mode 适配器 ← 把签名 TurnEnvelope 翻译成 dsh 提示词 → DeepSeek Harness SDK / dsh 运行时无头执行一个有界工作分段 → typed loopx_turn_result_v0 ← 模型最终消息被解析为结构化结果 → 独立验证器 LoopX 写回 配额扣减前端首屏也能看到这套控制平面的工作形态快速上手3 步完成 dsh 与 LoopX 集成第 1 步获取代码并安装可选依赖git clone https://gitcode.com/GitHub_Trending/lo/loopx cd loopx python -m pip install loopx[deepseek-harness]该可选依赖组固定了对应版本的deepseek-harness-sdk核心 LoopX 本身不强制它。真实运行还需要DEEPSEEK_API_KEY/DEEPSEEK_BASE_URL环境变量以及可选的cordis.yml配置文件。第 2 步以--host dsh跑一次受治理回合推荐loopx turn run-once --goal-id goal-id --agent-id deepseek-worker \ --host dsh --execution-mode isolated-headless --project $PWD \ --dsh-model deepseek-v4-flash --validation-command-json [...] --execute内置宿主--host dsh在同一 CLI 进程内运行适配器Provider 故障会以类型化失败码进入 Turn 日志从而支持同 Turn 有界重试子进程模式generic-cli--host-adapter-command-json同样可用两条路径的端到端演练脚本在 examples/ 下。第 3 步在 dsh 交互界面里显式调用 loopx 技能如果你日常使用 dsh 的 Web 会话也可以安装 dsh-loopx 插件源码见 packages/dsh-loopx-plugin/在技能选择器中显式选择loopx然后直接用自然语言描述任务——Agent 会自动建立持久化的 Goal/Todo 状态。无头分段回合是如何执行的理解这套无头分段回合的治理方式关键是适配器loopx/dsh_goal_mode/turn_host_adapter.py的两条铁律只信签名授权不信散文。适配器从 stdin 读取一个loopx_turn_host_request_v0JSON 对象先校验 TurnEnvelope 的 action 签名哈希再取出有界任务正文primary_action、只读清单required_reads与写权限write_scope。它绝不从其他文本里脑补权限。只认结构化结果失败即收口fail closed。dsh 的最终助手消息必须是一个 JSON 对象result_kind只接受六种之一result_kind含义validated_progress有验证通过的实际进展repair_required任务本身没问题但有个可修复的缺陷挡住replan_required当前路线走不通需要换方案user_action_required需要人工介入wait当前没有安全可写的内容暂停iteration_failed本回合失败且未授权重试如果模型没有返回可解析的 JSON适配器会保守地输出wait不伪造进展、不扣配额如果结果形状本身非法则作为contract_rejected类型化失败上抛。两条路径都不允许消耗配额——这是无头执行的底线。失败分类让每一次无头重试都有据可依子进程模式下一个非零退出码只能告诉你挂了内置宿主loopx/dsh_goal_mode/host_failure_map.py则把 dsh 的终端原因映射为精确的失败类型dsh 侧信号LoopX 失败类型是否可重试401 / 403 /invalid_api_keyauth_failed否429 /rate_limitrate_limited有界重试5xx /SERVER/overloadedprovider_overloaded有界重试EMPTY_RESPONSE/ 连接中断transport_lost有界重试结果与事件自相矛盾contract_rejected否分类遵循loopx-turn-v0优先级已知 Provider 错误码 HTTP 状态码 消息文本匹配同一层级信号冲突时一律收口为unknown防止看似成功、实则带错的灰色状态进入日志。治理边界适配器不能做什么LoopX 对适配器的限制是刻意设计的值得新手记住不读goal/todo 状态不写LoopX 状态不花配额不自验自己的工作dsh 的运行时主目录默认workspace/.local/.dsh-sessions永远留在本地绝不进入LoopX 公开证据会话持久化归 dsh 自身组合所有此集成不承诺跨回合会话续接或跨进程恢复。一句话dsh 是执行手LoopX 是记账官两者之间只有签名报文和结构化结果两条通道。真实案例约束变化时Replan 留下完整决策链仓库内置了一个可复现的演示examples/dsh-loopx-demo/案例文档见 docs/showcases/cases/dsh-loopx-replan-demo.md一个 Node.js CLI 需要结构化日志dsh Agent 对比 Pino、Consola、Roarr 后选了 Pino随后用户追加约束将部署到 serverless冷启动和依赖体积优先。LoopX 的做法不是悄悄改写旧决策而是保留原决策为被取代状态 → 记录一次显式Replan→ 创建后继 Todo → 实现切换到 Roarr依赖树从 12 个包降到 4 个3/3 行为测试通过GoalBar 最终 2/2 关闭。对长程无头任务来说这种约束变化不抹掉证据链的治理方式正是分段回合模式的核心价值——每个回合短小可重试但决策与证据在 LoopX 侧持久累积。长时运行的轨迹示例可参考 docs/assets/long-running-loop-ml-experiment-trajectory.png延伸阅读控制平面适配协议docs/integrations/deepseek-harness-control-plane-adapter.md运行时连接器目录docs/integrations/runtime-connector-catalog.md适配器运行说明与边界loopx/dsh_goal_mode/README.md小结把 DeepSeek Harness 接入 LoopX本质是给无头 Agent 装上一套先审批、后执行、再验证的分段回合治理。dsh 保持执行主权LoopX 保持记账主权任何一次无头执行都配额有界、失败可分类、决策可追溯。【免费下载链接】loopxLong-horizon agent control plane for durable, governed work across Codex, Claude Code, and other harnesses.项目地址: https://gitcode.com/GitHub_Trending/lo/loopx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考