@whyshu/argent-engine 0.0.0-stage → 0.6.0

package/engine/agents/catalog.json

@@ -0,0 +1,454 @@
+{
+  "_doc": "智能体目录（货架声明）—— Argent 是智能体平台：用户从**智能体库**里选一个智能体安装，**只装这个智能体相关的东西，其余不装**。",
+  "_layer": "L0 业务资产（与 verticals/ presets/ skills/ 同级）：本文件只做**目录层声明**（agent → capability + flows 子集 + 角色 + 插件/技能/集成/凭据槽），⛔ 不含任何判据逻辑、⛔ 不引宿主、⛔ 不含密钥值。装什么/怎么装的实现分别在 scripts/argent-agents.mjs（解析）与 install-argent.mjs（落盘）。",
+  "_why": "用户口径（2026-10-10）：① HR = **一个**智能体；② 美客多拆成 **4 个**智能体（FULL 发货 / 上海文鳐发票 / 鑫中航发票 / 日报）+ 可选组合 ml-suite；③ **能力包不拆**（`invoice` 仍是一个能力包，含文鳐+鑫中航两条 flow）——智能体只是目录层的**投影**，不是新的打包单位。",
+  "_invariants": [
+    "① `capability` 与 `capabilities` **二选一**（exactly one）——单能力用前者、组合用后者，二者都给或都不给判红。",
+    "② `flows` 必须是**已声明能力名下的规范 id 子集**（合取），能力有流程而 flows 为空 ⇒ 红（那等于装了不跑）。",
+    "③ `roles` 必须含 `argent-general`（恒装入口），且每个角色要么是某个已声明 flow 的 `role`，要么在 presets.json 里声明了 `capability ∈ capabilities`，要么在 `rolesFor` 里点名了本智能体；**反向**也查：每个已声明 flow 的 `role` 必须出现在 `roles` 里。",
+    "④ `plugins` 至少含共享壳 `argent-core` + `argent-skin`（⛔ 任何智能体都不许把它们摘掉）。",
+    "⑤ `scheduler=false` ⇒ `flows` 必须为空、且安装器 ⛔ 不打印定时器命令；`scheduler=true` ⇒ `flows` 必须非空。",
+    "⑥ `credentials` 只写**槽位名 + 落点 + 用途**，⛔ 绝不写值（门禁递归扫描禁止键与密钥形态串）。",
+    "⑦ 未知字段 / 未知能力 / 未知 flow / 未知角色 / 未知插件 / 未知技能 / 未知集成 / 未知档位 ⇒ **红**（门禁 scripts/check-agent-catalog.mjs）。",
+    "⑧ `title` = **商品短名**（W7.7 口径）：⛔ 不含「角色」/「角色包」字样（角色 = DSH preset，Argent 侧不复述；W7.6 已删 Argent 的角色页签），且**不得谎报能力** —— 标题写了「发票」的行必须真的声明了发票能力/流程。两层（本文件 + `plugins/argent-agent-<id>/package.json#argent.agent.title`）必须逐字一致。判据：`scripts/tests/agent-title-naming.test.mjs`（含 5 条有牙）。"
+  ],
+  "version": 1,
+  "plans": [
+    "free",
+    "pro",
+    "enterprise"
+  ],
+  "plugins": {
+    "argent-core": {
+      "title": "Argent 内核插件",
+      "why": "路由/服务/工具（账号、积分、更新、配置）；所有智能体共用。"
+    },
+    "argent-skin": {
+      "title": "Argent 品牌皮肤",
+      "why": "设置页/品牌外观；所有智能体共用。"
+    },
+    "argent-gateway": {
+      "title": "飞书网关",
+      "why": "需要飞书群 @ 派单/收单的智能体才声明；纯本机能力（如 HR）不声明。"
+    },
+    "argent-flow": {
+      "title": "流程控制台",
+      "why": "需要在工作台看流程台账/失败面的智能体才声明。"
+    },
+    "argent-ml": {
+      "title": "美客多平台工具",
+      "why": "美客多各条流程（FULL/两条发票/日报）的工具面插件；ML 类智能体才声明（W3 补登记：此前漏在货架声明外 ⇒ 生成器无从推导「ML 类要装它」）。"
+    }
+  },
+  "integrations": {
+    "feishu-base": {
+      "title": "飞书多维表格（Base）",
+      "why": "流程的票据源与回写面；客户自己的 Base。"
+    },
+    "feishu-card": {
+      "title": "飞书群卡片推送",
+      "why": "日报/完成卡/告警的投递面。"
+    },
+    "ziniao-browser": {
+      "title": "紫鸟浏览器（店铺窗口）",
+      "why": "需要操作平台后台（取标签/箱唛/预约）的智能体才声明；日报只用官方 API ⇒ 不声明。"
+    },
+    "mercadolibre-openapi": {
+      "title": "美客多官方 API（OAuth）",
+      "why": "只读采集店铺数据的正式通道。"
+    },
+    "wenyao-portal": {
+      "title": "上海文鳐门户（对方生产系统）",
+      "why": "文鳐发票的导入/导出面；写操作需人工批准轮。"
+    },
+    "xzh-portal": {
+      "title": "鑫中航门户（对方生产系统）",
+      "why": "鑫中航发票的上传/下载面；写操作需人工批准轮。"
+    }
+  },
+  "agents": [
+    {
+      "id": "hr",
+      "title": "HR 智能体",
+      "summary": "招聘支持 / 员工关系 / PPT 与文档产出；员工隐私严格保密。纯本机能力，无定时流程。",
+      "capability": "hr",
+      "flows": [],
+      "roles": [
+        "argent-general",
+        "argent-hr"
+      ],
+      "plugins": [
+        "argent-core",
+        "argent-skin"
+      ],
+      "skills": [],
+      "integrations": [],
+      "credentials": [],
+      "minPlan": "pro",
+      "scheduler": false,
+      "notes": [
+        "入口角色 = argent-hr（活角色）；argent-hr-office 是 2026-10-04 退役的**墓碑**，随 hr 能力包一起落位（老会话 agentPreset 外键），⛔ 不复活、不当入口。",
+        "无流程 ⇒ 安装器 ⛔ 不打印 flow-timers.sh 命令、⛔ 不建任何定时器。"
+      ]
+    },
+    {
+      "id": "ml-full",
+      "title": "美客多 FULL 发货",
+      "summary": "FULL 货件全链路：识别 → 装箱/标签/箱唛 → 预约 → 完成回写；箱唛等写操作属企业版。",
+      "capability": "full",
+      "flows": [
+        "mercadolibre.full"
+      ],
+      "roles": [
+        "argent-general",
+        "argent-ml-fulfillment"
+      ],
+      "plugins": [
+        "argent-core",
+        "argent-skin",
+        "argent-gateway",
+        "argent-flow",
+        "argent-ml"
+      ],
+      "skills": [
+        "ml-config-guide",
+        "ml-fulfillment-sop"
+      ],
+      "integrations": [
+        "feishu-base",
+        "ziniao-browser",
+        "mercadolibre-openapi",
+        "feishu-card"
+      ],
+      "credentials": [
+        {
+          "slot": "FULL_BASE_TOKEN",
+          "target": "verticals/mercadolibre/env/fulfillment.env",
+          "why": "lip 表（客户 Base）的读写身份 token。"
+        },
+        {
+          "slot": "FULL_TABLE_ID",
+          "target": "verticals/mercadolibre/env/fulfillment.env",
+          "why": "FULL/发票共用的那张表 id。"
+        },
+        {
+          "slot": "FULL_LARK_PROFILE",
+          "target": "verticals/mercadolibre/env/fulfillment.env",
+          "why": "客户 Base 只对客户 bot 开放 ⇒ 用哪个 lark-cli profile 读表。"
+        },
+        {
+          "slot": "ZINIAO_WD_COMPANY",
+          "target": "verticals/mercadolibre/env/ziniao-webdriver.env",
+          "why": "紫鸟客户端（常驻 WebDriver）企业号。"
+        },
+        {
+          "slot": "ZINIAO_WD_USERNAME",
+          "target": "verticals/mercadolibre/env/ziniao-webdriver.env",
+          "why": "紫鸟登录账号。"
+        },
+        {
+          "slot": "ZINIAO_WD_PASSWORD",
+          "target": "verticals/mercadolibre/env/ziniao-webdriver.env",
+          "why": "紫鸟登录密码（店铺浏览器取标签/箱唛用）。"
+        }
+      ],
+      "minPlan": "enterprise",
+      "scheduler": true
+    },
+    {
+      "id": "ml-invoice-wenyao",
+      "title": "美客多·上海文鳐发票智能体",
+      "summary": "只做**上海文鳐**这条货代的发票：模板填报 → 回写 lip 表 → 门户导入/导出 → 回写大货标签。",
+      "capability": "invoice",
+      "flows": [
+        "mercadolibre.wenyao-invoice"
+      ],
+      "roles": [
+        "argent-general",
+        "argent-ml-invoice-wy"
+      ],
+      "plugins": [
+        "argent-core",
+        "argent-skin",
+        "argent-gateway",
+        "argent-flow",
+        "argent-ml"
+      ],
+      "skills": [
+        "ml-config-guide",
+        "ml-invoice"
+      ],
+      "integrations": [
+        "feishu-base",
+        "wenyao-portal",
+        "feishu-card"
+      ],
+      "credentials": [
+        {
+          "slot": "FULL_BASE_TOKEN",
+          "target": "verticals/mercadolibre/env/fulfillment.env",
+          "why": "文鳐与 FULL 同一张 lip 表（同表读写身份）。"
+        },
+        {
+          "slot": "FULL_TABLE_ID",
+          "target": "verticals/mercadolibre/env/fulfillment.env",
+          "why": "同上。"
+        },
+        {
+          "slot": "FULL_LARK_PROFILE",
+          "target": "verticals/mercadolibre/env/fulfillment.env",
+          "why": "同上。"
+        },
+        {
+          "slot": "WENYAO_URL",
+          "target": "verticals/mercadolibre/env/wenyao.env",
+          "why": "文鳐门户地址（对方生产系统）。"
+        },
+        {
+          "slot": "WENYAO_PHONE",
+          "target": "verticals/mercadolibre/env/wenyao.env",
+          "why": "文鳐门户账号（手机号）。"
+        },
+        {
+          "slot": "WENYAO_PASSWORD",
+          "target": "verticals/mercadolibre/env/wenyao.env",
+          "why": "文鳐门户密码。"
+        }
+      ],
+      "minPlan": "enterprise",
+      "scheduler": true,
+      "notes": [
+        "共享能力包 `invoice` 同时含鑫中航那条 flow ⇒ 本智能体按 **flow 子集**过滤：⛔ 不落 `mercadolibre.xzh-invoice`、⛔ 不落 `ml-invoice-xzh` 角色、⛔ 不装鑫中航技能。"
+      ]
+    },
+    {
+      "id": "ml-invoice-xzh",
+      "title": "美客多·鑫中航发票智能体",
+      "summary": "只做**鑫中航-美墨**这条货代的发票：生成 → 门户上传 → 下载大货标签 → 状态机流转。",
+      "capability": "invoice",
+      "flows": [
+        "mercadolibre.xzh-invoice"
+      ],
+      "roles": [
+        "argent-general",
+        "argent-ml-invoice-xzh"
+      ],
+      "plugins": [
+        "argent-core",
+        "argent-skin",
+        "argent-gateway",
+        "argent-flow",
+        "argent-ml"
+      ],
+      "skills": [
+        "ml-config-guide",
+        "ml-invoice-xzh"
+      ],
+      "integrations": [
+        "feishu-base",
+        "xzh-portal",
+        "feishu-card"
+      ],
+      "credentials": [
+        {
+          "slot": "FULL_BASE_TOKEN",
+          "target": "verticals/mercadolibre/env/fulfillment.env",
+          "why": "与 FULL/文鳐同一张 lip 表。"
+        },
+        {
+          "slot": "FULL_TABLE_ID",
+          "target": "verticals/mercadolibre/env/fulfillment.env",
+          "why": "同上。"
+        },
+        {
+          "slot": "FULL_LARK_PROFILE",
+          "target": "verticals/mercadolibre/env/fulfillment.env",
+          "why": "同上。"
+        },
+        {
+          "slot": "xhInvoiceUser",
+          "target": "config.json",
+          "why": "鑫中航门户账号（写生产系统用）。"
+        },
+        {
+          "slot": "xhInvoicePass",
+          "target": "config.json",
+          "why": "鑫中航门户密码。"
+        }
+      ],
+      "minPlan": "enterprise",
+      "scheduler": true,
+      "notes": [
+        "共享能力包 `invoice` 同时含文鳐那条 flow ⇒ 本智能体按 **flow 子集**过滤：⛔ 不落 `mercadolibre.wenyao-invoice`、⛔ 不落 `ml-invoice-wy` 角色、⛔ 不装文鳐技能。"
+      ]
+    },
+    {
+      "id": "ml-daily",
+      "title": "美客多日报",
+      "summary": "官方 API **只读**采集 → 畅销榜/补货预警/风险利润流量 → 飞书群卡片；⛔ 不写客户任何系统、⛔ 不动浏览器。",
+      "capability": "daily-report",
+      "flows": [
+        "mercadolibre.daily-report"
+      ],
+      "roles": [
+        "argent-general",
+        "argent-ml-daily"
+      ],
+      "plugins": [
+        "argent-core",
+        "argent-skin",
+        "argent-gateway",
+        "argent-flow",
+        "argent-ml"
+      ],
+      "skills": [
+        "ml-store-daily-report"
+      ],
+      "integrations": [
+        "mercadolibre-openapi",
+        "feishu-card"
+      ],
+      "credentials": [
+        {
+          "slot": "ML_APP_ID",
+          "target": "verticals/mercadolibre/env/daily-report.env",
+          "why": "美客多开发者后台应用 id（OAuth 授权用）。"
+        },
+        {
+          "slot": "ML_APP_SECRET",
+          "target": "verticals/mercadolibre/env/daily-report.env",
+          "why": "美客多应用 Secret。"
+        },
+        {
+          "slot": "ML_DAILY_CHAT_ID",
+          "target": "verticals/mercadolibre/env/daily-report.env",
+          "why": "日报推送群 id（也可在设置页写 config）。"
+        }
+      ],
+      "minPlan": "pro",
+      "scheduler": true,
+      "notes": [
+        "只读 ⇒ 档位 Pro（判据：只读 ⇒ Pro / 写操作 ⇒ 企业版）；⛔ 不声明 ziniao-browser（日报不碰浏览器）。"
+      ]
+    },
+    {
+      "id": "ml-suite",
+      "title": "美客多全套（组合）",
+      "summary": "FULL 发货 + 上海文鳐发票 + 鑫中航发票 + 日报 四条一起装（一个客户买全套时的省事入口）。",
+      "capabilities": [
+        "full",
+        "invoice",
+        "daily-report"
+      ],
+      "flows": [
+        "mercadolibre.full",
+        "mercadolibre.wenyao-invoice",
+        "mercadolibre.xzh-invoice",
+        "mercadolibre.daily-report"
+      ],
+      "roles": [
+        "argent-general",
+        "argent-ml-fulfillment",
+        "argent-ml-invoice-wy",
+        "argent-ml-invoice-xzh",
+        "argent-ml-daily"
+      ],
+      "plugins": [
+        "argent-core",
+        "argent-skin",
+        "argent-gateway",
+        "argent-flow",
+        "argent-ml"
+      ],
+      "skills": [
+        "ml-config-guide",
+        "ml-fulfillment-sop",
+        "ml-invoice",
+        "ml-invoice-xzh",
+        "ml-store-daily-report"
+      ],
+      "integrations": [
+        "feishu-base",
+        "feishu-card",
+        "ziniao-browser",
+        "mercadolibre-openapi",
+        "wenyao-portal",
+        "xzh-portal"
+      ],
+      "credentials": [
+        {
+          "slot": "FULL_BASE_TOKEN",
+          "target": "verticals/mercadolibre/env/fulfillment.env",
+          "why": "lip 表读写身份 token（FULL + 两条发票共用）。"
+        },
+        {
+          "slot": "FULL_TABLE_ID",
+          "target": "verticals/mercadolibre/env/fulfillment.env",
+          "why": "共用表 id。"
+        },
+        {
+          "slot": "FULL_LARK_PROFILE",
+          "target": "verticals/mercadolibre/env/fulfillment.env",
+          "why": "读表用的 lark-cli profile。"
+        },
+        {
+          "slot": "ZINIAO_WD_COMPANY",
+          "target": "verticals/mercadolibre/env/ziniao-webdriver.env",
+          "why": "紫鸟客户端企业号（FULL 取标签/箱唛）。"
+        },
+        {
+          "slot": "ZINIAO_WD_USERNAME",
+          "target": "verticals/mercadolibre/env/ziniao-webdriver.env",
+          "why": "紫鸟登录账号。"
+        },
+        {
+          "slot": "ZINIAO_WD_PASSWORD",
+          "target": "verticals/mercadolibre/env/ziniao-webdriver.env",
+          "why": "紫鸟登录密码。"
+        },
+        {
+          "slot": "WENYAO_URL",
+          "target": "verticals/mercadolibre/env/wenyao.env",
+          "why": "文鳐门户地址。"
+        },
+        {
+          "slot": "WENYAO_PHONE",
+          "target": "verticals/mercadolibre/env/wenyao.env",
+          "why": "文鳐门户账号。"
+        },
+        {
+          "slot": "WENYAO_PASSWORD",
+          "target": "verticals/mercadolibre/env/wenyao.env",
+          "why": "文鳐门户密码。"
+        },
+        {
+          "slot": "xhInvoiceUser",
+          "target": "config.json",
+          "why": "鑫中航门户账号。"
+        },
+        {
+          "slot": "xhInvoicePass",
+          "target": "config.json",
+          "why": "鑫中航门户密码。"
+        },
+        {
+          "slot": "ML_APP_ID",
+          "target": "verticals/mercadolibre/env/daily-report.env",
+          "why": "美客多应用 id（日报 OAuth）。"
+        },
+        {
+          "slot": "ML_APP_SECRET",
+          "target": "verticals/mercadolibre/env/daily-report.env",
+          "why": "美客多应用 Secret。"
+        },
+        {
+          "slot": "ML_DAILY_CHAT_ID",
+          "target": "verticals/mercadolibre/env/daily-report.env",
+          "why": "日报推送群 id。"
+        }
+      ],
+      "minPlan": "enterprise",
+      "scheduler": true
+    }
+  ]
+}