Skip to content

Releases

4.97.3

Choose a tag to compare

@github-actions github-actions released this 20 Nov 06:15

v4.97.3 — 构建可复现:内联 worker 的 gzip 头与压缩实现

标签 4.97.3 · 2026-11-20 · 上一版 4.97.2

为什么发这一版

4.97.2 修掉了审核扫描器唯一保持 error 的 eslint-comments/require-description,但那只是「Source code」这一段。审核还有一段 Build verification:重新构建仓库,并与 GitHub Release 里的 main.js 比对。本仓这一条一直是坏的:

  • scripts/generate-worker-inline.mjs 把两个 worker 的打包产物 gzip+base64 内联进 shared/workers-inline.generated.ts,而 gzip 头里的 MTIME 写的是构建时刻 → 同一台机器连跑两次,生成物哈希都不同;
  • 更根本的是压缩用的是 node:zlib,deflate 输出随内置 zlib 版本变化 → 本机(Node 24)与 CI(Node 20)构建出的 main.js 字节数相同但内容不同:首个差异在 offset 1,835,905,全部落在 base64 里(本地 CB43DB80…,CI 发布版 B4B4FF16…)。

审核方用哪个 Node 重建我们无法控制,所以唯一稳的做法是让构建与环境无关。

变更

文件 变更
scripts/generate-worker-inline.mjs 压缩从 node:zlib 换成纯 JS 的 fflate.gzipSync(…, { level: 9, mtime: 0 });注释写明为什么不能再回 zlib
package.json / lockfile 新增 devDependency fflate@^0.8.3(只参与构建,不进包)
shared/workers-inline.generated.ts 重新生成(INLINE_WORKER_COMPRESSION 仍是 gzip+base64,运行时解压路径不变)
shared/changelog-data.ts 新增 4.97.3 条目(并删除最旧的 4.89.0,保持 ≤12 条上限)
docs/releases/community-submission.md 新增「构建可复现」一节,记录坑与验证口径

验证

  • 生成物确定性:node scripts/generate-worker-inline.mjs 连跑两次 + 换 TMP/TEMP 再跑一次,shared/workers-inline.generated.ts 三次哈希均为 5A2AC542…63C6(350,569 字节)。
  • 构建确定性:npm run build 连跑两次,main.js 哈希均为 11472CB43488581D10E76A665A9517DA7B6DCAFCD90EAA60323688D893EC381A(6,241,484 字节)。
  • 运行时不回归:tests/unit/shared/worker-inline-compression.test.ts(6 例,含 DecompressionStream('gzip') 解压 + 语法校验 + ≥35% 压缩率)与 plugin-worker-url.test.ts(10 例)通过。
  • npx tsc --noEmit EXIT=0;npm run check:obsidian-review EXIT=0;npm run preflight EXIT=0。

影响与迁移

  • 无功能变化、无配置迁移;main.js 体积 +2,571 字节(压缩率略低于 zlib),bundle 基线已同步上调。
  • 破坏性变更:无。

未完成(明确记录)

  • 审核结论未知:需要在账号页点 Check for new releases 触发 4.97.3 的扫描。若仍是 Failed,下一轮要抓 Reviews 各段(Manifest / Releases / Source code / Build verification)的具体条目,而不是继续猜。
  • 扫描器剩余约 2,700 条 warn 级问题属长期清理,不阻断上架。

4.97.2

Choose a tag to compare

@github-actions github-actions released this 20 Nov 05:26

v4.97.2 — 通过社区审核:补上 eslint 指令说明

标签 4.97.2 · 2026-11-20 · 上一版 4.97.1

为什么发这一版

4.97.1 发布后账号页显示的是 Failed,而不是「等待审核」:Reviews 区里 4.83.1 / 4.85.0 / 4.95.0 / 4.96.0 / 4.97.1 全部 failed,也就是从 4.83 起每一版都没通过自动扫描,插件因此一直没进客户端市场清单。

按官方 Community plugin scanner configuration 复刻扫描器判据后,当前代码树里真正会阻断的只有一条规则、两处命中:

eslint-comments/require-description
  engine/agent/harness/mcp-stdio-transport.ts:31
  services/chapter-version-service.ts:57
Unexpected undescribed directive comment.

