回头看看你是怎么使用 AI 的:`/session-insights` 会整理一段时间内的 DSH 会话,找出哪些做法有效、哪些问题总在重复、最终真正留下了哪些成果,并生成一份保存在本机的复盘报告。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-session-insights
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:GreenLv/dsh-session-insights
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
English | Русский | 介绍文章 | 更新日志
想回顾过去一个月用 DeepSeek Harness(DSH)做了什么,可以运行 /session-insights。打开生成的网页报告,就能比较各项目花了多少时间,找到工具失败、反复重试或值得回看的会话。
安装并生成第一份报告
0.8.3 插件包(Bundle)要求 DSH >=0.2.2-rc.5 和 Node.js >=24.9.0,安装插件无需 Python。rc.4 及更早宿主请先升级。
rc.5 完整宿主仍有已知依赖漏洞。使用前请阅读安全说明。
使用 DSH Web 时,在终端执行:
dsh plugin --profile web add dsh-session-insights@0.8.3
dsh web
进入 DSH 后,在消息输入框运行:
/session-insights --days 30 --locale zh-CN --deterministic
把命令返回的 report.html 路径放进本地浏览器打开即可。插件会在 $DSH_HOME/insights/runs/ 下新建一个目录,保存网页报告和便于程序处理的 report.json。这条命令在本地整理会话记录,无需调用模型。
官方桌面版。 在应用的插件管理界面安装同一个包。macOS 也可以用应用自带的命令行工具:
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add dsh-session-insights@0.8.3
Windows 上如果重装时因文件占用报 EPERM,先退出桌面应用和它启动的宿主进程再试。安装后在消息框运行上面的命令,用浏览器打开报告。
报告里有什么
- 对比两个时段的会话数、活跃时间和 token 用量。用量来自会话记录,账单以服务商的数据为准。
- 按项目和工作流程查看投入,顺着报告中的证据找到失败、重试或没有收尾的会话。
- 查看常用工具、技能和插件,以及自己通常在什么时间使用 DSH。启用模型分析后,报告还可以结合会话给出改进建议和可复制的提示词。
网页内嵌了数据和样式,断网也能打开。配套 JSON 遵循报告格式。判断任务是否完成时,请结合报告列出的证据。
控制会话内容的使用范围
去掉 --deterministic,当前 DSH 智能体就会用模型分批分析会话片段。命令提示已排队后,等智能体给出最终报告路径。
模型会收到选中的会话片段,数据处理和费用由 DSH 中配置的模型服务商决定。脱敏会过滤常见的敏感内容,但片段仍可能含有敏感信息。
--privacy |
报告保留的内容 |
|---|---|
redacted(默认) |
过滤身份、路径和疑似密钥后的会话片段 |
metrics |
只保留汇总数字,跳过模型分析 |
local |
过滤疑似密钥后,保留选中的会话片段和本地路径。要把分析留在本机,请同时使用 --deterministic。 |
模型分析默认沿用报告的隐私设置,也可用 --analysis-privacy 单独指定。两个隐私选项中只要有一个设为 metrics,就会跳过模型分析。插件读写和发送的数据见安全说明。
筛选会话、续跑和清理
/session-insights [--days N] [--project PATH] [--locale zh-CN|en|ru]
[--privacy MODE] [--analysis-privacy MODE] [--analysis-depth conversation|evidence]
[--report-timezone ZONE] [--deterministic] [--resume] [--workdir RUN] [--no-open]
--project使用绝对路径,例如/path/to/project或 Windows 上的C:/path/to/project。路径包含空格时用双引号括起来。若选中超过 2,000 个会话或 64 MiB 输入,缩短时间范围或只选一个项目。- 报告的日期和时段默认按宿主时区统计。可用
--report-timezone Asia/Shanghai或--report-timezone UTC+08:00指定时区。 - 用
--resume --workdir RUN继续模型分析,天数、项目、语言、时区、分析深度和隐私设置须与该次运行相同。匹配到多个运行时,按提示指定目录。模型输出修正一次后仍不合格时,流程可保留一份标记为回退结果的本地报告。 - 对于命令直接生成的报告,
--no-open让命令只返回文件路径。需要查看时自行打开 HTML。
报告和证据会保存在各自的运行目录。先输入 /session-insights --cleanup RUN 预览,再加 --confirm 删除这一次运行和它的报告。清理只接受插件标记过的目录。如果由智能体调用清理工具,宿主必须向你请求批准。
DSH 兼容性
0.8.3 以 DSH 0.2.2-rc.5 为验收目标。DSH 兼容性检查按声明范围允许后续宿主版本准入,实际版本需单独验证接口和包解析。0.8.2 发行说明记录其 rc.3 验收与软件包身份。
升级前请用原版本完成进行中的语义分析,或在升级后重新开始。0.8.3 更新了分析身份,旧运行无法继续恢复。既有报告仍可打开,独立命令行工具会按需重建旧确定性缓存。
从源码安装时,请先检出所需的发布标签,再在该目录运行 dsh plugin --profile web add .。
单独使用 Python 命令行工具和 Skill
需要直接读取磁盘上的 V4 会话日志,或用脚本批量生成报告时,可以使用单独的命令行工具。它需要 Python 3.11 或更高版本。请在要使用的仓库版本中执行安装脚本。
macOS 和 Linux:
DSH_HOME="${DSH_HOME:-$HOME/.dsh}"
python3 scripts/bootstrap.py install --dsh-home "$DSH_HOME"
CLI="$DSH_HOME/tools/dsh-session-insights/venv/bin/dsh-session-insights"
"$CLI" report --dsh-home "$DSH_HOME" --days 30 --locale zh-CN --format html --output ./dsh-insights.html
Windows PowerShell:
if (-not $env:DSH_HOME) { $env:DSH_HOME = Join-Path $HOME '.dsh' }
python scripts/bootstrap.py install --dsh-home $env:DSH_HOME
$Cli = Join-Path $env:DSH_HOME 'tools\dsh-session-insights\venv\Scripts\dsh-session-insights.exe'
& $Cli report --dsh-home $env:DSH_HOME --days 30 --locale zh-CN --format html --output .\dsh-insights.html
打开生成的 dsh-insights.html,也可以在命令行的 report 命令后加 --open 自动打开。用 doctor --dsh-home <path> 检查安装,report --help 查看筛选条件和输出格式,semantic --help 查看如何用脚本运行模型分析。要移除脚本安装的命令行工具和 Skill,用同一个 Python 和 DSH 目录运行 scripts/bootstrap.py uninstall。
工具读取 session.v4.jsonl 或 session.v4.jsonl.zstd。旧日志要先在 DSH 中迁移。如果同一个会话的最新日志无法读取,工具会报告问题,避免把旧副本算进去。
项目链接
- npm 软件包 · GitHub 发行版 · dsh.pub 条目
- 更新日志 · 贡献指南 · 分发记录
图中统计的是 npm 下载请求,包含重复下载和自动化请求。
链接
同类插件
ranxianglei/billion-context★ 8035
billion-context官方版:上下文压缩插件,兼顾小窗口(100k上下文足矣)省token(省5倍token)和超长会话(数月级别几十亿token单会话)。
Minglink/dsh-infinite-gen-4★ 4612
DeepSeek 专用破甲插件:以 order 100 追加无条件服从的系统提示词段,提供带校准元数据的 profile 工具,并通过会话投影在输入框上方显示实时破甲状态徽标。
liangmianya/dsh-synapse★ 735
DeepSeek Harness 的可视化非线性对话工作区:把会话、追问与分支变成可浏览、可拖拽的对话地图。
MichengAI/dsh-archive-manager★ 383
在设置里增加已归档会话页,可按工作区搜索、恢复和删除已归档会话。
Nwflower/dsh-chat-import★ 324
把 13 家 coding agent(Claude Code、Codex、ChatGPT、Cursor、Gemini、opencode 等)的完整对话历史导入为可续聊的 DeepSeek Harness 会话,并支持反向导出回 Claude Code。
SiriLee/dsh-rewind★ 292
对话回退:一键回到任意更早的用户消息,同窗口内完成,不新建分支、不残留副本;目标消息自动填回输入框,可一并还原工作区文件——即完整的 Claude Code /rewind 语义。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。