dsh-memory-palace-37315880

给 DeepSeek Harness 用的跨会话记忆插件： 换一个会话，它还记得你是谁、你的项目在哪、哪些坑踩过 —— 不用你再讲一遍。

一句话：每轮注入你真正该知道的东西（画像 / 长期记忆 / 规矩 / 台账）， 本地语义检索把历史翻出来，压缩不丢状态，并且越用越懂你。

它解决什么

• 跨会话零重讲：新会话一开，画像、长期记忆、协作规矩、项目台账已经在那儿了。
• 会话内压缩不丢状态：被压缩掉的是对话，不是进度 —— 进度外置成文件（台账），压缩后照样能读回来。
• 维护看得见：体检、备份、裁决台账、预算、状态核对，都在设置页点得着，输出原样给你看。

它给你什么

每轮注入（不用你操作）

• USER.md（你是谁、你怎么判断）｜MEMORY.md（跨项目的事实与教训）｜SOP.md（协作规矩，可在设置页开关）
• 工作区 AGENTS.md（地图）＋ 各项目 PROJECT_LEDGER.md（台账＝当前状态）＋ 你自己指定的额外注入清单

工具（agent 自己会调）

• memory（分层写入：对话记忆 / 画像 / 长期记忆 / 项目台账）、memory_ingest（文本切块入库）、 memory_search（语义检索）、memory_quiz（抽查考试）、memory_semantic_scan（用当前模型判矛盾）

设置页（设置 → 记忆）

• 嵌入器：本地 Ollama（默认）或云端 API，两种模式都能用
• Vault 索引：重建/同步，并显示"过期没过期"
• 会话转写：把会话日志转成可检索的语料（折叠时自动转，也可手动补）
• 记忆视图：摊成一份给别人眼看的只读副本；可选用 Obsidian 打开（有树状图和关系图）
• 初始化：一键初始化（见下）
• 维护：体检器 8 项 / 裁决台账 / 分层纪律 / 注入预算 / 状态真话核对 / 能力清单点名 / 备份记忆库

命令行（给会话里的 agent，也可自己敲）

• node <插件>/lib/init-cli.mjs …（初始化：检测、建骨架、装 Ollama、拉模型、走云端 API、生成视图）
• node <插件>/lib/maintain-cli.mjs list|where|run <作业id|all>（维护）

安装

前置：Node ≥ 22.6（用到 node:sqlite）｜DeepSeek Harness 0.1.2 及以上（在 0.1.2-rc.1 上实测）

# 1) 拿到 tarball（从 Releases 下载，或自己 npm pack）
# 2) 装进 profile（路径写绝对路径 —— 相对路径会被当成 profile 目录下的路径）
dsh plugin --profile web add /绝对路径/dsh-memory-palace-0.10.0.tgz

# 3) 重启 DSH（这一步只有你能做）

装完打开 设置 → 记忆，页面上应该出现「记忆系统」那一列卡片。

本包还没发到 npm，所以用 tarball 装。 回退/卸载：dsh plugin --profile web remove dsh-memory-palace → 再装回旧版本 tarball → 重启。

第一次用：点一下「一键初始化」

在「初始化」卡上点 【一键初始化（进入新会话）】，它会开一个新会话，并按顺序问你四件事：

选了云端 API 它会先停下：你去设置页填地址/模型/Key，回来说一声它才继续。

之后它读你给的文档、扫历史会话，起草画像/长期记忆/规矩给你确认，再建项目台账与检索库。 每一步都回写状态，所以设置页那 5 行是自己变 ✓ 的。

文件放在哪

全部是你机器上的普通文本文件，随时可以自己打开、改、删。

依赖与第三方

• 嵌入：默认用本地 Ollama（qwen3-embedding:0.6b），不会自动启动 —— 在设置页点【启动】它才起来； 也可以改成云端 API（OpenAI 兼容的 embeddings 接口）。
• 显示层（可选）：Obsidian 只用来"把这堆 .md 看得更舒服"，不是必需品，用任何编辑器都能看。
• 内置：本包内收了一份 dsh-persist（v0.2.5）的本地分叉 （lib/vendor/dsh-persist/），MIT © 2026 ten，许可原文随包附在 lib/vendor/dsh-persist/LICENSE。这样对外只需要装一个插件。

已知限制（先看清楚再装）

• 只在 Windows 上充分实测过（Obsidian 与 Ollama 的路径探测都给了三平台候选，但非 Windows 未实测）。
• 语义检索需要嵌入器可用：Ollama 没启动、又没配云端 API 时，它会退化成关键词模式并在设置页红字说明（不会静默变笨）。
• 「记忆视图」是只读副本，刷新会重写该目录（只清它自己生成的文件）。
• 体检器给的是候选清单，不是判决 —— 要人来裁。
• 初始化会读你的会话日志（默认只扫当前工作区，全量要你点头），第一次跑会花点时间。
• 打码只作用于"转写副本"：会话转写落盘前会把密钥（GitHub / OpenAI / Anthropic / AWS / Slack 的 token、私钥块）换成 ［已打码］， 但DSH 自己的原始会话日志（session.jsonl.zstd）里仍然有 —— 插件不去动它。 所以正确做法还是别把密钥贴进聊天；贴了的话请去服务商那边吊销重发。

许可

Apache License 2.0（见仓库根 LICENSE；版权行 Copyright 2026 373158808qq-cmd）。

简单说：你可以自由使用、修改、再分发，商用也行；条件是保留版权与许可声明、 改过的文件要注明你改过，并且许可里附带了专利授权（贡献者不能拿专利反过来告你）。

包内第三方分叉 lib/vendor/dsh-persist/（v0.2.5）不是 Apache-2.0， 它是上游的 MIT © 2026 ten，按原许可随包分发，原文在 lib/vendor/dsh-persist/LICENSE； 本包 NOTICE 里也做了归属声明。

致谢

• DeepSeek Harness —— 插件跑在它的 Cordis 插件体系上
• dsh-persist —— 分层记忆的搬运工（本包内含其分叉）
• Ollama 与 qwen3-embedding —— 本地嵌入
• Obsidian —— 可选的显示层