知识库古诗文和日积月累更新

.vscode/秒过知识库更新/2026年秋季更新结果.md

@@ -74,3 +74,8 @@
 - MiaoguoLiteracy 补录报告：`miaoguo_literacy_apply_report_2026_fall.json`
 - MiaoguoLiteracy 补录后审计：`miaoguo_literacy_post_apply_audit_2026_fall.json`
 
+## 后续补充：六册古诗文与日积月累
+
+2026-09-03 已继续完成一年级上至六年级上的古诗文、现代背诵课文和日积月累更新：新增 17 条、迁移 7 条、脱册保留 9 条、删除 0 条。12 本目标书及 3 本供体书的 `UnitNum/WordNum` 已按最终实际行数校准，提交后独立审计与幂等 dry-run 均通过。
+
+详细逐项结果见 `古诗文与日积月累更新结果_2026年秋.md`；写入前备份为 `backups/before_ancient_daily_2026_fall_2026-09-03T06-25-28-871Z.json`。

.vscode/秒过知识库更新/README.md

@@ -1,10 +1,10 @@
 # 秒过知识库更新维护手册
 
-本目录用于每年 2 月、9 月教材改版后的秒过知识库维护。目标是：只需放入新版教材图片、整理两份源数据、依次运行 dry-run、apply、audit，即可完成更新并留下可追溯记录。
+本目录用于每年 2 月、9 月教材改版后的秒过知识库维护。目标是：只需放入新版教材图片、整理结构化源数据、依次运行 dry-run、apply、audit，即可完成更新并留下可追溯记录。
 
 ## 一、不可违反的规则
 
-1. 语文 `HanziUnit` **禁止 DELETE**，只能 `UPDATE` 旧行或 `INSERT` 新行。旧 `ID` 可能已被历史试题或用户数据引用。
+1. 语文 `HanziUnit`、`AncientPoetry` **禁止 DELETE**，只能 `UPDATE` 旧行或 `INSERT` 新行。旧 `ID` 可能已被历史试题或用户数据引用。
 2. 英语 `Words` 允许按目标 `BookID` 删除后重建，但必须先备份，并且所有写入都必须在事务中完成。
 3. 每一本更新后，都要同步校准 `MiaoguoBook.UnitNum`、`MiaoguoBook.WordNum`。
 4. 识字表的蓝色多音字也要写入 `HanziUnit.Example`，并计入 `WordNum`。
@@ -21,6 +21,8 @@
 | 语文写字表 | 1～12 | HanziUnit | HanziBookID=BookIDOld | UnitType、Name、Example、OrderID |
 | 语文词语表 | 33～42 | HanziUnit | HanziBookID=BookIDOld | UnitType、Name、Example、OrderID |
 | 语文识字表 | 43～52 | HanziUnit | HanziBookID=BookIDOld | UnitType、Name、Example、OrderID |
+| 语文古诗文 | 13～30 | AncientPoetry | HanziBookID=BookIDOld | Sort、Category、Tag、Title、Author、Dynasty、PeomContent |
+| 语文日积月累 | 54～65 | AncientPoetry | HanziBookID=BookIDOld | Sort、Category、Tag、Title、Author、Dynasty、PeomContent |
 | 英语单词表 | 285～292、301～305 | Words | BookID=BookIDOld | Word、LessonID、LessonName、Soundmark、Translate、Sort |
 | 英语常用表达法 | 293～300 | Words | BookID=BookIDOld | Word、LessonID、LessonName、Translate、Sort |
 
@@ -36,6 +38,18 @@
 - 识字表要分别记录教材标注的普通识字数、蓝色多音字数；两者之和必须等于 `wordNum`。
 - 多次出现的 `语文园地` 保持同名，依靠数组位置最终生成 `OrderID=1..N`。
 
+#### 古诗文与日积月累
+
+- 每册图片通常依次为：目录、识字表、写字表、词语表、日积月累、古诗文/背诵课文。目录用于核对课文名单；凡图片中有“日积月累”字样的页面归入日积月累。
+- 古诗文范围不只包括古诗和小古文，还包括教材明确要求背诵的现代课文。只录指定背诵范围；部分自然段背诵时，标题统一加“（节选）”。
+- 现代文 `PeomContent` 按自然段保存为 JSON 数组，`Translation` 留空；作者在教材脚注中明确给出时写入 `Author`。
+- 日积月累中的诗词使用 `Category=0`；成语、名言、儿歌、常识等使用 `Category=1`，并沿用现有挖空 `Title` 和完整答案 `PeomContent` 的结构。
+- `PeomContent` 字段名是历史拼写，不能擅自改成 `PoemContent`。写入前必须验证其为合法 JSON，且不超过字段长度。
+- 同一首经典古诗文不重复新增。先按标题搜索整张 `AncientPoetry`：找到唯一旧记录就迁移原 `ID`，同时更新 `HanziBookID/Sort/Tag`；找不到才新增。
+- 新版中已取消、又没有明确新归属的旧记录不删除，改为 `HanziBookID=0` 脱册并保留正文。迁出、迁入和脱册都会影响关联书的实际行数。
+- `Sort` 在每本书内统一从 `0` 连续到 `N-1`。来源图片重复时按同一内容去重，不生成重复行。
+- `MiaoguoBook.WordNum` 按该 `BookIDOld` 最终实际 `AncientPoetry` 行数设置；经典内容从别册迁入时，供体书的 `WordNum` 也必须同步调整。
+
 ### 英语
 
 - 教材图 01～08 是单词表，09～14 是常用表达法；页码和星号不写入数据库。
@@ -80,6 +94,23 @@ node .vscode/秒过知识库更新/update_knowledge_base_2026_fall.mjs --audit
 
 7. 人工复核报告，并至少抽查每套数据的首行、末行、`语文园地`、英语每单元首末词。
 
+### 古诗文与日积月累标准命令
+
+后续批次复制源文件和脚本并修改年份、图片范围及书籍映射：
+
+```bash
+# 只读预检：校验最终名单、迁移、脱册、行数和元数据
+node .vscode/秒过知识库更新/update_ancient_daily_2026_fall.mjs --dry-run
+
+# 生成完整备份后，在单个事务中更新并做提交前审计
+node .vscode/秒过知识库更新/update_ancient_daily_2026_fall.mjs --apply
+
+# 事务提交后的独立审计
+node .vscode/秒过知识库更新/update_ancient_daily_2026_fall.mjs --audit
+```
+
+`--apply` 必须保证：没有 `DELETE`；所有来源条目逐字段匹配；每册 `Sort=0..N-1`；脱册记录的 `HanziBookID=0`；目标书和供体书的 `WordNum` 等于实际行数。执行后再次运行 `--dry-run`，应得到全部变更计数为 0，以证明脚本可幂等复跑。
+
 ## 五、程序的语文 ID 保留策略
 
 对于每本语文书，程序按以下优先级映射新版单元：
@@ -91,6 +122,14 @@ node .vscode/秒过知识库更新/update_knowledge_base_2026_fall.mjs --audit
 
 所有复用的旧行保留原 `ID` 和原 `IsLocked`。新增行默认 `IsLocked=1`。所有目标行都重新写入连续的 `OrderID=1..N`。
 
+### AncientPoetry 的 ID 保留策略
+
+1. 最终清单中的同一旧内容按 `AncientPoetry.ID` 更新，保留原主键。
+2. 经典内容已在别册存在时迁移该旧行，不能复制出同名第二行。
+3. 新增现代背诵课文或全库不存在的内容才使用 `INSERT`。
+4. 新版取消的旧内容改 `HanziBookID=0`，禁止 `DELETE`，其他正文信息继续保留。
+5. 每册所有最终行都重写连续的 `Sort=0..N-1`，不能依赖自增 ID 或旧数据中大量相同的 `Sort=0`。
+
 ## 六、检查项和判定标准
 
 - JSON 可以解析，且数据集、书籍 ID 没有重复。
@@ -102,6 +141,8 @@ node .vscode/秒过知识库更新/update_knowledge_base_2026_fall.mjs --audit
 - 英语更新后逐行 `Word/LessonID/LessonName/Soundmark/Translate/Sort` 与源文件完全一致，未提供字段仍为 `NULL`。
 - 所有 `MiaoguoBook.UnitNum/WordNum` 与最终数据一致。
 - 备份中的所有语文旧 `HanziUnit.ID` 在更新后仍然存在。
+- 古诗文与日积月累最终行数、标题、Category、Tag、Sort 与源数据一致，所有 `PeomContent` 均为合法 JSON。
+- 古诗文与日积月累的迁移行保留原 ID；脱册行仍存在且 `HanziBookID=0`；供体书 `WordNum` 与迁出后的实际行数一致。
 
 ## 七、备份与异常恢复
 
@@ -151,6 +192,10 @@ node .vscode/秒过知识库更新/update_miaoguo_literacy_2026_fall.mjs --audit
 - `语文园地` 同名是正确数据，不要为“唯一”而擅自编号。
 - 英语复合词的音标可能只标在其中一部分，必须忠实保存教材给出的内容，不补写推测音标。
 - 图片 OCR 只能辅助，最终必须逐页核对专名、音标、过去式和标点。
+- 目录只能帮助核对古诗文课目，不能代替“背诵课文”要求；现代文必须查看课后题，确认是全文还是指定自然段。
+- 日积月累不能只看目录，必须逐张查找图片中的“日积月累”标题。图片缺页或重复页要在清单中明确记录。
+- 跨册迁移经典内容时，不能只更新目标书：供体书的实际行数和 `MiaoguoBook.WordNum` 也会减少。
+- 古诗文 `Sort` 历史数据常全部为 0；必须按本批次最终清单重新生成连续值。
 - `MiaoguoLiteracy` 同一个词可能同时有 `zici` 和 `list` 等记录；低优先级 `list` 没有 `CHN` 不一定影响词语题，必须按线上查询排序判断真正选中的记录。
 - 任务目录可能包含真实数据库备份，提交或外发前先确认仓库的数据安全策略。
 
@@ -171,5 +216,10 @@ node .vscode/秒过知识库更新/update_miaoguo_literacy_2026_fall.mjs --audit
 - `miaoguo_literacy_apply_report_2026_fall.json`：补录 ID、完整 JSONString、事务前后审计和备份位置。
 - `miaoguo_literacy_post_apply_audit_2026_fall.json`：补录后的独立审计报告。
 - `MiaoguoLiteracy补录结果_2026年秋季.md`：20 条补录词语的人工复核表。
+- `source_ancient_daily_2026_fall.json`：六册古诗文、现代背诵课文和日积月累的最终结构化源数据。
+- `update_ancient_daily_2026_fall.mjs`：古诗文/日积月累的校验、迁移、脱册、备份、事务更新和审计程序。
+- `dry_run_ancient_daily_2026_fall.json`、`apply_ancient_daily_2026_fall.json`、`audit_ancient_daily_2026_fall.json`：对应的预检、执行和独立审计报告。
+- `research_ocr_2026_fall.json`、`research_db_snapshot_2026_fall.json`：本次只读调研的 OCR 与数据库快照。
+- `古诗文与日积月累调研清单_2026年秋.md`、`古诗文与日积月累更新结果_2026年秋.md`：人工确认清单和最终结果。
 - `2026年秋季更新结果.md`：便于人工复核的最终清单。
 - `backups/`：每次执行前的数据库完整备份。

.vscode/秒过知识库更新/audit_ancient_daily_2026_fall.json

