본문으로 건너뛰기
G

dsh-session-insights

greenlv/dsh-session-insights

AI를 어떻게 사용해 왔는지 확인하세요: `/session-insights`는 시간에 따른 DSH 세션을 검토하여 무엇이 효과적이었는지, 어떤 문제가 계속 반복되었는지, 실제로 어떤 결과가 산출되었는지 보여주고, 사용자 컴퓨터에 회고 보고서를 생성합니다.

설치

dsh plugin --profile web add github:greenlv/dsh-session-insights

README

dsh-session-insights

简体中文 | Русский | Introduction | Changelog

CI Release License: MIT

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

Deterministic report overview with synthetic session data

  • 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.

--privacyWhat the report keeps
redacted (default)Selected excerpts with identities, paths and likely secrets filtered
metricsAggregate measurements only. Model analysis is skipped.
localSelected 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 --project with an absolute path, for example /path/to/project or C:/path/to/project on 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/Shanghai or --report-timezone UTC+08:00 to choose another.
  • Resume model analysis with --resume --workdir RUN and 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-open returns 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.

Cumulative npm downloads for dsh-session-insights

The chart counts npm download requests, which can include repeated downloads and automation.

MIT License

관련 플러그인