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

在 Workspace db/bd_record.db 中维护持久化 SQLite 数据库，供 expert-bd 的 Lead Hunting 保存潜客画像，并供本包授权触达去重与记录使用。保存画像不表示已联系。

数据库位置

<Workspace 根>/db/bd_record.db

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

---

表结构

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

字段	类型	说明
id	INTEGER PRIMARY KEY AUTOINCREMENT	自增主键
platform	TEXT NOT NULL	平台标识（xhs/dy/ks/bilibili/fb/x/wb）
creator_id	TEXT NOT NULL	平台上的创作者 ID
nickname	TEXT	创作者昵称
homepage_url	TEXT NOT NULL	创作者主页 URL
qualified	INTEGER DEFAULT 0	是否符合潜在客户标准（1=是，0=否）
notes	TEXT	备注（符合/不符合的原因摘要）
created_at	TEXT DEFAULT (strftime('%Y-%m-%d %H:%M:%S','now','localtime'))	记录时间

comment_posts（模式二：帖子互动）

字段	类型	说明
id	INTEGER PRIMARY KEY AUTOINCREMENT	自增主键
platform	TEXT NOT NULL	平台标识
post_title	TEXT	帖子标题（如有）
post_url	TEXT NOT NULL	帖子 URL
strategy	TEXT NOT NULL	互动策略（direct_comment/reply_dm/direct_dm）
replied	INTEGER DEFAULT 0	是否已互动（1=是，0=否）
reply_content	TEXT	我们发送的互动内容
reply_target_id	TEXT	互动目标 ID（回复的评论 ID 或私信的用户 ID）
created_at	TEXT DEFAULT (strftime('%Y-%m-%d %H:%M:%S','now','localtime'))	记录时间

---

命令

创作者记录（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": "..."}

帖子互动记录（授权触达 用）

检查帖子是否已互动：

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

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