前言¶
在 DeepSeek Harness（DSH）里，工作区、会话、文件管理器和编辑器之间经常需要来回切换。常见操作包括查看工作区绝对路径、在文件管理器中打开目录、用编辑器打开工作区、在长会话中定位某条提问、标记空闲会话，以及在服务状态异常时重启 DSH。
dsh-niao-quick-open 是一个面向 DSH Web 界面的插件，把这些常用操作集中到界面上，减少离开页面后再手工查找目录、编辑器或会话位置的步骤。
这是什么¶
dsh-niao-quick-open 是一个 DSH 客户端插件，包名为 dsh-niao-quick-open，维护者为 dsh-niao，许可证为 MIT。
它主要提供以下能力：
- 工作区一键打开：复制路径、在文件管理器中显示、用常用编辑器打开。
- 编辑器自动发现：宿主端扫描可用编辑器，列出能生成有效打开命令的编辑器。
- 用户消息导航条：在长会话右侧标记用户提问，便于快速定位。
- 会话待办标记：在空闲会话前显示可点击标记。
- 单列表增强：把单列表视图中的会话卡片调整为三行布局。
- 硬性重启：在页面内重启 DSH 服务，并在服务恢复后刷新页面。
核心功能¶
会话区域顶部快捷按钮¶
打开任意工作区会话后，会话区域顶部第一行会显示当前工作区文件夹名，并提供三个图标按钮：
- 复制绝对路径
- 在文件管理器中显示
- 用常用编辑器打开
第二行显示当前会话名称。
工作区菜单快捷操作¶
在每个工作区的 ⋯ 菜单底部，插件会提供一行快捷按钮，用于：
- 复制路径
- 在访达 / 文件管理器中显示
- 用常用编辑器打开工作区文件夹
用户消息导航条¶
在会话右侧，插件会显示一条用户消息导航条。每条用户消息对应一个标记，支持：
- 悬停标记查看提问摘要
- 点击标记跳转到对应提问
- 当前阅读位置高亮
- 底部显示用户消息总数徽标
该导航条在会话用户消息不少于 2 条，且内容超过一屏时出现，并受「界面功能 → 用户消息导航条」开关控制。
会话待办标记¶
空闲会话前会显示一个可点击的待办标记。用户可以将其标记为完成，也可以再次点击取消。
待办标记状态保存在浏览器本地，不占用服务配置。
单列表视图增强¶
开启后，单列表视图中的会话卡片会升级为三行布局：
- 状态图标、工作区名、相对时间
- 会话标题
- 最后一条对话预览
列表头部快捷切换¶
工作区 / 会话列表头部会增加一个「切换分组方式」快捷图标。点击后，可以在工作区分组与单列表之间切换。
界面功能设置面板¶
插件会在 DSH 设置面板中注册「界面功能」页，把配置项按以下区域分组：
- 侧边栏
- 会话区域
- 系统工具
配置项可即时生效。部分需要重启才能生效的修改完成后，页面顶部会显示「重启以生效」横幅。
配置持久化到：
~/.dsh/dsh-niao-quick-open.config.json
编辑器自动发现¶
编辑器由宿主端扫描，包括：
- 已知编辑器品牌
- 系统应用
- 常见编辑器 CLI
插件会列出能够生成有效打开命令的编辑器。列出的编辑器都用于打开当前工作区文件夹。
硬性重启¶
界面左下角设置按钮旁边会新增一个重启图标。点击后进入二次确认流程。
确认后，插件会以当前进程相同的命令拉起一个脱离终端的新实例，等待旧进程退出、端口释放后启动新实例，再退出当前进程。前台页面会显示等待层，服务恢复后自动刷新页面。
安装与启用¶
推荐安装命令：
dsh plugin --profile web add dsh-niao-quick-open
也可以把包加入当前 profile 的 package.json 的 dependencies，以及 dsh.profile.bundles，然后重启 DSH Web：
dsh web
典型用法¶
下面这些操作都可以在 DSH Web 界面中完成：
-
打开任意工作区会话后，在会话区域顶部第一行使用「复制绝对路径」「在文件管理器中显示」或「用常用编辑器打开」。
-
进入 DSH 设置，打开「界面功能」页，按需开关各项功能，并配置「常用编辑器」。
-
在长会话中，将鼠标悬停在会话右侧用户消息导航条上查看提问摘要，点击标记跳转到对应提问。
-
在空闲会话前点击待办标记，标记为完成或取消。
-
需要重启服务时，点击左下角设置按钮右侧的重启图标，经过二次确认后执行硬性重启。
技术信息¶
插件声明为 Web 客户端插件：
platform: web
client inject: @deepseek-ai/dsh-client-runtime
dependency: @deepseek-ai/schemastery ^3.18.1
它通过 DSH 客户端运行时注入界面增强逻辑，并在宿主端完成编辑器扫描、服务重启等操作。
适用场景与注意¶
适合使用 DSH Web 界面的开发者，尤其是经常需要：
- 在 DSH 与文件管理器之间切换目录
- 用编辑器快速打开工作区
- 在长会话中定位历史提问
- 标记空闲会话
- 在页面内重启 DSH 服务
安装前请注意：
- 该插件运行在 DSH 当前进程环境中，具有该进程相应权限。
- 它会向 DSH Web 客户端注入代码，并在宿主端执行扫描、重启等操作。
- 安装前建议检查源码、依赖与 MIT 许可证。
- 硬性重启会重启 DSH 服务，请按需使用。
链接¶
GitHub 仓库：
https://github.com/dsh-niao/dsh-niao-quick-open
