前言¶
在 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
