feat: 一键安装全自动/小白模式、国内镜像修复与常用工具安装

.gitattributes

@@ -0,0 +1,27 @@
+# 统一按 LF 处理换行符。
+#
+# 为什么需要：这个仓库里 core.autocrlf 默认是 false 且此前没有 .gitattributes，
+# git 会原样存盘上的字节。Windows 上某些编辑器保存文件时会顺手改成 CRLF，
+# 于是 `git status` 会把整个仓库都标成已修改——实测一次就是 37 个文件、
+# 5608 行增删，而 `git diff --ignore-all-space` 是空的，一行真实内容都没变。
+# 这会淹没真正的改动，评审也没法看。
+#
+# text=auto 让 git 在计算对象时把换行符归一成 LF，工作区是 CRLF 也不再算差异；
+# eol=lf 保证检出到工作区时也是 LF。
+#
+# 对 install 这个文件尤其重要：它是用户 `source` 执行的 shell 脚本，
+# 跑在 Linux 上，CRLF 会导致 bad interpreter 之类的报错。
+* text=auto eol=lf
+
+# 二进制文件不做任何转换。仓库目前没有二进制文件，
+# 这几行是防止以后加了图片等资源被误转换。
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.svg text eol=lf
+*.zip binary
+*.gz binary
+*.tar binary
+*.deb binary

README.md

@@ -4,18 +4,38 @@
 
 ## 工具列表
 
-已支持工具列表：
+已支持工具列表（方括号里是菜单编号）：
 
