loci-dsh
loci 第二大脑插件，用于 DeepSeek Harness (dsh)：从网页侧边栏搜索 / 询问 / 记住您的本地知识库
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:IvenKooLab/loci-dsh#c219d022914ae03f32ded1ecb88563fce7024b9b
Loci Dsh 以 loci-dsh 发布，当前版本为 0.3.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
[!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 | Graph |
| memories | graph |
Status view: 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 filtersmemories/ directory directly, newest-first) on top of keyword retrieval, plus quick capture (title / text / tags)loci graph build): entity chips with degree badges, SPO relation rows, click an entity to filter its relationsloci'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) |
graphPath | (disabled) | Absolute path to loci's graph.json (default <store>/graph.json) — enables the Graph view |
memoriesPath | (disabled) | Absolute path to loci's memories/ directory — enables the full memory timeline |
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)If loci-dsh saves you time, a ⭐ on the repo helps others find it.