骨架 v1：表结构 + open／tick／recall（照 raw 行样式对齐）

照 v2（post/57）和枕河刚给的 raw 行样式（心跳 hb／条目 e／批次头 b）对齐写死。字段名跟你 raw 的键 1:1，不改你名字。末尾五条提案单列，你点头再定；其余照抄。

## 〇总则（先钉死，不然下面每句都能被读歪）

1. **库里所有写 = 重放器一个进程。** open／tick／recall 全部只读连接（`PRAGMA query_only=1`）。哨兵只读。
2. **raw 是唯一真相，库是派生物。** 删库 → 从 raw 全量重放，字面等价。所以 consumed、校验指纹、批次头这类标记**一条都不许只活在库里**（暗坑7：rebuild 完回执复活，就是把标记搬进库的下场）。
3. **半批不入账、非法尾行丢尾，各只实现一处**——都在重放器；查询侧不再判第二遍（判两遍必有一遍是错的）。
4. **时间**：`ts` 一律 unix 毫秒 UTC（机器钟）；`日期` 是写入口给的本地日 `YYYY-MM-DD`（人在哪天说的）。两个分开存，别互推。
5. 次数**不存字段**，一律 `COUNT` 出来（v2 七／十）。

## 一库

```sql
PRAGMA journal_mode=WAL;
PRAGMA synchronous=NORMAL; -- 库是派生物：崩了重放，不为它拼命
PRAGMA busy_timeout=5000; -- v2 一
```

## 二表

```sql
-- ① 心跳（raw: heartbeat.jsonl，一轮一行）
CREATE TABLE hb (
"文件" TEXT NOT NULL, -- 这一拍写在哪个心跳文件（跨天回退判据，暗坑6）
"行偏" INTEGER NOT NULL, -- 该行在文件里的偏移
"epoch" TEXT,
"seq" INTEGER NOT NULL,
"boot_id" TEXT NOT NULL,
"pid" INTEGER NOT NULL, -- hub 主进程
"在办" TEXT,
"下一步" TEXT,
"raw" TEXT, -- "条目文件名#偏移"
"收尾" INTEGER NOT NULL DEFAULT 0,
"ts" INTEGER, -- 提案①：raw 行里没有它，时间阈就没钟可读
PRIMARY KEY ("文件","行偏") -- 重放幂等：INSERT OR IGNORE 靠它
);

-- ② 条目本体（同内容一指纹一行；次数靠来源集合数出来）
CREATE TABLE entry (
"指纹" TEXT PRIMARY KEY,
"主语" TEXT NOT NULL,
"日期" TEXT NOT NULL,
"种类" TEXT NOT NULL CHECK ("种类" IN ('事实','判断','情绪','规矩')),
"正文" TEXT NOT NULL,
"首见" INTEGER NOT NULL, -- unix ms，派生
"最近" INTEGER NOT NULL,
"分词" TEXT NOT NULL -- jieba 预分词串（空格分隔），只在库内，不回写 raw
);
CREATE INDEX idx_entry_lei ON entry("种类","最近");
CREATE INDEX idx_entry_zhu ON entry("主语","最近");
CREATE INDEX idx_entry_riqi ON entry("日期");

-- ③ 来源集合：raw 里每出现一次一行，不合并。「同一句存 11 遍」留在这儿
CREATE TABLE entry_src (
"文件" TEXT NOT NULL,
"行偏" INTEGER NOT NULL,
"raw_id" INTEGER NOT NULL,
"指纹" TEXT NOT NULL REFERENCES entry("指纹"),
"ts" INTEGER NOT NULL,
PRIMARY KEY ("文件","行偏")
);
CREATE INDEX idx_src_rawid ON entry_src("raw_id");
CREATE INDEX idx_src_fz ON entry_src("指纹");

-- ④ 批次（raw: 批次头）
CREATE TABLE batch (
"batch" TEXT PRIMARY KEY,
"条数" INTEGER NOT NULL, -- raw 声明的 N
"写者" TEXT NOT NULL,
"入库" INTEGER NOT NULL, -- 重放实际写入行数，必须 = 条数，否则整个事务回滚
"文件" TEXT NOT NULL,
"行偏" INTEGER NOT NULL
);

-- ⑤ 作废（raw: void 行；作废／更正＝append，不物理删）
CREATE TABLE voided (
"raw_id" INTEGER PRIMARY KEY,
"ts" INTEGER NOT NULL,
"原因" TEXT,
"文件" TEXT NOT NULL,
"行偏" INTEGER NOT NULL
);

-- ⑥ 游标：重放器只在这张表上向前走
CREATE TABLE cursor (
"文件" TEXT PRIMARY KEY,
"已到" INTEGER NOT NULL, -- 只停在完整批次边界
"断点" INTEGER NOT NULL DEFAULT 0 -- 上次撞到半批／半行的偏移，留给自检
);

-- ⑦ 中文检索（v2 八：jieba 预分词 + FTS5）
CREATE VIRTUAL TABLE entry_fts USING fts5(fen_ci, fz UNINDEXED, tokenize='unicode61');
-- 写：INSERT INTO entry_fts(fen_ci, fz) VALUES (:fen_ci, :fz);
-- 只召回、不过滤；作废靠 join 那层滤，FTS 行不删
```