@@ -0,0 +1,741 @@
+{
+  "generatedAt": "2026-09-03T06:28:11.125Z",
+  "sourceVersion": "2026-fall",
+  "ok": true,
+  "failures": [],
+  "books": [
+    {
+      "miaoguoBookId": 13,
+      "bookIdOld": 25,
+      "label": "一年级上",
+      "type": "ancient",
+      "rows": 8,
+      "checked": [
+        {
+          "id": 275,
+          "sort": 0,
+          "title": "金木水火土"
+        },
+        {
+          "id": 2,
+          "sort": 1,
+          "title": "江南"
+        },
+        {
+          "id": 276,
+          "sort": 2,
+          "title": "雪地里的小画家"
+        },
+        {
+          "id": 277,
+          "sort": 3,
+          "title": "对韵歌"
+        },
+        {
+          "id": 278,
+          "sort": 4,
+          "title": "升国旗"
+        },
+        {
+          "id": 279,
+          "sort": 5,
+          "title": "小小的船"
+        },
+        {
+          "id": 280,
+          "sort": 6,
+          "title": "两件宝"
+        },
+        {
+          "id": 281,
+          "sort": 7,
+          "title": "比尾巴"
+        }
+      ]
+    },
+    {
+      "miaoguoBookId": 15,
+      "bookIdOld": 27,
+      "label": "二年级上",
+      "type": "ancient",
+      "rows": 7,
+      "checked": [
+        {
+          "id": 16,
+          "sort": 0,
+          "title": "登鹳雀楼"
+        },
+        {
+          "id": 17,
+          "sort": 1,
+          "title": "望庐山瀑布"
+        },
+        {
+          "id": 18,
+          "sort": 2,
+          "title": "江雪"
+        },
+        {
+          "id": 20,
+          "sort": 3,
+          "title": "敕勒歌"
+        },
+        {
+          "id": 282,
+          "sort": 4,
+          "title": "田家四季歌"
+        },
+        {
+          "id": 283,
+          "sort": 5,
+          "title": "树之歌"
+        },
+        {
+          "id": 284,
+          "sort": 6,
+          "title": "日月潭（节选）"
+        }
+      ]
+    },
+    {
+      "miaoguoBookId": 17,
+      "bookIdOld": 29,
+      "label": "三年级上",
+      "type": "ancient",
+      "rows": 9,
+      "checked": [
+        {
+          "id": 34,
+          "sort": 0,
+          "title": "望洞庭"
+        },
+        {
+          "id": 29,
+          "sort": 1,
+          "title": "山行"
+        },
+        {
+          "id": 31,
+          "sort": 2,
+          "title": "夜书所见"
+        },
+        {
+          "id": 49,
+          "sort": 3,
+          "title": "鹿柴"
+        },
+        {
+          "id": 32,
+          "sort": 4,
+          "title": "望天门山"
+        },
+        {
+          "id": 33,
+          "sort": 5,
+          "title": "饮湖上初晴后雨"
+        },
+        {
+          "id": 37,
+          "sort": 6,
+          "title": "司马光"
+        },
+        {
+          "id": 285,
+          "sort": 7,
+          "title": "秋天的雨（节选）"
+        },
+        {
+          "id": 286,
+          "sort": 8,
+          "title": "大自然的声音（节选）"
+        }
+      ]
+    },
+    {
+      "miaoguoBookId": 19,
+      "bookIdOld": 31,
+      "label": "四年级上",
+      "type": "ancient",
+      "rows": 9,
+      "checked": [
+        {
+          "id": 50,
+          "sort": 0,
+          "title": "暮江吟"
+        },
+        {
+          "id": 51,
+          "sort": 1,
+          "title": "题西林壁"
+        },
+        {
+          "id": 52,
+          "sort": 2,
+          "title": "雪梅"
+        },
+        {
+          "id": 53,
+          "sort": 3,
+          "title": "精卫填海"
+        },
+        {
+          "id": 56,
+          "sort": 4,
+          "title": "凉州词"
+        },
+        {
+          "id": 55,
+          "sort": 5,
+          "title": "出塞"
+        },
+        {
+          "id": 57,
+          "sort": 6,
+          "title": "夏日绝句"
+        },
+        {
+          "id": 59,
+          "sort": 7,
+          "title": "王戎不取道旁李"
+        },
+        {
+          "id": 287,
+          "sort": 8,
+          "title": "观潮（节选）"
+        }
+      ]
+    },
+    {
+      "miaoguoBookId": 21,
+      "bookIdOld": 33,
+      "label": "五年级上",
+      "type": "ancient",
+      "rows": 10,
+      "checked": [
+        {
+          "id": 73,
+          "sort": 0,
+          "title": "示儿"
+        },
+        {
+          "id": 74,
+          "sort": 1,
+          "title": "题临安邸"
+        },
+        {
+          "id": 75,
+          "sort": 2,
+          "title": "己亥杂诗"
+        },
+        {
+          "id": 76,
+          "sort": 3,
+          "title": "少年中国说（节选）"
+        },
+        {
+          "id": 77,
+          "sort": 4,
+          "title": "山居秋暝"
+        },
+        {
+          "id": 78,
+          "sort": 5,
+          "title": "枫桥夜泊"
+        },
+        {
+          "id": 123,
+          "sort": 6,
+          "title": "早春呈水部张十八员外"
+        },
+        {
+          "id": 81,
+          "sort": 7,
+          "title": "敏而好学"
+        },
+        {
+          "id": 82,
+          "sort": 8,
+          "title": "读书有三到"
+        },
+        {
+          "id": 288,
+          "sort": 9,
+          "title": "白鹭"
+        }
+      ]
+    },
+    {
+      "miaoguoBookId": 23,
+      "bookIdOld": 35,
+      "label": "六年级上",
+      "type": "ancient",
+      "rows": 10,
+      "checked": [
+        {
+          "id": 99,
+          "sort": 0,
+          "title": "宿建德江"
+        },
+        {
+          "id": 100,
+          "sort": 1,
+          "title": "六月二十七日望湖楼醉书"
+        },
+        {
+          "id": 101,
+          "sort": 2,
+          "title": "西江月·夜行黄沙道中"
+        },
+        {
+          "id": 103,
+          "sort": 3,
+          "title": "七律·长征"
+        },
+        {
+          "id": 106,
+          "sort": 4,
+          "title": "浪淘沙（其一）"
+        },
+        {
+          "id": 107,
+          "sort": 5,
+          "title": "江南春"
+        },
+        {
+          "id": 108,
+          "sort": 6,
+          "title": "书湖阴先生壁"
+        },
+        {
+          "id": 119,
+          "sort": 7,
+          "title": "两小儿辩日"
+        },
+        {
+          "id": 289,
+          "sort": 8,
+          "title": "曹冲称象"
+        },
+        {
+          "id": 290,
+          "sort": 9,
+          "title": "少年闰土（节选）"
+        }
+      ]
+    },
+    {
+      "miaoguoBookId": 54,
+      "bookIdOld": 74,
+      "label": "一年级上",
+      "type": "daily",
+      "rows": 8,
+      "checked": [
+        {
+          "id": 1,
+          "sort": 0,
+          "title": "咏鹅"
+        },
+        {
+          "id": 3,
+          "sort": 1,
+          "title": "画"
+        },
+        {
+          "id": 266,
+          "sort": 2,
+          "title": "一模____ 一心____ 独一____\n十全____ 五颜____ 三头____"
+        },
+        {
+          "id": 4,
+          "sort": 3,
+          "title": "悯农（其二）"
+        },
+        {
+          "id": 240,
+          "sort": 4,
+          "title": "一年_______，一日_______。\n一寸_______，寸金_______。"
+        },
+        {
+          "id": 5,
+          "sort": 5,
+          "title": "古朗月行（节选）"
+        },
+        {
+          "id": 241,
+          "sort": 6,
+          "title": "种_______，种_______。\n前_______，后_______。\n千_______，始_______。\n百_______，更_______。"
+        },
+        {
+          "id": 6,
+          "sort": 7,
+          "title": "风"
+        }
+      ]
+    },
+    {
+      "miaoguoBookId": 56,
+      "bookIdOld": 76,
+      "label": "二年级上",
+      "type": "daily",
+      "rows": 8,
+      "checked": [
+        {
+          "id": 14,
+          "sort": 0,
+          "title": "梅花"
+        },
+        {
+          "id": 224,
+          "sort": 1,
+          "title": "数九歌"
+        },
+        {
+          "id": 15,
+          "sort": 2,
+          "title": "小儿垂钓"
+        },
+        {
+          "id": 222,
+          "sort": 3,
+          "title": "有_______,无_______ \n白_______,杏_______ \n清_______,近_______ \n雾_______,天_______"
+        },
+        {
+          "id": 225,
+          "sort": 4,
+          "title": "黑_______，白_______。\n一_______，一_______。\n书_______，学_______。"
+        },
+        {
+          "id": 223,
+          "sort": 5,
+          "title": "有_______ ——《后汉书》\n志_______ ——诸葛亮\n穷_______ ——王勃"
+        },
+        {
+          "id": 19,
+          "sort": 6,
+          "title": "夜宿山寺"
+        },
+        {
+          "id": 221,
+          "sort": 7,
+          "title": "己_______ ——《论语》\n与_______ ——《论语》\n不_______ ——《孟子》"
+        }
+      ]
+    },
+    {
+      "miaoguoBookId": 58,
+      "bookIdOld": 78,
+      "label": "三年级上",
+      "type": "daily",
+      "rows": 7,
+      "checked": [
+        {
+          "id": 28,
+          "sort": 0,
+          "title": "所见"
+        },
+        {
+          "id": 27,
+          "sort": 1,
+          "title": "舟夜书所见"
+        },
+        {
+          "id": 228,
+          "sort": 2,
+          "title": "不_______ ——《论语》\n爱_______ ——《墨子》\n仁_______ ——《孟子》\n与_______ ——《荀子》"
+        },
+        {
+          "id": 242,
+          "sort": 3,
+          "title": "人_______，泰_______。  二_______，其_______。  三_______，顶_______。"
+        },
+        {
+          "id": 35,
+          "sort": 4,
+          "title": "早发白帝城"
+        },
+        {
+          "id": 36,
+          "sort": 5,
+          "title": "采莲曲"
+        },
+        {
+          "id": 267,
+          "sort": 6,
+          "title": "士_______，任_______。——《论语》\n志_______，言_______。——《墨子》\n锲_______，朽_______；锲_______，金_______。——《荀子》"
+        }
+      ]
+    },
+    {
+      "miaoguoBookId": 60,
+      "bookIdOld": 80,
+      "label": "四年级上",
+      "type": "daily",
+      "rows": 7,
+      "checked": [
+        {
+          "id": 30,
+          "sort": 0,
+          "title": "赠刘景文"
+        },
+        {
+          "id": 229,
+          "sort": 1,
+          "title": "博_______ ——《中庸》\n智_______ ——王充\n人_______ ——韩愈\n善_______ ——方以智"
+        },
+        {
+          "id": 230,
+          "sort": 2,
+          "title": "立_______，_______\n二_______，_______\n夏_______，_______\n八_______，雁_______\n一_______，十_______\n八_______，十_______"
+        },
+        {
+          "id": 54,
+          "sort": 3,
+          "title": "嫦娥"
+        },
+        {
+          "id": 94,
+          "sort": 4,
+          "title": "黄鹤楼送孟浩然之广陵"
+        },
+        {
+          "id": 231,
+          "sort": 5,
+          "title": "尺_______，_______。\n仁_______，_______。\n机_______，_______。\n差_______，_______。\n一_______，_______。\n知_______，_______。"
+        },
+        {
+          "id": 58,
+          "sort": 6,
+          "title": "别董大"
+        }
+      ]
+    },
+    {
+      "miaoguoBookId": 62,
+      "bookIdOld": 82,
+      "label": "五年级上",
+      "type": "daily",
+      "rows": 7,
+      "checked": [
+        {
+          "id": 291,
+          "sort": 0,
+          "title": "卧_______ 龙_______ 龙_______ 凤_______\n如_______ 如_______ 鹤_______ 一_______\n鼠_______ 抱_______ 狼_______ 狼_______\n狡_______ 呆_______ 虾_______ 黔_______"
+        },
+        {
+          "id": 233,
+          "sort": 1,
+          "title": "盛_______ ——陶渊明\n莫_______ ——岳飞\n多_______ ——毛泽东"
+        },
+        {
+          "id": 72,
+          "sort": 2,
+          "title": "乞巧"
+        },
+        {
+          "id": 234,
+          "sort": 3,
+          "title": "安_______ 国_______ 太_______ 丰_______\n政_______ 人_______ 夜_______ 路_______\n多_______ 流_______ 兵_______ 生_______\n家_______ 哀_______ 民_______ 内_______"
+        },
+        {
+          "id": 114,
+          "sort": 4,
+          "title": "游子吟"
+        },
+        {
+          "id": 80,
+          "sort": 5,
+          "title": "渔歌子"
+        },
+        {
+          "id": 84,
+          "sort": 6,
+          "title": "观书有感（其一）"
+        }
+      ]
+    },
+    {
+      "miaoguoBookId": 64,
+      "bookIdOld": 84,
+      "label": "六年级上",
+      "type": "daily",
+      "rows": 7,
+      "checked": [
+        {
+          "id": 122,
+          "sort": 0,
+          "title": "江畔独步寻花"
+        },
+        {
+          "id": 236,
+          "sort": 1,
+          "title": "志_______ ——《论语》\n捐_______ ——曹植\n祖_______ ——李纲\n位_______ ——陆游"
+        },
+        {
+          "id": 85,
+          "sort": 2,
+          "title": "观书有感（其二）"
+        },
+        {
+          "id": 92,
+          "sort": 3,
+          "title": "送元二使安西"
+        },
+        {
+          "id": 102,
+          "sort": 4,
+          "title": "过故人庄"
+        },
+        {
+          "id": 237,
+          "sort": 5,
+          "title": "五行：_______\n五谷：_______\n五音：_______\n五彩：_______"
+        },
+        {
+          "id": 239,
+          "sort": 6,
+          "title": "无_______ ——鲁迅《答客诮》\n寄_______ ——鲁迅《自题小像》\n其_______ ——鲁迅《故乡》\n惟_______ ——鲁迅《学界的三魂》\n我_______ ——鲁迅《中国人失掉自信力了吗》"
+        }
+      ]
+    }
+  ],
+  "detached": [
+    {
+      "ID": 71,
+      "HanziBookID": 0,
+      "Title": "蝉"
+    },
+    {
+      "ID": 79,
+      "HanziBookID": 0,
+      "Title": "长相思"
+    },
+    {
+      "ID": 83,
+      "HanziBookID": 0,
+      "Title": "士人读书"
+    },
+    {
+      "ID": 104,
+      "HanziBookID": 0,
+      "Title": "春日"
+    },
+    {
+      "ID": 105,
+      "HanziBookID": 0,
+      "Title": "回乡偶书"
+    },
+    {
+      "ID": 109,
+      "HanziBookID": 0,
+      "Title": "伯牙鼓琴"
+    },
+    {
+      "ID": 110,
+      "HanziBookID": 0,
+      "Title": "书戴嵩画牛"
+    },
+    {
+      "ID": 235,
+      "HanziBookID": 0,
+      "Title": "克_______ ——《尚书》\n居_______ ——魏征\n由_______ ——司马光\n一_______ ——朱用纯"
+    },
+    {
+      "ID": 238,
+      "HanziBookID": 0,
+      "Title": "高_______ 天_______\n余_______ 黄_______\n轻_______ 行_______\n巧_______ 惟_______\n画_______ 笔_______\n妙_______ 栩_______"
+    }
+  ],
+  "metadata": [
+    {
+      "ID": 13,
+      "BookIDOld": 25,
+      "UnitNum": 1,
+      "WordNum": 8
+    },
+    {
+      "ID": 15,
+      "BookIDOld": 27,
+      "UnitNum": 1,
+      "WordNum": 7
+    },
+    {
+      "ID": 17,
+      "BookIDOld": 29,
+      "UnitNum": 1,
+      "WordNum": 9
+    },
+    {
+      "ID": 19,
+      "BookIDOld": 31,
+      "UnitNum": 1,
+      "WordNum": 9
+    },
+    {
+      "ID": 21,
+      "BookIDOld": 33,
+      "UnitNum": 1,
+      "WordNum": 10
+    },
+    {
+      "ID": 23,
+      "BookIDOld": 35,
+      "UnitNum": 1,
+      "WordNum": 10
+    },
+    {
+      "ID": 24,
+      "BookIDOld": 36,
+      "UnitNum": 1,
+      "WordNum": 15
+    },
+    {
+      "ID": 54,
+      "BookIDOld": 74,
+      "UnitNum": 1,
+      "WordNum": 8
+    },
+    {
+      "ID": 56,
+      "BookIDOld": 76,
+      "UnitNum": 1,
+      "WordNum": 8
+    },
+    {
+      "ID": 58,
+      "BookIDOld": 78,
+      "UnitNum": 1,
+      "WordNum": 7
+    },
+    {
+      "ID": 60,
+      "BookIDOld": 80,
+      "UnitNum": 1,
+      "WordNum": 7
+    },
+    {
+      "ID": 61,
+      "BookIDOld": 81,
+      "UnitNum": 1,
+      "WordNum": 6
+    },
+    {
+      "ID": 62,
+      "BookIDOld": 82,
+      "UnitNum": 1,
+      "WordNum": 7
+    },
+    {
+      "ID": 63,
+      "BookIDOld": 83,
+      "UnitNum": 1,
+      "WordNum": 5
+    },
+    {
+      "ID": 64,
+      "BookIDOld": 84,
+      "UnitNum": 1,
+      "WordNum": 7
+    }
+  ],
+  "sourceExistingIds": 80
+}

