uniner-cli 1.0.17 → 1.0.19

package/lib/SKILL.md.template

@@ -1,6 +1,6 @@
 ---
 name: uniner-cli
-description: RPA 自动化 CLI 工具，提供浏览器自动化、Excel 操作、OCR 识别、桌面/SAP 自动化、加密/HTTP/邮件等通用工具能力。Use when user mentions RPA、自动化、抓取网页、抓数据、填表、读 Excel、写 Excel、识别验证码、OCR、SAP、桌面操作、uniner-cli、爬虫、表单自动化.
+description: RPA 自动化 CLI 工具，提供浏览器自动化、Excel 操作、OCR 识别、魔像云流程开发与发布（流程发布/上传流程/魔微子）、加密/HTTP/邮件等通用工具能力。Use when user mentions RPA、自动化、抓取网页、抓数据、填表、读 Excel、写 Excel、识别验证码、OCR、流程发布、上传流程、业务流程、魔像云、魔微子、uniner-cli、爬虫、表单自动化.
 ---
 
 # uniner-cli Skill
@@ -15,7 +15,8 @@ description: RPA 自动化 CLI 工具，提供浏览器自动化、Excel 操作
 如果这次任务**满足任一条件**：
 
 - 调用了 ≥ 3 个 uniner-cli 命令
-- 涉及 web / desktop / OCR 任何一个模块
+- 涉及 web / OCR 任何一个模块（desktop 暂不开放，不在其列）
+- 涉及魔像云流程开发（init/validate/publish 多步链路，沉淀后可 0 token 重放）
 - 用户提到过"以后还会跑" / "每天都要" / "做成自动化"
 - 任务里踩过坑（XPath 不稳、参数名错、Vue 组件、超时调整等）
 
@@ -45,7 +46,7 @@ description: RPA 自动化 CLI 工具，提供浏览器自动化、Excel 操作
 - ✅ `uniner-cli` 命令已加入 PATH（安装时自动配置，新终端立即生效）
 - ✅ 环境变量 `UNINER_CLI_HOME = {{INSTALL_PATH}}`
 - ✅ Web 模块自动通过 CDP 连接本机 Chrome / Edge —— **不要手动启动 Chrome**
-- ⚠️ desktop 模块仅 Windows，依赖外部 Agent 服务（魔奈 RPA 编辑器自带）
+- ⚠️ desktop 模块**暂不开放**（测试覆盖少）；桌面/SAP 场景告知用户后改用 web 或 tool system execute
 
 ## 命令结构（一级 + 二级）
 
@@ -84,13 +85,29 @@ tool               通用工具
 ├── email          send / receive / list
 └── http           get / post / put / delete
 
