learn-queue-query-playbook.md
3.67 KB
学习管线查询手册(learn_queue / learning_results)
场景:用户问「昨天/今天/最近学了什么」「学习队列现在什么状态」「某篇文章吸收了没有」。 直接查 SQLite,不要凭 memory 或 session 猜。
数据库位置
~/wechat-viewer/circle.db
相关表:learn_queue(入队 + 分类 + 路由)、learning_results(吸收产出 1:1 记录)。
learn_queue schema(实际列名,勿猜)
CREATE TABLE learn_queue (
id INTEGER PRIMARY KEY AUTOINCREMENT,
article_url TEXT,
title TEXT, -- 注意:不是 article_title
dedup_key TEXT,
learn_type TEXT NOT NULL, -- skill / memory / reference / todo
learn_target TEXT, -- 目标 skill 名 或 memory key 或 "new:xxx"
learn_content TEXT,
confidence TEXT DEFAULT 'medium',
status TEXT DEFAULT 'pending_review',
error_msg TEXT,
created_at TEXT DEFAULT (datetime('now','localtime')), -- 本地时间字符串
reviewed_at TEXT,
score INTEGER DEFAULT 0,
outline TEXT,
priority INTEGER DEFAULT 0
);
status 取值:pending_learn(≥7分,cron 自动吸收)、pending_review(4-6分,人工审)、applied / rejected / failed。
learning_results schema(关键列)
SELECT id, article_title, result_type, result_summary, status, created_at
FROM learning_results ...
article_title— 这张表里确实叫 article_title(和 learn_queue 不同!)result_type— memory / reference / skill / apply_auditresult_summary— 学习完成报告全文(markdown)status— applied / rejected / failed
坑:两张表的标题列名不一样。learn_queue.title vs learning_results.article_title。join 时用 URL 或各自标题列,别想当然。
常用查询(复制即用)
注意:created_at 是本地时间字符串,date('now','-1 day') 是 UTC——手机时区 CST 下「昨天」可能差 8 小时。要覆盖「昨天」用 -2 days 窗口再肉眼看,或用 datetime('now','localtime','-1 day') 做对比基准。
昨日完成的吸收(回答「昨天学了什么」的主查询)
sqlite3 ~/wechat-viewer/circle.db \
"SELECT id, article_title, result_type, status, created_at
FROM learning_results
WHERE created_at > datetime('now','localtime','-2 days')
ORDER BY created_at DESC LIMIT 30"
result_summary 太长时先只看这条索引,再按 id 取单行全文:
sqlite3 ~/wechat-viewer/circle.db \
"SELECT result_summary FROM learning_results WHERE id = <id>"
当前队列状态(pending_learn / pending_review)
sqlite3 ~/wechat-viewer/circle.db \
"SELECT id, title, score, status, learn_type, learn_target
FROM learn_queue
WHERE status IN ('pending_learn','pending_review')
ORDER BY score DESC, created_at DESC"
按时间窗口看入队
sqlite3 ~/wechat-viewer/circle.db \
"SELECT id, title, score, status, created_at
FROM learn_queue
WHERE created_at > datetime('now','localtime','-2 days')
ORDER BY created_at DESC LIMIT 30"
汇报格式(用户问「学了什么」时)
三段式,简洁直接:
- 已完成吸收(learning_results, status=applied/rejected)— 列标题 + 一句话产出(patch 了哪个 skill / 写了哪个 memory key / rejected 原因)
- 队列状态(learn_queue, pending_learn + pending_review)— 按 score 降序列
- 异常(status=failed 或 error_msg 非空)— 有就报,没有不凑数
不要逐字复述 result_summary 全文——提炼「学了什么 → 落到哪个系统变更」。