[开发] SoBBS（FlintHub 1.5.0 → Go）开发规划方案

0. 文档导读

0.1 本方案要解决的问题

用 Go 重写 FlintHub 1.5.0，并满足一条硬性承诺：

同一份 data/ 目录，PHP 版与 Go 版可以交替启动，读写结果一致；切换只需改 Nginx upstream，不需要数据迁移。

这不是"重写一个论坛"，而是"换一个进程去读写同一套已有数据"。因此本方案的重心不是功能列表，而是兼容契约、数据真相源、阶段验收。

0.2 阅读路径

0.3 阶段推进规则

1. 严格按 B0 → B1 → … → B10 顺序推进，前一阶段验证报告未通过，不进入下一阶段。
2. 每个阶段结束必须产出 docs/reports/Bx-verify.md，内容至少包含：
   • 本阶段任务完成清单（逐条对应任务 ID）；
   • 执行的测试命令与结果；
   • 兼容性用例结果（涉及数据层的阶段必填）；
   • 已知问题与是否阻断下一阶段；
   • 下一阶段准入结论。
3. 每个阶段只允许修改本阶段范围内的文件；跨阶段改动必须回到对应阶段补齐验收。

1. 项目定义

1.1 一句话目标

以 Go 标准库为主体重写 FlintHub 1.5.0，保持 data/、Cookie、会话、设置缓存、页面缓存、搜索索引、任务队列逐字节/逐语义兼容，并在此之上提供更安全的运行时与更清晰的模块边界。

1.2 核心目标

1.3 非目标（本版本明确不做）

1.4 发布阻断红线（任何一条不满足即不得上线）

1. 向现有表增加必填字段，或删除/改名/改类型。
2. 把 sessions.data 改成 JSON 或其他格式。
3. 用 SQLite AUTOINCREMENT 取代 global_id.sqlite 发号。
4. 正文写到 extern/ 之外的位置，或改变 t/r 前缀语义。
5. 改变时间字段单位（秒 ↔ 毫秒），或把 business 表的本地时间字符串改成整数。
6. 重命名/移动 data/meta/ 下的库文件。
7. 升级或部署时只拷 .sqlite 不带 -wal / -shm。
8. 允许未验签的插件包安装。
9. 响应体出现 err.Error()、绝对路径、SQL 片段。
10. data/、protected/、logs/ 可被 Web 直接访问。

2. 现状盘点

2.1 FH 1.5.0 代码规模（实测）

2.2 必须理解的 8 个机制

2.3 白皮书已确定、本方案直接继承的结论

1. 纯标准库：net/http + html/template + database/sql + modernc.org/sqlite；不引入 Gin/Echo/ORM。
2. 模板外置：禁止 embed；themes/ 目录 + mtime 缓存失效。
3. 插件编译期注入：后端静态编译，运行时只装视图与资源；签名校验（Ed25519 + SHA-256）。
4. 只加不删的迁移铁律，migrations/NNNN_*.sql 幂等、可中断恢复。
5. 请求生命周期复刻 FH，钩子名沿用 FH 命名。
6. 安全基线：路径穿越、SQL 注入、XSS、CSRF、会话固定、资源耗尽逐项防护。

2.4 事实冲突清单（白皮书 vs FH 1.5.0 实际代码）

这一节是本方案与"直接照抄白皮书"的区别所在。以下冲突必须在 B0 阶段固化为测试夹具，后续实现以实际代码/实际库为准，白皮书作为原则依据。

3. 总体架构

3.1 设计原则

3.2 技术选型

3.3 源码目录结构（建议）

