dsh-plugins

Plugins for DeepSeek Harness. One directory per plugin; each is a self-contained package with its own package.json.

The directory name and the package name differ for the search plugin: the directory kept -serper from when Serper was the only backend, the package did not. What the harness resolves is always the package name.

Install

You need a harness first — these are plugins for one, not programs:

npm install -g @deepseek-ai/dsh
dsh --version                  # verified against 0.1.1-rc.2

Then add the plugins to the profile's package.json and let the harness mount them:

{
  "dependencies": {
    "@ai4gensteam/dsh-agents-swarm": "^0.3.2",
    "@ai4gensteam/dsh-web-search": "^0.3.2"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "@ai4gensteam/dsh-agents-swarm",
        "@ai4gensteam/dsh-web-search"
      ]
    }
  }
}

cd ~/.dsh/profiles/web && npm install
dsh web --no-open        # then open http://127.0.0.1:3080

Bundle order is load order: a patch only sees what was applied before it, so a bundle placed ahead of the one it customises gets overwritten by it.

Node 24 or newer — dsh-agents-swarm uses node:sqlite unguarded.

Each plugin's own README covers its settings and the keys it needs. Nothing works without them, and none of them are in this repository.

Develop against a checkout

git clone https://github.com/genesis-agents/dsh-plugins
cd dsh-plugins && ./deploy/setup.sh

setup.sh links every plugin into ~/.dsh/profiles/web and installs their dependencies. It is idempotent, safe to re-run after a pull, and it merges — plugins in your profile that this repo does not own are left alone.

One argument, the only genuinely per-machine choice, is where the source library lives:

./deploy/setup.sh                                # this machine owns it
./deploy/setup.sh https://box.tailnet.ts.net     # proxy to the machine that does
./deploy/setup.sh /srv/data/swarm-sources.sqlite # own one at a chosen path

Then ./deploy/doctor.sh to check the result, and ./deploy/release-check.sh before trusting anything that was published.

Why lib/ is committed

A git install fetches sources, not build output, so a consumer running dsh plugin add github:... would otherwise receive a package that cannot load. The alternative is a self-contained prepare script — see docs/user/develop/basic/publish.md in the harness repository and the turtle-ui example.

Documentation

• Architecture — what runs where, the pipeline, the data, the seams, and a table of failures that do not announce themselves
• 洞察 — a landing plan — the design for the stage between collecting and publishing, and what the comparable systems taught it
• Running it on a Mac mini — a migration that was actually carried out, including the steps whose first draft was wrong
• deploy/ — setup, health check, self-update, release

License

MIT