@whyshu/argent-engine 0.7.7 → 0.8.0-rc.2

package/engine/scripts/lib/argent_datadir.py

@@ -65,6 +65,8 @@ ENV_DATA_DIR = "ARGENT_DATA_DIR"
 ENV_DSH_HOME = "DSH_HOME"
 #: 隔离目录下**显式**放开失败回路的开关（必须精确等于 `1`）。
 ENV_ALLOW_ISOLATED_PUMP = "ARGENT_ALLOW_ISOLATED_PUMP"
+#: 部署方声明的本机规范数据目录（生产客户机用）。
+ENV_CANONICAL_DATA_DIR = "ARGENT_CANONICAL_DATA_DIR"
 
 #: **老机器**的数据目录（`~/.dsh/argent`）：存在即沿用 —— 这一级同时是"客户机现状"。
 DATA_DIR_SEGMENTS = (".dsh", "argent")
@@ -148,6 +150,9 @@ def default_data_dir(env=None, home=None) -> str:
     与 JS 内核 `core/lib/argent-datadir.mjs#defaultDataDir` **同批、同夹具**对拍
     （`scripts/tests/argent-datadir-parity.test.mjs`）；优先级链**不变**。
     """
+    canonical = _get(_env(env), ENV_CANONICAL_DATA_DIR)
+    if canonical:
+        return _p.abspath(canonical)                                       # 部署方显式规范目录
     if legacy_data_dir_exists(env, home):
         return legacy_data_dir(env, home)                                  # ① 存在即沿用（老机器）
     return _join(home or os_home(_env(env)), *NO_HOST_DATA_DIR_SEGMENTS)   # ② 新装（无宿主）⇒ ~/.argent

package/engine/scripts/ml_hub_status.py

@@ -88,7 +88,7 @@ units 页上都会出现 ⇒ 单凭它会把正常票判成尺寸阻塞。空间
 本样本**不依赖它**（仅凭 hub 即可判 `true`）。
 
 ⚠️ `operationally_complete=True` ⇒ 货件**被视为已完成**（无论表里写什么），但
-**⛔ 绝不是让引擎去改写 `FULL状态`** —— 改写权在运营/用户；引擎只写「识别为运营手动完成（依据 hub-v2 实测）」的备注。
+**⛔ 绝不是让引擎去改写 `FULL状态`** —— 改写权在运营/用户；引擎只写「识别为已完成（依据 hub-v2 实测；来源未声明）」的备注。
 
 ## 容错（平台改版是常态）
 
@@ -1305,14 +1305,14 @@ def summary_zh(state: dict) -> str:
 def completion_verdict(state: dict) -> dict:
     """完成度裁定（**确定性规则**，供收口/前置校验/失败现场三处共用）。
 
-    `operationally_complete=True` ⇒ 「识别为运营手动完成（依据 hub-v2 实测）」。
+    `operationally_complete=True` ⇒ 「识别为已完成（依据 hub-v2 实测；来源未声明）」。
     ⛔ 本函数**不改任何数据**：它只给结论，写表与否由调用方按各自白名单决定。
     """
     ok = bool(state.get("operationally_complete"))
     return {
         "operationally_complete": ok,
         "identified_as": "manual-completion-by-hub" if ok else "",
-        "note_zh": ("识别为运营手动完成（依据 hub-v2 实测）：" + summary_zh(state)) if ok else "",
+        "note_zh": ("识别为已完成（依据 hub-v2 实测；来源未声明）：" + summary_zh(state)) if ok else "",
         "reason": state.get("complete_reason") or "",
         "items": item_lines(state),
         "shipment_id": state.get("shipment_id") or "",

package/engine/scripts/orchestrator.py

@@ -2320,6 +2320,11 @@ BOX_LABEL_DL_ROUNDS = int(os.environ.get("BOX_LABEL_DL_ROUNDS", "") or 3)
 # 现在：等待按"业务信号"轮询 + 分层预算，超时才落终态；预算可调（客户机也能按现场调）。
 NAV_TIMEOUT_SEC = float(os.environ.get("NAV_TIMEOUT_SEC", "") or 90)        # page.goto 单次
 URL_TRANSITION_SEC = float(os.environ.get("URL_TRANSITION_SEC", "") or 120)  # 等跳转（如 hub-v2）
+# 2026-10-24：平台把 hub 落地页从 `/hub-v2` 改为 `/hub`；历史判据只认 `hub-v2`
+# ⇒ 写操作明明生效也判失败（FULL 步骤4/5 假失败、误取消预约）。统一用正则接受两种形态。
+HUB_URL_RE = re.compile(r"/inbounds/\d+/hub(?:-v2)?(?:[/?#]|$)")
+def is_hub_url(url: str) -> bool:
+    return bool(HUB_URL_RE.search(str(url or "")))
 SLOW_GRACE_SEC = float(os.environ.get("SLOW_GRACE_SEC", "") or 60)           # 慢渲染宽限（再等一轮）
 # 错误弹窗（Algo salió mal）自愈的**退避**（2026-09-23）：
 # 旧行为：失败→重载→固定等 8s→再来一次，两次不成即判失败 ⇒ 平台慢时等于"连打同一页面"
@@ -7455,7 +7460,7 @@ class Orchestrator:
         """**唯一入口**：把 `FULL状态` 置为「已完成」。
 
         2026-10-16：原先只有 `_finalize_ticket_complete`（引擎自己跑完）能置位；现在
