前言¶

在 DeepSeek Harness（DSH）裏跑智能體時，模型每一輪實際帶了哪些上下文、各段來自哪個插件或入口、歷史是原文還是壓縮摘要，往往只能翻日誌或猜。DSH 生態主張「一切皆插件」，社區插件在獨立目錄站點分發，與 DeepSeek / 幻方無官方從屬關係。下面介紹社區維護的 dsh-context-lite：在不動注入、壓縮與模型執行的前提下，用側欄時間線和來源追溯回答上述問題；v0.3.0 起還複用宿主日誌，爲開發者提供結構化快照、差異與導出接口。

這是什麼¶

dsh-context-lite（GitHub：hope586/dsh-context-lite）是面向 DSH 的非官方社區插件，分類爲客戶端。維護者爲 hope586，許可證 MIT。定位是一句 README 裏的概括：只讀的上下文時間線與自動來源（provenance）側欄——Read-only context timeline and automatic provenance sidebar for DeepSeek Harness。

它不控制注入、壓縮、權限或模型執行，不額外調用模型，不提供獨立統計圓環或 /context 技能；側欄向當前 DSH 宿主發送已鑑權的讀取請求，與其他插件同進程運行，「只讀」描述實現行爲，不代表安全隔離。

當前源碼版本 0.3.1（package.json），要求 DSH 0.2.1-rc.5 或更高的兼容 0.2.x 版本（engines.dsh: >=0.2.1-rc.5 <0.3.0）。公開發布的安裝包對應 v0.3.0；0.3.1 的修復尚未打新 Release，測試修復版需構建源碼或使用已審閱提交中的 lib/。

核心功能¶

側欄：時間線與來源¶

默認展示組成色帶、來源、本輪新增和當前上下文大小；懸停可看含義，點擊可追溯正文、工具結果與壓縮來源。

• 一輪從用戶請求開始，到最終回覆或實際中斷結束；不中斷的中途引導仍算同一輪。
• 歷史原文、歷史壓縮信息、用戶輸入、插件貢獻、模型工作和最終彙報分塊展示；同源、相鄰、同階段內容可合併。
• 自動觀察來源，不要求其他插件填特殊字段或改代碼；啓動時輕量補查現存註冊項，無法確認的調用方顯示「來源方未確認」。
• 複用 DSH 的會話、主題、側欄與固定估算器；界面隨 DSH 中英文設置切換，用戶原文、插件名、路徑和標識符保持原樣。細節見倉庫 來源說明 與 兼容性。

開發者上下文審計（v0.3.0+）¶

複用 DSH 原生日誌，只註冊 GET，不增加模型工具或額外服務；所有接口需宿主鑑權，且每次查詢都要帶 sessionId。

默認導出不含正文、工具參數或原始事件；顯式 includeContent=true 才含原始事件與導出時有效內容。默認上限 32 MiB（配置項 maxExportBytes），超限返回 413。邊界與示例見 開發者 API 文檔。

來源元數據與存儲¶

來源主名爲實際插件包或腳本入口，輔助顯示進入方法與原標識符。運行時採集優先；數據在宿主 storageDomain 的 context_lite_origins，默認最多 64 個會話，每會話最多 2000 條最新歸因及 2000 條證據觀察。插件無獨立雲服務、API key 或遙測。

安裝與啓用¶

需要已安裝的 DeepSeek Harness 和 pnpm。首發通過 GitHub 分發，尚未發佈到 npm。

從 v0.3.0 Release 下載預構建的 dsh-context-lite-0.3.0.tgz，對照同頁 SHA256SUMS 校驗後安裝：

dsh plugin --profile web add ./dsh-context-lite-0.3.0.tgz

也可以安裝帶預構建產物的 Git tag：

dsh plugin --profile web add github:hope586/dsh-context-lite#v0.3.0

按你管理 Web 的原有方式重啓後端，然後打開會話標題欄的「上下文」圖標，或右側欄開始頁的「上下文」。不要爲重載再啓動第二個 Web 服務。Desktop 請通過官方插件管理頁添加本地解壓目錄並啓用；不要從 CLI 繞過 Desktop 對 profile 的管理。

卸載 Web 端：

dsh plugin --profile web remove dsh-context-lite

卸載後重載；清理元數據應在所有使用該存儲的 DSH 進程停止後，備份並移除 DSH_HOME 下 storages/context_lite_origins 目錄。

典型用法¶

1. 安裝並重載後端後，在會話 UI 打開「上下文」側欄，按輪次查看色帶、新增塊與估算大小。
2. 對某段內容懸停看說明，點擊進詳情追溯正文、工具結果或壓縮來源；來源未確認時會明確標註。
3. 排查插件注入或壓縮問題時，對已鑑權會話調用審計 API，例如先取 snapshot，再用 diff 看輪次間變化；需要離線分析時用 export（注意默認不含正文，分享導出前評估來源路徑是否含私有信息）。

插件配置通過 DSH 插件配置編輯，無獨立控制面板。常用項包括：collectOrigins（默認 true）、persistOrigins（默認 true）、maxVisibleRounds（默認 120）、previewCharacters（默認 12000）等，完整表見 README「設置與卸載」一節。

適用場景與注意¶

適合誰： 日常在 DSH Web 會話裏想快速看清「這一輪上下文從哪來、佔多少」的用戶；編寫或調試 DSH 插件、需要對照宿主日誌做上下文審計的開發者。

使用前請知悉：

• 插件以當前 dsh 進程權限運行，安裝前應自行查看源碼與 MIT 許可證及 THIRD-PARTY-NOTICES。
• 快照按結算前日誌重建，不是提供方適配後的完整抓包；缺少記錄不能證明未發生注入；證據有延遲寫入，崩潰可能丟尾部。
• 系統提示詞、環境快照、工具定義仍整體計量，詳情列貢獻方，不虛構逐插件 token 分攤。
• 遠程部署時側欄讀取請求經你的網絡；導出即使不含正文，來源路徑也可能是敏感信息。

結尾¶

dsh-context-lite 把「模型帶了什麼、來自哪裏」做成只讀側欄與可選審計 API，與 DSH 原生 UI 和估算器對齊，適合作爲客戶端觀測層而不是第二套上下文控制器。

• 社區目錄頁：https://www.skillhub.cn/plugins/hope586/dsh-context-lite
• 源碼與文檔：https://github.com/hope586/dsh-context-lite