前言¶
DeepSeek Harness（DSH）採用插件化架構，社區開發者可以擴展其功能。在開發或使用過程中，開發者往往需要直觀地查看單輪對話的 token 消耗與累計成本，同時需要將對話記錄導出爲文檔進行存檔或復盤。DSH 官方界面有時會隱藏部分統計信息或對長對話的統計欄進行截斷。下面介紹的 dsh-usage-export 插件旨在解決這些痛點，在輸入框下方直接展示成本估算與完整統計，並提供 Markdown 或 PDF 導出功能。
插件定位¶
這是一個本機優先的 Web 插件，由用戶 alenhu2005 維護。它主要解決三個問題：
1. 成本透明化：實時顯示本輪指令與全對話累計的預估成本。
2. 統計完整化：展開顯示所有統計指標，避免被截斷。
3. 導出便利化：支持將可見文字內容導出爲 Markdown 或可打印的 PDF。
核心功能¶
插件提供以下核心能力：
1. 成本與用量實時顯示¶
在對話輸入框下方，會實時顯示當前狀態與成本估算：
- 尖峯/離峯標記：顯示當前處於尖峯時段還是離峯時段。尖峯時段爲臺灣時間平日 09:00–12:00、14:00–18:00。
- 成本估算：分別顯示本次指令的預估成本與全對話累計的預估成本。計算基於已顯示的 token 用量，計價以 1 CNY = NT$4.60 換算（具體請以 DeepSeek 官方定價頁爲準）。
2. 展開統計列¶
原生界面可能截斷統計行，本插件將其完整展開，顯示以下指標：
- 對話輪數、步數
- LLM 處理時間
- 首 Token 時間
- 生成速度
- 緩存命中情況
- 輸入與輸出 Token 數量
3. 安全導出¶
支持將對話記錄導出爲 Markdown 或 PDF。
- 內容選擇：導出時可以選擇導出全部消息、僅用戶消息或僅助理消息。
- PDF 字級調整：PDF 導出時提供滑桿，範圍 5–20px，默認 11px，用於調整打印字級與縮放比例。
- 隱私保護：僅導出畫面上可見的文字內容。不包含推理過程、工具調用、附件或工作區文件。
安裝與啓用¶
在安裝前，請確保你的環境滿足要求：
- Node.js 22+
- DeepSeek Harness 版本 0.1.1-rc.2 或更新
- 正常運行的 web profile
使用以下命令安裝插件：
dsh plugin --profile web add github:alenhu2005/dsh-usage-export
安裝完成後，重啓 DSH Web 服務，並在任意對話中即可看到新增的統計面板與導出按鈕。
如需移除插件，可執行：
dsh plugin --profile web remove dsh-usage-export
使用方式¶
完成一輪 DeepSeek 回覆後，輸入框下方會自動出現狀態與成本信息。點擊 匯出 MD 或 匯出 PDF 按鈕即可進行導出。
PDF 導出流程：
1. 在導出窗口中選擇需要導出的內容範圍。
2. 拖動滑桿調整列印字級（5–20px）。
3. 系統將打開瀏覽器原生列印視窗，選擇「儲存為 PDF」即可保存文件。
隱私與計算說明¶
- 本地計算：所有成本估算均在瀏覽器端進行，基於當前顯示的 token 用量計算，不會將數據上傳至服務器。
- 數據範圍：僅導出可見文字。插件不會發送遙測數據，也不會讀取工作區內的文件。
- 計價參考：價格換算僅爲參考，請以 DeepSeek 官方定價頁面爲準。
生態背景¶
本插件屬於 DeepSeek Harness 的第三方插件生態。該生態遵循「一切皆插件」的理念，社區目錄提供了插件的索引服務，但插件本身由獨立開發者維護，與 DeepSeek 官方無從屬關係。
結語¶
該插件通過在本地瀏覽器端計算與渲染，爲開發者提供了一個輕量級的成本監控與文檔導出方案。如需查看源碼或獲取更新，可訪問 GitHub 倉庫。
