前言¶
DeepSeek Harness（DSH）把对话、工作区、插件和定时任务放在同一套客户端里。默认布局里，折叠会话列表后，Home、插件入口和定时任务往往不够显眼；跨工作区的重要会话也缺少统一的置顶视图。若你同时依赖右侧文件面板查看生成物，在对话旁直接预览视频会比反复切换更省事。
下面介绍社区插件 DeepSeek Dock（captainyufei/dsh-dock）：在不改宿主应用的前提下，通过 Cordis patch 注入客户端 UI，提供可定制的左侧 Dock、跨工作区置顶、Home 草稿优先，以及右侧面板内的视频预览。
这是什么¶
DeepSeek Dock 由维护者 captainyufei 发布，npm 包名为 @captainyufei/dsh-dock，当前资料中的版本为 0.1.1。README 将其定位为：面向 DeepSeek Harness 的 Codex 风格界面，附带持久、可定制的左侧 Dock、跨工作区置顶会话、草稿优先的 Home，以及侧栏视频预览。
插件分类为客户端；目标环境为 macOS / Harness 0.2.1-rc.5。安装后独立启用，保留 DeepSeek 品牌与宿主原生工具，不替换任务执行引擎——文件、终端、浏览器、工具标签与定时任务仍由 Harness 提供，插件主要改变导航与 surrounding UI。
核心功能¶
资料中列出的五项能力如下。
持久、可定制的左侧 Dock¶
折叠聊天列表后，仍可通过 Dock 在 Home、定时任务、插件等入口间切换。右键 Dock 可选择已注册的条目，拖拽图标调整顺序；Home 固定为第一项，直接展示最多六项，其余在 More 下。偏好保存在本地。
Codex 风格统一窗格¶
Home、会话、插件、定时任务共用同一窗口框架与可拖拽顶栏。页面切换时导航与工具控件保持一致，并保留宿主会话层级与 DeepSeek 品牌。
跨工作区置顶¶
不同工作区的重要会话可集中到 Dock 区域的置顶区，每条只出现一次。取消置顶后会话回到原分组，不改变工作区归属。
Home 草稿优先¶
在 Home 选定工作区、模式、模型与权限后再撰写内容；只有发送时才创建会话，未发送的草稿不会在侧栏留下空会话。草稿文本与选项在页面跳转和刷新后仍可保留；刷新后附件需重新选择。
右侧面板视频预览¶
原生文件标签支持 MP4、M4V、MOV、WebM 的播放、 seek、音量与全屏（受编解码限制）。对话在左、视频在右，便于对照检查。右上角按钮可恢复已有工具标签；同一标签生命周期内重新打开且文件版本未变时，可恢复播放位置且不自动播放。
安装与启用¶
Requires macOS / Harness 0.2.1-rc.5。若曾安装旧插件 @local/chatgpt-rail，需先禁用（迁移说明见仓库 docs/MIGRATION.md）。本包未发布到 npm，安装的是仓库 main 最新代码，不会自动更新。
在 Harness 图形界面安装¶
打开 Plugins → Add plugin，在 Package name or address 中粘贴：
https://github.com/captainyufei/dsh-dock
点击 Install，出现 Installed 后点 Enable now；若直接关闭对话框，插件会保持关闭。在 Installed plugins 中确认 DeepSeek Dock 已开启。折叠会话列表后，左侧应出现 Home、定时任务、插件等 Dock 项；右键 Dock 可定制条目。
使用 dsh CLI（web profile）¶
针对 web profile 可执行：
dsh plugin --profile web add https://github.com/captainyufei/dsh-dock
若 dsh web 未运行需先启动，再在 Plugins 中确认 DeepSeek Dock 已启用。桌面用户应优先使用上述图形安装方式。
更新与移除¶
要拉取当前 main 代码：保存工作后 Plugins → DeepSeek Dock → Uninstall，再使用相同 URL 或 CLI 命令重装并启用，按提示 reload/restart，在插件详情中核对来源与版本。临时关闭可关开关；卸载且不重装则完全移除。上述操作不删除宿主管理的会话与工作区。
也可从 main 分支 ZIP 解压到本地目录，在 Add plugin 中填写含 package.json 与 cordis.patch.yml 的根目录绝对路径（勿填 ZIP 本身）。
典型用法¶
定制 Dock¶
右键 Dock 勾选常用入口，拖拽排序。Home 始终首位。
草稿与输入¶
Enter 发送，Shift+Enter 换行；IME 组词确认不会误发。+ 选本地文件，@ 引用路径或已加载会话，麦克风走宿主语音组件；附件仅在发送时交给宿主。发送失败会保留草稿。
会话菜单¶
右键会话可使用宿主提供的置顶、重命名、fork、归档/取消归档、复制 Session ID；Shift+F10 与菜单键可用。
恢复工具与看视频¶
在右侧文件面板打开支持格式的视频，用顶栏按钮恢复该会话已有的工具标签页，继续对照对话审阅。
适用场景与注意¶
适合谁： 长期在 macOS 上使用 Harness 0.2.1-rc.5、希望固定左侧导航、跨工作区盯重要会话、在 Home 先写再发、或在对话旁预览生成视频的用户。
权限与安全： DSH 插件在当前 dsh 进程权限下运行。安装前应阅读 GitHub 仓库 源码与 LICENSE，确认第三方声明（THIRD_PARTY_NOTICES.md）。社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系。
兼容与限制： README 明确目标为 macOS 与指定 Harness 版本；package.json 中 dsh.client.platform 为 web，CLI 安装命令针对 web profile。折叠抽屉、切换标签或关闭预览会暂停播放并释放临时媒体资源。
安装问题（包找不到、GitHub 下载失败、已装但无 Dock 等）可按 README 故障表排查，或到 Issues 反馈 Harness/macOS 版本与安装来源（日志中勿含私有路径或 token）。
结尾¶
DeepSeek Dock 把 Codex 式统一布局、可定制 Dock、跨工作区置顶、Home 草稿与侧栏视频预览集中到同一客户端插件，安装方式以仓库 URL 为准，适合在指定 Harness 版本上强化日常导航与审阅流程。
- 目录页：https://www.skillhub.cn/plugins/captainyufei/dsh-dock
- GitHub：https://github.com/captainyufei/dsh-dock
