# toolchain

**Repository Path**: alexlyg/toolchain

## Basic Information

- **Project Name**: toolchain
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-08
- **Last Updated**: 2026-05-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# toolchain

Ubuntu / ROS 开发环境一键配置工具集。面向新机重装、虚拟机迁移、实验室机器批量初始化等场景，用脚本完成常用软件安装、开发库管理、网络与代理、Docker/ROS 环境等重复性工作。

适用系统：**Ubuntu 20.04 / 22.04**（amd64），部分脚本依赖 `apt`、`wget`、`curl`。

---

## 工程结构

```
toolchain/
├── software/          # 桌面与开发工具 deb 安装/卸载（多下载源）
├── libdll/            # C++/Python 开发库（Eigen、OpenCV、PCL、Ceres、g2o 等）
├── prox/              # 终端 HTTP/SOCKS 代理开关（配合 Clash 7890 端口）
├── anaconda/          # Miniconda / Anaconda 安装与常用命令说明
├── docker/            # Docker 镜像构建与容器运行（含 ROS 开发环境）
├── yx-ros/            # ROS 相关启动脚本
├── netfix/            # 网络检测与自动修复（VMware 等环境）
├── sysdiag/           # 系统硬件/服务全面诊断
├── easyconnect/       # EasyConnect VPN 安装与网络修复
├── chinaese/          # 中文输入法配置
└── gitlab/            # GitLab 令牌认证说明
```

---

## 快速开始

> 需要 root 的脚本请进入对应目录后执行 **`sudo ./脚本名`**。  
> 不要写 `sudo software.sh`（当前目录不在 PATH 里，会报 command not found）。

### 1. 常用软件（software）

安装/卸载：飞书、Chrome、WPS、ToDesk、钉钉、Cursor、VS Code、Clash for Windows 等。  
支持多镜像依次下载、安装前环境检查；Cursor/VS Code 走官方 APT 源可升级。

```bash
cd ~/source/toolchain/software
sudo ./software.sh
```

### 2. 开发库（libdll）

安装/升级/卸载：Eigen、OpenCV、PCL、Python、SO3(Sophus)、Ceres、g2o、CGAL、SuiteSparse 等。  
安装前会检查 Ubuntu 版本与已装版本，并列出 apt 可选版本。

```bash
cd ~/source/toolchain/libdll
sudo ./libs.sh
```

### 3. 终端代理（prox）

配合 Clash for Windows（mixed-port 默认 **7890**）为当前 shell 设置/取消 `http_proxy` 等环境变量。

```bash
cd ~/source/toolchain/prox
source ./proxy_on.sh    # 开启（必须 source，不要 ./proxy_on.sh）
source ./proxy_off.sh   # 关闭
```

### 4. Conda（anaconda）

交互式安装 Miniconda / Anaconda，可选清华镜像；脚本内含 conda 常用命令速查。

```bash
cd ~/source/toolchain/anaconda
bash ./install_conda.sh
```

### 5. 其它工具

| 模块 | 说明 | 示例命令 |
|------|------|----------|
| netfix | 网卡/DNS/网关检测与修复 | `sudo ./netfix.sh` |
| sysdiag | CPU/内存/磁盘/网络/GPU 等系统诊断 | `./sysdiag.sh`（见 sysdiag/README.md） |
| docker | 构建与运行开发容器 | 见 docker/README.md、docker/QUICK_START.md |
| easyconnect | VPN 客户端安装与排障 | 见 easyconnect/QUICK_START.md |
| chinaese | fcitx 等中文输入法 | `./setup_chinese_input.sh` |

---

## 典型使用流程

1. **新系统**：`netfix` 或 `sysdiag` 确认网络与硬件 → `software` 装浏览器/编辑器/Clash → `prox` 开代理（如需）→ `libdll` 装开发库 → `anaconda` 装 Python 环境（可选）。
2. **ROS 开发**：`docker` 构建镜像，或本机 `libdll` + 系统 ROS，配合 `yx-ros/run.sh`。
3. **下载失败**：先 `source prox/proxy_on.sh`，再重试对应安装脚本。

---

## 注意事项

- 脚本会修改系统包（`apt install`）、`~/.bashrc`（代理/conda）、`~/.config/clash`（Clash 订阅）等，请在可信环境使用。
- WPS、飞书等大安装包下载较慢，脚本内已配置超时与多源重试。
- Clash 订阅链接在 `software.sh` 中可配置；已有 Clash 配置时不会覆盖 `profiles/list.yml`，需手动在客户端添加订阅。
- 各子目录可能有独立 `README.md`，细节以子文档为准。

---

## 参与贡献

1. Fork 本仓库  
2. 新建功能分支  
3. 提交变更  
4. 发起 Pull Request  

欢迎补充下载源、新软件项或对新 Ubuntu 版本的适配。