-- 一键安装:ROS(支持ROS和ROS2,树莓派Jetson)  [贡献@小鱼](https://github.com/fishros)
-- 一键安装:VsCode(支持amd64和arm64)  [贡献@小鱼](https://github.com/fishros)
-- 一键安装:github桌面版(小鱼常用的github客户端)  [贡献@小鱼](https://github.com/fishros)
-- 一键安装:nodejs开发环境(通过nodejs可以预览小鱼官网噢)  [贡献@小鱼](https://github.com/fishros)
-- 一键配置:rosdep(小鱼的rosdepc,又快又好用)  [贡献@小鱼](https://github.com/fishros)
-- 一键配置:ROS环境(快速更新ROS环境设置,自动生成环境选择)  [贡献@小鱼](https://github.com/fishros)
-- 一键配置:系统源(更换系统源,支持全版本Ubuntu系统)  [贡献@小鱼](https://github.com/fishros)
-- 一键安装:Docker(支持amd64和arm64)  [贡献@alyssa](https://github.com/alyssa1024)
-- 一键安装:cartographer 贡献 [@小鱼](https://github.com/fishros) & [@Catalpa](https://github.com/Y-zi)
-- 一键安装:微信客户端  [贡献@小鱼](https://github.com/fishros)
+**ROS安装**
+- [1] 一键安装(推荐):ROS(小白/高手两种模式,自动识别系统并换源,支持ROS1/ROS2/树莓派/Jetson)  [贡献@小鱼](https://github.com/fishros)
+- [11] 一键安装:ROS Docker版(支持所有版本ROS/ROS2,系统版本不匹配时使用)
+- [16] 一键安装:系统自带ROS(仅供特殊情况下使用)
+
+**ROS开发工具**
+- [4] 一键配置:ROS环境(快速更新ROS环境设置,自动生成环境选择,修复中文路径编译报错)  [贡献@小鱼](https://github.com/fishros)
+- [3] 一键安装:rosdepc(小鱼的国内版rosdep,又快又好用)  [贡献@小鱼](https://github.com/fishros)
+- [22] 一键安装:ROS常用功能包(导航Nav2/建图slam_toolbox、Cartographer/键盘、手柄遥控等)
+- [9] 一键安装:Cartographer(仅支持ROS1:Ubuntu16/18/20)  贡献 [@小鱼](https://github.com/fishros) & [@Catalpa](https://github.com/Y-zi)
+- [12] 一键安装:MicroROS开发环境(PlatformIO,支持FishBot)
+
+**换源与网络**
+- [5] 一键配置:系统源(更换国内源,支持Ubuntu/Debian全版本)  [贡献@小鱼](https://github.com/fishros)
+- [13] 一键配置:Python国内源
+- [17] 一键配置:Docker代理(支持VPN+代理服务两种模式)
+- [14] 一键安装:科学上网代理工具
+
+**开发工具**
+- [7] 一键安装:VSCode(支持amd64和arm64)  [贡献@小鱼](https://github.com/fishros)
+- [8] 一键安装:Docker(支持amd64和arm64)  [贡献@alyssa](https://github.com/alyssa1024)
+- [6] 一键安装:Node.js开发环境  [贡献@小鱼](https://github.com/fishros)
+- [2] 一键安装:GitHub桌面版(小鱼常用的GitHub客户端)  [贡献@小鱼](https://github.com/fishros)
+- [18] 一键安装/卸载:OpenCode(AI编程助手)
+
+**日常软件**
+- [10] 一键安装:微信客户端  [贡献@小鱼](https://github.com/fishros)
+- [15] 一键安装:QQ for Linux
+
+> 菜单编号固定不变（自动化配置按编号选择），新增工具只会用新编号。
 
 
 
@@ -24,6 +44,23 @@
 source <(wget -qO- http://fishros.com/install)
 ```
 
+装 ROS 在菜单里输入 `1`，接着选安装模式：不知道怎么选的选 `1` 小白模式，确认后脚本会自动识别系统、
+测速换源、挑选可用的镜像和对应的 ROS 版本，中途不用再做选择，装完会列出替你选了什么；
+想自己指定镜像源和版本的选 `2` 高手模式。
+
+### 用自己的服务器测试新版本
+
+把仓库文件放到任意 HTTP 服务器上，把 `install` 第一行改成你的地址，然后在测试机上运行即可，
+后续所有工具脚本都会从这个地址下载：
+
+```
+# 服务器上(仓库目录内)
+sed -i "1s#.*#export FISHROS_URL=http://<服务器IP>:8080/#" install
+python3 -m http.server 8080
+# 测试机上
+wget http://<服务器IP>:8080/install -O fishros && . fishros
+```
+
 ## 如何自动选择(Dockerfile中使用)
 
 目前一键安装支持从配置文件自动输入选项，你需要手动运行一次一键安装，使用完毕后会自动产生 `/tmp/fish_install.yaml`。

docs/_sidebar.md

@@ -1,3 +1,3 @@
-- [一键安装](./README.md)
-- 高效工具
+- [一键安装](./README.md)
+- 高效工具
     - [Md编辑器Typora](./install/Typora.md)

install

@@ -1,15 +1,29 @@
 export FISHROS_URL=http://mirror.fishros.com/install/
 
+SUDO=''
+if [ "$(id -u)" -ne 0 ];then
+    SUDO='sudo'
+fi
+
+# 上次运行被中断时 /tmp/fishinstall 会残留且属主是 root, 普通用户再下载会因权限不足静默失败,
+# 结果要么没有菜单直接退出, 要么跑的是旧脚本, 所以每次先清掉
+$SUDO rm -rf /tmp/fishinstall/
 mkdir -p /tmp/fishinstall/tools/translation/assets
-wget $FISHROS_URL/install.py -O /tmp/fishinstall/install.py 2>>/dev/null 
+# 与 install.py 里其它下载保持一致不校验证书: 老系统证书库过旧、树莓派等开机时钟不准时, 服务器跳转到 https 也能下载
+wget -q -T 15 -t 3 --no-check-certificate $FISHROS_URL/install.py -O /tmp/fishinstall/install.py
 source /etc/profile
 
-SUDO=''
-if [ $UID -ne 0 ];then
-    SUDO='sudo'
+if [ -s /tmp/fishinstall/install.py ]; then
+    # 已经能导入就不再跑 apt: 每次都要读软件包列表(约 1s), 系统自动更新占着 apt 锁时还会卡住
+    if ! python3 -c "import distro, yaml" 2> /dev/null; then
+        $SUDO apt install python3-distro python3-yaml -y
+    fi
+    # sudo 默认会清掉环境变量, 显式把 FISHROS_URL 传进去, 否则后续工具一律从默认地址下载(自建服务器测试时会拿到旧版)
+    $SUDO env FISHROS_URL="$FISHROS_URL" python3 /tmp/fishinstall/install.py
+else
+    echo "下载一键安装脚本失败: ${FISHROS_URL}install.py"
+    echo "请检查网络后重试(能否打开 ${FISHROS_URL}install.py)"
 fi
-$SUDO apt install python3-distro python3-yaml -y
-$SUDO python3 /tmp/fishinstall/install.py
 $SUDO rm -rf /tmp/fishinstall/
 
 if [ -f fishros ]; then