# init

**Repository Path**: ly525/init

## Basic Information

- **Project Name**: init
- **Description**: 各种初始化类内容，for human，more for ai agent
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-06
- **Last Updated**: 2026-09-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# dotfiles — Lambert 的 Mac 配置仓库

新电脑一键复装 + 日常配置版本管理。所有改配置的操作都在本仓库做，改动自动同步到 home 目录（软链）。

> 本项目也设计为**交给 AI IDE（workbuddy / CodeBuddy 等）打开**，由其参考 `AGENTS.md`
> 来协助编排电脑初始化流程——而不是依赖某个「一键脚本」跑完一切。

## 仓库内容

| 文件 | 作用 | 是否入库 |
|---|---|---|
| `brew/Brewfile` | Homebrew 公式 + Cask 清单（21 cask + 16 formula） | ✅ |
| `init-my-new-mac.md` | **给 AI 的主指令**：新 Mac 初始化全流程（无脚本，AI 按自然语言执行） | ✅ |
| `zsh/.zshrc` | Shell 主配置（已做无损修复：compinit 语法、openssl@3、镜像合并） | ✅ |
| `zsh/.zsh_aliases` | 常用 alias（proxy / grep2 / delete_node_modules / ti 等） | ✅ |
| `git/.gitconfig` | Git 全局配置 | ✅（含 email，仓库务必 private） |
| `node/.npmrc.template` | npm 镜像配置**脱敏模板**（键值部分；鉴权行放 `NPMRC-TOKENS.md`） | ✅ |
| `NPMRC-TOKENS.md` | 需手动补充的 8 行：`//` 开头的 3 行 scope 配置 + 5 处 token 占位说明 | ✅ |
| `~/.npmrc` | 真实配置（含明文 token） | ❌ gitignore |
| `.config/` | Clash 代理配置等暂存副本 | ❌ gitignore（含凭据 + 5MB 二进制） |
| `.oh-my-zsh/` | omz 默认脚手架 | ❌ gitignore（安装后自动生成） |

## 新电脑复装

### 第 0 步：安装 Homebrew（国内必须走镜像）

官方安装脚本在 `raw.githubusercontent.com`，国内常不可达（实测 HTTP 000），改用 CDN 上的同一份脚本：

```bash
/bin/bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/Homebrew/install@HEAD/install.sh)"
```

装完后把仓库源与预编译包（bottle）切到阿里云（`zsh/.zshrc` 里已自带这几个变量，source 后自动生效）：

```bash
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.aliyun.com/homebrew/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.aliyun.com/homebrew/homebrew-core.git"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.aliyun.com/homebrew/homebrew-bottles"
```

### 第 1 步：配置 + 应用

```bash
git clone <你的私有仓库地址> ~/dotfiles
cd ~/dotfiles
# 软链配置 / 生成 ~/.npmrc / 装 nvm / brew bundle 等，全部交给 AI 按 init-my-new-mac.md 执行，无需脚本
```

### 第 2 步：Node / 包管理器 / 手动项

```bash
source ~/.zshrc
nvm install 16 && nvm install 18 && nvm install 22
curl -fsSL https://get.pnpm.io/install.sh | sh -   # pnpm（走独立二进制，不绑 nvm）
corepack enable                                     # yarn
```

> **关于 nvm**：本仓库**不用** `brew install nvm`。一是 brew caveats 原话写明 upstream 不支持 brew 管理 nvm；二是 brew 版 `nvm.sh` 在 `$HOMEBREW_PREFIX/opt/nvm/`，而 `zsh/.zshrc` 的 `NVM_DIR` 指向 `~/.nvm`，两者不一致会让 nvm **静默失效**。且 **`brew install nvm` 不会帮你写 shell 配置**，那三行必须自己加 —— 本仓库 `zsh/.zshrc` 里已有（`$HOME` 写法，可移植）。

**手动 DMG 安装**（无官方 cask，不进 Brewfile）：
`qoder` / `workbuddy` / `ishot` / `wps-office` / `clashx` / `omnidisk-sweeper`

## 日常使用

配置文件已软链到 home，直接改仓库文件即可：

```bash
vim ~/dotfiles/zsh/.zsh_aliases    # 改完 source ~/.zshrc 生效
cd ~/dotfiles && git add -A && git commit -m "..."
```

## ⚠️ 安全须知

- **仓库必须设为 private**：`git/.gitconfig` 含 email，`node/.npmrc.template` 虽已脱敏但结构暴露
- `~/.npmrc` **不入库**，含 5 处明文 `_authToken`，初始化时由 `node/.npmrc.template` 复制生成并设为权限 `600`，建议定期轮换
- `.config/clash/` 含代理服务器信息，不入库

## 当前机器已做的处理

- `zsh/.zshrc` 无损修复：第 152 行 `compinit -u` 与 `export` 语法粘连拆开、openssl@1.1 → @3、清理失效 autojump 引用、brew 镜像统一阿里云
- 原 `~/.zshrc`、`~/.gitconfig` 已备份为 `*.bak.<时间戳>` 后替换为软链
- `.npmrc` 保持为真实文件（非软链），未被改动