前言¶
在 DeepSeek Harness（DSH）裏跑長對話時，上下文窗口會不斷被系統提示、工具定義和消息歷史佔滿。窗口快滿時，往往只能靠體感判斷要不要手動 /compact，也不清楚壓縮前後各塊 token 各佔多少、這一輪會話大概花了多少錢。
Claude Code 有 /context 命令，能把上下文組成攤開給你看。DSH 生態裏，context-vista 由維護者 GooodWei 發佈，定位爲客戶端插件：提供 /context 斜槓命令，並在對話區右側常駐一張可拖動的迷你懸浮卡，用環形圖即時展示 token 用量、壓縮收益與估算費用。
這是什麼¶
context-vista 是爲 DeepSeek Harness 編寫的 DSH 插件，分類爲客戶端。它解決的核心問題是：在長會話中，讓你隨時看到上下文窗口的佔用結構與估算成本，而不必翻日誌或自己心算。
插件當前版本爲 0.1.0，採用 MIT 許可證，在 GitHub 上開源（截至資料抓取時約 12 stars）。SkillHub 目錄頁：https://www.skillhub.cn/plugins/GooodWei/context-vista。
核心功能¶
下面按 README 已寫明的能力逐項說明。
/context 斜槓命令¶
在 DSH Web 客戶端輸入 /context 並回車，會展示一張卡片，內容包括：
- 上下文組成環形圖：系統、工具、消息、剩餘空間
- 佔用進度條
- 會話累計用量與估算費用
右側懸浮卡¶
對話區右側有一張迷你環形圖懸浮卡，無需輸入命令即可即時更新。按住標題欄可上下拖動，位置會自動記憶；點右上角箭頭可收起或展開。
懸浮卡底部有「壓縮上下文」按鈕，點擊即觸發 /compact，效果與手動輸入該命令相同。壓縮進行中會顯示「壓縮中…」，按鈕在此期間禁用。
費用估算與自定義定價¶
插件內置 DeepSeek 官方定價（人民幣 ¥，含峯谷時段）。金額僅爲估算，不代表實際賬單。
要覆蓋或新增定價，可編輯 ~/.dsh/settings.yaml，修改後熱加載，無需重啓 DSH。貨幣單位與峯谷定義跟隨 API 路由，每個路由可各自指定。
安裝與啓用¶
安裝前需本機已有 pnpm（dsh plugin add 內部會調用它）。若已全局安裝 dsh，下面命令裏的 npx @deepseek-ai/dsh 可簡寫爲 dsh。
npx @deepseek-ai/dsh plugin --profile web add github:GooodWei/context-vista
npx @deepseek-ai/dsh web
第一條命令把插件加入 Web 配置；第二條啓動 DSH Web 客戶端。
典型用法¶
查看上下文組成¶
啓動 DSH Web 後，在輸入框輸入：
/context
回車即可打開環形圖卡片，對照系統、工具、消息各塊佔比，判斷是否需要壓縮。
從懸浮卡觸發壓縮¶
當右側懸浮卡顯示佔用率偏高時，直接點底部「壓縮上下文」。插件會調用 /compact，壓縮期間按鈕顯示「壓縮中…」並禁用，避免重複觸發。
自定義定價（最簡示例）¶
在 ~/.dsh/settings.yaml 中爲某個 API 路由寫入模型單價（每百萬 tokens）：
context-vista:
pricing:
"https://api.deepseek.com":
models:
deepseek-v4-pro:
peak: { hit: 0.3, miss: 9, output: 27 }
offpeak: { hit: 0.15, miss: 4.5, output: 13.5 }
外層鍵可用 provider 路由名或 baseURL；模型價格可寫平坦價 { hit, miss, output }，或峯谷分檔 { peak, offpeak }。未匹配到的模型按內置默認處理（模型名含 flash 走 flash 檔，否則 pro 檔）。支持 * 作爲路由名或模型名的通配符。
適用場景與注意¶
適合誰
- 經常在 DSH Web 裏跑長對話、需要盯上下文窗口占用的開發者
- 想對照 Claude Code
/context體驗、在 DSH 裏做同類可視化的用戶 - 需要按路由和模型粗略估算會話費用的場景
使用前注意
DSH 的理念是「一切皆插件」；SkillHub 等社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，安裝前請自行查看源碼與許可證。
插件以當前 dsh 進程權限運行。費用數字來自配置與內置默認定價，僅供參考；多路由、多模型並存時，建議在 settings.yaml 裏把常用路由寫全，避免估算偏差。
結尾¶
context-vista 把上下文窗口的 token 分配、壓縮入口和費用估算集中到 /context 命令與右側懸浮卡里，適合在 DSH Web 長會話中持續觀察窗口占用。目錄頁：https://www.skillhub.cn/plugins/GooodWei/context-vista；源碼與完整配置說明：https://github.com/GooodWei/context-vista。
