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_audit
  • result_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"

汇报格式(用户问「学了什么」时)

三段式,简洁直接:

  1. 已完成吸收(learning_results, status=applied/rejected)— 列标题 + 一句话产出(patch 了哪个 skill / 写了哪个 memory key / rejected 原因)
  2. 队列状态(learn_queue, pending_learn + pending_review)— 按 score 降序列
  3. 异常(status=failed 或 error_msg 非空)— 有就报,没有不凑数

不要逐字复述 result_summary 全文——提炼「学了什么 → 落到哪个系统变更」。