dsh-turn-outline
dsh-better-sidebar 的轮次大纲侧边栏标签页：按用户轮次折叠会话（输入+工具步骤+输出），结构化跳回对话
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Andor-Z/dsh-turn-outline#d2ca1152ab216d39e8246d19d9c9ee8dbfc8abeeTurn Outline 以 dsh-turn-outline 发布，当前版本为 0.2.7。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH Web 插件：在 dsh-better-sidebar 侧边栏注册「轮次轨迹」tab——把会话按用户轮次折叠成「输入 + 工具步骤 + 输出」摘要，一键定位回对话原位（聊天视图 / 轨迹视图双支持）。
轮次轨迹 tab：会话按用户轮次折叠成「输入 → 工具步骤 → 输出」的结构化轨迹
真实会话截图：整条会话折叠为「轮次 1-5」，每轮 = 用户输入 + 工具步骤 + 最终输出；顶部工具筛选 chips（全部 / bash / read / edit / 更多）按语义色点聚合，点击任意行可定位回对话原位。
适合谁：使用 DeepSeek Harness（Web / Desktop profile）、会话很长、想快速回看某一步「当时做了什么」的用户——希望零成本、不引入 LLM 也不改动核心。
解决什么问题：
sessions 服务（loadOlder + anchorSeq + data-chat-anchor-key），不依赖 DOM 文本与哈希类名。TrailFolder 只重折打开中的轮次（O(delta)）；seq-keyed 行追加不重挂。💡 与 dsh-conversation-outline 互补：它用 LLM 为每轮生成一句话标题做「对话大纲」；本插件零 AI、按轮次折叠「轨迹」。两者注册不同的 tab，可在 better-sidebar 的 + 菜单中同时使用。
前置：DSH 插件宿主 + dsh-better-sidebar。本插件把 better-sidebar 声明为可选 peer——未安装时插件照常加载、只是不注册 tab（inert，无副作用）。
先装 better-sidebar，再装本插件：
npx @deepseek-ai/dsh plugin --profile desktop add dsh-better-sidebar
npx @deepseek-ai/dsh plugin --profile desktop add dsh-turn-outline
使用 Web profile 时把
--profile desktop换成--profile web。ℹ️ 版本线说明：本插件 peer 声明
dsh-better-sidebar@^0.17.0 || ^0.18.0，双线均已联调——better-sidebar 0.18.0 + DSH 0.1.2-rc.1（0.2.7 起验证）与 better-sidebar 0.17.1 + DSH 0.1.1-rc.x（stable）。注意 better-sidebar 0.18.0 仅支持 DSH 0.1.2-rc.1+：旧 stable 宿主（0.1.0-rc.8 ~ 0.1.1-rc.2）请固定安装dsh-better-sidebar@0.17.1。
git clone https://github.com/Andor-Z/dsh-turn-outline
cd dsh-turn-outline
pnpm install && pnpm build && pnpm pack # 产出 dsh-turn-outline-0.2.6.tgz
npx @deepseek-ai/dsh plugin --profile desktop add "file:$(pwd)/dsh-turn-outline-0.2.6.tgz"
重启 DSH（host 改动需完整重启；client 改动硬刷新 Cmd/Ctrl+Shift+R 即可）。打开 better-sidebar 侧边栏的 + 菜单，选择「轮次轨迹」。
npx @deepseek-ai/dsh plugin --profile desktop remove dsh-turn-outline
host（Node） inject: ['webServer','sessionQuery','sessions']
POST /turn-outline/api/events { sessionId, afterSeq }
→ 活跃会话：直接借用 live store 冻结快照（O(1) 探测 + O(delta) 投影，零深拷贝）
→ 冷会话：sessionQuery 持久化日志 + lastSeq 缓存（LRU + 字节上限）
→ 响应逐页（每页 PAGE_SIZE 事件，hasMore 语义）+ 字段裁剪（不发 tool 结果全文）
→ 200 { events, hasMore } / 400 / 403 / 404 / 405 / 413
client（浏览器） inject: ['sessions','betterSidebar']（betterSidebar 可选 peer）
→ registerTab({ id:'turn-outline', single:true })
→ 会话订阅驱动刷新（无定时轮询）+ 增量折叠（TrailFolder：只重折打开中的轮次）
+ seq-keyed 行（追加不重挂）+ 按轮次 React.memo + 三级折叠 + 工具筛选 chips
listEvents 探测与 readSession 读取会对每个事件 structuredClone（活跃会话约 3 次全量深拷贝/请求）。现在活跃会话直接借用 store 的冻结 events 快照（复用不变数组），探测 O(1)、取增量 O(delta)，全程同步零拷贝。PAGE_SIZE 事件（hasMore 续拉，首载渐进渲染）；事件只投影折叠所需字段（文本截断到 TEXT_CAP、arguments 到 ARGS_CAP、tool/result 只留 error 字段——最大的传输与内存占用被去掉）。TrailFolder.push() 每事件只消费一次，snapshot() 复用已封口轮次的 TrailTurn 对象（身份稳定 → React.memo 只重渲染打开中的轮次），每轮刷新从 O(n) 全量重折降为 O(delta)；重复/重发的分页被 seq 水位线丢弃。POST /turn-outline/api/events，浏览器同源 + Host 头信任围栏；只读不回写、不改动会话。| 项 | 值 |
|---|---|
| 平台 | DSH 0.1.1-rc.x（stable 线；web/desktop profile） |
| 依赖 | dsh-better-sidebar（可选 peer；未装则 inert）、react（DSH client 种子注入） |
| 构建 | TypeScript + esbuild，无运行时 npm 依赖 |
| 测试 | vitest 80 用例（fold / folder / jump / tab / host） |
pnpm install # pnpm 10+ 拦截构建脚本时按提示允许 esbuild（见 pnpm-workspace.yaml）
pnpm typecheck # tsc --noEmit
pnpm test # vitest run（80 用例）
pnpm build # esbuild → lib/index.js + lib/client.js（含 bundle 契约自检）
pnpm pack # 产出 dsh-turn-outline-<version>.tgz（prepack 自动重新构建）
布局：src/index.ts（host 路由）/ src/client/（tab 与折叠模型）/ tests/（vitest + jsdom）。
贡献方式：fork → 修改 → pnpm typecheck && pnpm test && pnpm build → 提 PR。
| 现象 | 含义 / 处理 |
|---|---|
| + 菜单里没有「轮次轨迹」 | 确认 better-sidebar 已安装且版本为 0.17.x；确认插件已加入 profile（dsh plugin --profile desktop list）；host 改动后需完整重启 DSH |
| 页面报错 / 样式错乱 | client 改动后未硬刷新：Cmd/Ctrl+Shift+R |
| 冷会话没有轨迹 | 先在会话中任意产生新事件（或激活该会话）再打开 tab；只读路由只回放已持久化的日志 |
| 更新插件后不生效 | host 半变更需 remove + add 重装（同版本号重装可能被 pnpm 缓存跳过，见方式二） |