AI 辅助集成

除按接口文档手动对接外，我们还提供 AIG Integration Skill：把接口规格、签名算法、资金安全规则和分阶段实现步骤打包成 AI 编码助手可直接使用的指令包。安装后，只需在 Claude Code 等 AI 编码助手中说一句"接入 AIG 单一钱包"，AI 会读取你现有的代码库，按你的语言和框架生成完整的接入代码和测试。

1、选择钱包模式

	转账钱包	单一钱包
余额在哪	游戏侧为玩家单独建钱包	商户侧，游戏侧不保存余额
调用方向	商户 → 游戏侧（转入/转出/查询）	游戏侧 → 商户（余额/下注/派彩/取消下注回调）
商户需要	调用接口 + 对账任务	公网 HTTPS 回调地址
对应 Skill	aig-transfer-wallet	aig-seamless-wallet
下载	aig-transfer-wallet.zip	aig-seamless-wallet.zip

钱包模式由商户开户时确定，不确定请咨询客服。

2、Skill 包含什么

aig-seamless-wallet/
├── SKILL.md              触发短语、必须遵守的资金规则、完成标准
├── guide.md              分阶段实现步骤
├── reference/            协议、签名（含测试向量）、各接口规格、自测场景
└── appendix/             错误码、游戏 ID、语言、环境地址

Skill 只包含 Markdown 文件，不含可执行代码，不会上传你的代码或密钥。

3、安装（Claude Code）

1. 下载对应的 zip 并解压，得到 aig-seamless-wallet/ 或 aig-transfer-wallet/ 文件夹。
2. 放到你项目的 .claude/skills/ 目录下（仅对该项目生效），或 ~/.claude/skills/（对所有项目生效）：

your-project/
└── .claude/
    └── skills/
        └── aig-seamless-wallet/   ← 放在这里
            ├── SKILL.md
            ├── guide.md
            └── ...

3. 重启 Claude Code。

4、使用

在项目目录中启动 Claude Code，输入以下任一句话：

单一钱包

接入 AIG 单一钱包
Implement AIG seamless wallet integration

转账钱包

接入 AIG 转账钱包
Implement AIG transfer wallet integration

AI 会按以下阶段进行，每个阶段结束时向你说明进展：

阶段	单一钱包	转账钱包
0	分析代码库：框架、配置方式、现有钱包、玩家 ID	同左，另确认后台任务机制
1	配置 + 签名/验签，签名测试向量必须通过	配置 + 签名 + 接口客户端
2	回调幂等记录表	转账记录表
3	实现 4 个回调接口	转入/转出/全部转出 + 对账任务
4	注册会员与进入游戏	注册会员与进入游戏
5	按自测场景测试	注单同步任务
6	交付：改动清单、环境变量、回调地址、待确认事项	按自测场景测试
7		交付：改动清单、环境变量、出口 IP、待确认事项

建议提前准备好以下信息，AI 会向你询问：

• 商户 ID（agent_id）、商户私钥、API 网关地址（测试环境 https://staging.aig1234.com）
• 你系统中作为 user_id 的玩家标识（3–64 位，仅英文、数字、_）
• 使用的币种
• 单一钱包：游戏侧可访问的回调基础地址，例如 https://wallet.example.com
• 转账钱包：服务器出口 IP（需加入游戏侧白名单）

提示

不要把商户私钥写进代码或提交到仓库。AI 会把它放在环境变量或配置文件中；私钥可以在最后由你自己填入。

5、其他 AI 编码助手

Skill 是普通的 Markdown 文件，Cursor、GitHub Copilot、Codex 等工具同样可以使用：把 Skill 文件夹放进项目（例如 docs/aig-seamless-wallet/），然后发送：

单一钱包

Read docs/aig-seamless-wallet/SKILL.md and follow it to integrate the AIG seamless wallet into this project.
Load the other files in that folder as SKILL.md instructs. Follow guide.md phase by phase,
and make the signing test vectors in reference/signing.md pass before implementing the callbacks.

转账钱包

Read docs/aig-transfer-wallet/SKILL.md and follow it to integrate the AIG transfer wallet into this project.
Load the other files in that folder as SKILL.md instructs. Follow guide.md phase by phase,
and make the signing test vectors in reference/signing.md pass before implementing transfers.

可以在末尾补充你的项目信息，例如内部文档链接、使用的币种、特殊要求等。

6、上线前检查

• reference/signing.md 中的签名测试向量全部通过
• reference/test-scenarios.md 中的自测场景全部通过
• 私钥只存在于环境变量/配置中，日志中不出现私钥
• 单一钱包：回调接口对同一 bet_txn_id 的重复请求不会重复扣款/加款；先收到取消下注、后收到下注时能正确拒绝
• 转账钱包：转入/转出超时后不会直接判定失败，由对账任务确认最终结果
• 在测试环境完成联调，再切换生产环境

7、常见问题

1、AI 生成的代码和接口文档不一致，以哪个为准？

Skill 中包含了接口文档之外的实现细节（超时、重试、幂等、异常处理等），生成的代码可能比接口文档要求得更严格。如有疑问请联系技术支持。

2、Skill 会更新吗？

会。本页的下载链接始终是最新版本，接口有变更时请重新下载并替换。

3、我的项目没有现成的钱包系统怎么办？

AI 会在分析阶段发现并询问你，是新建一个最小的钱包，还是对接你已有的外部服务。