# Feishu Wiki

> 飞书知识库。创建知识空间、Wiki 页面节点。 Use when this capability is needed.

- Skill: `tomevault-io/feishu-wiki` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/feishu-wiki`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/feishu-wiki/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/feishu-wiki

---


# 飞书知识库

通过 Wiki v2 API 管理知识空间和页面节点。

**Base URL**: `https://open.feishu.cn/open-apis/wiki/v2`

## 认证与 Token 获取

从 `feishu_skills` 根目录执行共享脚本：

```bash
TOKEN="$(./scripts/get_feishu_token.sh)"
```

请求头统一使用 `Authorization: Bearer ${TOKEN}`。

如果业务接口返回 token 无效、过期或 401，强制刷新后仅重试一次原请求：

```bash
TOKEN="$(./scripts/get_feishu_token.sh --force-refresh)"
```

**环境变量**:
- `FEISHU_APP_ID`
- `FEISHU_APP_SECRET`

**本地缓存**: `./.feishu_token_cache.json`（未过期直接复用，默认提前 5 分钟刷新）

---

## 知识空间

| API | 端点 | 说明 |
|-----|------|------|
| 创建空间 | `POST /spaces` | `{"name":"知识库名称"}` |
| 获取列表 | `GET /spaces` | - |
| 获取详情 | `GET /spaces/{space_id}` | - |

⚠️ **权限穿透**：空间创建后机器人默认无权维护。建议：
1. 创建包含机器人的群组
2. 在知识库【设置】添加该群组为"管理员"
3. 机器人通过群组身份获得操作权

---

## 页面节点

| API | 端点 | 说明 |
|-----|------|------|
| 创建节点 | `POST /spaces/{space_id}/nodes` | 创建 Wiki 页面 |
| 获取节点 | `GET /spaces/{space_id}/nodes/{node_token}` | - |
| 移动节点 | `POST /spaces/{space_id}/nodes/{node_token}/move` | - |

**创建节点**:
```json
{
  "obj_type": "docx",
  "parent_node_token": "root",
  "node_type": "origin",
  "origin_node_token": "doxcnXXX",
  "title": "页面标题"
}
```

**obj_type**: `doc` / `sheet` / `mindnote` / `bitable` / `file` / `docx`

---

## 最佳实践

1. **群组授权法**（解决权限问题）
2. **先创建文档再关联**（`origin_node_token`）
3. **适合知识沉淀场景**

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/alextangson) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->