dsh-cherry-kb

Local knowledge base and memory switch for DeepSeek Harness (dsh web).

Two controls in the composer's trailing tool row (left of the model selector), and two pages under Settings. The host half orchestrates an external knowledge-base toolchain; it re-implements neither indexing nor memory.

---

⚠️ Read this first: external prerequisite

This plugin is not self-contained. It contains no chunking, no FTS, no embedding, no AGENTS.md rendering and no memory logic. Every operation is a spawn of three executables that already exist on your machine:

Executable	Used for
我的知识库/记忆开关	reading and setting the three-position memory mode
我的知识库/idx	status, sources, indexing, search, embedding models, index library
我的知识库/cherry	read-only access to Cherry Studio's own knowledge bases

The knowledge-base root is resolved in this order:

1. DSH_KB_ROOT (environment variable), or an explicit override;
2. otherwise <built lib/>/../../../../我的知识库, then one level further up.

The first candidate that actually contains an idx file wins.

Without that toolchain installed, the plugin still installs and renders, but every route fails with a "cannot find the CLI" error. The package does not ship the toolchain, and there is no public distribution of it.

---

Install

dsh plugin --profile web add @wanghuiym123/dsh-cherry-kb

Point it at your knowledge base if it does not sit four levels above the installed package:

DSH_KB_ROOT=/path/to/我的知识库 dsh web

What it registers

Composer tool row — slot conversation.input.right, both left of the model selector as one cluster of "what this conversation gets to see":

Seat id	Order	Role
kb-chat-kb	90	Which knowledge base this conversation uses
kb-memory	100	Three-position memory switch (always shows the current position)

Settings — slot settings.section:

Section id	Order	Role
my-knowledge-base	50	Source list, native folder picker, one-click reindex with staged progress, index library, per-source memory, embedding-model picker, local model service
cherry-studio-kb	55	Read-only view of Cherry Studio's knowledge bases

Both composer seats share one store, so the button and the settings page cannot disagree about the current position.

Host half — 22 routes under /dsh/kb/*:

status  toggle  update  progress  stop  token
sources  search  select  source-memory
indexes  index-delete  rebuild-vectors  models
model/service  model/list  model/loaded  model/load  model/unload
cherry/list  cherry/search  cherry/select

Routes that write require a token; KbToken.ts issues it to loopback same-origin requests only.

Boundaries

• Cherry Studio's bases are read-only. They belong to another application; the plugin never builds, moves, rewrites or vacuums them. This is enforced by keeping the Cherry family in a separate module (KbCherry.ts) from the workspace family (KbSources.ts).
• Adding a source registers it; it does not index it. Confirming an add writes 我的知识库/03_证据层/来源清单.json and nothing else.
• The plugin never moves the memory switch on its own. It is changed only by a user gesture in the UI.
• The plugin holds no persistent state of its own; every status shown is read live from the CLIs.

Verify

Both checks are offline — no dsh process, no browser, no network:

node scripts/verify-bundle.mjs   # client artifact + host route table
node scripts/verify-host.mjs     # route handlers against stub CLIs

verify-host.mjs runs entirely against bash stubs; it does not exercise the real CLIs or the HTTP adapter layer. Read its closing note before treating a green run as end-to-end coverage.

Build

tsc -b tsconfig.json && tsc -b tsconfig.host.json   # types (client / host)
node <tsdown entry>                                  # lib/client.js + lib/index.js

The two tsconfig files are standalone on purpose: no extends into the dsh checkout and no project references, so tsc -b never writes outside this package.

License

MIT