插件文档撰写规范
1. 文档撰写
1.1 结构模板
文档撰写模板:插件文档撰写结构
- 智能助手触发文档结构参考:企业微信通讯录自动添加成员、企业微信自动建群插件
- 按钮字段触发文档结构参考:高德地图插件、飞书自建应用插件
- 前端事件触发文档结构参考:字段校验增强插件、企业信息查询插件
- 流程节点触发文档结构参考:金蝶云星空-销售出库单同步插件
- 自定义按钮中智能助手触发文档结构参考:简道云主数据推送至金蝶云星辰
1.2 内容要求
1)文档中需要设置相对完整的表单场景。如自动获取流程状态插件,需要设置相对完整的流程,可以是请假流程、物品领用申请流程等。不能在表单中仅设置一个表示流程状态的字段。
2)文档中录入相关数据时,需要使用合理完整的模拟数据,不可使用无意义、残缺的测试数据。
- 错误示范:
学生姓名 | 年龄 | 性别 |
Test 1 | 100 | 男 |
2 | 2000 | |
3 | 300 | 女 |
- 正确示范:
学生姓名 | 年龄 | 性别 |
小简 | 22 | 男 |
小道 | 34 | 女 |
小云 | 26 | 男 |
3)预期效果处需给出插件执行成功的效果图。
2. 使用工具
2.1 截图工具
为了避免出现色差,建议使用电脑自带的快捷键截图:
- mac:command+shift+4(选取部分区域截屏) & command+shift+3(电脑全屏)
- Windows:Windows + Shift + S
2.2 图片制作工具
- 图片制作工具:Figma
- Figma 注册地址:Figma 官网
2.3 动图工具
动图录制工具:
- Windows:ScreenToGif,ScreenToGif 下载地址:ScreenToGif下载
- mac:licecap,licecap 下载地址:licecap下载
3. 标注规范
3.1 截图规范
1)图越清晰越好,如果需要截很小的一个区域的图而又截不清晰,建议将浏览器放大了再截,尽量清晰。
2)截图时需要注意图不能太宽,不可以将浏览器全屏后截图,这样会导致放在帮助中心后看不清。
- 尽量截局部图,不截全图;
- 如果需要截全图,不可在全屏模式等宽屏幕状态下截图,需要调整浏览器宽度后截小图。
3)保持边缘整齐,边缘尽量在空白位置,且上下左右留白尽量一致。
4)录制动图时,尽量控制在15s之内。
3.2 Figma标注模板
点击下载:图片标注模板.fig
Figma使用方法可参考:Figma使用方法

400-111-0890
在线咨询