dsh-trail

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-03），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh-trail

**Friendly Trajectory** — a new-user-friendly replacement for the DeepSeek Harness Web
"轨迹" (Trajectory) tab: the raw event ledger becomes a storyline anyone can read.

[中文](README.zh.md) · [Usage](docs/usage.md) · [Development](docs/development.md)

The built-in trajectory view is a power tool: untranslated jargon with no legend, five
toolbar toggles, a zoomable/draggable timeline, a separate inspector, and an event table
that never answers "what did I ask → what did the AI do → what came back". `dsh-trail`
replaces that tab with a storyline design — one collapsible card per round,
plain-language tool names, inline argument previews, and guidance for every state. It
reads only the session snapshot, adds no Host half, and uninstalling restores the
original view.

## Features

- **Turn cards** — one card per round: what you asked → what the AI thought → which
  tools it called → the outcome, with duration, model and token meta when present.
- **Plain-language tool labels** — `read` renders as *读取文件 (read a file)* with a
  one-line note; unknown tools fall back gracefully.
- **Inline argument previews** — the touched file or command is visible on the row;
  raw arguments, results, timing and error metadata fold into a Details toggle.
- **Category filter** — 全部 (all) plus eight row categories, combinable and
  remembered across sessions.
- **Fuzzy search** — ignores case, punctuation and full-width forms; multi-word terms
  match as ordered subsequences.
- **Live round** — dashed card with status pills (thinking / generating / running
  tool · elapsed) and a spinner; durations are never fabricated.
- **Zero product coupling** — renders purely from top-level session snapshot fields;
  no Host half, no new data endpoints.

## Screenshots

The Friendly Trajectory view inside the official Web GUI — turn cards summarize each
round, and reasoning, tool arguments and full replies stay folded until expanded:

![Friendly Trajectory view](docs/screenshot.png)

![Rounds view](docs/screenshots/rounds-view.png)

![Tool details](docs/screenshots/tool-details.png)

## Install

```sh
dsh plugin --profile web add dsh-trail dsh-trail-bundle
```

Restart the profile and open any session: the 轨迹 tab is now the storyline view. The
bundle disables the shipped `ui-trajectory` row and mounts this view in its place, so
exactly one 轨迹 tab remains.

To go back to the original view:

```sh
dsh plugin --profile web remove dsh-trail dsh-trail-bundle
```

### Update

```sh
dsh plugin --profile web update dsh-trail dsh-trail-bundle
```

Upgrades are never applied automatically; restart the profile afterwards. Two pnpm
behaviors can make an update look stale right after a release: the registry metadata
cache and the 24-hour `minimumReleaseAge` supply-chain policy for freshly published
versions. If `update` reports "Already up to date" while npm shows a newer version,
clear the cache (`pnpm cache delete dsh-trail`) or pin explicitly
(`dsh plugin --profile web add dsh-trail@ dsh-trail-bundle`).

## Quick start

Open a conversation and click 轨迹. Read it top-down as a story: expand any folded
reasoning or reply with 展开, and open 详情 on a tool row for raw arguments, results,
timing and tokens. Use the search box to jump to a file or command, and the category bar
to isolate e.g. only 工具 rows — both stay applied while you browse.

## Architecture

One repository, two npm packages. `dsh-trail` is the client plugin: it registers the
`conversation.view` slot cell `id: 'trajectory'` and renders purely from top-level
session snapshot selectors (`nodes`, `turnTimings`, `partial`, `runningCalls`,
`hasMore`, `loadingOlder`, `openState`). `dsh-trail-bundle` is a patch bundle whose
`cordis.patch.yml` inserts the plugin row and sets `disabled: true` on the shipped
`ui-trajectory` row. Design rationale is documented in the repository's internal
working docs (not shipped with the package).

## Known Limitations and Deferred Work

- **Web GUI only** — the plugin targets the web shell (`react` ^18 peer dependency);
  other shells are not validated.
- **Simplified Chinese-first** — the v1 view copy (labels, tool names, guidance) is
  简体中文; an English locale is deferred.
- **Legacy snapshot fields** — the plugin reads compatibility projections
  (`nodes`/`turnTimings`/`partial`/`runningCalls`/…), tested against dsh 0.1.0-rc.5;
  it must be upgraded if the product removes those fields.
- **Round grouping is heuristic** — `user`/`tool-result` nodes carry no turn number,
  so round boundaries are inferred from node order and may occasionally be drawn wrong.
- **Not feature-parity with the original view** — the timeline overview, duration
  toggles and batch collapses are removed by design; the essentials fold into Details
  and search is kept.

## Documentation

- [docs/usage.md](docs/usage.md) — install, what the view shows, filters and search,
  uninstall
- [docs/development.md](docs/development.md) — build, test, publish, contribute

## License

MIT — see [LICENSE](LICENSE).