teamwiseflow 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（模式一：创作者探索）
| 字段 | 类型 | 说明 |
|---|---|---|
| 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": "..."}
帖子互动记录（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": "..."}
使用规则
- 创作者探索：打开创作者主页前先用
check-creator判断是否已记录；已在记录中则跳过。读取创作者信息后，不管是否符合标准，都要用record-creator记录。 - 帖子互动：
- 直接回帖策略：打开帖子前先用
check-post判断是否已操作过，已操作则跳过；回复后用record-post记录。 - reply/dm 策略：互动前先判断是否对同一内容/发布者已 touch 过（查
reply_target_id），已 touch 则跳过；touch 后用record-post记录。
- 直接回帖策略：打开帖子前先用