.vscode/秒过知识库更新/dry_run_ancient_daily_2026_fall.json

@@ -0,0 +1,418 @@
+{
+  "generatedAt": "2026-09-03T06:25:39.143Z",
+  "mode": "dry-run",
+  "sourceVersion": "2026-fall",
+  "summary": {
+    "inserts": 0,
+    "updates": 0,
+    "moves": 0,
+    "detaches": 0,
+    "metadataUpdates": 0,
+    "databaseDeletes": 0
+  },
+  "books": [
+    {
+      "miaoguoBookId": 13,
+      "bookIdOld": 25,
+      "label": "一年级上",
+      "type": "ancient",
+      "finalRows": 8,
+      "titles": [
+        "金木水火土",
+        "江南",
+        "雪地里的小画家",
+        "对韵歌",
+        "升国旗",
+        "小小的船",
+        "两件宝",
+        "比尾巴"
+      ]
+    },
+    {
+      "miaoguoBookId": 15,
+      "bookIdOld": 27,
+      "label": "二年级上",
+      "type": "ancient",
+      "finalRows": 7,
+      "titles": [
+        "登鹳雀楼",
+        "望庐山瀑布",
+        "江雪",
+        "敕勒歌",
+        "田家四季歌",
+        "树之歌",
+        "日月潭（节选）"
+      ]
+    },
+    {
+      "miaoguoBookId": 17,
+      "bookIdOld": 29,
+      "label": "三年级上",
+      "type": "ancient",
+      "finalRows": 9,
+      "titles": [
+        "望洞庭",
+        "山行",
+        "夜书所见",
+        "鹿柴",
+        "望天门山",
+        "饮湖上初晴后雨",
+        "司马光",
+        "秋天的雨（节选）",
+        "大自然的声音（节选）"
+      ]
+    },
+    {
+      "miaoguoBookId": 19,
+      "bookIdOld": 31,
+      "label": "四年级上",
+      "type": "ancient",
+      "finalRows": 9,
+      "titles": [
+        "暮江吟",
+        "题西林壁",
+        "雪梅",
+        "精卫填海",
+        "凉州词",
+        "出塞",
+        "夏日绝句",
+        "王戎不取道旁李",
+        "观潮（节选）"
+      ]
+    },
+    {
+      "miaoguoBookId": 21,
+      "bookIdOld": 33,
+      "label": "五年级上",
+      "type": "ancient",
+      "finalRows": 10,
+      "titles": [
+        "示儿",
+        "题临安邸",
+        "己亥杂诗",
+        "少年中国说（节选）",
+        "山居秋暝",
+        "枫桥夜泊",
+        "早春呈水部张十八员外",
+        "敏而好学",
+        "读书有三到",
+        "白鹭"
+      ]
+    },
+    {
+      "miaoguoBookId": 23,
+      "bookIdOld": 35,
+      "label": "六年级上",
+      "type": "ancient",
+      "finalRows": 10,
+      "titles": [
+        "宿建德江",
+        "六月二十七日望湖楼醉书",
+        "西江月·夜行黄沙道中",
+        "七律·长征",
+        "浪淘沙（其一）",
+        "江南春",
+        "书湖阴先生壁",
+        "两小儿辩日",
+        "曹冲称象",
+        "少年闰土（节选）"
+      ]
+    },
+    {
+      "miaoguoBookId": 54,
+      "bookIdOld": 74,
+      "label": "一年级上",
+      "type": "daily",
+      "finalRows": 8,
+      "titles": [
+        "咏鹅",
+        "画",
+        "一模____ 一心____ 独一____\n十全____ 五颜____ 三头____",
+        "悯农（其二）",
+        "一年_______，一日_______。\n一寸_______，寸金_______。",
+        "古朗月行（节选）",
+        "种_______，种_______。\n前_______，后_______。\n千_______，始_______。\n百_______，更_______。",
+        "风"
+      ]
+    },
+    {
+      "miaoguoBookId": 56,
+      "bookIdOld": 76,
+      "label": "二年级上",
+      "type": "daily",
+      "finalRows": 8,
+      "titles": [
+        "梅花",
+        "数九歌",
+        "小儿垂钓",
+        "有_______,无_______ \n白_______,杏_______ \n清_______,近_______ \n雾_______,天_______",
+        "黑_______，白_______。\n一_______，一_______。\n书_______，学_______。",
+        "有_______ ——《后汉书》\n志_______ ——诸葛亮\n穷_______ ——王勃",
+        "夜宿山寺",
+        "己_______ ——《论语》\n与_______ ——《论语》\n不_______ ——《孟子》"
+      ]
+    },
+    {
+      "miaoguoBookId": 58,
+      "bookIdOld": 78,
+      "label": "三年级上",
+      "type": "daily",
+      "finalRows": 7,
+      "titles": [
+        "所见",
+        "舟夜书所见",
+        "不_______ ——《论语》\n爱_______ ——《墨子》\n仁_______ ——《孟子》\n与_______ ——《荀子》",
+        "人_______，泰_______。  二_______，其_______。  三_______，顶_______。",
+        "早发白帝城",
+        "采莲曲",
+        "士_______，任_______。——《论语》\n志_______，言_______。——《墨子》\n锲_______，朽_______；锲_______，金_______。——《荀子》"
+      ]
+    },
+    {
+      "miaoguoBookId": 60,
+      "bookIdOld": 80,
+      "label": "四年级上",
+      "type": "daily",
+      "finalRows": 7,
+      "titles": [
+        "赠刘景文",
+        "博_______ ——《中庸》\n智_______ ——王充\n人_______ ——韩愈\n善_______ ——方以智",
+        "立_______，_______\n二_______，_______\n夏_______，_______\n八_______，雁_______\n一_______，十_______\n八_______，十_______",
+        "嫦娥",
+        "黄鹤楼送孟浩然之广陵",
+        "尺_______，_______。\n仁_______，_______。\n机_______，_______。\n差_______，_______。\n一_______，_______。\n知_______，_______。",
+        "别董大"
+      ]
+    },
+    {
+      "miaoguoBookId": 62,
+      "bookIdOld": 82,
+      "label": "五年级上",
+      "type": "daily",
+      "finalRows": 7,
+      "titles": [
+        "卧_______ 龙_______ 龙_______ 凤_______\n如_______ 如_______ 鹤_______ 一_______\n鼠_______ 抱_______ 狼_______ 狼_______\n狡_______ 呆_______ 虾_______ 黔_______",
+        "盛_______ ——陶渊明\n莫_______ ——岳飞\n多_______ ——毛泽东",
+        "乞巧",
+        "安_______ 国_______ 太_______ 丰_______\n政_______ 人_______ 夜_______ 路_______\n多_______ 流_______ 兵_______ 生_______\n家_______ 哀_______ 民_______ 内_______",
+        "游子吟",
+        "渔歌子",
+        "观书有感（其一）"
+      ]
+    },
+    {
+      "miaoguoBookId": 64,
+      "bookIdOld": 84,
+      "label": "六年级上",
+      "type": "daily",
+      "finalRows": 7,
+      "titles": [
+        "江畔独步寻花",
+        "志_______ ——《论语》\n捐_______ ——曹植\n祖_______ ——李纲\n位_______ ——陆游",
+        "观书有感（其二）",
+        "送元二使安西",
+        "过故人庄",
+        "五行：_______\n五谷：_______\n五音：_______\n五彩：_______",
+        "无_______ ——鲁迅《答客诮》\n寄_______ ——鲁迅《自题小像》\n其_______ ——鲁迅《故乡》\n惟_______ ——鲁迅《学界的三魂》\n我_______ ——鲁迅《中国人失掉自信力了吗》"
+      ]
+    }
+  ],
+  "changes": [],
+  "metadataChanges": [
+    {
+      "miaoguoBookId": 13,
+      "bookIdOld": 25,
+      "from": {
+        "unitNum": 1,
+        "wordNum": 8
+      },
+      "to": {
+        "unitNum": 1,
+        "wordNum": 8
+      },
+      "changed": false
+    },
+    {
+      "miaoguoBookId": 15,
+      "bookIdOld": 27,
+      "from": {
+        "unitNum": 1,
+        "wordNum": 7
+      },
+      "to": {
+        "unitNum": 1,
+        "wordNum": 7
+      },
+      "changed": false
+    },
+    {
+      "miaoguoBookId": 17,
+      "bookIdOld": 29,
+      "from": {
+        "unitNum": 1,
+        "wordNum": 9
+      },
+      "to": {
+        "unitNum": 1,
+        "wordNum": 9
+      },
+      "changed": false
+    },
+    {
+      "miaoguoBookId": 19,
+      "bookIdOld": 31,
+      "from": {
+        "unitNum": 1,
+        "wordNum": 9
+      },
+      "to": {
+        "unitNum": 1,
+        "wordNum": 9
+      },
+      "changed": false
+    },
+    {
+      "miaoguoBookId": 21,
+      "bookIdOld": 33,
+      "from": {
+        "unitNum": 1,
+        "wordNum": 10
+      },
+      "to": {
+        "unitNum": 1,
+        "wordNum": 10
+      },
+      "changed": false
+    },
+    {
+      "miaoguoBookId": 23,
+      "bookIdOld": 35,
+      "from": {
+        "unitNum": 1,
+        "wordNum": 10
+      },
+      "to": {
+        "unitNum": 1,
+        "wordNum": 10
+      },
+      "changed": false
+    },
+    {
+      "miaoguoBookId": 24,
+      "bookIdOld": 36,
+      "from": {
+        "unitNum": 1,
+        "wordNum": 15
+      },
+      "to": {
+        "unitNum": 1,
+        "wordNum": 15
+      },
+      "changed": false
+    },
+    {
+      "miaoguoBookId": 54,
+      "bookIdOld": 74,
+      "from": {
+        "unitNum": 1,
+        "wordNum": 8
+      },
+      "to": {
+        "unitNum": 1,
+        "wordNum": 8
+      },
+      "changed": false
+    },
+    {
+      "miaoguoBookId": 56,
+      "bookIdOld": 76,
+      "from": {
+        "unitNum": 1,
+        "wordNum": 8
+      },
+      "to": {
+        "unitNum": 1,
+        "wordNum": 8
+      },
+      "changed": false
+    },
+    {
+      "miaoguoBookId": 58,
+      "bookIdOld": 78,
+      "from": {
+        "unitNum": 1,
+        "wordNum": 7
+      },
+      "to": {
+        "unitNum": 1,
+        "wordNum": 7
+      },
+      "changed": false
+    },
+    {
+      "miaoguoBookId": 60,
+      "bookIdOld": 80,
+      "from": {
+        "unitNum": 1,
+        "wordNum": 7
+      },
+      "to": {
+        "unitNum": 1,
+        "wordNum": 7
+      },
+      "changed": false
+    },
+    {
+      "miaoguoBookId": 61,
+      "bookIdOld": 81,
+      "from": {
+        "unitNum": 1,
+        "wordNum": 6
+      },
+      "to": {
+        "unitNum": 1,
+        "wordNum": 6
+      },
+      "changed": false
+    },
+    {
+      "miaoguoBookId": 62,
+      "bookIdOld": 82,
+      "from": {
+        "unitNum": 1,
+        "wordNum": 7
+      },
+      "to": {
+        "unitNum": 1,
+        "wordNum": 7
+      },
+      "changed": false
+    },
+    {
+      "miaoguoBookId": 63,
+      "bookIdOld": 83,
+      "from": {
+        "unitNum": 1,
+        "wordNum": 5
+      },
+      "to": {
+        "unitNum": 1,
+        "wordNum": 5
+      },
+      "changed": false
+    },
+    {
+      "miaoguoBookId": 64,
+      "bookIdOld": 84,
+      "from": {
+        "unitNum": 1,
+        "wordNum": 7
+      },
+      "to": {
+        "unitNum": 1,
+        "wordNum": 7
+      },
+      "changed": false
+    }
+  ]
+}

