Metadata-Version: 2.4
Name: feishu-wiki-md
Version: 0.3.2
Summary: Feishu document toolkit: download docs via API or convert exported Word to AI-friendly Markdown
Requires-Python: >=3.13
Requires-Dist: httpx>=0.28.0
Requires-Dist: python-docx>=1.1.0
Description-Content-Type: text/markdown

# feishu-wiki-md

飞书文档工具：通过 API 下载飞书文档 / 将飞书导出的 Word 转为 AI 友好的 Markdown。

## 功能

**下载飞书文档 (`dl`)**
- 通过飞书链接直接下载文档并转为 Markdown
- 支持普通文档和知识库 Wiki
- 自动下载文档中的图片

**Word 转 Markdown (`wm`)**
- 将飞书导出的 .docx 文件转为干净的 Markdown
- 支持标题、列表、表格、图片、超链接、行内格式
- AI 友好后处理：标题层级归一化、空白折叠、Word 元素清理

## 安装

```bash
# 一键运行（无需安装）
uvx feishu-wiki-md --help

# 或本地安装
uv tool install .
```

## 使用

### 1. 登录飞书

首次使用 `dl` 前需要登录（需要先在[飞书开放平台](https://open.feishu.cn)创建应用）：

```bash
feishu-wiki-md login
# 或指定 app 凭据
feishu-wiki-md login --app-id cli_xxx --app-secret xxx
```

### 2. 下载飞书文档

```bash
# 下载到当前目录
feishu-wiki-md dl https://xxx.feishu.cn/docx/ABC123

# 指定输出目录
feishu-wiki-md dl https://xxx.feishu.cn/wiki/XYZ456 -o ./docs/
```

### 3. Word 转 Markdown

```bash
# 转换单个文件（输出到同目录）
feishu-wiki-md wm 需求文档.docx

# 批量转换
feishu-wiki-md wm *.docx -o ./output/
```

### 输出规则

- **无图片**：`需求文档.docx` → `需求文档.md`
- **有图片**：
  ```
  需求文档/
  ├── index.md
  └── assets/
      ├── image001.png
      └── image002.png
  ```
