dsh-session-insights
greenlv/dsh-session-insights
AI를 어떻게 사용해 왔는지 확인하세요: `/session-insights`는 시간에 따른 DSH 세션을 검토하여 무엇이 효과적이었는지, 어떤 문제가 계속 반복되었는지, 실제로 어떤 결과가 산출되었는지 보여주고, 사용자 컴퓨터에 회고 보고서를 생성합니다.
설치
dsh plugin --profile web add github:greenlv/dsh-session-insightsREADME
dsh-session-insights
简体中文 | Русский | Introduction | Changelog
Run /session-insights in DeepSeek Harness (DSH) to review your session history. Open the HTML report to compare where you spent time across projects, spot tool failures and retries, and find sessions worth revisiting.
Quick start
The 0.8.3 Bundle requires DSH >=0.2.2-rc.5 and Node.js >=24.9.0. The plugin runs without Python. Upgrade rc.4 and older hosts before installing.
The full rc.5 host dependency tree retains known advisories. Review the security policy before use.
For DSH Web, run:
dsh plugin --profile web add dsh-session-insights@0.8.3
dsh web
In the DSH message box, run:
/session-insights --days 30 --locale en --deterministic
Open the returned report.html path in your browser. The plugin writes it and report.json to a new directory under $DSH_HOME/insights/runs/. This command analyzes the selected sessions locally, without asking a model to read them.
Desktop. Install the same package with the official app's plugin controls. On macOS you can also use the app's bundled CLI:
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add dsh-session-insights@0.8.3
If a Windows reinstall fails with EPERM because files are in use, close Desktop and its child host before retrying. Then run the same slash command and open the returned HTML file.
Read the report

- Compare sessions, active time and token usage across two periods. Token totals describe recorded usage, rather than a bill.
- See which projects and workflows account for the most activity. Follow the evidence to sessions with failures, retries or unfinished work.
- Review when you work and which tools, skills and plugins you use. With model analysis enabled, the report can also suggest changes to your workflow and give you prompts to try.
The HTML includes its data and styles and works offline. The companion JSON follows the report schema. Interpret inferred patterns alongside their evidence, especially when judging whether work was completed.
Choose what to share
Remove --deterministic to have the current DSH agent review selected session evidence and write findings. It works through batches one at a time. Wait for the final report path after the command says the run was queued.
With model analysis, your configured provider receives selected excerpts. Its data handling and charges apply. Redaction reduces exposure, but sensitive text can still appear in excerpts.
--privacy | What the report keeps |
|---|---|
redacted (default) | Selected excerpts with identities, paths and likely secrets filtered |
metrics | Aggregate measurements only. Model analysis is skipped. |
local | Selected text and local paths after secret filtering. Use --deterministic to keep the analysis on this machine. |
Model analysis uses the report’s privacy mode unless you set --analysis-privacy separately. Either privacy option set to metrics skips that stage. See the security policy for what the plugin reads, writes and sends.
Select, resume or remove a run
/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]
- Use
--projectwith an absolute path, for example/path/to/projectorC:/path/to/projecton Windows. Quote paths containing spaces. If the selection exceeds 2,000 sessions or 64 MiB of input, shorten the time window or select one project. - Dates and hours use the host timezone by default. Set
--report-timezone Asia/Shanghaior--report-timezone UTC+08:00to choose another. - Resume model analysis with
--resume --workdir RUNand the same days, project, locale, timezone, depth and privacy settings. If more than one run matches, use the reported directory to choose. When model output remains invalid after one repair attempt, the workflow can keep a local report marked as a fallback. - For a report generated directly by the command,
--no-openreturns just the file path. Open the HTML yourself when you want to view it.
Run directories hold the report and its evidence until you remove them. Type /session-insights --cleanup RUN to preview one run, then add --confirm to delete that run and its reports. The plugin only removes directories it marked as its own. If the agent requests cleanup through its tool, the host must ask you to approve it.
DSH compatibility
Version 0.8.3 targets DSH 0.2.2-rc.5. The DSH compatibility check admits later host versions under the declared range. Each later host requires verification of its interfaces and package resolution. The 0.8.2 release notes record its rc.3 acceptance and package identity.
Finish an in-progress semantic run with its original version or start a new run after upgrading. The input identity changed in 0.8.3, so earlier runs cannot resume under it. Existing reports remain readable, and the standalone CLI rebuilds stale deterministic caches.
For a source installation, check out the intended release tag before running dsh plugin --profile web add . from that checkout.
Standalone Python CLI and Skill
Use the standalone CLI to read on-disk V4 session logs or generate reports from a script. It requires Python 3.11 or later. Run the installer from the version of this repository you want to use.
On macOS or 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 en --format html --output ./dsh-insights.html
On Windows, in 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 en --format html --output .\dsh-insights.html
Open the resulting dsh-insights.html, or add --open to the CLI report command to open it automatically. Use doctor --dsh-home <path> to check the installation, report --help for other formats and filters, and semantic --help for scripted model review. Run scripts/bootstrap.py uninstall with the same Python and DSH home to remove the managed CLI and Skill.
The CLI reads session.v4.jsonl or session.v4.jsonl.zstd. Migrate older logs in DSH first. When the latest log cannot be read, the CLI reports the problem rather than counting an older copy of the same session.
Project links
The chart counts npm download requests, which can include repeated downloads and automation.