# 飞书多维表格初始化指南

## 目录
1. [自动建表流程](#自动建表流程)
2. [字段定义](#字段定义)
3. [视图设计建议](#视图设计建议)
4. [写入示例](#写入示例)

---

## 自动建表流程

首次运行时，技能会自动执行以下步骤：

### Step 1：创建Bitable应用
```
feishu_bitable_create_app(name="Get笔记录音知识台账")
```
记录返回的 `app_token` 和默认 `table_id`，写入 `config.json`。

### Step 2：创建字段

按以下顺序创建字段：

| 序号 | 字段名 | field_type | 选项（如有） |
|------|--------|-----------|-------------|
| 1 | 录音标题 | 1(Text) | — |
| 2 | 录音日期 | 5(DateTime) | — |
| 3 | 录音类型 | 3(SingleSelect) | 谈案录音/会议录音/课堂录音/电话录音/闪念录音/本地音频 |
| 4 | 时长(分钟) | 2(Number) | — |
| 5 | 一级分类 | 3(SingleSelect) | 由config.json中categories配置决定 |
| 6 | 二级分类 | 3(SingleSelect) | 由config.json中categories配置决定 |
| 7 | 录音概要 | 1(Text) | — |
| 8 | 知识要点 | 1(Text) | — |
| 9 | 法规引用 | 1(Text) | — |
| 10 | 行业数据 | 1(Text) | — |
| 11 | 案例素材 | 1(Text) | — |
| 12 | 标签 | 4(MultiSelect) | 初始为空，使用中自动扩展 |
| 13 | 待办事项 | 1(Text) | — |
| 14 | 隐私级别 | 3(SingleSelect) | P0已脱敏/P1已确认/P2无敏感/P1待确认 |
| 15 | 处理状态 | 3(SingleSelect) | 待处理/已蒸馏/已入库/需确认 |
| 16 | Get笔记ID | 1(Text) | — |
| 17 | 入库时间 | 5(DateTime) | — |

### Step 3：更新配置
将 app_token、table_id、url 写入 `config.json` 和 `processed_notes.json`。

---

## 字段定义详解

### note_type 到 录音类型 的映射

| note_type | 录音类型（中文） |
|-----------|----------------|
| audio | 谈案录音 |
| meeting | 会议录音 |
| class_audio | 课堂录音 |
| local_audio | 本地音频 |
| recorder_audio | 谈案录音 |
| recorder_flash_audio | 闪念录音 |

### 默认分类选项

**一级分类：** 法律、财税、金融、行业通用
**二级分类：** 诉讼、合同、知产、劳动、税务筹划、税务争议、投融资、并购、客户管理、AI应用、培训学习

> 用户可在 `config.json` 中自定义分类，首次建表时会读取自定义分类创建选项。

---

## 视图设计建议

建议在飞书中手动创建以下视图：

1. **全部录音**（默认）— 按录音日期降序
2. **待处理** — 筛选处理状态="待处理"或"需确认"
3. **按分类查看** — 按一级分类分组
4. **知识检索** — 仅显示录音标题、知识要点、标签

---

## 写入示例

```javascript
feishu_bitable_create_record({
  app_token: config.bitable.app_token,
  table_id: config.bitable.table_id,
  fields: {
    "录音标题": "会议录音标题",
    "录音日期": 1714114596000,  // timestamp_ms
    "录音类型": "会议录音",
    "时长(分钟)": 45,
    "一级分类": "法律",
    "二级分类": "诉讼",
    "录音概要": "本次会议讨论了...",
    "知识要点": "**[要点1]**\n...",
    "标签": ["标签1", "标签2"],
    "隐私级别": "P2无敏感",
    "处理状态": "已入库",
    "Get笔记ID": "1234567890",
    "入库时间": 1714200000000
  }
})
```

### 去重检查
写入前查询是否已存在相同 Get笔记ID 的记录，避免重复入库。