Linux人工智能环境配置脚本

Name: Linux人工智能环境配置脚本
Author: tamerkaraca

作者：tamerkaraca17 星标更新：2025-11-14

安装使用来源：spider==github.com

项目介绍

技术文档摘要

🌈 AI 开发环境设置脚本

在 Linux/WSL 和 macOS 上一键启动现代 AI 工作站。交互式菜单、远程安全模块、彩色横幅以及双语指南（英语和土耳其语）。

📚 目录

英文指南
- 概述
- 架构
- 需求
- 安装
- 主菜单参考
- CLI 和框架子菜单
- 使用说明
- 故障排除
- 贡献
- 致谢
- 许可证
土耳其语指南
- 概览
- 架构
- 需求
- 安装
- 主菜单摘要
- 子菜单详情
- 使用说明
- 故障排除
- 贡献
- 致谢
- 许可证

🇬🇧 英文指南

概述

setup 准备在 Linux/WSL 和 macOS 上进行 AI 开发的工作站。它自动检测操作系统和包管理器，解决 Windows 的 CRLF 行尾问题，安装系统依赖项，引导 Python/Node/PHP 堆栈，并提供精选菜单供 AI CLI、AI 框架和辅助工具使用。界面是双语的：默认为英语，当您的区域设置以 tr 开头时自动选择土耳其语，您可以通过菜单选项 L 随时切换语言。

平台支持

Linux/WSL：使用原生包管理器（apt、dnf、yum、pacman）和传统安装方法
macOS：使用 Homebrew 包管理器，优化了 AI 工具的 Cask 和 Formula 安装

架构

组件	描述
自愈启动器	检测 CRLF，在修复权限/行尾后重新运行自身。
远程安全模块	当通过 `bash -c "$(curl …)"` 调用时，`setup` 将帮助模块下载到临时目录并导出帮助函数，使嵌套脚本像本地运行一样操作。
横幅系统	`modules/banner.sh` 现在使用纯 Bash 渲染宽框绘制面板，因此无需安装外部横幅 CLI。
菜单运行器	`run_module` 优先使用本地 `./modules/*.sh`；否则从 GitHub 下载并通过环境变量（如 `PKG_MANAGER`、`INSTALL_CMD` 等）传递给子进程。

需求

暴露 apt、dnf、yum 或 pacman 的 Linux 发行版。
bash 5+，sudo 权限，互联网访问。
curl 或 wget（缺少时会自动安装）。
可选：dos2unix、shellcheck、jq（相关时会自动安装）。

横幅渲染器随仓库一起提供，因此不需要额外的包来打印标题。

安装

1. 快速单行命令（推荐）

bash -c "$(curl -fsSL https://raw.githubusercontent.com/tamerkaraca/linux-ai-setup-script/main/setup)"

或使用 wget：

wget -qO- https://raw.githubusercontent.com/tamerkaraca/linux-ai-setup-script/main/setup | bash

2. 本地克隆

git clone https://github.com/tamerkaraca/linux-ai-setup-script.git
cd linux-ai-setup-script
chmod +x setup
bash -n setup && shellcheck setup  # 可选
./setup

主菜单参考

选项	描述
`1`	更新系统包 + 安装必需项（`curl`、`wget`、`git`、`jq`、`zip`、编译器）。
`2`	安装 Python 工具链：Python 3、Pip、确保 pip 回退、Pipx、UV；自动重新加载 shell RC 文件。
`3`	打开 Node.js 工具子菜单（NVM + Node LTS、Bun、CLI 额外功能）。
`4`	安装 AI CLI 工具（打开子菜单）。
`5`	安装 AI 框架（打开子菜单；处理 Pipx、GLM 提示、tty 安全运行）。
`6`	Git 配置（姓名/邮箱、签名、别名建议）。
`7`	Claude Code 提供者菜单（GLM-4.6 或 Moonshot kimi-k2，带掩码密钥 + 基础 URL 辅助）。
`8`	安装辅助 AI 工具（OpenSpec、代理等）。
`9`	安装 PHP 和 Composer，可选择版本和 Laravel 友好的扩展。
`10`	使用官方仓库密钥安装 GitHub CLI。
`A`	删除所有 AI 框架
`A`	MCP 服务器管理（列出，清理 `~/.gemini`、`~/.qwen`、`~/.claude`）。
`L`	切换界面语言（英语 ↔ 土耳其语，默认自动检测）。
`A`	依次安装所有内容（跳过交互登录，打印摘要）。
`0`	退出。

CLI 和框架子菜单

Node.js 工具子菜单

选项 3 现在打开一个交互式菜单，接受逗号分隔的选择（1,3），并且还暴露了一个 4 快捷方式来运行每个组件。每个选择调用 modules/install_nodejs_tools.sh 下的加固安装程序，因此您可以混合搭配而不必重新运行整个堆栈。

