前言¶

在 DSH 裏做產品或需求側協作時，常見做法是把設計稿或文檔當作主入口，再讓智能體對着截圖或說明去猜頁面結構。真實前端往往早已在倉庫裏用 Vue Router 定好了路由和組件路徑，若工作臺不能直接從這份代碼讀取頁面清單，列表和引用就容易和實現脫節。

dsh-knj-reqwork（社區目錄名與包名一致）是維護者 yangdongzhen590 發佈的 DSH 工作流類插件。它把本地前端代碼庫當作真相源：掃描配置的 Vue Router 入口，在 DSH Web 工作區裏列出路由頁面，並提供穩定的 @page:<path> 引用與源碼檢視。README 明確說明：它不是 Figma 替代品，M0 階段只讀、無持久化，不涉及矢量編輯、多人協作或雲端設計文件。

這是什麼¶

• 定位：面向 DeepSeek Harness 的私有 PM「需求工坊」工作臺插件（包名 dsh-knj-reqwork）。
• 維護者：yangdongzhen590；許可證 MIT（© 2026 yangdongzhen）。
• 解決的問題：在 DSH Web 側快速對齊「倉庫裏真實有哪些路由頁」，選中頁後可在對話上下文中使用穩定 PageRef，並查看路由、組件源碼與佈局相關元數據。

社區目錄簡介將其歸爲工作流，並概括爲需求導入、拆解與跟蹤方向；當前已發佈的 M0 能力以 README 爲準：路由頁列表、固定或可配置的 projectRoot 掃描、側邊欄「需求工坊」面板與 GET /dsh-knj-reqwork/pages 只讀接口。

核心功能（M0：當前可用）¶

M0 刻意保持只讀、無持久化，主要包括：

1. Vue Router 頁面列表
   在 projectRoot 下查找 src/router/index.js、src/router/index.ts、src/router.js、src/router.ts 等候選文件，解析路由 path、name、動態 import 的 .vue 組件及 home-child 佈局約定。

2. 固定或可配置的項目根
   默認讀取 D:\workspace\knsearch-test\knsearch_web；宿主配置可提供 projectRoot 指向其他本地前端根目錄。

3. 穩定 PageRef
   選中頁面後暴露 @page:<path>，例如 @page:/home，用於在 DSH 對話中引用路由而非單獨的設計文檔 ID。

4. 源碼檢視（Source inspector）
   展示所選路由、組件源碼及可用佈局元數據。

5. 宿主 API
   通過 DSH webServer 註冊只讀端點 GET /dsh-knj-reqwork/pages；成功時返回 { ok, root, pages }，錯誤場景使用 404/405/500。掃描器拒絕 projectRoot 外的路徑。

6. Web 客戶端面板
   向 knj.menu.item 插槽注入「需求工坊」菜單項，在主工作區掛載面板；dispose 時可逆地移除菜單、DOM、樣式、觀察者與監聽。客戶端入口導出爲 dsh-knj-reqwork/client。

宿主側導出 scanVueRouter、mountReqworkRoutes、BASE、PAGES_PATH、DEFAULT_PROJECT_ROOT 等符號，供集成與測試使用。

路線圖（尚未在 M0 交付）包括 M1 畫布節點與圖層、M2 佈局對比與快照、M3 後續工作流能力，仍約束在「私有、代碼即真相」模型內。

安裝與啓用¶

插件需先在本機構建並打包，再裝入 DSH web profile。官方 README 要求 Node.js 20 及以上；在 PowerShell 中應使用 npm.cmd，避免 PowerShell 的 npm shim。倉庫 .npmrc 啓用 legacy-peer-deps，以適配釘死的 DSH 預發佈 peer 依賴。

package.json 聲明引擎：node >= 20，dsh >= 0.1.1-rc.2；peer 依賴 @deepseek-ai/cordis（^4.0.1，可選）。

1、構建與校驗並打包：

npm.cmd run check
npm.cmd test
npm.cmd pack

pack 會生成用於安裝的 .tgz；README 舉例 M0 產物名爲 dsh-knj-reqwork-2026.9.5.tgz，實際文件名中的 <ver> 以 package.json 的 version 字段爲準（資料中該字段爲 2026.11.12）。

2、安裝到 DSH web profile：

dsh plugin --profile web add ./dsh-knj-reqwork-<ver>.tgz

3、按宿主環境重啓或重載 DSH Web，在菜單中打開「需求工坊」。

開發者在倉庫內完整驗證流程可參考：

npm.cmd install
npm.cmd run typecheck
npm.cmd run build
npm.cmd run check
npm.cmd test
npm.cmd pack

典型用法¶

經過上面的步驟安裝並重載宿主後，在 DSH Web 客戶端點擊「需求工坊」，面板會向同源地址請求頁面列表（可中止的請求，並對重複 apply/dispose 做防禦性處理）。

1、確認掃描根目錄：若本地前端不在默認路徑，通過宿主配置設置 projectRoot，使掃描器只讀該目錄下的 Router 候選文件。

2、在列表中選擇目標路由頁；工作臺暴露 @page:<path>，可在與智能體的對話裏引用該標識。

3、使用源碼檢視區查看對應路由、.vue 組件源碼及佈局元數據，以代碼爲準對齊需求描述（M0 不寫入倉庫、不建庫、不寫緩存文件）。

也可直接調用只讀 HTTP 接口做集成或調試（僅支持同主機的 GET）：

GET /dsh-knj-reqwork/pages

適用場景與注意¶

適合誰

• 已在 DSH Web 上工作、且前端爲 Vue Router 結構的項目團隊或 PM，需要在對話裏用 @page: 對齊真實路由而非維護平行設計稿。
• 希望快速列出倉庫內可發現的路由頁並檢視組件源碼的開發者。

務必注意

• 插件以當前 DSH 進程權限讀取本地文件；安裝前應閱讀源碼與 MIT 許可證，並確認 projectRoot 指向的預期目錄。
• M0 無遠程協作面：無上傳、權限管理、評論審批、雲組件庫；無持久化狀態。
• 社區插件目錄（SkillHub）爲獨立生態站點，與 DeepSeek / 幻方無官方從屬關係；星標等目錄元數據以站點展示爲準（資料中 GitHub 星標爲 0）。

結尾¶

dsh-knj-reqwork 把 Vue Router 掃描、穩定頁引用和源碼檢視接到 DSH Web「需求工坊」裏，適合以代碼爲真相源做需求對齊；更遠期的畫布與規格產出見 README 路線圖。查閱說明與源碼可訪問社區目錄頁與 GitHub 倉庫：

• 目錄頁：https://www.skillhub.cn/plugins/yangdongzhen590/dsh-knj-reqwork
• GitHub：https://github.com/yangdongzhen590/dsh-knj-reqwork