在 DeepSeek Harness 中进行长对话或调试智能体行为时,对话历史往往堆叠在一起,难以快速定位到具体的提问位置或回顾上下文。现有的视图主要聚焦于内容本身,缺乏类似 Codex 的结构化导航。dsh-codex-side-outline 旨在解决这个问题,通过在聊天列左侧提供可视化的导航轨道,帮助用户在长对话中建立清晰的视觉索引。
这是一个为 DeepSeek Harness 聊天列设计的 Codex 风格侧边大纲插件。它在聊天列左侧展示对话的极简导航条,帮助用户在长对话中快速定位和回顾。该插件由 EnkiduGilgamesh 维护,遵循 MIT 许可证。
核心功能¶
- 极简导航条:左侧显示灰色短线条,每行代表一次对话回合,自上而下堆叠。悬停的回合是最长的,长度向两个方向递减(5 个级别),使导航条读起来像小地图。
- 悬停查看摘要:鼠标悬停在导航条某一行时,会弹出摘要卡片。卡片第一行为用户提问(加粗,带有品牌强调条);后续行仅显示代理的最终回复,自动排除思考过程、思维链和工具调用前的中间叙述。
- 点击跳转:点击导航条上的某一行,聊天视图会自动滚动到该回合的用户提问位置。
- 长对话分页:当对话较长时,导航条会出现 ▲ 和 ▼ 按钮,用于上下滚动导航轨道。
- 智能跟随与隐藏:在轨迹视图下自动隐藏,且会跟随侧边栏的拖拽或折叠动作实时移动。
安装与启用¶
使用默认的 web 配置文件进行安装:
dsh plugin --profile web add github:EnkiduGilgamesh/dsh-codex-side-outline
安装完成后,必须重启 dsh web 进程才能生效。页面刷新无法加载新添加或更新后的插件代码。
典型用法¶
启动 Web 应用后,左侧边缘会出现灰色的导航线条。在一个长对话中,尝试将鼠标悬停在不同行上查看摘要,或点击某一行以快速跳转回该回合的提问位置。
注意事项¶
- 重启要求:由于 Web 应用在启动时才编译客户端包列表,安装或修改插件代码后,必须停止
dsh web进程并重新启动。 - 数据来源:插件通过读取本地
sessions服务获取对话数据,因此需要确保会话数据已正常加载。 - 文件说明:
src/conversation-outline.client.js是对原始进程级动态插件的保留引用副本,用于溯源,该文件不包含在 npm 打包中。
通过这个插件,可以在长对话中建立清晰的视觉索引,大幅提升交互效率。更多细节和源码可参考插件目录或 GitHub 仓库。