选项	组件	特点
`1`	Node.js 通过 NVM	安装/更新 NVM，刷新 shell RC 文件，并安装最新的 LTS 版本。
`2`	Bun 运行时	运行 Bun 的官方安装程序，将 `~/.bun/bin` 添加到 PATH 中，并显示检测到的版本。
`3`	Node CLI 额外功能	启用 Corepack 并全局安装 `pnpm` + `yarn`，非常适合仓库脚本和 CI。
`4`	安装每个组件	依次执行选项 `1-3`。
`0`	返回主菜单	不做任何更改。

AI CLI 子菜单

子菜单接受逗号分隔的选择（1,3,7）或 14 快捷方式，依次安装每个 CLI。交互式运行会暂停等待登录，而批处理运行会记住缺失的身份验证命令并在摘要中打印它们。

选项	工具	特点
`1`	Claude Code CLI	附加到 `/dev/tty`，即使在远程运行期间，Anthropic 的 Ink 提示也能正常工作。
`2`	Gemini CLI	需要 Node.js ≥ 20，执行 npm 回退安装，并提醒您运行 `gemini auth`。
`3`	OpenCode CLI	处理 OpenCode 测试工具的安全远程安装，并打印 `opencode login` 提示。
`4`	Qoder CLI	探测多个 npm 范围并接受覆盖（`QODER_NPM_PACKAGE`、`QODER_CLI_BUNDLE`、`--skip-probe`）以及本地捆绑安装。
`5`	Qwen CLI	强制 Node.js ≥ 18，当缺少时引导 Node，并使用 `/dev/tty` 对 `qwen login` 提示进行 `--package` 覆盖。
`6`	OpenAI Codex CLI	安装 Codex/Cursor 辅助工具，并指向 ChatGPT 或 `OPENAI_API_KEY` 身份验证流程。
`7`	Cursor Agent CLI	需要 Node.js ≥ 18，通过 npm 安装 `cursor-agent`，并提醒您运行 `cursor-agent login`（交互式运行打开 `/dev/tty`）。
`8`	Cline CLI	需要 Node.js ≥ 18，安装 `@cline/cli` 包，并仅在交互式运行期间提示 `cline login`。
`9`	Aider CLI	使用官方 `aider-install` 脚本进行健壮安装，自动处理 Python 版本和依赖项。
`10`	GitHub Copilot CLI	通过 npm 安装，并打印 `copilot auth login` 和 `copilot auth activate` 提醒。
`11`	Kilocode CLI	安装 `@kilocode/cli`，强制 Node.js ≥ 18，并打印运行 `kilocode config` 以及 architect/debug/auto 模式的提醒。
`12`	Auggie CLI	安装 `@augmentcode/auggie`（Node.js ≥ 22），并引导您完成 `auggie login`、`.augment/commands` 和 CI 友好标志。
`13`	Droid CLI	提供 Factory 的快速入门说明，用于安装 droid CLI（交互终端），并提醒您遵循官方指南。
`14`	安装每个 CLI	在批处理模式下运行选项 `1-13`（跳过登录，最后打印摘要）。

辅助 AI 工具子菜单

此新菜单可通过主菜单中的选项 8 访问，将规范驱动开发工具和代理库组合在一起。

选项	工具	特点
`1`	OpenSpec CLI	全局安装 `@fission-ai/openspec`（Node.js ≥ 18），以便您可以运行 `openspec init/plan/sync`。
`2`	specify-cli	使用 `uv` 从 `spec-kit` 安装 GitHub 的 `specify-cli`。需要已安装 Python 工具。
`3`	Contains Studio Agents	将 Contains Studio 的 `.md` 代理同步到 `~/.claude/agents`（之后重启 Claude Code）。
`4`	Wes Hobson Agents	将 `wshobson/agents` 收集安装到 `~/.claude/agents`（之后重启 Claude Code）。
`A`	安装所有	依次安装所有辅助工具。

AI 框架子菜单

框架菜单确保存在 pipx（如果需要先安装 Python），然后让您单独配置每个 Super* 堆栈或一次性全部配置。每个安装程序将提示通过 /dev/tty 路由，因此即使 setup 通过 curl 管道运行，API 密钥输入也能正常工作。

选项	框架	特点
`1`	SuperGemini	通过 `pipx` 安装原生 Gemini 工作流，包括登录提示和 PATH 刷新。
`2`	SuperQwen	用 `attach_tty_and_run` 包装官方安装程序，因此可以安全地输入 Qwen 凭据。
`3`	SuperClaude	提供 Anthropic 工具包，具有相同的 TTY 保护措施和清理助手。
`4`	安装所有框架	依次安装所有三个框架（重复运行优雅地跳过）。

