Lark Wiki Writer

# Lark Wiki Writer

飞书知识库文档写入器 - 支持 Markdown 解析、富文本、标题识别。

## 快速开始

### 步骤 1：创建飞书应用

1. 访问 [飞书开放平台](https://open.larksuite.com/app)
2. 点击"创建企业自建应用"
3. 填写应用名称和描述
4. 记录 **App ID** 和 **App Secret**

### 步骤 2：配置应用权限

在应用管理页面，添加以下权限：

- ✅ **知识库** → 查看、编辑和管理知识空间
- ✅ **文档** → 查看、编辑和管理文档

### 步骤 3：获取知识库 Space ID

1. 打开飞书知识库
2. 在浏览器地址栏找到 Space ID（长数字串）
3. 例如：`https://xxx.larksuite.com/wiki/space/7603663680785370844`
   - Space ID 就是 `7603663680785370844`

### 步骤 4：获取父节点 Token（可选）

如果要在特定目录下创建文档：

1. 打开目标目录
2. 在地址栏找到 node_token
3. 例如：`https://xxx.larksuite.com/wiki/JieGwPB0MiKhPbkkq9cltbPIgid`
   - 父节点 token 就是 `JieGwPB0MiKhPbkkq9cltbPIgid`

### 步骤 5：配置环境变量

```bash
export LARK_APP_ID="cli_xxxxxxxxxx"
export LARK_APP_SECRET="xxxxxxxxxxxxxx"
export LARK_SPACE_ID="7603663680785370844"
export LARK_WIKI_DOMAIN="your-domain.larksuite.com"  # 可选
export LARK_PARENT_NODE="JieGwPB0MiKhPbkkq9cltbPIgid"  # 可选
```

或者创建配置文件 `config.json`：

```json
{
  "app_id": "cli_xxxxxxxxxx",
  "app_secret": "xxxxxxxxxxxxxx",
  "space_id": "7603663680785370844",
  "wiki_domain": "your-domain.larksuite.com"
}
```

### 步骤 6：验证配置

```bash
python3 lark_wiki_writer.py validate \
  --app-id YOUR_APP_ID \
  --app-secret YOUR_APP_SECRET \
  --space-id YOUR_SPACE_ID
```

输出示例：
```
📊 配置验证结果

APP_ID: ✅
APP_SECRET: ✅
Space ID: ✅
Token 获取: ✅
知识库访问: ✅
```

---

## 核心功能

### 1. 标题识别

根据 `#` 数量自动识别标题级别：

| Markdown | 飞书 Block |
|----------|-----------|
| `# 标题` | heading1 |
| `## 二级标题` | heading2 |
| `### 三级标题` | heading3 |
| ... | ... |
| `###### 六级标题` | heading6 |

### 2. 富文本支持

| Markdown | 效果 |
|----------|------|
| `**加粗**` | **加粗** |
| `*斜体*` | *斜体* |
| `***加粗斜体***` | ***加粗斜体*** |
| `~~删除线~~` | ~~删...

# Lark Wiki Writer

飞书知识库文档写入器 - 支持 Markdown 解析、富文本、标题识别。

## 安装

```bash
# 下载 skill
git clone <repo_url>
cd lark-wiki-writer

# 或使用 clawhub
clawhub install lark-wiki-writer
```

## 快速开始

1. 创建飞书应用并获取凭证
2. 配置环境变量
3. 运行验证命令
4. 开始使用

详细文档请查看 [SKILL.md](SKILL.md)

## 示例

```bash
# 验证配置
python3 lark_wiki_writer.py validate \
  --app-id YOUR_APP_ID \
  --app-secret YOUR_APP_SECRET \
  --space-id YOUR_SPACE_ID

# 创建文档
python3 lark_wiki_writer.py write_file "我的文档" report.md \
  --app-id YOUR_APP_ID \
  --app-secret YOUR_APP_SECRET \
  --space-id YOUR_SPACE_ID
```

## 许可证

MIT