在 DSH 中开发智能体时,长会话往往难以快速定位。手动浏览长对话容易遗漏关键步骤。dsh-turn-outline 通过在侧边栏注册一个折叠视图,将长会话按用户轮次折叠为“输入 + 工具步骤 + 输出”的结构化摘要,并提供一键跳转功能。
维护者:Andor-Z
许可:MIT
分类:客户端
核心功能¶
- 按用户轮次折叠轨迹:会话被折叠成结构化的“输入 → 工具步骤 → 输出”格式,长会话一目了然。支持多级折叠与工具类型筛选 chips。
- 一键定位回原位:点击任意轮次或工具步骤,自动加载历史并滚动到聊天视图或轨迹视图的对应行。
- 零 AI 依赖与只读零侵入:纯事件折叠,不调用 LLM,不修改 DSH 核心。host 提供只读路由,client 注册只读 tab。
- 增量性能:会话订阅驱动刷新,不使用定时轮询。增量折叠算法优化渲染开销。
安装与启用¶
该插件依赖 DSH 插件宿主以及 dsh-better-sidebar(可选 peer,未安装时插件 inert)。
安装¶
以 Desktop profile 为例:
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。
重启与启用¶
- host 改动(如路由注册)需完整重启 DSH。
- client 改动(如 tab 注册)需硬刷新(Cmd/Ctrl+Shift+R)。
安装完成后,重启 DSH。打开 dsh-better-sidebar 侧边栏的 + 菜单,选择「轮次轨迹」。
使用方法¶
- 打开任意会话,在侧边栏添加「轮次轨迹」。
- 轨迹按用户轮次折叠展示。点击任意轮次或工具步骤,即可定位回对话原位(支持聊天视图和轨迹视图)。
- 利用轮次或工具类型的筛选 chips 收起无关内容。
技术与兼容性说明¶
- 主线版本:以 DSH 0.2.0-rc.x 为主线,走
uiConversation会话视图注册表。 - 兼容版本:0.1.x 线兼容 DSH 0.1.2-rc.1 / 0.1.1-rc.x(stable),自动回退旧快照跳转逻辑。
- 依赖:
dsh-better-sidebar为可选,版本要求>=0.17.0。 - 权限:仅读取会话日志,不调用 LLM,不修改核心数据。
卸载¶
npx @deepseek-ai/dsh plugin --profile desktop remove dsh-turn-outline
该插件将长会话转化为可导航的轨迹,帮助开发者快速定位上下文,且完全零依赖、零侵入。
GitHub 仓库