@whyshu/argent-engine 0.0.0-stage → 0.6.0

package/engine/configs/account.json

@@ -0,0 +1,272 @@
+{
+  "_doc": "配置目录 · 账号域（引擎级）。声明格式与四道门禁见 docs/Argent-宿主适配契约.md §7；读取器 = core/lib/config-catalog.mjs（唯一）。本文件**只声明**：不写任何真实值、不写密钥样例（secret 项的 default 必须为空）。",
+  "domain": "account",
+  "order": 10,
+  "items": [
+    {
+      "key": "account.feishu.app_id",
+      "label": "飞书应用 App ID",
+      "category": "账号",
+      "type": "string",
+      "source": "json",
+      "secret": false,
+      "required": false,
+      "validation": {
+        "pattern": "^cli_[A-Za-z0-9]+$"
+      },
+      "capability": null,
+      "vertical": null,
+      "editable": true,
+      "help": "推送/对话用的自建应用；保存后宿主会切换身份。",
+      "binding": {
+        "kind": "json",
+        "file": "config.json",
+        "field": "feishuAppId"
+      },
+      "todayChain": [
+        "json"
+      ]
+    },
+    {
+      "key": "account.feishu.app_secret",
+      "label": "飞书应用 App Secret",
+      "category": "账号",
+      "type": "string",
+      "source": "json",
+      "secret": true,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": true,
+      "help": "自建应用密钥；只在本机保存，页面只显示「已配置/未配置」。",
+      "binding": {
+        "kind": "json",
+        "file": "config.json",
+        "field": "feishuAppSecret"
+      },
+      "todayChain": [
+        "json"
+      ]
+    },
+    {
+      "key": "account.feishu.user_id",
+      "label": "飞书操作者 ID（@ 用）",
+      "category": "账号",
+      "type": "string",
+      "source": "envfile",
+      "secret": false,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": false,
+      "help": "流程里 @ 人的 open_id；由装机脚本写入部署文件。",
+      "binding": {
+        "kind": "envfile",
+        "file": "fulfillment.env",
+        "env": "FEISHU_USER_ID",
+        "vertical": "mercadolibre"
+      }
+    },
+    {
+      "key": "account.ziniao.api_key",
+      "label": "店铺浏览器 API Key",
+      "category": "账号",
+      "type": "string",
+      "source": "json",
+      "secret": true,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": true,
+      "help": "写入客户端自身的配置（不入此项）；本项只反映「配没配」。",
+      "binding": {
+        "kind": "json",
+        "file": "config.json",
+        "field": "apiKey"
+      },
+      "todayChain": [
+        "json"
+      ]
+    },
+    {
+      "key": "account.whyshu.api_key",
+      "label": "问述账号令牌",
+      "category": "账号",
+      "type": "string",
+      "source": "envfile",
+      "secret": true,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": true,
+      "help": "账号令牌（一键登录写入此槽）；余额/积分与代理 provider 都读它。",
+      "binding": {
+        "kind": "envfile",
+        "file": "whyshu.env",
+        "env": "WHYSHU_API_KEY"
+      }
+    },
+    {
+      "key": "account.carrier.user",
+      "label": "货代门户账号",
+      "category": "账号",
+      "type": "string",
+      "source": "json",
+      "secret": false,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": true,
+      "help": "货代门户登录账号（对方生产系统账号，凭据不进仓库）。",
+      "binding": {
+        "kind": "json",
+        "file": "config.json",
+        "field": "xhInvoiceUser"
+      },
+      "todayChain": [
+        "json"
+      ]
+    },
+    {
+      "key": "account.carrier.password",
+      "label": "货代门户密码",
+      "category": "账号",
+      "type": "string",
+      "source": "json",
+      "secret": true,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": true,
+      "help": "货代门户登录密码；留空 = 保持原值。",
+      "binding": {
+        "kind": "json",
+        "file": "config.json",
+        "field": "xhInvoicePass"
+      },
+      "todayChain": [
+        "json"
+      ]
+    },
+    {
+      "key": "account.portal.phone",
+      "label": "门户登录手机号",
+      "category": "账号",
+      "type": "string",
+      "source": "envfile",
+      "secret": false,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": false,
+      "help": "发票门户登录手机号（部署文件维护）。",
+      "binding": {
+        "kind": "envfile",
+        "file": "wenyao.env",
+        "env": "WENYAO_PHONE",
+        "vertical": "mercadolibre"
+      }
+    },
+    {
+      "key": "account.portal.password",
+      "label": "门户登录密码",
+      "category": "账号",
+      "type": "string",
+      "source": "envfile",
+      "secret": true,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": false,
+      "help": "发票门户登录密码（部署文件维护，只显示已配置）。",
+      "binding": {
+        "kind": "envfile",
+        "file": "wenyao.env",
+        "env": "WENYAO_PASSWORD",
+        "vertical": "mercadolibre"
+      }
+    },
+    {
+      "key": "account.browser.company",
+      "label": "店铺浏览器企业标识",
+      "category": "账号",
+      "type": "string",
+      "source": "envfile",
+      "secret": false,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": false,
+      "help": "店铺浏览器 WebDriver 档位需要的企业标识。",
+      "binding": {
+        "kind": "envfile",
+        "file": "ziniao-webdriver.env",
+        "env": "ZINIAO_WD_COMPANY",
+        "vertical": "mercadolibre"
+      }
+    },
+    {
+      "key": "account.browser.username",
+      "label": "店铺浏览器账号",
+      "category": "账号",
+      "type": "string",
+      "source": "envfile",
+      "secret": false,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": false,
+      "help": "店铺浏览器 WebDriver 档位的登录账号。",
+      "binding": {
+        "kind": "envfile",
+        "file": "ziniao-webdriver.env",
+        "env": "ZINIAO_WD_USERNAME",
+        "vertical": "mercadolibre"
+      }
+    },
+    {
+      "key": "account.browser.password",
+      "label": "店铺浏览器密码",
+      "category": "账号",
+      "type": "string",
+      "source": "envfile",
+      "secret": true,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": false,
+      "help": "店铺浏览器 WebDriver 档位的登录密码。",
+      "binding": {
+        "kind": "envfile",
+        "file": "ziniao-webdriver.env",
+        "env": "ZINIAO_WD_PASSWORD",
+        "vertical": "mercadolibre"
+      }
+    },
+    {
+      "key": "account.plan",
+      "label": "账号档位 / 已购能力",
+      "category": "账号",
+      "type": "string",
+      "source": "server",
+      "secret": false,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": false,
+      "help": "服务端下发的账号档位与能力集。**来源 server 为预留**：本批不做配置上云/绑账号，读取器不读它，页面按「未接入」呈现。",
+      "binding": null
+    }
+  ],
+  "entries": [
+    {
+      "id": "account.bind",
+      "label": "绑定账号 / 配置上云",
+      "category": "账号",
+      "kind": "action",
+      "action": "account.bind",
+      "implemented": false,
+      "help": "把本机配置与账号绑定（服务端存储）。整体推迟到后续批次；目录已预留 source=server。"
+    }
+  ]
+}

