@qing3a/flow-rpa-app 0.5.8 → 0.5.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qing3a/flow-rpa-app",
-  "version": "0.5.8",
+  "version": "0.5.9",
   "engines": { "node": ">=20" },
   "type": "module",
   "description": "flow-rpa 应用壳（原 app crate）：MCP server + CLI",
@@ -26,7 +26,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@qing3a/flow-rpa-engine": "^0.5.8",
+    "@qing3a/flow-rpa-engine": "^0.5.9",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "zod": "^4.4.3"
   }
@@ -34,3 +34,5 @@
 
 
 
+
+

package/skill/flow-rpa-engine.md

@@ -1,7 +1,7 @@
 <!-- 由 docs/SKILL-ENGINE.md 构建生成（M11c D-K1），勿手改；改 docs 真源后重跑 pnpm build -->
 # 引擎级 skill：flow-rpa 本地 RPA 引擎（契约版）
 
-> 状态：**定稿**（2026-08-29 按 0.5.8 实现校对：14 工具签名核对（T015 resume_run 新增）、暂停-恢复语义、薪资加密标注（T017 P1-1）、标题过滤 matchText（T017 P1-2）、节流参数同步、D3 角色说明）
+> 状态：**定稿**（2026-08-29 按 0.5.9 实现校对：14 工具签名核对（T015 resume_run 新增）、暂停-恢复语义、薪资加密标注（T017 P1-1）、标题过滤 matchText（T017 P1-2）、平台配置引导（T019 P2-3）、节流参数同步、D3 角色说明）
 > 用途：挂载在 npm 包内作为「引擎级 skill」的唯一真源（ARCHITECTURE #10），安装时同步/链接到 Agent 平台的 skills 目录。
 > 分工：本 skill 只讲「怎么调引擎」；业务编排（何时调、调哪个流程）在业务级 skill（外部/平台分发）。
 
@@ -59,6 +59,16 @@
 - **正常初始态**：未跑流程前 `browser.connected=false`、`flows=[]`（或仅流程包内的）均为正常——
   浏览器懒加载（首次 run_flow 才弹出），流程需先从 md-forge 获取（`pkg_update`）或放入 flows/
 
+### 0.6 配置平台（md-forge：观察上报 + 流程/建议同步；T019 P2-3）
+
+- **目的**：配置 `platform-url + platform-token` 后，引擎自动注册：run 结束自动上传观察包、`pkg_update` 拉取流程包、L2 建议同步回平台。未配置 = 本地模式正常使用（观察只落盘本地，`get_status` 的 `platform.configured=false`）。
+- **配置方式（二选一，一次配置永久生效——自动持久化到 `data/platform.json`）**：
+  - **启动参数**：`flow-app --http ... --platform-url <url> --platform-token <token>`（token 已由平台方发放）
+  - **环境变量**：`FLOW_PLATFORM_URL=<url>` `FLOW_PLATFORM_TOKEN=<token>`（服务启动时读取）
+- **验证配置生效**：`flow-app doctor` 显示「✅ 平台已配置」；或 `get_status` 返回 `platform.configured=true`（url 含地址，**不含 token**）。
+- **配置后**：`pkg_update` 拉取平台流程包到 `flows/`（或本地 `flows/` 优先，pkg_update 只覆盖平台发布的版本）；已配置后 run 结束自动上传观察包（`sync_pending_uploads` 可重试断网遗留）。
+- ⚠️ 若 doctor 显示「⚠️ 平台未配置」而你已经拿到 token——说明 token 未传进引擎（启动命令缺 `--platform-url/--platform-token` 或环境变量未设），按上面方式补配后重启服务。
+
 ---
 
 ## 一、这是什么
@@ -148,7 +158,9 @@ Agent 按自己被赋予的角色调用，超出裁剪集的工具会报「工
 - extract 步骤：`field`（字段标签）、`count`（命中数）、`saved`（是否落盘本地明细）
 - `selectorHit`：实际生效的选择器（页面改版排查用）
 - paused 记录额外字段：`pausedAt`（暂停时刻）、`pauseReason`（login/env_check/paused）、`resumeStepIndex`（resume 起点）
