config-man/docs/USAGE.md

Config-Man 查看功能使用说明

功能概述

Config-Man 的查看功能允许您对比显示对象存储和CDN中的配置内容，支持Android和iOS平台。

安装依赖

首先安装项目依赖：

pip install -e .

基本用法

1. 查看配置文件

# 查看版本 0.30 的配置文件
python main.py view --version 0.30

# 以JSON格式输出
python main.py view --version 0.30 --json

# 使用模拟环境进行测试
python main.py view --version 0.30 --mock

2. 查看帮助信息

# 查看主命令帮助
python main.py --help

# 查看view命令帮助
python main.py view --help

参数说明

view 命令参数

• --version: 版本号，格式为 0.29, 0.30, 0.31 等（必需）
• --json: 以JSON格式输出（可选）
• --storage-path: 对象存储路径前缀，默认为 'ab'（可选）
• --cdn-url: CDN基础URL（可选）
• --mock: 使用模拟环境进行测试（可选）

输出格式

表格格式（默认）

版本: 0.30 | 平台: Android
┌─────────────────┬─────────────────────┬─────────────────────┬──────────┐
│ 配置项          │ 对象存储内容        │ CDN内容             │ 状态     │
├─────────────────┼─────────────────────┼─────────────────────┼──────────┤
│ Ver             │ 0.30.2ghi789       │ 0.30.2ghi789       │ ✅ 一致  │
│ EventApiURL     │ https://n3backend. │ https://n3backend. │ ✅ 一致  │
│ NewFeature      │ enabled             │ N/A                 │ ❌ 不同  │
│ ...             │ ...                 │ ...                 │ ...      │
└─────────────────┴─────────────────────┴─────────────────────┴──────────┘

JSON格式

{
  "version": "0.30",
  "platform": "android",
  "storage_config": {
    "EventApiURL": "https://n3backend.azurewebsites.net/",
    "Ver": "0.30.2ghi789",
    "NewFeature": "enabled"
  },
  "cdn_config": {
    "EventApiURL": "https://n3backend.azurewebsites.net/",
    "Ver": "0.30.2ghi789"
  }
}

模拟环境测试

为了方便测试，项目提供了模拟环境：

# 使用模拟环境测试
python main.py view --version 0.30 --mock

模拟环境会：

1. 自动创建测试配置文件
2. 模拟rclone命令
3. 提供完整的测试数据

错误处理

常见错误

1. 版本号格式错误

   错误: 无效的版本号格式: 1.2.3
   

2. rclone未安装

   错误: rclone 未安装或不可用。请先安装 rclone。
   

3. 文件不存在

   警告: 无法从对象存储下载 ab/0_30/androidconfig.json: 文件不存在
   

4. 网络连接失败

   警告: 无法从CDN获取 https://cdn.example.com/ab/0_30/androidconfig.json
   

配置说明

配置文件结构

配置文件包含以下主要字段：

• EventApiURL: API端点URL
• Ver: 版本信息
• PlayFabTitle: PlayFab标题
• Google_Play_URL: Google Play商店链接
• APP_Store_URL: App Store链接
• HeartBeat: 心跳间隔
• RTMPid: RTM进程ID
• RTMServerEndpoint: RTM服务器端点
• RTMHmacSecret: RTM HMAC密钥
• FuncUrl: 功能URL
• FuncKey: 功能密钥

版本号转换

版本号会自动转换为存储路径格式：

• 0.29 → 0_29
• 0.30 → 0_30
• 1.00 → 1_00

高级用法

自定义存储路径

python main.py view --version 0.30 --storage-path custom_path

指定CDN URL

python main.py view --version 0.30 --cdn-url https://cdn.example.com

组合使用

python main.py view --version 0.30 --json --mock --storage-path test_data/ab

故障排除

1. 安装问题

确保安装了所有依赖：

pip install click pycryptodome tabulate requests rich

2. rclone配置

如果使用真实环境，需要配置rclone：

rclone config

3. 权限问题

确保有足够的权限访问对象存储和CDN。

4. 网络问题

检查网络连接和防火墙设置。

开发说明

项目结构

config-man/
├── main.py              # 主程序入口
├── appconfig_tool.py    # 加密解密工具
├── config_manager.py    # 配置管理器
├── display_manager.py   # 显示管理器
├── view_command.py      # 查看命令处理器
├── mock_rclone.py       # 模拟rclone环境
└── test_configs.py      # 测试配置生成器

扩展功能

要添加新的查看功能，可以：

1. 在 config_manager.py 中添加新的方法
2. 在 display_manager.py 中添加新的显示格式
3. 在 view_command.py 中添加新的处理逻辑
4. 在 main.py 中添加新的CLI命令

联系支持

如果遇到问题，请检查：

1. 版本号格式是否正确
2. 网络连接是否正常
3. rclone配置是否正确
4. 依赖是否完整安装