package/engine/configs/advanced.json

@@ -0,0 +1,205 @@
+{
+  "_doc": "配置目录 · 高级与诊断域（引擎级）：遥测/更新通道/解释器与超时/暂停开关。多数是**逃生与诊断**面，默认值即安全态。声明格式与四道门禁见 docs/Argent-宿主适配契约.md §7。",
+  "domain": "advanced",
+  "order": 90,
+  "items": [
+    {
+      "key": "advanced.appointment.max_day",
+      "label": "预约顺延窗口（天）",
+      "category": "高级与诊断",
+      "type": "int",
+      "source": "env",
+      "secret": false,
+      "required": false,
+      "validation": {
+        "min": 1,
+        "max": 90
+      },
+      "capability": "full",
+      "vertical": "mercadolibre",
+      "editable": true,
+      "default": 5,
+      "help": "FULL 步骤4 预约时，从「平台今天+1」往后最多试到第几天。窗口越大越可能够到可约日期，代价是单票最长耗时线性增加（每天一次导航 + 最多 3 次提交）。**默认 5**（2026-10-10 由 3 提高，属**行为变更**：约 1/3 的 FULL 失败与「最近几天都被平台拒」相关，窗口=3 够不到可约日期）。⛔ 仓容满时**不会**靠加大窗口解决 —— 那是另一条链（仓容前置探测，见 docs/本机接班运行清单.md §8.72）。运维改回旧行为：设 `ARGENT_APPOINTMENT_MAX_DAY=3`。",
+      "binding": {
+        "kind": "env",
+        "env": "ARGENT_APPOINTMENT_MAX_DAY"
+      },
+      "todayChain": [
+        "env",
+        "default"
+      ],
+      "_chainNote": "生效链 = ① 进程 env `ARGENT_APPOINTMENT_MAX_DAY`（**优先**） ② 本声明的 `default`。**实现落点**：`scripts/flow_config.py#appointment_max_day()`（按 key 取这里的 default）→ `scripts/orchestrator.py#step4_appointment()`。Python 侧**不复制**上面的默认值：声明是这个数的唯一真源（`scripts/tests/capacity-defer-lift.test.py` 钉住「声明 default == 代码实际生效值」）。",
+      "_whyNotJson": "刻意**不**给 `config.json` 这一级：设置页写 json 需要 Python 侧再实现一条 json→生效 的路径（编排器不 import Node 读取器）⇒ 那才是真的第二条链。env + 声明 default 两级已满足本批需求（逃生阀 + 可声明默认值）。"
+    },
+    {
+      "key": "advanced.telemetry.opt_in",
+      "label": "诊断上报（可选）",
+      "category": "高级与诊断",
+      "type": "bool",
+      "source": "json",
+      "secret": false,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": true,
+      "default": false,
+      "help": "默认关；开启后按《数据上报说明》上报脱敏诊断。",
+      "binding": {
+        "kind": "json",
+        "file": "config.json",
+        "field": "telemetryOptIn"
+      },
+      "todayChain": [
+        "json"
+      ]
+    },
+    {
+      "key": "advanced.update.channel",
+      "label": "更新通道",
+      "category": "高级与诊断",
+      "type": "enum",
+      "source": "json",
+      "secret": false,
+      "required": false,
+      "validation": {
+        "enum": [
+          "stable",
+          "beta"
+        ]
+      },
+      "capability": null,
+      "vertical": null,
+      "editable": true,
+      "default": "stable",
+      "help": "更新通道（**保留项**）：当前**没有任何代码读取**它 ⇒ 在这里改了**不生效**，也不会影响「检查更新」看到什么。待补读者（如「检查更新」按通道取版）或明确退役。",
+      "binding": {
+        "kind": "json",
+        "file": "config.json",
+        "field": "updateChannel"
+      },
+      "_note": "批 3-1（2026-10-09）如实标注：全仓 **0 个读取点** —— `updateChannel` / `ADVANCED_UPDATE_CHANNEL` 唯一出现处是**写入**白名单 plugins/argent-core/src/index.js:81（CONFIG_KEYS），没有任何读取方（`--check-update` 与插件的 checkUpdate() 都不读通道）。⇒ 如实登记为「无人读」，并在 help/_note 写明：当前无读者、页面改了不生效，待补读者或如实标注为保留项（⛔ 不许让运营以为它在起作用）。同时**撤掉**原 todayChain:['json']：该提示的前提是「同名 env/env 文件有值时会压过 json」，而本项**根本没有读者**，前提不成立（且 editable:true 让它看着像能生效，更误导）。⛔ 这不是删提示 —— 是声明与代码事实（0 读取点）一致后才消失的。"
+    },
+    {
+      "key": "advanced.command.timeout_sec",
+      "label": "子命令超时（秒）",
+      "category": "高级与诊断",
+      "type": "int",
+      "source": "env",
+      "secret": false,
+      "required": false,
+      "validation": {
+        "min": 1,
+        "max": 86400
+      },
+      "capability": null,
+      "vertical": null,
+      "editable": false,
+      "help": "引擎调用外部命令的默认超时；排障时可临时放大。",
+      "binding": {
+        "kind": "env",
+        "env": "ARGENT_CMD_TIMEOUT"
+      }
+    },
+    {
+      "key": "advanced.registry.mode",
+      "label": "注册表读取模式",
+      "category": "高级与诊断",
+      "type": "enum",
+      "source": "env",
+      "secret": false,
+      "required": false,
+      "validation": {
+        "enum": [
+          "merged",
+          "base",
+          "projection"
+        ]
+      },
+      "capability": null,
+      "vertical": null,
+      "editable": false,
+      "help": "诊断用：注册表按合并结果读还是只读引擎级 base。",
+      "binding": {
+        "kind": "env",
+        "env": "ARGENT_REGISTRY_MODE"
+      }
+    },
+    {
+      "key": "advanced.pause.poll",
+      "label": "暂停轮询泵",
+      "category": "高级与诊断",
+      "type": "bool",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": false,
+      "default": false,
+      "help": "存在该标记文件 ⇒ 本机不再派发流程（逃生动作为落/删一个文件）。",
+      "binding": {
+        "kind": "machine",
+        "file": "PAUSE_POLL",
+        "presence": true
+      }
+    },
+    {
+      "key": "advanced.pause.invoice",
+      "label": "暂停发票流程",
+      "category": "高级与诊断",
+      "type": "bool",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": "invoice",
+      "vertical": null,
+      "editable": false,
+      "default": false,
+      "help": "存在该标记文件 ⇒ 发票流程停在自己的定时器里。",
+      "binding": {
+        "kind": "machine",
+        "file": "PAUSE_INVOICE",
+        "presence": true
+      }
+    },
+    {
+      "key": "advanced.pause.flow_watch",
+      "label": "暂停失败回路",
+      "category": "高级与诊断",
+      "type": "bool",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": false,
+      "default": false,
+      "help": "存在该标记文件 ⇒ 失败回路不自动跑（隔离态下默认暂停）。",
+      "binding": {
+        "kind": "machine",
+        "file": "PAUSE_FLOW_WATCH",
+        "presence": true
+      }
+    }
+  ],
+  "entries": [
+    {
+      "id": "capability.checkUpdate",
+      "label": "检查更新",
+      "category": "高级与诊断",
+      "kind": "action",
+      "action": "capability.checkUpdate",
+      "implemented": true,
+      "help": "逐个已装能力查是否有新版本（产品不做自动更新 ⇒ 由用户点）。**已实现**（2026-10-09）：复用 install-argent.mjs 的同一份比对（服务端清单 ∩ 本机 install.json），按能力过滤 + 短时缓存；有更新时可先看计划再一键更新，失败自动回滚。"
+    },
+    {
+      "id": "diagnostics.export",
+      "label": "导出诊断包",
+      "category": "高级与诊断",
+      "kind": "action",
+      "action": "diagnostics.export",
+      "implemented": false,
+      "help": "把版本/装配/最近失败导成一份脱敏包（密钥项按纪律不导出）。入口先声明，实现在后续批次。"
+    }
+  ]
+}