d:\sobbs\
├── cmd/sobbs/main.go              # 入口：加载配置 → 自检 → 启动 HTTP
├── lib/
│   ├── router/                    # 路由、参数、方法、BASE_PATH
│   ├── context/                   # 请求上下文、UserID/Role/IP/Lang/RequestID
│   ├── middleware/                # Recovery/RequestID/RealIP/SecurityHeaders/BodyLimit/Timeout/CSRF/Auth/RateLimit
│   ├── config/                    # config.json + config.php 解析
│   ├── db/                        # 连接管理、PRAGMA、LRU、事务、重试
│   ├── splitdb/                   # schema/shardrouter/id/extern/pagecache/settings/search/queue
│   ├── session/                   # session store + phpsess 编解码
│   ├── cache/                     # 进程内 KV（TTL + 主动失效）
│   ├── template/                  # 加载器、FuncMap、mtime 缓存
│   ├── i18n/                      # 三语包加载、键集合自检
│   ├── security/                  # SafeJoin、HTML 净化、密码、token、限流
│   ├── upload/                    # 上传校验、缩略图、随机命名
│   ├── mail/                      # SMTP（异步发送）
│   ├── plugin/                    # 注册表、钩子总线、动态资源包
│   └── compat/                    # PHP 时间/序列化/配置/缓存格式兼容
├── app/
│   ├── handlers/                  # 前台 handler（forum/thread/post/auth/...）
│   ├── admin/                     # 后台 handler
│   ├── api/                       # /api handler
│   ├── services/                  # 业务服务（事务编排）
│   └── models/                    # 数据访问（SQL 逐字段对齐）
├── themes/modern/                 # 外置模板（layout + partials + pages；沿用 FH 默认主题键 modern）
├── plugins/                       # 静态插件（plugin.go + plugin.json + views/assets）
├── assets/                        # 复用 FH 静态资源（css/js/fonts/img/medals/pwa/uploads）
├── migrations/                    # 只加不删的 SQL 迁移
├── tools/                         # compat/dbcheck/langimport/bench/doctor
├── testdata/fixtures/             # FH 只读样本（脱敏）+ 校验清单
├── docs/                          # 本方案、兼容清单、阶段验证报告
└── go.mod

3.4 生产部署布局（与 FH 同构）

