Pular para o conteúdo principal
R

dsh-weknora-memory

rennimars/dsh-weknora-memory

Layered context engine for DeepSeek Harness: per-kb WeKnora retrieval fused by RRF, recency decay and hot/warm/cold tiering, standing profile cards, fact-conflict surfacing, plus the four WeKnora tools (list / search / read / ask) for pull-on-demand retri

Instalar

dsh plugin --profile web add github:rennimars/dsh-weknora-memory

README

dsh-weknora-memory

DeepSeek Harness 的分层上下文引擎。 把本机 WeKnora 知识库变成一份可预算、可审计、可编辑的长期上下文:每一轮只放进去"该进去的那一小段",并且能说清它为什么进去、占了多少字符、什么时候会退场。

A layered context engine for DeepSeek Harness — budgeted injection, recency decay, hot/warm/cold tiering, standing profile cards and fact-conflict surfacing on top of a local WeKnora instance.

它不是"再来一个 RAG 检索器"。检索只是这条管线里的一环,真正决定回答质量的是注入治理:什么能进、进多少、以什么身份进、什么时候该退场。


一、它要解决的四类结构性失效

失效表现本插件的对策
会话失忆换个会话就要重新交代背景,模型对你的偏好、项目约束一无所知每轮自动检索并注入,记忆不依赖模型主动调用
检索噪声反噬top-k 直接塞进上下文,三条无关片段挤走一条真正相关的字符/条数/阈值三重闸 + 冷热配额,席位有限且按价值分配
记忆不可控记忆写死在系统提示词里,改不了、看不见、不知道它今天带了什么侧边面板直读直写,带预算条与命中统计;每轮实际注入内容全程可见
旧材料永久占坑三个月前的会话记录和昨天的结论同权,反复抢占 3 个注入席位时效衰减 + 冷热分层,旧片段需要新的证据才能重新入场

二、三层上下文,三份互不侵占的预算

层内容预算(默认值)打分 / 衰减
常驻层 pinned_constraints行为准则、硬约束12 条 · 1500 字符 · 单条 ≤200 字符永不参与打分、永不衰减
画像层 profilesoul 规则 / user 画像 / agent 工作习惯soul 6 张·300 字 · user 3 张·200 字 · agent 6 张·400 字,单卡 ≤80 字永不打分,按类配额裁剪
检索层 weknora_context本轮检索命中的片段≤2400 字符 · 最多 3 条打分 + 衰减 + 分层共同决定

常驻/画像块整场只投一次(pinnedMode,默认 session):首步贴一份,之后不再重贴——DSH 会把注入消息写进会话历史,后续副本本来就是纯冗余。历史被折叠(压缩)时它也会跟着没了,所以另有两道补投:history 变短或出现 compact 节点时立即补一次;pinnedRefreshTurns(默认 8 轮,0 关闭)按轮兜底补一次。需要旧节奏可切 turn(按用户轮次)或 step(每步)。

三份预算是相加而不是共享的:检索块撑满 2400 字符也不会挤掉常驻准则(lib/config.js:26,31);画像层按类型分账,避免 user 卡把 agent 层吃空(lib/config.js:104-110)。

上限是硬编码契约,不是建议值:timeoutMs 被钳到 4000ms、maxChars 被钳到 2400(lib/config.js:19,26 的 TIMEOUT_CAP_MS / CHARS_CAP),手改配置文件也撑不破。

三、一轮里到底发生了什么

agent/pre-step
 ├── 查询构造      取本轮用户文本;8–500 字符,过短追问拼上一轮(mergeContextQuery)
 ├── 分库并发检索  每个 kb 一次 /knowledge-search,共享同一 deadline
 ├── RRF 融合     k=60,跨库合并,不让单个库垄断席位(mergeKbGroups)
 ├── 来源权重      sourceWeights 正则 × 系数(默认 ^hs- ×0.35,降权但不删除)
 ├── 时效衰减      w = min(1, max(0.35, 2^(-ageDays/30)))      (decay.js)
 ├── 冷热分层      hot ≤14d · warm ≤90d · cold >90d,coldTopK=0
 ├── 阈值闸        minScore 0.1 且 ≥ 本轮最高分的 45%
 ├── 会话去重      本会话已注入过的 chunk 不再重复占用席位
 ├── 邻块扩展      ±1 个相邻 chunk,400ms 子预算,把碎片补成完整段落
 ├── 事实卡        同 subject 多张在效卡 → 块尾追加一行「⚠ 冲突未决」;superseded ×0.3
 └── 渲染          以独立来源消息追加(source.kind = plugin:weknora-inject)