.vscode/秒过知识库更新/research_db_snapshot_2026_fall.mjs

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import mysql from "mysql2/promise";
+import config from "../../src/config/dev.js";
+
+const taskDir = path.dirname(fileURLToPath(import.meta.url));
+const outputPath = path.join(taskDir, "research_db_snapshot_2026_fall.json");
+const miaoguoBookIds = [13, 15, 17, 19, 21, 23, 24, 54, 56, 58, 60, 61, 62, 63, 64];
+const hanziBookIds = [25, 27, 29, 31, 33, 35, 36, 74, 76, 78, 80, 81, 82, 83, 84];
+
+const connection = await mysql.createConnection({
+  ...config.database,
+  charset: "utf8mb4",
+});
+
+try {
+  const [books] = await connection.query(
+    `SELECT ID, BookIDOld, BookName, UnitNum, WordNum
+       FROM MiaoguoBook
+      WHERE ID IN (?)
+      ORDER BY ID`,
+    [miaoguoBookIds],
+  );
+  const [targetRows] = await connection.query(
+    `SELECT ID, HanziBookID, Sort, Category, Tag, Title, ImgUrl,
+            Author, Dynasty, PeomContent, Translation, Flag
+       FROM AncientPoetry
+      WHERE HanziBookID IN (?)
+      ORDER BY HanziBookID, Sort, ID`,
+    [hanziBookIds],
+  );
+  const [allRows] = await connection.query(
+    `SELECT ID, HanziBookID, Sort, Category, Tag, Title, Author, Dynasty,
+            PeomContent, Translation, Flag
+       FROM AncientPoetry
+      ORDER BY ID`,
+  );
+
+  fs.writeFileSync(
+    outputPath,
+    `${JSON.stringify({ capturedAt: new Date().toISOString(), books, targetRows, allRows }, null, 2)}\n`,
+    "utf8",
+  );
+  console.log(JSON.stringify({ outputPath, books: books.length, targetRows: targetRows.length, allRows: allRows.length }));
+} finally {
+  await connection.end();
+}

.vscode/秒过知识库更新/research_ocr_2026_fall.swift

@@ -0,0 +1,90 @@
+import AppKit
+import Foundation
+import Vision
+
+struct OCRLine: Codable {
+  let text: String
+  let x: Double
+  let y: Double
+  let width: Double
+  let height: Double
+}
+
+struct OCRPage: Codable {
+  let grade: String
+  let file: String
+  let path: String
+  let lines: [OCRLine]
+}
+
+let args = CommandLine.arguments
+guard args.count == 3 else {
+  fputs("usage: research_ocr_2026_fall <source-root> <output-json>\n", stderr)
+  exit(2)
+}
+
+let sourceRoot = URL(fileURLWithPath: args[1], isDirectory: true)
+let outputURL = URL(fileURLWithPath: args[2])
+let manager = FileManager.default
+let allowedExtensions = Set(["png", "jpg", "jpeg"])
+
+let gradeURLs = try manager.contentsOfDirectory(
+  at: sourceRoot,
+  includingPropertiesForKeys: nil,
+  options: [.skipsHiddenFiles]
+).filter { $0.hasDirectoryPath }.sorted { $0.lastPathComponent < $1.lastPathComponent }
+
+var pages: [OCRPage] = []
+for gradeURL in gradeURLs {
+  let imageURLs = try manager.contentsOfDirectory(
+    at: gradeURL,
+    includingPropertiesForKeys: nil,
+    options: [.skipsHiddenFiles]
+  ).filter { allowedExtensions.contains($0.pathExtension.lowercased()) }
+    .sorted { $0.lastPathComponent < $1.lastPathComponent }
+
+  for (index, imageURL) in imageURLs.enumerated() {
+    guard let image = NSImage(contentsOf: imageURL),
+          let cgImage = image.cgImage(forProposedRect: nil, context: nil, hints: nil) else {
+      fputs("failed to load \(imageURL.path)\n", stderr)
+      exit(1)
+    }
+
+    let request = VNRecognizeTextRequest()
+    request.recognitionLevel = .accurate
+    request.usesLanguageCorrection = true
+    request.recognitionLanguages = ["zh-Hans", "en-US"]
+    request.minimumTextHeight = 0.006
+    try VNImageRequestHandler(cgImage: cgImage, options: [:]).perform([request])
+
+    let lines = (request.results ?? []).compactMap { observation -> OCRLine? in
+      guard let candidate = observation.topCandidates(1).first else { return nil }
+      let box = observation.boundingBox
+      return OCRLine(
+        text: candidate.string,
+        x: Double(box.minX),
+        y: Double(box.minY),
+        width: Double(box.width),
+        height: Double(box.height)
+      )
+    }.sorted {
+      let leftY = Int($0.y * 1000)
+      let rightY = Int($1.y * 1000)
+      if leftY != rightY { return leftY > rightY }
+      return $0.x < $1.x
+    }
+
+    pages.append(OCRPage(
+      grade: gradeURL.lastPathComponent,
+      file: imageURL.lastPathComponent,
+      path: imageURL.path,
+      lines: lines
+    ))
+    fputs("[\(gradeURL.lastPathComponent)] \(index + 1)/\(imageURLs.count) \(imageURL.lastPathComponent)\n", stderr)
+  }
+}
+
+let encoder = JSONEncoder()
+encoder.outputFormatting = [.prettyPrinted, .sortedKeys, .withoutEscapingSlashes]
+try encoder.encode(pages).write(to: outputURL, options: .atomic)
+fputs("wrote \(pages.count) pages to \(outputURL.path)\n", stderr)

.vscode/秒过知识库更新/update_ancient_daily_2026_fall.mjs

