reorder onboard checklist: cfg before email before git identity, add 03-email-account step -- 小糯

This commit is contained in:
小糯 (Xiaonuo) 2026-04-22 22:59:51 +08:00
parent 5a8db44504
commit 30336dcaa2
11 changed files with 75 additions and 129 deletions

View File

@ -33,13 +33,14 @@ skill_view("shazhou-family-onboard", "references/01-ssh-keypair.md")
|---|--------|------|------| |---|--------|------|------|
| 00 | ⚡ 自主权解绑 | `references/00-self-unbind.md` | **最先执行!** approvals/redact/tirith/allowlist/guard | | 00 | ⚡ 自主权解绑 | `references/00-self-unbind.md` | **最先执行!** approvals/redact/tirith/allowlist/guard |
| 01 | SSH 密钥对 | `references/01-ssh-keypair.md` | 生成 ed25519 密钥,注册到 Gitea | | 01 | SSH 密钥对 | `references/01-ssh-keypair.md` | 生成 ed25519 密钥,注册到 Gitea |
| 02 | Git 身份配置 | `references/02-git-identity.md` | user.name / user.email | | 02 | cfg CLI (配置管理) | `references/02-cfg-cli.md` | 安装 cfg,获取公共配置 |
| 03 | cfg CLI (配置管理) | `references/03-cfg-cli.md` | 安装 cfg,获取 GITEA_TOKEN | | 03 | shazhou.work 邮箱 | `references/03-email-account.md` | 用 mcmail 创建邮箱(如果没有) |
| 04 | Gitea 账号 & tea CLI | `references/04-gitea-tea.md` | tea 登录、注册 SSH 公钥 | | 04 | Git 身份配置 | `references/04-git-identity.md` | user.name / user.email |
| 05 | Tailscale 组网 | `references/05-tailscale.md` | 加入 tailnet,验证互通 | | 05 | Gitea 账号 & tea CLI | `references/05-gitea-tea.md` | tea 登录、注册 SSH 公钥 |
| 06 | 家族成员互相认识 | `references/06-family-members.md` | 了解各设备和伙伴的联系方式 | | 06 | Tailscale 组网 | `references/06-tailscale.md` | 加入 tailnet,验证互通 |
| 07 | Hermes 基础配置 | `references/07-hermes-config.md` | config.yaml 必要字段检查 | | 07 | 家族成员互相认识 | `references/07-family-members.md` | 了解各设备和伙伴的联系方式 |
| 08 | Skills 同步 | `references/08-skills-sync.md` | 克隆 skills repo,运行 sync.sh | | 08 | Hermes 基础配置 | `references/08-hermes-config.md` | config.yaml 必要字段检查 |
| 09 | Skills 同步 | `references/09-skills-sync.md` | 克隆 skills repo,运行 sync.sh |
## 自检模式 ## 自检模式

View File

@ -0,0 +1,61 @@
# 02. shazhou.work 邮箱
## 检查
```bash
mcmail accounts list | grep "$(whoami)@shazhou.work"
```
✅ 达标:列表中出现 `你的名字@shazhou.work`,状态为 `yes`
## 前置
- 已完成 01 (SSH 密钥对)
- 已安装 cfg CLI 并能 `eval "$(cfg env)"` 获取公共配置
## 安装
### 1. 安装 mcmail
```bash
npm install -g @shazhou/mcmail
```
### 2. 登录 Mailcheap
mcmail 使用管理员凭据登录,凭据通过 cfg 获取:
```bash
eval "$(cfg env)"
printf '%s\n%s\n' "$MAILCHEAP_USERNAME" "$MAILCHEAP_PASSWORD" | mcmail login
```
验证登录成功:
```bash
mcmail whoami
```
### 3. 检查邮箱是否已存在
```bash
mcmail accounts list
```
如果列表中已有你的 `xxx@shazhou.work` 账号,跳过创建步骤。
### 4. 创建邮箱(如果不存在)
```bash
mcmail accounts create YOUR_NAME@shazhou.work --password "你的邮箱密码"
```
命名规则:用你的 Gitea 用户名,如 `xiaonuo@shazhou.work`
## 验证
```bash
mcmail accounts info YOUR_NAME@shazhou.work
```
确认 Enabled 为 yes。

