设置与偏好手册
节点的选择逻辑、AI 模型的接入、语言的切换、日志的排查到版本升级，覆盖你按需定制钱包体验的每一个设置项。本手册不仅教你「怎么点」，更讲清每一项背后的底层逻辑。
01节点选择（NodeSelector）
节点是钱包与区块链之间的「桥」。节点选择的质量，直接决定查询速度、成功率与数据准确性。AI Crypto Wallet 通过 NodeSelector 组件，为你自动维护一套链感知 + 延迟择优 + 主备用切换的节点体系，你几乎不需要手动干预。
链感知 ping
与盲目的「能连上就算好」不同，NodeSelector 会针对每一条链分别维护节点列表。因为不同链的 RPC 服务商、网络拥护、可达性各不相同——例如 BSC 使用 AVE 自建代理节点（延迟约 200ms），而 EVM 通用节点与 SOL/TRX 的 HTTP RPC 节点需独立处理。选择器会逐链记录每个节点的延迟，作为择优依据。
节点延迟显示
在「节点选择」页面，每个可用节点都会展示实时延迟数据（ms）。延迟越低，代表数据往返越快，交易广播与余额查询的响应体验越好。延迟并非唯一指标，选择器还会综合成功率与重试次数。例如连接超时被缩短至 3s 快速失败，避免长时间卡顿。
主 / 备用节点自动切换
当主节点连续失败时，系统自动回退到备用节点，并记录这次失败用于后续优先级调整。整个流程对用户透明——你看到的只是「请求总是能成功」。NodeManager 负责节点健康检查与延迟监控，为切换提供数据支撑。
节点「选择」不是单一快照，而是一个持续的健康评估过程。选择器以「延迟 + 成功率 + 是否可达」综合打分，链感知地维护独立列表，从而兼顾速度与可用性两大目标。
02AI 模型配置
AI 智能交易的核心是底层大语言模型（LLM）。在「AI 模型配置」中，你可以选择模型提供商、填写接入凭证，并随时查看脱敏状态。
Provider 选择
应用兼容 OpenAI 与 Claude（Anthropic） 两类协议，同时支持 OpenAI function calling 与 Claude tool use 两种函数调用规范。你在下拉框中选择 provider 后，应用会自动适配对应的 API 路径与请求格式（聊天接口会自动补全 /chat/completions 路径）。
API Key 设置与脱敏
API Key 是访问 LLM 服务的凭证，属于高敏感信息。应用采用「脱敏存储」策略：
- 填写时完整输入，保存后仅保留前 4 位 + 后 4 位（例如
sk-****abcd）。 - 脱敏后的 Key 存入
agent_memory.json的meta.apiKeyMasked字段。 - AI 智能体在任何情况下都看不到完整 Key，只能看到脱敏版本。
- 重新进入设置页时显示脱敏值，如需更换则重新输入完整 Key 覆盖。
请勿将 API Key 分享给任何人。应用内所有写入操作均经过安全网关校验，AI 无法通过任何工具读取或导出完整 API Key。
03多语言切换
应用界面与 AI 回答语言均可独立配置。系统原生支持 8 种语言：
| 语言 | Locale 标识 | 覆盖场景 |
|---|---|---|
| 简体中文 | zh-CN | 默认语言，界面 + AI 回答 |
| English（英文） | en | 界面 + AI 回答 |
| 日本語（日文） | ja | 界面 + AI 回答 |
| Deutsch（德文） | de | 界面 + AI 回答 |
| 繁體中文（繁体） | zh-TW | 界面 + AI 回答 |
| 한국어（韩文） | ko | 界面 + AI 回答 |
| Español（西班牙文） | es | 界面 + AI 回答 |
| Français（法文） | fr | 界面 + AI 回答 |
切换后立即生效，钱包资产、交易记录等数据不受影响。AI 的回答语言偏好会同步写入记忆文件 preferences.language，AI 在后续对话中遵循该偏好。
04通用设置
通用设置集中管理钱包的日常行为与显示偏好：
- 资产显示：货币单位（USD / 法币）、隐藏小额资产、显示精度。
- 默认主链：首页默认展示的链（BNB/ETH/SOL…），与 AI 的
tradingChain相关联。 - 刷新频率：资产与行情列表的自动刷新间隔。
- 通知开关：AI 主动聊天、交易结果、止损止盈触发的系统通知。
- 数据缓存：DataCache 按「钱包地址 + 链」校验与刷新，避免跨钱包串数据。
通用设置遵循「用户可控」原则——自动交易必须由用户手动开启/关闭，AI 不能自行启动；所有影响资金行为的开关都默认保持保守值。
05日志系统（Logger）
日志是排查问题、审计行为的核心依据。应用内置 Logger 组件，统一格式为 [时间] [级别] [模块] 消息。
日志级别
| 级别 | 用途 | 示例 |
|---|---|---|
INFO | 正常流程信息 | 安全网关检查通过 |
ACTION | 用户 / AI 主动操作 | swap_tokens 兑换操作 |
SUCCESS | 操作成功 | 交易广播成功 txHash=0x… |
WARNING | 警告（接近限额等） | 今日交易接近每日上限 |
ERROR | 错误（交易失败等） | 合约调用失败 |
示例：[22:05:01] [ACTION] [AgentSwap] swap_tokens chain=BNB target=0x92cb…->NATIVE desc=卖出R-MAB换BNB
崩溃日志
当应用崩溃时，系统会同步写入外部存储，便于你或开发者定位问题：
Android/data/com.aicryptowallet.app/files/crash_log.txt该目录为应用专有外部目录，无需额外权限，随应用卸载自动清理。若遇到闪退，可先查看此文件中的堆栈信息，再通过 GitHub Issues 反馈。
06版本信息与升级
版本号规则
Android 采用标准的 versionCode（整数，单调递增）+ versionName（人类可读）双版本机制：
- versionCode：整数，每次构建必须递增，用于系统判断「是否更新」。
- versionName：如
2.5.0，遵循「主版本.次版本.修订号」，便于用户识别功能级别。 - 项目规范：每次代码改动必须同步升级 versionCode + versionName，禁止只改一个。
Debug 签名
开发调试版本使用 Android 默认的 debug.keystore 签名，仅用于开发与自测；正式发布版本使用独立的 release 签名。两者签名不一致，因此 debug 包无法在正式包之上覆盖安装，反之亦然——这是 Android 签名机制的固有约束，用于防止恶意篡改。
请通过官方渠道（GitHub Releases）下载正式 APK，升级前建议先备份助记词与记忆文件（agent_memory.json），确保资产与 AI 配置万无一失。