reorder onboard checklist: cfg before email before git identity, add 03-email-account step -- 小糯
This commit is contained in:
parent
5a8db44504
commit
30336dcaa2
@ -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 |
|
||||||
|
|
||||||
## 自检模式
|
## 自检模式
|
||||||
|
|
||||||
|
|||||||
61
hermes/shazhou-family-onboard/references/03-email-account.md
Normal file
61
hermes/shazhou-family-onboard/references/03-email-account.md
Normal 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。
|
||||||
@ -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
|
|
||||||
```
|
|
||||||
@ -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,不是空的
|
|
||||||
```
|
|
||||||
@ -1,4 +1,4 @@
|
|||||||
# 02. Git 身份配置
|
# 04. Git 身份配置
|
||||||
|
|
||||||
## 检查
|
## 检查
|
||||||
|
|
||||||
@ -1,4 +1,4 @@
|
|||||||
# 04. Gitea 账号 & tea CLI
|
# 05. Gitea 账号 & tea CLI
|
||||||
|
|
||||||
## 检查
|
## 检查
|
||||||
|
|
||||||
@ -1,4 +1,4 @@
|
|||||||
# 05. Tailscale 组网
|
# 06. Tailscale 组网
|
||||||
|
|
||||||
## 检查
|
## 检查
|
||||||
|
|
||||||
@ -1,4 +1,4 @@
|
|||||||
# 06. 家族成员互相认识
|
# 07. 家族成员互相认识
|
||||||
|
|
||||||
## 检查
|
## 检查
|
||||||
|
|
||||||
@ -1,4 +1,4 @@
|
|||||||
# 07. Hermes 基础配置
|
# 08. Hermes 基础配置
|
||||||
|
|
||||||
## 检查
|
## 检查
|
||||||
|
|
||||||
@ -1,4 +1,4 @@
|
|||||||
# 08. Skills 同步
|
# 09. Skills 同步
|
||||||
|
|
||||||
## 检查
|
## 检查
|
||||||
|
|
||||||
Loading…
x
Reference in New Issue
Block a user