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 的「一切皆插件」理念，它爲智能體開發流程中的文檔管理提供了更順滑的體驗。