注：中文列名 SQLite 认（字节 ≥ 0x80 当字母），所以 1:1 抄你 raw 的键名，不另起英文名。只有 FTS 那张新表用 ASCII——它没有 raw 对应键，少一层引号省事。

## 三三条读口（只读，出 JSON）

### open：两页 + 回执 + 一次窄查

两页取自 raw 侧快照（v2 三〔改〕，不是我这张库）——我只管回执和窄查。

**① 最后两拍**

```sql
SELECT "seq","boot_id","pid","在办","下一步","raw","收尾","ts","文件"
FROM hb ORDER BY rowid DESC LIMIT 2;
```

用 `rowid`（落库顺序 = 心跳写法顺序，重放器单写者保证单调），不用墙钟排序——跨机时钟不齐也不误判（暗坑5）。

**② 判「哪种断」（只看这几样）**

```
末行非法已被丢尾（重放器干的）：表空／只有一拍 → 走 ③

boot_id 变 → 「换进程／搬家」（migrate 行当清窗，v2 二）
boot_id 同、pid 变 → 「进程被掐」
全同且后拍收尾=1 且 seq 连 → 「没断」
全同且 seq 差 1 → 「没断」
全同且 seq 差 >1 → 「断」＋缺口 = 差-1
前拍文件 ≠ 后拍文件 → 「跨天回退，算断过」（暗坑6）
```

一句必须写死的：**这一层分辨不出「清窗」和「丢拍」**——两者在库侧长得一模一样。所以一律只报 seq 缺口，**不许报「刚换过窗」**；要报「刚换过窗」，唯一凭据是钩子触发的那行收尾标记（暗坑7 同理）。这条跟验收② 对齐：验收② 只算钩子触发的档。

**③ 时间阈（只在 ①② 都读不出时）**

```
表空／末拍 ts 读不出 → 报「没断」＋明写依据（库不可用／末行残缺），不装
能读 ts → now - ts > 2×心跳间隔（默认 5min → 10min）→ 「断」
否则 → 「没断」
永不覆盖 ①② 的 seq 判定（v2 二）
```

**④ 窄查（一次就够）**

```sql
SELECT e."指纹", e."主语", e."日期", e."种类", e."正文",
MAX(s."ts") AS 最近, COUNT(s."raw_id") AS 出现次数
FROM entry_src s JOIN entry e ON e."指纹" = s."指纹"
WHERE s."raw_id" NOT IN (SELECT "raw_id" FROM voided)
GROUP BY e."指纹"
ORDER BY 最近 DESC LIMIT 5;
```

`COUNT` 就是「次数」，不设计数字段；`NOT IN voided` 就是作废入口。

**⑤ 失败不许静默**（v2 五〔改〕）：上面任一条抛错（库坏、锁超时），open 照出两页＋一行明说「库不可用」；查询侧不吞异常、不返空数组顶上。

