Introduction

The philosophy of DSH is to make capabilities into plugins: the host side can register model tools, the client side can mount a UI, and REST routes can be combined based on profiles. For Godot projects, if asset files, goals, tags, and completion statuses are scattered across different records, there is a lack of a unified entry point for models and interfaces. godot-asset-planner places Godot assets and project goals into a single set of DSH plugins, providing godot_* tools, a /gap REST surface, and a better-sidebar UI.

What is this

godot-asset-planner is a unified management plugin for Godot assets and project goals within DeepSeek Harness (DSH). The maintainer is LINinLIN-0079, and the license is MIT. It solves the problem of unifying asset registration, goal creation, asset querying, and status report generation within DSH sessions and the Web interface, while isolating assets, goals, tags, associations, and reports by project. Data is persisted to local JSON files via the DSH storage service.

Core Capabilities

  • godot_* Model Tools: Used for registering assets, creating goals, querying assets, and generating status reports.
  • /gap REST Surface: Used for status queries and project operations.
  • better-sidebar UI: Includes the Asset Manager, Scene Tree Viewer, and Git Panel.
  • Project Isolation: Assets, goals, tags, associations, and reports are isolated by project.
  • Asset Maintenance: Supports asset tagging, associating assets with goals, completion status, updating, and deleting assets.
  • Godot Import: Supports scanning the Godot project directory and batch importing project resources as assets.
  • Scene Tree: Supports real-time reading and editing of the Godot scene tree.
  • Git Panel: Supports Git version control interface, including status, commits, branches, and diffs.

Installation and Activation

  1. Execute the installation command:
dsh plugin --profile web add godot-asset-planner
  1. Restart dsh web / the desktop application for the changes to take effect.

If enabled via a profile patch, append an insert block to the profile’s cordis.patch.yml:

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

You can also load the patch manifest ./my-plugins/cordis.yml at once. Note that --patch must be placed before application parameters like --host / --port.

Verify the patch combination:

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

--dump-config will rewrite the profile root file cordis.yml and requires write permissions for that directory.

Typical Usage

When calling tools, an optional project_id can be passed; the default is default. You can first query the project ID:

godot_list_projects

Then, pass the corresponding project_id in godot_* tools such as registration, creation, and querying.

For the REST view, you can use:

GET /gap/state?project=<id>

On the UI side, you can use the Asset Manager, Scene Tree Viewer, and Git Panel in better-sidebar; the Scene Tree Viewer is for real-time reading and editing of the Godot scene tree, and the Git Panel is for viewing status, commits, branches, and diffs.

Use Cases and Considerations

Suitable for developers handling Godot project assets and goals within DSH. It allows model tools, REST queries, and UI operations to be unified under a single plugin data layer.

Please note:

  • REST routes are registered via ctx.inject(['webServer'], ...) and depend on the readiness of webServer; profiles without a web interface, such as headless, automatically degrade to pure tool plugins.
  • Deleting a project will delete all its assets and goals along with it, and is irreversible; the default project cannot be deleted.
  • The package declares peerDependencies as @deepseek-ai/cordis ^4.0.1.
  • The plugin has zero runtime dependencies and directly loads .ts source files using Node’s type stripping for ^22.19 || >=24.
  • The storage unit name can be specified via config.unitName in cordis.yml and must match ^[a-z][a-z0-9_]*$.
  • The plugin runs with the permissions of the current dsh process; you should check the source code and the MIT license before installing.

Links

The DSH community directory is an independent site and is not equivalent to the official app store, nor does it have any official affiliation with DeepSeek / 幻方. The verified information for this time does not provide a directory page URL; the repository address is:

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