loci-dsh
loci second-brain plugin for DeepSeek Harness (dsh): search / ask / remember your local knowledge base from the web sidebar
The plugin will be installed here. Keep web if you are unsure.
npx -y @deepseek-ai/dsh plugin --profile web add github:IvenKooLab/loci-dsh#99da1c27b827c761f3e47ccef05bb2e3d197d919
Loci Dsh is published as loci-dsh and currently resolves to version 0.1.1. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.
[!TIP] 🧠 Your loci second brain, living in the DeepSeek Harness (dsh) web UI sidebar.
中文文档：README.zh-CN.md
loci-dsh is a UI-layer plugin for dsh ("everything is a plugin"): it mounts a 🧠 loci memory tab in the web sidebar where you can search, ask questions, jot down memories, and inspect your loci knowledge base — without leaving the conversation.
| Search | Ask |
|---|---|
| search | ask |
| Memories | Status |
| memories | status |
Pure UI layer — no Python embedded, no core fork. The plugin's host half (Node) mounts /loci-dsh/api/* routes on the dsh web server and proxies them to a local loci serve-http instance (REST + Bearer auth). The client half (React) registers the sidebar tab via dsh-better-sidebar and talks to the host half same-origin — so loci never needs CORS.
tag=memory) and path filtersloci's HTTP API answers in plain-text envelopes, so the host half re-derives structure (search blocks, stats, citations, memory timestamps from filenames). Parsers live in src/parse.ts and track loci's de-facto wire format.
Node.js ≥ 24 (dsh's launcher uses import.meta.main; Node 20/22 exit silently)
dsh: npm i -g @deepseek-ai/dsh
The sidebar host: dsh plugin --profile web add dsh-better-sidebar
loci ≥ v0.6.2 with its HTTP server running and a fixed token in loci's config.toml:
[http]
token = "<a random string>"
loci serve-http # defaults to 127.0.0.1:8765; --host/--port or the [http] section override
# from npm (once published)
dsh plugin --profile web add loci-dsh
# or straight from git (lib/ artifacts are committed — no local build needed)
dsh plugin --profile web add github:IvenKooLab/loci-dsh
Then point the plugin at your loci instance. Edit ~/.dsh/profiles/web/cordis.patch.yml and add an id-targeted override row (no insert — the bundle is already mounted by dsh plugin add; a second insert of the same id fails the boot with a duplicate-entry error):
- id: loci-dsh
config:
baseUrl: 'http://127.0.0.1:8765'
token: '<same value as [http] token in loci config.toml>'
dsh patch rows replace config wholesale (no deep merge) — restate every key you care about.
Alternatively use the LOCI_URL / LOCI_TOKEN environment variables before starting dsh web.
Launch dsh web — the 🧠 loci memory tab appears in the bottom workbench sidebar.
| Key | Default | Description |
|---|---|---|
baseUrl | http://127.0.0.1:8765 | loci serve-http address |
token | (empty) | Bearer token, matching loci's [http] token |
timeoutMs | 20000 | Short-request timeout (health/stats/search/remember) |
askTimeoutMs | 180000 | /ask timeout — a full LLM round-trip (~21 s with glm-4.6) |
pnpm install
pnpm build # tsc typecheck + tsdown dual-entry bundle → lib/
pnpm watch # rebuild on change
# mount into a profile as a live link (rebuild + browser hard-refresh to apply)
cd ~/.dsh && dsh plugin --profile web add /absolute/path/to/loci-dsh
src/index.ts — host half: route mounting, loci proxy, error mappingsrc/loci-client.ts — loci HTTP client (fetch + AbortSignal timeouts)src/parse.ts — plain-text → structured parsers (search blocks / stats / citations)src/trust-fence.ts — Host-header loopback fence (same semantics as dsh's /api gateway)src/client/ — client half: tab registration, views, zh/en dictionariesStructured after the dsh-better-sidebar external-plugin guide and dsh-sentinel's standalone build.
pip install loci-rag)