@@ -0,0 +1,592 @@
+#!/usr/bin/env node
+
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import mysql from "mysql2/promise";
+import config from "../../src/config/dev.js";
+
+const taskDir = path.dirname(fileURLToPath(import.meta.url));
+const sourcePath = path.join(taskDir, "source_ancient_daily_2026_fall.json");
+const source = JSON.parse(fs.readFileSync(sourcePath, "utf8"));
+const flags = new Set(process.argv.slice(2));
+const knownFlags = new Set(["--dry-run", "--apply", "--audit"]);
+for (const flag of flags) assert(knownFlags.has(flag), `不支持的参数：${flag}`);
+assert(
+  ["--dry-run", "--apply", "--audit"].filter((flag) => flags.has(flag)).length <= 1,
+  "--dry-run、--apply、--audit 只能选择一个",
+);
+const mode = flags.has("--apply") ? "apply" : flags.has("--audit") ? "audit" : "dry-run";
+
+function nowForFile() {
+  return new Date().toISOString().replaceAll(":", "-").replaceAll(".", "-");
+}
+
+function writeJson(filePath, data) {
+  fs.writeFileSync(filePath, `${JSON.stringify(data, null, 2)}\n`, "utf8");
+}
+
+function stringifyContent(content) {
+  return JSON.stringify(content);
+}
+
+function normalized(value) {
+  return value == null ? null : value;
+}
+
+function tagFor(book, entry) {
+  return book.type === "daily"
+    ? `${book.label},日积月累,${entry.kind}`
+    : `${book.label},${entry.kind}`;
+}
+
+function categoryFor(book, entry) {
+  if (book.type === "ancient") return 0;
+  return entry.kind === "诗词" ? 0 : 1;
+}
+
+function validateSource() {
+  assert.equal(source.version, "2026-fall");
+  assert.equal(source.sortBase, 0);
+  assert.equal(source.books.length, 12, "应包含六册古诗文和六册日积月累");
+
+  const bookIds = source.books.map((book) => book.miaoguoBookId);
+  const bookIdsOld = source.books.map((book) => book.bookIdOld);
+  assert.equal(new Set(bookIds).size, bookIds.length, "MiaoguoBook.ID 重复");
+  assert.equal(new Set(bookIdsOld).size, bookIdsOld.length, "目标 BookIDOld 重复");
+
+  const existingIds = [];
+  const newTitles = [];
+  for (const book of source.books) {
+    assert(["ancient", "daily"].includes(book.type), `${book.label} type 错误`);
+    assert(book.entries.length > 0, `${book.label}/${book.type} 没有条目`);
+    book.entries.forEach((entry, index) => {
+      assert(entry.kind, `${book.label}/${book.type}/Sort=${index} 缺少 kind`);
+      const tag = tagFor(book, entry);
+      assert(tag.length <= 45, `${tag} 超过 Tag 长度`);
+      if (entry.id != null) {
+        existingIds.push(entry.id);
+      } else {
+        assert(entry.title, `${book.label}/${book.type}/Sort=${index} 新增项缺少标题`);
+        assert(entry.content, `${book.label}/${book.type}/${entry.title} 新增项缺少正文`);
+        newTitles.push(entry.title);
+      }
+      if (entry.title != null) assert(entry.title.length <= 200, `${entry.title} 标题过长`);
+      if (entry.author != null) assert(entry.author.length <= 45, `${entry.title} Author 过长`);
+      if (entry.dynasty != null) assert(entry.dynasty.length <= 45, `${entry.title} Dynasty 过长`);
+      if (entry.content != null) {
+        const content = stringifyContent(entry.content);
+        assert(content.length <= 2000, `${entry.title ?? entry.id} PeomContent 超过 2000 字符`);
+        assert.deepEqual(JSON.parse(content), entry.content);
+      }
+    });
+  }
+
+  assert.equal(new Set(existingIds).size, existingIds.length, "来源中的 AncientPoetry.ID 重复");
+  assert.equal(new Set(newTitles).size, newTitles.length, "新增标题重复");
+  const detachIds = source.detach.map((entry) => entry.id);
+  assert.equal(new Set(detachIds).size, detachIds.length, "detach ID 重复");
+  assert(
+    detachIds.every((id) => !existingIds.includes(id)),
+    "同一 ID 不能既出现在最终清单又出现在 detach",
+  );
+
+  const metadataIds = source.metadata.map((entry) => entry.miaoguoBookId);
+  assert.equal(new Set(metadataIds).size, metadataIds.length, "metadata MiaoguoBook.ID 重复");
+  for (const book of source.books) {
+    const metadata = source.metadata.find((entry) => entry.miaoguoBookId === book.miaoguoBookId);
+    assert(metadata, `${book.label}/${book.type} 缺少 metadata`);
+    assert.equal(metadata.bookIdOld, book.bookIdOld, `${book.label}/${book.type} metadata 映射错误`);
+    assert.equal(metadata.wordNum, book.entries.length, `${book.label}/${book.type} WordNum 不等于最终行数`);
+  }
+}
+
+async function readState(connection, lock = false) {
+  const existingIds = source.books.flatMap((book) => book.entries)
+    .filter((entry) => entry.id != null)
+    .map((entry) => entry.id);
+  const affectedIds = [...new Set([...existingIds, ...source.detach.map((entry) => entry.id)])];
+  const metadataIds = source.metadata.map((entry) => entry.miaoguoBookId);
+  const targetBookIdsOld = source.books.map((book) => book.bookIdOld);
+  const lockSuffix = lock ? " FOR UPDATE" : "";
+
+  const [rows] = await connection.query(
+    `SELECT ID, HanziBookID, Sort, Category, Tag, Title, ImgUrl, Author, Dynasty,
+            PeomContent, Translation, Flag
+       FROM AncientPoetry
+      WHERE ID IN (?)${lockSuffix}`,
+    [affectedIds],
+  );
+  const [allRows] = await connection.query(
+    `SELECT ID, HanziBookID, Sort, Category, Tag, Title, ImgUrl, Author, Dynasty,
+            PeomContent, Translation, Flag
+       FROM AncientPoetry${lockSuffix}`,
+  );
+  const [books] = await connection.query(
+    `SELECT ID, BookIDOld, BookName, UnitNum, WordNum
+       FROM MiaoguoBook
+      WHERE ID IN (?)${lockSuffix}`,
+    [metadataIds],
+  );
+  const [targetRows] = await connection.query(
+    `SELECT ID, HanziBookID, Sort, Category, Tag, Title, ImgUrl, Author, Dynasty,
+            PeomContent, Translation, Flag
+       FROM AncientPoetry
+      WHERE HanziBookID IN (?)${lockSuffix}`,
+    [targetBookIdsOld],
+  );
+  return { rows, allRows, books, targetRows };
+}
+
+function materialize(state) {
+  const allById = new Map(state.allRows.map((row) => [row.ID, row]));
+  const allByTitle = new Map();
+  for (const row of state.allRows) {
+    const matches = allByTitle.get(row.Title) ?? [];
+    matches.push(row);
+    allByTitle.set(row.Title, matches);
+  }
+
+  const referencedIds = source.books.flatMap((book) => book.entries)
+    .filter((entry) => entry.id != null)
+    .map((entry) => entry.id);
+  for (const id of [...referencedIds, ...source.detach.map((entry) => entry.id)]) {
+    assert(allById.has(id), `AncientPoetry.ID=${id} 不存在`);
+  }
+
+  const desiredBooks = source.books.map((book) => ({
+    ...book,
+    entries: book.entries.map((entry, index) => {
+      let current = null;
+      if (entry.id != null) {
+        current = allById.get(entry.id);
+      } else {
+        const titleMatches = allByTitle.get(entry.title) ?? [];
+        assert(titleMatches.length <= 1, `新增标题“${entry.title}”在数据库中存在多条记录`);
+        if (titleMatches.length === 1) {
+          current = titleMatches[0];
+          assert.equal(
+            current.HanziBookID,
+            book.bookIdOld,
+            `新增标题“${entry.title}”已存在，但位于 BookIDOld=${current.HanziBookID}`,
+          );
+        }
+      }
+
+      return {
+        source: entry,
+        current,
+        desired: {
+          ID: current?.ID ?? null,
+          HanziBookID: book.bookIdOld,
+          Sort: source.sortBase + index,
+          Category: categoryFor(book, entry),
+          Tag: tagFor(book, entry),
+          Title: entry.title ?? current?.Title,
+          ImgUrl: current?.ImgUrl ?? null,
+          Author: Object.hasOwn(entry, "author") ? entry.author : normalized(current?.Author),
+          Dynasty: Object.hasOwn(entry, "dynasty") ? entry.dynasty : normalized(current?.Dynasty),
+          PeomContent: entry.content != null
+            ? stringifyContent(entry.content)
+            : current?.PeomContent,
+          Translation: current?.Translation ?? null,
+          Flag: current?.Flag ?? 0,
+        },
+      };
+    }),
+  }));
+
+  for (const book of desiredBooks) {
+    for (const entry of book.entries) {
+      assert(entry.desired.Title, `${book.label}/${book.type} 存在空标题`);
+      assert(entry.desired.PeomContent, `${book.label}/${book.type}/${entry.desired.Title} 存在空正文`);
+      JSON.parse(entry.desired.PeomContent);
+    }
+  }
+
+  const currentTargetIds = new Set(state.targetRows.map((row) => row.ID));
+  const desiredExistingIds = new Set(
+    desiredBooks.flatMap((book) => book.entries)
+      .filter((entry) => entry.current)
+      .map((entry) => entry.current.ID),
+  );
+  const detachIds = new Set(source.detach.map((entry) => entry.id));
+  const unexplainedTargetIds = [...currentTargetIds]
+    .filter((id) => !desiredExistingIds.has(id) && !detachIds.has(id));
+  assert.deepEqual(unexplainedTargetIds, [], `目标书存在未处理旧记录：${unexplainedTargetIds.join(",")}`);
+
+  const finalBookByExistingId = new Map(state.allRows.map((row) => [row.ID, row.HanziBookID]));
+  for (const book of desiredBooks) {
+    for (const entry of book.entries) {
+      if (entry.current) finalBookByExistingId.set(entry.current.ID, book.bookIdOld);
+    }
+  }
+  for (const entry of source.detach) finalBookByExistingId.set(entry.id, 0);
+
+  const expectedCounts = new Map();
+  for (const bookIdOld of finalBookByExistingId.values()) {
+    expectedCounts.set(bookIdOld, (expectedCounts.get(bookIdOld) ?? 0) + 1);
+  }
+  for (const book of desiredBooks) {
+    const inserts = book.entries.filter((entry) => !entry.current).length;
+    expectedCounts.set(book.bookIdOld, (expectedCounts.get(book.bookIdOld) ?? 0) + inserts);
+  }
+  for (const metadata of source.metadata) {
+    assert.equal(
+      expectedCounts.get(metadata.bookIdOld) ?? 0,
+      metadata.wordNum,
+      `BookIDOld=${metadata.bookIdOld} 模拟行数与 metadata.WordNum 不一致`,
+    );
+  }
+
+  return desiredBooks;
+}
+
+const compareFields = [
+  "HanziBookID",
+  "Sort",
+  "Category",
+  "Tag",
+  "Title",
+  "Author",
+  "Dynasty",
+  "PeomContent",
+  "Translation",
+  "Flag",
+];
+
+function buildPlan(state, desiredBooks) {
+  const changes = [];
+  for (const book of desiredBooks) {
+    for (const entry of book.entries) {
+      if (!entry.current) {
+        changes.push({
+          action: "insert",
+          bookIdOld: book.bookIdOld,
+          sort: entry.desired.Sort,
+          title: entry.desired.Title,
+        });
+        continue;
+      }
+      const changedFields = compareFields.filter(
+        (field) => normalized(entry.current[field]) !== normalized(entry.desired[field]),
+      );
+      if (changedFields.length > 0) {
+        changes.push({
+          action: entry.current.HanziBookID === entry.desired.HanziBookID ? "update" : "move",
+          id: entry.current.ID,
+          fromBookIdOld: entry.current.HanziBookID,
+          toBookIdOld: entry.desired.HanziBookID,
+          sort: entry.desired.Sort,
+          fromTitle: entry.current.Title,
+          toTitle: entry.desired.Title,
+          changedFields,
+        });
+      }
+    }
+  }
+
+  for (const entry of source.detach) {
+    const current = state.allRows.find((row) => row.ID === entry.id);
+    if (current.HanziBookID !== 0) {
+      changes.push({
+        action: "detach",
+        id: entry.id,
+        fromBookIdOld: current.HanziBookID,
+        toBookIdOld: 0,
+        title: current.Title,
+        changedFields: ["HanziBookID"],
+      });
+    }
+  }
+
+  const booksById = new Map(state.books.map((book) => [book.ID, book]));
+  const metadataChanges = source.metadata.map((desired) => {
+    const current = booksById.get(desired.miaoguoBookId);
+    assert(current, `MiaoguoBook.ID=${desired.miaoguoBookId} 不存在`);
+    assert.equal(current.BookIDOld, desired.bookIdOld, `MiaoguoBook.ID=${desired.miaoguoBookId} 映射不一致`);
+    return {
+      miaoguoBookId: desired.miaoguoBookId,
+      bookIdOld: desired.bookIdOld,
+      from: { unitNum: current.UnitNum, wordNum: current.WordNum },
+      to: { unitNum: desired.unitNum, wordNum: desired.wordNum },
+      changed: current.UnitNum !== desired.unitNum || current.WordNum !== desired.wordNum,
+    };
+  });
+
+  return {
+    generatedAt: new Date().toISOString(),
+    mode,
+    sourceVersion: source.version,
+    summary: {
+      inserts: changes.filter((entry) => entry.action === "insert").length,
+      updates: changes.filter((entry) => entry.action === "update").length,
+      moves: changes.filter((entry) => entry.action === "move").length,
+      detaches: changes.filter((entry) => entry.action === "detach").length,
+      metadataUpdates: metadataChanges.filter((entry) => entry.changed).length,
+      databaseDeletes: 0,
+    },
+    books: desiredBooks.map((book) => ({
+      miaoguoBookId: book.miaoguoBookId,
+      bookIdOld: book.bookIdOld,
+      label: book.label,
+      type: book.type,
+      finalRows: book.entries.length,
+      titles: book.entries.map((entry) => entry.desired.Title),
+    })),
+    changes,
+    metadataChanges,
+  };
+}
+
+async function applyPlan(connection, desiredBooks) {
+  const inserted = [];
+  const updated = [];
+  const detached = [];
+
+  for (const entry of source.detach) {
+    const [result] = await connection.query(
+      "UPDATE AncientPoetry SET HanziBookID=0 WHERE ID=? AND HanziBookID<>0",
+      [entry.id],
+    );
+    if (result.affectedRows > 0) detached.push(entry.id);
+  }
+
+  for (const book of desiredBooks) {
+    for (const entry of book.entries) {
+      const row = entry.desired;
+      if (entry.current) {
+        const [result] = await connection.query(
+          `UPDATE AncientPoetry
+              SET HanziBookID=?, Sort=?, Category=?, Tag=?, Title=?, Author=?, Dynasty=?,
+                  PeomContent=?, Translation=?, Flag=?
+            WHERE ID=?`,
+          [
+            row.HanziBookID,
+            row.Sort,
+            row.Category,
+            row.Tag,
+            row.Title,
+            row.Author,
+            row.Dynasty,
+            row.PeomContent,
+            row.Translation,
+            row.Flag,
+            entry.current.ID,
+          ],
+        );
+        assert.equal(result.affectedRows, 1, `更新 AncientPoetry.ID=${entry.current.ID} 失败`);
+        updated.push(entry.current.ID);
+      } else {
+        const [result] = await connection.query(
+          `INSERT INTO AncientPoetry
+             (HanziBookID, Sort, Category, Tag, Title, ImgUrl, Author, Dynasty,
+              PeomContent, Translation, Flag)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+          [
+            row.HanziBookID,
+            row.Sort,
+            row.Category,
+            row.Tag,
+            row.Title,
+            row.ImgUrl,
+            row.Author,
+            row.Dynasty,
+            row.PeomContent,
+            row.Translation,
+            row.Flag,
+          ],
+        );
+        inserted.push({ id: result.insertId, bookIdOld: row.HanziBookID, title: row.Title });
+      }
+    }
+  }
+
+  for (const metadata of source.metadata) {
+    const [result] = await connection.query(
+      "UPDATE MiaoguoBook SET UnitNum=?, WordNum=? WHERE ID=? AND BookIDOld=?",
+      [metadata.unitNum, metadata.wordNum, metadata.miaoguoBookId, metadata.bookIdOld],
+    );
+    assert.equal(result.affectedRows, 1, `更新 MiaoguoBook.ID=${metadata.miaoguoBookId} 失败`);
+  }
+
+  return { inserted, updated, detached };
+}
+
+async function audit(connection) {
+  const failures = [];
+  const bookResults = [];
+  const entryByExistingId = new Map(
+    source.books.flatMap((book) => book.entries)
+      .filter((entry) => entry.id != null)
+      .map((entry) => [entry.id, entry]),
+  );
+
+  for (const book of source.books) {
+    const [rows] = await connection.query(
+      `SELECT ID, HanziBookID, Sort, Category, Tag, Title, ImgUrl, Author, Dynasty,
+              PeomContent, Translation, Flag
+         FROM AncientPoetry
+        WHERE HanziBookID=?
+        ORDER BY Sort, ID`,
+      [book.bookIdOld],
+    );
+    const expectedSorts = book.entries.map((_, index) => source.sortBase + index);
+    const actualSorts = rows.map((row) => row.Sort);
+    if (rows.length !== book.entries.length) {
+      failures.push(`${book.label}/${book.type} 行数 ${rows.length} != ${book.entries.length}`);
+    }
+    if (JSON.stringify(actualSorts) !== JSON.stringify(expectedSorts)) {
+      failures.push(`${book.label}/${book.type} Sort 不连续：${actualSorts.join(",")}`);
+    }
+
+    const rowById = new Map(rows.map((row) => [row.ID, row]));
+    const rowByTitle = new Map(rows.map((row) => [row.Title, row]));
+    const checked = [];
+    book.entries.forEach((entry, index) => {
+      const row = entry.id != null ? rowById.get(entry.id) : rowByTitle.get(entry.title);
+      if (!row) {
+        failures.push(`${book.label}/${book.type} 缺少 ${entry.title ?? `ID=${entry.id}`}`);
+        return;
+      }
+      const expectedTitle = entry.title ?? row.Title;
+      const expectedCategory = categoryFor(book, entry);
+      const expectedTag = tagFor(book, entry);
+      if (row.HanziBookID !== book.bookIdOld) failures.push(`ID=${row.ID} HanziBookID 错误`);
+      if (row.Sort !== source.sortBase + index) failures.push(`ID=${row.ID} Sort 错误`);
+      if (row.Category !== expectedCategory) failures.push(`ID=${row.ID} Category 错误`);
+      if (row.Tag !== expectedTag) failures.push(`ID=${row.ID} Tag 错误`);
+      if (row.Title !== expectedTitle) failures.push(`ID=${row.ID} Title 错误`);
+      try {
+        JSON.parse(row.PeomContent);
+      } catch {
+        failures.push(`ID=${row.ID} PeomContent 不是合法 JSON`);
+      }
+      if (entry.content != null && row.PeomContent !== stringifyContent(entry.content)) {
+        failures.push(`ID=${row.ID} PeomContent 与来源不一致`);
+      }
+      if (Object.hasOwn(entry, "author") && normalized(row.Author) !== normalized(entry.author)) {
+        failures.push(`ID=${row.ID} Author 与来源不一致`);
+      }
+      if (Object.hasOwn(entry, "dynasty") && normalized(row.Dynasty) !== normalized(entry.dynasty)) {
+        failures.push(`ID=${row.ID} Dynasty 与来源不一致`);
+      }
+      if (entry.id == null && row.Translation != null) failures.push(`新增 ID=${row.ID} Translation 应为空`);
+      checked.push({ id: row.ID, sort: row.Sort, title: row.Title });
+    });
+    if (new Set(rows.map((row) => row.Title)).size !== rows.length) {
+      failures.push(`${book.label}/${book.type} 存在重复标题`);
+    }
+    bookResults.push({
+      miaoguoBookId: book.miaoguoBookId,
+      bookIdOld: book.bookIdOld,
+      label: book.label,
+      type: book.type,
+      rows: rows.length,
+      checked,
+    });
+  }
+
+  const [detachedRows] = await connection.query(
+    "SELECT ID, HanziBookID, Title FROM AncientPoetry WHERE ID IN (?) ORDER BY ID",
+    [source.detach.map((entry) => entry.id)],
+  );
+  for (const entry of source.detach) {
+    const row = detachedRows.find((candidate) => candidate.ID === entry.id);
+    if (!row) failures.push(`detach ID=${entry.id} 不存在`);
+    else if (row.HanziBookID !== 0) failures.push(`detach ID=${entry.id} HanziBookID=${row.HanziBookID}`);
+  }
+
+  const [books] = await connection.query(
+    "SELECT ID, BookIDOld, UnitNum, WordNum FROM MiaoguoBook WHERE ID IN (?) ORDER BY ID",
+    [source.metadata.map((entry) => entry.miaoguoBookId)],
+  );
+  for (const expected of source.metadata) {
+    const book = books.find((candidate) => candidate.ID === expected.miaoguoBookId);
+    if (!book) failures.push(`MiaoguoBook.ID=${expected.miaoguoBookId} 不存在`);
+    else {
+      if (book.BookIDOld !== expected.bookIdOld) failures.push(`MiaoguoBook.ID=${book.ID} BookIDOld 错误`);
+      if (book.UnitNum !== expected.unitNum) failures.push(`MiaoguoBook.ID=${book.ID} UnitNum 错误`);
+      if (book.WordNum !== expected.wordNum) failures.push(`MiaoguoBook.ID=${book.ID} WordNum 错误`);
+      const [[countRow]] = await connection.query(
+        "SELECT COUNT(*) AS count FROM AncientPoetry WHERE HanziBookID=?",
+        [expected.bookIdOld],
+      );
+      if (countRow.count !== expected.wordNum) {
+        failures.push(`BookIDOld=${expected.bookIdOld} 实际行数 ${countRow.count} != WordNum ${expected.wordNum}`);
+      }
+    }
+  }
+
+  return {
+    generatedAt: new Date().toISOString(),
+    sourceVersion: source.version,
+    ok: failures.length === 0,
+    failures,
+    books: bookResults,
+    detached: detachedRows,
+    metadata: books,
+    sourceExistingIds: [...entryByExistingId.keys()].length,
+  };
+}
+
+validateSource();
+const connection = await mysql.createConnection({ ...config.database, charset: "utf8mb4" });
+
+try {
+  if (mode === "audit") {
+    const auditResult = await audit(connection);
+    const auditPath = path.join(taskDir, "audit_ancient_daily_2026_fall.json");
+    writeJson(auditPath, auditResult);
+    assert(auditResult.ok, auditResult.failures.join("\n"));
+    console.log(JSON.stringify({ mode, auditPath, ok: true, books: auditResult.books.length }));
+    process.exitCode = 0;
+  } else if (mode === "dry-run") {
+    const state = await readState(connection);
+    const desiredBooks = materialize(state);
+    const plan = buildPlan(state, desiredBooks);
+    const reportPath = path.join(taskDir, "dry_run_ancient_daily_2026_fall.json");
+    writeJson(reportPath, plan);
+    console.log(JSON.stringify({ mode, reportPath, summary: plan.summary }));
+  } else {
+    const backupState = await readState(connection);
+    const backupPath = path.join(taskDir, "backups", `before_ancient_daily_2026_fall_${nowForFile()}.json`);
+    fs.mkdirSync(path.dirname(backupPath), { recursive: true });
+    writeJson(backupPath, { capturedAt: new Date().toISOString(), sourceVersion: source.version, ...backupState });
+
+    await connection.beginTransaction();
+    try {
+      const lockedState = await readState(connection, true);
+      const desiredBooks = materialize(lockedState);
+      const plan = buildPlan(lockedState, desiredBooks);
+      const applied = await applyPlan(connection, desiredBooks);
+      const auditResult = await audit(connection);
+      assert(auditResult.ok, auditResult.failures.join("\n"));
+      await connection.commit();
+
+      const reportPath = path.join(taskDir, "apply_ancient_daily_2026_fall.json");
+      writeJson(reportPath, {
+        appliedAt: new Date().toISOString(),
+        sourceVersion: source.version,
+        backupPath,
+        plan,
+        applied,
+        audit: auditResult,
+      });
+      console.log(JSON.stringify({
+        mode,
+        reportPath,
+        backupPath,
+        summary: plan.summary,
+        insertedIds: applied.inserted.map((entry) => entry.id),
+        auditOk: auditResult.ok,
+      }));
+    } catch (error) {
+      await connection.rollback();
+      throw error;
+    }
+  }
+} finally {
+  await connection.end();
+}

.vscode/秒过知识库更新/古诗文与日积月累更新结果_2026年秋.md

@@ -0,0 +1,121 @@
+# 2026 年秋季古诗文与日积月累更新结果
+
+执行日期：2026-09-03（Asia/Shanghai）  
+教材来源：`/Users/chengjie/Downloads/2026年秋-语文`  
+执行状态：已提交；事务内审计、事务外独立审计、幂等 dry-run 均通过。
+
+## 更新结果
+
+| 类别 | MiaoguoBook.ID | BookIDOld | 数据行 | UnitNum | WordNum |
+|---|---:|---:|---:|---:|---:|
+| 一上古诗文 | 13 | 25 | 1 → 8 | 1 | 1 → 8 |
+| 二上古诗文 | 15 | 27 | 4 → 7 | 1 | 4 → 7 |
+| 三上古诗文 | 17 | 29 | 7 → 9 | 1 | 7 → 9 |
+| 四上古诗文 | 19 | 31 | 8 → 9 | 1 | 8 → 9 |
+| 五上古诗文 | 21 | 33 | 10 → 10 | 1 | 9 → 10 |
+| 六上古诗文 | 23 | 35 | 9 → 10 | 1 | 9 → 10 |
+| 一上日积月累 | 54 | 74 | 8 → 8 | 1 | 8 |
+| 二上日积月累 | 56 | 76 | 7 → 8 | 1 | 8 |
+| 三上日积月累 | 58 | 78 | 7 → 7 | 1 | 7 |
+| 四上日积月累 | 60 | 80 | 7 → 7 | 1 | 7 |
+| 五上日积月累 | 62 | 82 | 8 → 7 | 1 | 8 → 7 |
+| 六上日积月累 | 64 | 84 | 7 → 7 | 1 | 7 |
+
+全部 12 本目标书的 `Sort` 已统一为连续的 `0..N-1`。
+
+## 新增记录
+
+| ID | BookIDOld | 标题 |
+|---:|---:|---|
+| 275 | 25 | 金木水火土 |
+| 276 | 25 | 雪地里的小画家 |
+| 277 | 25 | 对韵歌 |
+| 278 | 25 | 升国旗 |
+| 279 | 25 | 小小的船 |
+| 280 | 25 | 两件宝 |
+| 281 | 25 | 比尾巴 |
+| 282 | 27 | 田家四季歌 |
+| 283 | 27 | 树之歌 |
+| 284 | 27 | 日月潭（节选） |
+| 285 | 29 | 秋天的雨（节选） |
+| 286 | 29 | 大自然的声音（节选） |
+| 287 | 31 | 观潮（节选） |
+| 288 | 33 | 白鹭 |
+| 289 | 35 | 曹冲称象 |
+| 290 | 35 | 少年闰土（节选） |
+| 291 | 82 | 五上动物成语（挖空标题） |
+
+共新增 17 条。现代背诵课文按教材要求只录指定自然段；《白鹭》要求全文背诵，因此标题不加“节选”。新增记录的 `Translation` 均为空。
+
+## 迁移与脱册
+
+保留原 ID 迁移 7 条：
+
+| ID | 内容 | BookIDOld 变化 |
+|---:|---|---:|
+| 123 | 早春呈水部张十八员外 | 36 → 33 |
+| 119 | 两小儿辩日 | 36 → 35 |
+| 14 | 梅花 | 0 → 76 |
+| 114 | 游子吟 | 83 → 82 |
+| 122 | 江畔独步寻花 | 81 → 84 |
+| 85 | 观书有感（其二） | 82 → 84 |
+| 92 | 送元二使安西 | 36 → 84 |
+
+新版不再包含的 9 条旧数据没有删除，已统一改为 `HanziBookID=0`：
+
+- ID=79《长相思》
+- ID=83《士人读书》
+- ID=109《伯牙鼓琴》
+- ID=110《书戴嵩画牛》
+- ID=71《蝉》
+- ID=235“克勤于邦……”名言组
+- ID=104《春日》
+- ID=105《回乡偶书》
+- ID=238 艺术成语组
+
+## 供体书元数据
+
+经典记录迁出后，以下非目标上册的 `WordNum` 也已按实际行数同步：
+
+| MiaoguoBook.ID | BookIDOld | 类别 | WordNum |
+|---:|---:|---|---:|
+| 24 | 36 | 六下古诗文 | 18 → 15 |
+| 61 | 81 | 四下日积月累 | 7 → 6 |
+| 63 | 83 | 五下日积月累 | 7 → 5（更新前实际已有 6 行） |
+
+## 主要正文校正
+
+- 《司马光砸缸》改为教材标题《司马光》。
+- 《少年中国说》改为《少年中国说（节选）》并按新版图片校正文段。
+- 五上《古人谈读书》继续沿用库内分篇结构；《敏而好学》补齐新版《论语》五则，《士人读书》脱册。
+- 《浪淘沙·九曲黄河万里沙》改为教材标题《浪淘沙（其一）》。
+- 《两小儿辩日》迁入六上，并补正“一儿曰”。
+- 《数九歌》补回“三九四九冰上走”中遗漏的“九”。
+- 二上勤学名言改为“黑发不知勤学早，白首方悔读书迟”等新版三则。
+- 三上改正“锲而舍之，朽木不折；锲而不舍，金石可镂”。
+- 四上求学名言出处由《礼记》改为图片中的《中庸》，六则俗语按新版整体替换。
+- 五上惜时名言去掉旧版葛洪一则；治世/乱世成语按新版顺序重新分组。
+- 六上爱国名言新增《论语》一则，鲁迅名言新增《自题小像》一则。
+
+## 审计结论
+
+- 新增 17、迁移 7、脱册 9、数据库删除 0。
+- 12 本目标书的最终行数、标题、`Category/Tag/Sort` 全部匹配结构化源数据。
+- 所有明确变更及新增记录的 `PeomContent` 与来源完全一致，且全部为合法 JSON。
+- 9 条脱册记录仍存在，且 `HanziBookID=0`。
+- 15 本涉及元数据的 `UnitNum/WordNum` 均与对应 `BookIDOld` 的实际行数一致。
+- 提交后独立运行 `--audit` 通过。
+- 提交后再次运行 `--dry-run`，结果为新增 0、更新 0、迁移 0、脱册 0、元数据更新 0、删除 0。
+
+## 产物与校验值
+
+- 写入前完整备份：`backups/before_ancient_daily_2026_fall_2026-09-03T06-25-28-871Z.json`
+- 结构化来源：`source_ancient_daily_2026_fall.json`
+- 来源 SHA-256：`f760473c36c43c8df67eb192c9a21c492a977ee812c1dd7ee1c926794d16d3bb`
+- 更新程序：`update_ancient_daily_2026_fall.mjs`
+- 执行报告：`apply_ancient_daily_2026_fall.json`
+- 独立审计：`audit_ancient_daily_2026_fall.json`
+- 幂等复跑报告：`dry_run_ancient_daily_2026_fall.json`
+- 调研清单：`古诗文与日积月累调研清单_2026年秋.md`
+- OCR 快照：`research_ocr_2026_fall.json`
+- 更新前数据库快照：`research_db_snapshot_2026_fall.json`

.vscode/秒过知识库更新/古诗文与日积月累调研清单_2026年秋.md

@@ -0,0 +1,201 @@
+# 2026 年秋季古诗文与日积月累调研清单（待确认）
+
+> 状态：只读调研完成，尚未执行数据库写入。
+>
+> 图片来源：`/Users/chengjie/Downloads/2026年秋-语文`
+
+## 1. 数据范围与处理原则
+
+- 古诗文目标书：`MiaoguoBook.ID=13/15/17/19/21/23`，对应 `BookIDOld=25/27/29/31/33/35`。
+- 日积月累目标书：`MiaoguoBook.ID=54/56/58/60/62/64`，对应 `BookIDOld=74/76/78/80/82/84`。
+- 古诗、古文、现代背诵课文都放在 `AncientPoetry`；现代文 `Translation` 留空，`PeomContent` 按自然段保存为 JSON 数组。
+- 只修改、迁移或新增，不删除语文记录。旧教材内容若不再属于本次六册，拟将 `HanziBookID` 改成 `0` 脱册，正文仍保留。
+- 已存在于别册的经典内容迁移原记录，避免重复新增；迁移时同步改 `HanziBookID/Sort/Tag`。
+- 目标书的 `Sort` 拟统一为从 `0` 开始连续编号，顺序采用来源图片中的首次出现顺序；重复图片只计一次。
+- `MiaoguoBook.UnitNum` 均保持 `1`；`WordNum` 拟按最终 `AncientPoetry` 实际行数更新。
+
+## 2. 图片分段
+
+| 年级 | 日积月累图片 | 古诗文/背诵课文图片 | 备注 |
+|---|---:|---:|---|
+| 一年级上 | 10～17 | 18～33 | 18《天地人》没有“背诵课文”要求，暂不纳入 |
+| 二年级上 | 14～21 | 22～33 | 26～27 与 30～31 都是《田家四季歌》，拟去重 |
+| 三年级上 | 11～17 | 18～26 | 23～24、25～26 是现代文节选 |
+| 四年级上 | 11～17 | 18～26 | 24～26 是《观潮》第 3～4 自然段 |
+| 五年级上 | 11～17 | 18～27 | 26～27 是《白鹭》全文 |
+| 六年级上 | 08～14 | 15～22 | 22 是《少年闰土》第 1 自然段 |
+
+## 3. 古诗文最终清单
+
+### 一年级上：BookIDOld=25，1 → 8 条
+
+| Sort | 最终标题 | 动作 |
+|---:|---|---|
+| 0 | 金木水火土 | 新增；民间歌谣 |
+| 1 | 江南 | 保留现有 ID=2 |
+| 2 | 雪地里的小画家 | 新增；作者程宏明 |
+| 3 | 对韵歌 | 新增 |
+| 4 | 升国旗 | 新增 |
+| 5 | 小小的船 | 新增；作者叶圣陶 |
+| 6 | 两件宝 | 新增；作者陶行知 |
+| 7 | 比尾巴 | 新增；作者程宏明 |
+
+待确认项：《天地人》虽在本组首张图片，但图片中没有“背诵课文”要求，因此暂不计入；若纳入则最终为 9 条。
+
+### 二年级上：BookIDOld=27，4 → 7 条
+
+| Sort | 最终标题 | 动作 |
+|---:|---|---|
+| 0 | 登鹳雀楼 | 保留 |
+| 1 | 望庐山瀑布 | 保留 |
+| 2 | 江雪 | 保留；Tag 去掉误标的“日积月累” |
+| 3 | 敕勒歌 | 保留 |
+| 4 | 田家四季歌 | 新增；重复图片只生成一条 |
+| 5 | 树之歌 | 新增 |
+| 6 | 日月潭（节选） | 新增；仅第 2～4 自然段，作者吴壮达 |
+
+### 三年级上：BookIDOld=29，7 → 9 条
+
+| Sort | 最终标题 | 动作 |
+|---:|---|---|
+| 0～5 | 望洞庭、山行、夜书所见、鹿柴、望天门山、饮湖上初晴后雨 | 保留并重排；《鹿柴》Tag 去掉误标的“日积月累” |
+| 6 | 司马光 | 现 ID=37 从“司马光砸缸”改为教材标题“司马光” |
+| 7 | 秋天的雨（节选） | 新增；只录第 2 自然段，作者陶金鸿 |
+| 8 | 大自然的声音（节选） | 新增；只录第 2～3 自然段 |
+
+### 四年级上：BookIDOld=31，8 → 9 条
+
+| Sort | 最终标题 | 动作 |
+|---:|---|---|
+| 0～3 | 暮江吟、题西林壁、雪梅、精卫填海 | 保留并重排 |
+| 4～7 | 凉州词、出塞、夏日绝句、王戎不取道旁李 | 保留并按图片顺序重排 |
+| 8 | 观潮（节选） | 新增；只录第 3～4 自然段，作者赵宗成、朱明元 |
+
+### 五年级上：BookIDOld=33，现有 10 条，最终仍为 10 条
+
+| Sort | 最终标题 | 动作 |
+|---:|---|---|
+| 0～2 | 示儿、题临安邸、己亥杂诗 | 保留并重排 |
+| 3 | 少年中国说（节选） | 现 ID=76 改教材标题并按图片校正文段 |
+| 4～5 | 山居秋暝、枫桥夜泊 | 保留并重排 |
+| 6 | 早春呈水部张十八员外 | 迁移现 ID=123：BookIDOld 36 → 33，并去掉标题中的“（其一）” |
+| 7 | 敏而好学 | 保留现有拆分方式；补齐新版《论语》中的 5 则并调整顺序 |
+| 8 | 读书有三到 | 保留现有拆分方式并校正文段 |
+| 9 | 白鹭 | 新增；全文，作者郭沫若，不加“节选” |
+
+脱册但不删除：ID=79《长相思》、ID=83《士人读书》，拟改 `HanziBookID=0`。
+
+说明：教材目录统一写作《古人谈读书》，库内原来按篇拆成《敏而好学》《读书有三到》《士人读书》三条。新版图片只有前两篇，拟沿用库内拆分方式，去掉第三篇。
+
+### 六年级上：BookIDOld=35，9 → 10 条
+
+| Sort | 最终标题 | 动作 |
+|---:|---|---|
+| 0～3 | 宿建德江、六月二十七日望湖楼醉书、西江月·夜行黄沙道中、七律·长征 | 保留并重排 |
+| 4 | 浪淘沙（其一） | 现 ID=106 从“浪淘沙·九曲黄河万里沙”改为教材标题 |
+| 5～6 | 江南春、书湖阴先生壁 | 保留并重排 |
+| 7 | 两小儿辩日 | 迁移现 ID=119：BookIDOld 36 → 35，并按新版图片校正文段 |
+| 8 | 曹冲称象 | 新增古文 |
+| 9 | 少年闰土（节选） | 新增；只录第 1 自然段，作者鲁迅 |
+
+脱册但不删除：ID=109《伯牙鼓琴》、ID=110《书戴嵩画牛》，拟改 `HanziBookID=0`。
+
+## 4. 日积月累最终清单
+
+### 一年级上：BookIDOld=74，仍为 8 条
+
+顺序：咏鹅、画、数字成语、悯农（其二）、惜时名言、古朗月行（节选）、四则俗语、风。
+
+- 内容与图片总体一致。
+- ID=5 标题由《古朗月行》改为《古朗月行（节选）》。
+- 全部重新设置连续 `Sort=0～7`。
+
+### 二年级上：BookIDOld=76，7 → 8 条（`MiaoguoBook.WordNum` 当前已是 8）
+
+顺序：梅花、数九歌、小儿垂钓、山水对偶句、勤学名言、立志名言、夜宿山寺、交友处世名言。
+
+- 迁移现 ID=14《梅花》：`HanziBookID=0 → 76`。
+- ID=224《数九歌》修正“**三九四九冰上走**”（库内漏了一个“九”）。
+- ID=225 第一则由旧版“少年不知勤学苦……”替换为“**黑发不知勤学早，白首方悔读书迟。**”，并同步修改挖空标题。
+- ID=19《夜宿山寺》补齐日积月累 Tag。
+
+### 三年级上：BookIDOld=78，仍为 7 条
+
+顺序：所见、舟夜书所见、仁爱名言、团结俗语、早发白帝城、采莲曲、立志名言。
+
+- ID=267 第三则改为教材原文：“**锲而舍之，朽木不折；锲而不舍，金石可镂。**”
+- 同步修正挖空标题；全部重新设置连续 Sort。
+
+### 四年级上：BookIDOld=80，仍为 7 条
+
+顺序：赠刘景文、求学名言、秋季俗语、嫦娥、黄鹤楼送孟浩然之广陵、六则俗语、别董大。
+
+- ID=229 第一则出处由《礼记》改为图片中的《中庸》，并校正“明辨之，笃行之”。
+- ID=230 修正“把扇丟”为“把扇丢”。
+- ID=231 六则内容按新版图片替换为：
+  - 尺有所短，寸有所长。
+  - 仁者见仁，智者见智。
+  - 机不可失，时不再来。
+  - 差之毫厘，谬以千里。
+  - 一言既出，驷马难追。
+  - 知无不言，言无不尽。
+
+### 五年级上：BookIDOld=82，8 → 7 条
+
+顺序：动物成语、惜时名言、乞巧、治世/乱世成语、游子吟、渔歌子、观书有感（其一）。
+
+- 新增 1 条动物成语（Category=1，沿用挖空题格式）：
+  - 卧虎藏龙、龙马精神、龙飞凤舞、凤毛麟角
+  - 如虎添翼、如鱼得水、鹤立鸡群、一马当先
+  - 鼠目寸光、抱头鼠窜、狼心狗肺、狼狈为奸
+  - 狡兔三窟、呆若木鸡、虾兵蟹将、黔驴技穷
+- 迁移现 ID=114《游子吟》：BookIDOld 83 → 82。
+- ID=233 惜时名言按新版图片去掉旧版“葛洪”一则，保留陶渊明、岳飞、毛泽东三则。
+- ID=234 治世/乱世成语按新版图片顺序重新分组。
+- 现 ID=85《观书有感二首·其二》移到六年级上日积月累。
+- ID=71《蝉》、ID=235“克勤于邦……”脱册但不删除，拟改 `HanziBookID=0`。
+- 《观书有感二首·其一》标题按图片统一为《观书有感（其一）》；其二同理。
+
+### 六年级上：BookIDOld=84，仍为 7 条
+
+顺序：江畔独步寻花、爱国名言、观书有感（其二）、送元二使安西、过故人庄、五行/五谷/五音/五彩、鲁迅名言。
+
+- 迁移 ID=122《江畔独步寻花》：BookIDOld 81 → 84。
+- 迁移 ID=85《观书有感二首·其二》：BookIDOld 82 → 84。
+- 迁移 ID=92《送元二使安西》：BookIDOld 36 → 84。
+- ID=236 爱国名言最前补一则：“志士仁人，无求生以害仁，有杀身以成仁。——《论语》”。
+- ID=239 鲁迅名言第二项补：“寄意寒星荃不察，我以我血荐轩辕。——鲁迅《自题小像》”。
+- ID=104《春日》、ID=105《回乡偶书》、ID=238 艺术成语脱册但不删除，拟改 `HanziBookID=0`。
+
+## 5. 连带迁移与 MiaoguoBook 元数据
+
+按“WordNum 等于最终实际行数”的口径，拟更新如下：
+
+| MiaoguoBook.ID | BookIDOld | 类别 | 当前 WordNum | 最终 WordNum | 原因 |
+|---:|---:|---|---:|---:|---|
+| 13 | 25 | 一上古诗文 | 1 | 8 | 新增现代背诵课文等 |
+| 15 | 27 | 二上古诗文 | 4 | 7 | 新增 3 篇背诵课文 |
+| 17 | 29 | 三上古诗文 | 7 | 9 | 新增 2 篇现代文节选 |
+| 19 | 31 | 四上古诗文 | 8 | 9 | 新增《观潮（节选）》 |
+| 21 | 33 | 五上古诗文 | 9 | 10 | 当前实际已有 10 行，更新后仍 10 行 |
+| 23 | 35 | 六上古诗文 | 9 | 10 | 两篇旧古文脱册，迁入/新增 3 篇 |
+| 24 | 36 | 六下古诗文 | 18 | 15 | 三条迁往本次上册 |
+| 61 | 81 | 四下日积月累 | 7 | 6 | 《江畔独步寻花》迁出 |
+| 62 | 82 | 五上日积月累 | 8 | 7 | 新版只有 7 组日积月累 |
+| 63 | 83 | 五下日积月累 | 7 | 5 | 当前实际只有 6 行，《游子吟》迁出后为 5 行 |
+
+其余目标书 `WordNum` 不变；所有涉及书的 `UnitNum` 保持 `1`。
+
+## 6. 预计写入统计
+
+- 新增 `AncientPoetry`：古诗文/现代背诵课文 16 条，日积月累成语 1 条，共 17 条。
+- 迁移现有经典记录：7 条（含目标六册之间的《观书有感（其二）》迁移）。
+- 脱册保留：9 条，统一改 `HanziBookID=0`，不删除正文。
+- 其余为标题、正文、Tag、Sort、Category 及 `MiaoguoBook` 元数据校正。
+- 正式执行前会先生成完整备份和 dry-run 报告；执行后逐书核对行数、Sort 连续性、JSON 合法性、标题唯一性和 donor 书 WordNum。
+
+## 7. 需要确认的三点
+
+1. 一年级上《天地人》没有“背诵课文”要求，是否确认不纳入？（当前方案：不纳入。）
+2. 对新版图片中已经消失的 9 条旧记录，是否确认采用 `HanziBookID=0` 脱册、保留正文的方式？
+3. 是否确认 `Sort` 统一为图片顺序的 `0～N-1`，`WordNum` 按最终实际数据库行数计算，并同步修正 3 本供体书的 WordNum？

README.md

@@ -30,7 +30,7 @@ nvm use
 
 ```bash
 # 克隆仓库
-git clone https://scoreline.kylx365.com/kylx365/miaoguo_system_server.git
+git clone https://gogs.kylx365.com/kylx365/miaoguo_system_server.git
 cd miaoguo_system_server
 
 # 确保使用正确的 Node.js 版本

src/api/index/indexController.js

@@ -137,7 +137,7 @@ export async function indexInternalData(ctx) {
         let data1 = "";
         if (ctx.req.url === "/20170411") {
             data1 = fs.readFileSync("./public/internal/20170411.html").toString();
-            if (cookie === validCookies[0]) data1 = data1.replace("[替换]", "<p><a href='https://scoreline.kylx365.com/kylx365_db_admin'>DB维护</a></p>");
+            if (cookie === validCookies[0]) data1 = data1.replace("[替换]", "<p><a href='https://www.kylx365.com/kylx365_db_admin'>DB维护</a></p>");
             else data1 = data1.replace("[替换]", "");
         } else if (ctx.req.url.indexOf("20170411List") > 0) {
             data1 = fs.readFileSync("./public/internal/20170411List.html").toString();

src/api/virtualPay/virtualPayController.js

@@ -174,8 +174,8 @@ function calculateMemberUpdate(user, order, detail) {
     if (requestedMoment) {
         productServiceTime = requestedMoment.format('YYYY-MM-DD HH:mm:ss');
     } else {
-        const oldEndTime = moment(user.ProductServiceTime);
-        const baseTime = oldEndTime.isValid() && oldEndTime.isAfter(moment()) ? oldEndTime : moment();
+        const oldEndTime = parseMemberEndTime(user.ProductServiceTime);
+        const baseTime = oldEndTime && oldEndTime.isAfter(moment()) ? oldEndTime : moment();
         productServiceTime = baseTime.add(12, 'months').format('YYYY-MM-DD HH:mm:ss');
     }
 

src/api/yjbdc/readerController.js

@@ -14,31 +14,45 @@ import { fileURLToPath } from 'url';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
+const READER_BOOK_TITLES = [
+    'Strange-Life-of-a-Cat',
+    'Throne-of-Magical-Arcana',
+    'Zhui-Xu',
+    // 'Hidden-Assassin',
+    // 'Release-that-Witch',
+    // 'The-Legendary-Mechanic',
+];
+const READER_BOOK_TITLE_SET = new Set(READER_BOOK_TITLES);
+
+function getReaderBookTitle(ctx) {
+    const title = String(ctx.query.Title || '');
+    if (READER_BOOK_TITLE_SET.has(title)) return title;
+
+    ctx.status = 400;
+    ctx.body = { errcode: 400, errStr: '无效的书名' };
+    return null;
+}
+
+function getReaderChapter(ctx) {
+    const chapter = Number(ctx.query.Chapter);
+    if (Number.isInteger(chapter) && chapter > 0) return chapter;
+
+    ctx.status = 400;
+    ctx.body = { errcode: 400, errStr: '无效的章节号' };
+    return null;
+}
 
 export async function GetReaderBooks(ctx) {
-    let result = [
-        {
-            Title: "Strange-Life-of-a-Cat",
-        },{
-            Title: "Throne-of-Magical-Arcana",
-        },{
-            Title: "Zhui-Xu",
-        }
-        //,{
-        //     Title: "Hidden-Assassin",
-        // },{
-        //     Title: "Release-that-Witch",
-        // },{
-        //     Title: "The-Legendary-Mechanic",
-        // },
-    ];
+    const result = READER_BOOK_TITLES.map(Title => ({ Title }));
 
     ctx.body = { "errcode": 10000, result };
 }
 
 export async function GetReaderBooksChapter(ctx) {
+    const title = getReaderBookTitle(ctx);
+    if (!title) return;
     const param = {
-        Title: ctx.query.Title || "",
+        Title: title,
     };
 
     let result = [];
@@ -57,15 +71,15 @@ export async function GetReaderBooksChapter(ctx) {
 }
 
 export async function GetReaderBooksChapterContent(ctx) {
+    const title = getReaderBookTitle(ctx);
+    if (!title) return;
+    const chapter = getReaderChapter(ctx);
+    if (!chapter) return;
     const param = {
-        Title: ctx.query.Title || "",
-        Chapter: ctx.query.Chapter || "0",
+        Title: title,
+        Chapter: title === 'Strange-Life-of-a-Cat' ? chapter + 5 : chapter,
     };
 
-    if (param.Title === "Strange-Life-of-a-Cat") {
-        param.Chapter=param.Chapter+5; 
-    }
-
     let result = [];
 
     const {readFile} = fs.promises;
@@ -144,4 +158,4 @@ export async function GetReaderBooksChapterContent(ctx) {
     result=result.slice(1);
 
     ctx.body = { "errcode": 10000, result: result };
-}
+}

src/api/yjbdc/yjbdcController.js

@@ -290,7 +290,7 @@ export async function YJBDCLogin(ctx) {
                 Version: param.ProgramVersion,
             };
             let result3 = await commonModel.GetProductVersionList(param2);
-            if (result3) {
+            if (result3 && result3.length > 0) {
                 if ((param2.Version == result3[0].Version && result3[0].IsShowPay <= 0)
                     || param2.Version > result3[0].Version) {
                     userList[0].IsShow = result3[0].IsShowPay;

src/util/crypto/index.js

@@ -44,15 +44,32 @@ export function Decrypt(encryptedText, key, iv) {
         throw new Error('IV必须是16字节');
     }
 
-    const decipher = createDecipheriv(
-        'aes-128-cbc',
-        Buffer.from(key, 'utf8'),
-        Buffer.from(iv, 'utf8')
-    );
-    
-    let decrypted = decipher.update(encryptedText, 'base64', 'utf8');
-    decrypted += decipher.final('utf8');
-    return decrypted;
+    try {
+        const value = String(encryptedText ?? '');
+        if (!isBase64Ciphertext(value)) throw new Error('invalid base64 ciphertext');
+
+        const decipher = createDecipheriv(
+            'aes-128-cbc',
+            Buffer.from(key, 'utf8'),
+            Buffer.from(iv, 'utf8')
+        );
+
+        let decrypted = decipher.update(value, 'base64', 'utf8');
+        decrypted += decipher.final('utf8');
+        return decrypted;
+    } catch (cause) {
+        const error = new Error('无效的加密参数', { cause });
+        error.name = 'InvalidEncryptedDataError';
+        error.status = 400;
+        error.expose = true;
+        throw error;
+    }
+}
+
+function isBase64Ciphertext(value) {
+    return value.length >= 24
+        && value.length % 4 === 0
+        && /^[A-Za-z0-9+/]+={0,2}$/.test(value);
 }
 
 /**
@@ -77,10 +94,20 @@ export function decryptUrlMiddle() {
     return async (ctx, next) => {
         const apiFirstOld = "api";
         const apiFirst = "apiData";
+        const prefix = `/${apiFirst}/`;
         
         if (config.urlSecrets.require) {
-            if (ctx.request.url.includes(apiFirst)) {
-                const encryptedStr = decodeURIComponent(ctx.request.url.replace(`/${apiFirst}/`, ""));
+            if (ctx.request.url.startsWith(prefix)) {
+                let encryptedStr = '';
+                try {
+                    encryptedStr = decodeURIComponent(ctx.request.url.slice(prefix.length));
+                } catch {
+                    encryptedStr = '';
+                }
+                if (!isBase64Ciphertext(encryptedStr)) {
+                    await next();
+                    return;
+                }
                 const decryptedStr = Decrypt(
                     encryptedStr, 
                     config.urlSecrets.aes_key, 

src/util/stringClass.js

@@ -374,9 +374,10 @@ export const stringUtils = {
     },
     //替换字符串中所有匹配项
     ReplaceAllString: (str, replaceStrFrom, replaceStrTo) => {
-        if (str && str.length > 0) {
-            const reg = new RegExp(replaceStrFrom, "g");
-            return str.toString().replace(reg, replaceStrTo);
+        if (str && str.length > 0 && replaceStrFrom !== undefined && replaceStrFrom !== null) {
+            const search = String(replaceStrFrom);
+            if (search.length === 0) return str.toString();
+            return str.toString().split(search).join(String(replaceStrTo ?? ''));
         }
         return str;
     },

test/errorRegression.test.js

@@ -0,0 +1,75 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import config from '../src/config/index.js';
+import { Decrypt, Encrypt, decryptUrlMiddle } from '../src/util/crypto/index.js';
+import { stringUtils } from '../src/util/stringClass.js';
+import { GetReaderBooksChapter, GetReaderBooksChapterContent } from '../src/api/yjbdc/readerController.js';
+
+test('ReplaceAllString 将正则特殊字符按普通文本替换', () => {
+    assert.equal(stringUtils.ReplaceAllString('a+b+c', '+', '___'), 'a___b___c');
+    assert.equal(stringUtils.ReplaceAllString('a.b.c', '.', '-'), 'a-b-c');
+});
+
+test('Decrypt 正常往返并将无效密文标记为 400', () => {
+    const encrypted = Encrypt('Ping?UserID=1', config.urlSecrets.aes_key, config.urlSecrets.aes_iv);
+    assert.equal(Decrypt(encrypted, config.urlSecrets.aes_key, config.urlSecrets.aes_iv), 'Ping?UserID=1');
+
+    assert.throws(
+        () => Decrypt('not encrypted', config.urlSecrets.aes_key, config.urlSecrets.aes_iv),
+        error => error.name === 'InvalidEncryptedDataError' && error.status === 400
+    );
+    assert.throws(
+        () => Decrypt('AAAAAAAAAAAAAAAAAAAAAA==', config.urlSecrets.aes_key, config.urlSecrets.aes_iv),
+        error => error.name === 'InvalidEncryptedDataError' && error.status === 400
+    );
+});
+
+test('URL 解密中间件忽略 apiData 下的普通静态资源路径', async () => {
+    const previousRequire = config.urlSecrets.require;
+    config.urlSecrets.require = true;
+    const ctx = { request: { url: '/apiData/web/School/0221_02.jpeg' } };
+    let nextCalled = false;
+    try {
+        await decryptUrlMiddle()(ctx, async () => { nextCalled = true; });
+    } finally {
+        config.urlSecrets.require = previousRequire;
+    }
+
+    assert.equal(nextCalled, true);
+    assert.equal(ctx.request.url, '/apiData/web/School/0221_02.jpeg');
+});
+
+test('URL 解密中间件只重写有效的加密 API 地址', async () => {
+    const previousRequire = config.urlSecrets.require;
+    config.urlSecrets.require = true;
+    const encrypted = Encrypt('Ping?UserID=1', config.urlSecrets.aes_key, config.urlSecrets.aes_iv);
+    const ctx = { request: { url: `/apiData/${encodeURIComponent(encrypted)}` } };
+    try {
+        await decryptUrlMiddle()(ctx, async () => {});
+    } finally {
+        config.urlSecrets.require = previousRequire;
+    }
+
+    assert.equal(ctx.request.url, '/api/Ping?UserID=1');
+});
+
+test('阅读器章节接口拒绝缺失或不在书单内的 Title', async () => {
+    for (const controller of [GetReaderBooksChapter, GetReaderBooksChapterContent]) {
+        const ctx = { query: { Title: '' } };
+        await controller(ctx);
+        assert.equal(ctx.status, 400);
+        assert.deepEqual(ctx.body, { errcode: 400, errStr: '无效的书名' });
+    }
+});
+
+test('阅读器正文接口校验章节号并正确换算回到过去变成猫的章节', async () => {
+    const invalidCtx = { query: { Title: 'Strange-Life-of-a-Cat', Chapter: 'not-a-number' } };
+    await GetReaderBooksChapterContent(invalidCtx);
+    assert.equal(invalidCtx.status, 400);
+    assert.deepEqual(invalidCtx.body, { errcode: 400, errStr: '无效的章节号' });
+
+    const validCtx = { query: { Title: 'Strange-Life-of-a-Cat', Chapter: '1' } };
+    await GetReaderBooksChapterContent(validCtx);
+    assert.equal(validCtx.body.errcode, 10000);
+    assert.ok(validCtx.body.result.length > 0);
+});

test/virtualPayFulfillment.test.js

@@ -138,6 +138,25 @@ test('会员有效期兼容小程序提交的斜杠日期且不触发 Moment 回
     assert.equal(result.memberUpdate.ProductServiceTime, '2032-05-14 00:00:00');
 });
 
+test('续费基准日期兼容数据库中的斜杠日期', async () => {
+    const order = paidMemberOrder({
+        TradeNo: 'VP_TEST_OLD_SLASH_DATE',
+        XMLPre: orderXml({ productId: '166_199', detail: {} })
+    });
+    const user = { ...memberUser, ProductServiceTime: '2032/05/14' };
+    const { connection } = createFakeConnection({ order, user });
+
+    const result = await fulfillOrder('VP_TEST_OLD_SLASH_DATE', {
+        openid: 'openid-test',
+        env: 0,
+        productId: '166_199',
+        originalPrice: 19900,
+        actualPrice: 19900
+    }, dependencies(connection));
+
+    assert.equal(result.memberUpdate.ProductServiceTime, '2033-05-14 00:00:00');
+});
+
 test('重复发货通知不会重复增加会员有效期', async () => {
     const { connection, state } = createFakeConnection({
         order: paidMemberOrder({ Status: 1 }),