@rezti/dsh-rez-suite 0.1.49 → 0.1.51

package/templates/shared/wecomcli-smartsheet/assets/templates/wechat_customer.md

@@ -0,0 +1,384 @@
+# 管理微信上的客户的数据表模版
+
+## 包含表格模版
+
+- **客户服务跟进**：基于企业微信外部联系人数据，管理客户线索、服务跟进记录及满意度调研，支持业绩仪表盘展示销售额、客户状态和来源分布。
+- **客户群服务跟进**：以客户群为单位管理服务跟进，记录群主、群人数、客户状态及订单信息，适合通过微信群维护客户关系的销售场景。
+- **客户销售跟进**：整合客户商机、订单跟进和产品库存管理，记录客户意向数量、订单进度及产品报价，支持销售全流程可视化管理。
+- **学员服务跟进**：面向教育培训机构，管理学员线索、课程预约、上课记录及学员评价，支持教练课时统计和销售业绩分析。
+- **学员群服务跟进**：以学员群为单位管理课程服务，记录群主、学员状态、课程预约及上课记录，适合通过微信群运营学员的培训机构。
+
+## 客户服务跟进
+
+### 客户线索（示例）
+
+| 字段 | 类型 |
+| --- | --- |
+| 职务 | FIELD_TYPE_TEXT |
+| 地址 | FIELD_TYPE_TEXT |
+| 企业 | FIELD_TYPE_TEXT |
+| 添加人所属部门 | FIELD_TYPE_SELECT |
+| 对接销售 | FIELD_TYPE_USER |
+| 客户 | FIELD_TYPE_USER |
+| 跟进备注（可编辑） | FIELD_TYPE_TEXT |
+| 标签组 | FIELD_TYPE_SELECT |
+| 客户状态（可编辑） | FIELD_TYPE_SELECT |
+| 客户跟进总结 | FIELD_TYPE_TEXT |
+| 添加人 | FIELD_TYPE_USER |
+| 手机 | FIELD_TYPE_PHONE_NUMBER |
+| 其他添加人 | FIELD_TYPE_LOOKUP |
+| 来源 | FIELD_TYPE_SELECT |
+| 添加时间 | FIELD_TYPE_DATE_TIME |
+| 描述 | FIELD_TYPE_TEXT |
+| 电话 | FIELD_TYPE_PHONE_NUMBER |
+| 添加人账号 | FIELD_TYPE_TEXT |
+| 邮箱 | FIELD_TYPE_EMAIL |
+| 客户名称 | FIELD_TYPE_TEXT |
+
+### 服务跟进（示例）
+
+| 字段 | 类型 |
+| --- | --- |
+| 订单类型 | FIELD_TYPE_SELECT |
+| 客户电话 | FIELD_TYPE_LOOKUP |
+| 服务状态 | FIELD_TYPE_SELECT |
+| 客户名称 | FIELD_TYPE_REFERENCE |
+| 订单编号 | FIELD_TYPE_AUTONUMBER |
+| 客户反馈 | FIELD_TYPE_TEXT |
+| 服务对接人 | FIELD_TYPE_USER |
+| 成交金额 | FIELD_TYPE_CURRENCY |
+| 成交时间 | FIELD_TYPE_DATE_TIME |
+
+### 满意度调研（示例）
+
+| 字段 | 类型 |
+| --- | --- |
+| 订单编号 | FIELD_TYPE_REFERENCE |
+| 提交时间 | FIELD_TYPE_CREATED_TIME |
+| 是否考虑回购 | FIELD_TYPE_SELECT |
+| 客户名称 | FIELD_TYPE_TEXT |
+| 订单类型 | FIELD_TYPE_LOOKUP |
+| 其他意见和建议 | FIELD_TYPE_TEXT |
+| 服务打分 | FIELD_TYPE_NUMBER |
+| 是否需要申请售后？ | FIELD_TYPE_SELECT |
+| 产品打分 | FIELD_TYPE_NUMBER |
+
+### 业绩仪表盘（示例）（仪表盘）
+
+| 图表名称 | 图表类型 | 坐标 | 尺寸 |
+| --- | --- | --- | --- |
+| 客户记录数 | numberCard | [0, 1] | [4, 3] |
+| 订单分布 | stackbar | [8, 5] | [4, 3] |
+| 销售分布 | pie | [4, 5] | [4, 3] |
+| 客户状态分布 | pie | [8, 1] | [4, 3] |
+| 本周新增客户数 | numberCard | [4, 1] | [4, 3] |
+| 添加人分布 | bar | [4, 9] | [4, 3] |
+| 添加时间分布 | smoothline | [0, 9] | [4, 3] |
+| 总销售额 | numberCard | [0, 5] | [4, 3] |
+| 客户来源分布 | pie | [8, 9] | [4, 3] |
+
+## 客户群服务跟进
+
+### 客户线索（示例）
+
+| 字段 | 类型 |
+| --- | --- |
+| 职务 | FIELD_TYPE_TEXT |
+| 企业 | FIELD_TYPE_TEXT |
+| 客户群 | FIELD_TYPE_WWGROUP |
+| 跟进备注 | FIELD_TYPE_TEXT |
+| 客户状态（可编辑） | FIELD_TYPE_SELECT |
+| 对接销售 | FIELD_TYPE_USER |
+| 群主 | FIELD_TYPE_USER |
+| 客户跟进总结 | FIELD_TYPE_TEXT |
+| 群人数 | FIELD_TYPE_NUMBER |
+| 群主所在部门 | FIELD_TYPE_SELECT |
+| 客户（可编辑） | FIELD_TYPE_USER |
+| 创建时间 | FIELD_TYPE_DATE_TIME |
+| 手机 | FIELD_TYPE_PHONE_NUMBER |
+| 邮箱 | FIELD_TYPE_EMAIL |
+
+### 服务跟进（示例）
+
+| 字段 | 类型 |
+| --- | --- |
+| 客户群 | FIELD_TYPE_LOOKUP |
+| 订单类型 | FIELD_TYPE_SELECT |
+| 客户电话 | FIELD_TYPE_LOOKUP |
+| 服务状态 | FIELD_TYPE_SELECT |
+| 客户名称 | FIELD_TYPE_REFERENCE |
+| 订单编号 | FIELD_TYPE_AUTONUMBER |
+| 客户反馈 | FIELD_TYPE_TEXT |
+| 服务对接人 | FIELD_TYPE_USER |
+| 成交金额 | FIELD_TYPE_CURRENCY |
+| 成交时间 | FIELD_TYPE_DATE_TIME |
+
+### 满意度调研（示例）
+
+| 字段 | 类型 |
+| --- | --- |
+| 订单编号 | FIELD_TYPE_REFERENCE |
+| 提交时间 | FIELD_TYPE_CREATED_TIME |
+| 是否考虑回购 | FIELD_TYPE_SELECT |
+| 用户名称 | FIELD_TYPE_TEXT |
+| 订单类型 | FIELD_TYPE_LOOKUP |
+| 其他意见和建议 | FIELD_TYPE_TEXT |
+| 服务打分 | FIELD_TYPE_NUMBER |
+| 是否需要申请售后？ | FIELD_TYPE_SELECT |
+| 产品打分 | FIELD_TYPE_NUMBER |
+
+### 业绩仪表盘（示例）（仪表盘）
+
+| 图表名称 | 图表类型 | 坐标 | 尺寸 |
+| --- | --- | --- | --- |
+| 客户记录数 | numberCard | [0, 1] | [4, 3] |
+| 总销售额 | numberCard | [0, 5] | [4, 3] |
+| 订单类型分布 | doughnut | [8, 5] | [4, 3] |
+| 销售人员业绩分布 | bar | [4, 5] | [4, 3] |
+| 创建时间分布 | smoothline | [6, 9] | [6, 4] |
+| 本周新增客户群数 | numberCard | [4, 1] | [4, 3] |
+| 客户状态分布 | pie | [0, 9] | [6, 4] |
+| 群主分布 | bar | [8, 1] | [4, 3] |
+
+## 客户销售跟进
+
+### 客户商机（示例）
+
+| 字段 | 类型 |
+| --- | --- |
+| 职务 | FIELD_TYPE_TEXT |
+| 地址 | FIELD_TYPE_TEXT |
+| 企业 | FIELD_TYPE_TEXT |
+| 添加人所属部门 | FIELD_TYPE_SELECT |
+| 客户 | FIELD_TYPE_USER |
+| 客户名称 2 | FIELD_TYPE_LOCATION |
+| 标签组 | FIELD_TYPE_SELECT |
+| 客户跟进总结 | FIELD_TYPE_TEXT |
+| 文本 | FIELD_TYPE_TEXT |
+| 添加人 | FIELD_TYPE_USER |
+| 客户状态 | FIELD_TYPE_SELECT |
+| 电话 | FIELD_TYPE_PHONE_NUMBER |
+| 其他添加人 | FIELD_TYPE_LOOKUP |
+| 来源 | FIELD_TYPE_SELECT |
+| 添加时间 | FIELD_TYPE_DATE_TIME |
+| 描述 | FIELD_TYPE_TEXT |
+| 手机 | FIELD_TYPE_PHONE_NUMBER |
+| 地理位置 | FIELD_TYPE_LOCATION |
+| 跟进备注 | FIELD_TYPE_TEXT |
+| 添加人账号 | FIELD_TYPE_TEXT |
+| 邮箱 | FIELD_TYPE_EMAIL |
+| 客户名称 | FIELD_TYPE_TEXT |
+
+### 订单跟进（示例）
+
+| 字段 | 类型 |
+| --- | --- |
+| 职务 | FIELD_TYPE_TEXT |
+| 地址 | FIELD_TYPE_TEXT |
+| 预估订单金额 | FIELD_TYPE_FORMULA |
+| 企业 | FIELD_TYPE_TEXT |
+| 添加人所属部门 | FIELD_TYPE_SELECT |
+| 产品 | FIELD_TYPE_REFERENCE |
+| 订单进度 | FIELD_TYPE_SELECT |
+| 跟进销售 | FIELD_TYPE_USER |
+| 最近跟进时间 | FIELD_TYPE_DATE_TIME |
+| 客户 | FIELD_TYPE_USER |
+| 单价 | FIELD_TYPE_CURRENCY |
+| 自动编号 | FIELD_TYPE_AUTONUMBER |
+| 跟进备注 | FIELD_TYPE_TEXT |
+| 标签组 | FIELD_TYPE_SELECT |
+| 意向数量 | FIELD_TYPE_NUMBER |
+| 手机 | FIELD_TYPE_PHONE_NUMBER |
+| 添加人 | FIELD_TYPE_USER |
+| 用户来源 | FIELD_TYPE_SELECT |
+| 添加时间 | FIELD_TYPE_DATE_TIME |
+| 描述 | FIELD_TYPE_TEXT |
+| 电话 | FIELD_TYPE_PHONE_NUMBER |
+| 添加人账号 | FIELD_TYPE_TEXT |
+| 邮箱 | FIELD_TYPE_EMAIL |
+| 客户名称 | FIELD_TYPE_TEXT |
+
+### 产品库存（示例）
+
+| 字段 | 类型 |
+| --- | --- |
+| 图片 | FIELD_TYPE_IMAGE |
+| 更新时间 | FIELD_TYPE_MODIFIED_TIME |
+| 产品名称 | FIELD_TYPE_TEXT |
+| 库存数量 | FIELD_TYPE_NUMBER |
+| 货号 | FIELD_TYPE_AUTONUMBER |
+| 报价 | FIELD_TYPE_CURRENCY |
+| 上架季节 | FIELD_TYPE_SELECT |
+
+### 业绩仪表盘（示例）（仪表盘）
+
+| 图表名称 | 图表类型 | 坐标 | 尺寸 |
+| --- | --- | --- | --- |
+| 本周新增客户数 | numberCard | [4, 1] | [4, 3] |
+| 添加时间分布 | smoothline | [4, 14] | [4, 3] |
+| 产品报价及库存 | combo | [0, 9] | [12, 4] |
+| 客户分布 | doughnut | [8, 5] | [4, 3] |
+| 总销售额 | numberCard | [0, 5] | [4, 3] |
+| 添加人分布 | bar | [0, 14] | [4, 3] |
+| 客户记录数 | numberCard | [0, 1] | [4, 3] |
+| 销售分布 | pie | [4, 5] | [4, 3] |
+| 客户来源分布 | pie | [8, 14] | [4, 3] |
+| 客户状态分布 | pie | [8, 1] | [4, 3] |
+
+## 学员服务跟进
+
+### 学员线索（示例）
+
+| 字段 | 类型 |
+| --- | --- |
+| 学员跟进总结 | FIELD_TYPE_TEXT |
+| 添加人所属部门 | FIELD_TYPE_SELECT |
+| 邮箱 | FIELD_TYPE_EMAIL |
+| 添加人账号 | FIELD_TYPE_TEXT |
+| 描述 | FIELD_TYPE_TEXT |
+| 标签组 | FIELD_TYPE_SELECT |
+| 添加人 | FIELD_TYPE_USER |
+| 学员 | FIELD_TYPE_USER |
+| 对接销售 | FIELD_TYPE_USER |
+| 跟进备注 | FIELD_TYPE_TEXT |
+| 学员状态 | FIELD_TYPE_SELECT |
+| 手机 | FIELD_TYPE_PHONE_NUMBER |
+| 地址 | FIELD_TYPE_TEXT |
+| 企业 | FIELD_TYPE_TEXT |
+| 来源 | FIELD_TYPE_SELECT |
+| 职务 | FIELD_TYPE_TEXT |
+| 添加时间 | FIELD_TYPE_DATE_TIME |
+| 其他添加人 | FIELD_TYPE_LOOKUP |
+| 学员名称 | FIELD_TYPE_TEXT |
+
+### 课程预约（示例）
+
+| 字段 | 类型 |
+| --- | --- |
+| 联系电话 | FIELD_TYPE_PHONE_NUMBER |
+| 预约上课时间 | FIELD_TYPE_DATE_TIME |
+| 姓名 | FIELD_TYPE_TEXT |
+| 订单ID | FIELD_TYPE_FORMULA |
+| 课程类型 | FIELD_TYPE_SELECT |
+| 课时/小时 | FIELD_TYPE_NUMBER |
+
+### 上课记录（示例）
+
+| 字段 | 类型 |
+| --- | --- |
+| 是否转化为会员 | FIELD_TYPE_SELECT |
+| 课程类型 | FIELD_TYPE_LOOKUP |
+| 客户电话 | FIELD_TYPE_LOOKUP |
+| 是否付款 | FIELD_TYPE_SELECT |
+| 学员名称 | FIELD_TYPE_REFERENCE |
+| 订单编号 | FIELD_TYPE_LOOKUP |
+| 是否上课 | FIELD_TYPE_SELECT |
+| 付款方式 | FIELD_TYPE_SELECT |
+| 负责销售 | FIELD_TYPE_USER |
+| 时长/小时 | FIELD_TYPE_LOOKUP |
+| 上课备注 | FIELD_TYPE_TEXT |
+| 教练 | FIELD_TYPE_USER |
+| 付费课时 | FIELD_TYPE_NUMBER |
+| 订单金额 | FIELD_TYPE_CURRENCY |
+| 预约时间 | FIELD_TYPE_LOOKUP |
+
+### 学员评价（示例）
+
+| 字段 | 类型 |
+| --- | --- |
+| 教练专业度 | FIELD_TYPE_NUMBER |
+| 上课环境 | FIELD_TYPE_NUMBER |
+| 是否会推荐给朋友 | FIELD_TYPE_SELECT |
+| 其他评价和建议 | FIELD_TYPE_TEXT |
+| 提交时间 | FIELD_TYPE_DATE_TIME |
+| 学员名称 | FIELD_TYPE_TEXT |
+
+### 业绩仪表盘（示例）（仪表盘）
+
+| 图表名称 | 图表类型 | 坐标 | 尺寸 |
+| --- | --- | --- | --- |
+| 添加时间分布 | smoothline | [4, 13] | [4, 3] |
+| 总销售额 | numberCard | [0, 5] | [4, 3] |
+| 课程分布 | bar | [8, 5] | [4, 3] |
+| 教练课时数 | stackbar | [0, 9] | [6, 3] |
+| 本周新增学员数 | numberCard | [4, 1] | [4, 3] |
+| 学员状态分布 | pie | [8, 1] | [4, 3] |
+| 学员来源分布 | pie | [8, 13] | [4, 3] |
+| 添加人分布 | bar | [0, 13] | [4, 3] |
+| 学员记录数 | numberCard | [0, 1] | [4, 3] |
+| 销售人员业绩 | doughnut | [4, 5] | [4, 3] |
+
+## 学员群服务跟进
+
+### 学员线索（示例）
+
+| 字段 | 类型 |
+| --- | --- |
+| 创建时间 | FIELD_TYPE_DATE_TIME |
+| 群人数 | FIELD_TYPE_NUMBER |
+| 学员群 | FIELD_TYPE_WWGROUP |
+| 学员（可编辑） | FIELD_TYPE_USER |
+| 对接销售 | FIELD_TYPE_USER |
+| 跟进备注（可编辑） | FIELD_TYPE_TEXT |
+| 学员状态（可编辑） | FIELD_TYPE_SELECT |
+| 手机 | FIELD_TYPE_PHONE_NUMBER |
+| 群主 | FIELD_TYPE_USER |
+| 客户跟进总结 | FIELD_TYPE_TEXT |
+| 群主所在部门 | FIELD_TYPE_SELECT |
+
+### 课程预约（示例）
+
+| 字段 | 类型 |
+| --- | --- |
+| 联系电话 | FIELD_TYPE_PHONE_NUMBER |
+| 预约上课时间 | FIELD_TYPE_DATE_TIME |
+| 姓名 | FIELD_TYPE_TEXT |
+| 订单ID | FIELD_TYPE_FORMULA |
+| 课程类型 | FIELD_TYPE_SELECT |
+| 课时/小时 | FIELD_TYPE_NUMBER |
+
+### 上课记录（示例）
+
+| 字段 | 类型 |
+| --- | --- |
+| 是否转化为会员 | FIELD_TYPE_SELECT |
+| 课程类型 | FIELD_TYPE_LOOKUP |
+| 客户电话 | FIELD_TYPE_LOOKUP |
+| 是否付款 | FIELD_TYPE_SELECT |
+| 学员名称 | FIELD_TYPE_REFERENCE |
+| 订单编号 | FIELD_TYPE_LOOKUP |
+| 是否上课 | FIELD_TYPE_SELECT |
+| 付款方式 | FIELD_TYPE_SELECT |
+| 负责销售 | FIELD_TYPE_USER |
+| 时长/小时 | FIELD_TYPE_LOOKUP |
+| 上课备注 | FIELD_TYPE_TEXT |
+| 教练 | FIELD_TYPE_USER |
+| 付费课时 | FIELD_TYPE_NUMBER |
+| 订单金额 | FIELD_TYPE_CURRENCY |
+| 预约时间 | FIELD_TYPE_LOOKUP |
+
+### 学员评价（示例）
+
+| 字段 | 类型 |
+| --- | --- |
+| 教练专业度 | FIELD_TYPE_NUMBER |
+| 上课环境 | FIELD_TYPE_NUMBER |
+| 是否会推荐给朋友 | FIELD_TYPE_SELECT |
+| 其他评价和建议 | FIELD_TYPE_TEXT |
+| 提交时间 | FIELD_TYPE_DATE_TIME |
+| 学员名称 | FIELD_TYPE_TEXT |
+
+### 业绩仪表盘（示例）（仪表盘）
+
+| 图表名称 | 图表类型 | 坐标 | 尺寸 |
+| --- | --- | --- | --- |
+| 教练课时数 | stackbar | [0, 9] | [6, 3] |
+| 教练评价 | bar | [6, 9] | [6, 3] |
+| 课程分布 | bar | [8, 5] | [4, 3] |
+| 学员记录数 | numberCard | [0, 1] | [4, 3] |
+| 群主分布 | bar | [8, 1] | [4, 3] |
+| 学员状态分布 | pie | [0, 13] | [6, 4] |
+| 销售人员业绩 | doughnut | [4, 5] | [4, 3] |
+| 本周新增学员群数 | numberCard | [4, 1] | [4, 3] |
+| 创建时间分布 | smoothline | [6, 13] | [6, 4] |
+| 总销售额 | numberCard | [0, 5] | [4, 3] |

