项目接入配置

接入配置描述项目希望连接的业务目标；平台信任与账号身份来自仓库外的可信绑定，不由项目配置自行决定。

xuji-connect.json

项目根目录 / xuji-connect.json

{
  "schemaVersion": "xuji-connect/1",
  "targets": [
    {
      "name": "dev",
      "planPath": "cloudbase/connect/dev-plan.json",
      "artifactPath": "cloudbase/connect/xg_ops-dev.zip"
    }
  ]
}

路径相对项目根目录，必须指向根目录内部的真实文件。多个目标必须显式选择，不能按目录名或上次执行环境猜测。

计划文件

下面示例针对已有蹊光适配器。所有说明性值均需替换，动作必须由项目实际实现。

cloudbase/connect/dev-plan.json

{
  "projectId": "existing_platform_project_id",
  "environmentId": "logical_dev",
  "environmentRole": "dev",
  "cloudEnvironmentId": "actual_cloudbase_environment_id",
  "functionName": "xg_ops",
  "allowedActions": ["metrics.overview", "orders.list", "orders.get"],
  "approvedTopics": ["metrics.overview"],
  "streamEpoch": "explicit_snapshot_stream_epoch"
}

字段	说明
projectId	已存在的掌序项目 ID，不是产品名称或 AppID
environmentId	项目逻辑环境标识
environmentRole	环境用途；本例为开发环境
cloudEnvironmentId	实际 CloudBase 物理环境 ID
functionName	本次指定的已存在管理函数
allowedActions	连接允许调用且项目端实际支持的动作
approvedTopics	已批准的摘要主题
streamEpoch	明确的事件流标识

不应放入的内容

项目声明不接受 platform、platformUrl、accountId、expectedAccountId、trustFile 等信任字段。认证平台通过明确参数和可信绑定确认。

长期密钥不放进 Git、插件 JSON 或普通本地文件。默认本机信任文件为用户目录下 .xuji/connect-trust.json，恢复记录位于 .xuji/connect-sessions；不要把这些位置随项目发布。

文件限制

声明 JSON 最大 64 KiB，嵌套最多 20 层；拒绝重复键、危险对象键、未知字段、非法 UTF-8、越界路径与符号链接。ZIP 的完整内容与摘要由接入冻结步骤再次检查。