# Feishu Doc Optimizer

> 飞书云文档内容优化与格式美化。当用户需要优化飞书文档的排版、结构、格式、美观度时使用此技能。支持：(1) 读取飞书文档内容 (2) 优化文档结构和层次 (3) 清空并替换文档内容 (4) 通过浏览器自动化编辑文档。触发词：优化飞书文档、美化文档、整理文档格式、文档排版。

- Skill: `aaaaqwq/feishu-doc-optimizer` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add aaaaqwq/feishu-doc-optimizer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aaaaqwq/feishu-doc-optimizer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: aAAaqwq (https://skillmd.com/u/aaaaqwq)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/aaaaqwq/feishu-doc-optimizer

---


# 飞书云文档优化器

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

## 工作流程

### 1. 读取文档内容

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

```python
python3 scripts/feishu_doc_reader.py <doc_token>
```

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

### 2. 分析并优化内容

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

### 3. 替换文档内容

通过 Playwright 浏览器自动化：

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

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

## 飞书 API 配置

### 租户配置

| 租户 | App ID | 用途 |
|------|--------|------|
| hanxing | REDACTED_FEISHU_OPENCLAW_APP_ID | OpenClaw企业（默认） |
| personal | REDACTED_FEISHU_PERSONAL_APP_ID | 个人应用 |

### API 权限

需要的权限范围：
- `docx:document:readonly` - 读取文档
- `docx:document` - 编辑文档（API 方式）

## 优化模板

### 项目文档模板

```markdown
# [项目名称]

> [一句话描述]
> 📅 版本：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 |
|------|-------|
| 目录/导航 | 📋 |
| 日期/版本 | 📅 |
| 痛点/问题 | 🔴 |
| 已完成 | ✅ |
| 进行中 | 🔄 |
| 待办 | ⏳ |
| 重要提示 | ⚠️ 💡 |
| 数据采集 | 📥 |
| 数据处理 | ⚙️ |
| 数据展示 | 📊 |
| 时间 | ⏱️ |
| 成本 | 💰 |
| 增长 | 📈 |

### 分隔符

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

### 表格格式

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

## 注意事项

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

## 相关文件

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