| ，内容一定要用合适的XHTML标签包装
文件限制
- 在创建、更新等使用场景下，先创建临时文本文件，然后执行完成后，再删除掉这个临时文本文件
- 在同步一个仓库的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 |
📊 多维表格操作流程
-
了解表格结构
smartsheetGetFields(doc_id) -> 获取所有字段定义
smartsheetGetViews(doc_id) -> 获取视图列表
-
查询数据
smartsheetGetRecords(doc_id, {
pageNum: 1,
pageSize: 100,
filterByFormula: "条件表达式",
fields: "字段1,字段2"
})
-
写入数据
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：搜索并阅读文档
graph LR
A[searchDocument] --> B{找到文档?}
B -->|是| C[getDocument]
B -->|否| D[aiSearchDocument]
D --> E{找到文档?}
E -->|是| C
E -->|否| F[尝试其他关键词或调整 offset]
C --> G[阅读/分析内容]
场景 2：创建新文档
graph LR
A[确定目标空间] --> B[getSpaceInfoByKey]
B --> C[获取 spaceid]
C --> D[确定父目录 parentid]
D --> E[createDocument]
场景 3：更新文档
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：复制文档
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）
graph LR
A[准备本地文件] --> B[确定父目录 parent_id]
B --> C[upload 命令上传]
C --> D{导入成功?}
D -->|是| E[文档已创建]
D -->|否| F[检查文件/权限]
场景 5：操作多维表格
graph LR
A[smartsheetGetFields] --> B[了解字段结构]
B --> C{操作类型}
C -->|查询| D[smartsheetGetRecords]
C -->|新增| E[smartsheetAddRecords]
C -->|更新| F[smartsheetUpdateRecords]
C -->|删除| G[smartsheetDeleteRecords]
错误处理
| 错误信息 | 原因 | 解决方案 |
|---|
body 为空值 | 内容参数为空 | 确保传入有效的文档内容 | MCP不支持审批流程 | 文档需要审批 | 手动在 iWiki 网页操作 |
参考资料
|
|---|
