工单管理 (Task) 命令详解
工单是售后宝的核心业务对象——客户报修、设备巡检、上门服务，都是通过工单来流转的。
命令列表
| 命令 | 说明 | 典型用法 |
|---|---|---|
task search | 搜索工单列表 | "帮我找一下有哪些工单" |
task detail | 查看工单详情 | "这个工单的具体情况是什么" |
task create submit | 创建并提交工单 | "帮我建一个新工单" |
task alloc submit | 派工（分配执行人） | "这个工单派给谁去做" |
task field list | 获取工单字段定义 | "这种工单要填哪些信息" |
task field common | 获取通用字段 | "所有工单都有哪些公共字段" |
task type list | 获取工单类型列表 | "系统里有哪几种工单类型" |
task search 常用参数
| 参数 | 说明 |
|---|---|
--keyword | 按关键词搜（标题、描述里有这个词的工单） |
--template-id | 只看某一种类型的工单 |
--state | 只看某个状态的工单（如待处理、已完成） |
--page / --page-size | 翻页用的，默认第 0 页、每页 10 条 |
--format-data | 把字段编码翻译成人能看懂的标签 |
--all | 一次性拉回所有数据，不用自己翻页 |
task create submit 常用参数
| 参数 | 说明 |
|---|---|
--template-id | 用哪个工单模板来创建（必填） |
--customer-id | 这个工单属于哪个客户 |
--service-content | 服务内容，比如"空调维修" |
--description | 详细描述问题 |
--level | 工单优先级 |
--no-approve | 跳过审批检查（谨慎使用） |
task alloc submit 常用参数
| 参数 | 说明 |
|---|---|
--task-id | 要派工的工单 ID（必填） |
--executor-id | 直接指定执行人 ID（如果你知道的话） |
--search-user | 按名字搜索执行人（更常用，AI 会让你选） |
--synergies | 需要协助的人 |
--no-approve | 跳过审批检查 |