urzeye/dsh-outline

dsh-outline

DeepSeek Harness（DSH）Web GUI 的实时大纲插件：在会话页提供一棵”用户问题 + Markdown 标题（H1~H6）”的大纲树，流式生成时实时更新，点击节点即可定位正文并高亮当前阅读位置。

[!TIP] 若您以浏览器方式使用 DeepSeek Harness，建议优先体验 Ophel：专为浏览器场景深度优化，功能更全面、体验更流畅。

特性

实时大纲

• 大纲由会话事件流构建（用户问题为一级节点，助手回复中的 Markdown 标题挂在其下），不抓取 DOM
• 流式生成时随 token 实时更新；刷新、重连、历史分页由 DSH runtime 自动重建，无需自行处理
• 点击节点滚动定位正文，并高亮当前阅读位置

层级与视图

• 层级滑块控制展开深度（0~6 档），节点可单独展开/收起，支持一键展开/收起全部
• 关键词搜索（带匹配计数）、按会话收藏、”只看收藏”模式
• 一键复制大纲、回到顶部/底部

面板形态

• 面板为 shell.overlay 浮层：右缘触发条悬停预览、可固定常驻、可拖拽移动，不挤压聊天区

主题与国际化

• 跟随 DSH 主题变量与明暗模式；界面文案中英文随 DSH 语言切换

环境要求

• DeepSeek Harness（DSH）Web GUI
• Node.js ≥ 22.13（仅本地开发与构建时需要，pnpm 11 的最低要求）

安装

以下命令均通过 dsh plugin 转发给 profile 目录内的 pnpm。安装后需重启 dsh web 生效（插件的 host 部分在 DSH 启动时加载）。

从 npm 安装（推荐）

dsh plugin --profile web add dsh-outline@latest

已经装过时请带 @latest：裸包名会沿用 lockfile 里的旧版本，不会自动升级。

从 tarball 安装

无需发布 npm，也不需要任何构建授权。可自行 pnpm pack，或从 GitHub Releases 下载：

pnpm pack                                          # 产出 dsh-outline-<version>.tgz
dsh plugin --profile web add ./dsh-outline-0.1.5.tgz

本地路径安装（开发调试）

先在本仓库构建，再把本地路径 link 进 DSH 的 web profile：

cd /path/to/dsh-outline
pnpm install
pnpm build

若先前装过 npm 上的 dsh-outline，先卸掉，避免仍在跑旧包：

dsh plugin --profile web remove dsh-outline
dsh plugin --profile web add /path/to/dsh-outline   # 或相对路径 ./dsh-outline

第一次安装（以及任何 host 半变更）后需重启 dsh web。打开任意会话页，悬停右缘大纲触发条，确认面板出现。

之后改 src/client/** 时另开终端盯构建即可，不必重启 dsh web：

cd /path/to/dsh-outline
pnpm watch

保存后 tsdown 重写 lib/client.js，DSH client HMR 会自动刷新。

改动	要不要重启 dsh web
src/client/**（面板、定位、抽取）	否，pnpm watch + HMR
src/index.ts / host 半、cordis.patch.yml、dsh.plugin.json	要
第一次 dsh plugin add	要

常见问题：

• 命令必须带 --profile web，否则加不到 Web GUI 那套 profile。
• 面板不出现：看 dsh web 终端有没有插件加载报错；确认装的是本地路径而不是 npm 旧版。
• 改了代码页面没变：看 pnpm watch 有没有写出 lib/client.js，必要时浏览器强刷一次。

卸载

dsh plugin --profile web remove dsh-outline

使用

1. 启动 dsh web，打开任意会话页。
2. 鼠标悬停会话页右缘的大纲触发条，即可预览大纲面板。
3. 点击触发条或面板右上角的固定按钮，将面板固定常驻；拖动标题栏移动面板位置（拖动即固定）。
4. 面板内：点击节点跳转正文；顶部滑块调整展开层级；节点行内提供展开/收起与收藏按钮；支持关键词搜索。

开发

把本仓库 link 进 DSH、HMR 与何时重启，见上文「本地路径安装（开发调试）」。

pnpm install       # 安装依赖（prepare 会自动构建 lib/）
pnpm build         # tsc 类型 + tsdown client bundle
pnpm test          # vitest（core 纯逻辑 + DOM 锚点）
pnpm typecheck

命令	说明
pnpm install	安装依赖（prepare 自动构建 lib/）
pnpm build	构建（tsc 类型 + tsdown client bundle）
pnpm test	运行 vitest 测试
pnpm typecheck	类型检查
pnpm watch	监听构建，配合本地 link 安装 HMR 调试

src/
├── core/            # 纯逻辑：标题解析、大纲树、滚动计算（不依赖 DSH/DOM）
├── client/          # 适配层：会话事件流订阅、面板组件、槽位注册
│   └── panel/       # 大纲面板 React 组件
└── index.ts         # host 侧入口
tests/               # vitest 测试（core 纯逻辑 + DOM 锚点）
docs/                # 可行性分析与技术方案

架构纪律见 AGENTS.md：src/core/ 只放纯逻辑，DSH API 调用只出现在适配层与槽位注册代码里。

文档

文档	内容
docs/feasibility.md	可行性分析（证据、能力映射、边界）
docs/technical-plan.md	技术方案与分阶段实施计划

贡献

欢迎通过 Issue 与 Pull Request 参与贡献。

• 改动 src/core/：运行 pnpm test
• 改动适配层/面板：运行 pnpm typecheck，并在本地 DSH 实例冒烟验证

社区

使用问题请提交 Issue；社区讨论可前往 LINUX DO。

致谢

• 交互形态移植自 Ophel（浏览器扩展）
• 插件形态遵循 DSH 官方打包与安装约定，参考 DSH-better-sidebar

许可证

MIT