session-chains — 交接鏈面板 for DSH

把「互相交接的對話」自動聚成一條鏈：左側欄一張卡片列出每條鏈、每場對話編號， 點一下切過去；快到上下文上限時提醒你交接，設定打開的話連「開新對話＋貼提示詞＋切過去」都自己做完。

這是 DeepSeek Harness（DSH） 的外掛（host 端 index.mjs ＋ 瀏覽器端 client.js）， 以 file:// 掛進 $DSH_HOME/cordis.patch.yml，不改內建側邊欄、不動 profile。

---

為什麼要做

拆對話是省 token 最有效的手段（同一條工作線實測可省約 71%），但代價是側邊欄散成一堆看不出關係的對話框。 而「哪幾場是同一條線」其實已經寫在日誌裡 —— 只差沒有人把它讀出來：

• 接手的那一場，交接提示詞是使用者貼進去的第一句話；
• 交出的那一場，同一份文字是助理產出的。

兩側都落在 $DSH_HOME/sessions/<工作區>/<session>/session.v*.jsonl.zstd。 所以只要提示詞裡有一行 鏈=<代號>，兩邊就都認得出來，面板自動分組 —— 不必手動歸類。

長什麼樣

位置	內容
左側欄卡片	每條鏈一列，展開是各場對話（001、002…），右側三顆：收合／暫停／開面板
面板（浮層）	全部鏈、搜尋、拖拉／多選歸鏈、四鍵排序（名稱／建立／場次數／最後活動）
置頂／封存（2026-10-19）	側欄每列右側就有 📌（置頂）與 🗄（封存），不必進面板。置頂只在右側顯示圖釘（左側不再加一個）；封存是兩段式（側欄與面板一致）：按 🗄 會變成「確定封存？」，再按一次才送，旁邊有「取消」。封存的鏈從卡片收起，面板「封存庫 N」才看得到、也才還原得回去
輸入框上方 HUD	本場 320k/210 ＝ 這一場的上下文／請求數，達門檻才變色
⚙ 設定	字級、四組顏色、卡片圖示、HUD 五段開關、交接門檻、自動交接

置頂與封存存在哪：跟改名同一份 aliases.json（pinned／archived 兩個清單），不是瀏覽器 localStorage， 所以換瀏覽器、重開 DSH 都還在；改名之後置頂也跟著走（讀寫時都會過對照表）。 封存不動任何 session 日誌，只是不在卡片顯示。封存的鏈若又交接出新場次，留在封存庫（不會自己跳回卡片）。

安裝

需要 DSH（桌面版或 web 版都可以）。兩種裝法，選一種：

A. 從插件市場／dsh plugin add（repo 根目錄就是套件根）

# 發佈到 npm 之後：
dsh plugin --profile web add session-chains
# 或直接從 GitHub：
dsh plugin --profile web add github:HildebrandYu/dsh-session-chains

B. 直接掛本機資料夾（開發用，改檔即重載）

git clone <this-repo> dsh-session-chains
cd dsh-session-chains

node scripts/install.mjs            # dry-run：只寫 .preview/，讓你先看補丁長什麼樣
node scripts/install.mjs --apply    # 真的掛上（會先備份 $DSH_HOME/cordis.patch.yml）
node scripts/install.mjs --remove --apply   # 整包移除

掛好後重新整理 GUI 一次就會出現卡片。移除時它會把自己那兩段（插件列＋HMR 監看）一起清掉。

套件結構：package.json 在 repo 根（市集與 dsh plugin add 只讀這個），裡面宣告 dsh.bundle.patch = ./cordis.patch.yml（沒有這個就無法安裝，只宣告 dsh.client 不算） 與 dsh.client.platform = web；程式本體在 plugin/，exports 指過去。 本機用 file:// 直掛時，載入器會從 plugin/index.mjs 往上找到根目錄的 package.json。

install.mjs 會寫兩段：session-chains（插件本體）與 session-chains-hmr（把 plugin/ 加進 HMR 的監看根目錄， 沒有這段改 index.mjs 不會生效）。兩段都用哨兵包住，可重複執行。

使用

1. 平常：照常工作。交接過的對話會自己出現在同一條鏈裡。
2. 要交接時：面板上按「生成交接詞」→ AI 寫交接單與提示詞 → 按「開新對話」自動開＋貼＋送出＋切換。
3. 到門檻：畫面會跳提醒（warn 可延後 30 分鐘、hard 只能延後 5 分鐘）。 打開 ⚙ 的「到達門檻自動交接」，hard 會在這一輪結束後自己做完上面第 2 步。

門檻（預設值與怎麼選）

訊號	提醒（warn）	強制（hard）
請求數	≥ 200	≥ 320
上下文 tokens	≥ 320k	≥ 480k
佔模型視窗比例	≥ 50%	≥ 65%

• warn 是提示（只顯示，不動作）；hard 才是緊急煞車（設了自動交接才會出手）。
• 預設值是回放 42 場真實對話訂出來的：舊的 80／120、160k／240k 會在 25/42 場觸發 （觸發時中位還剩 103 步＝一定半路被切）；現在只在 6/42 場觸發，都是 300 步以上或 470k 以上的長場。
• 比例那一列是給換模型用的：1M 視窗下幾乎不會先觸發，換成 200k 視窗的模型時它會自動先擋。
• 全部可在 ⚙ 改，或直接改 localStorage 的 dsh.session-chains.settings。

運作原理（三個判定）

訊號	規則	例子
接手 1	第一句話有明確標記	鏈=my-project
接手 2	舊式提示詞	接續 my-project：讀 …
接手 3	第一句話裡的專案路徑	30-CodingSkills/my-project
交出	助理訊息裡「整行就是標記」	產出的提示詞那一行
—	都沒有 → 未標記	一般對話

「交出」那一條刻意嚴格（行首就是標記）：實測一場正在討論本功能的對話，助理推理裡 鏈=… 這種字串出現 23 次（全在行內），寬鬆比對會把一般對話誤認成鏈的起點。

測試

node --test scripts/          # 單元測試（純函式：鏈判定、編號、改名、建議歸鏈）
node scripts/smoke.mjs        # 端到端：在沙箱裡跑 client bundle，檢查面板／卡片／交接流程
node scripts/verify.mjs       # 靜態：manifest、bundle 形式、補丁現況
DSH_WEB_URL=http://127.0.0.1:51714 node scripts/probe.mjs   # 實機：宿主是否已把 bundle 組進 boot graph

scripts/smoke.mjs 不需要真的 DSH：它自己造假的宿主 API（sessions、workspace、fetch、localStorage）， 所以 CI 也能跑。

已知限制

• 只支援 DSH：它讀的是 DSH 自己的 session 日誌格式（session.v4.jsonl.zstd），換宿主就得改 chains.mjs。
• 紅點還沒有資料來源：宿主目前沒有「這一場失敗了」的狀態可讀，所以失敗圓點先留空。
• 手動「交接→新對話」在沒有交接詞時會顯示兩步錯誤（設計如此：先按「生成交接詞」）。
• 鏈的判定靠提示詞裡的標記；沒用過交接指令的舊對話會落在「未標記」，可在面板上逐一歸鏈。

授權

MIT，見 LICENSE。