核心用法
该 Skill 是 aria2 下载管理器的 JSON-RPC 2.0 客户端，允许用户通过自然语言命令控制下载任务。核心工作流遵循"配置检查 → 命令执行"的两步模式：首先通过 python3 scripts/config_loader.py test 验证与 aria2 服务的连接状态，测试通过后再执行具体的下载操作。
支持的下载协议包括 HTTP/HTTPS、FTP、磁力链接（Magnet）、种子文件（Torrent）和 Metalink。操作类型涵盖添加下载、暂停/恢复任务、删除任务、批量管理（暂停全部/恢复全部）、查看下载进度与状态、获取全局统计信息以及实时监控等。所有命令均通过 scripts/rpc_client.py 脚本调用，无需手动构造 JSON-RPC 请求。
配置系统采用四级优先级设计：环境变量（临时覆盖）> Skill 目录配置（项目级）> 用户目录配置 ~/.config/aria2-skill/（全局默认，更新安全）> 本地默认值（localhost:6800）。推荐用户使用 --user 参数初始化全局配置，以确保 Skill 更新时配置不丢失。
显著优点
零依赖安全架构：完全基于 Python 3.6+ 标准库实现，无第三方依赖包，从根本上消除了供应链攻击风险。可选的 WebSocket 实时通知功能需用户手动安装 websockets 包，不影响核心功能使用。
企业级配置管理：支持多级配置存储与密钥隔离，RPC 密钥通过 token:{secret} 标准格式注入请求，配置显示时自动脱敏处理（******）。支持 HTTPS/WSS 加密传输，适应反向代理部署场景。
完善的错误处理与输入验证：端口范围限制（1-65535）、超时正整数校验、完善的异常捕获机制，避免敏感信息泄露。所有操作均通过封装脚本执行，禁止直接构造 RPC 请求或执行原始 shell 命令。
开发者友好设计：提供详细的执行指南（execution-guide.md）、方法参考文档（aria2-methods.md）和故障排除手册（troubleshooting.md），包含命令映射表、参数格式化规则和常见错误规避指南。
潜在缺点与局限性
前提依赖严格：必须预先部署并配置好 aria2 守护进程，Skill 本身不集成 aria2 服务端。对于未接触过 aria2 的用户，需要额外的学习成本完成服务端部署、RPC 启用和密钥配置。
T3 来源可信度：由个人开发者 ISON（azzgo）维护，非知名企业或基金会背书。虽然代码通过全面安全扫描，但长期维护承诺、更新频率和社区支持规模存在不确定性。
功能边界明确：仅作为控制客户端存在，不直接执行下载任务，不管理下载内容存储，不提供下载内容的安全审查机制。恶意 torrent 或 URL 的过滤完全依赖用户自身判断和 aria2 服务端的配置。
WebSocket 功能可选：实时事件通知需要额外安装依赖，对于追求"开箱即用"体验的用户可能不够便捷。
适合的目标群体
技术型用户与开发者：熟悉命令行操作、了解 aria2 工作原理、具备基础网络配置能力的用户。适合已将 aria2 作为基础设施的进阶用户，希望通过自然语言交互提升操作效率。
NAS 与服务器管理者：在私有服务器、NAS 设备或远程主机上部署 aria2 的用户，需要通过统一接口管理分布式下载任务的场景。
自动化工作流构建者：需要将下载任务集成到自动化脚本、CI/CD 流程或智能家居系统的开发者，利用其稳定的 RPC 接口实现程序化控制。
隐私敏感用户：注重数据主权、希望避免第三方下载工具数据收集的用户，配合自托管 aria2 服务可实现完全私有的下载管理。
使用风险
配置安全风险（关键）：Skill 的安全性高度依赖 aria2 RPC 端点的配置。若 aria2 服务端未设置 RPC 密钥（secret）、监听公网 IP 或未启用 TLS，将面临未授权访问风险。建议严格遵循最小权限原则：生产环境仅监听 localhost，远程访问强制 HTTPS，配置强密钥。
下载内容风险：Skill 不对下载链接进行安全审查，用户需自行验证 URL、磁力链接和种子文件的来源可信度，避免引入恶意软件或侵权内容。
T3 来源维护风险：个人开发者项目可能存在更新延迟、文档过时或长期维护中断的风险。建议关注版本更新，生产环境使用前进行充分的集成测试。
网络连接风险：RPC 请求受网络延迟和 aria2 服务端稳定性影响，配置不当的超时参数可能导致命令执行异常。建议根据实际网络环境调整 timeout 配置。