package/templates/shared/wecomcli-smartsheet/assets/templates/work_report.md

@@ -0,0 +1,100 @@
+# 工作汇报的数据表模版
+
+## 包含表格模版
+
+- **日报周报表**：同时管理日报和周报，记录工作总结、下一步计划及所属项目，支持日报/周报提交数量统计和项目分布分析。
+- **团队日报汇总**：汇总团队成员日报，记录今日工作总结、明日计划及困难反馈，支持团队日报提交情况统计和项目任务分布。
+- **工作周报简表**：简洁的周报提交模版，记录本周工作总结、下周计划及附件，支持各员工累计提交数和每周提交趋势统计。
+
+## 日报周报表
+
+### 日报
+
+| 字段 | 类型 |
+| --- | --- |
+| 负责人 | FIELD_TYPE_USER |
+| 汇报时间 | FIELD_TYPE_DATE_TIME |
+| 相关资料 | FIELD_TYPE_ATTACHMENT |
+| 下一步计划 | FIELD_TYPE_TEXT |
+| 所属项目 | FIELD_TYPE_SELECT |
+| 今日工作总结 | FIELD_TYPE_TEXT |
+
+### 周报
+
+| 字段 | 类型 |
+| --- | --- |
+| 负责人 | FIELD_TYPE_USER |
+| 汇报时间 | FIELD_TYPE_DATE_TIME |
+| 相关资料 | FIELD_TYPE_ATTACHMENT |
+| 所属项目 | FIELD_TYPE_SELECT |
+| 周报内容 | FIELD_TYPE_TEXT |
+
+### 仪表盘（仪表盘）
+
+| 图表名称 | 图表类型 | 坐标 | 尺寸 |
+| --- | --- | --- | --- |
+| 日报提交总数 | numberCard | [4, 0] | [4, 3] |
+| 今日提交周报数 | numberCard | [0, 3] | [4, 3] |
+| 日报所属项目分布 | column | [8, 0] | [4, 3] |
+| 周报所属项目分布 | column | [8, 3] | [4, 3] |
+| 周报提交总数 | numberCard | [4, 3] | [4, 3] |
+| 今日提交日报数 | numberCard | [0, 0] | [4, 3] |
+
+## 团队日报汇总
+
+### 日报情况统计（仪表盘）
+
+| 图表名称 | 图表类型 | 坐标 | 尺寸 |
+| --- | --- | --- | --- |
+| 项目任务数 | pie | [0, 4] | [12, 4] |
+| 今日日报总数 | numberCard | [0, 1] | [6, 3] |
+| 团队日报情况 | stackbar | [6, 1] | [6, 3] |
+
+### 团队日报汇总
+
+| 字段 | 类型 |
+| --- | --- |
+| 汇报给 | FIELD_TYPE_USER |
+| 今日工作总结 | FIELD_TYPE_TEXT |
+| 困难及需要的支持 | FIELD_TYPE_TEXT |
+| 是否涉及多部门合作 | FIELD_TYPE_CHECKBOX |
+| 项目 | FIELD_TYPE_SELECT |
+| 提交人 | FIELD_TYPE_SELECT |
+| 明日工作计划 | FIELD_TYPE_TEXT |
+| 附件 | FIELD_TYPE_ATTACHMENT |
+| 关联 | FIELD_TYPE_TWOWAYLINKRECORDS |
+| 日报提交日期 | FIELD_TYPE_DATE_TIME |
+
+### 团队成员管理
+
+| 字段 | 类型 |
+| --- | --- |
+| 资料创建人 | FIELD_TYPE_SELECT |
+| 是否提交今日月报 | FIELD_TYPE_FORMULA |
+| 部门 | FIELD_TYPE_SELECT |
+| 最近修改时间 | FIELD_TYPE_DATE_TIME |
+| 是否提交日报 | FIELD_TYPE_TWOWAYLINKRECORDS |
+| 工号 | FIELD_TYPE_NUMBER |
+| 备注 | FIELD_TYPE_TEXT |
+
+## 工作周报简表
+
+### 周报简表
+
+| 字段 | 类型 |
+| --- | --- |
+| 提交人 | FIELD_TYPE_USER |
+| 其他事项 | FIELD_TYPE_TEXT |
+| 群聊 | FIELD_TYPE_WWGROUP |
+| 下周工作计划 | FIELD_TYPE_TEXT |
+| 提交时间 | FIELD_TYPE_DATE_TIME |
+| 附件 | FIELD_TYPE_ATTACHMENT |
+| 本周工作总结 | FIELD_TYPE_TEXT |
+
+### 周报仪表盘（仪表盘）
+
+| 图表名称 | 图表类型 | 坐标 | 尺寸 |
+| --- | --- | --- | --- |
+| 每周提交数 | stackbar | [3, 4] | [9, 5] |
+| 累计提交总数 | numberCard | [0, 0] | [3, 4] |
+| 各员工累计提交数 | column | [3, 0] | [9, 4] |

