Repository navigation
Releases
4.97.3
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 --noEmitEXIT=0;npm run check:obsidian-reviewEXIT=0;npm run preflightEXIT=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
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 . --quietEXIT=0(0 条阻断项,全量扫描 1,037 个文件)npm run preflightEXIT=0npm run build+check:release:三资产齐全,版本一致
影响与迁移
- 无功能变化、无配置迁移;只改两条注释与门禁脚本。
- 破坏性变更:无。
未完成(明确记录)
- 审核结论未知:本版发布后需要在账号页点
Check for new releases触发新一轮扫描(或先用Review branch预览)。扫描通过后还要等后续流程进客户端市场清单。 - 扫描器剩余的 2,746 条 warn 级问题(
prefer-create-el682、no-unused-vars569、no-deprecated255 等)不阻断,但属于长期清理项。
4.97.1
v4.97.1 — 社区插件目录上架准备
标签
4.97.1· 2026-11-20 · 上一版 4.97.0
为什么发这一版
4.97.0 已经准备好功能与双语界面,但按 Obsidian 社区目录的插件上架要求,有两处必须先改:
- 用了 Node/Electron API 就必须声明桌面端专用。 插件有三处这类调用——后台 Worker 线程、系统级「保护元文件」(
shared/desktop-shell.ts动态 importnode: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」。 - 描述要短、要以动作开头。 原描述是名词短语开头、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 --noEmitEXIT=0npm run preflightEXIT=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
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.css805,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
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
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
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
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
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
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 … preflight30 步 EXIT=0;check:prod6/6- 覆盖率无下降
升级说明
无破坏性变更。事实库为空或不可用时,所有第二意见返回「不干预」,行为与升级前一致。
项目标准校验只读报告,不会修改用户文件。