前言¶
DeepSeek Harness (DSH) 用户在长期使用中会产生大量的会话历史。直接查看原始日志很难快速把握工作流效率、习惯或瓶颈。该插件通过读取 DSH 的 sessionQuery 服务，将原始会话转化为结构化的本地回顾报告，帮助回答诸如“哪种工作类型花费最多精力”或“哪里出现了工具故障或重试”等问题。
插件信息¶
- 名称：dsh-session-insights
- 定位：工作流回顾插件
- 作者：GreenLv
- 许可证：MIT
核心功能¶
该插件生成包含会话历史的本地 HTML 仪表板和 JSON 报告，提供以下视图：
* 概览与时间对比：查看会话、任务家族、Token 使用量及两个时间段的变化。
* 工作流分解：分析项目、角色、代表性工作流及完成证据。
* 使用模式：查看每日活跃时间趋势、会话类型、工具/插件/MCP 使用、文件类型及本地活跃时段。
* 赢与摩擦：基于证据的强度识别，以及失败的信号、重试等需要调查的事项。
* 推荐：基于测量证据的 DSH 工作流建议及可复制的提示词。
此外，它支持离线报告、多种隐私模式以及通过 CLI 和原生命令的自动化。
安装与启用¶
该插件需要 DeepSeek Harness 和 Python 3.11 或更新版本。当前验证的兼容基线为 DSH 0.1.5-rc.2。
- 安装插件包：
dsh plugin --profile web add dsh-session-insights
- 启动对应的 Profile：
dsh web
典型用法¶
在 DSH 的 Composer 中运行原生命令以生成回顾报告：
/session-insights --days 30 --locale en
该命令会将结果写入 $DSH_HOME/insights/runs/<run-id>。
对于自动化或非 Bundle 环境，可以使用 CLI 工具：
python3 scripts/bootstrap.py install --dsh-home "$DSH_HOME"
然后通过 CLI 查看报告：
dsh-session-insights report --dsh-home "$DSH_HOME" --days 30 --locale en --format html --output ./dsh-insights.html
适用场景与注意事项¶
该插件是行为回顾工具，而非遥测或质量判断工具。它不提供实时监控或账单计算。
- 隐私控制：插件提供三种隐私模式（
redacted、metrics、local），用于控制报告内容和语义分析阶段的数据保留。 - 文件位置：生成的报告会被拒绝放入
$DSH_HOME/sessions目录，以确保与源日志树分离。 - 依赖检查：安装前请确保系统环境满足 Python 3.11+ 和 DSH 0.1.5-rc.2 的要求。
生态背景¶
该插件可通过 npm、GitHub Releases 或社区目录（如 dsh.pub）获取。
