Skip to content

v0.16.0

Latest

Choose a tag to compare

@github-actions github-actions released this 15 Nov 07:56
70dd4ad
  • 降格一组的情绪,把另一组还在用的那行 pattern 一起归档了:归档前没问「还有谁在引用」(#739) — 升格走的 applyCreate 按 (type, title) 去重,而标题模板只吃 person/target 与情绪原词(src/lang.js 的 affectiveTrait.title)…

    细节

    聚合键却含归一后的 normalize_key(src/api.js:1810)——于是「原词相同、归一键不同」的两组在面板上是两组、在库里是同一行 pattern。原来的降格只处理自己那组:清掉本组的边标记、把这行 setArchived(true),另一组随即指着一条已归档的 id——聚合面还报 attribution=trait、traitSessionCount=5,注入面那条 pattern 已经不存在,两面口径相反且没有任何一处报错。实测(内存库,promote e1 → promote e2 复用同一个 id → demote e1):修前 patternArchived: true,e2 的 promotedToTrait 仍是 true、traitMemoryId 仍指向已归档那行。修法是在归档前做引用计数:新增 store.relationIdsByTraitMemoryId(traitMemoryId, { excludeIds, limit }),只数排掉本次请求里的边之后仍带 promotedToTrait: true 且 traitMemoryId 指向这里的边——有就不归档,把这行留着给别组,回执显式说出来:patternRetained: true、retainedPatternIds、retainedPatternRefs: [{ patternId, edgeCount, edgeIds }](并写进 journal 的 after)。别组最后一位读者降格时才归档,行为与旧版一致。两个刻意的取舍:未归档必须显式回报,不再出现「什么都没做但看起来成功了」——这是 #725 那轮定下的规矩,一次静默就是一次最难查的故障;metadata 的 json_extract 一律包 CASE WHEN json_valid(metadata),历史行里有空值也有非 JSON 的脏值,裸写会抛 malformed JSON 把整个降格打成 500(新用例专门喂了脏行)。按 (type, title) 去重本身要不要改是另一件事,不在本件范围内。回执里 edgeCount 取 COUNT(*) 的真值,edgeIds 只用于点名、受 limit = 50 约束,截断时 edgeIdsTruncated: true 显式标出——拿数组长度冒充总数,就是「静默截断」换个地方复发。

测试 3,569 → 3,574(+5,test/graph-api.test.js):跨组共用时降格不归档且回执报出 edgeCount: 1 与具体边 id、别组最后一位读者降格时才归档、脏 metadata 不把请求打成 500、52 条引用时 edgeCount: 51 而 edgeIds.length: 50 且 edgeIdsTruncated: true、边上的 id 指向一行已不在了时回落按标题归档(否则条件只看「有没有 id」就会跳过回落,又一次静默)。变异自证四条:绕过引用计数(otherEdgeIds 恒为空)→ 第 1、3 条红;去掉 json_valid 守卫 → 第 3 条红(报 malformed JSON);回落条件改回只看 traitIds 是否为空 → 第 5 条红;把 edgeCount 改回取数组长度 → 第 4 条红。

  • 升格铸出的那行 pattern,降格时可能根本找不到:靠标题在 list({limit:200}) 里捞,窗口一挤就静默失手(#734) — promote 铸出「稳定倾向」行之后只在边上打了个 promotedToTrait: true,没记 id;demote 于是靠当次界面语言重算的标题回到 service.list({ type:"pattern", limit:200 }) 里 find 一次。

    细节

    两个坑都能实测复现:① 库里 pattern 超过 200 条、目标被别的行挤出窗口 —— 边标记被照常清掉、那一行仍在活跃,applied: 1、failures: [],于是 pattern 说「稳定倾向 X」、边已掉回单次场合,两处口径相反且没有任何一处报错;② 中文界面铸出的是中文标题,切到英文界面再降格,重算出的英文标题与库里的中文行对不上 —— 同样清标记、同样报成功。修法是把身份写下来而不是再猜一遍:promote 成功后把 pattern 的 id 写进组内每条边的 metadata.traitMemoryId,demote 先按这个 id 精确归档(语言无关、与 pattern 总数无关);老数据没有 id 时回落到同题查找,且换成定向读(新增 store.findByTypeAndTitle(type, title, { includeArchived }),无 LIMIT、TRIM(title) 与写路径同一把尺),list({limit:200}) 那条路彻底删掉。顺带两件同一处的问题:重复 promote 原本是「409 却 failures: []」——applyCreate 命中同题走 merged、applied 为 0,面板拿不到任何原因;现在同题行(含已归档的)直接复用、必要时解档、正文按本次证据刷新,返回 200 { reused: true, patternId },applied 仍只数边、形状标记走平级的 extra 不掺进去。promote → demote → promote 每轮多留一条 archived 行(实测 3 轮剩 3 条)也随之消失:复用同一行,不再靠去重候选(只含活跃行,永远命中不到刚归档的那条)。测试 3,565 → 3,569(+4,test/graph-api.test.js):250 条别的 pattern 挤窗口时 demote 仍真归档、中文铸英文删、重复 promote 幂等返回 reused、三轮循环后库里仍只有一行。变异自证四条:demote 回退成 list({limit:200}) → 前两条红;去掉复用分支 → 第三条红;不写 traitMemoryId → 前两条红。

  • 向量路一开就整个 memory_search 报错:_score 产出了却没在 output schema 里声明(#735) — 上一版给检索结果加了 _score(#713 续),DTO 产地 service.toApiList 会条件展开这个键…

    细节

    但 src/tools.js 的 MEMORY_ITEM_SCHEMA 是 additionalProperties: false 且没有声明它——于是 mode=auto|vector 命中向量时,宿主 in-process 校验直接把整个返回值判成 tool "memory_search" returned invalid output: "value.items[0]._score" is not a declared property,表现为「换个 mode 就全挂、keyword 正常」。修法只有一处:在共享的 MEMORY_ITEM_SCHEMA.properties 里加 _score: { type: "number" }(可选属性——keyword 路、memory_list、memory_get 恒不带该键),并就地留注释说明它与 vectorSearchThreshold 是同一把尺子、以及 #713 那次为什么没被发现。测试 3,552 → 3,554:新增 test/tools-search-score-schema.test.js,让向量路真的命中(mock embedder + 余弦 0.5 + 配置阈值 0.4)后拿 memory_search 自己声明的 output.schema 校验真实返回值,并覆盖 keyword / list / get 三条不带该键的路径;同时补上矩阵 B 层的一个空洞——test/tools-dto-schema-matrix.test.js 的「声明键必须被真实产出」原本只喂 list,永远产不出 _score,加了 _score 之后会把这条正确声明判成死声明,故新增 observeVectorShape() 补一次向量路形态记账。变异自证:删掉 _score 声明 → 新测试立刻红,报错文字与 issue 里那句逐字一致。现有两条测试为什么没抓到:test/vector-threshold.test.js 只比 toApiList 出来的数值、从不过 output schema;矩阵 A/B 层的 setup() 从不挂 embedder,种子形态里没有一条走过向量路。

  • 日记本 v2:一个 Agent 一本,素材取全局记忆(#613) — v0.13 的日记按「项目桶」分,一个人格在几个项目里就散成几本,同一件事的上下文被切开。

    细节

    这一版把分桶改到身份维度:agents/<agentId>/ 与项目桶正交并存不迁移,同 hash 项目桶在 library 读取前 best-effort 归并(日期不重叠整篇归位,重叠就是两份都留着当 conflict 副本、绝不静默覆盖,runs.jsonl 按行追加不补写历史)。身份解析走三级——标题 · 前缀(只认 source=user)命中人格卡名单 → preset → _unnamed,首次写入时把结论落进 agents/sessions.json,之后改标题只更新展示名;改一次标题就多出一本孤儿书是验收时点名的分叉,落定这一步就是为了堵它。素材换源到 store.diaryMaterial,四条实测口径都写进 SQL 而不是留给调用方猜:source 两形零重叠、occurred_at 为 NULL 占 54.4% 故必须 COALESCE、-480 偏移带按偏移量认(阈值法挡不住)、日界按本地墙钟;LIMIT 截断用 {total, used, truncated} 三元组显式暴露,正文末尾与账本 diaryTruncated 两处都能看见。类型黑名单 diaryMemoryExcludeTypes 默认 constraint/preference。触发改按 agentId 维度(turn/end、定时巡检、启动 catchUp),agentResolver 缺席时维持项目维度、行为与 v0.13 逐字节一致。验收红线十条逐条落成 test/diary-agent.test.js 用例:时区、COALESCE、-480、两形、LIMIT 不静默、agentId 守卫、fallback 不认、冷行回填、同 hash 归并(重叠与不重叠两向)。

  • 日记素材在 UTC 以西的时区整天为空,而且不报错(#613 复审) — diaryMaterial 把窗口偏移拼成 SQLite modifier 时写的是 '+${offsetMinutes} minutes'——SQLite 只认 ±N minutes…

    细节

    +-300 minutes 这种「加号紧跟负号」判非法、datetime() 直接返回 NULL,于是窗口条件恒假:西半球(美洲、太平洋)的日记素材全部 0 条,一条错误都不留。实测同一行、同一整天窗口,offsetMinutes 为 480/540/0 时 total 都是 1,为 -300/-480/-840 时全是 0;datetime('2026-11-08T00:00:00','+-300 minutes') 返回 null、'-300 minutes' 返回 2026-11-07 19:00:00,这就是「拼串 vs 符号」的判定证据。修法是把符号与绝对值分开:offsetSql 按 offMin < 0 ? "-" : "+" 加 Math.abs(offMin),where、CTE 的 datetime()、rows 的 local_ts 四处统一用同一个串。CI 抓不到这条:UTC runner 上偏移恒为 0,走不到符号分支,所以补了一条在 TZ=America/New_York 子进程里跑的用例,并把它跟着的时区矩阵一起跑过 11 个时区(含 UTC+14 与 UTC-11)全绿。测试夹具同时从「以 UTC 字面量为基准」改成按本地墙钟构造——原先那套在 UTC runner 上必挂、在 UTC+14/UTC-11 下也不成立。

  • 情绪记忆的人工修正通道:五种操作、一本账、回执不撒谎(#725) — 此前情绪边只能由自动链路写,用户看着一条记错的「稳定倾向」没有任何入口改它。

    细节

    新增 POST /semantic/graph/affective/apply(token-write)与 GET /semantic/graph/affective/journal(与其余 graph 读同口径开放):rename(词表归一,与 #723 的写入纪律同一份常量)、archive、restore(与 #724 的 TTL 同一个标记,可恢复不删除)、promote(铸 type=pattern,走 validateDecisions + applyDecisions,帽额与 #512 的 mint 账本照旧)、demote(清升格标记 + 同题 pattern 行归档)。组内并发失效的边进 failures 如实摆出,不整包拒——一次点击里有三条边、其中一条已被别处归档,把另外两条一起回滚是另一种假失败。账本落在新表 affective_journal(幂等迁移):谁、何时、对哪条边做了什么,只记账不触发 hook,配套 recordAffectiveJournal / listAffectiveJournal / pruneAffectiveJournal。前端在情绪页做成行级操作(改词行内编辑、归档、升格、降格,按钮可见性=操作前提,避免点了才报错),加归档区(默认收起,展开才读)与最近变更账本,store-changed 广播后失败以 role=alert 出现。SECURITY.md 的受门控清单两语言补上 apply。

  • 情绪聚合端点:why / downgradedFrom 透出、三档过滤与游标分页(#726) — 睡眠相位写 metadata 时早就采了「为什么记下这条」(截 200 字)与「曾判成特质又降级」的留痕,却被聚合层丢掉,前端想做悬浮说明与降级标示都没数据可用——现在透出。

    细节

    promotedToTrait 的源边归入 trait 组:铸出 pattern 后只给源边打标、边的字面 attribution 仍留在 occasion(不改写记录语义),严格照字面归组的话「稳定倾向」组在纯 sleep 流下永远空着,所以按展示语义归组、边一个字没改。加 ?person=(名或 id)/ ?emotion= / ?attribution= 三档过滤,skipped/totalEdges 口径按过滤前全量组算、不随过滤漂;请求带 cursor 才进分页模式,边帽放宽到 4×limit(下限 800)让组页翻得出去,排序补聚合键 tiebreaker(顺序是数据的纯函数,游标才翻得准),解不开的游标回 400。不带 cursor 时边帽、聚合、排序与旧版一致,差异只有每项新增的 why/downgradedFrom 与顶层 next: null。

  • 情绪词归一 + valence:同一件事换个说法就不再裂成两组(#723) — AFFECTIVE_VOCAB 进 src/lang.js(中英同义词组:主词 + 向性 + 近义词),affectiveVocabFor 做写入时归一查找、affectiveVocabText 展开 prompt 里的枚举——查找与枚举必须是同一份常量,分开放迟早漂。

    细节

    写入时 metadata 增 normalize_key(组主词)与 valence(组向性);词表外的词 normalize_key 取原词、valence 为 null,照常落库——词表只决定归到哪组,不改写、不丢弃。聚合键优先取 normalize_key,组同时透出 normalizeKey/valence/originals(原词全量保留);组内显示的 emotion 取主词而不是首个原词,因为同毫秒创建的边顺序不定、首个原词不稳定。存量边没有 normalize_key 时按词面兜底,行为不变。词表是初始集,扩充只改常量不动代码。

  • 单次场合的情绪边有了生命周期:过期归档、可恢复、回执记账(#724) — 新配置键 sleepAffectiveOccasionTtlDays(0=关,opt-in,0–3650)。

    细节

    新相位 affectiveTtl(无 LLM):超过 TTL 且期间没有合并活动的 occasion 边打 archivedAt 标记,可恢复不删除,与记忆归档同一哲学;trait 与 promotedToTrait 边不过期(稳定倾向没有 TTL);时间锚取 max(created_at, lastMergedAt),解析不出就不动——宁可留着不误杀。归因相位因无路由跳过时巡检照跑:家务不等模型。合并时记 lastMergedAt(合并就是「这条边还活着」的信号,runId 保留继续做审计追溯)。聚合端点归档口径分档:默认不含归档边,?archived=1 只看归档区,archivedEdges 单列;skipped 只数「没有情绪名」的边——归档账与缺名词账混在一起,「归档了」会被读成「本来就没记」。注入侧跳过归档边:归档的含义就是「这条情绪过时了」,继续挂等于把归档当没发生。