| ，内容一定要用合适的XHTML标签包装
8. **文件限制**
- 在创建、更新等使用场景下，先创建临时文本文件，然后执行完成后，再删除掉这个临时文本文件
- 在同步一个仓库的md到iWiki时，先找出md里包含的附件，并将附件与md一起打包成临时的zip文件，然后再导入操作
### 📝 URL 格式说明
| URL 类型 | 示例 | 说明 |
|----------|------|------|
| 个人空间 | `https://iwiki.woa.com/space/~myname` | Key 为 `~myname` |
| 普通空间 | `https://iwiki.woa.com/space/devcloud` | Key 为 `devcloud` |
| 文档页面 | `https://iwiki.woa.com/p/123456` | docid 为 `123456` |
| 专题 | `https://iwiki.woa.com/topic/1232323` | topic_id 为 `1232323` |
### 📊 多维表格操作流程
1. **了解表格结构**
```
smartsheetGetFields(doc_id) -> 获取所有字段定义
smartsheetGetViews(doc_id) -> 获取视图列表
```
2. **查询数据**
```
smartsheetGetRecords(doc_id, {
pageNum: 1,
pageSize: 100,
filterByFormula: "条件表达式",
fields: "字段1,字段2"
})
```
3. **写入数据**
```
smartsheetAddRecords(doc_id, fieldKey: "name", records: [
{ fields: { "字段名": "值" } }
])
```
### 支持的字段类型
```
SingleText, Text, SingleSelect, MultiSelect, Number, Currency,
Percent, DateTime, Attachment, Member, Checkbox, Rating, URL,
Phone, Email, WorkDoc, OneWayLink, TwoWayLink, MagicLookUp,
Formula, AutoNumber, CreatedTime, LastModifiedTime, CreatedBy,
LastModifiedBy, Button
```
### 支持的视图类型
```
Grid（表格）, Gallery（画廊）, Kanban（看板）,
Gantt（甘特图）, Calendar（日历）, Architecture（架构）
```
## 常见场景
### 场景 1：搜索并阅读文档
```mermaid
graph LR
A[searchDocument] --> B{找到文档?}
B -->|是| C[getDocument]
B -->|否| D[aiSearchDocument]
D --> E{找到文档?}
E -->|是| C
E -->|否| F[尝试其他关键词或调整 offset]
C --> G[阅读/分析内容]
```
### 场景 2：创建新文档
```mermaid
graph LR
A[确定目标空间] --> B[getSpaceInfoByKey]
B --> C[获取 spaceid]
C --> D[确定父目录 parentid]
D --> E[createDocument]
```
### 场景 3：更新文档
```mermaid
graph LR
A{更新范围}
A -->|仅改标题| B[renameDocumentTitle]
A -->|追加内容| C[saveDocumentParts]
A -->|全量更新| D[saveDocument]
B --> E[提供 id 和 new_title]
C --> F[指定 before/after]
D --> G[提供完整 body]
```
### 场景 3.5：复制文档
```mermaid
graph LR
A[确定源文档ID] --> B[确定目标父目录ID]
B --> C{复制范围}
C -->|单个文档| D[copyDocument is_single=1]
C -->|整个文档树| E[copyDocument is_single=0]
D --> F[返回任务ID]
E --> F
```
### 场景 4：导入本地文件（无需连接 MCP）
```mermaid
graph LR
A[准备本地文件] --> B[确定父目录 parent_id]
B --> C[upload 命令上传]
C --> D{导入成功?}
D -->|是| E[文档已创建]
D -->|否| F[检查文件/权限]
```
### 场景 5：操作多维表格
```mermaid
graph LR
A[smartsheetGetFields] --> B[了解字段结构]
B --> C{操作类型}
C -->|查询| D[smartsheetGetRecords]
C -->|新增| E[smartsheetAddRecords]
C -->|更新| F[smartsheetUpdateRecords]
C -->|删除| G[smartsheetDeleteRecords]
```
## 错误处理
| 错误信息 | 原因 | 解决方案 |
|----------|------|----------|
| `body 为空值` | 内容参数为空 | 确保传入有效的文档内容 |
| `MCP不支持审批流程` | 文档需要审批 | 手动在 iWiki 网页操作 |
## 参考资料
- [API 参考文档](./references/api_reference.md)
|
|---|