前言¶
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）爲準。
