dsh-conversation-outline


    

English · [使用文档](docs/usage.md) · [常见问题](docs/troubleshooting.md) · [安全说明](docs/security.md) · [发布指南](docs/publishing-guide.md) · [设计规格](docs/implementation-spec.md)

找到任何一次提问，一键跳回任何一处回答。

智能体的长对话滚起来没完。dsh-conversation-outline 是 DeepSeek Harness Web 的 Codex 风格「会话大纲」插件： 界面右侧一条常驻细竖条——每个问题一根小横条，像一张会话的 minimap——鼠标悬停即展开 预览面板，列出每个问题开头的几个字。点一下横条或某一行，直接瞬移到 Chat 视图里的那条消息， 并高亮闪烁让你不会看漏。界面中英双语（zh-CN / en）。

亮点

• 右侧细条（minimap）——紧贴右边缘的窄竖条，按时间顺序每个问题一根小横条。

平时不占地方、不影响阅读；超过 60 个问题折叠为顶部 +N 标记。

• 悬停预览——鼠标移到细条上，面板滑出：每个问题开头几个字（单行截断）、#轮次

徽标与 HH:MM 时间。移开 240ms 后自动收起；触屏点击可固定面板，Esc 关闭。 纯覆盖层，正文布局纹丝不动。

• 点击跳转——即使停在「轨迹」视图也会自动切回聊天视图，滚动定位并闪烁 1.8s，

尊重 prefers-reduced-motion。

• 搜索 & 加载更早——大小写不敏感过滤 + 翻历史分页。
• 实时——会话进行中新问题自动出现；跟随当前会话，切换即收起。
• 运行时零依赖——浏览器包只引用 React 等平台公共模块，其余全部内联并在构建期

过「纯度门」检查。

安装

前置要求：已安装 DeepSeek Harness （dsh 命令可用）；Node.js ^22.19 或 >=24；pnpm 10+。 通过 npx 运行 DSH 的话，给下面命令加上 npx -p @deepseek-ai/dsh 前缀。

# 1) GitHub（现在就能装，推荐）
dsh plugin --profile web add github:lzbaclz/dsh-conversation-outline

# 2) npm（发布到 npm registry 之后可用）
dsh plugin --profile web add dsh-conversation-outline

# 3) 从源码（本地开发）
git clone https://github.com/lzbaclz/dsh-conversation-outline.git
cd dsh-conversation-outline
pnpm install && pnpm dev:types && pnpm build
dsh plugin --profile web add "link:$(pwd)"

> GitHub 路径零构建脚本：本仓库把构建产物 lib/ 一并提交（.gitignore 故意不忽略）， > github: 安装拿到的就是可直接加载的产物——不需要 prepare 脚本，也不需要 profile > 里的 allowBuilds 配置。 > 如果 npm 命令报 package not found，说明包还没发布到 npm——请用上面的 GitHub 路径。

安装之后：重启 DSH Web 服务并刷新页面（link: 安装只需在 pnpm build 后刷新）。 确认插件在 profile 里：

dsh plugin --profile web list

升级用同一条 add 命令（可钉版本：dsh-conversation-outline@0.1.0）。

使用

装好重启后，打开任何一个已有消息的会话，右侧边缘会出现细竖条：悬停预览问题、点击跳转、 搜索过滤、加载更早 翻历史。完整走查：[docs/usage.md](docs/usage.md)。 没看到？先看 [常见问题](docs/troubleshooting.md)。

界面预览

> 真实截图占位：装好后把细条 + 面板的截图放到 assets/ui.png，就会显示在这里。


开发

pnpm dev:types   # 符号链接 @deepseek-ai 类型（一次性）
pnpm typecheck   # host + client 双 tsc program
pnpm build       # tsc(host) → tsc(client) → tsdown 打包 lib/client.js
pnpm verify      # 离线冒烟：manifest/exports/patch/产物形状 + 纯逻辑断言

纯客户端改动可热更新：pnpm exec tsdown --watch 持续重写 lib/client.js，DSH 的客户端 HMR 链（或简单刷新页面）即可生效。host / manifest 改动需要重启服务。scratch profile 测试配方：[docs/implementation-spec.md §4.2](docs/implementation-spec.md)。

一起聊聊

随时欢迎提 issue：点这里。 问题、点子、你用这个插件做了什么、截图——都欢迎。

License

MIT——见 [LICENSE](LICENSE)。纯客户端插件：无遥测、无额外网络请求 （[安全说明](docs/security.md)）。