@chestnut23/dsh-conversation-outline
适用于 DeepSeek Harness 的 Codex 风格对话大纲：浮动面板列出当前对话中的每个用户问题，支持搜索、加载较早内容，以及点击跳转（滚动 + 高亮）。双语 zh-CN / en。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @chestnut23/dsh-conversation-outline@0.2.2Conversation Outline 以 @chestnut23/dsh-conversation-outline 发布，当前版本为 0.2.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
简体中文 · Usage · Troubleshooting · Security · Publishing Guide · Design Spec
Find any question. Jump to any answer.
Long agent conversations scroll forever. dsh-conversation-outline is a
Codex-style conversation outline for DeepSeek Harness Web:
a slim, always-visible right-edge rail — one bar per question, like a minimap of the
conversation — that expands on hover into a preview panel of every question's opening
words. Click a bar or a row and you are teleported to that message in the Chat view, with
a flash highlight so you cannot miss it. Bilingual zh-CN / en.
+N marker.#turn badge and HH:MM time. Collapses 240 ms
after you move away. Pure overlay — your content never shifts.Esc, the ×, or a click outside, so the rail also works on touch, pen and
automation where no hover event ever arrives.prefers-reduced-motion; a jump that cannot
reach the message reports it in the panel instead of failing silently.Requirements: DSH ≥
0.1.5-rc.2(thenextchannel / the DSH Desktop app).
Plugin version Works with 0.2.xDSH ≥ 0.1.5-rc.20.1.2and earlierDSH 0.1.0-rc.x(the Chat node graph still lived insnapshot.chat)
Using the DSH Desktop app? Run the same command in the app's built-in terminal without
--profile— it targets thedesktopprofile automatically. The first install needs one restart of that DSH; later upgrades hot-reload (no restart).
Prerequisites: DeepSeek Harness
(dsh available) ≥ 0.1.5-rc.2; Node.js ^22.19 or >=24; pnpm 10+.
If you run DSH via npx, prefix the commands with npx -p @deepseek-ai/dsh .
On an older host, use plugin 0.1.3 — see the
compatibility table.
# 1) npm (recommended — one command)
dsh plugin --profile web add @chestnut23/dsh-conversation-outline
# 2) GitHub (latest commit, no build step needed)
dsh plugin --profile web add github:lzbaclz/dsh-conversation-outline
# 3) from source (local development)
git clone https://github.com/lzbaclz/dsh-conversation-outline.git
cd dsh-conversation-outline
pnpm install && pnpm build
dsh plugin --profile web add "link:$(pwd)"
Zero build scripts on the GitHub path: the built
lib/is committed to this repo (.gitignoredeliberately does not ignore it), so agithub:install fetches ready-to-load artifacts — nopreparescript, no profileallowBuildsconfiguration. Name warning: an unrelated project owns the unscoped npm namedsh-conversation-outline. This plugin is only published as@chestnut23/dsh-conversation-outline— always install the scoped name (or the GitHub path above).
After installing: restart the DSH Web service and refresh the page (link: installs
just need a page refresh after pnpm build). Confirm with:
dsh plugin --profile web list
Upgrade with the same add command (optionally pin a version:
@chestnut23/dsh-conversation-outline@0.1.4).
dsh plugin --profile web add @chestnut23/dsh-conversation-outline@latest # fetch the new version
The DSH composition always mounts the dsh-client-hmr chain, which watches
installed plugin bundles and reloads them:
Every side effect (style tag, locale dictionaries, slot registrations) is owned by the plugin fiber, so a hot reload never leaves stale code behind.
DSH 0.1.5 renders its own right-edge rail (TurnNavigatorRail) that marks every
turn and labels its ticks Turn N: its prompt-preview field is empty, so the
ticks never show what you asked (a measured session had 72 turns and 2
questions), and 20x10px text-less ticks cannot say which question is which.
While this plugin is loaded it therefore hides that rail (identified by
nav[aria-label], plus a structural fallback for rebuilt views; the marker is
re-applied through a MutationObserver) and owns the right edge itself. The change
is fully reversible:
<html data-dsh-outline-keep-turn-nav> (e.g. from a browser console:
document.documentElement.setAttribute('data-dsh-outline-keep-turn-nav','')).Install, restart, open any session that already has messages — a thin strip appears on
the right edge. Hover it to preview questions; click the strip (or a bar) to open the
panel and keep it open; click a row to jump; search to filter, Load older to page
through history. Full walkthrough: docs/usage.md. Something's not
showing up? Troubleshooting.
Real-screenshot placeholder: after installing, drop a screenshot of the rail + panel at
assets/ui.pngand it will appear here.
pnpm install # installs the pinned @deepseek-ai 0.1.5-rc.2 type packages
pnpm typecheck # host + client dual tsc programs
pnpm build # tsc(host) → tsc(client) → tsdown bundles lib/client.js
pnpm verify # offline smoke: manifest/exports/patch/bundle shape + pure-logic asserts
pnpm test:dom # headless DOM test: mounts the built rail in jsdom and asserts render/hover/jump
pnpm typecheck needs lib/types/** from the @deepseek-ai/* packages. Some DSH
installations ship those packages without declaration files (the Electron bundle
prunes them), and the npm rc channels publish a reduced type surface — in that case
typecheck reports missing modules while the build and runtime are unaffected. The
supported fix is to run against a DSH source checkout (or a profile whose
@deepseek-ai/* links resolve to one); pnpm verify covers the contract-shaped logic
either way.
Client-only changes hot-reload: pnpm exec tsdown --watch rewrites lib/client.js, and
the DSH client HMR chain (or a plain page refresh) picks it up. Host/manifest changes
need a service restart. Scratch-profile testing recipe:
docs/implementation-spec.md §4.2.
Issues are welcome any time: open one. Questions, feature ideas, screenshots of what you built with it — all good.
MIT — see LICENSE. Client-only plugin: no telemetry, no extra network calls (security notes).