dsh-memory-panel

DSH 记忆面板 · dsh-memory-panel

当前版本 Current version：0.1.1（见 package.json）

DSH 记忆面板：为 DeepSeek Harness（dsh）提供跨会话持久记忆的插件——记忆以纯 JSON 存于本机 ~/.dsh/memory.json，数据不出本机；Web 侧边栏可视化「代理记住了你什么」。

核心特性：

• 记忆工具齐备：memory_save 保存 · memory_recall 关键词召回 · memory_list 分类列表 · memory_delete 删除单条 · memory_clear 一键清空（需显式确认）
• 侧边栏可视化：Web 端侧边栏「Memory」按钮打开记忆面板，界面双语（中/英）跟随 dsh 界面语言
• 写入安全：原子写入（临时文件 + 重命名）与并发序列化排队；损坏的 memory.json 自动备份为 memory.json.corrupt-<ts> 后继续，不丢数据
• 容量可控：单条上限 4000 字、总量 500 条（最旧自动淘汰）、召回结果最多 30 条
• 数据不出本机：全部记忆以纯 JSON 存于 ~/.dsh/memory.json，不联网、不上传

Long-term memory for DeepSeek Harness (dsh): durable, cross-session memory tools plus a sidebar panel that shows what the agent remembers about you.

English | 中文

What it does

• memory_save — store a memory (creates or updates by key)
• memory_recall — search memories by keyword or category
• memory_list — list all memories, optionally filtered by category
• memory_delete — delete one memory by its exact key
• memory_clear — delete ALL memories (requires confirm: true)
• Sidebar memory panel — a "Memory" button in the web sidebar opens a panel visualizing the memory store (bilingual, follows the UI language)

Memories live in ~/.dsh/memory.json — plain JSON on your machine, nothing leaves it.

Features

• Atomic writes: write-to-temp + rename, readers never see a torn file
• Write serialization: concurrent memory_save calls queue instead of clobbering each other
• Corruption recovery: a broken memory.json is backed up to memory.json.corrupt-<ts> before continuing fresh — no silent data loss
• Growth control: content capped at 4000 chars, store capped at 500 entries (oldest evicted), recall results capped at 30
• Optional filter: memory_list works with or without category_filter
• Delete & clear: memory_delete removes one memory; memory_clear empties the whole store after an explicit confirm: true
• Bilingual UI: the panel follows the UI language (zh / en) via the dsh locale service
• Tunnel-aware UI: the panel warns when accessed through a tunnel where the browser-trust fence blocks /api/*

Install

# web profile (interactive GUI)
dsh plugin --profile web add dsh-memory-panel

# headless profile (one-shot runs) — same bundle, separate install
dsh plugin --profile headless add dsh-memory-panel

Install from GitHub directly (no npm needed):

dsh plugin --profile web add github:x2it/dsh-memory-panel

Restart dsh web after installing, then open the sidebar "记忆" button.

Verify

dsh --profile web --dump-config | grep memory-panel

The agent should now list memory_save / memory_recall / memory_list among its tools.

How it works

agent tools (memory_save/recall/list)
        │  ctx.tools.register
        ▼
  host plugin (lib/index.js)
        │  GET /api/memory  (ctx.webServer)
        ▼
  client panel (lib/client.js, sidebar.footer.action slot)

One plugin row (memory-panel) carries both halves: the host loader imports main, the web client loads ./client.

Development

npm install
npm run typecheck   # tsc --noEmit
npm run build       # esbuild → lib/index.js + lib/client.js
npm pack            # tarball

Install the local tarball to test before publishing:

npm pack
dsh plugin --profile web add ./dsh-memory-panel-0.1.1.tgz

Layout

src/index.ts          # host half: memory tools + /api/memory endpoint
src/client/index.tsx  # client half: sidebar memory panel
lib/                  # built artifacts (generated by build.mjs)
cordis.patch.yml      # bundle patch (dsh.bundle.patch)

Security

The /api/memory endpoint has no authentication — bind dsh web to localhost or a trusted network. The plugin stores memory content in plaintext at ~/.dsh/memory.json; do not save secrets you would not write to a local file.

License

MIT © 2026 知行工作室 · https://w3b.pub/ · support@w3b.pub