前言¶

DSH 的理念是把能力做成插件：host 側可以註冊模型工具，client 側可以掛 UI，REST 路由也能按 profile 組合。對 Godot 項目來說，資產文件、目標、標籤和完成狀態如果分散在不同記錄裏，模型與界面就缺少統一入口。godot-asset-planner 把 Godot 資產與項目目標放到同一套 DSH 插件裏，提供 godot_* 工具、/gap REST 表面和 better-sidebar UI。

這是什麼¶

godot-asset-planner 是 DeepSeek Harness（DSH）的 Godot 資產與項目目標統一管理插件。維護者是 LINinLIN-0079，許可證爲 MIT。它解決的問題是：在 DSH 會話和 Web 界面中統一註冊資產、創建目標、查詢資產、生成狀態報告，並把資產、目標、標籤、關聯和報告按項目隔離。數據通過 DSH storage 服務持久化到本地 JSON 文件。

核心能力¶

• godot_* 模型工具：用於註冊資產、創建目標、查詢資產和生成狀態報告。
• /gap REST 表面：用於狀態查詢和項目操作。
• better-sidebar UI：包括資產管理器、場景樹查看器和 Git 面板。
• 項目隔離：資產、目標、標籤、關聯和報告均按項目隔離。
• 資產維護：支持資產標籤、資產與目標關聯、完成狀態、更新和刪除資產。
• Godot 導入：支持掃描 Godot 項目目錄並批量導入項目資源爲資產。
• 場景樹：支持 Godot 場景樹即時讀取與編輯。
• Git 面板：支持 Git 版本控制界面，包括狀態、提交、分支和差異。

安裝與啓用¶

1、執行安裝命令：

dsh plugin --profile web add godot-asset-planner

2、安裝後重啓 dsh web / 桌面應用後生效。

如果通過 profile 補丁啓用，在 profile 的 cordis.patch.yml 追加 insert 塊：

- insert:
  - id: godot-asset-planner
    name: godot-asset-planner

也可以一次性加載補丁清單 ./my-plugins/cordis.yml。注意 --patch 必須放在 --host / --port 等應用參數之前。

驗證補丁組合：

--profile web --dump-config --patch ./my-plugins/cordis.yml

--dump-config 會重寫 profile 根文件 cordis.yml，需要對該目錄有寫權限。

典型用法¶

工具調用時可以傳入可選 project_id，缺省爲 default。可以先查詢項目 id：

godot_list_projects

隨後在註冊、創建、查詢等 godot_* 工具中傳入對應 project_id。

REST 視圖可以使用：

GET /gap/state?project=<id>

在 UI 側，可以使用 better-sidebar 中的資產管理器、場景樹查看器和 Git 面板；場景樹查看器用於 Godot 場景樹即時讀取與編輯，Git 面板用於查看狀態、提交、分支和差異。

適用場景與注意¶

適合在 DSH 中處理 Godot 項目資產與目標的開發者。它能把模型工具、REST 查詢和界面操作落到同一份插件數據面上。

需要注意：

• REST 路由通過 ctx.inject(['webServer'], ...) 註冊，依賴 webServer 就緒；headless 等無 web 的 profile 自動退化爲純工具插件。
• 刪除項目會連同該項目的資產與目標一併刪除且不可恢復；default 項目不可刪除。
• 包聲明 peerDependencies 爲 @deepseek-ai/cordis ^4.0.1。
• 插件運行時零依賴，使用 Node ^22.19 || >=24 的類型剝離直接加載 .ts 源文件。
• 存儲單元名可通過 cordis.yml 的 config.unitName 指定，須匹配 ^[a-z][a-z0-9_]*$。
• 插件以當前 dsh 進程權限運行；安裝前應檢查源碼與 MIT 許可證。

鏈接¶

DSH 社區目錄是獨立站點，不等同於官方應用商店，也與 DeepSeek / 幻方無官方從屬關係。本次已覈實資料未給出目錄頁 URL；倉庫地址爲：

https://github.com/LINinLIN-0079/godot-asset-planner-public