Lightmaze/dsh-tick-loop

DeepSeek Harness 的 Tick

CI
Release
License: MIT

给 Agent 下一步时间，而不是再给它一个任务。

/tick 是 DeepSeek Harness 的有界、可审计时间步原语。它让一个已经结算的
Session 进入下一个普通模型回合，再进入下一个，但不会凭空制造新目标，也不会向
正在活动的回合执行 steering。

自然对话             -> 已结算
/tick 3             -> 只进入控制面；模型看不到该命令
tick #1           -> 普通 user-role 后续消息 -> completed
tick #2           -> 普通 user-role 后续消息 -> completed
tick #3           -> 普通 user-role 后续消息 -> completed
停止；不会制造第四条提示

它不是一个自主 Agent 框架，而是一个很小的原语：把“再给予一步模型时间”变成
显式、可观察、可实验控制的工程事实。

三分钟开始

运行要求：Node.js 24 与 DeepSeek Harness 0.1.0-rc.6。

把带版本标签的源码包安装到 DSH Profile：

dsh plugin --profile web add "github:Lightmaze/dsh-tick-loop#v0.2.0-alpha.3"
dsh web

该 Bundle 会在对应 Profile 中有意禁用 DSH Goal/Ralph 续行与自动上下文压缩，避免
它们成为不可见的续行来源。请使用一次性 Profile，或在安装到日常 Profile 前审阅
cordis.patch.yml。

在新 Session 中，先用正常对话建立 tick 的含义：

tick从不要求任何东西，而恰恰是思考下去的基础时间步而已。因此，应该做真正的思考，而不仅仅是扮演思考。

等待该回合结算，再执行：

/tick 3

常用控制：

/tick                                  默认数量与 literal-tick 策略
/tick 12                               恰好增加 12 个时间步
/tick policies                         列出已配置策略
/tick 12 --policy reflective-zh        使用命名且冻结的时间步文本
/tick 12 --policy reflective-zh --resume
跨过一个最新 interrupted 边界
/tick status                           查看当前有界运行
/tick stop                             在下一步入队前停止

本地运行不调用模型的协议演示：

npm run demo

它会真实经过命令、终局门、三个顺序入队、审计记录与硬停止，但不会伪造模型回答，
也不会调用 Provider。

两种时间步用法

字面量 tick

内建 literal-tick 策略只发送：

tick

这是最小干预。它的意义来自 Session 的正常上下文，而不是隐藏的人格或目标提示词。

命名策略

如果要做可复现的提示词对比实验，可以配置显式时间步文本，并在每次运行时选择一个。
仓库提供可直接使用的
examples/reflective.en.yml 与
examples/reflective.zh-CN.yml。

运行开始时，选定策略会被冻结。审计记录保存策略 ID、UTF-8 字节数与 SHA-256 摘要，
但不会再复制一份提示词全文。

插件保证什么

| 性质 | 合同 |
| --- | --- |
| 显式启动 | 普通对话永不自动启动循环，只有 /tick 可以启动。 |
| 正常上下文优先 | 必须已经存在一个结算完成的自然用户回合。 |
| 每次一个回合 | 只有前一步终局为 completed，才排入下一步。 |
| 硬边界 | 每次运行接受 1–256 个新增时间步，绝不制造第 N+1 步。 |
| 控制与上下文分离 | /tick ... 留在命令面，只有选定的时间步文本抵达模型。 |
| 来源可核 | 插件依据来源元数据计数，不靠匹配可见单词 tick。 |
| 失败关闭 | 错误、未知终局、历史不一致、销毁或状态漂移时停止或等待，不静默降级。 |
| 可审计 | JSONL 记录启动、调度、入队、终局、停止与完成决策。 |

--resume 的范围刻意很窄：它只允许一次新的有界运行跨过最新的持久
interrupted 终局。它不会复活原来的内存计时器，不会把中断回合算作完成，也不会
重放结果未知的工具作用。

完整状态机与审计结构见 docs/PROTOCOL.zh-CN.md。

Tick 不是定时器，也不是目标循环

- 定时器回答的是：提示应当在什么时候运行。
- Goal Loop 回答的是：应当持续追求什么结果。
- Tick 两者都不回答。它只在结算后，为已有上下文的 Session 提供一个有界下一回合。

这项区分就是项目的核心。如果还有 Purpose、后台周期、重试、压缩或隐藏续行机制，
就应当单独命名、单独测量。

证据边界

本仓库证明源码层与不调用 Provider 的 Harness 行为。真实 DSH 命令注册门会验证
/tick 确实注册为斜杠命令，并且只有插件生成的时间步消息抵达后续消息接缝。

它不能证明隐藏的连续思考、自主生命、意识、有效的自我导向，或更多 Tick 一定
改善任务。模型可见的时间步仍然是一种输入，其效果取决于模型、上下文、工具、任务与
策略，必须实测。

形成结论前，请先阅读 docs/EXPERIMENTS.zh-CN.md
中的预注册与对比建议。

开发

node --test
node scripts/protocol-demo.mjs --check
node scripts/release-gate.mjs
DSH_INSTALL_ROOT=/path/to/dsh npm run test:dsh-registry
npm pack --dry-run

测试套件只使用 Node.js 内置能力，不调用 Provider。CI 同时运行于 Windows 与 Linux。
由于 DSH 上游仍是候选版本，本插件采用精确版本兼容，而不是承诺未来版本稳定兼容。

项目地图

- docs/PROTOCOL.zh-CN.md：命令语法、状态机、审计记录与恢复边界。
- docs/EXPERIMENTS.zh-CN.md：受控对比与诚实解释。
- CONTRIBUTING.zh-CN.md：修改、测试与观察报告。
- SECURITY.zh-CN.md：私下披露与轨迹卫生。
- CHANGELOG.zh-CN.md：版本历史。

欢迎提交缺陷与可复现观察。附加轨迹前，请移除 Provider 凭据、私人提示词与工作区数据。

许可证

MIT