-- **薪资加密（T017 P1-1）**：BOSS 薪资为字体加密字符（PUA 私用区 `\uE000-\uF8FF`，如 `\uE02E\uE02F-\uE02E\uF9K` 渲染为 "13-16K"）——提取内容**保留原始加密字符**（不再删除），步骤记录 `salaryEncrypted: true` 标注「薪资加密」；**不要当作乱码/提取失败**，解码字体映射不在引擎红线内（独立决策项）
+- **薪资加密（T017 P1-1 + T018 决策 c）**：BOSS 薪资为字体加密字符（PUA 私用区 `\uE000-\uF8FF`，如 `\uE02E\uE02F-\uE02E\uF9K` 渲染为 "13-16K"）——提取内容**保留原始加密字符**（不再删除），步骤记录 `salaryEncrypted: true` 标注「薪资加密」；**不要当作乱码/提取失败**。
+  - **消费口径（owner 拍板策略 c，2026-08-29）**：引擎**不解码** PUA 字体（解码映射在防封红线内不做）；需要真实薪资时，**在引擎浏览器中实时读取**——用引擎浏览器当前页面的薪资元素查看真实数值，或引导用户人工查看登录态下的薪资显示（get_run 之外，引擎不提供解码）。
+  - **报告口径**：报告/表格中薪资统一标注「薪资加密 · 登录后可见」，**不填数值**（不做解码、不填乱码猜测值）。
 - **标题过滤（T017 P1-2）**：click 步骤可用 `matchText: "{keyword}"`（region 寻址时跳过标题不含关键词的卡片——BOSS 搜索混入推荐位场景）；表达式引擎内部为 `region:<标签> >> [match:<文本>] >> <n>`，index 作用于过滤后集合，凑够 limit 或列表耗尽自然终止
 
 **失败处理**

package/starter/liepin_search_resumes/behavior.rules.json

@@ -0,0 +1,18 @@
+{
+  "regionRules": [
+    {
+      "id": "resume_list_area",
+      "label": "候选列表区",
+      "match": {
+        "ancestorClass": "resume-list"
+      }
+    },
+    {
+      "id": "resume_detail_area",
+      "label": "简历详情区",
+      "match": {
+        "textContains": "工作经历"
+      }
+    }
+  ]
+}

package/starter/liepin_search_resumes/flow.json

@@ -0,0 +1,74 @@
+{
+  "id": "liepin_search_resumes",
+  "name": "猎聘搜索候选人（HR 端）",
+  "platform": "liepin",
+  "version": 1,
+  "trigger": { "mode": "manual" },
+  "inputs": [
+    { "name": "keyword", "required": true, "description": "搜索关键词（职位名，如 产品经理）" },
+    { "name": "city", "required": false, "description": "城市名（如 珠海；缺省不带 → 平台默认城市）" },
+    { "name": "limit", "required": false, "description": "提取数量上限，缺省 10" }
+  ],
+  "envCheck": {
+    "verifyUrls": [
+      "safe.liepin.com/page/liepin/captchaPage_PC"
+    ],
+    "dialogs": []
+  },
+  "steps": [
+    {
+      "id": "nav_home",
+      "type": "navigate",
+      "params": { "url": "https://h.liepin.com/resume/search" },
+      "verify": { "waitSelector": ".auto-input-wrap-v3, .search-btn, input[placeholder*=\"职位\" i]", "timeoutMs": 180000 }
+    },
+    {
+      "id": "input_keyword",
+      "type": "input",
+      "params": { "selector": ".auto-input-wrap-v3 input, input[placeholder*=\"职位\" i], input.input", "value": "{keyword}" },
+      "verify": { "textContains": "{keyword}" }
+    },
+    {
+      "id": "click_search",
+      "type": "click",
+      "params": { "selector": ".search-btn" },
+      "verify": { "waitSelector": ".detail-resume-card-wrap, [class*=\"resume-card\" i], .resume-list-container", "timeoutMs": 30000 }
+    },
+    {
+      "id": "loop_candidates",
+      "type": "loop",
+      "params": {
+        "steps": [
+          {
+            "id": "extract_list",
+            "type": "extract",
+            "params": { "selector": ".detail-resume-card-wrap, [class*=\"resume-card\" i]", "field": "candidateList" },
+            "verify": { "waitSelector": ".detail-resume-card-wrap, [class*=\"resume-card\" i]", "timeoutMs": 30000 }
+          },
+          {
+            "id": "click_candidate",
+            "type": "click",
+            "params": { "region": "候选列表区", "index": "{i}", "matchText": "{keyword}" },
+            "verify": { "waitSelector": "[class*=\"resume-detail\" i], [class*=\"resume-content\" i], .resume-detail-wrap", "textContains": "工作经历", "timeoutMs": 15000 }
+          },
+          {
+            "id": "extract_resume",
+            "type": "extract",
+            "params": { "selector": "[class*=\"resume-detail\" i], [class*=\"resume-content\" i], .resume-detail-wrap", "field": "resumeDetail", "save": true },
+            "verify": { "textContains": "工作经历", "timeoutMs": 15000 }
+          },
+          {
+            "id": "wait_breathe",
+            "type": "wait",
+            "params": { "ms": 3000 }
+          }
+        ]
+      }
+    },
+    {
+      "id": "finalize",
+      "type": "finalize",
+      "params": { "closeTab": true }
+    }
+  ]
+}