Apache-2.0、本地优先的控制平面，在 DeepSeek Harness（dsh）上以持久的目标／待办／关卡／证据状态与配额约束、人在环回路，治理长程智能体。
DSH 适配
兼容
作者声明
安全审计
未审计
最后核验
2026-09-02
许可证
Apache-2.0
01它能帮你完成什么？
Run long-horizon, governed agent loops on DeepSeek Harness (dsh) with durable state across bounded turns
Headless dsh segments through LoopX Turn, each tick gated by `quota should-run`, with durable goal, todo, gate, evidence, and quota state preserved across turns and harnesses
Engineers and teams running long-running or multi-agent work on DeepSeek Harness who need reviewable, restartable control instead of chat-only memory
Turn a public issue into a reviewable, evidence-backed change
Reviewable, evidence-backed PR delivery plus reusable, revision-stamped fix knowledge
Open-source contributors and maintainers who want long-running issue-fix work to stay aligned and reviewable
Coordinate multi-agent research (proposer, executor, evaluator/promoter) with visible quota and evidence
Reproducible multi-agent research workflows where todos, quota, evidence, and targeted wake remain visible
Researchers and engineers running reproducible experiments who need hypotheses, evidence, and promote/stop gates visible in one graph
02如何接入 DeepSeek Harness？
前置条件
- Python 3.11+ (the README lists this as the requirement).
- An active Python environment whose console scripts are on `PATH`.
- No runtime dependencies outside the Python standard library.
安装步骤
- 01
Install from PyPI: `python3 -m pip install --upgrade loopx`.
- 02
Install the workflow skills and run the doctor check: `loopx workflow-skills --install` then `loopx doctor`.
- 03
From your project root, connect and check status: `loopx connect` then `loopx status`.
- 04
For DeepSeek Harness: install `loopx[deepseek-harness]`, prepare a dsh `cordis.yml`, then use the dsh goal-mode adapter with `loopx turn run-once`.
验证接入成功
- `loopx doctor` passing;
- `.loopx/registry.json` and a projected active goal state;
回滚
- The Installing LoopX guide documents upgrade, rollback, uninstall, and the archive fallback.
03DSH 适配与能力边界
通过专有的 dsh goal-mode 适配器接入 DeepSeek Harness（dsh）：安装 `loopx[deepseek-harness]` 扩展，准备好 dsh 的 `cordis.yml`，再运行 `loopx turn run-once`；每个无头 dsh 分段都受 `quota should-run` 约束。
Durable goal/todo/gate/evidence state kernel
a long-horizon objective and bounded agent turns→stable goal, todos, gates, evidence, quota, and handoff state across turns, tools, and agents
Quota-gated, human-in-the-loop turns
a registered-agent tick→a decision to deliver, ask, wait, self-repair, or stay quiet, gated by `quota should-run`
DeepSeek Harness (dsh) goal-mode adapter
a dsh `cordis.yml` and `loopx turn run-once`→headless dsh segments through LoopX Turn, each tick gated by `quota should-run`
04适合谁？何时不该用？
适合
- Engineers and teams running long-running or multi-agent work on DeepSeek Harness who need reviewable, restartable control instead of chat-only memory
- Open-source contributors and maintainers who want long-running issue-fix work to stay aligned and reviewable
- Researchers and engineers running reproducible experiments who need hypotheses, evidence, and promote/stop gates visible in one graph
不适合
- LoopX is not an autonomous production controller. Dangerous permissions, publishing, production writes, and final ownership stay with the human.
- LoopX does not grant credentials, approve destructive or production actions, publish on a user's behalf without authorization, or turn an unverified run into evidence of success.
05兼容性、维护与安全提示
- LoopX is not an autonomous production controller. Dangerous permissions, publishing, production writes, and final ownership stay with the human.
- LoopX does not grant credentials, approve destructive or production actions, publish on a user's behalf without authorization, or turn an unverified run into evidence of success.
- LoopX is not a full agent platform, an agent runtime, or an autonomous production controller.
Apache-2.0 · actively maintained (latest release v0.5.3, 2026-08-27)
06常见问题
如何把 LoopX 接入 DeepSeek Harness（dsh）？
安装 `loopx[deepseek-harness]` 扩展，准备好 dsh 的 `cordis.yml`，再使用 dsh goal-mode 适配器配合 `loopx turn run-once`。每一个无头 dsh 分段都经由 LoopX Turn 执行，并受 `quota should-run` 约束。
LoopX 会取代 DeepSeek Harness，或自带智能体运行时吗？
不会。LoopX 运行在宿主之上而非取代它们，它既不是另一种智能体框架，也不是特定提供商的编排运行时。有限的回合仍由宿主执行，LoopX 只负责治理持久状态。
LoopX 需要哪个 Python 版本？
Python 3.11+。请使用控制台脚本已在 `PATH` 中的活跃 Python 环境；该包除标准库外没有运行时依赖。
在 DeepSeek Harness 上无人值守运行 LoopX 安全吗？
LoopX 不是自主生产控制器。危险权限、发布、生产写入与最终归属仍归人类；它不会授予凭证，也不会在未获授权时批准破坏性或生产操作。
如何验证 LoopX 与 dsh 已成功连接？
成功连接时 `loopx doctor` 通过，并显示 `.loopx/registry.json` 及已投影的活跃目标状态；`loopx status` 应展示当前目标、一个具体的用户关卡与下一个智能体待办。
07相关的 DSH 工作流
archify
作者 tt-a1i
为编码智能体生成美观可验证的架构图、时序图与数据流图，输出自包含 HTML，支持动效与清晰导出。
openviking
作者 volcengine
为 AI 智能体打造的自进化上下文数据库，统一智能体记忆、知识 RAG 与技能。
nocobase
作者 nocobase
开源的 AI + 无代码应用搭建平台：AI 在久经生产验证的底层基础设施与所见即所得的无代码界面之上工作，帮你快速构建 CRM、ERP 等业务系统，兼顾速度与可靠性。
learn-harness-engineering
作者 walkinglabs
Harness 工程新手教程，从 0 到 1 系统学习智能体工作流框架。
08数据与来源
Runs on top of any agent harness — Codex App, Claude Code, Cursor, dsh, or your own — providing long-horizon state, sema…
Install `loopx[deepseek-harness]`, prepare a dsh `cordis.yml`, then use the [dsh goal-mode adapter](loopx/dsh_goal_mode/…
Headless dsh segments through LoopX Turn, each tick gated by `quota should-run`
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-09-02。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。