huangjiayu
/
WX-Game1
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
WX-Game1/sign_generation_task.md

7.6 KiB
Raw Permalink Blame History

上下文

文件名：sign_generation_task.md 创建于：2025-01-27 10:30:00 创建者：AI Assistant 关联协议：RIPER-5 + Multidimensional + Agent Protocol (Conditional Interactive Step Review Enhanced)

任务描述

为Unity微信小游戏项目添加sign签名生成功能，根据提供的PHP示例实现C#版本的sign生成方法。接口请求需要增加sign参数，按照以下规则生成：

  1. 将参数去除sign进行ASCII排序
  2. 拼接成字符串（key+value格式）
  3. 在字符串后面加上AppSecret
  4. 进行MD5加密

项目概述

Unity微信小游戏项目，使用WebRequestManager进行HTTP请求管理，已有token认证机制。需要集成sign签名验证机制以增强接口安全性。

以下部分由 AI 在协议执行过程中维护

分析 (由 RESEARCH 模式填充)

通过代码分析发现：

  1. 现有网络架构：

    • WebRequestManager.cs：负责HTTP请求管理，支持GET/POST请求
    • Apis.cs：管理API接口地址和token
    • 已有token认证机制，通过请求头传递

  2. MD5加密支持：

    • MotionFramework.Utility.HashUtility.StringMD5()：提供MD5加密功能
    • 支持字符串MD5加密，符合sign生成需求

  3. 请求参数处理：

    • 当前支持urlencoded和JSON格式
    • PostFormRequest方法处理表单数据
    • 需要扩展支持sign参数自动生成

  4. 配置管理：

    • Apis.cs管理基础配置
    • 需要添加AppKey和AppSecret配置

  5. 接口调用模式：

    • 使用异步UniTask模式
    • 支持回调函数和异常处理
    • 需要保持现有调用方式兼容性

提议的解决方案 (由 INNOVATE 模式填充)

基于研究分析，采用混合方案实现sign生成功能：

方案选择：混合方案（推荐）

  • 创建SignUtility工具类处理签名逻辑
  • 在WebRequestManager中添加可选的sign支持
  • 保持向后兼容，新接口可选择启用sign
  • 优点：灵活性高，兼容性好

技术实现：

  • 参数排序：使用SortedDictionary确保ASCII排序
  • 数组处理：JSON序列化数组参数
  • MD5加密：使用现有HashUtility.StringMD5
  • 配置管理：在Apis.cs中添加AppKey/AppSecret
  • 错误处理：完善的异常处理机制

实施计划 (由 PLAN 模式生成)

基于创新阶段的分析，采用混合方案来实现sign生成功能。

架构设计：

  1. 创建SignUtility工具类，专门处理签名生成逻辑
  2. 扩展Apis.cs，添加AppKey和AppSecret配置管理
  3. 修改WebRequestManager，添加可选的sign支持
  4. 保持向后兼容，现有接口调用不受影响

详细实施规范：

文件修改计划：

  • Assets/Scripts/Utility/SignUtility.cs (新建)
  • Assets/Scripts/Apis.cs (扩展)
  • Assets/Scripts/Network/WebRequestManager.cs (扩展)
  • Assets/Scripts/Test/SignUtilityTest.cs (新建)

SignUtility类设计：

  • 静态方法：GenerateSign(Dictionary<string, object> parameters, string appSecret)
  • 支持参数排序、数组处理、MD5加密
  • 完善的错误处理和日志记录

Apis.cs扩展：

  • 添加AppKey和AppSecret静态属性
  • 添加设置和获取方法
  • 保持现有接口不变

WebRequestManager扩展：

  • 添加enableSign参数到请求方法
  • 自动生成sign参数并添加到请求中
  • 保持现有方法签名兼容

实施检查清单：

  1. [创建SignUtility工具类，实现sign生成核心逻辑, review:true]
  2. [扩展Apis.cs，添加AppKey和AppSecret配置管理, review:true]
  3. [修改WebRequestManager，添加sign支持到GET请求方法, review:true]
  4. [修改WebRequestManager，添加sign支持到POST请求方法, review:true]
  5. [添加异步方法的sign支持, review:true]
  6. [创建测试用例验证sign生成正确性, review:true]
  7. [更新任务进度文档, review:false]