使用说明

语言切换：默认为英语，当您的区域设置以 tr 开头时自动选择土耳其语，您可以通过菜单选项 L 随时切换语言。
环境重载：对于 pipx、uv、nvm、bun、gh 等的 PATH 更新，追加到 ~/.bashrc、~/.zshrc 和 ~/.profile。脚本自动源代码，以便新命令立即可用。
远程执行：无论您是本地克隆还是通过 curl 管道运行，菜单结构、彩色日志和子模块的行为都相同。
API 密钥：Super* 安装程序引导您通过提供商门户（Gemini、Anthropic、OpenAI）。GLM 配置隐藏现有密钥（abcd***wxyz），只有在提供新值时才替换它们。
TTY 要求：Claude Code、SuperQwen 和 SuperClaude 安装程序现在路由到 /dev/tty，防止基于 Ink 的 CLI 由于“不支持原始模式”而退出。

故障排除

症状	解决方案
`curl: (3) URL rejected: No host part`	确保您使用的是最新版本的 `setup`（≥ `7d4ee0a`）。该脚本现在导出 `SCRIPT_BASE_URL` 并缓存带有完全限定 URL 的模块。
`mask_secret: command not found`	拉取最新更改；GLM 配置现在即使在远程运行中也引用 `modules/utils.sh`。
`SuperQwen 安装` 未提示就中止	通过 `attach_tty_and_run` 修复；重新运行选项 `5` → SuperQwen。
Aider CLI 安装失败	该脚本现在使用更稳健的官方 `aider-install` 脚本。如果仍然失败，请检查安装程序的日志。
安装后 CLI 仍不存在	重新打开终端或运行 `source ~/.bashrc`；确认 `$PATH` 包含 `~/.local/bin` 和 `~/.nvm`。
`pip` 关于外部管理环境的错误	`install_pip` 现在回退到 `ensurepip`、发行版包或 `get-pip.py --break-system-packages`。重新运行选项 `2`。
`file: 命令未找到` 或 `install_specify_cli.sh` 中的语法错误	通过确保 `file` 命令检查和纠正关联数组语法来修复。

贡献

分叉存储库并创建功能分支。
在修改过的脚本上运行 shellcheck 和 bash -n 进行语法检查。确保所有问题都得到解决。
添加菜单或模块时更新 README/本地化文档。
提交 PR，描述动机、受影响的脚本和样本输出（交互流程的截图/日志有助于审阅者）。
对于模块更改，验证本地和远程（bash -c "$(curl …)"）工作流程。

脚本验证

本存储库中的所有脚本均经过以下验证：

语法检查：对所有 shell 脚本使用 bash -n
静态分析：使用 shellcheck 进行最佳实践和安全性检查
行尾规范化：自动将 CRLF 转换为 LF
当前状态：✅ 40 个脚本已验证（39 个模块 + setup）

致谢

维护者：Tamer Karaca (@tamerkaraca)
框架作者：SuperGemini/SuperQwen/SuperClaude 团队，Anthropic，Google，OpenAI，GitHub Copilot CLI 贡献者。

许可证

本项目根据 MIT 许可证 发布。详见 LICENSE。

🇹🇷 土耳其语指南

概览

setup 在 Linux 基础的开发者机器上构建端到端的 AI 环境。自动检测包管理器，修正 CRLF，安装 Python/Node/PHP 生态系统，提供 AI CLI 和框架菜单。界面是双语的：默认为英语，系统语言以 tr 开头时自动选择土耳其语，您可以通过菜单选项 L 随时切换语言。

架构

组件	描述
自愈启动器	检测 CRLF，修复权限/文件问题后重新启动脚本。
远程安全模块	当通过 `bash -c "$(curl …)"` 方法运行时，辅助模块被下载到临时目录并与子过程共享。
横幅系统	`modules/banner.sh` 使用 Bash 直接绘制宽框面板，无需安装额外的 ASCII 工具。
菜单运行器	首先使用本地 `./modules/*.sh` 文件，如果没有则从 GitHub 下载。

需求

包含 apt、dnf、yum 或 pacman 的 Linux 发行版。
bash 5+，sudo 权限，活跃的互联网连接。
curl 或 wget（远程安装时必需）。
横幅面板随仓库一起提供；不需要额外的 ASCII 工具。

安装

1. 单行安装

bash -c "$(curl -fsSL https://raw.githubusercontent.com/tamerkaraca/linux-ai-setup-script/main/setup)"

或使用 wget：

wget -qO- https://raw.githubusercontent.com/tamerkaraca/linux--ai-setup-script/main/setup | bash

2. 本地克隆

git clone https://github.com/tamerkaraca/linux