bd-record — BD 记录数据库工具

在 Workspace db/bd_record.db 中维护持久化 SQLite 数据库，供 Lead Hunting（创作者探索）与 Comment Engagement（帖子互动）去重使用。

数据库位置

<Workspace 根>/db/bd_record.db

所有命令通过 PATH wrapper bd-record <子命令> 调用，不要拼接脚本路径。初始化（幂等，可重复执行）：bd-record init-db。

表结构

lead_creators（模式一：创作者探索）

comment_posts（模式二：帖子互动）

命令

创作者记录（Lead Hunting 用）

检查创作者是否已记录：

bd-record check-creator --platform <平台> --creator-id <创作者ID>

返回 JSON：{"exists": true/false}

记录创作者：

bd-record record-creator \
  --platform <平台> \
  --creator-id <创作者ID> \
  --nickname <昵称> \
  --homepage-url <主页URL> \
  --qualified <0或1> \
  --notes <备注>

返回 JSON：{"ok": true, "id": <记录ID>} 或 {"ok": false, "error": "..."}

帖子互动记录（Comment Engagement 用）

检查帖子是否已互动：

bd-record check-post --platform <平台> --post-url <帖子URL>

返回 JSON：{"exists": true/false, "replied": true/false}

记录互动：

bd-record record-post \
  --platform <平台> \
  --post-title <标题> \
  --post-url <帖子URL> \
  --strategy <direct_comment|reply_dm|direct_dm> \
  --reply-content <互动内容> \
  --reply-target-id <目标ID>

返回 JSON：{"ok": true, "id": <记录ID>} 或 {"ok": false, "error": "..."}

使用规则

1. 创作者探索：打开创作者主页前先用 check-creator 判断是否已记录；已在记录中则跳过。读取创作者信息后，不管是否符合标准，都要用 record-creator 记录。
2. 帖子互动：
   • 直接回帖策略：打开帖子前先用 check-post 判断是否已操作过，已操作则跳过；回复后用 record-post 记录。
   • reply/dm 策略：互动前先判断是否对同一内容/发布者已 touch 过（查 reply_target_id），已 touch 则跳过；touch 后用 record-post 记录。