前言¶
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 仓库。
