<p align="center"><b>English</b> | <a href="README.zh-CN.md">简体中文</a></p>
📖 Trajectory Reader · 轨迹解读 (DSH Web Client Plugin)
   
Adds a new 「轨迹解读」 (Trajectory Reader) tab to the DSH Web GUI conversation view ring (beside 对话 / 轨迹). It segments the session by user round and, for each round, highlights what the user wanted and how the assistant fulfilled it — plus an optional ✨ AI process narrative generated by an LLM for the full think-and-execute story of that round.
UI Preview
<p align="center"> <img src="images/ui.jpg" alt="Trajectory Reader UI — the 轨迹解读 tab inside the DSH Web GUI" width="880"> </p>
The screenshot shows the 轨迹解读 tab open in the DSH Web GUI: the conversation header carries the third view tab (对话 / 轨迹 / 轨迹解读), and the body lists one card per user round. Each round card shows the condensed 🎯 user need, the 🛠 action summary of how the assistant fulfilled it (plan / research / implement / verify / delegate), ⚠ errors and notes, and the 💬 reply digest — while the original user message stays verbatim and expandable, with the full per-tool-call ledger folded away. The ✨ button on a round requests the LLM process narrative (需求 / 思路 / 执行 / 结果) for that round.
Install (one command, auto-activated)
# Option 1: from npm (recommended)
dsh plugin --profile web add @clarkchan/trajectory-reader
# Option 2: straight from GitHub
dsh plugin --profile web add "github:flyingtimes/dsh-trajectory-reader#v0.2.3"> The package declares dsh.bundle.patch, so dsh plugin add automatically appends it to dsh.profile.bundles — no manual cordis.patch.yml editing. After that, restart dsh web and the conversation tab bar shows 对话 / 轨迹 / 轨迹解读.
Links
- npm package: https://www.npmjs.com/package/@clarkchan/trajectory-reader
- GitHub repository: https://github.com/flyingtimes/dsh-trajectory-reader
- Listed on: https://github.com/0xsline/awesome-deepseek-harness
Per-round presentation
Round N · X tool calls · Y files · Z errors [✨ AI interpret this round]
├── 🧠 AI process narrative (optional, LLM-generated)
│ ### User need / ### Assistant thinking / ### Execution / ### Result
├── 🎯 User need one or two sentences distilled by the rules engine (expandable original)
├── 🛠 How the assistant did it plan/research/implement/verify/delegate action summary
├── ⚠ Errors / notes failed tool calls, compaction, truncation, retries
├── 💬 Assistant reply (digest) opening of the reply (expandable full text)
└── ▸ Action details collapsed per-tool-call ledger- Round segmentation: each user message opens a new round; all assistant activity after it belongs to that round. Steering messages mid-execution form their own marked round; orphan activity at session start goes to "session start".
- The rules-based summary is instant and dependency-free; the AI narrative is generated on demand and cached (unchanged material is not re-requested).
✨ AI process narrative (LLM summary)
Architecture
browser client.js ──POST /plugin-api/trajectory-reader/summarize──▶ server index.js
│ │
│ { rounds: [{ key, material }] } │ ctx.llm.stream()
│ system = SYSTEM_PROMPT
◀── { ok, route, results: [{ key, ok, text }] } ─────────────────────┘- Server half (
index.js): activated as a cordis plugin by the web profile Loader row (inject: ["llm", "webServer"]), registers an exclusive route:
- GET same path → availability probe (client shows/hides the AI button based on it); - POST → calls the host llm service per round (model route defaults to the current agent default model agentDefaultModel.currentSelection(), overridable via request provider/model), 120s timeout per round, maxTokens 1200, at most 12 rounds per request. - Each round's material is JSON-framed (same injection defense as session-title: user text cannot break the structural delimiters), and every string is recursively length-capped.
- Client half (
client.js): per-round "✨ AI interpret this round" button plus a top-level "✨ AI interpret all rounds"; results cached by material hash; AI cards render the###section headings; a hint tells the user to restart the GUI when unavailable.
Summarizer prompt (SYSTEM_PROMPT in index.js)
> You are a "session trajectory interpreter" for DeepSeek Harness (a coding-assistant framework). You receive one round's raw material: the user's original messages, the assistant's replies and thinking excerpts, the ordered tool-call records (names and argument digests), errors and system notes. > Your job: write a coherent Chinese interpretation of this round — what the user wanted, how the assistant thought and executed step by step, and the final result — so someone who never saw the session can understand what the assistant did and why. > > Rules: > 1. Interpret only from the supplied material; never invent files, commands, conclusions or causes absent from it; if material is truncated ("…"), do not guess the truncated content. > 2. Output the following Markdown structure (keep the three-# heading lines, in order): ### 用户需求 (one or two sentences…) / ### 助手思路 (…why something was done before something else, how plans adjusted…) / ### 执行过程 (numbered list in actual order…) / ### 结果 (…what was finished, what remains unfinished or failed). > 3. Emphasize the causal chain of the process (e.g., "read A to confirm B, then modify C to finish D"); do not just list tool names. > 4. Keep it under 400 characters; wrap file names, commands and error messages in backticks. > 5. Output only the interpretation — no preamble, no closing remarks, no verbatim re-quoting of the material.
Design notes: the four fixed sections mirror the requested need–thinking–execution–result; no fabrication + no guessing truncated content keep the interpretation faithful to the trajectory; causal emphasis prevents it degrading into a tool list; the length cap and direct-output format keep the card readable.
After enabling (one GUI restart)
After restarting dsh web, the 轨迹解读 tab appears; the AI button becomes available once the GET /plugin-api/trajectory-reader/summarize probe passes. Client bundle changes apply on page refresh; server index.js changes require a GUI restart.
Development & tests
node --check client.js && node --check index.js
node test/smoke.mjs # 61 assertions: round splitting / rule classification / material framing / prompt points / route & streaming assemblyUninstall
cd "$DSH_HOME/profiles/web" && pnpm remove @clarkchan/trajectory-readerdsh plugin automatically removes the package from dsh.profile.bundles on uninstall — no manual cleanup needed.