前言¶
DSH 的插件机制允许在 Web GUI 上扩展界面能力。长对话里，用户提示词容易被上下文、工具输出和后续消息淹没，想回看“某一次我问了什么”时，手动滚动和搜索都不够直接。
dsh-conversation-minimap 是一个 DSH Web GUI 客户端插件，把每个用户提示词映射为左侧导航轨上的锚点，用来快速定位长对话中的关键输入。
DSH 社区目录是独立插件站点，不代表 DeepSeek / 幻方官方应用商店；安装插件前，仍需要按项目要求确认来源、权限和许可证。
这是什么¶
dsh-conversation-minimap 是 Braidy-Wu 维护的 DSH Web GUI 插件，定位为“提示词级对话迷你地图”。
它解决的问题是：长对话中，用户提示词对应的消息位置不容易找。插件把每个用户提示词映射成一个锚点胶囊，沿左侧导航轨均匀分布并居中显示，提供类似桌面聊天软件里的会话导航轨体验。
核心功能¶
导航与定位¶
- 每个用户提示词对应一个锚点胶囊，沿导航轨均匀分布并居中。
- 悬停锚点时显示完整提示词预览。
- 点击锚点后平滑滚动到对应消息，并高亮 2 秒。
- 蓝色发光高亮跟随当前提示词；窗口尺寸变化后视图回到底部。
视觉表现¶
- 鱼眼放大：锚点条在光标下方按高斯钟形曲线放大，峰值为 44px，并在放大区域内保持放大。
- 顶部和底部边缘渐隐。
- 超出可见区域的锚点淡出，且不超出导航轨边界。
数据与稳定性¶
- 通过官方
ctx.sessions与conversation.loadOlder()API 拉取完整历史，使长对话中的提示词都能被导航。 - 纯 vanilla JS 客户端插件，无构建步骤、无依赖。
- 异常被 try/catch 保护；如果插件内部失败，只禁用 minimap，不影响 GUI。
安装与启用¶
插件面向 DSH Web 客户端使用。使用插件名安装：
dsh plugin --profile web add dsh-conversation-minimap
也可以从 GitHub 仓库安装：
dsh plugin --profile web add github:Braidy-Wu/dsh-conversation-minimap
安装后重启 dsh web：
dsh web
典型用法¶
默认安装后即可使用。若需要调整显示条件或锚点尺寸，可在 cordis.patch.yml 中配置以下可选字段：
enabled: true
minPrompts: 4
anchorSize: 3
字段说明如下：
enabled：总开关，设为false时不加载 minimap。minPrompts：会话中至少有多少个用户提示词时显示导航轨，默认4，范围0-100。anchorSize：锚点条高度，单位 px，默认3，范围2-8。
修改 cordis.patch.yml 后需要重启 dsh web：
dsh web
开发或源码检查时，可以运行语法检查：
node --check client.js index.js
适用场景与注意¶
适合在 DSH Web 里处理较长会话，并且经常需要按“我上一句问了什么”快速跳转回对应位置的开发者。它适合希望增加轻量导航、又不想引入复杂前端构建链的场景。
需要注意：
- 插件以当前
dsh进程权限运行；安装前应检查源码、依赖关系和许可证。 - 许可证为 MIT。
- 运行环境要求
node >=22.19.0。 - 配置项均为可选，修改后需重启
dsh web。
结尾¶
dsh-conversation-minimap 的价值在于把长对话里的用户提示词变成一条可视、可点、可定位的导航轨。它的安装成本低，配置可选，失败时也尽量不破坏原有 GUI。
GitHub 仓库：
https://github.com/Braidy-Wu/dsh-conversation-minimap
插件线索中给出的目录页地址（未在本次已抓取资料中确认）：
https://www.skillhub.cn/plugins/Braidy-Wu/dsh-conversation-minimap
