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
Install
dsh plugin --profile web add github:rennimars/dsh-weknora-memoryREADME
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 字符 | 永不参与打分、永不衰减 |
画像层 profile | soul 规则 / 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.mjs | data/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.js | WeKnora 分库并发检索、RRF 融合、来源权重、邻块扩展 |
lib/format.js | 阈值筛选、事实卡解析、冲突行、受控块渲染 |
lib/tier.js | hot/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.js | vendor 自 @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:
- 改代码 → 在
CHANGELOG.md顶部加一节(版本号 + 变更)→package.json的version改成同一个号。 npm test全绿。git commit→git tag vX.Y.Z→git push origin main --follow-tags。.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)。.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。