chore: auto release commit (2026-07-03 12:09:55)

README.md

@@ -1,99 +1,76 @@
 ---
-description: "用用户能理解的方式说明这个技能能做什么、适合什么场景，以及如何开始使用。"
+description: "自动从 Amazon 卖家中心下载结算报表，省去重复登录与手工导出。"
 ---
 
-> **模板说明（复制后删除本段）**  
-> 本文是技能市场详情与普通用户说明，**不是** Agent 参考索引、CLI 契约或开发文档。  
-> frontmatter 的 `description` 必须是用户能看懂的一句话能力描述；**不得**写成 CLI、schema、references、development、契约、数据结构、开发规范或 Agent 参考索引。  
-> 正文只回答用户关心的问题，**不要**把 Playwright、DOM、Python、RPA、references、development、schema 等作为面向用户的主说明内容；若业务上必须出现技术词，须用用户能理解的方式解释，且不能喧宾夺主。
+# Amazon 结算报表自动下载
 
-# 【技能名称】
-
-> 用一两句话说明这个技能帮助用户完成什么工作。  
-> 这里不要解释技术实现，要从用户的业务目标出发描述价值。
+帮你从 Amazon 卖家中心自动申请并下载结算报表（Settlement），保存为 Excel 文件，并记录每次下载结果。
 
 ---
 
 ## 这个技能能帮你做什么
 
-用 3 到 6 条业务能力说明技能价值，例如：
-
-- 【自动整理/查询/生成/同步/核对/提交】某类业务数据
-- 帮你减少重复操作，降低人工录入或核对成本
-- 在任务完成后给出清晰的处理结果、失败原因或后续建议
+- 按你指定的日期范围，自动申请结算报表
+- 等待报表生成完成后自动下载，保存到本地
+- 记录每次下载是否成功、文件路径与失败原因
+- 适合跨境财务实训中定期拉取 Amazon 结算数据
 
 ---
 
 ## 适合什么场景
 
-列出典型使用场景。请使用用户熟悉的业务语言，例如：
-
-- 每天需要重复处理同一类订单、单据、报表或客户资料
-- 需要从多个系统中查询信息并汇总结果
-- 需要按固定规则检查数据是否完整、是否异常
-- 需要把处理结果保存为文件、记录或任务报告
+- 月末或周度需要从 Amazon 导出结算报表做对账
+- 实训/教学中反复练习「登录 → 选日期 → 下载报表」流程
+- 希望 Agent 代为完成重复性的报表下载操作
 
 ---
 
 ## 使用前需要准备什么
 
-说明用户在使用前要准备的东西，例如：
+- 已在账号管理中添加 **Amazon 仿真卖家** 账号（平台标识 `amazon_sim`），且状态为可用
+- 账号已完成登录（或具备自动登录凭据）
+- 确认要下载的**起止日期**（例如 2025-12-01 至 2025-12-31）
+- 可选：指定店铺代码；不指定时使用页面默认第一个店铺
 
-- 相关账号已登录，且具备查询、导出或提交权限
-- 需要处理的文件、时间范围、订单号、客户名称、项目名称等信息
-- 如果涉及外部系统，请确认网络、账号、验证码或审批流程可正常使用
+### 添加 Amazon 仿真账号（若尚未配置）
+
+若 `amazon_sim` 平台尚未在 account-manager 中注册，需由运维先注册平台；然后执行：
+
+```text
+python D:\OpenClaw\client-commons\account-manager\scripts\main.py account add-web \
+  --platform amazon_sim \
+  --login-id <邮箱> \
+  --url https://sandbox.jc2009.com/industries/ecommerce/amazon/login \
+  --environment simulator \
+  --auth-strategy password_auto
+```
+
+建议 `extra_json`：`{"logged_in_url_pattern": "/seller"}`
+
+联调前须存在 **active** 账号且带 **profile_dir**（浏览器登录态目录）。
 
 ---
 
 ## 你可以这样告诉 Agent
 
-用自然语言示例展示用户可以怎么发起任务，例如：
+> 「帮我下载 2025 年 12 月的 Amazon 结算报表。」
 
-> “帮我查询今天的【业务对象】，整理成表格。”
->
-> “帮我核对这些【数据/单据】是否有异常，并告诉我问题在哪里。”
->
-> “帮我把【时间范围】内的【业务数据】导出并生成处理报告。”
->
-> “帮我根据这个文件里的内容，逐条完成【业务动作】。”
+> 「从 Amazon 卖家中心导出 12 月 1 日到 12 月 31 日的结算单。」
 
-> 注意：示例应是自然语言，不要写命令行命令。
+> 「用 AMA1OF6T 店铺下载上周的 settlement 报表。」
 
 ---
 
 ## 执行后你会得到什么
 
-说明用户会看到什么结果，例如：
-
-- 任务是否成功完成
-- 处理了多少条数据
-- 哪些内容成功、哪些失败
-- 失败原因和建议处理方式
-- 生成的文件、表格、报告或记录
+- 成功时：本地 xlsx 文件路径、任务编号、日期范围（JSON 摘要）
+- 失败时：错误说明；必要时可在数据目录查看失败截图
+- 任务日志中可查询历史下载记录
 
 ---
 
 ## 注意事项
 
-用用户能理解的方式说明边界和风险，例如：
-
-- 请确认输入范围准确，避免处理错数据
-- 涉及提交、付款、删除、审批等高风险动作时，技能应在执行前请求确认
-- 如果外部系统登录失效、权限不足或页面变化，任务可能需要用户介入
-- 不建议在未核对数据的情况下直接执行批量操作
-
----
-
-## 常见问题
-
-### 为什么任务没有查到数据？
-
-> 可能是时间范围、关键词、账号权限或系统筛选条件不正确。请先确认输入信息是否准确。
-
-### 为什么任务执行到一半需要我操作？
-
-> 可能遇到了登录、验证码、权限确认、二次审批或系统异常。请根据 Agent 的提示完成必要操作。
-
-### 结果文件在哪里查看？
-
-> 请根据 Agent 返回的结果说明查看生成文件、任务记录或处理报告。
+- 请确认日期范围正确，避免下载错期间的数据
+- 仿真环境与真实 Amazon 卖家中心界面类似，但数据为实训用途
+- 本技能仅下载报表文件，**不会**自动解析 Excel 内容或入账