-        「运营手动完成（hub-v2 实测）」也要置位（用户口径「都要」）⇒ 抽出本入口，两条路径
+        「已完成（hub-v2 实测；来源未声明）」也要置位（用户口径「都要」）⇒ 抽出本入口，两条路径
         **都走这里**，保持"表状态只有一个写点"的不变量（回归见 ticket-completion-criteria /
         step-progress-realtime 的 AST 断言）。
         """
@@ -7881,7 +7886,7 @@ class Orchestrator:
                 "shipment_id": "", "url_inbound": "", "probe_ok": False}
 
     # 需求 1a：hub 判定的**运营手动完成**在表里固定用这句话（运维与角色都按它对齐口径）
-    HUB_MANUAL_NOTE = "识别为运营手动完成（依据 hub-v2 实测）"
+    HUB_MANUAL_NOTE = "识别为已完成（依据 hub-v2 实测；来源未声明）"
 
     def _hub_manual_complete(self, verdict: dict[str, Any], *, status: str = "") -> dict[str, Any]:
         """hub-v2 判定「预约已取消 ∧ 产品标签已下载 ∧ 箱唛已下载」⇒ **认定为已完成**。
@@ -7890,7 +7895,7 @@ class Orchestrator:
         三个派生结论**都必须是 `True`**（`None` 一律不算）；只要有一个判不了 ⇒ 不是完成。
 
         ## 写什么 / ⛔ 不写什么（用户口径）
-        - **写**：`FULL备注` ← 「识别为运营手动完成（依据 hub-v2 实测）：<逐项>」（同源同文，
+        - **写**：`FULL备注` ← 「识别为已完成（依据 hub-v2 实测；来源未声明）：<逐项>」（同源同文，
           与 `--mode hub-status` 打印、与 `failures.jsonl#hub_status` 完全一致）；
           `当前步骤` ← **「全部完成」**（2026-10-16 用户口径：表口径与"引擎自己跑完"一致）；`就绪=false`（消费掉拾取位）。
           **`FULL状态` ← 已完成**（2026-10-16 用户口径「都要」：认定即置位，否则票一直挂在"失败"里，
@@ -9299,7 +9304,7 @@ class Orchestrator:
         while time.time() < deadline:
             rounds += 1
             try:
-                if "hub-v2" in (self.browser.page.url or ""):
+                if is_hub_url(self.browser.page.url or ""):
                     break
             except Exception:
                 pass
@@ -10094,7 +10099,7 @@ class Orchestrator:
         for _ in range(38):  # 0.4s × 38 ≈ 15s
             try:
                 url = self.browser.page.url or ""
-                if "hub-v2" in url:
+                if is_hub_url(url):
                     submit_ok = True
                     break
                 hint = await self.browser.page.evaluate(
@@ -10754,7 +10759,7 @@ class Orchestrator:
                     self._log("  ✅ 已确认重新贴标弹窗")
                     return True
                 # 无弹窗时快速返回：正常提交路径已跳转 hub-v2 → 零额外延迟
-                if "hub-v2" in (self.browser.page.url or ""):
+                if is_hub_url(self.browser.page.url or ""):
                     return False
             except Exception:
                 return False
@@ -10877,12 +10882,24 @@ class Orchestrator:
                             recovery_attempted=["checkbox_mouseevent"])
         await self.browser.click_with_fallback(5, "confirm_btn", "Confirmar")
         await asyncio.sleep(3)
