前言¶
DeepSeek Harness (DSH) 採用“一切皆插件”的理念，將功能模塊化。在智能體開發與調試過程中，管理會話軌跡、Prompt、MCP 配置以及修復 sessionlog 往往需要在不同界面間切換，操作鏈路較長。
dsh-context-console 是一個面向 DSH 的完整上下文工作臺插件。它將原本分散的會話軌跡展示、Prompt/Skill/MCP/Tools 分類管理、緩存觀察、消息鍛造和 sessionlog 修復整合在同一個工作臺中。該插件是 dsh-assistant-message-forge 的正式繼任者，繼承了其消息鍛造能力、RPC 兼容層和原有數據目錄，並在此基礎上增加了新的上下文管理功能。
核心功能¶
插件提供以下工作區能力：
- 軌跡磚塊牆：展示 user、assistant、reasoning、tool call/result、request header 等會話事件。支持展開、過濾以及行內編輯。
- 分類管理：雙欄管理 Prompt、Skill、MCP 與 Tools。支持拖拽上線/下線，以及選擇 Prompt 插入位置。
- 緩存與歷史：跟蹤 request header 變化、cache read token 和管理動作。數據持久化到 SQLite 歷史流。
- 模擬消息：支持注入 Assistant、User、Tool Call、Tool Result 或原始 JSON 事件。
- 消息鍛造：保留草稿、提供詳細上下文卡片、支持 surface replace，具備導入識別與直接注入能力。
- 會話修復：識別 JSONL/Zstandard sessionlog。採用“後寫分支覆蓋 + 官方 crash closer + Session.create 校驗”策略創建修復子會話。此過程絕不改寫源日誌文件。
- 子代理軌跡：識別 subagent tool call/result，並在可獲得子會話 ID 時嵌套展示其軌跡。
安裝與啓用¶
通過 Corepack 調用 pnpm 安裝插件：
corepack pnpm dsh plugin --profile web add dsh-context-console
如果當前正在使用 dsh-assistant-message-forge（消息鍛造臺），建議一次性完成替換，避免兩個插件註冊相同的兼容 RPC：
corepack pnpm dsh plugin --profile web remove dsh-assistant-message-forge
corepack pnpm dsh plugin --profile web add dsh-context-console
安裝完成後，原有 $DSH_HOME/assistant-message-forge/ 數據會直接複用，無需轉換。安裝後需重啓 DSH 以加載插件。
兼容版本¶
DSH 當前處於快速、破壞性演進階段，安裝前請覈對兼容版本表：
| 插件發佈通道 | DSH 基線 | 兼容承諾 |
|---|---|---|
npm latest（當前正式發佈插件） |
dsh-v0.1.1-rc.2 |
已驗證維護基線 |
npm next 候選 |
dsh-v0.1.5-alpha.1 |
適配 Session Log V3 |
| 後續 DSH 正式版 | 尚未發佈 | 待發布並完成驗證後聲明兼容 |
注：開發版不會覆蓋 npm latest。alpha.5 依賴按 0.1.5-alpha.1 精確鎖定，繼續使用 snapshotEvents()、SessionSeq 和 SessionLogOffset。
環境要求：
* Node.js：^22.19.0 || >=24.0.0
* pnpm：建議通過 Corepack 調用（版本 11.7.0）。
數據與安全邊界¶
插件運行時涉及的數據存儲位置如下：
- Context Console 配置：
$DSH_HOME/context-console/manifest.json - 歷史與緩存事件：
$DSH_HOME/context-console/history.sqlite - 繼承的草稿與上下文記錄：
$DSH_HOME/assistant-message-forge/
安全與權限說明：
* RPC 複用 DSH Connection 的 Host/Origin 柵欄和瀏覽器認證，插件不再維護獨立授權策略。
* MCP 配置可能包含環境變量或請求頭；導出狀態前應自行檢查敏感字段。
* sessionlog 修復只創建帶 parentSession 的新會話，不覆蓋或截斷來源文件。
* 正在執行、存在未閉合 turn 的會話會拒絕消息注入和 surface replace。
總結¶
dsh-context-console 適合需要在 DSH 環境下深度管理會話上下文、調試 Prompt 邏輯或修復日誌文件的開發者。它提供了從軌跡查看、資源管理到消息注入和日誌修復的一站式操作入口。如需查看源碼、提交問題或覈對版本完整性，可訪問插件目錄或 GitHub 倉庫。
