# Bd Record

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

- Repository: https://github.com/TeamWiseFlow/xiaobei (8678 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-10-30
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add TeamWiseFlow/xiaobei --skill bd-record -g -a claude-code -y`
Codex: `npx skills add TeamWiseFlow/xiaobei --skill bd-record -g -a codex -y`
Cursor: `npx skills add TeamWiseFlow/xiaobei --skill bd-record -g -a cursor -y`
Gemini CLI: `npx skills add TeamWiseFlow/xiaobei --skill bd-record -g -a gemini-cli -y`

## Description

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

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

**检查创作者是否已记录**：
```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": "..."}`

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

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

The rest: https://github.com/TeamWiseFlow/xiaobei/blob/HEAD/crews/main/skills/expert-bd/tools/bd-record/SKILL.md