当前执行步骤 (由 EXECUTE 模式在开始执行某步骤时更新)

任务进度 (由 EXECUTE 模式在每步完成后，以及在交互式审查迭代中追加)

  • 2025-01-27 10:35:00

    • 步骤：1. [创建SignUtility工具类，实现sign生成核心逻辑 (完成, 审查需求: review:true)]
    • 修改：创建了 Assets/Scripts/Utility/SignUtility.cs 文件，实现了完整的sign生成功能
    • 更改摘要：实现了SignUtility静态工具类，包含GenerateSign方法（支持object和string参数）、参数排序、数组处理、MD5加密、签名验证等功能，添加了完善的错误处理和日志记录
    • 原因：执行计划步骤 1 的实施
    • 阻碍：无
    • 状态：已完成
    • 用户确认状态：成功

  • 2025-01-27 10:40:00

    • 步骤：2. [扩展Apis.cs，添加AppKey和AppSecret配置管理 (完成, 审查需求: review:true)]
    • 修改：扩展了 Assets/Scripts/Apis.cs 文件，添加了AppKey和AppSecret的静态属性和相关方法
    • 更改摘要：添加了SetAppKey/GetAppKey和SetAppSecret/GetAppSecret方法，保持现有接口不变，为sign生成提供配置支持
    • 原因：执行计划步骤 2 的实施
    • 阻碍：无
    • 状态：已完成
    • 用户确认状态：成功

  • 2025-01-27 10:45:00

    • 步骤：3. [修改WebRequestManager，添加sign支持到GET请求方法 (完成, 审查需求: review:true)]
    • 修改：修改了 Assets/Scripts/Network/WebRequestManager.cs 文件，为GetRequest方法添加了sign支持
    • 更改摘要：添加了enableSign和signParams参数，自动生成sign签名并添加到请求中，支持AppKey和时间戳自动添加
    • 原因：执行计划步骤 3 的实施
    • 阻碍：无
    • 状态：已完成
    • 用户确认状态：成功

  • 2025-01-27 10:50:00

    • 步骤：4. [修改WebRequestManager，添加sign支持到POST请求方法 (完成, 审查需求: review:true)]
    • 修改：修改了 Assets/Scripts/Network/WebRequestManager.cs 文件，为PostRequest方法添加了sign支持
    • 更改摘要：添加了enableSign和signParams参数，支持urlencoded和JSON两种格式的sign参数添加，自动生成sign签名
    • 原因：执行计划步骤 4 的实施
    • 阻碍：无
    • 状态：已完成
    • 用户确认状态：成功

  • 2025-01-27 10:55:00

    • 步骤：5. [添加异步方法的sign支持 (完成, 审查需求: review:true)]
    • 修改：修改了 Assets/Scripts/Network/WebRequestManager.cs 文件，为GetRequestAsync和PostRequestAsync方法添加了sign支持
    • 更改摘要：为异步方法添加了enableSign和signParams参数，保持与同步方法的一致性
    • 原因：执行计划步骤 5 的实施
    • 阻碍：无
    • 状态：已完成
    • 用户确认状态：成功

  • 2025-01-27 11:00:00

    • 步骤：6. [创建测试用例验证sign生成正确性 (完成, 审查需求: review:true)]
    • 修改：创建了 Assets/Scripts/Test/SignUtilityTest.cs 文件，实现了完整的测试用例
    • 更改摘要：实现了SignUtilityTest类，包含基本sign生成、数组处理、签名验证、空参数、null参数、PHP示例一致性等测试用例，提供Inspector界面测试
    • 原因：执行计划步骤 6 的实施
    • 阻碍：无
    • 状态：已完成
    • 用户确认状态：成功

  • 2025-01-27 11:05:00

    • 步骤：7. [更新任务进度文档 (完成, 审查需求: review:false)]
    • 修改：更新了 sign_generation_task.md 文件，完善了所有阶段的文档记录
    • 更改摘要：补充了提议的解决方案和实施计划的详细内容，记录了所有执行步骤的完成情况
    • 原因：执行计划步骤 7 的实施
    • 阻碍：无
    • 状态：已完成
    • 用户确认状态：成功

最终审查 (由 REVIEW 模式填充)