/var/www/sobbs/
├── sobbs                    # 单文件二进制
├── config.json              # 进程级配置（监听、日志、超时）
├── config.php               # 存量站原有配置（Go 只读解析，不执行）
├── data/                    # 与 FH 完全同构，直接接管
│   ├── meta/{business,main_index,sessions,global_id}.sqlite
│   ├── meta/search/search_YYYYQn.sqlite
│   ├── meta/task_queue/queue_0..2.sqlite
│   ├── bucket/{active,archive}/YYYYQn/<0..31>.sqlite
│   ├── extern/YYYY/Qn/<bucket>/t|r<id>.txt
│   ├── runtime/pages/*.html
│   ├── runtime/category_stats.cache
│   ├── runtime/category_<id>_latest.json
│   ├── lock/cron_trigger.lock
│   └── log/
├── themes/modern/
├── plugins/
├── assets/                  # 含 assets/uploads/
└── protected/               # 仅存量兼容：settings_cache.php、level_config_cache.php、rate_cache

3.5 分层与依赖规则

cmd → app/handlers, app/admin, app/api
app/* → app/services → app/models → lib/splitdb → lib/db
app/* → lib/template, lib/i18n, lib/security, lib/upload
lib/plugin ← 只依赖 lib/context、lib/router、lib/splitdb 的公开接口

硬性规则：

1. lib/splitdb 不允许 import app/*。
2. handler 不直接写 SQL；写操作必须经 service。
3. 插件只能通过公开接口访问数据库与钩子，不得直接引用 handler。
4. 任何跨层错误必须用哨兵错误包装（%w），出口统一翻译。

3.6 请求生命周期（对齐 FH index.php）

① 加载 config.json（失败即启动失败，输出可读原因）
② 读取 config.php 兼容常量（data 路径、桶大小、上传、邮件、CRON_KEY、时区）
③ 初始化 slog + 生成/透传 request_id
④ 打开 business/main_index/sessions/global_id；分片桶按需懒加载
⑤ 会话解析：Cookie → sessions 表 → PHP 反序列化 → 还原身份
⑥ 构建 Context（UserID/Role/IP/Lang/Theme/RequestID）
⑦ 全局中间件：Recovery → RequestID → SecurityHeaders → BodyLimit → Auth → RateLimit → CSRF
⑧ 游客页面缓存前置命中（仅 GET、无登录 Cookie）
⑨ 路由分发：静态资源 → 前台 → /api → 后台（鉴权）→ 插件路由
⑩ 业务处理 → 模板渲染 / JSON
⑪ 收尾：计数批量回写、缓存刷新、会话续期、释放连接

与 FH 的差异（必须记录并在验收中说明）：

3.7 并发与写模型

3.8 配置体系

三层配置，优先级从高到低：

环境变量（FLINTHUB_SITE_URL / FLINTHUB_CRON_KEY 等）
  > 站点根 config.json（Go 进程级）
  > 站点根 config.php（存量兼容，只读解析）
  > 内置默认值

config.json 建议字段（只放进程级）：

{
  "listen": "127.0.0.1:8080",
  "base_path": "",
  "data_dir": "./data",
  "theme": "modern",
  "session_cookie": "PHPSESSID",
  "session_ttl": 1800,
  "page_cache_shared": false,
  "timezone": "Asia/Shanghai",
  "log_level": "info",
  "log_dir": "./logs",
  "trusted_proxies": ["127.0.0.1"],
  "read_timeout": 15,
  "write_timeout": 30,
  "queue_mode": "auto"
}

config.php 必须解析的常量（只允许标量字面量，不执行 PHP）：

解析失败策略：不静默兜底。缺失关键常量时启动失败并打印缺失项；MAIL_PASS 等敏感值只进内存，不写日志。

3.9 错误、日志与可观测性

3.10 安全基线（摘要，详细见 7.7）

• 统一 SafeJoin，所有模板名/主题名/插件名/附件名白名单。
• 全部 SQL 参数化；排序/筛选走白名单映射。
• 默认 html/template 转义；raw 仅用于服务端净化后的正文。
• CSRF：表单隐藏字段 + JSON X-CSRF-Token；30 分钟滑动续期。
• 会话：PHPSESSID、HttpOnly、SameSite=Lax、HTTPS 自动 Secure、登录换 SID。
• 响应头按白皮书 11.6 固定；CSP 不含 blob:。
• 请求体 2MB（上传单独限制）、Header 1MB、超时 5/15/30/60s。

4. 数据兼容设计（核心章节）

4.1 兼容契约

4.2 库与表清单

4.2.1 data/meta/business.sqlite（主库）

核心 20 张（FH 1.5.0 Schema::ensureBusiness 创建）：

遗留 3 张（实测库存在，1.5.0 核心 DDL 不创建）：

Schema 策略：Go 的 ensureBusiness 必须逐字复刻 FH DDL 与列补丁（如 category_permissions.can_attach），不得新增 FH 不认识的列；只允许新增可选列/新表，且有默认值。

4.2.2 data/meta/main_index.sqlite

• topic_index：id/uid/title/create_time/last_reply_time/view_count/reply_count/status/category_id/is_pinned/is_highlighted/color/reply_to_view/deleted_at/bucket_path/is_archived/excerpt/excerpt_images，时间 INTEGER。
• reply_index：id/pid/uid/create_time/update_time/status/bucket_path。
• 索引必须与 FH 同名同列序（idx_topic_index_list、idx_topic_index_pinned_ct、idx_topic_index_hot、idx_topic_index_uid、idx_reply_index_pid、idx_reply_index_uid、idx_reply_index_status 等），否则查询计划劣化。
• WAL 模式必须校验；非 WAL 拒绝启动（fail-closed）。

4.2.3 桶库 bucket/{active,archive}/YYYYQn/<n>.sqlite

topic：id/uid/category_id/title/create_time/update_time/last_reply_time/view_count/reply_count/status/is_pinned/is_highlighted/color/reply_to_view/deleted_at/extern_path/excerpt/excerpt_images。

reply：id/pid/uid/create_time/update_time/status/deleted_at/extern_path。

索引：idx_topic_category、idx_reply_pid、idx_reply_pid_status_ct；建表后写 PRAGMA user_version = 2（与 FH BUCKET_SCHEMA_VERSION 一致），命中即跳过 DDL。

归档桶：PRAGMA query_only=1，只读；禁止回复/编辑。

4.2.4 sessions.sqlite

CREATE TABLE sessions (id TEXT PRIMARY KEY, data TEXT, expires INTEGER NOT NULL);
CREATE INDEX idx_sessions_expires ON sessions (expires);

4.2.5 global_id.sqlite

CREATE TABLE id_generator (table_name TEXT PRIMARY KEY, last_id INTEGER DEFAULT 0);
INSERT OR IGNORE ... ('topic',0),('reply',0);

4.2.6 meta/task_queue/queue_0..2.sqlite

CREATE TABLE task_queue (
  id INTEGER PRIMARY KEY,
  type TEXT,
  data TEXT,
  status TEXT DEFAULT 'pending',
  create_time INTEGER,
  update_time INTEGER DEFAULT 0,
  retry_count INTEGER DEFAULT 0,
  lease_token TEXT,
  lease_until INTEGER,
  dedupe_key TEXT
);
-- idx_status, idx_update_time

状态机：pending → processing(租约) → done | failed；未知类型记录日志后丢弃（与 FH 一致，避免无限重试堆积）。

4.2.7 meta/search/search_YYYYQn.sqlite

CREATE TABLE search_index (
  token TEXT NOT NULL,
  type INTEGER NOT NULL DEFAULT 1,   -- 1=帖子 2=博客
  target_id INTEGER NOT NULL,
  weight INTEGER NOT NULL DEFAULT 1,
  created_at TEXT                    -- 'Y-m-d H:i:s'（注意：不是整数）
);
-- idx_search_index_token(token)、idx_search_index_target(type,target_id)、
-- idx_search_index_created(created_at)、UNIQUE(token,type,target_id,weight)

写入按目标创建时间所在季度路由；删除按 target 扫描季度；查询逐 token 等值查询后归并（避免 IN (...) 走错索引）。

4.3 时间双轨制（最重要的兼容细节）

实现建议：

// lib/compat/dbtime
func FormatBusiness(t time.Time, loc *time.Location) string // "2006-01-02 15:04:05"
func ParseBusiness(s string, loc *time.Location) (time.Time, error)
func UnixSeconds(t time.Time) int64

验收：同一操作在 PHP 与 Go 写入后，对同一行做字段级 diff，时间字符串逐字节一致（时区一致时）。

4.4 分片路由

4.5 外置正文（Extern）

路径：

extern/{YYYY}/{Qn}/{bucket}/t{topicID}.txt
extern/{YYYY}/{Qn}/{bucket}/r{replyID}.txt

归档块（同目录）：

t|r{floor(id/1000)*1000}.bin   # [4字节大端长度][正文]...
t|r{floor(id/1000)*1000}.idx   # JSON { "id": offset }

读写顺序与红线：

1. 路径安全校验（拒绝 NUL、..、越出 data/）。
2. 读：进程内 LRU → .bin/.idx → .txt；.bin 存在但 .idx 缺失、ID 不在 idx → 回退 .txt，前台不得 404。
3. .bin 长度异常（<=0 或 >16MB）或短读 → 记 ERROR 并回退 .txt。
4. 写：先写同目录临时文件 → 原子 rename；再更新 DB；旧路径按需删除。
5. 删除：删 .txt + 在 .idx.lock 下从 idx 移除并原子重写；.bin 内死字节保留（不可变归档）。
6. 局部读（摘要链路）：只读前 N 字节，不污染完整正文缓存。
7. 新帖只写 .txt，不写 .bin/.idx；归档任务另行处理。

4.6 全局 ID

• 库：meta/global_id.sqlite，表 id_generator(table_name,last_id)。
• 算法：BEGIN IMMEDIATE → INSERT OR IGNORE 种子 → SELECT last_id → UPDATE last_id+1 → COMMIT。
• busy_timeout：取号期间 1000ms，结束恢复 5000ms；锁竞争重试 3 次，5–20ms 抖动。
• 禁止：AUTOINCREMENT、内存自增、按桶独立发号。

4.7 会话（PHP 兼容）

编解码要求：

• 支持 s（字符串，长度按字节）、i、b、d、N、a（嵌套数组）。
• 双向可逆：解析 → 重编码 → 与原文逐字节一致（未知键必须保留原顺序）。
• 读改写：只修改需要的键，未识别键原样保留；禁止整表重写为 JSON。
• 遇到不支持的标记：不重写该会话（返回只读），记 WARN；不得破坏用户登录态。

4.8 设置缓存与运行时缓存

设置写流程：

DB UPDATE/UPSERT settings
→ 清进程内设置缓存
→ 从 DB 全量读取 → 生成 JSON → 原子写 settings_cache.php
→ 失效相关页面缓存

4.9 页面缓存

4.10 搜索索引

• 分词：必须移植 FH Segmenter（含词典与停用词），以"同一文本 → token+weight 集合完全一致"为验收。
• 写入：新帖/编辑/删除后写 rebuild_search 队列任务；消费者调用索引重建。
• 重建：cli/search_rebuild 可全量重建；季度文件缺失时按目标时间创建。
• 双端共存：B2 完成后如分词一致性未达标，Go 只入队、不自行消费，交由 PHP worker 处理（配置项 search_consumer=php|go）。

4.11 任务队列与定时任务

已知任务类型（以 FH consumer 注册为准）：rebuild_search、stats；B0 必须枚举全部类型并落表，Go consumer 对未知类型"记录 + 丢弃"。

4.12 附件与上传

4.13 兼容红线（实现期逐条检查）

1. 不写 threads / posts。
2. 不新增 FH 不认识的必填列。
3. 不改 bucket_path、extern_path 的语义。
4. 不改 .idx 的 JSON 结构（键必须是字符串 ID，值必须是整数偏移）。
5. 不把会话数据写成 JSON/Go gob。
6. 不在 data/ 外存储正文。
7. 不用 AUTOINCREMENT。
8. 不在启动时自动"修复/重排"现有数据。
9. 不在 PHP 共存期轮换 remember_token（默认只校验）。
10. 不在未对齐分词前让 Go 消费搜索重建任务。

5. 模块映射与功能清单

5.1 FH Helper → Go 包映射

5.2 路由与控制器映射

完整路由清单见附录 A。分组如下：

5.3 视图清单（64 个）

5.4 通用组件（必须优先转写）

left_sidebar、right_sidebar、mobile_sidebar、notification_bell、attachment_card、image_lightbox、footer_beian。

它们被大量页面引用，先完成组件再铺页面，能显著降低返工。

5.5 插件与钩子

• 49 个钩子按生命周期分组（完整表在 B0 从 FH 插件开发规范.md §9.1 复制为 docs/COMPAT_HOOKS.md）：
  • 初始化/路由：init_after、route_register、route_before_dispatch；
  • 布局/导航：layout_head_end、nav_plugin_links、footer_links、controller_view_before；
  • 内容：topic_created、post_created、upload_url 等；
  • 用户/后台/搜索等其余分组。
• Go 钩子总线要求：注册顺序 + priority 稳定排序；单个监听器 panic 隔离；同步执行；同一事件可重试，监听器需幂等。
• 插件形态：
  • 静态插件：plugins/<id>/plugin.go + plugin.json + views/ + assets/，编译期空白导入；
  • 动态资源包：仅视图/静态资源，可在线安装；Ed25519 验签 + SHA-256 + ZIP Slip 防护。
• PHP 插件兼容边界：不执行 PHP；列出可迁移插件（blog/checkin 优先）、暂不支持插件（依赖 PHP 运行时的 AI/统计类需重写）。

6. 分阶段实施计划

说明：以下任务按依赖排序，不含工期估算。每个阶段结束必须提交验证报告并评审通过。

B0 工程基线与兼容样本

目标：在不写业务代码的前提下，把"什么是兼容"固化成可执行资产。

退出条件：样本库可被工具完整读取；配置解析与自检通过；兼容清单（C1–C14）有测试用例占位。

B1 基础设施层

目标：路由、上下文、中间件、数据库、缓存、会话、模板骨架可独立运行并通过单测。

退出条件：go test -race ./lib/... 全绿；最小站点（首页占位、404、静态资源）可启动。

B2 SplitDB 数据层

目标：读写 FH 数据目录的每一个字节级对象，并通过双端校验。

退出条件：用 FH 样本库启动 Go，完成"读主题/回复/设置/会话"与"写新主题/回复/设置"；PHP 端逐项读回一致；报告附字节级比对。

B3 认证与用户

退出条件：PHP 建会话 → Go 识别；Go 建会话 → PHP 识别；密码/CSRF/权限用例全绿。

B4 论坛核心读写

退出条件：完成 7.3 兼容用例第 3–6、8–10 条；发帖/回帖在 PHP 端可正常展示。

B5 消息、通知、搜索、用户主页、PWA

退出条件：搜索索引读写双向可用；通知/私信/主页视图通过。

B6 后台核心

退出条件：后台所有"会写数据"的操作在 PHP 端可见；设置缓存文件一致。

B7 视图收口、主题与响应式

退出条件：64 个视图销项完成；关键页面（首页/版块/主题/发帖/登录/后台首页）截图对比通过。

B8 插件体系与生态

退出条件：至少 2 个静态插件可启停；动态资源包可安装/卸载；钩子派发不破坏主流程。

B9 高级后台、异步与运维

退出条件：队列/归档/备份/升级四类演练通过；无数据丢失。

B10 全量兼容验收与发布

退出条件：发布检查表全绿；评审会签通过；可进入灰度。

7. 测试策略

7.1 测试分层

7.2 兼容夹具要求

1. 覆盖所有库与目录（含 -wal/-shm）。
2. 至少包含：正常主题、超长正文、纯 emoji 标题、已删除主题、归档主题、.bin/.idx 归档块、损坏 .idx、缺失桶文件。
3. 会话样本：匿名、登录、管理员、封禁、过期。
4. 每次样本变更必须更新校验和清单，禁止手工改样本。

7.3 双端切换用例（发布门槛）

按白皮书 10.3 执行，并补充 Go→PHP 方向：

7.4 PHP 会话编解码专项

• 单元往返：解析 → 编码 → 逐字节比较。
• Fuzz：随机键/嵌套数组/超长字符串/非法序列化串，要求不 panic、不丢未知键。
• 双端：Go 改写 csrf_time 后 PHP 能继续读取。

7.5 数据一致性专项

• dbdump：表结构、行数、关键列校验和。
• 写入后：桶行、topic_index、reply_index、extern、搜索索引、计数器六处一致。
• 中断测试：事务中杀进程，重启后无半成品（schema_migrations、队列租约）。
• 并发测试：同帖并发回复、并发投票、并发取号。

7.6 性能门槛（建议）

7.7 安全检查表

7.8 CI 流水线

lint → unit → integration → race → compat(fixtures) →
nightly: dualrun(PHP) + 性能基准 + 安全扫描

8. 迁移与上线

8.1 上线前数据准备

1. 整目录备份 data/（含 -wal/-shm），校验关键表行数。
2. 确认 data/meta/business.sqlite 存在且非 0 字节；根目录 0 字节占位库忽略。
3. 确认 protected/settings_cache.php 可写；data/lock、data/runtime 可写。
4. 记录当前 PHP 版本、FH 版本、桶大小、扩容时间戳。

8.2 灰度切换

切换动作只改 Nginx upstream；不迁移数据。

8.3 回滚

• 同 MAJOR：直接换回旧二进制，不碰 data/。
• 升级失败：用备份覆盖 data/ + 放回旧二进制。
• 不允许用 rsync --delete 同步 data/。

8.4 运行方式

• systemd：ExecStart=/var/www/sobbs/sobbs，Restart=on-failure，工作目录站点根。
• Nginx：静态 /assets、/themes、/plugins 直出，其余反代 127.0.0.1:8080。
• 定时任务：系统 cron 调用 curl -H "X-Cron-Key: ..." /cron/trigger，或 sobbs worker 常驻。

8.5 监控指标

9. 风险登记表

10. 待决策项（需评审确认）

11. 附录

附录 A：路由清单（来自 index.php）

前台（50）

GET  /                                   GET  /index.php
GET  /__rewrite_probe                    GET  /manifest.webmanifest
GET  /offline                            GET  /forum
GET  /forum/category/{id}                GET  /thread/{id}
POST /thread/{id}                        POST /thread/{id}/delete
GET  /thread/{id}/edit                   POST /thread/{id}/edit
GET  /post/new                           POST /post/new
GET  /post/{id}/edit                     POST /post/{id}/edit
GET  /attachment/{id}                    GET/POST /login
GET/POST /register                       POST /logout
GET/POST /forgot-password                GET/POST /reset-password/{token}
GET  /verify-email/{token}               GET/POST /resend-verification
GET/POST /notifications                  GET/POST /profile
GET  /message                            GET/POST /message/inbox
GET/POST /message/sent                   GET/POST /message/compose
GET  /message/view/{id}                  GET/POST /search
GET  /tags                               GET  /tag/{id}
GET/POST /theme-settings                 POST /layout-toggle
POST /toggle-sidebar                     GET  /u/{id}

后台（84，按模块）

API（7）

POST /vote          POST /upload        POST /fetch-image
GET  /captcha       GET  /pow           GET  /favorites-count
GET  /post/{id}/body

附录 B：数据库对象清单

附录 C：49 钩子分组（B0 落表）

完整 49 条表由 B0 从 fh_reference/flinthub1.5.0/docs/插件开发规范.md §9.1 复制生成 docs/COMPAT_HOOKS.md，并要求"钩子数/调用点数/双向差集"自检脚本通过。

附录 D：视图清单（64）

附录 E：关键常量与 Cookie 对照

附录 F：术语