CNB 远程开发默认环境 - 基于 Debian 12 + code-server

远程开发默认环境镜像，基于 Debian 12，集成 code-server（浏览器版 VS Code）、常用开发工具与优化配置，专为 CNB 在线开发优化。

• 镜像名称: docker.cnb.cool/xzydm/example/default-dev-env:latest
• 基础镜像: cnbcool/default-build-env:latest
• 操作系统: Debian 12 (bookworm)
• 软件源: 腾讯云 APT 源
• 默认 Shell: Zsh (Oh My Zsh + 插件)
• 字符编码: LANG=C.UTF-8、LANGUAGE=C.UTF-8

已预装 13 款常用扩展，满足多场景开发需求：

• ms-azuretools.vscode-docker：Docker 容器管理与语法支持
• redhat.vscode-yaml：YAML 语法高亮、校验与自动补全（支持 Kubernetes/CI 配置）
• tencent-cloud.coding-copilot@3.3.6041600：腾讯云 Coding Copilot AI 辅助编程（固定版本）
• waderyan.gitblame：在代码行旁显示 Git 提交人、时间与备注（Git Blame）
• dbaeumer.vscode-eslint：ESLint 代码检查与自动修复（前端开发必备）
• mhutchie.git-graph：图形化展示 Git 分支历史与合并关系
• donjayamanne.githistory：查看文件的 Git 版本历史、对比不同版本差异
• cnbcool.cnb-welcome：CNB 平台专属欢迎页与引导
• ms-ceintl.vscode-language-pack-zh-hans：VS Code 中文（简体）语言包
• ultram4rine.vscode-choosealicense：快速选择并生成开源许可证文件（如 MIT、Apache）
• cloudstudio.live-server：启动本地开发服务器，支持浏览器实时刷新（前端预览）
• esbenp.prettier-vscode：Prettier 代码格式化工具（支持多语言统一风格）

• 网络诊断: iputils-ping（ping 命令）、net-tools（ifconfig/route）、dnsutils（nslookup/dig）、openssh-server（SSH 服务）
• 系统监控: nload（网络流量监控）、htop（进程管理与资源监控）、lsof（查看进程打开的文件）
• 文本编辑: vim（高级编辑器）、nano（简易编辑器）
• 下载与解压: wget（文件下载）、unzip（解压 ZIP 文件）
• 包管理: apt（Debian 官方包管理器，已更新并清理缓存）

• Python 生态: uv（0.8.22 版本，超快 Python 包管理器，安装路径 /usr/local/bin）
• 版本控制: git（含自定义 /root/.gitconfig 配置）
• Shell 优化:
  • 基础：zsh（默认 Shell）+ Oh My Zsh（Shell 框架）
  • 插件：
    • zsh-users/zsh-autosuggestions：命令输入时自动提示（基于历史记录）
    • zsh-users/zsh-syntax-highlighting：命令行语法高亮（错误命令标红、关键字标色）
  • 自定义配置：
    • .zshrc 中添加 setopt NO_AUTO_REMOVE_SLASH（保留路径末尾斜杠）
    • 启动时自动 source /etc/profile（加载系统环境变量）
    • 通过 ./scripts/add-zsh-plugins.sh 自动启用插件
    • 通过 ./scripts/set-zsh-env.sh 配置 Zsh 环境

• VS Code 配置:
  • /root/.vscode-server/data/Machine/settings.json（code-server 配置）
  • /root/.local/share/code-server/Machine/settings.json（备用配置路径）
• CNB 工具脚本:
  • /bin/cnb-init-from：CNB 项目初始化脚本
  • /bin/cnb-init-from-without-lfs：无 LFS 模式的 CNB 项目初始化脚本
• 辅助脚本:
  • ./scripts/add-zsh-plugins.sh：Zsh 插件启用脚本
  • ./scripts/set-zsh-env.sh：Zsh 环境变量配置脚本
  • /tmp/create_languagepacks：语言包生成脚本（执行后自动删除）

在项目根目录创建 .cnb.yml 配置文件，指定使用该镜像：

main:
  vscode:
    - docker:
        image: docker.cnb.cool/xzydm/example/default-dev-env:latest
      services:
        - vscode
        - docker

提交配置后，CNB 平台会自动拉取镜像并启动远程开发环境，直接在浏览器中打开 VS Code 即可使用。

# 1. 拉取镜像（若远程仓库需要认证，需先执行 docker login）
docker pull docker.cnb.cool/xzydm/example/default-dev-env:latest

# 2. 启动容器（映射 code-server 默认端口 8080，可根据需求修改）
docker run -it \
  --name cnb-dev-env \
  -p 8080:8080 \
  docker.cnb.cool/xzydm/example/default-dev-env:latest

# 3. 访问 code-server
# 打开浏览器，输入 http://localhost:8080，按提示完成初始化即可使用

1. 开箱即用: 预装前端、Python 开发必备工具，无需手动安装基础依赖
2. CNB 深度适配: 集成 CNB 专属插件（cnbcool.cnb-welcome）与初始化脚本，无缝对接平台功能
3. 性能优化: 使用 uv 替代传统 pip，Python 依赖安装速度提升 10-100 倍；apt 操作后清理缓存，减少镜像体积
4. 开发体验优化: Zsh + Oh My Zsh 提升命令行效率，VS Code 中文界面降低使用门槛
5. 可扩展性: 支持通过修改 settings.json 自定义 VS Code 配置，通过 apt/uv/npm 安装额外工具

本镜像及配套代码基于 MIT 许可证 开源，允许自由使用、修改与分发，需保留原版权声明。详细条款见项目根目录的 LICENSE 文件。

1. 镜像中 openssh-server 默认未启动，若需使用 SSH 连接，需手动执行 service ssh start
2. 若需修改 VS Code 配置，建议直接在界面中操作（配置会自动同步到 settings.json）
3. 如需安装额外系统工具，可执行 apt update && apt install -y [工具名]（如 apt install -y jq）
4. Zsh 插件若需升级，可执行 git -C ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions pull（同理升级 zsh-syntax-highlighting）