test

TUTORIAL.md

@@ -1,12 +1,6 @@
-> **模板说明（复制后删除本段）**  
-> 本文对应技能市场 **「使用教程」** Tab（发布时同步为 `tutorial_md`）。  
-> 面向普通用户写**可跟着做的步骤**，不要写 CLI、目录结构、release、开发规范。  
-> 与根 `README.md`（技能说明）分工：README 讲「是什么 / 能做什么」；本文讲「第一次怎么用完」。  
-> **复制后验收章节（标题可微调）：**「开始前」「第一步…」「第二步…」「常见卡住怎么办」。
+# 待办事项管理 使用教程
 
-# 【技能名称】使用教程
-
-用最短路径带用户完成一次成功使用。步骤要具体，可用「打开匠厂 → …」这类操作语言。
+用最短路径带你完成一次从「新建待办」到「标记完成」的完整使用。
 
 ---
 
@@ -16,10 +10,8 @@
 
 1. 已安装并登录匠厂客户端
 2. 已在技能市场安装本技能（或更新到最新版）
-3. 【网页自动化类技能】首次运行一般会自动登记本平台账号；也可在「账号管理」中指定登录标识。浏览器会话由系统隔离管理——**不要**用本机日常浏览器用户目录去跑真实站
-4. 【按平台】若本技能说明「需要先登录目标站」，请在弹出的有头浏览器中按提示登录或扫码；「登记账号」不等于「已登录目标站」。若说明「可不登录也能用」，仍须有可用的账号会话目录
-5. 【网页自动化类技能】已登记账号可在「数据管理 / 账号管理」查看；每个账号都有独立浏览器会话
-6. 【如需】需要的文件 / 时间范围 / 单号等已准备好
+3. 本技能使用本地数据库存储待办，首次使用会自动初始化，无需手动准备
+4. 如需设置截止时间，请提前想好具体日期时间；优先级可选「高 / 中 / 低」，不写默认「中」
 
 ---
 
@@ -27,7 +19,11 @@
 
 在匠厂里新建任务或打开对话，用自然语言说明要做什么，例如：
 
-> “帮我【完成某件业务事】，范围是【时间 / 对象 / 条件】。”
+> “帮我加一条待办：周五前提交项目周报，优先级高。”
+>
+> “帮我看看现在有哪些待办。”
+>
+> “把第 3 条待办标记为完成。”
 
 建议一次只交代一件事；范围说清楚，减少来回确认。
 
@@ -35,10 +31,11 @@
 
 ## 第二步：按提示补充信息
 
-如果 Agent 问你缺什么（账号、文件、筛选条件），按提示补充即可。
+如果 Agent 问你缺什么，按提示补充即可。
 
-- 有文件时：按界面提示选择或拖入
-- 有账号时：确认已在对应平台登录，且具备操作权限
+- **新增待办时**：标题是必填的；优先级和截止时间可选，不写会用默认值（优先级「中」，无截止时间）
+- **标记完成 / 删除时**：需要提供待办编号（可一次给多个，用逗号隔开）
+- **查看列表时**：可指定只看「待办中」或「已完成」，不指定则全部列出
 
 ---
 
@@ -46,9 +43,10 @@
 
 任务结束后，请核对：
 
-- 是否成功完成
-- 处理了多少条 / 哪些失败
-- 生成的文件、表格或记录是否在预期位置
+- **新增成功**：会返回这条待办的编号、标题、状态、优先级等信息，请记下编号以便后续操作
+- **列表查询**：会返回待办清单，默认按创建时间倒序，最多 100 条
+- **标记完成 / 删除**：会逐条返回成功或失败，注意看是否有编号不存在、或已完成状态无法重复标记的情况
+- **统计**：会显示总数、待办数、完成数
 
 若失败，先看失败原因说明，再按下一节排查。
 
@@ -58,10 +56,11 @@
 
 | 现象 | 你可以先试 |
 |------|------------|
-| 提示未登录 / 无权限 | 确认匠厂已登录；业务账号是否在线、权限是否足够 |
-| 提示账号不存在 / 被占用 | 到「数据管理 / 账号管理」确认账号记录和状态，稍后再试；不要重复创建账号 |
-| 提示缺少必要信息 | 把时间范围、单号、文件等说完整后再试一次 |
-| 一直没有结果 | 到任务中心查看进度或失败原因；必要时重新发起 |
-| 结果不对 | 用更明确的条件再说一次，或缩小范围重试 |
+| 提示标题不能为空 | 重新发起，把待办内容说清楚（标题不能留空） |
+| 提示待办编号不存在 | 先用「查看待办列表」确认正确编号，再操作 |
+| 提示该待办已是完成状态 | 已完成的待办不能重复标记完成，无需再操作 |
+| 优先级不生效 | 优先级只能是「高 / 中 / 低」，请用这三个词之一 |
+| 截止时间不对 | 截止时间请用明确的日期时间表述（如「明天下午 6 点」「9 月 10 日 18:00」），避免模糊说法 |
+| 列表数据为空 | 确认是否还没有新增过待办；或是否筛选了「已完成」但没有已完成项 |
 
 仍无法解决时，把「你说了什么 + 界面提示原文」发给支持人员，便于排查。