# Bd Record

> BD 线索与互动记录数据库（SQLite）：已探索创作者去重、已互动帖子去重。

- Skill: `teamwiseflow/bd-record` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add teamwiseflow/bd-record`
- Raw SKILL.md: https://api.skillmd.com/api/skills/teamwiseflow/bd-record/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: teamwiseflow (https://skillmd.com/u/teamwiseflow)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/teamwiseflow/bd-record

---


# 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 用）

**检查创作者是否已记录**：
```bash
bd-record check-creator --platform <平台> --creator-id <创作者ID>
```
返回 JSON：`{"exists": true/false}`

**记录创作者**：
```bash
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 用）

**检查帖子是否已互动**：
```bash
bd-record check-post --platform <平台> --post-url <帖子URL>
```
返回 JSON：`{"exists": true/false, "replied": true/false}`

**记录互动**：
```bash
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` 记录。