最后一步的细节很重要:注入块是一条独立的 user-role 消息,不是对你的提问的改写,模型能分辨"这是检索来的历史材料"而不是"用户刚说的新任务"。

四、写入侧:这些记忆是谁写进去的

本包只做读(每轮注入)和人工编辑(面板)。把原文、结论、画像写进 WeKnora 与 data/profile.json 的,是宿主侧的定时任务——装上本插件不会自动获得这些任务,它们是同一套体系的另一半,这里把契约写清楚,方便你自己实现或用别的工具替代。

任务触发做什么写到哪里
DSH-Session-Ingest每小时把已结束且空闲 ≥10 分钟的会话转录原样入库,跳过子代理会话;单篇 ≤200,000 字符,最多保留 150 篇;失败重试 3 次,入库后轮询索引 ≤600 秒库① 会话记忆
DSH-Session-Distill每日 04:30从最近会话里抽取结论 / 约束 / 偏好 / 教训,一次最多 3 个会话、3 篇文档,输入 ≤30,000 字符、每轮 ≤1500 字符、每会话 ≤8 条,语义去重阈值 0.66库② 知识
DSH-Memory-Dream每日 03:30夜间做梦:五阶段 S0 收拢 → S1 分组 → S2 裁决 → S3 落账 → S4 报告。裁决同主题事实卡的取代 / 冲突 / 重复,只改 header 里的状态字段,正文逐字保留;单夜 ≤60 次 LLM 调用、≤20 次更新;支持 --dry-run / --no-llm 零成本演练库② 知识(事实卡状态)
profile-writer紧接做梦之后,且只在做梦 rc=0 时data/profile.json 的唯一写入者:新卡一律 proposed,至少等一夜才复核;复核必须同时满足「有来源 / 不重复 / 不冲突 / 正文 ≤60 字」,且同一话题被反复看到至少 3 次(attest ≥ 3,ATTEST_MIN)或人显式 --approve 批准,才转正;否则保持 proposed 并记日志;被插件标了 degrade 的 active 卡转 disputed,下一轮起不再进常驻块常驻层画像
DSH-Memory-Weekly每周体检:跨库重复、失效文档、状态异常三库

三库的分工不是随手划的:

  • 库① 会话记忆存原文,回答"当时到底怎么说的";
  • 库② 知识存结论,一条结论一张事实卡,回答"这件事定了没有、为什么";
  • 库③ 资料存你手工入库的原始文件,回答"这份规范里怎么写的"。

为什么写入侧必须独立于插件: 写要 LLM、要数据库权限、要能被人工审计;而读侧每轮都跑,必须零依赖、可静默失败。两者混在一起,任何一次写入故障都会变成一次会话故障。

为什么画像文件只允许一个写入者: 常驻内容每轮注入、跨会话传播——一旦被污染,后面没有任何一次检索能把它纠正回来。所以插件侧只读,任何新内容只能走 proposed → 隔夜复核(≥3 次证言或人工批准)→ active 这条闸门——一晚的静默本身不是决定。

本包自带的写入侧参考实现(writers/,默认不启用)

上面那张表是它应该长什么样;本包把同一套约定做成了可复制的实现,放在 writers/,随包分发但默认不运行——装上插件不会创建任何计划任务、不会写任何文档。

