DSH 的 Web profile 提供了基础的文件浏览能力，但在处理 OpenSpec 变更时，通常需要手动切换目录或使用命令行。dsh-openspec 插件直接在会话标题栏集成了一个入口，用于快速访问项目的 openspec/ 目录，实现浏览、预览、编辑和保存的闭环。
这是一个 DeepSeek Harness 客户端插件，由 wx971025 维护。它解决了在 Web 界面中查看、预览和编辑 OpenSpec 变更文件的需求，并且不依赖 openspec CLI 工具本身。
核心功能¶
插件通过以下方式与 DSH Web UI 交互：
- 会话标题栏集成：安装后，在会话标题栏的 Session log 旁会出现 OpenSpec 按钮。
- 自动跟随工作区：面板内容跟随当前会话的工作区（或会话目录），无需手动配置项目路径。
- 目录列表：自动列出
openspec/目录下的全部内容，包括config.yaml、specs/、changes/、archive/等。 - 预览与编辑：
- 遇到 Markdown 文件时提供预览模式。
- 其他文本文件按源码模式显示，均支持编辑。
- 保存确认：保存操作以 Host 写盘确认为准。
- 无侵入操作：插件本身不创建、删除或重命名文件，也不调用 openspec CLI。
安装与启用¶
使用前需确保本机已能运行 dsh，且使用 web profile（即 dsh web 或 dsh --profile web）。
1. 安装插件¶
在终端中执行以下命令将插件添加到 web profile：
dsh plugin --profile web add github:wx971025/dsh-openspec#v0.1.0
2. 验证安装¶
安装完成后，可以通过以下命令确认插件是否生效：
dsh --profile web --dump-config
在输出配置中应能找到 dsh-openspec 相关条目。
典型用法¶
- 启动 Web 服务：
dsh web
浏览器将打开 Harness Web UI（默认地址通常为 `http://127.0.0.1:3080`）。
-
打开一个已经绑定了项目目录的会话。
-
点击会话标题栏上的 OpenSpec 按钮，面板将显示当前项目的
openspec/目录内容。 -
如果当前项目根目录下没有
openspec/文件夹，面板将提示「当前项目没有 OpenSpec」。
注意事项¶
- 源码安装依赖：如果使用源码安装模式（即通过本地绝对路径安装），本地目录必须一直保留。如果删除或移动该目录，插件加载会失败。
- pnpm 10 兼容性：在使用 pnpm 10 时，若安装提示构建脚本被阻塞，需将对应 key 写入 profile 的
pnpm-workspace.yaml的allowBuilds配置中，然后再重新执行安装命令。 - 版本适配：该插件针对 DeepSeek Harness 0.1.0-rc.5 的 Web profile 开发，其他版本需自行核对扩展点是否仍可用。
- 卸载影响：卸载插件后，标题栏按钮和
/openspec-viewer接口将消失，但磁盘上的openspec/文件不会被删除。
总结¶
dsh-openspec 提供了一个轻量级的 Web UI 入口，让 DSH 用户能够在不离开浏览器界面的情况下管理 OpenSpec 变更文件。配合 DSH 的「一切皆插件」理念，它为智能体开发流程中的文档管理提供了更顺滑的体验。