package/engine/configs/host.json

@@ -0,0 +1,149 @@
+{
+  "_doc": "配置目录 · 宿主机域（引擎级）。本域多数项是**机器事实**（source=machine / env）：只读、由安装器或体检生成，页面只呈现不编辑。声明格式与四道门禁见 docs/Argent-宿主适配契约.md §7。",
+  "domain": "host",
+  "order": 30,
+  "items": [
+    {
+      "key": "host.data_dir",
+      "label": "数据目录",
+      "category": "宿主与机器",
+      "type": "path",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": false,
+      "help": "所有本机配置/台账的落点；由内核唯一判据解析（三段链），页面只读。",
+      "binding": {
+        "kind": "machine",
+        "special": "dataDir"
+      }
+    },
+    {
+      "key": "host.dsh_home",
+      "label": "宿主 home",
+      "category": "宿主与机器",
+      "type": "path",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": false,
+      "help": "宿主数据目录的父目录；多实例隔离靠它。",
+      "binding": {
+        "kind": "machine",
+        "special": "dshHome"
+      }
+    },
+    {
+      "key": "host.python",
+      "label": "Python 解释器",
+      "category": "宿主与机器",
+      "type": "path",
+      "source": "env",
+      "secret": false,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": false,
+      "help": "引擎脚本使用的解释器（venv 优先）；不设则按 PATH 找。",
+      "binding": {
+        "kind": "env",
+        "env": "ARGENT_PY"
+      }
+    },
+    {
+      "key": "host.instance.id",
+      "label": "本机实例标识",
+      "category": "宿主与机器",
+      "type": "string",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": false,
+      "help": "安装期生成的实例标识（诊断上报与实例令牌按它绑定）。",
+      "binding": {
+        "kind": "machine",
+        "file": "instance.json",
+        "field": "installId"
+      }
+    },
+    {
+      "key": "host.instance.host_hash",
+      "label": "主机名哈希",
+      "category": "宿主与机器",
+      "type": "string",
+      "source": "machine",
+      "secret": false,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": false,
+      "help": "不可逆的主机标识（上报只带哈希，不带原始主机名）。",
+      "binding": {
+        "kind": "machine",
+        "file": "instance.json",
+        "field": "hostHash"
+      }
+    },
+    {
+      "key": "host.telemetry.instance_token",
+      "label": "实例令牌",
+      "category": "宿主与机器",
+      "type": "string",
+      "source": "machine",
+      "secret": true,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": false,
+      "help": "机器自带的上报凭证（随机器走）；只显示已配置/未配置。",
+      "binding": {
+        "kind": "machine",
+        "file": "instance-token.json",
+        "field": "token"
+      },
+      "todayChain": [
+        "machine",
+        "env"
+      ],
+      "_note": "批 3-1（2026-10-09）只修 binding：补 field='token'（与 scripts/telemetry.py:206-212 的实际读法一致 —— 该文件的**唯一鉴权键**就是 `token`，其余是便于人工核对的元数据，不参与鉴权）。修前缺 field ⇒ 规范读取器退化成「把整个 JSON 信封当标量」（core/lib/config-catalog.mjs：`let raw = b.field ? pickPath(doc, b.field) : doc`），实测报「期望标量，实际拿到 object（binding 的 field 写错了？）」⇒ 该项落到 missing，**机器明明有令牌（客户机 897 B）却显示「未配置」**。⛔ 本批**不动** todayChain（machine → env 的次序与逃生阀登记属批 3-5）。"
+    },
+    {
+      "key": "host.path.stores_json",
+      "label": "店铺清单文件",
+      "category": "宿主与机器",
+      "type": "path",
+      "source": "env",
+      "secret": false,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": false,
+      "help": "店铺映射缓存文件的位置（由体检/刷新店铺写入）。",
+      "binding": {
+        "kind": "env",
+        "env": "STORES_JSON"
+      }
+    },
+    {
+      "key": "host.account.binding",
+      "label": "机器与账号的绑定关系",
+      "category": "宿主与机器",
+      "type": "string",
+      "source": "server",
+      "secret": false,
+      "required": false,
+      "capability": null,
+      "vertical": null,
+      "editable": false,
+      "help": "服务端记录的「这台机器属于哪个账号」。**来源 server 为预留**：本批不做配置上云/绑账号，读取器不读它。",
+      "binding": null
+    }
+  ],
+  "entries": []
+}

