（1385期）aria2-json-rpc – 自然语言操控的下载管理中枢

自然语言操控的下载管理中枢 基于 aria2 的 JSON-RPC 客户端，通过自然语言命令管理下载任务，支持 HTTP/FTP/磁力链/种子等多种协议，MIT 开源授权。 使用说明 核心用法 aria2-json-rpc 是一个面向 AI Agent 的 aria2 下载管理器控制技能，通过封装 JSON-RPC 2.0 协议，让用户能够以自然语言指令操控下载任务。核心工作流分为三步：首先通过 configloader.py test 检测配置状态，若未就绪则引导用户初始化配置（推荐 --user 模式以持久化保存），最后通过 rpcclient.py 执行具体的 aria2 操作。 该技能支持完整的下载生命周期管理：添加任务（aria2.addUri）、状态查询（aria2.tellStatus/tellActive）、任务控制（pause/unpause/remove）以及全局统计（getGlobalStat）。特别支持种子文件和磁力链下载，并提供 WebSocket 实时监听作为可选功能。 显著优点 自然语言交互：内置命令映射器，将"下载这个文件""暂停所有任务"等口语化指令自动转换为精确的 RPC 调用，大幅降低使用门槛。 配置管理智能：采用四级配置优先级（环境变量 > 项目配置 > 用户配置 > 默认值），--user 模式确保技能更新后配置不丢失，兼顾灵活性与持久性。 安全设计到位：敏感信息（RPC Secret）在显示时自动脱敏为 ******；支持 HTTPS 加密通信和 Token 认证；所有文件操作均使用标准库，无危险函数。 依赖极简：核心功能仅依赖 Python 3.6+ 标准库（urllib、json、os），WebSocket 为可选依赖，部署成本极低。 文档完善：提供执行指南、方法参考、故障排查三层文档体系，AI Agent 可按图索骥完成复杂操作。 潜在缺点与局限性 前置依赖较重：必须自行部署并配置 aria2 服务端（RPC 模式），技能本身仅为客户端，无法独立工作。对无运维经验的用户存在门槛。 路径验证不足：用户提供的种子文件路径仅做 os.path.isfile 基础检查，缺乏严格的目录遍历防护，存在潜在的文件越界读取风险。 权限管理粗放：初始化配置时未自动设置文件权限（如 600），依赖用户手动执行 chmod，可能导致敏感配置泄露。 错误处理依赖服务端：所有业务逻辑错误（如无效 URL、磁盘空间不足）均来自 aria2 服务端返回，技能层仅做透传，调试体验受限于服务端配置。 WebSocket 功能受限：实时监听功能需要额外安装 websockets 库，且对 Python 版本有匹配要求，部分环境可能无法启用。 适合的目标群体 NAS/服务器用户：已在设备上部署 aria2，希望通过自然语言快速管理下载任务 自动化工作流开发者：需要将下载能力集成到 AI Agent 或自动化脚本中 技术爱好者：熟悉 aria2 生态，追求更优雅的交互方式而非手动构造 RPC 请求 多设备同步用户：利用用户级配置实现跨项目、跨会话的持久化设置 使用风险 网络暴露风险：若 aria2 服务端配置不当（如监听 0.0.0.0 且无 Secret），配合此技能可能导致未授权下载控制，建议严格限制 RPC 监听地址。 配置泄露风险：~/.config/aria2-skill/config.json 默认权限依赖 umask，在多用户环境可能可读，需手动加固。 依赖项版本冲突：WebSocket 功能对 websockets 库版本敏感，与某些 Python 环境可能存在兼容性问题。 下载内容合规性：技能本身不审查下载内容，用户需自行确保种子/磁力链来源合法，避免版权或法律风险。 原始说明 Interact with aria2 download manager via JSON-RPC 2.0. Manage downloads, query status, and control tasks through natural language commands. Use when working with aria2, download management, or torrent operations.