前言¶
DeepSeek Harness（DSH）把能力拆成插件，智能体在 harness 里调用工具完成工作。很多 agent 工具把上下文当成「一次会话」：开聊、干活、关窗，笔记和任务往往散落在对话里，换 harness 或换机器后难以接续。
AI-Suplex 把真实工作看成一条重复出现的环：plan → run → capture → close → compound（计划、执行、沉淀、收束、复利）。dsh-ai-suplex 是 kmagwenzi 维护的开源 DSH 插件（分类：工作流），把这条环写进 harness，并用你本地拥有的 Markdown vault 作为唯一事实来源。插件当前版本 v0.4.0，许可证 MIT，依赖 Node >= 20，设计上 无网络、无数据库、无守护进程，只有文件与内置 CLI。
这是什么¶
一句话：dsh-ai-suplex 在 DeepSeek Harness 里实现 AI-Suplex 7-7-7 工作流管道——在本地 markdown vault 上完成 plan、run、capture、close、compound，并在「晋升记忆」一步设 human gate（须显式批准）。
维护者 Kudakwashe Magwenzi（GitHub：kmagwenzi）。社区目录页：skillhub.cn/plugins/kmagwenzi/dsh-ai-suplex；源码与说明：github.com/kmagwenzi/dsh-ai-suplex。目录站点为社区独立收录，与 DeepSeek / 幻方无官方从属关系。
插件 README 强调：vault 是 system of record，harness 只是表面；换 harness 可以，vault 仍归你。
核心功能¶
v0.4.0 宣称 完整 v0 环已交付：九个工具针对真实 vault 运行，并支持冷启动 bootstrap。
| 管道阶段 | 工具 | 状态 |
|---|---|---|
| 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（门控） | ai_suplex_promote |
已交付 — 须批准 |
| Approvals | ai_suplex_approvals |
已交付 |
| Status | ai_suplex_status |
已交付 |
各工具职责与主要参数（摘自 README）：
| 工具 | 作用 | 关键参数 |
|---|---|---|
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 |
原始待办 → 管道 tasklist 格式，写入 Tasklists/Active/ |
title、todos[]、type、focus、cycle、week、write |
ai_suplex_capture |
将 artifact 写到对应周期路径 | 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 提取 lesson 到 Memory/lessons.md |
— |
ai_suplex_promote |
打分并晋升 lesson（3lm promote --min N）— 须批准 |
approved（必须为 true）、min |
ai_suplex_approvals |
决策收件箱，机器可读 JSON | — |
ai_suplex_status |
记忆统计、活跃 tasklist、boss HP | — |
Human gate¶
ai_suplex_promote 没有 approved: true 会拒绝执行。README 写明：approved=false 为 BLOCKED；approved=true 时触发 3lm promote --min 70。设计意图是：记忆要「挣得位置」，节奏由人控制，而不是自动无限写入。
它不是什么¶
- 不是独立的 memory layer——vault 才是记忆，插件是环上的操作面。
- 不是「自写记忆」——每次 promote 都要过门。
- 不是完整 Ultra Edition 框架——那是付费 cockpit；本仓库是开源 loop。
安装与启用¶
前置：dsh、Node >= 20（ESM）、一个工作区；尚无 vault 时可用 ai_suplex_init 创建。
官方安装（README 原文）：
dsh plugin --profile web add dsh-ai-suplex
dsh --profile web --dump-config | grep ai-suplex
确认配置里出现 ai-suplex 行。README 提醒：只安装不激活的插件只是依赖，不是 layer；带 dsh.bundle 的包才会通过 cordis.patch.yml 写入 profile 组合树。
本地 checkout 试用（trial profile，npm 发布前）：
dsh plugin --profile dshtrial add /path/to/dsh-ai-suplex
插件以当前 dsh 进程权限读写 vault 与执行 bundled CLI。安装前建议自行查看仓库源码与 MIT 许可证，确认路径与工具行为符合你的安全策略。
典型用法¶
下面介绍 README 中的 Quick start 与 loop 调用顺序，可在 harness 里按工具名传参复现。
冷启动与一轮环¶
1、若无 vault，先 bootstrap：
ai_suplex_init path=/path/to/my-vault
2、加载上下文（staleness guard + mission brief）：
ai_suplex_context
3、计划：把待办写成 tasklist，并打开 Phase 0：
ai_suplex_tasklist title="Ship the landing page" todos=[...]
4、执行过程中 capture，收束 session：
ai_suplex_capture title="..." content="..." cycle=2 week=5
ai_suplex_session_end title="..." rating=5
完整环上的工具顺序¶
经过上面的步骤后，同一 vault 上可按 README 串联：
ai_suplex_context # staleness guard + mission brief
ai_suplex_tasklist # to-dos -> tasklist，含 Phase 0
ai_suplex_capture # artifact 到周期路径
ai_suplex_session_end # report + 3lm end
ai_suplex_learn # 提取 lessons
ai_suplex_promote # 打分晋升 — 需要 approved: true
ai_suplex_approvals # Hustler 决策收件箱
ai_suplex_status # memory 统计 + boss HP
晋升示例（门控行为）：
ai_suplex_promote approved=false # BLOCKED
ai_suplex_promote approved=true # 执行 3lm promote --min 70
开发侧可用 node test/smoke.mjs 跑 smoke（真实 vault、stub vault、clean-room init）。
适用场景与注意¶
适合谁： 已在用或打算用 DSH，希望把「计划—执行—沉淀—收束—复利」固定成可重复环，且愿意用本地 Markdown vault 作主记录、并人工把关哪些 lesson 晋升的长期工作者或智能体开发者。
环境与边界： 本地优先，无网络调用；需要 @deepseek-ai/dsh-tools（peer >=0.1.0-rc）。README 提到 live proof 站点 wqr.co.zw 作为 AI-Suplex 环上的业务实例，本文不展开其业务细节。
安全与信任： 插件在 dsh 进程内注册 Cordis 工具（lib/index.js 的 apply(ctx)），并 patch bundle；vault 路径与 3lm 相关命令会触及磁盘。安装前阅读源码，仅在可信工作区启用。
结尾¶
dsh-ai-suplex 把 AI-Suplex 的 plan → run → capture → close → compound 做成 DSH 一等公民，用文件 vault 代替会话型上下文，并用 ai_suplex_promote 的批准门控约束记忆复利。若要安装或查版本细节，以 GitHub README 与 package.json（当前 0.4.0）为准。
