2.7 KiB
2.7 KiB
模板说明（复制后删除本段）
本文对应技能市场 「使用教程」 Tab（发布时同步为tutorial_md）。
面向普通用户写可跟着做的步骤，不要写 CLI、目录结构、release、开发规范。
与根README.md（技能说明）分工：README 讲「是什么 / 能做什么」；本文讲「第一次怎么用完」。
复制后验收章节（标题可微调）：「开始前」「第一步…」「第二步…」「常见卡住怎么办」。
【技能名称】使用教程
用最短路径带用户完成一次成功使用。步骤要具体，可用「打开匠厂 → …」这类操作语言。
开始前
确认：
- 已安装并登录匠厂客户端
- 已在技能市场安装本技能（或更新到最新版）
- 【网页自动化类技能】首次运行一般会自动登记本平台账号；也可在「账号管理」中指定登录标识。浏览器会话由系统隔离管理——不要用本机日常浏览器用户目录去跑真实站
- 【按平台】若本技能说明「需要先登录目标站」，请在弹出的有头浏览器中按提示登录或扫码；「登记账号」不等于「已登录目标站」。若说明「可不登录也能用」，仍须有可用的账号会话目录
- 【如需】需要的文件 / 时间范围 / 单号等已准备好
第一步：打开技能并说清目标
在匠厂里新建任务或打开对话，用自然语言说明要做什么，例如：
“帮我【完成某件业务事】，范围是【时间 / 对象 / 条件】。”
建议一次只交代一件事；范围说清楚，减少来回确认。
第二步：按提示补充信息
如果 Agent 问你缺什么（账号、文件、筛选条件），按提示补充即可。
- 有文件时：按界面提示选择或拖入
- 有账号时：确认已在对应平台登录，且具备操作权限
第三步：等待结果并核对
任务结束后，请核对：
- 是否成功完成
- 处理了多少条 / 哪些失败
- 生成的文件、表格或记录是否在预期位置
若失败，先看失败原因说明，再按下一节排查。
常见卡住怎么办
| 现象 | 你可以先试 |
|---|---|
| 提示未登录 / 无权限 | 确认匠厂已登录；业务账号是否在线、权限是否足够 |
| 提示缺少必要信息 | 把时间范围、单号、文件等说完整后再试一次 |
| 一直没有结果 | 到任务中心查看进度或失败原因；必要时重新发起 |
| 结果不对 | 用更明确的条件再说一次，或缩小范围重试 |
仍无法解决时，把「你说了什么 + 界面提示原文」发给支持人员，便于排查。