62 lines
1.8 KiB
Markdown
62 lines
1.8 KiB
Markdown
---
|
||
name: feishu-doc
|
||
description: "从飞书（Lark）Wiki、文档、表格和Bitable获取内容。自动将Wiki URL解析为真实实体并将内容转换为Markdown。"
|
||
tags: [feishu, lark, wiki, doc, sheet, document, reader, writer]
|
||
---
|
||
|
||
# Feishu Doc Skill
|
||
|
||
Fetch content from Feishu (Lark) Wiki, Docs, Sheets, and Bitable. Write and update documents.
|
||
|
||
## Prerequisites
|
||
|
||
- Install `feishu-common` first.
|
||
- This skill depends on `../feishu-common/index.js` for token and API auth.
|
||
|
||
## Capabilities
|
||
|
||
- **Read**: Fetch content from Docs, Sheets, Bitable, and Wiki.
|
||
- **Create**: Create new blank documents.
|
||
- **Write**: Overwrite document content with Markdown.
|
||
- **Append**: Append Markdown content to the end of a document.
|
||
- **Blocks**: List, get, update, and delete specific blocks.
|
||
|
||
## Long Document Handling (Unlimited Length)
|
||
|
||
To generate long documents (exceeding LLM output limits of ~2000-4000 tokens):
|
||
1. **Create** the document first to get a `doc_token`.
|
||
2. **Chunk** the content into logical sections (e.g., Introduction, Chapter 1, Chapter 2).
|
||
3. **Append** each chunk sequentially using `feishu_doc_append`.
|
||
4. Do NOT try to write the entire document in one `feishu_doc_write` call if it is very long; use the append loop pattern.
|
||
|
||
## Usage
|
||
|
||
```bash
|
||
# Read
|
||
node index.js --action read --token <doc_token>
|
||
|
||
# Create
|
||
node index.js --action create --title "My Doc"
|
||
|
||
# Write (Overwrite)
|
||
node index.js --action write --token <doc_token> --content "# Title\nHello world"
|
||
|
||
# Append
|
||
node index.js --action append --token <doc_token> --content "## Section 2\nMore text"
|
||
```
|
||
|
||
## Configuration
|
||
|
||
Create a `config.json` file in the root of the skill or set environment variables:
|
||
|
||
```json
|
||
{
|
||
"app_id": "YOUR_APP_ID",
|
||
"app_secret": "YOUR_APP_SECRET"
|
||
}
|
||
```
|
||
|
||
Environment variables:
|
||
- `FEISHU_APP_ID`
|
||
- `FEISHU_APP_SECRET`
|