dsh-memwiki

多个 AI 共用的记忆 wiki：一个 Obsidian 兼容的 Markdown 文件夹 + 一个 MCP 服务。DeepSeek Harness（DSH）、Claude Code、Codex、Cursor 都通过同一个 MCP 读写；人用 Obsidian / VS Code 直接看。

设计契约见 docs/DESIGN.md。

安装

npm install -g dsh-memwiki
# 或在项目里本地安装后用 npx / node node_modules/dsh-memwiki/lib/cli.js

初始化库：

dsh-memwiki init ~/memwiki

Related MCP server: Brainstem

接入客户端

所有客户端最终都是：用 Node 启动本包的 lib/cli.js serve，并设置 MEMWIKI_AGENT / MEMWIKI_DIR。

推荐先打印配置（不写入）：

dsh-memwiki setup claude   # 或 codex / cursor / dsh
dsh-memwiki setup claude --write   # 合并写入，原文件备份为 .bak

可选 skill（写入习惯）：

dsh-memwiki install-skill
# 或 --target claude --target cursor

配置项

库目录优先级：--dir > MEMWIKI_DIR > ~/.dsh/dsh-memwiki.json 的 dir > ~/memwiki。自动推送：命令行 > 环境变量 > DSH 设置文件的 autoPush > 库设置 > 默认关闭；其他设置仍是命令行 > 环境变量 > 库设置 > 默认值。

memwiki.json 示例：

{ "schemaVersion": 1, "name": "我的记忆库", "created": "2026-10-14", "settings": { "staleDays": 90, "contextBudget": 4096, "autoPush": false } }

MCP 工具

Prompt：memwiki-curate（内容收敛、核实、归档及反馈/使用信号汇总，只汇报不改代码）。规则正文唯一来源是库内 _guide；skill 与服务说明只保留摘要。

命令行

dsh-memwiki init [dir]
dsh-memwiki serve
dsh-memwiki context [--project <名>]
dsh-memwiki search <query>
dsh-memwiki read <page>
dsh-memwiki lint [--fix]
dsh-memwiki merge <from>... --into <page> --rev <rev> --reason <说明> [--body-file <md>] [--meta-file <json>]
dsh-memwiki verify <page> [--note <说明>]
dsh-memwiki usage [--days 7]
dsh-memwiki feedback list [--all]
dsh-memwiki reindex
dsh-memwiki sync
dsh-memwiki setup <claude|codex|cursor|dsh> [--write]
dsh-memwiki install-skill [--target ...]

sync：先 git pull --rebase --autostash 再 push；冲突时中止变基并列出文件，退出码非 0。

库的格式

标准 Markdown + YAML 页头 + [[双链]]，状态只有 active / stale。页间引用使用双链；[文字](相对路径.md) 会被 lint 报 markdown_link，fix: true 按当前页目录将其转成双链，随后才参与反链、断链与 move/merge 改写。请先修复再移动或合并。MCP 的 meta 只接受对象，tags/aliases 使用字符串数组，append 正文用 text。目录约定见 docs/DESIGN.md §2–§3。生成文件 index.md、log.md 勿手改。

常见问题

CONFLICT：别人或另一个进程改过页面。重新 memwiki_read 拿最新 rev 再写。

SIMILAR_EXISTS：先读最多 3 个相似候选，优先更新已有页；确实不同主题才 force: true，reason 必须说明理由并原样记日志。inbox 不拦截。

内容维护：一个事实一个归属，纠正优先于补充。merge 的正文由调用方整理；删除源内容前确认已在目标页，源文件直接删除，源标题和别名并入目标 aliases，原文在 git 历史中。fact_repeat 仅为低级别提示，链接引用 IP 不必删。

反馈与统计：反馈在 meta/feedback/YYYY-MM.md（type=meta）；context 只提示 open 条数。使用信号在 git 忽略的 .memwiki/usage.jsonl，超过 1 MB 轮转一份旧文件；仅记录零结果搜索、版本冲突、密钥拦截、编辑找不到/不唯一、相似拦截和成功强制新建；不统计正常搜索、阅读或其他成功写入。计数为空会提示“这段时间没有发生这些事件”。事件中只保留脱敏查询及哈希页面标识，不记录正文、写入理由或凭据值。

SECRET_DETECTED：正文或页头命中密钥规则，不会写入。确需保存低风险凭据时用 memwiki_secret_set，页面写 secret:<名字> 引用。

多机同步：同一 git 远程下，开 autoPush 或定期 dsh-memwiki sync。冲突需人工处理列出的文件。

外部编辑：在 Obsidian 里改文件会被监视；约 60 秒后统一提交 [external] …。

DSH 找不到 cli.js：用 dsh-memwiki setup dsh 打印带绝对路径的条目，合并进 $DSH_HOME/cordis.patch.yml，并确认 MEMWIKI_DIR。

本机凭据库

密码和 token 不能写进 wiki 页面（会进入 git 历史、目录和检索）。仅本地开发、测试账号、内网设备等低风险凭据可存入独立凭据库；银行、邮箱、主账号、生产环境密码不要存。页面只写 secret:netx-local-admin。

默认文件 ~/.memwiki/secrets.json，可用 MEMWIKI_SECRETS_FILE 或 --secrets-file 覆盖；文件必须在 wiki 目录之外，不进 git、不同步。默认访问日志为同目录的 secrets-access.log，只记录时间、agent、动作、名字和用途，不含值。

Windows 用 DPAPI CurrentUser 加密，绑定当前 Windows 用户；换用户或机器不能解密，DPAPI 不可用时直接失败，不退回明文。其他平台第一版明文存储，靠文件 0600 / 父目录 0700 权限保护。列表不会返回值。

dsh-memwiki secret set netx-local-admin --scope "仅用于 localhost 的 netx 开发实例"
dsh-memwiki secret list
dsh-memwiki secret get netx-local-admin --purpose "登录 localhost 开发实例"
dsh-memwiki secret rm netx-local-admin
dsh-memwiki secret log --limit 20

set 交互输入不回显；管道输入只读 stdin 第一行，密码不能放在命令行参数中。get 是明确请求取值的命令，会向 stdout 输出值，请留意接收端。MCP 的 memwiki_secret_list/get/set/delete 共用同一凭据库；get 必须给 purpose，只按 scope 使用，不回显给用户、不写进任何文件或页面。set 只在用户明确要求记住密码时使用。

DSH 设置页

安装插件后打开“设置 → 记忆库”，可保存库目录和自动推送开关，查看库状态、最近 5 条变更和只读体检；凭据区支持新增、更新、删除和访问日志。凭据默认不显示，点击“显示”后显示 10 秒，查看会记入访问日志；同一时间只显示一条，切换设置页或窗口失焦时立即隐藏。显示期间可复制，30 秒后若剪贴板仍为该值且可读取则尝试清空。配置落盘到 ~/.dsh/dsh-memwiki.json，保存后重启 DSH 生效；环境变量优先时卡片会提示实际目录。

cordis.patch.yml 同时挂载 MCP 客户端与独立的 lib/dsh-host.js 插件；公共 API 仍为 lib/index.js。浏览器端 dsh.client / ./client 加载 lib/client.js，遵循 Desktop 0.2 的 settings.section、slots + locale 模式。构建保留 tsc，并通过 Bun 打包这两个插件入口（npm run build 需要 Bun）。