前言¶
在 DeepSeek Harness（DSH）裏跑編碼智能體，賬單往往按 Token 計。除了模型本身，還有三類開銷容易被忽略：回覆裏的寒暄與複述、終端裏幾百行裏只有幾行有用、以及每輪對話重複注入的規則與說明。社區插件 Tersio（維護者 KurutoDenzeru，npm 包 @krtclcdy/tersio）在同一套擴展樹上提供多種可開關模式，並附帶用量 Dashboard 與 MCP 接口，目標是把上述三類成本壓下去。README 寫明：若只是偶爾用智能體，安裝收益可能不值得；若按 Token 日結，才值得認真配置。
這是什麼¶
Tersio 的定位是 Token saver & usage tracker for coding agents：更短的回覆（Caveman）、壓縮後的 Shell 輸出（RTK）、更 lean 的代碼改動（Ponytail）、可選的設計嚴謹模式（pstack）、可選的歷史與工具輸出壓縮（Headroom），以及一鍵組合預設（Combo）和本地 Dashboard。它可安裝到 Oh My Pi、pi、OpenCode、Pi-in-go 和 DeepSeek Harness；在 DSH 側通過 npm 插件或 tersio install --host dsh 把同一 bundle 掛到各 profile（桌面端走應用內插件面板，CLI 的 desktop profile 按設計不會被 dsh plugin 寫入）。
許可證爲 MIT；當前資料中的 npm 版本爲 2.25.16。GitHub 倉庫 KurutoDenzeru/tersio 在 SkillHub 目錄中歸類爲工作流，星標約 21、fork 約 4（以目錄頁與 GitHub 爲準）。
核心功能¶
各模式在倉庫中均爲可讀文本塊；各模式帶來的 prompt 開銷與實測節省見 docs/BENCHMARK_GUIDE.md。README 未對總賬單做統一承諾，測試範圍限於回覆 Token、prompt 開銷與命令輸出。
| 模式 | 作用（據 README） |
|---|---|
| Caveman | 先給結論，去掉填充語；代碼、命令、路徑與錯誤信息保持準確 |
| RTK | condensed shell 輸出，保留失敗測試名、斷言與行號等信號 |
| Ponytail | YAGNI：不做未要求的功能與抽象，儘量短 diff |
| pstack | 可選嚴謹模式，在合適時機應用設計原則並負責方案與校驗 |
| Headroom | 可選，壓縮工具輸出、文件讀取與歷史；需自行開啓，Tersio 不會默認打開 |
| Combo | 一條命令同時設定 Caveman、RTK、Ponytail 及三檔強度 |
| Dashboard | 按模型、按日查看消耗 |
六個擴展始終從同一來源加載；會話啓動默認值寫在 ~/.tersio/settings.json，各 Host 共用。
MCP：客戶端在 mcpServers 中配置 command: tersio、args: ["mcp"] 即可；tersio install 會向 OMP、Pi、PiG、DSH、OpenCode 寫入同一 MCP 條目，避免重複進程。可用工具包括 tersio_stats、tersio_activity、tersio_modes、tersio_headroom 等（詳見 README MCP 小節）。
安裝與啓用¶
環境要求（README）：Node.js 20.12+ 與 npm；可選 Bun（在 PATH 上時優先）；SQLite 由 Bun、Node 22.5+ 的 node:sqlite 或系統 sqlite3 提供；支持 macOS、Linux、Windows（含 WSL 內安裝）。
方式一：通用安裝腳本（macOS/Linux） — 安裝 npm CLI 並在同一次流程中跑主安裝器（作用域與 Combo 預設菜單）：
curl -fsSL https://github.com/KurutoDenzeru/tersio/releases/latest/download/install.sh | sh
Windows 使用 install.ps1 的 PowerShell 一行命令（見 README）。安裝後執行 tersio 會彈出菜單選擇 Host；針對 DSH 的非交互安裝爲：
tersio install --host dsh
說明：tersio install --host dsh 會把 bundle 掛到 每個 dsh profile；DeepSeek Harness 桌面應用應在 Plugins 面板 Add plugin 粘貼 @krtclcdy/tersio（或 bundle 未發佈時的本地路徑），然後重啓應用。dsh plugin 按設計拒絕 desktop profile。
方式二：由 DSH 直接安裝 npm 包（web profile 示例，勿與方式一對同一 Host 混用，否則會重複註冊命令）：
dsh plugin --profile web add npm:@krtclcdy/tersio
其他 Host 的安裝命令見 INSTALL.md。一次性試用可不落盤安裝：
npm exec --yes --prefer-online --package=@krtclcdy/tersio@latest -- tersio install
典型用法¶
安裝完成後，常用 CLI 包括：
tersio # 菜單選擇 Host
tersio install --host dsh # 非交互安裝到 DeepSeek Harness
tersio update # 更新 CLI；加 --host 可刷新對應 Host 的擴展
tersio doctor # 健康檢查；--fix 可修復
tersio dashboard # 本地 Dashboard（--open、--export、--port、--currency）
tersio mcp # 以 stdio 啓動 MCP 服務
tersio uninstall # 移除擴展與註冊項
tersio version # 打印版本
MCP 客戶端配置示例：
{
"mcpServers": {
"tersio": {
"command": "tersio",
"args": ["mcp"]
}
}
}
會話中可通過各 Host 自帶的 Tersio 命令或 MCP 的 tersio_modes 調整 Combo 預設或單模式開關；Headroom 與 pstack 爲 opt-in，需按文檔自行啓用。
適用場景與注意¶
適合：按 Token 計費、幾乎每天用編碼智能體 的 DSH 用戶，希望在回覆、終端輸出、代碼 diff 與可選歷史壓縮上統一管控，並需要本地用量視圖或 MCP 讀數。
不適合：README 明確說每週只用幾次的場景，維護成本可能高於收益。
安全與權限：插件在 當前 DSH 進程權限 下運行，會讀寫用戶目錄（如 ~/.tersio/settings.json）並向 Agent 注入規則與擴展。安裝前應閱讀 GitHub 源碼 與 MIT 許可證，確認與團隊策略一致。SkillHub 目錄（plugins/KurutoDenzeru/tersio）是社區索引，與 DeepSeek / 幻方無官方從屬關係；DSH 生態主張「一切皆插件」，本文安裝命令均來自倉庫 README，請勿憑倉庫名自行拼接未文檔化的 dsh plugin add github:... 形式。
結尾¶
Tersio 把 Caveman、RTK、Ponytail、Combo、Dashboard 等能力收進同一 npm 包與共享擴展樹，並針對 DSH 提供 dsh plugin ... add npm:@krtclcdy/tersio 與 tersio install --host dsh 兩條官方路徑。若要覈對功能細節、基準方法與完整安裝矩陣，以 GitHub README 與 INSTALL.md 爲準。
- 目錄頁：https://www.skillhub.cn/plugins/KurutoDenzeru/tersio
- GitHub：https://github.com/KurutoDenzeru/tersio