package/engine/configs/hr.json

@@ -0,0 +1,27 @@
+{
+  "_doc": "配置目录 · 人事（HR）域（引擎级）。本批只把既有面板里那个只读字段（入口角色状态）纳入目录 —— 不新增任何 HR 配置面。声明格式与四道门禁见 docs/Argent-宿主适配契约.md §7。",
+  "domain": "hr",
+  "order": 40,
+  "items": [
+    {
+      "key": "hr.office.role",
+      "label": "HR 智能体入口状态",
+      "category": "人事(HR)",
+      "type": "string",
+      "source": "json",
+      "secret": false,
+      "required": false,
+      "capability": "hr",
+      "vertical": null,
+      "editable": false,
+      "help": "HR 办公的入口就是这个角色会话（角色 = DSH 预设：在 设置 →「Agent 预设」查看/切换）；安装 / 升级 HR 智能体在 设置 → Argent →「我的智能体」。本页只读，如实报告入口是否仍在册。",
+      "binding": {
+        "kind": "json",
+        "file": "roles.json",
+        "field": "presets.hr-office"
+      },
+      "_note": "批 3-1（2026-10-09）声明纠正（方案 B · 按实际读取顺序如实声明）：本项**只有 json 一级**，全仓不存在 HR_OFFICE_ROLE / hrOfficeRole 之类的 env 层 ⇒ 不登记 todayChain（原为 ['json']）。**7 个读取点全部只读 roles.json（唯一来源）**：plugins/argent-gateway/src/index.js:383 与 :395-399（用 roles.json#presets 覆盖源码常量，启动日志「roles.json 已应用 N 个角色映射」为证）、scripts/check-role-mapping.mjs:276 / :325 / :363、scripts/flow_preflight.py:293、scripts/customer-readiness.sh:61。⇒ 原 todayChain:['json'] 触发的「旧优先级」提示是**误报**：既然没有任何 env 级存在，就没有任何东西能压过 json，而该提示恰恰断言「env/env 文件有值时会压过它」；且本项 editable:false（页面本来就不可写）⇒ 撤掉该登记才是如实。⛔ 这不是删提示，是声明与代码事实一致后才消失的。附：hr-office 已于 2026-10-04 退役（gateway.json 无该行、presets/argent-hr-office 是墓碑），条目保留供老会话/诊断解析到 preset。｜**W7.7（2026-10-14，尾巴收口）**：label 由「HR 角色入口状态」改为「HR 智能体入口状态」、help 与 `scripts/flow-requirements.json#capabilities.hr.pack.settingsPanel` 的 `hint` 去掉指向**已删页签**的措辞 —— W7.6（1cf558b）已删除「Argent 角色」页签（角色 = DSH preset，归官方「设置 → Agent 预设」区）⇒ 两处死指针改指新落点：会话身份 ⇒ 官方「Agent 预设」区；安装 / 升级 ⇒ 设置 → Argent →「我的智能体」。⛔ **只改文案**：`key` / `binding` / `editable` / 取值链与 `source` 一个字节未变。"
+    }
+  ],
+  "entries": []
+}