飞书云文档优化器

优化飞书云文档的内容结构、排版格式和视觉美观度。

工作流程

1. 读取文档内容

使用飞书 API 读取文档原始内容：

python3 scripts/feishu_doc_reader.py <doc_token>

文档 token 从 URL 提取：https://xxx.feishu.cn/docx/<doc_token>

2. 分析并优化内容

优化原则：

• 结构清晰：使用标准章节编号（1. 2. 3.）
• 层次分明：一级标题、二级标题、正文层次清晰
• 内容精炼：删除冗余，保留核心信息
• 视觉美观：使用 emoji 标记、分隔线、表格对齐

3. 替换文档内容

通过 Playwright 浏览器自动化：

python3 scripts/feishu_doc_editor.py <doc_token> <content_file>

流程：

1. 连接已登录的浏览器
2. 打开文档进入编辑模式
3. 循环 Ctrl+A + Backspace 清空内容
4. 逐行输入新内容

飞书 API 配置

租户配置

租户	App ID	用途
hanxing	YOUR_FEISHU_APP_ID	汉兴企业（默认）
personal	cli_a83467f9ecba5013	个人应用

API 权限

需要的权限范围：

• docx:document:readonly - 读取文档
• docx:document - 编辑文档（API 方式）

优化模板

项目文档模板

# [项目名称]

> [一句话描述]
> 📅 版本：vX.X | 更新日期：YYYY-MM-DD

---

## 📋 目录
1. 项目背景  2. 系统架构  3. 核心功能  ...

---

## 1. 项目背景

### 1.1 痛点分析
🔴 痛点1 - 描述 ⭐⭐⭐⭐⭐
🔴 痛点2 - 描述 ⭐⭐⭐⭐

### 1.2 解决方案
方案描述...

---

## 2. 核心功能

### 2.1 功能名称 ✅
**功能**：功能描述
**流程**：步骤1 ➜ 步骤2 ➜ 步骤3

---

## N. 项目价值

### N.1 投入成本
| 项目 | 成本 | 说明 |
|------|------|------|
| 项目1 | ¥0 | 说明 |

### N.2 产出价值
⏱️ 指标1：描述
💰 指标2：描述

---

💡 如有改进建议，欢迎提出！

格式规范

Emoji 使用

场景	Emoji
目录/导航	📋
日期/版本	📅
痛点/问题	🔴
已完成	✅
进行中	🔄
待办	⏳
重要提示	⚠️ 💡
数据采集	📥
数据处理	⚙️
数据展示	📊
时间	⏱️
成本	💰
增长	📈

分隔符

• 章节分隔：---（三个短横线）
• 流程箭头：➜
• 星级评分：⭐⭐⭐⭐⭐

表格格式

| 列1 | 列2 | 列3 |
|:---:|------|:---:|
| 居中 | 左对齐 | 居中 |

注意事项

1. 登录状态：浏览器编辑需要已登录飞书
2. API 限制：飞书 API 不支持直接删除文档块
3. 编辑模式：确保文档处于"编辑"模式而非"阅读"模式
4. 保存确认：编辑后等待"已保存到云端"提示

相关文件

• scripts/feishu_doc_reader.py - 读取文档内容
• scripts/feishu_doc_editor.py - 编辑文档内容
• references/optimization-examples.md - 优化案例参考