-desktop            桌面自动化 [仅 Windows]
-├── window         find / activate / close / info / list
-├── element        find / click / get-text / set-value
-├── keyboard       type / press / hotkey
-├── mouse          click / move / scroll / drag
-├── image          find / click / wait
-└── sap            login / transaction / field / table
+desktop            桌面自动化 [暂不开放] —— 测试覆盖少，当前版本未开放。
+                   AI 检测到任务需要桌面/SAP 操作时：停下告知用户"desktop 模块
+                   暂不开放"，改用 web（浏览器场景）或 tool system execute
+                   （执行外部程序），不要尝试调用 desktop 命令。
+
+cloud              魔像云操作（编辑器账号登录态；见"魔像云流程"章节）
+├── login          登录（多组织时交互列出、**必须用户本人输入序号选定**）
+├── logout         登出
+├── status         查看登录状态（含当前组织）
+└── flow           流程管理
+    ├── init       生成流程脚手架（无参 = 当前目录五件套；init <name> 建子目录）
+    ├── validate   基础检查流程目录（发布前自动执行，不通过即阻断）
+    ├── test       本地真跑流程（不强制，建议发布前手动跑）
+    ├── list-local 列本地流程、发布状态与绑定组织
+    ├── list       列云端流程（标注来源 CLI / 编辑器）
+    ├── publish    发布流程目录（自动 validate + 版本号用户确认 + 外发确认）
+    ├── download   下载云端流程回流当前目录（覆盖前确认，默认 N）
+    └── pack       打包当前目录流程为 .7z（无参数，输出上级目录）
+
+config             配置管理
+├── set            设置配置项（仅 editor.path：魔微子安装目录）
+├── list           查看当前配置
+└── clear          清除配置
 ```
 
 ## 全局选项（写在子命令前）
@@ -140,7 +157,9 @@ uniner-cli [全局选项] <模块> <子命令> <命令> [命令选项]
 | HTTP GET | `tool http get --url <URL>` |
 | 发送邮件 | `tool email send --to <addr> --subject <S> --body <B>` |
 | 结束进程 | `tool system kill-app --name chrome.exe` |
-| SAP 登录 | `desktop sap login --user <U> --password <P>` |
+| SAP / 桌面操作 | **不可用**：desktop 暂不开放，停下告知用户并改用 web / tool system execute | "登录 SAP 系统" |
+| 流程发布 / 上传流程 | **先 Read** [{{INSTALL_PATH}}/skills/cloud-flow-publish.md]({{INSTALL_PATH}}/skills/cloud-flow-publish.md)，再走 `cloud login → cloud flow init → validate → publish` | "把这个流程发到魔像云" |
+| 下载云端流程 | `cloud flow download [流程名]`（覆盖前确认默认 N；AI 不得代答） | "把云端流程拉下来改" |
 
 ## 命令选择优先级
 
@@ -154,7 +173,7 @@ uniner-cli [全局选项] <模块> <子命令> <命令> [命令选项]
 1. **Chrome CDP 自动管理** — 别手动 kill Chrome；客户机必须装 Chrome 或 Edge
 2. **session 持久化** — `$TEMP/.uniner-cli/sessions.json`（Windows: `%TEMP%\.uniner-cli\sessions.json`）；CLI 退出后用 `web browser reconnect` 恢复
 3. **Vue/Element UI 组件** — 日期选择器、级联下拉等，用 `execute-js` 直接操作组件模型，不要硬 input
-4. **desktop 返回 -999** = Agent 服务未启动；此时改用 `web action execute-js` 或 `tool system execute`
+4. **desktop 暂不开放** — 测试覆盖少，当前版本未开放；任何 desktop 子命令都提示暂不开放，改用 `web action execute-js` 或 `tool system execute`
 5. **Linux 平台** — Playwright 默认 HTTPS-only，访问 HTTP 站点需改 wrapper 加 `--disable-features=HttpsOnlyMode`，或用 Firefox `--browser-type 1`
 6. **Windows GBK 编码** — CLI 内部已强制 UTF-8 输出；调用方读 stdout 也要 UTF-8
 
@@ -162,7 +181,7 @@ uniner-cli [全局选项] <模块> <子命令> <命令> [命令选项]
 
 | 主题 | 路径 |
 |---|---|
-| **魔像云流程开发与发布工作流**（init/validate/test/publish） | [{{INSTALL_PATH}}/skills/cloud-flow-publish.md]({{INSTALL_PATH}}/skills/cloud-flow-publish.md) |
+| **魔像云流程开发与发布工作流**（login→init→validate→publish，含版本号确认） | [{{INSTALL_PATH}}/skills/cloud-flow-publish.md]({{INSTALL_PATH}}/skills/cloud-flow-publish.md) |
 | 命令树全集 + 三级参数 | [{{INSTALL_PATH}}/skills/cli/SKILL.md]({{INSTALL_PATH}}/skills/cli/SKILL.md) |
 | 完整命令结构（120+ 命令） | [{{INSTALL_PATH}}/skills/cli/command-tree.md]({{INSTALL_PATH}}/skills/cli/command-tree.md) |
 | execute-js 使用指南 | [{{INSTALL_PATH}}/skills/cli/execute-js-guide.md]({{INSTALL_PATH}}/skills/cli/execute-js-guide.md) |
@@ -179,7 +198,9 @@ uniner-cli [全局选项] <模块> <子命令> <命令> [命令选项]
 
 用户提到【流程发布】【上传流程】【业务流程】【魔像云】【魔微子】等关键词时，
 **先 Read** [{{INSTALL_PATH}}/skills/cloud-flow-publish.md]({{INSTALL_PATH}}/skills/cloud-flow-publish.md)
-再操作——流程生产走 CLI 命令链（init → validate → test → publish），有独立的环境前提与 AI 行为红线。
+再操作——流程生产走 CLI 命令链（login 选组织 → init → validate → （建议手动
+test）→ publish，publish 时提示云端最新版本号、版本号由用户确认），有独立的
+环境前提与 AI 行为红线。
 
 ## 典型完整流程（参考）
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "uniner-cli",
-    "version": "1.0.17",
+    "version": "1.0.19",
     "description": "uniner-cli — RPA automation CLI: browser automation (Playwright/CDP), Excel, OCR, desktop/SAP, crypto/HTTP/email tools. Auto-installs a Claude Code skill on install.",
     "keywords": [
         "rpa",