扫描器把绝大多数 eslint-plugin-obsidianmd 规则降级为 warn(warn 不阻断),真正保持 error 的只有安全类(no-eval、no-unsanitized/*、regex-lookbehind、no-forbidden-elements、no-new-func、no-implied-eval),外加最新提交层额外收紧的 settings-tab/*、no-static-styles-assignment、no-unsupported-api 等 API 规则与 eslint-comments/*。所以「本地 lint 全绿」不等于审核通过——本地 lint 里那 1721 条 error 绝大多数在扫描器里只是 warn,而本地从不检查的那条 require-description 才是真凶。

变更

文件 变更
engine/agent/harness/mcp-stdio-transport.ts // eslint-disable-next-line @typescript-eslint/no-require-imports 补 -- 说明(桌面端动态加载 child_process,移动端由 catch 降级)
services/chapter-version-service.ts // eslint-disable-next-line no-control-regex 补 -- 说明(必须显式匹配控制字符区间才能拦下伪造 contentKey)
eslint.obsidian-review.mjs 新增:复刻审核扫描器判据的 ESLint 配置(blocking 规则 error、其余按扫描器降级/关闭)
package.json 新增脚本 check:obsidian-review,并接入 preflight(紧跟 lint)
eslint-plugin-obsidianmd 新增 devDependency(审核官方插件 0.4.2)
docs/releases/community-submission.md 新增「本地复现审核扫描」一节,记录严重度分层与复现命令

为什么要把这个判据固化进 preflight

之前两版(4.97.0 / 4.97.1)都以为「等审核」,实际每一版发布即失败。把扫描器判据复刻成本地门禁后,npm run check:obsidian-review 的退出码等价于「这一版会不会被自动扫描打回」,大约 52 秒跑完,避免再用一次发版去试错。

验证

  • npx eslint --config eslint.obsidian-review.mjs . --quiet EXIT=0(0 条阻断项,全量扫描 1,037 个文件)
  • npm run preflight EXIT=0
  • npm run build + check:release:三资产齐全,版本一致

影响与迁移

  • 无功能变化、无配置迁移;只改两条注释与门禁脚本。
  • 破坏性变更:无。

未完成(明确记录)

  • 审核结论未知:本版发布后需要在账号页点 Check for new releases 触发新一轮扫描(或先用 Review branch 预览)。扫描通过后还要等后续流程进客户端市场清单。
  • 扫描器剩余的 2,746 条 warn 级问题(prefer-create-el 682、no-unused-vars 569、no-deprecated 255 等)不阻断,但属于长期清理项。

4.97.1

Choose a tag to compare

@github-actions github-actions released this 20 Nov 03:46

v4.97.1 — 社区插件目录上架准备

标签 4.97.1 · 2026-11-20 · 上一版 4.97.0

为什么发这一版

4.97.0 已经准备好功能与双语界面,但按 Obsidian 社区目录的插件上架要求,有两处必须先改:

  1. 用了 Node/Electron API 就必须声明桌面端专用。 插件有三处这类调用——后台 Worker 线程、系统级「保护元文件」(shared/desktop-shell.ts 动态 import node:child_process)、MCP 本地文件与 stdio 传输(shared/mcp-file-browse.ts 的 require('node:fs')、engine/agent/harness/mcp-stdio-transport.ts 的 require('node:child_process'))。这些路径在移动端本来就有降级,但目录要求是「只要用到就设 isDesktopOnly: true」。
  2. 描述要短、要以动作开头。 原描述是名词短语开头、204 字符,目录要求 ≤250 字符、句末带句号、不用 emoji,并建议以动作陈述开头。

这一版不改任何功能代码,只改 manifest 与文档。

变更

文件 变更
manifest.json isDesktopOnly 改为 true;description 改为 219 字符动作句;版本 4.97.1
package.json / package-lock.json / versions.json 版本同步到 4.97.1
README.md 平台说明与 FAQ 第 5 条改为「桌面端专用」;顺手修掉「界面仅简体中文」的过期说法
shared/changelog-data.ts 新增 4.97.1 条目,裁掉最旧的 4.87.0(保持 12 条上限)
docs/releases/community-submission.md 新增:上架清单与合规自检结果

影响与迁移

  • 移动端用户:本版起在移动端不可安装(Obsidian 会按 isDesktopOnly 过滤)。原有 vault 数据、设置不受影响;如需移动端,后续把三处 Node 调用改为纯 vault API 实现,再发一版恢复。
  • 桌面端用户:行为无变化,插件 ID、命令 ID、设置键名均未改动。
  • 升级方式:正常更新即可,无需迁移数据。

验证

  • npx tsc --noEmit EXIT=0
  • npm run preflight EXIT=0(1013 文件 / 10503 通过 + 3 跳过)
  • node scripts/check-release.mjs --tag 4.97.1 通过(tag 与 manifest 版本一致、release 说明存在、main.js 与两个 worker 语法正常)
  • npm run build + Release 工作流(tag 触发)产出 main.js / manifest.json / styles.css / workers

未完成(明确记录)

  • 移动端支持:需要把 MCP stdio、MCP 本地文件、系统级文件保护三处改为纯 vault API(或按平台拆包),完成后可把 isDesktopOnly 改回 false。
  • 目录上架提交本身:Obsidian 现在通过 community.obsidian.md 用 Obsidian 账号登录后提交(不再走 obsidian-releases 的 PR),需要仓库所有者本人登录完成,步骤见 community-submission.md。

4.97.0

Choose a tag to compare

@github-actions github-actions released this 20 Nov 03:07

v4.97.0 — 双语界面 + 文面体检 + 视觉重构收口

发布日期:2026-11-20 · tag:4.97.0 · 上一版本 v4.96.0(含 4.96.1 未单独发版的内容)

为什么发这一版

上一版(4.96.0)解决的是「链路断链」——数据进了表单却进不了 prompt。这一版解决的是**「看得懂、点得动、写得完」**:

  • 界面只有中文,英文用户无法使用 → 全量双语(命令面板命令名与分组名 + 设置页全部分区 + 写作主流程 + 知识库 + 全部弹窗);
  • 发布前只能靠肉眼找错别字和标点 → 内置 7 条规则的文面体检,可定位、可跳转;
  • 视觉层大面积依赖工具类与内联样式,暗色主题下按钮渲染成白底黑字 → 25 个切片(Slice A–Y)语义化,用 before/after 像素快照逐场景校正;
  • 真实点击验收(不是脚本调用)发现 14 条界面缺陷,逐条修复并复验。

新能力(功能缺口 ①–⑦)

# 能力 入口 关键实现
① 大纲扩写「应用」真正写回正文 大纲树 → 智能扩写 应用按钮按目标章节写回,不再只复制到剪贴板
② 全屏写作体检条(实时) 写作工作台顶部体检条 ui/full-writer/checkup-bar-controller.ts(288 行),段落节拍/重复/视角问题实时提示,AI 不可用时给出可读原因
③ 发布前文面体检 命令「发布前体检」 shared/manuscript-precheck.ts 纯规则引擎 7 条 / 三档严重度 + 问题列表弹窗,每行可一键跳转正文
④ 提示词管理器交付级修补 设置 → 写作 → 提示词管理器 变量校验、模板预览、A/B 状态标签
⑤ 质量统计状态清单可交互 知识库 → 质量统计 状态行可点,按状态筛选条目
⑥ 章节朗读听校(TTS) 命令「朗读当前章节」 Web Speech 逐句朗读 + 当前句高亮 + 语速/音色切换 + 播放条
⑦ 双语界面(i18n) 设置 → 外观 → 语言 t() 运行时 + zh-CN / en-US 各 6087 条资源,切换即时生效

功能清查(本轮实测,2026-11-20)

命令口径:addCommand 90 条(命令面板可见)+ 内部注册 22 条;shared/command-ids.ts 共 97 个 id,其中表内 internalOnly: true 3 条。逐项抽查命令接线(定义 / uiCommandIds / addCommand 三处齐备)。

能力域 状态 入口 说明
三域创作(长篇 / 短篇 / 剧本) 可用 创作主页三张模式卡 长篇逐章、短篇/剧本按「节 / 集」单元
完整写作工作台 可用 创作主页 → 继续写作 五阶段 11 个子步骤、项目选择器、单元写作、撤销/重做、Ctrl+S 统一
协同写作视图 可用 命令「协同写作」 2 秒自动保存、保存状态枚举、历史快照
知识库 / 设定库 可用 侧栏 / 命令「知识库」 书架、四管理弹窗、8 维拆解详情、向量对账与重向量化
质量闭环 可用 命令「质量闭环」「质量仪表盘」 六维评分、质量护栏、闭环修订;未单独做模块打磨
规划画布 / 剧情推演 可用 主页「规划画布」 节点与连线、大纲树联动
写作指纹库 可用 命令「写作指纹库」 12 维指纹、混合、详情/编辑/提取/选书四弹窗
导出与发布 可用 命令「导出成稿」 长篇/短篇/剧本、结构预检、平台包(短篇/剧本投稿信息 + 敏感词预检)、出版检查
统计 / 用量 / 备份 / 体检 可用 创作主页卡片 写作统计、用量账本、备份中心、项目体检
AI Agent 工作台 可用 命令「Agent 创作工作台」 工具目录、审批、阶段面板;MCP 服务在设置里可配
设置页 可用 设置 → 小说工坊 6 个一级分组、全部分区双语

视觉重构收口(Slice A–Y,25 个切片)

  • 25 个切片全部完成,每个切片都用 before/after 像素快照 + 结构/尺寸/样式探针验收;绝大多数场景 0 像素差,差异项均在模块文档里逐条解释(如按设计意图恢复被覆盖的按钮配色)。
  • 工具类 nw-u-* 只剩 46 个类 / 137 次引用(Slice Y 之后无存量大户),check:utility 拦截新增;内联样式按切片清零,check:inline-styles 为 474(静态 410 / 动态 64)。
  • styles.css 805,893 字节 / 4,340 个唯一类,全部走 styles-src/ 拼接,transition: all 由测试硬拦。

交互与稳定性(审计 C 清单 + 真实点击验收)

  • 防重复扣费:withButtonBusy 接入 AI 生成按钮(plan-book / ai-builder / 世界观 / 协同控制面板),双击不再触发两次付费调用。
  • 防丢改动:ModalDirtyGuard 覆盖 8 个弹窗(计划书 / 文笔风格 / 同人设定 / 黄金开篇 / 文笔蒸馏 / 模板编辑 / 书籍编辑 / 题材编辑),Esc 或点外关闭前二次确认。
  • 撤销栈共享化:shared/edit-history.ts 从协同写作抽到共享层,单元写作台获得撤销/重做(Ctrl+Z / Ctrl+Y / Ctrl+Shift+Z,800ms 节流 + 失焦强制落点)。
  • 真实点击验收 F-01–F-14 全部修复:含写作台横向溢出、窄高窗口状态栏被裁、英文阶段名、设置页开关压字与四边虚线、体检静默 401、供应商侧栏名称截断等;每条都有复验脚本与截图。
  • 启动噪音清理:按设计不注入的分析器不再报警、缺失「.sessions」目录降为 debug;干净启动仅剩「API key 无效」这一条真实告警。
  • 破坏性下线:旧正文写入链(4 条 internalOnly 命令 + 3 个隐藏弹窗)与协同写作悬浮面板已退役(详见 4.96.1 条目与迁移说明)。

验证

项 结果
npm run preflight(30+ 门禁) EXIT=0,1013 个测试文件 / 10,503 通过 + 3 跳过
check:release --tag 4.97.0 通过(tag 不带 v 前缀,与 manifest.version 一致)
check:i18n 资源 zh/en 各 6087 条;无法解析键 0;棘轮 205 文件 / 5359 条
check:css / check:bundle styles.css 805,893 字节 / 4,340 类;main.js 6,239,011 字节
真实点击验收 14 条缺陷全部修复并复验;三档窗口(1440×900 / 1280×800 / 900×680)零横向溢出
双语实机 命令面板、设置页、写作台、知识库、全部弹窗在 en-US 下零中文残留(vault 数据除外)
CI / Release 工作流 移除已退役的 check:dsh-isolation 步骤,tag 触发的 Release 流程可走通

升级说明

  • 破坏性:旧正文写入链命令(WRITE_CHAPTER / WRITE_CHAPTER_AUTO / BATCH_CHAPTERS / AUTO_WRITER)与协同写作悬浮面板已删除,正文统一走协同写作工作台 / 完整写作工作台 / 「批量生成章节」。
  • 无数据迁移:知识库索引、事实库、指纹库、台账格式均未变;4.96.1 的索引写入修复会自动生效。
  • 语言切换:设置 → 外观 → 语言,切换后界面即时刷新;命令面板命令名需重载插件(Obsidian 命令名在注册时固定),重载后为新语言。
  • 回滚建议:回退到 v4.96.0 时,已删除命令的快捷键会失效(这些命令本就不在命令面板)。

未完成(明确记录)

  • RETIRE-D1 / RETIRE-D2:ui/knowledge-detail-modal.ts 与 ui/views/book-detail-renderer.ts 的残留中文文案,按用户裁定随知识库视觉重构后续批次一并处理。
  • 剩余长任务弹窗的运行态守卫仍按批次推进(本轮先覆盖 8 个高危弹窗)。
  • 知识库详情页签横向滚动、详情大标题字号偏大:已记入模块页 backlog,不阻塞发版。
  • 规划/大纲、MCP/Agent 两个模块页仍为 review 状态(功能可用,文档待验收)。

4.96.0

Choose a tag to compare

@github-actions github-actions released this 14 Nov 10:20

v4.96.0 — 链路修复 + 设置重构

发布日期:2026-11-14 · tag:4.96.0 · 上一版本 v4.95.0

这一版解决什么

审计发现「结构化表单数据大量只流向结算/检查侧,生成 prompt 侧靠名称匹配兜底」——
用户精心填的事实库、人物卡连续性字段,根本没进写作 prompt。这一版把 8 条断链全部接上,
并让此前静默的降级全部可见。

链路修复(审计 §四 8 项)

断链 修复
事实库三元组从不进写作 prompt ✅ fact_nodes 经 context-manager → buildStoryContext 注入
人物卡连续性三字段不进主实体块 ✅ 已知信息/伤势/持有物品进 ${allChars} + snapshot injury 错位修正
台账稳定 ID/关联边不参与生成 ✅ buildLedgerIndex 传 links/relations
story_linkage.promptText 只进旧弹窗 ✅ 接进一键链路(≤1800 字预算)
entity_status dead/hidden 无过滤 ✅ 实体注入过滤(新旧双链路)
body-v4 整段丢九个注入变量 ✅ 对齐 v2
知识检索失败静默空注入 ✅ notifier + 时间线不再吞 chars=0
跨模型回退不可追溯 ✅ actualModel 回带 frontmatter + 缓存命中补齐

降级可见性(阶段3)

  • 时间线事件的「涉及人物/地点/类型」随事件进 prompt(shared/timeline-events-format)
  • 上下文硬截断 → 降级事件(此前 contextTruncated 写入后零读者)
  • 模板变量 11 处 catch 收敛到 degradation-notifier(同标签去重)
  • LLM 增强降级 → source='llm' 上报(模块级去重,避免每章弹一次)

设置信息架构

18 个平铺 tab → 6 个一级分组 + 二级 tab:
🔌 连接与模型 / ✍️ 写作与协同 / 📜 规则与一致性 / 📚 知识与拆解 / 🎨 界面与工作台 / 🗂 项目与运维。
关键词配置按用途归位:兜底词表 → 写作规则;统计词表 → 写作指纹库。

E2E 常态化

  • OBSIDIAN_PATH 默认按平台路径探测(不再每次手工传),.env.example 记录变量
  • 3 个关键路径 spec:一键生成冒烟 / 事实库视图 / 一致性审核弹窗
  • 注入链路验证 spec:真实项目 + mock AI 抓 prompt,断言事实库/人物卡字段真的进了 prompt

验证

项 结果
preflight EXIT=0(30 步,8878+ 测试)
E2E 关键路径 4 passed(3 关键路径 + 注入链路)
注入链路 事实库标记与人物卡两字段均出现在 bodyGeneration prompt

升级说明

无破坏性变更。旧事实库/人物卡缺新字段时按既有兜底路径处理。
设置项位置变化(关键词配置移入对应 tab),功能不变。

4.95.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 15:12

v4.95.0 — 词表治理收尾

发布日期:2026-11-13 · tag:4.95.0 · 上一版本 v4.94.0

这一版做了什么

关键词审查把 158 个词表按输入来源分三级后,这一版收尾:

A 类:plot-divergence 结构化优先

new PlotDivergenceEngine({
    structuredContradictions: ['世界观:无魔法', '势力:青云门已覆灭'],
})

设定一致性判定顺序改为:结构化矛盾 → 词表模式兜底。
SETTING_CONTRADICTION_PATTERNS 是正则词表,换个说法就漏;有结构化数据时不该再猜。

至此 A 类三处全部完成:

模块 结构化输入
conflict-detector lifeState / injuryLevel / 事实库等级序
logic-consistency-checker injuryLevels
plot-divergence-engine structuredContradictions

C 类:统计词表可配置

词表 设置入口
语义词表(伤情/行动/现代/地点/剧变) ✅ 5 个输入框
AI 高频词 ✅
正面/负面/高强度情绪词 ✅ 3 个输入框

用户发现某个说法没被识别时,自己加词即可,无需改代码。

定位说明:C 类只影响统计口径(情绪分布、风格画像),不影响对正文的正确性判断,
所以只做可配置,不做结构化替代。

词表治理全景

类别 处理方式 状态
A 语义判定(~5 处) 结构化字段优先 + 词表兜底 ✅ 三处核心已改
B 结构约定(多数) 我方格式规定 ✅ 无需改造
C 统计风格(~25 词表) 可配置化 ✅ 主要词表已接

门禁

preflight EXIT=0(30 步);check:prod 6/6;覆盖率无下降。

升级说明

无破坏性变更。新增设置项默认为空,不影响既有判定与统计口径。

4.94.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 14:40

v4.94.0 — 从「猜关键词」到「读结构化字段」

发布日期:2026-11-13 · tag:4.94.0 · 上一版本 v4.93.0

这一版解决什么

关键词审查发现:引擎里 158 个词表,其中 A 类「用词表判断文本含义」是最难根治的一类——
换个说法就漏报(「陨落」没在词表里),词表膨胀又带来误报。

这一版把三个 A 类模块从「词表猜」改成「读结构化字段」,词表退化为兜底。

改动一:人物状态快照结构化

interface CharacterStateBrief {
    lifeState?: 'alive' | 'dead' | 'unknown';
    injuryLevel?: 'none' | 'light' | 'severe' | 'critical' | 'unknown';
}

关键:生产方真的填值(否则就是死代码)。

gate-snapshot.parseCharacterStates 从人物块解析:

文本 结果
死亡/身亡/陨落/丧命/气绝 dead
存活/活着/健在 alive
濒死/垂危/奄奄一息 critical
重伤/断臂/吐血/昏迷 severe
轻伤/擦伤 light
解析不出 unknown(回退词表)

改动二:检测器结构化优先

conflict-detector 判定顺序:

① 结构化覆盖(lifeState='dead' / injuryLevel∈{severe,critical})→ 不报
② 有铺垫迹象(emotion/injury 非空)→ 不报
③ 能力变化 → 事实库等级序(adviseAbility)
④ 都不满足 → 词表兜底报出

logic-consistency-checker:

analyzeLogicConsistency(body, { injuryLevels: { 宁缺: 'severe' } })

词表没提「重伤」也能报——只要快照说这人重伤、本段又做高强度动作。

改动三:语义关键词可配置化

设置界面新增「🧩 语义关键词(追加)」:

字段 用途
伤情词 「气若游丝」「断魂」
行动词 高强度动作
现代词 时代错位
地点词 场景锚点
剧变词 死亡/重伤/能力变化

逗号分隔、保存即生效、与内置词去重合并。用户不必改代码。

设计约束(写入模块注释)

判定顺序必须是:结构化字段 → 词表兜底 → 不判定
词表不是主判据

测试

本轮新增 13 条:

  • 结构化优先 4 条(dead 抑制 / severe 抑制 / unknown 仍兜底 / alive 仍报)
  • 逻辑检查器 4 条(结构化重伤不靠词表也报 / 结构化未受伤仍按词表 / 无信息按词表 / 追加词生效)
  • 词表解析 5 条(无追加等于内置 / 追加生效 / 剧变词进每组 / 去重 / 空追加不变)

门禁

preflight EXIT=0(30 步);check:prod 6/6;覆盖率无下降。

升级说明

无破坏性变更。快照无结构化字段时(旧项目/未解析出)自动回退词表,行为与 v4.93.0 一致。
设置里的追加词默认为空,不影响既有判定。

4.93.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 13:58

v4.93.0 — 拆解补维度 + 语义词表注册表

发布日期:2026-11-13 · tag:4.93.0 · 上一版本 v4.92.0

这一版解决什么

v4.92.0 把谓词压成枚举,换来可确定比对;但 100→200 章规模评测暴露了两类新问题:

问题 实例
同一事件内不同里程碑被误判矛盾 「十三岁开悟」vs「三十岁才进不惑」
抽取归属错误 「你虽然才不惑…」(对六师兄说的)被归成宁缺 40 岁
边界值与精确值混比 「未满二十」vs「十八」被判 20→18 倒退

改动一:拆解产物补维度

slot 子维度

{ "subject": "大师兄", "predicate": "年龄", "slot": "开悟年龄", "value": "十三" }
  • 同一主体的不同侧面用不同 slot(当前年龄 / 开悟年龄 / 职务身份…)
  • R1 按 (主体, slot) 分组、R2 按 (主体, slot, 章节) 分组
  • 唯一 slot 数 2396(3258 条事实),说明维度确实被用起来了

归属约束

prompt 明确:只抽取关于 subject 本人的事实。
对别人说的话、成语/比喻式表达、他人的情况,都不抽成本人的事实。

精确值守卫

未满 / 不到 / 将近 / 约 / 左右 / 上下… 等边界值不参与「倒退/不相容」比较。

改动二:A 类语义词表统一注册表

关键词审查发现 47 个文件、158 个词表。按输入来源分三级后,只有 A 类
(用词表判断自由文本含义)必须改造。

新增 shared/semantic-keywords.ts:

导出 用途
DRASTIC_CHANGE_GROUPS 死亡/重伤/能力变化
INJURY_WORDS / ACTION_WORDS / MODERN_WORDS / LOCATION_WORDS 各类语义词表
KEYWORD_FALLBACK_SOURCE 告警标注「词表兜底命中」
mergeKeywordOverrides 合并用户扩展词(去重)
findKeywordHits 返回命中词,告警可展示证据

设计约束(写入模块注释):判定顺序必须是
结构化字段 → 词表兜底 → 不判定。词表不是主判据。

conflict-detector 与 logic-consistency-checker 已迁移。

评测:200 章真实数据

指标 改造前 改造后
事实条数 3354 3258
真实数据误报 2 0
注入矛盾召回 假低值 2/10 10/10 = 100%
合法变化误报 0/10 0/10
成本 ¥2.53 ¥2.42

完整演化(同一份 200 章数据)

阶段 误报 召回
自由谓词(100 章) 0 7/7
规范谓词(100 章) 427 → 21 9/10
+ event 事件锚 0 8/8
规范谓词(200 章) 3 —
+ 精确值守卫 2 —
+ slot 子维度 0 10/10

规律:每一次"压成枚举"都会丢一个维度,必须显式补回来。
谓词压成枚举 → 丢事件区分 → 加 event;
谓词压成枚举 → 丢侧面区分 → 加 slot。

成本

项 值
200 章拆解 ¥2.42(约 ¥0.012/章)
折算 400 章 约 ¥4.8

升级说明

无破坏性变更。旧事实库无 slot 字段时按谓词兜底,行为与 v4.92.0 一致。
shared/semantic-keywords 是新增模块,词表内容与原先内联常量一致。

4.92.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 12:47

v4.92.0 — 拆解结构化:从「猜关键词」到「读字段」

发布日期:2026-11-13 · tag:4.92.0 · 上一版本 v4.91.0

为什么发这一版

v4.91.0 的规则层靠关键词匹配判断谓词。这在真实长篇上暴露了两种 bug:

  • 严格等值 === '年龄' → LLM 给「年龄约」「年纪」时整类漏报
  • 包含匹配 includes('年龄') → 「被提亲起始年龄」这类回溯叙述被当当前状态,产生假矛盾

修一个引入另一个,是死循环。这一版从拆解产物下手,让规则层不再猜。

核心改动:拆解产物结构化

字段 作用
predicate 规范枚举 年龄 / 位置 / 持有 / 能力 / 关系 / 时间 / 规则 / 认知 / 记忆
isCurrentState 当前状态 true;回溯/回忆(「我那年才四岁」)false
event 事件锚 这条事实属于哪个事件(「渭城春雨」「宁缺入楼」)

解析侧强制归一化:模型给自由谓词也映射到枚举值。

规则层:统一匹配器 + 按事件分组

matchesPredicate(predicate, 'age')   // 唯一入口
  • 前缀锚定(不是包含):「年龄约」✅ /「被提亲起始年龄」❌
  • 别名表:每概念列全变体
  • 回溯限定词排除:起始/当年/曾/之前/旧称/少时…
  • R5 改为按 event 分组:修复同一主体的不同事件被判时长矛盾

三个真实案例(都已核对原文)

案例 原文 修复前 修复后
桑桑 11岁→8岁 「桑桑才八岁的时候你就开始提亲」 假矛盾 排除(回溯)
宁缺 16岁→4岁 「我那年才四岁」 假矛盾 current=false
宁缺 入楼17日 vs 苦求10年 两个不同事件 假矛盾 按 event 分组不报

评测:三组同 100 章真实数据

组 prompt 事实数 真实误报 有效召回 成本
A 旧 自由谓词 1576 0 7/7 ¥1.03
B 新 规范谓词 1656 427 → 21 9/10 ¥1.11
C 新+event 结构化 1622 0 8/8 = 100% ¥1.25

B 组 427 条误报的因果链(本版最值钱的教训):

规范谓词 → 时间类全归一为「时间」
        → R5 按 (主体,谓词) 分组
        → 同一主体的不同事件混在一起比
        → 427 条假矛盾
加 event 事件锚 → R5 按事件分组 → 0 条

规范化不是免费的:把自由文本压成枚举会丢掉"天然区分度",
必须补回被丢掉的维度,否则规则层失去分组依据。

其他

  • 项目标准接入体检视图:体检弹窗新增「📐 项目标准」区块
    (标准版本 / 目录数 / 分类汇总 / 逐条修法),结构问题与章节问题并列展示
  • R5 守卫:时长比较要求 numericValue > 0 且单位为时长单位

成本

项 值
单章拆解 约 ¥0.012(200 章约 ¥2.49)
100 章实测 ¥1.25

升级说明

无破坏性变更。

  • 旧事实库没有 isCurrentState / event 时,规则自动回退到引文启发式与按主体分组,行为与升级前一致
  • 新拆解的事实才带新字段
  • 项目标准校验只读,不修改用户文件

4.91.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 11:13

v4.91.0 — 项目标准约束 + 事实库可编辑 + 长篇评测

发布日期:2026-11-13 · tag:4.91.0 · 上一版本 v4.90.0

为什么发这一版

v4.90.0 让事实库「自动维护 + 可浏览 + 三处第二意见」。但它还有两个缺口:
项目结构没有标准可依、事实库只能看不能改;而"这些能力在真实作品上到底靠不靠谱"
也从未被系统测量过。

这一版补齐三件事:项目标准约束、事实库编辑、长篇端到端评测。

新增:项目化标准约束

单一标准源

12 个必备目录(01-世界架构/{人物,势力,地点,物品}、02-时间线与伏笔、
03-大纲与章节/{正文,分卷大纲}、04-项目总控/{剧情记忆,故事台账} 等)、
必备文件(.project)、命名规范、标准版本号。

运行时实现只在 scripts/lib/project-standard-lib.mjs 一处,
TS 侧(shared/project-standard.ts)只是类型门面——避免两套标准并存。

7 类结构校验

类型 严重度
缺必备目录 / 缺必备文件 error
事实库损坏 error
命名不符 / 摘要缺失 / 事实库版本缺失 / 标准落后 warning

摘要缺失这条直接对应历史踩坑:没有章节摘要的项目跑审核会得到 0 产出,
用户会误以为"没问题"。

门禁与手册

node scripts/check-project-standard.mjs [--vault <path>] [--json]

退出码 0/1/2;vault 内没有项目不算失败(新库/纯素材库属正常)。
手册见 docs/handbook/07-project-standard.md。

新增:事实库视图内编辑

操作 说明
改值 / 改有效区间 行内编辑
标记忽略 保留事实与引文,但排除出第二意见
删除 误抽的条目直接删

写入前整批校验:空主体/空谓词/空值/区间倒置/置信度越界一律拒绝,
失败弹提示说明原因,绝不静默丢弃用户编辑。

新增:能力等级序第二意见

修为/能力天然是合法变化(练气三层 → 筑基一层是进阶)。按字符串比较会全是误报。

境界 rank×100 + 层数:练气三层=1003、筑基一层=2001
筑基一层 > 练气九层(跨境界优先于层数)
新序数 ≥ 旧 → 不报(合法进阶)
新序数 < 旧 → 报(倒退需要理由)
无法解析 → 不猜

已接入正文生成后的质量验收链路(真实生产调用方)。

新增:长篇端到端评测

数据源:《将夜》前 30 章真实拆解事实 456 条(复用已有数据,不额外产生 LLM 费用)。

指标 结果
真实数据误报 0 / 456 条
合法变化误报 0 / 10(能力进阶)
当前年龄类注入召回 2 / 2 = 100%

评测中发现并修复的真实缺陷:R1 年龄规则

阶段 问题 修法
首轮 谓词要求恰好 === '年龄',LLM 的「年龄约」「年纪」变体整类漏报 改为包含匹配
二轮 包含匹配吞进回溯限定谓词,产生假矛盾 改为前缀锚定

被排除的回溯谓词实例(已核对原文):

第6章「桑桑才八岁的时候你就开始提亲」
  → LLM 抽成「被提亲起始年龄=八岁」(抽取没错)
  → 但这是回溯叙述,不是当前年龄 → 不应参与「11岁→8岁」比对

教训:中文谓词限定词常前置于核心名词(被提亲起始年龄 / 请求远嫁时年龄 / 入初境年龄),
包含匹配会吞进局部语义,前缀锚定才是正确边界。

测试与门禁

  • 本轮新增测试 100+ 条:项目标准 20 / 事实编辑 25 / 视图行为 3 /
    能力等级序 15 / 剧变接线 3 / R1 谓词 8 …
  • preflight 30 步 EXIT=0;check:prod 6/6
  • 覆盖率无下降

升级说明

无破坏性变更。事实库为空或不可用时,所有第二意见返回「不干预」,行为与升级前一致。
项目标准校验只读报告,不会修改用户文件。