# dsh-conversation-outline

![banner](assets/banner.png)

[![npm](https://img.shields.io/badge/npm-v0.1.0-cb3837)](https://www.npmjs.com/package/dsh-conversation-outline)
[![license](https://img.shields.io/badge/license-MIT-2fbf8f)](LICENSE)
[![node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-5FA04E?logo=nodedotjs)](https://nodejs.org/)
[![stars](https://img.shields.io/github/stars/lzbaclz/dsh-conversation-outline.svg)](https://github.com/lzbaclz/dsh-conversation-outline)
[![dsh plugin](https://img.shields.io/badge/dsh-plugin-4d6bfe)](https://github.com/deepseek-ai/DeepSeek-Harness)

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

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

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

## 亮点

- **右侧细条（minimap）**——紧贴右边缘的窄竖条，按时间顺序每个问题一根小横条。
  平时不占地方、不影响阅读；超过 60 个问题折叠为顶部 `+N` 标记。
- **悬停预览**——鼠标移到细条上，面板滑出：每个问题开头几个字（单行截断）、`#轮次`
  徽标与 `HH:MM` 时间。移开 240ms 后自动收起；触屏点击可固定面板，`Esc` 关闭。
  纯覆盖层，**正文布局纹丝不动**。
- **点击跳转**——即使停在「轨迹」视图也会自动切回聊天视图，滚动定位并闪烁 1.8s，
  尊重 `prefers-reduced-motion`。
- **搜索 & 加载更早**——大小写不敏感过滤 + 翻历史分页。
- **实时**——会话进行中新问题自动出现；跟随当前会话，切换即收起。
- **运行时零依赖**——浏览器包只引用 React 等平台公共模块，其余全部内联并在构建期
  过「纯度门」检查。

## 安装

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

```sh
# 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 里：

```sh
dsh plugin --profile web list
```

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

## 使用

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

## 界面预览

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

![会话大纲](assets/ui.png)

## 开发

```sh
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：[点这里](https://github.com/lzbaclz/dsh-conversation-outline/issues)。
问题、点子、你用这个插件做了什么、截图——都欢迎。

## License

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