执行循环 kmagwenzi/dsh-ai-suplex

dsh-ai-suplex

你的智能体缺失的执行循环。

一个免费、开源的 DeepSeek Harness (dsh) 插件，让 AI-Suplex 7-7-7 工作流流水线成为 harness 里的一等公民 —— plan → run → capture → close → compound —— 基于本地 markdown vault 运行。

大家都在造自己会写的记忆。这个造的是必须挣得一席之地的记忆 —— 按你掌控的节奏。

MIT · Node >= 20 · 无网络 · 无数据库 · 无守护进程 —— 只有文件和内置命令行。

为什么

大多数智能体工具把上下文当成一个会话。真正的工作是一个循环：

plan → execute → capture → close → compound

dsh-ai-suplex 给这个循环在 dsh 里安了个家，并用一个你拥有的纯 markdown vault 支撑它。vault 始终是记录系统；harness 只是一个界面。换掉 harness，留住心智。

实况证明： wqr.co.zw —— 一个跑在 AI-Suplex 循环上的真实生意。

状态

v0.4.0 —— 完整的 v0 循环已发布。 九个工具跑在真实 vault 上，干净环境也能冷启动：

| 流水线阶段 | 工具 | 状态 |
| Bootstrap | ai_suplex_init | 已发布 |
| Context Core | ai_suplex_context | 已发布 |
| Plan | ai_suplex_tasklist | 已发布 |
| Capture | ai_suplex_capture | 已发布 |
| Session End | ai_suplex_session_end | 已发布 |
| Learn | ai_suplex_learn | 已发布 |
| Promote (gated) | ai_suplex_promote | 已发布 —— 需审批 |
| Approvals | ai_suplex_approvals | 已发布 |
| Status | ai_suplex_status | 已发布 |

要求

- dsh (DeepSeek Harness)
- Node >= 20 (ESM)
- 一个工作区。还没有 vault？ai_suplex_init 会创建一个。

安装

dsh plugin --profile web add dsh-ai-suplex
dsh --profile web --dump-config | grep ai-suplex

确认 ai-suplex 那一行出现 —— 装了却不激活的插件是依赖，不是一层。

从本地检出安装（试用配置档，在 npm 发布之前或没有发布时）：

dsh plugin --profile dshtrial add /path/to/dsh-ai-suplex

快速开始

1 · bootstrap a vault (skip if you already have one)

ai_suplex_init path=/path/to/my-vault

2 · load context — staleness guard + mission brief

ai_suplex_context

3 · plan

ai_suplex_tasklist title="Ship the landing page" todos=[...]

4 · capture as you go, then close

ai_suplex_capture title="..." content="..." cycle=2 week=5
ai_suplex_session_end title="..." rating=5

循环

ai_suplex_context # staleness guard + mission brief
ai_suplex_tasklist # to-dos -> a tasklist that opens with Phase 0
ai_suplex_capture # artifact to the period-correct path
ai_suplex_session_end # report + 3lm end
ai_suplex_learn # extract lessons
ai_suplex_promote # scored promotion — needs approved: true ai_suplex_approvals # the Hustler-decides inbox ai_suplex_status # memory stats + boss HP

工具

| 工具 | 作用 | 关键参数 |
| ai_suplex_init | 搭一个最小 vault（period.md · 种子 Tools/3lm.js · Tasklists · Memory · Sessions） | path |
| ai_suplex_context | 运行 3lm start --context；返回 staleness guard + brief | stale_days |
| ai_suplex_tasklist | 把原始 to-do 转成 pipeline tasklist 格式，写入 Tasklists/Active/ | title、todos[]、type、focus、cycle、week、write |
| ai_suplex_capture | 把产物写到对应周期的路径 | title、content、cycle、week、focus |
| ai_suplex_session_end | 组装 Session End Report，并运行 3lm end | title、rating、narrative、key_insights、next_actions、run_3lm_end |
| ai_suplex_learn | 从最近一期 episode 提炼经验，写入 Memory/lessons.md | — |
| ai_suplex_promote | 给经验打分并晋升（3lm promote --min N）—— 需审批放行 | approved（必须为 true）、min |
| ai_suplex_approvals | 决策收件箱，输出机器可读的 JSON | — |
| ai_suplex_status | Memory 统计 · 活跃 tasklist · boss HP | — |

闸门

ai_suplex_promote 没有显式 approved: true 就拒绝触发：

ai_suplex_promote approved=false # BLOCKED — promote is approval-gated ai_suplex_promote approved=true # fires 3lm promote --min 70

大家都在做自己会写自己的记忆。这一套做的记忆，得先挣到自己的位置——节奏由你掌控。闸门就是产品本身。

工作原理

dsh 插件由两部分组成：

1. Cordis 插件 —— lib/index.js 导出 apply(ctx)，把工具注册到 ctx.tools。
2. bundle 补丁 —— package.json 声明 dsh.bundle.patch → cordis.patch.yml，把插件那一行插进配置档组装出的树里。

没有 dsh.bundle 的包能装上，但不会激活任何一层。要验证，别假设：

dsh --profile web --dump-config | grep ai-suplex

设计上只跑本地：不联网、不用数据库、不用 ORM、不起守护进程。

它不是什么

- 不是记忆层——vault 才是记忆；这是套在它外面的循环。
- 不是自己写自己的记忆——每次晋升都要人明确放行。
- 不是完整框架——Ultra Edition 是付费驾驶舱；这是开放循环。

演示

GIF 稍后补上——录一段终端里的循环（init → context → tasklist → capture → session_end），最后停在 promote 闸门拒绝触发的那一刻。

开发

node test/smoke.mjs # the full smoke suite: the real vault, a stub vault, and a clean-room init

设计原则

插件是接口，不是产品。vault 始终是记录系统，也始终与 harness 无关；dsh 只是一个界面。

许可

MIT —— 见 LICENSE。

作者

Kudakwashe Magwenzi —— 哈拉雷的 AI 智能体开发者。
- GitHub：github.com/kmagwenzi
- LinkedIn：linkedin.com/in/kudakwashe-magwenzi
- wqr.co.zw