文件作用
writers/ingest.mjs会话转录 → 库①(幂等:同名文档走 PUT 复用 id)
writers/distill.mjs会话 → 结论 → 库②(含语义去重,LLM 走 WeKnora 会话网关)
writers/dream.mjs事实卡裁决 S0–S4,只改 header 状态;--self-test 可离线跑
writers/profile-writer.mjsdata/profile.json 的唯一写入者;不带 --write 就只打印 diff
writers/register-tasks.ps1幂等注册/更新计划任务(-Unregister 撤销,时间取自配置里的 writers.tasks;默认走隐藏启动器不弹窗,-Visible 才回到控制台窗口)
writers/hidden/run-hidden-cmd.vbs隐藏启动器模板;注册时复制到 <WK_INJECT_HOME>/bin/,任务是 wscript.exe 起它
writers/print-config.mjs打印写侧最终解析出的配置(来源、每段摘要、密钥打码),排障第一步。状态与日志的落点也由这里给出的 writers.stateDir 决定
writers/run-all.cmd手动跑一轮:`run-all.cmd [--dry-run] [ingest

三步启用(不用第二份配置文件:写侧和读侧共用第九节那一个文件):

# 1) 打开读侧那份配置,把 writers.enabled 改成 true,填 writers.kbs 三个库 id 和 sessionsRoot
notepad $env:USERPROFILE\.dsh\wk-inject\wk-inject.config.json

# 2) 看写侧到底解析成了什么(来源、库 id、计划任务时间,密钥自动打码)
node node_modules\@rennimars\dsh-weknora-memory\writers\print-config.mjs

# 3) 注册计划任务(enabled 还是 false 时会拒绝注册,加 -Force 可硬来)
powershell -ExecutionPolicy Bypass -File node_modules\@rennimars\dsh-weknora-memory\writers\register-tasks.ps1

注册出来的任务不会弹窗:动作是 wscript.exe "<WK_INJECT_HOME>\bin\run-hidden-cmd.vbs" "<WK_INJECT_HOME>\bin\<step>.cmd",由那个 .cmd 把 node 的输出追加到 <WK_INJECT_HOME>\logs\<step>.log(5 MB 轮转到 .old)。想看着它跑就加 -Visible,会退回直接起 node.exe。代价要说清楚:wscript 立刻返回,调度器拿不到 node 的退出码,失败只能从日志里的 [hidden] <step> failed 看。

四条纪律:

  • 一份配置管两头:写侧读同一份 wk-inject.config.json 的 writers 段,密钥也共用一项(环境变量 WEKNORA_API_KEY 仍然优先);老的 writers/writer.config.json 还能读,但只在共享配置没有 writers 段时才生效,且里面写的 apiKey 一律忽略。
  • 演练零成本:四个脚本都支持 --dry-run(不写库、不写文件、不写 state);dream.mjs --dry-run --no-llm 连一次 LLM 都不发。
  • 共用一份 HTTP:读侧 lib/retrieve.js 与写入侧全部走 lib/weknora.js,X-API-Key 头与错误词表只有一处实现。
  • 失败可见:退出码 0/1/2/3 有明确语义,失败是一条可读错误而不是异常栈——这与读侧「失败即静默」刻意相反,因为定时任务没有人在看着。

手动侧:四个工具(weknora_*)

注入是"我替你查",工具是"你决定查"。同一份钥匙、同一批知识库,两条路并存:

工具什么时候用拿回来什么
weknora_list_knowledge_bases想知道这台部署能看到哪些库、各自的 id库名 + id + 描述(本次实测 3 个:资料 / 会话记忆 / 知识)
weknora_search要找具体段落、要自己读原文再判断(最快,优先用这个)命中列表(rank / chunk_id / 文档名 / chunk 序号 / score / 截断后的正文)+ 按名命中的文档
weknora_read_document已定位到某篇,要顺着读下去分页片段(page / page_size,按 chunk_index 升序拼好)+ 总块数与 has_more
weknora_ask跨很多文档的综述题,让服务端自己做查询改写 + 重排 + 总结答案 + 引用(文档名 / chunk / knowledge_id)+ 用到的工具链 + WeKnora 会话 id(可追问)

四个工具不是本仓库发明的:REST 客户端、SSE 读取器与工具定义 vendor 自腾讯 WeKnora 官方的 @wxg-prc-cpg/dsh-weknora(MIT),本仓库只做三件事——把它们接到自己的配置键上(lib/mount-tools.js)、在 ctx.inject(["tools"]) 里挂载、以及让"某个工具名字被占用"只损失那一个工具(逐个注册、失败单独记日志,不会四个一起掉)。

几个刻意的选择:

  • 挂载与注入互不牵连:没有 tools 服务的宿主(headless)只是少四个工具,每轮注入照旧;工具配置写错也只丢工具。
  • ask 默认走 RAG,不设 toolAgentId 就绝不走 agent 管线:ReAct 管线成本高一个量级,要它得显式配置。
  • 工具名前缀可改(toolPrefix,默认 weknora),与官方 0.1.0 插件同名——同时装两个会撞名:撞了就只剩本仓库的先注册成功,另一个报重复。要么卸掉 0.1.0,要么把这里改成 mem。
  • 一页一页读:read_document 每次最多 100 段、总字符受 toolMaxChunkChars 约束,逼着模型分页读,而不是一次性把整篇灌进上下文。

五、几个刻意的设计取舍

不改用户原话。 注入永远走追加,避免任何"提示词污染"式的隐蔽改写。

状态不依赖数据库。 WeKnora 的 Postgres 不对宿主暴露端口,且实测 chunks.metadata 4950 行全为 NULL——想往库里写 tier 或命中时间根本无处可写(decay.js 文件头注释)。所以状态落在插件自己的 data/tier-state.json:tmp 写入 + rename 原子替换,上限 4000 条,读-合-写是一个同步序列,同进程两个写者不会交错。

冷启动不误伤。 hotDays 14 / warmDays 90 是"先测量"的值:今天入库的每一块都还年轻,全部算 hot,分层层在真实年龄积累起来之前是一个空操作;唯一立即改变行为的开关是 coldTopK=0,它只挡"又旧又从没命中过"的块(tier.js:38-46)。

禁止双重惩罚。 已经被 sourceWeights 降过权的命中,不再叠加衰减(applyToSourceWeights=false):惩罚只施加一次,日志里写明是哪一种。

失败即静默。 后端挂了、超时、配置写错——全部返回未改动的 decision,这一轮只是不注入。会话不会因为记忆层而失败或卡住(index.js 文件头注释)。

自动写入与人工编辑分权。 data/profile.json 的自动更新属于夜间任务,插件本身只读;面板里的编辑是用户显式动作。这条边界防的是"每轮注入、每轮重算"的自我强化——一个被污染的事实否则会跨会话传播。

六、可观测性

侧边栏「记忆」页签,三个视图:

  • 记忆卡 —— 编辑正文 / 启停 / 新增 / 删除,每条都带预算条(用了多少字符、离上限多远)
  • 记忆统计 —— 每张卡的轮次与命中次数
  • 检索统计 —— 注入率、平均命中数、耗时 p50/p95、每个知识库的贡献占比

面板走同源路由:宿主注册 /api/weknora-memory/state(读)与 /api/weknora-memory/card(写),浏览器用相对路径调用——没有第二个端口、没有 CORS、没有令牌要同步。客户端脚本无构建、无 hooks(slot 渲染是普通函数调用,用模块级 store + class 组件),装完即用。

日志只记元数据:会话 id、耗时、命中数、字符数、结果。不写提问原文,也不写片段正文。

七、依赖

项要求
DSH>= 0.2.1-rc.3(用到 GUI 的 /api Fetch 路由与 sidebar.panellist 槽)
Node>= 20.11
WeKnora一个可访问实例(默认 http://127.0.0.1:8080/api/v1),以及至少一个知识库

八、安装

从插件市场:插件页 → 插件市场 → 搜索 weknora → 安装。

手动(把仓库放进 profile 的 node_modules 再登记为 bundle):

cd "$DSH_HOME/profiles/<你的 profile>"
mkdir -p node_modules/@rennimars
git clone https://github.com/RenniMars/dsh-weknora-memory node_modules/@rennimars/dsh-weknora-memory

然后在同目录 package.json 的 dsh.profile.bundles 里加一行 "@rennimars/dsh-weknora-memory",重启客户端。

装完不会"什么都没发生":第一次启动时插件会自己生成唯一的配置文件——~/.dsh/wk-inject/wk-inject.config.json(Windows 上是 C:\Users\<你>\.dsh\wk-inject\)。它自带中文注释,把每一段是干什么的、留空会怎样都写在里面;支持 //、/* */ 注释和尾随逗号,不用写得像 JSON。

启动日志会有这么三行,意思是"装好了、还没填":

weknora-inject ready (WeKnora http://127.0.0.1:8080/api/v1)
config template created at C:\Users\<你>\.dsh\wk-inject\wk-inject.config.json -- fill in apiUrl / apiKey / kbIds there
not configured yet, injection stays silent: missing apiKey (or WEKNORA_API_KEY) + kbIds -- open <该文件> and fill in those fields, then restart DSH

打开那个文件,只填三样,保存后重启客户端:

缺什么不填的表现填在哪儿
一个可访问的 WeKnora 实例请求发不出去,注入恒为空apiUrl,默认 http://127.0.0.1:8080/api/v1
API key服务端 401(工具调用直接报错)apiKey,或环境变量 WEKNORA_API_KEY
知识库范围没有检索范围,注入恒为空kbIds(不知道 id 就问模型:"用 weknora_list_knowledge_bases 列一下知识库")

填完重启,日志会多一行 backend ok: N knowledge base(s) visible——那就是通了;如果写的是 backend unreachable: …,按提示回去查 apiUrl / apiKey。包本身依旧不带任何配置和凭据(data/、logs/ 也在 .npmignore 里),所以升级换版本不会动你这份文件。写侧的进度状态同理:它跟着这份配置文件走(writers.stateDir,默认同目录的 data/writer-state/),不在包目录里。

九、配置

配置只有一个文件:~/.dsh/wk-inject/wk-inject.config.json(或 WK_INJECT_HOME / DSH_HOME 指向的目录下)。它住在包里之外,所以 npm i @rennimars/dsh-weknora-memory@latest 升级版本不会碰到它;文件里没写的字段全部走默认值,删掉某个字段也不会报错。文件不存在时插件启动会按内置模板(lib/config-template.js)自动生成一份带注释的,不需要手动复制。

查找顺序(第一个存在的文件生效):WK_INJECT_CONFIG 指定的文件 → 宿主传入的路径 → ~/.dsh/wk-inject/wk-inject.config.json → 包目录里的旧位置(向后兼容老安装)。文件里的相对路径(profile.path、decay.statePath、logFile)都相对配置文件所在目录解析,记忆跟着配置走,不跟着包走。

文件长这样(节选,真实模板比这长得多,每节都有注释):

{
  // 总开关:false 时插件什么都不做(不注入,也不注册工具)。
  "enabled": true,
  "apiUrl": "http://127.0.0.1:8080/api/v1",
  "apiKey": "",
  "kbIds": ["<知识库 id>", "<知识库 id>"],
  "kbNames": { "<知识库 id>": "知识" },
  "kbLabel": "知识",

  // 常驻层:不做检索也每轮都带着的规则(一条一句,别写长)。
  "pinned": [{ "reason": "tools", "text": "记忆库能主动查:weknora_search / weknora_read_document / weknora_ask。" }],

  // 工具组:关掉 toolsEnabled 只是不注册四个 weknora_* 工具,每轮注入照旧。
  "toolsEnabled": true,
  "tools": { "listKnowledgeBases": true, "search": true, "readDocument": true, "ask": true }
}
  • apiKey 建议不要写进文件:留空,用环境变量 WEKNORA_API_KEY(可选 WEKNORA_API_URL)注入。环境变量优先于文件,同一份配置可在不同机器上用不同 key。
  • kbIds 就是检索范围;kbNames 只影响注入块里显示的中文标签。
  • 四个工具:toolsEnabled(默认 true)总开关;toolPrefix 改名;tools: { listKnowledgeBases, search, readDocument, ask } 逐个关;toolAgentId 填了才走 ReAct 管线,toolMaxResults / toolMaxChunkChars / toolRequestTimeoutMs / toolChatTimeoutMs / toolResourceUrls 是它们各自的预算。关掉 toolsEnabled 不影响每轮注入。
  • 其余参数(超时、字符上限、命中数、阈值、RRF k、邻块扩展、衰减半衰期与下限、冷热分层配额、画像卡配额、事实卡权重、常驻块投递模式与刷新轮数、日志路径)全在同一个文件里,模板已逐个写默认值加注释;不改就是默认。
  • 写入侧也在同一个文件里:writers 段管四个定时脚本(会话沉淀 / 结论蒸馏 / 事实裁决 / 画像复核)。默认 "writers": { "enabled": false }——不打开就不会创建计划任务、不会往库里写东西。打开要填的三样:writers.enabled: true、writers.kbs 的三个库 id(会话记忆 / 知识 / 资料)、writers.sessionsRoot(DSH 转录目录);计划任务时间在 writers.tasks(hourly 或 HH:MM)。改完跑 node writers/print-config.mjs 可以确认它到底读到了哪份文件、哪个库。
  • 写侧的状态不放在包里:三个脚本的进度(哪些会话已入库、哪些结论已写过、昨夜裁决过哪些组)默认落在 <配置文件目录>/data/writer-state/{ingest,distill,dream}.json,日志落在 <配置文件目录>/logs/。想换地方就在 writers.stateDir 写一个路径(相对本配置文件,或写绝对路径)。这样升级 npm 包不会把记忆一起换掉,也不需要 node_modules 可写。
  • 包里另附一份纯 JSON 的同义文件 wk-inject.config.example.json(enabled: false、无凭据),给不接受注释的老宿主或配置中心用;正常使用不需要它,插件启动时写的那份就够。
  • 画像卡(profile.cards)与衰减状态是数据不是配置,默认落在同目录的 data/ 下,由夜间任务写;想手动改某张卡可以在配置里直接塞 profile.cards。

升级与版本对齐

npm run sync           # 本地仓库 / npm 线上 / 已安装 三个版本一眼看清
npm run sync:install   # 把线上最新版装进 profile(自动钉版本),然后重启 DSH

日常流程只有一条线:本地改 → npm test → 提版本号 → 打 tag(CI 自动发 npm 与 Release)→ npm run sync:install → 重启。跑的是装进去的那个包,不是仓库目录,所以「本地改了但没发版」在机器上永远不会悄悄生效。

十、隐私与边界

  • profile.json、profile-stats.json、tier-state.json、logs/inject.log 全部留在本机,默认在 ~/.dsh/wk-inject/(可用 WK_INJECT_HOME 换位置),不进仓库、不进包(.gitignore / .npmignore 都排除了)。
  • 本插件不向任何第三方上报数据;所有请求只发往你自己配置的 apiUrl。
  • 子代理会话默认不检索(skipSubagents: true):子代理拿到的是被裁剪过的任务,用它的文本去检索只会污染主会话的记忆。

十一、开发

npm test          # node --test test/*.mjs,81 个用例
文件职责
lib/index.js入口:apply 注册 agent/pre-step + 挂面板路由
lib/injector.js注入装配:身份判定、查询构造、去重、消息组装
lib/retrieve.jsWeKnora 分库并发检索、RRF 融合、来源权重、邻块扩展
lib/format.js阈值筛选、事实卡解析、冲突行、受控块渲染
lib/tier.jshot/warm/cold 分层与回温规则
lib/decay.js时效衰减与命中回写(原子 JSON 状态)
lib/config.js配置加载、钳制、日志;JSONC 解析与首次生成模板
lib/config-template.js唯一配置文件的模板(带中文注释的九节)
lib/writers-config.js写侧配置解析:共享配置 writers 段 → 老 writer.config.json → 出厂默认
lib/panel.js / lib/client.js面板同源路由 / GUI 侧渲染
lib/weknora.js唯一 HTTP 客户端:读侧与写入侧共用
lib/mount-tools.js工具挂载缝:本仓库配置 → vendor 配置 → ctx.tools
lib/tools.js / lib/tools-client.js / lib/render.js / lib/tool-config.jsvendor 自 @wxg-prc-cpg/dsh-weknora(MIT):四个工具、REST+SSE 客户端、渲染、配置校验
writers/*.mjs可选写入侧:ingest / distill / dream / profile-writer
writers/print-config.mjs / writers/register-tasks.ps1写侧配置排障(--json 给任务注册读) / 幂等注册计划任务

License

MIT © RenniMars

其中 lib/tools.js、lib/tools-client.js、lib/render.js、lib/tool-config.js 为 vendor 代码,来自 Tencent/WeKnora 的 packages/dsh-weknora(发布于 npm 的 @wxg-prc-cpg/dsh-weknora 0.1.0),MIT 许可,版权归 WeKnora 作者所有;除文件头的来源说明外保持原样。

发布流程

版本号、CHANGELOG 与 git tag 三处同步,发布由 CI 完成,不在本机手工 npm publish:

  1. 改代码 → 在 CHANGELOG.md 顶部加一节(版本号 + 变更)→ package.json 的 version 改成同一个号。
  2. npm test 全绿。
  3. git commit → git tag vX.Y.Z → git push origin main --follow-tags。
  4. .github/workflows/release.yml 校验 tag 与 package.json 版本一致后,跑测试、npm publish --provenance,再发 GitHub Release。发布走 npm 的 trusted publishing:GitHub Actions 用本 workflow 的 OIDC 身份换短时凭证,仓库里不放任何长期 token(npm 侧已绑定 RenniMars/dsh-weknora-memory + release.yml,权限 publish 与 stage publish)。
  5. .github/workflows/ci.yml 在每次 push / PR 上跑 Node 20 与 22 两个版本的测试。

回滚:npm 侧 npm deprecate @rennimars/dsh-weknora-memory@X.Y.Z "原因" 并发布修正版;GitHub 侧 git revert 后重新打 tag,不移动已有 tag。

路线图 / Roadmap

本项目的演进计划分阶段推进:先给"检索准不准"一把可量化的尺子,再让事实卡的冲突能被裁决、遗忘能被解释、主题能被归并,最后才谈写入门控。 完整计划(13 节,含每阶段的目标、改动点、验收与回滚):docs/ROADMAP.md 当前版本 0.3.3;计划可分批实现、每批独立验收,欢迎在 Issue 区按阶段提方案。 想改这份计划,请先开 Issue 讨论,达成一致后再改文档,不要直接改 ROADMAP.md。

Plugins relacionados