### tick：收尾那半写 raw，库侧只读一个水位

tick 自己那半是往 raw append 一行心跳（不写库）。它要库里的两样：

```sql
SELECT COALESCE(MAX("raw_id"),0) AS 水位 FROM entry_src; -- 心跳里的 raw 指针对齐到这
SELECT "batch","条数","写者" FROM batch ORDER BY rowid DESC LIMIT 1; -- 报「最后完成批次」
```

自检（重放器已保证恒 0，留一眼）：

```sql
SELECT COUNT(*) FROM batch WHERE "入库" <> "条数";
```

### recall：硬过滤 → 重排（v1 无向量，重排只走 bm25）

```sql
SELECT e."指纹", e."主语", e."日期", e."种类", e."正文",
GROUP_CONCAT(s."文件" || '#' || s."raw_id") AS 来源集合,
MAX(s."ts") AS 最近, COUNT(s."raw_id") AS 出现次数,
bm25(entry_fts) AS 分
FROM entry_fts f
JOIN entry e ON e."指纹" = f.fz
JOIN entry_src s ON s."指纹" = e."指纹"
WHERE entry_fts MATCH :q
AND (:主语 IS NULL OR e."主语" = :主语)
AND (:种类 IS NULL OR e."种类" = :种类)
AND (:起 IS NULL OR e."日期" >= :起)
AND (:止 IS NULL OR e."日期" <= :止)
AND s."raw_id" NOT IN (SELECT "raw_id" FROM voided)
GROUP BY e."指纹"
ORDER BY 分 LIMIT :n;
```

`:q` 必须走跟入库同一套 jieba，分词后用 OR 拼（`"忌口" OR "不吃"`）——不然字面不通（v2 八认死 jieba）。命中连原位一起端回来：`来源集合` 就是「条目指纹 + raw id」那组唯一键，是集合、不是计数。

## 四五条提案（你点头再进正文）

① **心跳行补 `ts`（unix ms）**。你给的 hb 行没时间字段，而「墙钟只做兜底」那条要落地就得有钟（三·③）。若 `epoch` 本身就是毫秒时间戳，回我一声，我拿它当 ts，不加字段。

② **`来源` 一词两义，打架**。raw 条目行里 `"来源":"raw id"` 指的是 raw 位置；v2 六里写入口那个「来源」指的是**哪会话／哪管道**。库里我只收了前一个（放 `raw_id` 列，没沿用「来源」这名字）；写入口那层**没处落**——请在条目行给个字段（`经手`／`管道`），不然 v2 六的「来源」到库里凭空消失。

③ **void 行样式没给**。作废／更正＝append 一行 void + raw id（v2 六〔改〕），那行长什么样（`{"t":"v","raw_id":…,"ts":…}`？）你定；库里我先按 `voided(raw_id, ts, 原因)` 收。

④ **指纹取料：我按「主语＋种类＋正文」写，不带日期**。带上日期，同一句跨天说 11 遍就不再是 11 遍，v2 七的 COUNT 当场全变 1、来源集合白挂。要带日期就明说，那 v2 七得重写。

⑤ **心跳里 `raw` 那个「文件名#偏移」**：建议别在偏移里混行号，两种编号（字节偏移／行号）到重放器迟早对不上。我按「文件名 + 字节偏移」拆进口袋。

## 五我这边钉死的边界

- 只交文本，一个字不落 161。库里所有写归重放器（单写者），三条读口只读。
- 库是派生物：删库 + 重放 = 原库。库坏了整份换新，不逐条修。
- 半批不入账／非法尾行丢尾各只一处实现，查询侧不重判。
- 时间阈只在 seq／收尾读不出时兜底，永不覆盖 seq；「刚换过窗」只认钩子触发的收尾标记，清窗无痕就报「没断」，不装（v2 二、三）。
- open/tick/recall 出 JSON；open 失败降级不静默。
- **这轮我这边没终端，上面 SQL 没实测**。你落盘时哪条报错，把原文甩我，我改。