package/templates/shared/wecomcli-smartsheet/references/common.md

@@ -0,0 +1,143 @@
+# 智能表格文件级公共接口参考
+
+本文件聚焦智能表格（`smartsheet`）的**文件级创建与导入接口**；重命名、搜索、成员管理、加入规则与未读管理请使用 `wecomcli-doc-manage` 技能。
+
+---
+
+## 场景导航
+
+| 用户场景/意图 | 对应命令 |
+| --- | --- |
+| 新建智能表格 | `smartsheet create` |
+| 导入本地/已上传文件（.csv/.xls/.xlsx）为智能表格 | `smartsheet import` |
+| 删除智能表格文件 | 不支持删除智能表格文件，请直接告知用户 |
+| 修改智能表格名称 | 使用 `wecomcli-doc-manage` 技能 |
+| 搜索智能表格 / 按名称查找 / 查看最近浏览或创建的智能表格 | 使用 `wecomcli-doc-manage` 技能 |
+| 向智能表格添加管理员、可编辑或仅浏览成员 | 使用 `wecomcli-doc-manage` 技能 |
+| 设置通过链接加入智能表格时的权限规则 | 使用 `wecomcli-doc-manage` 技能 |
+| 读取与我相关中未读的文档列表 | 使用 `wecomcli-doc-manage` 技能 |
+| 将与我相关中的文档标记为已读或未读 | 使用 `wecomcli-doc-manage` 技能 |
+
+---
+
+## 接口说明
+
+### 一、新建智能表格（smartsheet create）
+
+新建一个智能表格文档，可选择传入初始表结构定义。
+
+> **新建文档 vs 导入文档——如何正确选择：**
+> - **`smartsheet create`（本接口）**：用于**从零新建**一个企微智能表格。推荐在创建时通过 `sheet_title` + `fields` 一次性初始化子表字段；也支持创建空白智能表格后再调整。**本接口不支持文件导入类参数**（如 `media_id`），所有涉及文件导入的场景请使用 `smartsheet import`。
+> - **`smartsheet import`（导入接口）**：用于将一个**已上传并获得 `media_id` 的文件**（如 `.csv`、`.xlsx` 等）导入为智能表格。适用于用户已经提供文件 `media_id`，或用户明确表达「导入」文件意图的场景。若用户只提供本地文件路径，必须先使用 `wecomcli-media` 技能上传文件获取 `media_id`，再调用本接口。
+
+**命令示例：**
+
+创建智能表格并一次性初始化子表字段（推荐）：
+
+```bash
+wecom-cli smartsheet create --json '{"name": "任务跟踪表", "sheet_title": "任务列表", "fields": [{"field_title": "任务名称", "field_type": "text"}, {"field_title": "优先级", "field_type": "single_select", "property_single_select": {"is_quick_add": true, "options": [{"text": "高", "style": 18}, {"text": "中", "style": 20}, {"text": "低", "style": 16}]}}, {"field_title": "负责人", "field_type": "user", "property_user": {"is_multiple": false, "is_notified": true}}]}'
+```
+
+**（强制）传入 `fields` 创建字段后，须根据传入的 `field_title`，按 `references/smart-sheet-view-types.md` 中「新建字段时的列宽判断规则」和「列宽调整接口调用方式」完成列宽写入。**
+
+创建空白智能表格：
+
+```bash
+wecom-cli smartsheet create --json '{"name": "任务跟踪表"}'
+```
+
+**通用参数：**
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `name` | string | 是 | 文档标题 |
+
+**智能表格专用参数：**
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `sheet_title` | string | 否 | 子表名称 |
+| `fields` | array | 否 | 初始化字段列表。创建空智能表格时无需填写 |
+| `fields[].field_title` | string | 否 | 字段标题 |
+| `fields[].field_type` | string | 否 | 字段类型，完整枚举详见 `references/smart-sheet-field-types.md` |
+
+**返回值：**
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `errcode` | int | 错误码，0 表示成功 |
+| `errmsg` | string | 错误信息 |
+| `url` | string | 新建文档的访问链接 |
+| `docid` | string | 新建文档的 ID |
+| `doc_name` | string | 新建文档的名称 |
+
+---
+
+### 二、导入文档为智能表格（smartsheet import）
+
+将已上传的文件（`.csv`、`.xls`、`.xlsx`）导入为企微智能表格。
+
+**命令示例：**
+
+```bash
+wecom-cli smartsheet import --json '{"name": "data.xlsx", "media_id": "mcabc123"}'
+```
+
+**参数说明：**
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `name` | string | 是 | 二进制文件名（含后缀），用于业务判断文件类型 |
+| `passwd` | string | 否 | 若 office 文件有加密，传入用户输入的密码 |
+| `media_id` | string | 是 | 已上传文件的媒体 ID，前缀通常为 `mc`。只能来自 `wecomcli-media` 的上传接口或其他上游接口返回，禁止自行构造、猜测或从本地路径推断 |
+
+**返回值：**
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `errcode` | int | 网关错误码；`0` 表示请求成功（任务本身是否成功看 `task_status`） |
+| `errmsg` | string | 网关错误信息；失败时用于排查 |
+| `task_id` | string | 导入任务 ID；任务异步执行时可用于追踪导入进度 |
+| `task_status` | string | 导入任务状态枚举：`succ`（成功）/ `fail`（失败）/ `processing`（处理中） |
+| `docid` | string | 导入成功后的文档 ID；`task_status=succ` 时返回 |
+| `url` | string | 导入成功后的文档访问链接；`task_status=succ` 时返回 |
+
+---
+
+## 注意事项
+
+- **获取 docid**：统一遵循 `SKILL.md` 的「如何获取文档 ID（docid）」规则
+- **创建时一次性初始化字段**：新建智能表格时，优先在 `smartsheet create` 直接传 `sheet_title` + `fields` 完成子表字段初始化，避免拆成"创建后再补字段"两步
+- **导入只接受 `media_id`**：执行 `smartsheet import` 前，需先通过 `wecomcli-media` 上传文件并取得 `media_id`，再发起导入
+- **参数不全时必须主动补全**：当必填参数缺失时，禁止猜测或使用默认值，必须用简洁自然语言向用户追问缺失的参数
+
+---
+
+## 参数补全（跨技能协作）
+
+当用户提供的信息不足以完成操作时（如缺少必填参数），**应直接用简洁自然语言引导用户补全缺失的信息；有候选项时在文字中列出，不得自行猜测默认值。**
+
+### 何时触发？
+
+当用户发起智能表格文件级操作的意图，但以下任一必填信息缺失时，触发参数补全：
+
+| 缺失信息 | 对应接口/字段 | 示例用户表述 |
+| --- | --- | --- |
+| 文档名称 | `name` | "帮我建个智能表格"（没说叫什么名字） |
+| 新名称 | 查看 `wecomcli-doc-manage` 技能 | "帮我改一下智能表格名"（没说改成什么） |
+| 成员信息 | 查看 `wecomcli-doc-manage` 技能 | "帮我给智能表格加个人"（没说加谁、什么权限） |
+| 搜索关键词 | 查看 `wecomcli-doc-manage` 技能 | "帮我搜一下智能表格"（没说搜什么关键词） |
+| 浏览时间范围 | 查看 `wecomcli-doc-manage` 技能 | "看看我最近浏览了哪些智能表格"（没说时间范围）。需在文字中列出"最近一周"、"最近一个月"、"自定义时间范围"等选项 |
+| 创建时间范围 | 查看 `wecomcli-doc-manage` 技能 | "看看我最近创建的智能表格"（没说时间范围）。需在文字中列出"最近一周"、"最近一个月"、"自定义时间范围"等选项 |
+| 目标文档和操作类型 | 查看 `wecomcli-doc-manage` 技能 | "帮我标记智能表格已读"（没说哪些文档） |
+
+### 正确做法
+
+1. 分析用户已提供的信息，确定哪些必填参数缺失
+2. **用简洁自然语言仅对缺失或有歧义的参数进行提问**（用户已明确的参数不要重复问）；有候选项时在文字中列出供用户选择
+3. 收到用户回答后，组装完整的入参，执行操作
+
+### 禁止事项
+
+- ❌ 参数缺失时自行猜测默认值（如随意假设文档名称或目标文档）
+- ❌ 用户已明确的参数还重复提问