前言¶

在 DeepSeek Harness (DSH) 的開發或使用過程中，一個常見的問題是判斷當前上下文是否已經接近窗口上限，或者是否應該結束當前會話開啓新會話。這種判斷通常依賴經驗，缺乏量化依據。

dsh-context-compass 插件旨在解決這一問題。它通過收集 DSH 內部的真實運行數據，爲開發者提供一個基於事實的“繼續 vs 新開”決策羅盤。

插件介紹¶

dsh-context-compass 是 DeepSeek Harness 的一個會話健康插件，由 NinjaSln-labs 維護。它不依賴估算，而是直接讀取 Harness 的 sessionHealth 投影、tokenMeter、fs 探測以及 Git 狀態等真實數據，幫助用戶判斷當前會話的健康狀態。

核心功能¶

頭部徽章¶

插件會在會話日誌按鈕旁顯示一個響應式的頭部徽章。徽章的顏色由 sessionHealth 投影驅動，反映了當前的上下文壓力。

懸停徽章會顯示詳細信息：
* 佔用趨勢：最近 ≤40 次請求的壓力採樣迷你折線圖。
* 成本與緩存：每輪 token 成本、緩存命中率（上下文穩定度的表現）。
* 壓縮信息：壓縮次數、上次壓縮比例（按快照口徑推斷）。
* 計費預期：顯示 CNY 或 USD，並標註忙時價/閒時價。

/compass 命令¶

輸入 /compass 可查看完整的文本報告。該命令支持多種變體：

• /compass：全部探測（默認關閉進程探測）。
• /compass minimal：僅核心指標（token / 窗口 / 規模）。
• /compass no-git / /compass no-handoff：跳過 Git 或交接文檔探測。
• /compass doc=<文件名>：檢查指定的交接文檔。
• /compass remaining=<輪數>：根據剩餘輪數預估費用。
• /compass processes：強制開啓進程探測。

context_compass 工具¶

這是一個模型可調用的只讀評估工具，適用於長任務自查。它會返回結構化結論，包括 severity（嚴重程度）、recommendation（建議）、signals（信號）、cost（成本）和 handoffReady（交接就緒狀態）。

多會話羅盤一覽面板¶

在側欄底部“設置”旁點擊“羅盤一覽”按鈕，可打開全屏面板。該面板列出所有會話的健康判定，按運行狀態排序。狀態列包含三態：運行中、已加載、冷卻。點擊行可打開對應會話並運行 /compass。

判定模型¶

插件採用二維“繼續 vs 切換”模型，參數可在配置中調整。默認檔位如下：

• 綠：窗口占比 < 30%，每輪計費當量 < 50K。建議放心繼續。
• 藍：佔比 30–50%，或消息數 ≥ 800。建議繼續，留意窗口。
• 黃：佔比 ≥ 50%，或每輪計費當量 ≥ max(50K, 30% × 窗口)。建議在下一個任務邊界收尾。
• 紅：佔比 ≥ 80%。建議儘快收尾並交接。

經濟成本（每輪計費當量）優先於容量（窗口占比）。

安裝與啓用¶

安裝命令如下：

dsh plugin add dsh-context-compass

安裝後，插件會自動註冊 sessionHealth 投影和 /compass 命令。

配置¶

插件支持通過配置文件或瀏覽器配置卡片進行調節。關鍵配置項包括：

• thresholds：判定模型參數（窗口占比、經濟門檻、消息數代理指標）。
• checks：探測開關（Git、交接文檔、進程探測等）。
• cost：計費相關配置（緩存摺扣、價格源、刷新時間）。

其中 projection.enabled 控制徽章顯示，thresholds 和 checks 的改動通常即時生效，無需重啓。

價格與計費¶

插件內置了 DeepSeek 官方定價文檔的解析邏輯。金額顯示支持 CNY 和 USD 雙幣種，並區分忙時價和閒時價（按北京時間判定）。

數據源爲官方定價文檔，支持自動刷新（默認 24 小時）和回退機制。首次加載前或配置爲 static 時，會使用兜底的靜態價格。

生態與注意¶

• 知識庫聯動：插件解耦了知識庫依賴，僅當檢測到知識庫插件（如 dsh-knowledge-sqlite）時，纔會進行跨會話回顧的探測。
• 本地持久化：僅本機 loopback 部署支持本地寫持久化。
• 權限：插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。

總結¶

dsh-context-compass 通過將上下文管理從經驗主義推向數據驅動，幫助開發者更精準地控制會話生命週期。