本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-navbar

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @vlln/dsh-navbar

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• client：src/client/index.ts（自渲染 DOM + 官方锚点契约；pin 按钮走官方 conversation.chat.assistant-actions 插槽，React 由 client runtime 提供；访问的 ctx 服务须在插件对象 inject 中声明）
• Node half：src/index.mjs（空 apply，bundle 挂载载体）

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后需要手动开启吗？

不需要。插件被 web profile 加载后自动在对话页生效；安装完重启 web profile 即可。在设置页「插件」面板可以停用或重新启用。

节点条在哪些页面会显示？

仅在 Chat 视图（也兼容挂载的聚焦会话视图 dsh-focus-chat）的对话页；设置页等其他页面以及 user 消息少于 2 条时自动隐藏。

精选消息会跨设备同步吗？

不会。精选状态按会话存到浏览器 localStorage（键名 dsh-navbar:pins:<sessionId>），刷新后保留，但不跨设备、不跨浏览器同步。

节点超过 11 个时会怎样？

自动切到滑动窗口：只显示当前激活附近的 11 个节点（±5），两端用更小的圆点暗示还有更多；当前选中或精选的节点始终强制显示在窗口内。

顶部 ↑ 加载更早历史按钮什么时候出现？

仅当当前会话还有未加载的更早消息时出现（由官方「加载更早」控件的存在判定），全部加载完后自动隐藏；加载过程中按钮禁用并显示「加载中…」。

卸载插件会清除精选数据吗？

不会。数据存在浏览器 localStorage，卸载插件或重启 DSH 不会自动清理；要清理就在浏览器开发者工具里删除 dsh-navbar:pins:* 开头的键。

跳转后为什么有时位置会跳动一下？

插件按官方 follow 0811 之后的「读者输入账本」判定直接一步定位。0811 之前的基线版本（0808/0810）会先用 wheel 事件做兼容兜底，可能与官方流式渲染产生轻微抖动。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.5
• Node: >=22.19.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则