-        # 提交后应跳转 hub-v2；未跳转说明包装确认未提交
+        # 提交后应跳转 hub（平台 2026-10 已把 /hub-v2 改为 /hub）；URL 判据只作快速路径。
+        # 失败前必须用只读 hub 探针核验「包装确认」是否真的完成，平台慢渲染不得再判假失败。
         try:
-            await self.browser.page.wait_for_url("**/hub-v2**", timeout=15000)
+            await self.browser.page.wait_for_url(
+                re.compile(r".*/inbounds/\d+/hub(?:-v2)?(?:[?#].*)?$"),
+                timeout=int(URL_TRANSITION_SEC * 1000),
+            )
         except Exception:
-            raise StepError(5, "business", "包装确认后未跳转 hub-v2，确认可能未提交",
-                            recovery_attempted=["check_procedures_state"])
+            hub = await self._hub_truth(navigate=False, step=5)
+            items = (hub or {}).get("items") or []
+            packaging_done = any(
+                str((it or {}).get("key") or "") == "packaging" and (it or {}).get("done") is True
+                for it in items
+            )
+            if not packaging_done:
+                raise StepError(5, "business", "包装确认后未到 hub / 未确认包装完成",
+                                recovery_attempted=["check_procedures_state", "hub_probe"])
+            self._log("  ✅ 包装确认已由 hub 只读探针核验为完成（URL 判据未命中，按 effective 继续）")
         self._mark_done(5)
         if self.state.record_id:
             self.feishu.send_message(f"✅ 步骤5完成: 包装确认 - {self.state.sku}")
@@ -11837,7 +11854,7 @@ class Orchestrator:
                     self._log("  ✅ 取消生效（appointmentCancellationSuccess 成功标志）")
                     return True
                 # b. hub-v2 跳转（取消成功后的正常去向）
-                if "/hub-v2" in url:
+                if is_hub_url(url):
                     self._log("  ✅ 取消生效（hub-v2 跳转）")
                     return True
                 # c. 按钮消失 且 无错误弹窗（排除侧栏）
@@ -12689,18 +12706,13 @@ class Orchestrator:
                             f"失败：{exc.message}"
                             f"（{_capacity_defer_tag}·预检恢复即**当日**重试，最多 "
                             f"{_capacity_max_lift} 次）")
-                # 🧹 预约已成功提交（步骤4完成）→ 失败分支自动取消预约，防超时罚款。
-                # 放在 auto_retry 网络重置返回之前：即使走自动重置分支先 return，
-                # 取消也已完成（防重置后预约残留到预约时间被罚）。
-                # dry_run 跳过；步骤4本身失败（completed_steps 不含4）说明预约未成功
-                # 提交、无残留，不触发。
+                # ⛔ 2026-10-24 用户口径：失败分支**不再自动取消预约**。
+                # 假失败（如 /hub-v2 → /hub 改版）下自动取消会毁掉本来成功的预约；
+                # 预约是稀缺资源，必须先由评估/人工确认「确实需要取消」再走步骤8。
+                # dry_run 同样不取消。
                 cancel_note = ""
                 if not dry_run and 4 in self.state.completed_steps:
-                    self._log("  🧹 预约已成功，失败分支自动取消预约…")
-                    if await self._safe_cancel_appointment():
-                        cancel_note = "\n✅ 预约已自动取消，无超时罚款风险"
-                    else:
-                        cancel_note = "\n⚠️ 预约取消失败！请立即人工取消预约，避免超时罚款"
+                    self._log("  ⏸ 失败分支不自动取消预约：先核实 hub/门户真实状态；确认需要取消时再走步骤8")
                 if self.state.record_id:
                     if auto_retry is None and auto_reset_fail is None:
                         # 人工类 / 未触发自动恢复：客户群失败卡片（红底 ❌），失败降级文字
@@ -13801,7 +13813,7 @@ def build_parser() -> argparse.ArgumentParser:
                    "三态；⛔ 不点按钮、不写表、不改 defer 状态；需 --store-name）")
     p.add_argument("--hub-write-note", action="store_true",
                    help="hub-status 模式：当 hub 判定为「运营手动完成」时，**只**写 FULL备注/当前步骤"
-                        "（识别为运营手动完成（依据 hub-v2 实测））；⛔ 仍不改写 FULL状态")
+                        "（识别为已完成（依据 hub-v2 实测；来源未声明））；⛔ 仍不改写 FULL状态")
     p.add_argument("--no-heal", action="store_true",
                    help="cdp-preflight 模式：只检查不自愈（不重连/不重开店铺窗口，纯只读）")
     p.add_argument("--step", type=int, choices=list(range(1, 9)),