MIT 协议、默认只读的 DSH 分析插件：把会话日志转成费用 / Token / 工具调用报告，含确定性诊断、协作复盘与 PNG / HTML / PDF 导出。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-09-06
许可证
MIT
01它能帮你完成什么？
把 DSH 会话日志聚合成日报 / 周报 / 月报 / 年报 / 自定义区间分析报告
费用、Token、工具调用、重试风暴、危险操作与密钥模式存在性检测，附确定性诊断
想看清 agent 在每个会话、每个周期花了多少、做了什么的 DSH 用户
导出 DeepTrace 报告用于分享或归档
Web 面板报告、PNG、可打印 HTML 页与 PDF（A4），外加 `whale_report` 工具返回的 markdown 报告
复盘 agent 花费与协作、或归档周期报告的团队
02如何接入 DeepSeek Harness？
前置条件
- DSH（DeepSeek Harness，web 端）环境；官方兼容基线 DSH 0.1.1-rc.2（peer 范围 `>=0.1.1-rc.2 <0.2.0`）
- （可选）DSH-better-sidebar，让「深迹」Tab 出现在 + 菜单；未装时由右下角悬浮按钮兜底
安装步骤
- 01
运行 `dsh plugin --profile web add "github:SenmuuuuW/dsh-whale-report"` 注册进 dsh web（推荐，完整功能）
$ dsh plugin --profile web add "github:SenmuuuuW/dsh-whale-report"
- 02
重启 dsh web 使宿主代码生效；客户端 bundle 随插件自动更新
- 03
（仅依赖）`npm install dsh-whale-report@0.6.1`——只安装包，不会自动注册为 DSH 插件
$ npm install dsh-whale-report@0.6.1
验证接入成功
- 在 DSH web 侧边栏 + 菜单打开「深迹」Tab；未装 better-sidebar 时右下角悬浮按钮兜底
回滚
- 通过 dsh 插件管理器卸载即可；数据走官方接缝，卸载即净
03DSH 适配与能力边界
通过 `dsh plugin --profile web add` 注册进 dsh web 的 DSH 插件（官方接缝 ctx.sessionQuery + storage domain）
周期报告（6 种预设）
DSH 会话事件日志（官方接缝 ctx.sessionQuery + storage domain）→日报 / 周报 / 月报 / 年报 / 滚动 24h / 自定义区间报告，带较上周期 ▲/▼
费用与 Token 核算（只读）
会话事件→费用（官方峰谷价、按真实生效日）、Token、工具调用、重试风暴、危险操作、密钥模式存在性扫描
默认只读；受控 Apply 接缝（shell.timeoutMs）
确定性诊断（Repeated Tool Failure / Retry Waste / Peak Cost）→建议 + 证据 + 验证计划；用户批准后做单一 `shell.timeoutMs` 调整，再判 VERIFIED / NOT IMPROVED / INCONCLUSIVE
仅在用户批准后写入 `shell.timeoutMs` 设置；其余配置不自动修改导出（Web / PNG / HTML / PDF）
canonical 报告→Web 报告、PNG（主报告）、可打印 HTML 页、A4 PDF；`whale_report` 工具返回 markdown
04适合谁？何时不该用？
适合
- 想看清 agent 在每个会话、每个周期花了多少、做了什么的 DSH 用户
- 复盘 agent 花费与协作、或归档周期报告的团队
不适合
- 费用为估算，不是 provider 账单——按官方峰谷价与真实生效日计算，最终以 DeepSeek Platform 账单为准。
05兼容性、维护与安全提示
- 费用为估算，不是 provider 账单——按官方峰谷价与真实生效日计算，最终以 DeepSeek Platform 账单为准。
- Apply 目前只支持 `shell.timeoutMs`：单一、用户批准、可回滚的修改；不支持任意 config / shell / code mutation，不自动回滚、不做 self-healing。
- 默认只读：绝不改写会话历史；密钥扫描只记录模式标签（不存原文）；纠正信号只存类别与计数。
readme_verified
06常见问题
怎么装进 DeepSeek Harness？
运行 `dsh plugin --profile web add "github:SenmuuuuW/dsh-whale-report"` 后重启 dsh web，即注册为完整功能 DSH 插件；单独 `npm install` 只装引擎，不含 Web UI 与 `whale_report` 工具。
DeepTrace 测什么？
把会话事件日志聚合成费用（官方峰谷价、按真实生效日）、Token、工具调用、重试风暴、危险操作、密钥模式存在性检测（不存原文）与会话轨迹，覆盖 6 种周期。
安全吗、会改我的数据吗？
默认只读，绝不改写会话历史；唯一可写的是用户批准的 `shell.timeoutMs` 调整，不自动回滚、不做 self-healing。
费用数字精确吗？
不精确——费用是按官方峰谷价与真实生效日估算的，不是 provider 账单，最终以 DeepSeek Platform 账单为准。
怎么导出报告？
面板内是完整 Web 报告；主报告可导出 PNG，另有可打印 HTML 页，或直接打印面板为 PDF（A4）；对话里 `whale_report` 工具可返回 markdown 报告。
07相关的 DSH 工作流
weknora
作者 tencent
开源的 LLM 知识库平台：把原始文档转化为可检索的 RAG 知识库、自主推理智能体和自动维护的 Wiki 系统，支持多租户部署。
honcho
作者 plastic-labs
用于构建有状态 AI 智能体的记忆库，支持跨会话连续学习与上下文工程。
webnovel-writer
作者 lingfengqaq
基于 Claude Code 的长篇网文辅助创作系统，解决 AI 写作中的「遗忘」和「幻觉」问题，支持 200 万字量级 连载创作。
mirage
作者 strukto-ai
全球首个面向 AI 智能体的统一虚拟文件系统。
08数据与来源
**① DSH 插件安装（推荐，完整功能）** —— 注册进 dsh web
dsh plugin --profile web add "github:SenmuuuuW/dsh-whale-report"
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-09-06。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。