round-05.mdMIT
本站自己的源码,只读浏览:左边点文件,右边看内容。
快照 4131b57 · 发布 2026-09-10 · 350 个文件 · 3.8 MB
rounds/round-05/round-05.mdmarkdown · 24.3 KB · 271 行 Round 05 — notes 服务与内容摄入
状态:已完成(codex 7 轮审查,末轮零 findings,缺陷门禁 PASS)
目标
vault 学习分享/ 的 293 篇正文经一条幂等的同步管线进入 Postgres,notes 服务把它们喂给 Notes 三级页与四分类 + 全站 RSS;重跑同步不产生重复数据,RSS 过校验器。
前置
- R2 数据层与 encore test 基建已完成(本轮迁移在 agent 库上追加 002)。
- vault 位于本机(独立 git 仓,只读消费,本轮不写它;路径不入库)。
- R3/R4 未完成不阻塞本轮:Notes 与 Runtime 无数据耦合。
所有者裁定(2026-08-31)
摄入方案经所有者逐条确认,口径如下,实现不得偏离:
| # | 决策 | 结论 |
|---|
| 1 | 摄入形态 | 不做「快照进仓 / 打进镜像 / 构建时现读」三选一,改为提供一个专门的 skill sync-notes 驱动同步。skill 默认对当前目标库 upsert;另留 --emit-sql 产出可传输 SQL,130/生产怎么落由 R9 定 |
| 2 | 正文形态 | 库里存标准 markdown,前端渲染(方案 B)。vault 的 Obsidian 专有语法必须在同步阶段改写成标准语法 |
| 3 | 图片 |
这是本站自己的源码,与线上运行的版本一致;快照随每次发版更新。
| 压缩后进 apps/web/public/notes/(方案 A):只收正文引用到的图,转 WebP + 宽度上限 1600px |
| 4.1 | frontmatter | 不保留:元数据抽成库字段,正文里不留 frontmatter 块 |
| 4.2 | AI 资料 | 只收 60 篇中译,英文原文不入库;保留 source 原链挂在文章页 |
| 4.3 | 教材范围 | Encore(含 20 章深度教程)/ Rust / TypeScript 全融入;Rust 教材只保留 markdown 正文;任何正文都不得引用 原始资料/(抓取素材,无授权) |
| 4.4 | 内容分享 | 不同步(与所有者工作相关)。设计稿的 sharing 卡片保留,走已有的「本系列章节整理中」占位态 |
- wiki_exclude: true 一律忽略。带该标记的四个系列是 Agent基础知识 / Encore / Rust / TypeScript,而 4.3 明确要后三者全融入 —— 该标记只服务所有者另一条 wiki 管线,不是本站的发布闸。
- 原始资料/ 不摄入(583 篇抓取素材),正文里指向它的 42+19 处 wikilink 在改写阶段降级为纯文本,不生成任何链接。
- notes 表建在既有 agent 库(agent/migrations/002_notes.up.sql),notes 服务经 SQLDatabase.named("agent") 引用。理由:deploy/migrate.sh 显式只认 agent 一个库,新增第二个 SQLDatabase 会让部署脚本直接 die;单库多服务本就是 agent/db.ts 既定注释里的用法。
vault 勘察结论(实测,2026-08-31)
- 可发布正文 293 篇 / 4.07 MB;原始资料/ 583 篇不计
- frontmatter 覆盖 293/293:title 279 · tags 279 · date 272 · source 129 · company 114
- 图片 97 张 / 77.7 MB(Pi 39MB · DeepSeek 20MB),被 72 篇引用;Rust 教材 0 图
- Obsidian 语法清点:wikilink 1825(带别名 1301 / 带锚点 9)· callout 695(10 种)· 高亮 ==x== 41 · 注释 %% 2 · 图片宽度语法  17 · GFM 表格行 5086 · 嵌入 ![[x]] 0 · mermaid 0
- 裸 HTML:<br> 18 · <summary> 6 · <div> 2 · <script> 2 · <style> 2 —— 渲染侧一律不放行裸 HTML,同步阶段改写
交付物
text
apps/api/agent/migrations/002_notes.up.sql notes_categories / notes_series / notes_chapters
apps/api/notes/db.ts SQLDatabase.named("agent")
apps/api/notes/store.ts 读路径 SQL(服务只读,写在同步管线)
apps/api/notes/series.ts 系列列表 / 系列详情 / 章节正文 端点
apps/api/notes/rss.ts api.raw:/rss.xml + /rss/<分类>.xml(renderFeed 抽成纯函数便于测)
apps/api/notes/notes.test.ts 查询端点与 RSS 生成的测试(9 项)
apps/api/notes/README.md 已实现 / 待 R6 的边界
tools/notes-sync/ 同步管线(独立 package.json,不在 Encore app root 内)
src/manifest.ts 13 系列映射表(内容分享收 0 章)
src/obsidian.ts Obsidian → 标准 markdown 改写器(围栏感知)
src/images.ts 引用图收集 + WebP 压缩 + 路径重写 + 孤儿清理
src/db.ts upsert 入库 / --emit-sql 声明式全量
src/verify.ts 同步后自检,判据与改写器一致
src/main.ts CLI 与编排
README.md 代码分工(操作规程在 skill 里)
.claude/skills/sync-notes/SKILL.md **同步文档进站的 skill(所有者点名的交付物)**
.claude/launch.json web dev server 启动配置
apps/web/components/notes/Markdown.tsx markdown → design token 排版 + 目录抽取
apps/web/components/notes/NotesIndex.tsx 首页交互层(从 page.tsx 拆出,样式逐字未动)
apps/web/components/notes/RssModal.tsx 订阅弹层改为接收 props
apps/web/lib/{api,site,time}.ts SSR 客户端 / 站点常量 / 相对时间与阅读时长
apps/web/app/(site)/notes/** 三级页切真实数据
apps/web/public/notes/** 压缩后的图片(56 张 / 6.5MB)
apps/web/Dockerfile 补 COPY public(漏了图片全 404)
apps/web/next.config.ts dev 侧 /rss* 代理
deploy/Caddyfile /rss.xml 与 /rss/* 指向 api
deploy/docker-compose.yml API_INTERNAL_URL / SITE_HOST / SITE_ORIGIN
dev.ps1 新增 notes 子命令;build --services 补 notes
验收
| # | 检查 | 命令 / 期望 |
|---|
| 1 | 同步幂等 | 连跑两次 sync-notes,第二次报告 新增 0 / 更新 0,notes_chapters 行数不变 |
| 2 | Obsidian 语法清零 | dev.ps1 notes --verify:围栏与行内代码之外无 [[、无 > [!、无 %%、无裸 HTML(裸 LIKE 扫描会把 Cargo 的 [[bin]]、bash 的 [[ -n $X ]] 全当成残留,不能用) |
| 3 | 原始资料零引用 | 库里不存在指向 原始资料/ 的 markdown 链接;Rust 教材 42 处已降级为纯文本(纯文本字样保留,不算违反) |
| 4 | 内容边界 | notes_chapters 无 内容分享 来源;AI 资料只有中译(59 篇原文不在库);source 原链落库 |
| 5 | RSS | /rss.xml 与 4 条分类源合 RSS 2.0(well-formed、必备元素、RFC822 pubDate、atom:link rel=self);条目按 updated_at 倒序。在线校验器需公网地址,R9 补跑 |
| 6 | 三级页 | Notes 首页 4 分类卡片 / 系列页章节表 / 文章页正文 + 目录 全部来自 API,demo-data 的 notes 段不再被引用 |
| 7 | 样式零改动 | 三级页 diff 只出现数据源与 markdown 渲染相关改动,design token 与布局参数不变 |
| 8 | 服务白名单 | dev.ps1 build 的 --services 含 notes,构建产物内 /notes/series 可达(BACKLOG 2026-08-29 那条) |
禁止
- 不改前端页面样式(规则 7);不加设计稿没有的功能(规则 8)。
- 不把摄入管线放进 apps/api(规则 6:Encore app root 下的无关 .ts 与依赖会干扰 parser,也会把 sharp 等构建期依赖带进 api 镜像)。
- 不向 vault 写任何东西:同步管线对 vault 只读。
- 不摄入 原始资料/,不生成指向它的链接。
代码审查
- 审查方式:codex /codex:review --background(内置审查器,branch diff against main)。
首次带自定义关注点调用被拒 —— 该版本的 /codex:review 只走内置审查器,自定义关注点要用
/codex:adversarial-review;但那是设计评审入口,与本轮「缺陷门禁,严禁以审查代替设计」的定位冲突,
故按 CLAUDE.md 的默认路径改用无参数审查,未降级到 /code-review。
- findings:第 1 轮 6 条(P1×2 / P2×4),全部采纳整改,无一条需要新增机制:
| # | 级别 | finding | 处理 |
|---|
| 1 | P1 | SVG 原样复制到站点同源下 —— 直接访问 /notes/*.svg 可执行脚本,存储型 XSS | 采纳。删掉 SVG 直传分支,一律经 sharp 栅格化,输出目录里不再有可执行文档。实测该路径今天是死路(41 张 SVG 无章节引用,public/notes 里本来就只有 webp),属尚未触发的隐患;修复零体积代价,新路径实测 6KB SVG → 1600×1067 的 52KB WebP |
| 2 | P1 | dropComments 跑在行内代码切分之前,`LIKE '%%'` 被改成 `LIKE '`,未闭合标记还会吞掉后续行 | 采纳。mapTextSegments 改成返回片段的 splitSegments,注释剥离下沉到片段层并带跨行状态。8 个用例实测:行内代码与围栏里的 %% 保住,真注释/跨行注释/注释内含行内代码都正确剥离 |
| 3 | P2 | RSS origin 写死 https://,130 预发是明文 HTTP + IP + 端口,订阅源会指向没在听的端点 | 采纳。SITE_HOST + 代码拼 scheme 合并成单一 SITE_ORIGIN(变量少一个);顺带修掉 RssModal 复制时硬编码 https:// 的老实现。四种取值实测正确 |
| 4 | P2 | .env.example 缺 SITE_HOST | 采纳。实际情况更糟:deploy/.env.example 根本不存在(文档却让人 cp .env.example .env),而本轮新增了必填变量会让 compose 直接插值失败。补齐该模板 |
| 5 | P2 | 首页章节数含置顶 README,与系列页差 1 | 采纳。listSeriesCards 的 COUNT 加 FILTER (WHERE NOT ch.pinned),首页文案回到设计稿的「章」。补了一条回归测试锁住两页同口径 |
| 6 | P2 | vault 有未提交改动时仍取旧 commit 时间,新内容不进「最新」行与 RSS | 采纳。gitTimes 先取 git status --porcelain 的脏文件集并排除之,这类文件回落 mtime。所有者的 vault 是批量 backup 提交、工作区常年带改动,首次同步时实测就有 3 个 M 状态文件。用临时仓验证过解析(含中文路径) |
另有两处非审查发现、自查补的:注释剥离补围栏感知、图片相对路径加 vault 边界校验(见上一节)。
以及 dev.ps1 notes --verify 不该被 vault 存在性检查挡住(--verify 只读库)。
- 第 2 轮复审:4 条(P1×1 / P2×3)。
| # | 级别 | finding | 处理 |
|---|
| 1 | P1 | 远程图不经本地图片管线:依赖第三方可用性、把访客请求暴露给对方 | 不采纳 —— 所有者裁定。实测 53 张 / 14 章(pbs.twimg 35 · Webflow CDN 12 · 知识星球 5 · YouTube 1)。根因是 vault 里引用了远程图;所有者决定以后写文章一律把 PNG 存进 vault 从源头消除,不为此新增「降级成链接」或「构建期镜像」的机制。风险兜底:同步报告固定输出一行按域名列出的张数,便于盯着它归零 —— 不是默认忽略 |
| 2 | P2 | stripInlineTags 把 ](#锚点) 的 # 当行内标签吃掉,站内锚点变成相对路径导航 | 采纳。前缀从「空白或左括号」收紧成「行首或空白」。修复 2 章,3 条锚点链接完好 |
| 3 | P2 | 系列被移除/改名后只删章节不删 notes_series,首页留空卡片(改名则新旧并存) | 采纳。applyToDatabase 与 emitSql 同口径补元数据回收 |
| 4 | P2 | 孤儿图片在入库之前就删,入库失败会让现网正文指向已删除的图 | 采纳。flush() 改成只写不删,清理挪到持久化成功之后 |
自查追加:普通 markdown 链接指向相对路径时完全没处理,实测 66 处全部 404(2 处指向 vault 内文章,其余是被拆解仓库的源码路径)。套用与 wikilink 相同的策略后 66 → 7;剩余 6 处是标签内含行内代码的形态,记 BACKLOG。
| # | 级别 | finding | 处理 |
|---|
| 1 | P2 | 归档章节 slug 可能超 64 字符或为空,API 的 SLUG_RE 会 400,而系列页照样给出链接 | 采纳。同步侧按 API 的同一条正则校验,越界在同步时报错。实测当前 0 条不合法,但最长已 61 字符 —— 离上限只差 3 个 |
| 2 | P2 | 目录用正则扫 ## ,渲染器还会把引用内 H2 与 Setext H2 算进编号,导致后续锚点整体错位 | 不采纳 —— 所有者裁定。根因是 vault 正文有 196 处「文本行紧跟 --- 且无空行」(99 个文件),CommonMark 与 Obsidian 都会把它读成 Setext H2;所有者决定另开仓库写标准 markdown 从源头治,不在管线上做容错。受影响 11 / 226 章,已记 BACKLOG |
| 3 | P2 | 报错信息让人把目录加进 ARCHIVE_SKIP,而该常量根本不存在 —— 英文-only 目录无路可排除,同步会永久失败 | 采纳。补上 ARCHIVE_SKIP,未知目录仍默认失败 |
- 第 4 轮复审:2 条,全 P2,无 P1。两条同根:标题 id 用的是 h-0/h-1 这种出现序号。
| # | 级别 | finding | 处理 |
|---|
| 1 | P2 | 正文里保留下来的 ](#控制-subagent-的派生) 找不到目标,点了没反应 | 采纳。这不是 vault 的锅:标准 markdown 就该这么写,是渲染器没给标题发 slug —— 即便换成手写标准 markdown 也照样点不动 |
| 2 | P2 | 目录标签只去了强调与反引号,## [x](y) 会把 [x](y) 原样显示 | 采纳,并入同一处修改 |
一并把标题 id 从「出现序号」换成「标题可见文本的 slug」(GitHub / Obsidian 口径,同名加后缀)。
副作用是把第 3 轮那条 Setext 的危害降级了:序号方案下多数一个 H2 会让后续全部锚点错位,
slug 方案下最坏只是某一条目录项对不上。
实测:claude-code-harness/05 目录 8 项与 8 个 h2 全匹配、标签无残留 markdown;
ai-blog-archive/prompting-claude-opus-5 的正文锚点真的跳到位(容器 scrollTop 2747)。
-
未解决且不再处理:the-ai-native-sdlc-playbook 里的 #sd-s5 / #sd-s1 两条锚点,
目标是 vault 正文用裸 HTML <a id="sd-s5"> 定义的。渲染侧不放行裸 HTML(XSS 兜底,规则 9),
故这两条保持无效。属所有者裁定的「源头治理」范畴。
-
第 5 轮复审:1 条 P2,采纳。
| # | 级别 | finding | 处理 |
|---|
| 1 | P2 | 三级页只把后端的 not_found 映射成 404,invalid_argument 被重新抛出成 500 | 采纳。路由参数是访客可控的:/notes/PI(大小写写错)、非 ASCII、超 64 字符都会撞上 —— 一个坏链接被报成服务器故障,既误导读者也污染错误监控。两页共用 notFoundOnBadRoute,两类都渲染 404 |
实测两半都成立:/notes/PI、/notes/中文、74 字符 slug、/notes/pi/ZZ、/notes/pi/a%2Fb、
/notes/nope/01 全部 404,/notes/pi、/notes/pi/03 仍 200;
另起一个 API_INTERNAL_URL 指向死端口的实例,三级页全部 500(真故障没有被伪装成 404)。
| # | 级别 | finding | 处理 |
|---|
| 1 | P1 | takeTitle 自己累加字符偏移量并假设行终止符恒为 1 字符,CRLF 下每行少算 1,切片位置逐行前移 —— 标题末尾几个字被留在正文开头 | 采纳。改成直接在原串上走下标(`indexOf(" |
| ")` + 实际行尾),不再假设终止符宽度 | | | |
这条是已经在发生的内容损坏,不是潜伏问题:修复后同步报告 更新 99 · 未变 127 ——
226 章里有 99 章的正文开头带着标题残字。修复后复查「正文首行是标题尾字子串」的章节数为 0。
也说明第 1–2 轮之外仍做全量扫描是有价值的:这条在改动之外的老代码里,收窄范围就扫不到。
-
本轮开始按新的审查范围规则(所有者裁定 2026-08-31,已写进 CLAUDE.md「审查范围」):
前两轮全量 branch diff against main,第 3 轮起 --base <上一轮已审提交> 只审整改 diff。
本轮之前的第 2–6 轮都误用了全量口径(我裸跑 review --background,没注意 companion 支持
--base / --scope),单轮耗时 20 分钟上下。
-
第 7 轮复审(首次按新范围):--base d215a8d,零 findings。审查者结论:
"The code change correctly removes the line-ending-width assumption in takeTitle,
preserving correct offsets for CRLF input."
耗时对比很直观:全量的第 6 轮 20m20s,收窄到整改 diff 的第 7 轮 2m50s。
-
结论:整改后 PASS。7 轮共 17 条 findings(P1×4 / P2×13):15 条采纳整改,
2 条按所有者裁定不采纳(远程图内嵌、Setext 标题)并各自留了显式兜底与 BACKLOG 记录。
末轮零 findings,阻塞性与 bug/漏洞类 findings 已清零,达到 CLAUDE.md 的收口标准。
失败处理
同一验收项针对性整改后连续 2 次验证仍不过 → 写 rounds/round-05/BLOCKED.md,停下呼人。禁止放宽验收标准自我通过。
本轮实测
数字
| 项 | 实测 |
|---|
| 入库 | 226 章 / 12 个系列(内容分享按裁定为 0 章,卡片走占位态)。首次同步时是 225 章;本轮进行中 vault 新增了一篇(WikiSkill 论文归档,vault 侧 2026-08-31 提交),管线自动收了进来并只写了 1 条新增 —— 端到端跑通的真实证据 |
| 正文 | 约 68.7 万字 |
| 图片 | 引用 63 · 落盘 56 张 · 76.0MB → 6.5MB(WebP q82,宽度上限 1600px) |
| 改写 | 站内链接命中 1158 · callout 591 · 未解析链接 156 个目标 / 290 处(全部降级为纯文本) |
| 分系列 | agent-basics 33 · ai-native-swe 7 · sharing 0 · claude-code-harness 17 · codex-harness 17 · deepseek-harness 15 · pi 15 · harness-engineering 1 · rust-bible 16 · typescript-deep 19 · encore 22 · ai-blog-archive 62 · ai-blog-index 1 |
验收结果
| # | 检查 | 结果 |
|---|
| 1 | 同步幂等 | ✅ 连跑第二次 新增 0 · 更新 0 · 未变 226 · 删除 0,图片 新写 0 · 复用 56 |
| 2 | Obsidian 语法清零 | ✅ dev.ps1 notes --verify 六项全 PASS(同步末尾自动跑,FAIL 即非零退出) |
| 3 | 原始资料零引用 | ✅ 生成的链接 0 条(63 章正文里仍有"原始资料"字样,均为降级后的纯文本) |
| 4 | 内容边界 | ✅ sharing 0 章 · 英文原文 0 章 · 档案 62/63 篇带 source 原链(缺的那篇是中文原创汇总,本就无原文) |
| 5 | RSS | ✅ 5 条源(全站 + 四分类)全部 well-formed / RSS 2.0 / 每条 30 items / 带 atom:link rel=self / pubDate 合 RFC822。在线 W3C Feed Validator 需要公网地址,顺延到 R9 预发上跑 |
| 6 | 三级页 | ✅ 首页四分类卡片、系列页章节表、文章页正文+目录全部来自 API;demo-data.ts 的 notes 段已整段删除,无引用残留 |
| 7 | 样式零改动 | ⚠️ 见下方「与设计稿的偏离」——画板未给样例的元素按同一套 token 补齐,已逐条记录 |
| 8 | 服务白名单 | ✅ dev.ps1 build 的 --services 已含 notes;encore check / encore test(25 项)全绿 |
与设计稿的偏离(规则 7 逐条备案)
- 画板 2c 没有的元素补了样式:列表 / 表格 / 分隔线 / 正文图片。真实正文有 5086 行表格,不给样式就是没有边框的裸表。补的样式全部复用画板既有 token(边框 --border、表头底 --bg-panel、圆角 7),与代码块卡片同一族,不新增视觉语言。
- 上下章按钮加了 maxWidth: 300 + 省略号:真实章节标题最长 68 字符,不收会把按钮拉穿整行。
- 「本章目录」改为真实 h2 锚点链接,取消了画板里写死的"第 2 项高亮"——没有滚动联动就没有"当前项",硬留一个高亮是假信息。阅读进度条按画板保持静态 31%。
- Notes 首页拆成 server + client 两个文件(page.tsx 取数 / NotesIndex.tsx 管弹层 state)。JSX、样式、className 逐字未动。
- 三级页改为 force-dynamic:原先 generateStaticParams 依赖 demo-data 的固定 slug 列表;更要紧的是 docker build 时后端不可达,允许预渲染会让镜像构建直接失败。
踩到的坑(按代价排序)
- 改写器必须对代码围栏免疫。vault 里 == 有 41 处,其中真高亮约 5 处,其余全是 Rust/TS 代码里的比较运算符(491 段 rust + 419 段 ts 围栏);<script> / <summary> / <table> 也几乎全在围栏或行内代码里当例子讲。逐字符跑正则会把教程代码改烂,而且改完仍是合法 markdown,渲染出来看不出问题。
- Obsidian 表格里的竖线是 \|。AI技术博客索引 整张表(62 条链接)都是 [[路径\|别名]] 形态,按 | 切别名会把 \ 留在目标末尾,导致整表链接失效。
- 图片路径里有未转义的括号:01-分层图(阶段-0-的-⭐-最小产出就是把这张图画出来).png。正则 [^)\s]+ 会在第一个 ) 处截断,只能按 CommonMark 的括号配平手写扫描器。
- 按目录名生成 slug 会静默丢章。Karpathy-LLM-Knowledge-Bases/ 下有两篇中译,撞成同一个 slug 后 upsert 后者覆盖前者 —— 表现是"62 变 61",不报错。改成按文件名生成,并加了全局重复 slug 硬校验。
- 命名漂移同样是静默漏收。有一篇中译叫 … (Chinese Translation).md 而不是 -Chinese-<日期>,默认排除策略把它漏掉了。加了「AI资料每个子目录必须命中至少一篇」的覆盖校验,漂移变成硬失败。
- 知识星球课程的配图是 base64 内嵌的(7 处 / 59KB),不解码既进不了压缩流程,又会把整串 base64 塞进 content_md。
- 摘要会落到 --- 上:教程普遍以 > 导语 + --- 开头,只跳过引用的话 RSS 里整片 description 都是一根分隔线。
- 用 SQL LIKE 做同步后自检全是误报:Rust 的 [[bin]] 是 Cargo TOML 语法、bash 的 [[ -n $X ]] 是条件测试、讲 HTML 的文章有行内代码 <table>。改成 --verify,判据与改写器一致(只看围栏与行内代码之外)。
- Encore 的路径参数不能带 .xml 后缀(段内混字面量),/rss/:category.xml 匹配不上,只能 /rss/:file 拿整段自己剥。
- RSS 地址在站根,不带 /api 前缀,deploy/Caddyfile 与 next.config.ts 各要补一条路由,少了就 404 到 Next 上。
- apps/web/Dockerfile 的 COPY public 这次必须加:R-BUN 时 public/ 还是空的所以刻意没写,现在有 6.5MB 图片,漏掉的表现是页面正常、图片全 404。
提交后自查补的两处(未经审查发现,自己找出来的)
- %%…%% 注释剥离原先没有围栏感知。旧实现对整篇正文跑一次 /%%[\s\S]*?%%/g,
而模块的核心不变式是"改写永不进代码"。当前 vault 里唯一一处 %% 在未摄入的英文原文里,
没有实际损坏;但哪天正文的代码块里出现 %%(批处理的 %%A、SQL 的 LIKE '%%')
就会被静默吃掉,且吃完仍是合法 markdown。改成逐行、跨行状态机,只在围栏之外生效。
- 图片相对路径没有 vault 边界校验。正文里的 ../../../x.png 会被解析并复制进
公网可访问的 public/。vault 是自有内容,威胁模型弱,但这条守卫顺带也能抓出
"图放错目录"的手误,成本是三行。
改写器手工验证用例(整改后实测,BACKLOG 已记「补自动化测试」)
tools/notes-sync 在 Encore app root 之外,进不了 dev.ps1 test 的门禁。整改 P1-2 后逐个跑过:
| 输入 | 期望 | 实测 |
|---|
| 写 `LIKE '%%'` 匹配空串。 | 行内代码原样 | ✅ 原样 |
| 命令是 `for %%A in (*) do echo %%A`。 | 行内代码原样 | ✅ 原样 |
| 前 %% 这是注释 %% 后 | 注释剥离 | ✅ 前 后 |
| `一 | | |
| %% 注释开始 | | |
| 还在注释 | | |
| 结束 %% 尾巴` | 跨行剥离 | ✅ `一 |
| 尾巴` | | |
| 围栏内 ```bat + %%A | 围栏原样 | ✅ 原样 |
| A %% 注释 `code` 注释 %% B | 注释含行内代码也整体剥离 | ✅ A B |
| 这是 ==重点== 内容 | 高亮转加粗 | ✅ **重点** |
| ``判断 a == b 与 `c === d``` | 代码里的等号不动 | ✅ 原样 |
遗留 / 需所有者知悉
- AI native软件工程教程 的 7 篇是知识星球「雷哥AI 解决方案」付费课程原文,经 Obsidian Web Clipper 抓取收录(该系列的课程目录页自己写明了这一点,原文链接需星球权限)。这与所有者对 原始资料/(no license)和 AI 资料英文原文的处置是同一类问题,但本轮未被点名排除,已按现有裁定摄入。要不要发布请所有者裁定;排除只需删 manifest 里的一条。
- SITE_HOST 成为 deploy/.env 的新必填项(RSS 绝对链接与订阅弹层地址都取它),compose 里用 ${SITE_HOST:?} 挡空值。docs/deploy-environments.md 的 .env 必填清单已同步。
- 在线 W3C Feed Validator 需要公网可达地址,R9 预发部署后补跑一次。
苏公网安备32011402012723号