前言¶

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