Repository navigation
Releases
Releases · Ido1um/DeepSeek-memory-Ido1um
记忆 3.1 (3.1.0)
这是记忆 3.1 的正式版。数据格式只增不改,3.0 的库可以直接用。
3.1.0 — 2026-11-05
在 3.0 的分层之上,把「记忆」从只读投影推进到可写、可查、可核对:她自己能记、能改,检索按问法而不是按字面,图片和课表也有结构化落点。数据格式只增不改,3.0 库直接可用。
新增
- 自写事实(
src/self-write.mjs):助手通过 MCP 工具qq_memory_write写一条author:'self'、第一人称原句的事实,进同一套归并/衰减/卡片/检索;配额memory.selfWrite{maxPerDay:5, maxTotal:300, maxValueChars:60, maxTextChars:400, initialI:0.7, protectFromExtract:true},抽取器遇到同槽位自写单值只补不改。 - 修订留痕(
src/revise.mjs):qq_memory_edit只允许改自写事实,产生ev:'revise'与logs/fact-history.jsonl(before/after/by/at/reason/revision);回滚等于再修订一次。 - 问法路由(
src/route.mjs):整句问法 → 槽位 / 主题 / 主体 / 科目 / 日期;scoring-runner.search新增match:'smart',权重 槽位 8000 > 科目 7000 > 主题 6000 > 词法 ≤1200 > 主体 900,过期 −3000,主体或生日 who 不符再降。 - 召回格式(
src/recall-format.mjs):命中行带⟵ 窗口 MM-DD 轮 a–b锚点、自写标〔自己写的〕;空结果给出「我把它当成什么 / 相关但已过期 / 只是词面相近 / 下一步」四段诊断。 - 图片记忆(
src/media.mjs):入站图片按 sha1 存media/YYYY-MM/<sha1>.<ext>,索引state/media.jsonl;窗口账本只记mediaRefs,图片字节不进注入。MCPqq_memory_photo按 sha1 取原图,HTTPGET /api/socialV2/memory-photo,配置memory.media{enabled,maxBytes:8388608,maxPerTurn:6,keepDays:0}。 - 结构化字段(
src/entities.mjs、src/fields-migrate.mjs):事实可带entities{people,orgs,places}(每类 ≤6、总 ≤12);槽位扩展major / exam / course;课表只在「周几 + 时间/教室 + 课程名」的单条上成立,拼句进 review。 - 课表(
src/schedule.mjs):state/calendar.json记学期/周次/锚点,课程事实带course{name,day,start,end,parity,weekFrom,weekTo,location,semester};coursesOn()按周几 + 周次 + 单双周过滤,scheduleAnswer()输出「YYYY-MM-DD 周X · 第 N 周(双周):- 课程|时间 · 地点」。配置memory.schedule.enabled。 - 窗口缺口回填(
src/gapfill.mjs):入站缓存noteInbound/peekInbound/consumeInbound;日终按raw/反向核对,把「主人说了但没进账本」的连续消息补成一轮(fidelity:'reconciled'、source:'raw-gap'),日志logs/window-gap.log;CLIscripts/repair-window-gaps.mjs --days 3 --write。配置memory.window.gapRepair。 - 纠正候选(
src/claims.mjs):她说的纠正(含科目/专业代码、非元讨论、非寒暄)落state/claims.jsonl待确认;确认后写成author:'correction'事实并退掉旧口径,驳回留审计。配置memory.claims。 - 脚本:
fix-fake-time.mjs、repair-window-gaps.mjs、route-preview.mjs、migrate-fields.mjs、window-reconcile.mjs。 - 工作台:
/api/history、/api/recall、/api/media、/api/claims,新增「检索调试」页签、事实修订链、原图预览、待确认纠正卡片。
变更
- 检索结果行补
source / author / voice / saidAt / expired / topicId,锚点不再恒为空。 - v10 的
rankInInject改为「结构 rank 优先、激活值 tiebreak」。 - 卡片:子主题的「标题 + 首行」合并为一条并按主题顺序排;「旧事」行预留至多 20% 预算,避免被分额吃光。
修复
- 无时间词的计划被编造失效:旧规则把没有显式时间的事件/计划当成「当天生效、次日失效」,导致「考研目标」这类长期计划第二天变旧事;现在无显式时间词 →
dates: []、validUntil: null,只留saidAt。存量用scripts/fix-fake-time.mjs --write清理。 - 窗口账本漏记主人消息(尤其纠正与课表):入站缓存 + 日终反向对账,补写
fidelity:'reconciled'的轮次。 episode.segmentTurns改为按at升序,补写行(turn 号大、时间早)不再把情境段切乱。
测试
- 479 个用例(相对 3.0.0 新增 93 个,覆盖 13 个新测试文件:self-write / revise / route / route-eval / route-subjects / recall-format / media / window-media / entities / fields-migrate / schedule / gapfill / claims)、验收自检 17 项全部通过。
记忆 3.0 Beta 2 (3.0.0-beta.2)
Beta 2:把事实的时间放回它被说出口的那一刻;生日落成日期字段。不改变已有数据格式。
3.0.0-beta.2 鈥?2026-11-04
Beta 2 鍙仛涓€浠朵簨锛?*鎶婁簨瀹炵殑鏃堕棿鏀惧洖瀹冭璇村嚭鍙g殑閭d竴鍒?*锛屽苟璁╃敓鏃ユ垚涓哄彲鏌ヨ鐨勬棩鏈熷瓧娈点€備笉鏀瑰彉宸叉湁鏁版嵁鏍煎紡锛岃€佸簱鍙洿鎺ョ敤銆?
鏂板
- **浜嬪疄鏃堕棿閿?*锛坄src/timeparse.mjs
锛夛細瑙f瀽銆屼粖鏅?/ 鏄庡ぉ / 涓婂懆涓?/ 11 鏈?2 鏃?/ 涓夊ぉ鍚?/ 姣忓ぉ銆嶏紝浜у嚭dates[]銆乣validUntil銆乣phrase涓?who锛堟椂闂磋瘝鍓嶅悗 10 瀛楀垽鏂鐨勬槸璋侊級锛屾椂鍖哄浐瀹?+08:00銆?- **鐢熸棩缁撴瀯瀛楁**锛氫簨瀹炲彲甯?birthday: { y, m, d, key: 'MM-DD', yearly, who }锛宍parseBirthday()鏀寔銆?007 骞?9 鏈?5 鏃ャ€嶃€?1 鏈?2 鏃ャ€嶃€?1-02銆嶏紝birthdayWho()鎸変富璇垽鏂睘浜庣敤鎴疯繕鏄姪鎵嬶紱鍙ュ瓙閲屽悓鏃跺嚭鐜颁袱涓汉鏃朵互鍔╂墜涓哄噯銆?- 杩佺Щ鑴氭湰锛歚scripts/migrate-timefields.mjs锛堟寜鎯呭娈佃疆娆″弽鏌ユ瘡鍙ヨ瘽鐨勬椂闂撮敋锛屾煡涓嶅埌鏍?timeUnknown锛変笌scripts/migrate-birthday.mjs锛堟妸鏂囨閲岀殑鐢熸棩琛ユ垚缁撴瀯瀛楁锛屽箓绛夈€佸彧杩藉姞ev:'update'銆佸啓鍓嶅浠斤級銆?- **楠屾敹鑷**锛歚scripts/acceptance-check.mjs锛屾妸鏁版嵁鐩綍澶嶅埗鍒颁复鏃剁洰褰曞悗閫愰」妫€鏌ユ敞鍏ャ€佽疆杞€佸崱闈€佹绱€佺敓鏃ュ瓧娈电瓑 15 椤癸紝鍙鐪熸簮銆?
鍙樻洿
materialize()鐢?at = saidAt || createdAt娲剧敓浜嬪疄鏃堕棿涓?expired锛屼笉鍐嶆嬁鍐欏簱鏃堕棿褰撲簨瀹炴椂闂淬€?- 浜嬪疄鍗★細杩囨湡浜嬪疄绉诲嚭銆岀幇鍦ㄣ€嶅尯锛屾瘡涓牴涓婚鏈熬鍗曞垪涓€琛屻€屾棫浜嬶細MM-DD 鈥︼紱鈥︺€嶏紙鏈€澶?3 浠讹級锛涚敓鏃ユ寜birthday瀛楁娓叉煋鎴愩€岀敓鏃ワ細2007骞?鏈?鏃ャ€嶏紝鍚屼竴浜哄悓鏈堟棩鑷姩鍘婚噸銆?- 妫€绱細scoring-runner澧炲姞妲戒綅鎻愮ず锛堢敓鏃?鍑虹敓/瀵胯景 鈫?birthday锛変笌whoHint锛堥棶銆屼富浜?鎴戙€嶄紭鍏堢敤鎴凤紝闂€屽ス/鍔╂墜銆嶄紭鍏堝姪鎵嬶級锛涙绱㈢粨鏋滈噷鐨勬棫浜嬫爣銆屾棫浜?路 MM-DD銆嶃€?- 杩囨湡鍒ゅ畾涓嶅啀鎶婄敓鏃ョ畻杩涘幓鈥斺€旂敓鏃ユ瘡骞撮兘浼氬洖鏉ャ€?
淇
- 寰呭姙璇垽锛歚task` 鍒ゅ畾鍔犮€屽厓璁ㄨ璇?/ 鐤戦棶鍙?/ 杩囧幓鏃堕棿銆嶄笁閬撻棬锛岃繃鍘绘椂鐨勪簨涓嶅啀鐢熸垚寰呭姙銆?- 銆屼笂涓?X銆嶆寜杩囧幓銆併€屼笅涓?X銆嶆寜鏈潵瑙f瀽锛屽彧鏈変笉甯﹀墠缂€鐨勩€孹銆嶆墠椤哄欢銆?
娴嬭瘯
- 377 涓敤渚嬪叏杩囷紙鏂板
timeparse.test.mjs銆乣search-birthday.test.mjs锛屾墿灞?card-hygiene銆乣card-tree銆乣due銆乣engine銆乣retrieval銆乣window锛夈€?
记忆 3.0 Beta (3.0.0-beta.1)
记忆 3.0 首个 Beta。窗口账本 / 情境段 / 轮转契约 / 主题树 / 写入门 / 分层检索已可用;默认关闭模型抽取与 v10 输出,先观察再开。
Beta 期间数据格式可能做向后兼容的微调;升级前请备份数据目录。
首个 3.0 Beta。数据格式已可用,但 Beta 期间可能做向后兼容的微调。
新增
- 窗口账本(
src/window.mjs):按轮记录用户原话、助手真正发出去的话、以及[[feel]]…[[/feel]]包起来的「当时的想法」;想法在发送前剥离,只留在账本里。块级去重(同一段文本只存一份),支持草稿回收与超时清扫。 - 情境段(
src/episode.mjs+src/episode-ai.mjs):按 90 分钟间隔切段,少于 4 轮并入上一段,单段最多 40 轮;按 id 幂等 upsert;可选模型摘要(标题/场景/主题/想法)。 - 轮转契约:
≥ 70% × 上下文窗口可自动或手动轮转;< 70%必须人明确批准(rotate(force, approved)与宿主的 reset 端点都做了闸门)。 - 交接首屏:规则 600 + 事实卡 1500 + 最近一天原话 ≤2400 + 七天摘要,总量由
handoverMaxChars(默认 5000)兜底;没有原话时退回提取式摘要。 - 主题树事实卡(
src/topics.mjs+src/card-tree.mjs):主题/子主题分组、24 个槽位、同槽留最新、超预算整块丢并注明省略条数。 - 事实卡清洗(
src/card-hygiene.mjs):未闭合括号截断、技术噪声排除、残句过滤、型号归一、跨槽位去重、单值槽位选最完整、多值封顶、事件排序、主体纠偏。只清洗投影,不改真源。 - 写入门三档(
src/gate.mjs):pass / mark / block,原因码quoted / meta / uncertain / transient / botPref / thin;gateMode: broad时低置信只写影子。 - 候选池(
src/candidates.mjs):宽进候选先落state/candidates.jsonl(status=pending),不进卡、不进检索、不参与打分;日终裁决后才写事实。 - 模型抽取(
src/extract-model.mjs):日终把当天用户消息分批交模型,13 条硬规则 + 5 条语义门(称呼、属性证据、偏好动词、版本/系列、未来计划)过滤;默认关闭,可只写影子。 - 情境抽取(
src/extract-episode.mjs):从情境段里抽候选事实,quote必须是原文逐字子串。 - 分层检索(
src/retrieval.mjs):近 7 天情境 → 近 7 天原话 → 近 30 天情境;二元组 + substring 回退,超短查询(单个汉字)也能命中。 - v10 记忆属性(
src/v10.mjs):细节/情绪/可信度/碎片与三档语气措辞,emit默认关(关时注入文本与排序逐字节不变)。 - 消费记账:记忆侧模型调用写
logs/memory-usage.jsonl,按 caller 区分(handover / profile / extract / episode / entry)。 - 工作台新面板:窗口回放、情境索引、主题簇、消费账单(只读接口
/api/window、/api/episodes、/api/topics、/api/usage)。 - 隐私扫描(
scripts/scan-secrets.mjs):本机路径、令牌、真实private:/group:账号、凭据赋值、私钥块;支持PRIVATE_WORDS追加私人词。
变更
- 配置默认值集中到
src/engine.mjs的DEFAULTS:handoverMaxChars默认 5000、事实卡 1500、轮转阈值 0.7、冷却 10 分钟、最小轮转 20000 token。 - 数据目录默认
~/.deepseek-memory/data(可用QQ_MEMORY_DIR/memory.dir覆盖),不再从宿主程序目录推导。 - 事实卡优先走主题树投影;没有
state/topics.jsonl或profile.tree=false时回退旧扁平投影。 - 注入预算与压力阈值按真实 token 计算,拿不到用量时用「已观测最大 × 1.15」估算。
- 工作台端口(7351)、令牌、数据目录、价格表、宿主配置与日志全部改为环境变量/页面可配,不再写死路径。
修复
- 超短查询(「鱼」「嗯」)切不出中文二元组时 0 命中 → 空 token 回退 substring。
- 语气摘要长度上限计入「〔语气备忘〕」前缀;同秒多次写备份不再互相覆盖。
- 事实卡省略尾注与卡头重复。
- 主题分类里「大学」等泛词抢先命中,导致具体学校主题永远不命中。
已知限制
- 没有随包发布旧日志回填工具;2.x 已有数据可直接读。
- 主题分类以规则为主,跨领域话题需要自己补主题表。
- 日终摘要与模型抽取默认关闭,需自备模型凭据。
- 工作台是单机工具,无多用户/权限模型。
测试
node --test:355 个用例全部通过(Node 22 / 24,Windows / Linux)。node scripts/scan-secrets.mjs:发布树零命中。