前言¶
在 DeepSeek Harness（DSH）桌面客户端里，会话与全局面板往往来回切换：打开插件面板、回到某个会话、再切到另一路任务。客户端本身不像浏览器那样自带「后退 / 前进」，只能靠手动点选恢复上下文，路径一长就容易丢位置感。
dsh-client-ui-history-nav 是社区维护的客户端插件，在标题栏（或指定座位）提供与浏览器类似的导航控件，并把会话切换与面板打开/关闭记入同一条历史栈。下面介绍它的定位、能力与安装方式；事实以 GitHub 仓库 README 为准。
这是什么¶
- 名称：
dsh-client-ui-history-nav（npm 包名与安装标识一致） - 维护者：Self-Identity
- 分类：客户端插件（
dsh.client注入布局与会话相关 UI 模块） - 一句话：在 DSH 窗口标题栏增加浏览器式后退、前进、刷新；会话与插件面板共用历史，刷新运行中的会话前会确认；界面文案随 DSH 全局语言（中文 / English）
- 许可：MIT；与 DeepSeek 官方无隶属关系
核心功能¶
后退与前进¶
在会话与全局面板之间按访问顺序回退、前进。没有可前进/后退的历史时，对应按钮置灰。
刷新¶
重新加载当前页面的渲染；重载后会按刷新前的状态重新打开面板。若当前选中的会话仍在运行（回复中），刷新前会弹出确认框，可用 Esc、点遮罩或「取消」关闭。刷新会重置面板内部状态与滚动位置，这是预期行为，不是故障。
统一历史栈¶
会话切换、面板打开/关闭按访问顺序记录，最多保留 60 条，持久化在浏览器 localStorage 的键 dsh.history-nav.v1。
自愈与兼容降级¶
会话被归档、或面板所属插件被卸载后，历史回放遇到失效条目会自动移除，避免导航卡死。若客户端升级导致座位或服务方法缺失，插件保持惰性挂载，不破坏外壳；控制台可能出现 [dsh-client-ui-history-nav] 前缀的警告。
界面位置¶
- Windows 桌面：标题栏、Application / Edit 菜单右侧；会话页与面板页位置一致。
- 其他平台：会话标题左侧的座位；全局面板场景主要依赖快捷键（见下节）。
快捷键¶
| 平台 | 后退 | 前进 |
|---|---|---|
| Windows / Linux | Alt+← |
Alt+→ |
| macOS | ⌘[ |
⌘] |
| 纯浏览器 | Ctrl+Alt+← |
Ctrl+Alt+→ |
可在客户端 设置 → 快捷键 中修改绑定。
安装与启用¶
插件以当前 DSH 客户端进程权限运行；安装前建议浏览 GitHub 源码 与 MIT 许可证，确认符合你的安全策略。
- 打开客户端侧边栏 → 插件 → 添加插件。
- 在标识处填写下面版本（或选择本地源码目录）：
dsh-client-ui-history-nav@1.5.0
- 点击 安装 → 立即启用；若提示「改动在下次启动生效」，重启客户端。
- 插件卡片显示 已启用 / 已挂载 后，顶栏应出现后退 / 前进 / 刷新胶囊按钮。
package.json 中声明的引擎要求为 Node >=22.19.0、DSH >=0.2.1-rc.2 <0.3.0；README 写明基于桌面客户端 0.2.1-rc.2 开发，并依赖 uiWorkspace.selection 投影、layout.panelInfo、快捷键注册表与会话标题座位等客户端契约。大版本升级后若行为异常，可先对照 README「兼容性」一节。
典型用法¶
安装启用后无需额外配置文件：
- 在多个会话之间切换，或打开、关闭全局面板，历史栈会按顺序记录（最多 60 条）。
- 使用顶栏胶囊或上表快捷键执行后退、前进；无历史时按钮不可用。
- 需要重载当前视图时点 刷新；若会话正在运行，先确认再执行。
- 若要清空本地历史，可删除
localStorage中的dsh.history-nav.v1（卸载插件不会自动清历史，历史仅存在本地存储）。
适用场景与注意¶
适合：经常在 DSH 里混用会话与插件面板、希望用熟悉浏览器习惯找回上一屏的开发者或日常用户。
注意：
- 历史仅存本机
localStorage，不跨设备同步。 - 刷新会丢弃面板内未持久化的 UI 状态（含滚动位置）。
- 客户端半区架构变更时，插件可能只保留快捷键或完全惰性；属 README 已说明的契约风险。
- 卸载：在 插件 中关闭该组合包（或从 profile 的
dsh.profile.bundles移除）后重启；需要时再手动删除dsh.history-nav.v1。
参考链接¶
- 社区目录页：skillhub.cn/plugins/Self-Identity/dsh-client-ui-history-nav
- 源码与文档：github.com/Self-Identity/dsh-client-ui-history-nav
- npm：dsh-client-ui-history-nav（README 当前标注版本 1.5.0）
DSH 生态强调「一切皆插件」；社区目录为独立站点，并非 DeepSeek / 幻方官方应用商店。若你已在用 DSH 0.2.x 桌面客户端，且会话与面板切换频繁，该插件用最小 UI 面补齐导航缺口，值得按需试用。
