sayurinana/agent-aide
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
d705a733ee3a2ad7981f9256eda4873ed7fb3996
agent-aide/task-spec.md
sayurinana(vm) ba70fafa15 [aide] finish: 任务完成 
新增环境安装 Commands:
- /aide:install-win - Windows 环境安装命令
- /aide:install-linux - Linux 环境安装命令

新增离线安装程序:
- aide-program/offline-installer/windows/
- aide-program/offline-installer/linux/

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-17 05:22:38 +08:00

4.7 KiB
Raw Blame History

任务细则：环境安装 Command 与离线安装程序

生成时间：2025-12-17 任务来源：task-now.md

任务概述

为 aide 工具创建完整的环境安装解决方案，包括：

  1. Windows 环境安装 Command (/aide:install-win)
  2. Linux 环境安装 Command (/aide:install-linux)
  3. 离线安装程序（支持 Windows 和 Linux）

用户决策记录

决策项 用户选择
离线安装程序 本次一并实现
macOS 支持 不支持（仅 Windows/Linux）
Command 组织 分离命令

需要安装的工具

工具 用途 安装方式
uv Python 包管理器 官方安装脚本
Python aide 运行时 通过 uv python install
Java (JRE) PlantUML 依赖 系统包管理器或 Adoptium

子计划拆分

本任务拆分为 4 个子计划：

子计划 1：Windows 环境安装 Command

目标：创建 /aide:install-win command

产出：

  • aide-marketplace/aide-plugin/commands/install-win.md

功能要求：

  1. 检测当前环境状态（uv、Python、Java）
  2. 对于缺失的工具，提供两种安装模式：
    • 模式 A（自动安装）：生成安装报告，用户确认后执行安装
    • 模式 B（手动指南）：生成 markdown 操作指南 + PowerShell 脚本
  3. 安装完成后验证工具可用性
  4. 指导用户将 aide-program 添加到 PATH

技术要点：

  • uv 安装：irm https://astral.sh/uv/install.ps1 | iex
  • Python 安装：uv python install 3.11
  • Java 安装：winget/scoop 或 Adoptium MSI
  • PATH 配置：修改用户环境变量

子计划 2：Linux 环境安装 Command

目标：创建 /aide:install-linux command

产出：

  • aide-marketplace/aide-plugin/commands/install-linux.md

功能要求：

  1. 检测当前环境状态（uv、Python、Java）
  2. 检测 Linux 发行版（Debian/Ubuntu、RHEL/Fedora、Arch）
  3. 对于缺失的工具，提供两种安装模式：
    • 模式 A（自动安装）：生成安装报告，用户确认后执行安装
    • 模式 B（手动指南）：生成 markdown 操作指南 + Shell 脚本
  4. 安装完成后验证工具可用性
  5. 指导用户将 aide-program 添加到 PATH

技术要点：

  • uv 安装：curl -LsSf https://astral.sh/uv/install.sh | sh
  • Python 安装：uv python install 3.11
  • Java 安装：apt/dnf/pacman 或 Adoptium tarball
  • PATH 配置：修改 ~/.bashrc 或 ~/.zshrc

子计划 3：离线安装程序 - Windows 版

目标：创建 Windows 离线安装程序

产出：

  • aide-program/offline-installer/windows/ 目录
  • install.ps1 - 主安装脚本
  • resources.json - 资源清单
  • README.md - 使用说明

功能要求：

  1. 生成资源清单（下载链接列表）
  2. 用户下载资源到指定目录
  3. 运行安装脚本，从本地文件完成安装
  4. 支持静默安装和交互式安装

资源清单内容：

  • uv 安装包（Windows x64）
  • Python 安装包（通过 uv 管理，可选预下载）
  • Java JRE（Adoptium Temurin）

子计划 4：离线安装程序 - Linux 版

目标：创建 Linux 离线安装程序

产出：

  • aide-program/offline-installer/linux/ 目录
  • install.sh - 主安装脚本
  • resources.json - 资源清单
  • README.md - 使用说明

功能要求：

  1. 生成资源清单（下载链接列表）
  2. 用户下载资源到指定目录
  3. 运行安装脚本，从本地文件完成安装
  4. 支持多种 Linux 发行版

资源清单内容：

  • uv 安装包（Linux x64）
  • Python 安装包（通过 uv 管理，可选预下载）
  • Java JRE（Adoptium Temurin tarball）

执行顺序

子计划 1 (Windows Command)
    ↓
子计划 2 (Linux Command)
    ↓
子计划 3 (Windows 离线安装)
    ↓
子计划 4 (Linux 离线安装)

成功标准

  1. Command 功能验证：

    • 能正确检测环境状态
    • 自动安装模式能成功安装所有工具
    • 手动指南清晰可执行
    • aide 命令在 PATH 中可用

  2. 离线安装验证：

    • 资源清单完整且链接有效
    • 安装脚本能从本地文件完成安装
    • 安装后环境检测通过

风险与缓解

风险 缓解措施
系统权限不足 明确提示所需权限，提供非管理员替代方案
网络环境受限 离线安装程序作为备选
版本兼容性 指定明确的版本要求，提供版本检测
安装失败回滚 记录安装前状态，提供回滚指南

约束条件

  1. 不修改 aide-program 核心代码（仅添加离线安装器目录）
  2. Command 遵循现有 aide-marketplace 格式规范
  3. 所有脚本需包含完整注释
  4. 安装过程需用户确认，不得静默修改系统