Skip to content

0.10.4 — 基于 DSH 0.2.1-rc.5

Choose a tag to compare

@FuRongJun-1999 FuRongJun-1999 released this 16 Nov 04:27
· 148 commits to main since this release

安装

# npm(已发布 0.10.4)
npm i @furongjun1999/dsh-memory@0.10.4

# 或从源码
git clone https://github.com/FuRongJun-1999/dsh-memory.git

请确认宿主为 DSH 0.2.1-rc.5;0.2.2 系列尚未适配(见上方兼容性声明)。

基于 DSH 0.2.1-rc.5。

宿主兼容性声明:本版本基于 DSH 0.2.1-rc.5 开发与验证。
DSH 0.2.2 系列(含 rc.3)存在破坏性更新——@deepseek-ai/cordis 4.0.5 → 4.1.0(ctx.get 严格语义/服务就绪判定面)、
工具包从单包拆为一工具一包、插件依赖的 dsh-tools / dsh-system-prompt / dsh-session / dsh-llm 不再由总包直接列出——
尚未适配。升级宿主前请先看 docs/ 的兼容性清单(待补),不要直接替换运行环境。

主打一:检索提速——分类落到检索主链路

「分类、身份、用途、分层」不再是设计文档里的东西,而是真进了检索判据:

  • 标签预筛 tags_any(#957 / #958 / #959 / #960):单路优先域 + 覆盖率闸 + 空结果回退。
    实测库层 24–29s → 0.31s,工具面 20.89s → 0.50s(约 40–90 倍)。
    语义是优先域而非硬过滤:覆盖不足时自动回退融合检索并在 meta 标注,避免「筛掉就查不到」。
  • 用途/项目副键(#944 / #949 / #953):桶索引新增 purposes / projects 副键计数,修掉「算完即丢」;
    主归属=项目、用途=大类,说明: 承载小类。
  • 写入面同口径打标(#943 / #952):经 cg(op=write) 与 mdcg_remember 两条通路都打用途标签
    (此前只有一条通路打,另一条静默漏打)。

主打二:热层(本地库优先检索)落地

  • 热层不再每次全量重建(#955):新鲜度改判索引指纹(_index_fp),节点集合未变即复用;
    重建实测 3.2s 只在节点集变化时付。
  • 增量复用 + 正确性守卫(#961):按 content_hash 复用旧条目,守卫断言复用后结果与全量重建逐位一致。
  • scope=hot 作用域(#969):read / route / stg relation 三处可显式只走热层——
    read 29.31s → 0.27s、route 15–21s → 0.38s、relation 20–22s → 0.14s;
    read 在热层无命中时按热层优先级出 browse 批次(meta.mode=browse),不再让界面白屏;
    relation 任一节点不在热层则回落全库,不伪造关系。

主打三:#929 五条断根

  • 审计归情景层(#962):审计=工作记录(检查/审批用途),不再占结构层、不再当作「自身结构变更」;
    带 用途:跑审计 与 项目:<名> 标签,项目未登记时写 项目:未登记(不猜)。
  • 否证进索引(#966):rejection_reason 落进索引条目,读面可见。
  • S1 域闸覆盖率前置判据(#964):big_domain 覆盖率低于 MDCG_GATE_S1_MIN_COVERAGE(缺省 0.60)时不收敛,
    标注 skipped_reason=big_domain_coverage_low。
  • 比对上限自适应(#964):MAX_COMPARE=240 由硬截断改为下限,池大则全比、封顶 MDCG_MAX_COMPARE_CAP(缺省 1200);
    candidate_total 恒定透出;MDCG_MAX_COMPARE_CAP=240 可复现旧行为(回退开关)。
  • 项目/用途路由(#967):cg(op=read, project=…) / purpose=… 直达副键。

修复

  • 别名全链路召回(#954):aliases 此前只在 _like 兜底路径生效,主链路零召回。补齐四处:
    索引条目字段、写入 stage、bm25 词面、文档侧 _doc_norm_bigrams。
    关键边界:aliases 只入词面,不并入 tags——tasks/predict 的身份判据只读 tags,混入会翻转判据。
  • bucket_auto.age_h 纪元假象(#921,外部贡献):索引从未重建时 age_h=(now-0)/3600 报成 498497 小时(≈56.7 年),
    语义正好相反。改为 age_h=None(如实表示无历史),并顺手修掉 last_build_ts 连读两次的竞态。
  • UI 取消失效(#925 / #933):fetchJSON 覆盖调用方 AbortSignal ⇒ 取消后仍渲染旧响应;改 AbortSignal.any([...])。
  • #708 / #358 守卫跟上语义变更:审计改层后旧样本失效(#708 改用显式结构层验证同一不变量 + 新增 C3 钉新语义);
    比对自适应后 #358 用回退开关复现旧行为 + 新增 A8 钉新语义。均为保留不变量,未删除断言。
  • #929 UI 守卫失效(#972):判据写成只匹配 recallSkipItem(it),而调用点已带第二参数 ⇒ 守卫静默失效。

界面

  • 双语界面(#973):默认中文,顶栏可切英文(localStorage 记忆)。工具 schema 原文一字未动——
    翻译只挂在界面(TOOL_I18N + tTool/tOp),缺译回退中文;加语言 = 加一个语言键。
    覆盖 cg 全部 39 个 op + 记忆相关工具;守卫 C1(缺一即红)与 T1–T4(含禁止译文回流 schema)。
  • scope=hot 接线与检索范围选择器(#969):缺省热层、可选全库;结果标题如实标注「(热层)/(全库)」。
  • 调用计时日志(#971):每次 UI 调用记 工具:op + 耗时 + 桥就绪,用于定位「某页面慢」到底慢在哪一层。

其它

  • 身份五元组端侧接线骨架(#942,缺省关闭)+ 取值配置化(#946)+ 开启指南(#951);
  • 三层分类定稿与反例(#947 / #950);
  • fold_accents 记忆化(#956):端到端零收益,如实记录,不作为提速依据。

已知边界(不修,如实记录)

  • 融合六路 search_rrf 未接标签预筛(只有单路生效);
  • 热层只覆盖 6,000 / 35,300 条(自我 / 锚点 / 近 7 天 / 重要度 ≥ 0.7),scope=hot 结果是范围限定,不等于全库最优;
  • 大库 _index.json 62.9MB / 35,412 条,装载 10.9s(桥冷启动 ~14s 的主因);分片/二进制化未做;
  • big_domain 在真实库覆盖 0/35,300(检索管线从未开启),S1 闸在覆盖率为 0 时不误触发。