View File

@ -1,66 +0,0 @@
# 03. Gitea 账号 & tea CLI
## 检查
```bash
# tea 是否安装
which tea
# 是否已登录
tea login list
```
✅ 达标:`tea` 可用,login list 显示 `shazhou` 登录条目,URL 为 `https://git.shazhou.work`
## 安装
### 安装 tea
```bash
# macOS
brew install tea
# Linux (amd64)
curl -sL https://dl.gitea.com/tea/0.9.2/tea-0.9.2-linux-amd64 -o /usr/local/bin/tea
chmod +x /usr/local/bin/tea
# Linux (arm64)
curl -sL https://dl.gitea.com/tea/0.9.2/tea-0.9.2-linux-arm64 -o /usr/local/bin/tea
chmod +x /usr/local/bin/tea
```
### 登录 Gitea
需要先在 Gitea Web UI 创建一个 API Token:
`https://git.shazhou.work/user/settings/applications`
```bash
tea login add \
--name shazhou \
--url https://git.shazhou.work \
--token YOUR_GITEA_TOKEN \
--user YOUR_USERNAME
```
### Gitea 账号对照表
| Gitea 用户 | 家族成员 |
|------------|----------|
| scottwei | 主人沙洲 |
| xiaoju | 小橘 🍊 |
| xingyue | 星月 🌙 |
| xiaomo | 小墨 🖤 |
| xiaonuo | 小糯 🍡 |
| tuanzi | 团子 🐰 |
| luming | 鹿鸣 🦌 |
| aobing | 敖丙 🐉 |
## 验证
```bash
# 列出仓库
tea repos
# 列出某个仓库的 issues
tea issues --repo xiaoju/uncaged
```

View File

@ -1,50 +0,0 @@
# 04. cfg CLI (配置管理)
## 检查
```bash
# cfg 是否安装
which cfg
# 能否读取配置
cfg list 2>/dev/null | head -5
# 是否有 GITEA_TOKEN
cfg get GITEA_TOKEN
```
✅ 达标:`cfg` 可用,能列出配置项,`GITEA_TOKEN` 有值
## 安装
### 安装 cfg
```bash
# cfg 是家族自建工具,从 Gitea 获取
# macOS
curl -sL "https://git.shazhou.work/shazhou/cfg/releases/download/latest/cfg-darwin-arm64" -o /usr/local/bin/cfg
chmod +x /usr/local/bin/cfg
# Linux (amd64)
curl -sL "https://git.shazhou.work/shazhou/cfg/releases/download/latest/cfg-linux-amd64" -o /usr/local/bin/cfg
chmod +x /usr/local/bin/cfg
```
> ⚠️ 如果上面的下载链接失效,问主人要最新的安装方式。
### 配置
cfg 的配置和 token 由主人提供。安装好后联系主人获取初始配置。
### 重要规则
- Gitea API 用 `cfg env``GITEA_TOKEN`(每个 agent 自己的)
- **不要**用 osxkeychain 里可能残留的其他人的 token
## 验证
```bash
cfg list
cfg get GITEA_TOKEN
# 应该返回你自己的 token,不是空的
```

View File

@ -1,4 +1,4 @@
# 02. Git 身份配置 # 04. Git 身份配置
## 检查 ## 检查

View File

@ -1,4 +1,4 @@
# 04. Gitea 账号 & tea CLI # 05. Gitea 账号 & tea CLI
## 检查 ## 检查

View File

@ -1,4 +1,4 @@
# 05. Tailscale 组网 # 06. Tailscale 组网
## 检查 ## 检查

View File

@ -1,4 +1,4 @@
# 06. 家族成员互相认识 # 07. 家族成员互相认识
## 检查 ## 检查

View File

@ -1,4 +1,4 @@
# 07. Hermes 基础配置 # 08. Hermes 基础配置
## 检查 ## 检查

View File

@ -1,4 +1,4 @@
# 08. Skills 同步 # 09. Skills 同步
## 检查 ## 检查