Xiang's Blog

Claude Code 使用指南

Thu, 07 May 2026 00:00:00 +0000

一、安装与启动

# 安装
npm install -g @anthropic-ai/claude-code

# 基本用法
claude                    # 进入交互式会话
claude "帮我审查这个 PR"   # 单次任务
claude -p "解释这个函数"   # 非交互模式，直接输出到 stdout
claude -n <名称>          # 命名当前会话，方便后续查找
claude --worktree         # 在隔离 git worktree 中启动

二、会话管理

会话以 JSONL 文件存储在 ~/.claude/projects/ 下，每个会话拥有独立的上下文窗口。

2.1 终端命令

操作	命令
恢复最近会话	`claude --continue`
交互式选择会话	`claude --resume`（方向键选择，空格预览）
恢复指定会话	`claude --resume <名称>`
分支新会话	`claude --continue --fork-session`（保留历史，从旧会话分叉）
按 PR 恢复	`claude --from-pr <编号>`

2.2 会话内命令

命令	作用	别名
`/resume [名称]`	打开会话选择器，或切换到指定会话	`/continue`
`/clear`	清空当前对话上下文，开启新会话	`/reset`、`/new`
`/compact [指令]`	压缩长对话释放上下文窗口，可选保留重点	—
`/rename [名称]`	重命名当前会话，不传名称则自动从历史生成	—
`/branch [名称]`	在当前点分叉出新会话	`/fork`
`/export [文件名]`	导出当前对话为纯文本	—
`/copy [N]`	复制最近一次 AI 回复到剪贴板，`/copy 2` 复制倒数第二次	—
`/btw <问题>`	快速旁提问——不记入对话历史，不消耗上下文，无工具调用	—
`/recap`	按需生成一行会话摘要	—
`/context`	以彩色网格可视化当前上下文占用，附优化建议	—
`/add-dir <路径>`	动态添加会话可访问的工作目录	—
`/rewind`	回退对话和/或代码到之前的检查点	`/checkpoint`、`/undo`

会话选择器快捷键：

快捷键	作用
`Ctrl+A`	显示所有项目的会话
`Ctrl+W`	显示当前仓库所有 worktree 的会话
`Ctrl+B`	按当前 git 分支过滤
`Ctrl+R`	重命名高亮会话
`Space`	预览会话内容
`/` 或任意可打印字符	搜索/过滤会话

三、权限模式

3.1 六种模式

模式	自动批准范围	适用场景
`default`	仅读取	入门、敏感项目
`acceptEdits`	读取 + 文件编辑 + 常见文件系统操作	快速迭代同时保持审查
`plan`	仅读取	先探索再编码
`auto`	全部（分类器安全检查）	长任务、减少授权疲劳
`dontAsk`	仅预批准工具	CI/自动化环境
`bypassPermissions`	除受保护路径外全部	隔离容器/VM

3.2 切换方式

Shift+Tab — 终端内循环切换模式
/plan [描述] — 从提示符进入计划模式
claude --permission-mode plan — 启动时指定模式
settings.json: "permissions": { "defaultMode": "plan" } — 设为默认

四、模式切换命令

命令	作用
`/plan [描述]`	进入计划模式（仅研究不编辑）
`/model [模型]`	选择或切换模型，支持调整 effort 级别
`/effort [low\|medium\|high\|xhigh\|max\|auto]`	设置模型推理力度
`/fast [on\|off]`	快速模式开关（仅 Opus 4.6 可用）
`/color [颜色\|default]`	设置提示栏颜色：red/blue/green/yellow/purple/orange/pink/cyan
`/focus`	专注视图——仅显示上次提示、工具调用摘要和最终回复（全屏模式）
`/tui [default\|fullscreen]`	切换终端 UI 渲染模式
`/voice [hold\|tap\|off]`	语音输入模式
`/sandbox`	沙盒模式开关

五、代码与审查

命令	作用
`/review [PR]`	拉取并审查当前分支或指定 PR
`/security-review`	安全审查当前分支的所有待变更文件
`/diff`	打开交互式 diff 查看器，含未提交变更和逐轮 diff
`/init`	为当前项目自动生成 CLAUDE.md
`/simplify [关注点]`	并发启动 3 个审查子代理审查代码质量，汇总后自动修复
`/autofix-pr [提示]`	远程守护——监控 PR，CI 失败或有评论时自动推送修复
`/install-github-app`	为仓库安装 Claude GitHub Actions 应用
`/pr-comments`	查看 PR 评论
`/ultrareview [PR]`	云端多代理深度审查（Pro/Max 免费 3 次）
`/ultraplan <提示>`	云端起草计划，浏览器审查后执行或返回终端

六、权限与配置

命令	作用	别名
`/permissions`	管理工具的 allow/ask/deny 规则（交互对话框）	`/allowed-tools`
`/config`	打开设置界面：主题、模型、输出风格、偏好	`/settings`
`/hooks`	查看所有钩子配置（按事件分类的只读浏览器）	—
`/memory`	编辑 CLAUDE.md 记忆文件，开关自动记忆	—
`/keybindings`	打开或创建快捷键配置文件	—
`/skills`	列出所有可用技能（按 `t` 按 token 数排序）	—
`/mcp`	管理 MCP 服务器连接与 OAuth 认证	—
`/plugin`	管理插件	—
`/reload-plugins`	热重载所有插件	—
`/ide`	管理 IDE 集成状态	—
`/chrome`	配置 Chrome 浏览器集成	—
`/remote-env`	配置 `--remote` 启动时的默认远程环境	—
`/terminal-setup`	配置 Shift+Enter 键位（VS Code、Cursor、Windsurf 等）	—
`/doctor`	诊断安装和环境问题	—
`/status`	系统状态：版本、模型、账户、连接	—
`/login`	登录 Anthropic 账户	—
`/logout`	退出 Anthropic 账户	—
`/privacy-settings`	隐私设置（Pro/Max）	—

七、任务与调度

命令	作用	别名
`/tasks`	查看和管理后台任务	`/bashes`
`/agents`	管理子代理配置	—
`/loop [间隔] [命令]`	按间隔重复执行，如 `/loop 5m check deploy`；裸 `/loop` 进入自主维护	—
`/schedule [描述]`	创建/更新/列表/运行云端定时代理（routines）	`/routines`
`/usage`	会话费用、用量限制、活动统计	`/cost`、`/stats`
`/extra-usage`	配置超额用量（达速率上限时启用）	—

7.1 任务（Task）系统

Claude Code 对复杂多步任务自动创建任务列表，有四个状态：pending → in_progress → completed。

Ctrl+T — 在状态栏切换显示任务列表（最多 5 条）
桌面通知告知 —— “给我列一下所有任务”
任务在上下文压缩后依然保留
跨会话共享任务列表：CLAUDE_CODE_TASK_LIST_ID=my-project claude

7.2 定时调度细节

1
2
3

/loop 5m check deploy        # 每 5 分钟检查一次
/loop                         # 自主维护循环（适合 CI 监控等场景）
/loop check the PR            # Claude 自我调节节奏

/loop 只在当前会话存活期间有效，退出即终止
/schedule 创建的 routine 是云端持久化的，与当前会话生命周期无关
创建 .claude/loop.md 可以自定义默认维护任务的提示词

八、Skills（技能）系统

技能是扩展 Claude 能力的机制。核心优势：指令按需加载，不用的技能零成本。

8.1 技能 vs CLAUDE.md

特性	CLAUDE.md	Skill
加载时机	每次对话自动全量加载	仅在调用时加载
适合内容	项目架构、常用命令、关键约束	专项流程、参考手册、长文档
调用方式	自动	用户 `/技能名` 或 Claude 自动匹配

经验法则：长参考文档、专项操作流程放 Skill；项目基础信息、核心约束放 CLAUDE.md。

8.2 内置技能

命令	作用
`/batch <指令>`	大规模并行修改：分解 5-30 个任务，在隔离 worktree 中并发执行，每个开 PR
`/claude-api`	加载 Claude API 参考（Python/TS/Java/Go/Ruby/C#/PHP/curl）
`/debug [描述]`	开启调试日志并辅助排查问题
`/fewer-permission-prompts`	扫描历史记录，为常用只读命令生成项目 allowlist 减少授权弹窗
`/insights`	分析使用数据生成 Claude Code 会话报告
`/simplify [关注点]`	并发启动 3 个审查子代理审查代码质量，汇总后自动修复
`/statusline`	配置终端状态栏
`/team-onboarding`	根据你过去 30 天的使用历史生成团队入职指南
`/loop`	循环执行命令
`/schedule`	云端定时任务
`/init`	初始化 CLAUDE.md
`/review`	PR 审查
`/security-review`	安全审查

8.3 创建自定义 Skill

在以下路径创建 SKILL.md 文件：

~/.claude/skills/<名称>/SKILL.md    # 个人（所有项目可用）
.claude/skills/<名称>/SKILL.md      # 项目级（可提交到仓库）

文件格式：

---
name: my-skill
description: 这个技能做什么，何时使用
when_to_use: 额外的触发短语
disable-model-invocation: true   # 设为 true 则只能手动调用
user-invocable: false            # 设为 true 则只能 Claude 自动调用
allowed-tools: Bash(git *)       # 技能激活期间预批准的工具
model: sonnet                    # 覆盖模型
effort: high                     # 覆盖努力级别
context: fork                    # 在隔离子代理中运行
agent: Explore                   # 配合 context: fork 指定子代理类型
paths: "*.py"                    # 限制触发路径
---

技能指令内容...

8.4 技能调用与生命周期

手动调用：/技能名参数1 参数2
自动调用：Claude 根据 description 字段自动匹配
一旦调用，技能内容作为消息进入对话，保留整个会话
上下文压缩时会保留最近一次调用（前 5000 token）
技能目录被监视，编辑后即时生效无需重启
支持 !命令 语法在 prompt 到达 Claude 前做 shell 预处理
变量替换：$ARGUMENTS、$0、$1、${CLAUDE_SESSION_ID}、${CLAUDE_SKILL_DIR}

九、Hooks（钩子）系统

钩子是用户定义的脚本/HTTP 端点/提示词/代理子进程，在特定生命周期事件时自动执行。

9.1 所有事件一览

事件	触发时机	可阻断
`SessionStart`	会话开始或恢复	否
`SessionEnd`	会话终止	否
`UserPromptSubmit`	用户提交提示	是
`UserPromptExpansion`	斜杠命令展开为提示	是
`PreToolUse`	工具调用执行前	是（allow/deny/defer）
`PostToolUse`	工具调用成功执行后	否
`PostToolUseFailure`	工具调用执行失败后	否
`PostToolBatch`	所有并行工具调用完成后	是
`PermissionRequest`	权限对话框弹出时	是
`PermissionDenied`	auto 模式分类器拒绝工具时	否（可设重试）
`Notification`	Claude 发送通知时	否
`SubagentStart`	子代理启动时	否
`SubagentStop`	子代理完成时	是
`TaskCreated`	任务创建时	是
`TaskCompleted`	任务标记完成时	是
`Stop`	Claude 完成回复时	是
`StopFailure`	因 API 错误结束轮次时	否
`TeammateIdle`	队友即将空闲时	是
`InstructionsLoaded`	CLAUDE.md 或规则文件加载时	否
`ConfigChange`	会话中配置文件变更时	是
`CwdChanged`	工作目录变更时	否
`FileChanged`	被监视的文件在磁盘上变更时	否
`WorktreeCreate`	Worktree 被创建时	是
`WorktreeRemove`	Worktree 被删除时	否
`PreCompact`	上下文压缩前	是
`PostCompact`	上下文压缩后	否
`Elicitation`	MCP 服务器请求用户输入时	是
`ElicitationResult`	用户响应 elicitation 后	是

9.2 钩子类型

类型	机制	适用场景
`command`	Shell 命令，通过退出码和 stdout JSON 通信	本地检查、格式验证
`http`	POST JSON 到 HTTP 端点	外部服务集成
`mcp_tool`	调用已连接 MCP 服务器的工具	复用 MCP 能力
`prompt`	单轮 Claude 评估（yes/no 决策）	内容审查、是否放行
`agent`	启动子代理（有 Read/Grep/Glob 工具）	复杂前置检查（实验性）

9.3 退出码规则

退出码	含义
`0`	成功。stdout 解析为 JSON 决策
`2`	阻断性错误。操作被阻止，stderr 展示给 Claude
其他	非阻断性错误。继续执行

9.4 配置位置

~/.claude/settings.json — 用户级
.claude/settings.json — 项目级（可提交）
.claude/settings.local.json — 本地级（gitignore）
插件 hooks/hooks.json
企业托管策略设置
Skill/Agent YAML 头信息

查看所有钩子：/hooks。

9.5 典型用法

桌面通知钩子（~/.claude/settings.json）：

{
  "hooks": {
    "Notification": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "osascript -e 'display notification \"Claude Code 需要注意\" with title \"Claude Code\"'"
      }]
    }]
  }
}

matcher 可设：permission_prompt、idle_prompt、auth_success、elicitation_dialog。

十、快捷键

10.1 输入编辑

快捷键	作用
`Enter`	提交消息（换行用 `Shift+Enter` 或 `Alt+Enter`）
`Ctrl+O`	切换详细查看器（显示思考过程）
`Ctrl+J`	在消息中插入换行（备选）
`Ctrl+I`	在消息末尾插入文件内容
`Ctrl+K`	将选中文字转为代码块
`Ctrl+L`	清空当前输入并重绘屏幕
`Ctrl+G`	在外部文本编辑器打开当前提示
`Ctrl+R`	反向搜索命令历史
`Ctrl+C`	取消当前输入/生成
`Ctrl+D`	中断正在执行的工具调用
`Esc`	取消当前输入
`Esc + Esc`	打开 rewind/checkpoint 菜单

10.2 模式与界面

快捷键	作用
`Shift+Tab`	循环切换权限模式
`Ctrl+E`	打开/关闭思考模式
`Ctrl+V`	打开/关闭详细模式
`Ctrl+B`	后台运行任务（tmux 下按两次）
`Ctrl+T`	切换任务列表显示
`Ctrl+S`	保存当前对话到文件
`Ctrl+W`	查看当前 worktree 信息
`Option+P` / `Alt+P`	切换模型
`Option+T` / `Alt+T`	切换扩展思考

10.3 输入技巧

快捷键/字符	作用
`! 命令`	直接运行 shell 命令，输出加入上下文
`@ 文件路径`	文件路径自动补全
输入 `/`	列出所有可用斜杠命令

十一、上下文管理

11.1 核心概念

每次对话有上下文窗口限制，超出后最早的消息会被截断
/context 以彩色网格直观显示当前使用情况
/compact 在会话中释放上下文（可附带保留重点的指令）
/clear 完全重置上下文

11.2 省上下文技巧

长参考文档放入 Skill 而非 CLAUDE.md：Skill 只在调用时加载
用 /btw 处理临时疑问：不记入对话历史
使用子代理处理大量查询：返回摘要而非全量结果
定期 /compact：压缩已完成部分的细节，保留决策和结论

十二、Worktree（工作树）

在隔离的 git worktree 中工作，实验性修改不影响主工作区。

1
2
3

claude --worktree feature-auth   # 在新分支上创建隔离 worktree
claude --worktree bugfix-123     # 另一个平行会话
claude -w                         # 自动生成名称

Worktree 创建在 .claude/worktrees/<名称>/
子代理也可使用 worktree 隔离（agent frontmatter 中 isolation: worktree）
退出后根据选择保留或删除

十三、非交互（Headless）模式

# 单次问答
claude -p "解释这个函数"

# 管道输入
cat errors.txt | claude -p "找出错误原因"

# 结构化输出
claude -p --output-format json "分析 code.py 的结构" | jq '.'

# 流式 JSON 输出
claude -p --output-format stream-json "查询"

# 约束 JSON Schema
claude -p --json-schema '{"type":"object",...}' "分析并结构化返回"

# 恢复上下文后单次执行
claude --continue -p "检查类型错误"

# 无配置文件快速启动
claude --bare -p "查询"

十四、Checkpoint 与 Rewind

Claude Code 自动为每一次文件编辑创建检查点。

/rewind 或 Esc Esc — 回退对话和/或代码到之前某个检查点
/diff — 查看逐轮 diff，对比每次变更
/branch — 在当前点创建对话分支，保留原会话继续探索

十五、Agent Teams（代理团队）

通过 /config 启用。Claude 可并行启动多个队友（teammate）同时处理任务。

最适合：并行代码审查、多假设验证、独立工作的并行展开
--teammate-mode 控制显示方式：in-process、tmux、auto

十六、IDE 与编辑器集成

VS Code / JetBrains 插件：直接在 IDE 内使用全部功能，自动识别项目结构
Ctrl+G：在 $EDITOR/$VISUAL 中打开当前提示
Vim 模式：/config → 编辑器模式 → Vim（完整 vim 键位）
macOS Option 键：终端设置中启用 “将 Option 作为 Meta”
PR 状态底部栏：需要 gh CLI，审查状态以彩色下划线显示

十七、状态栏

/statusline 配置终端状态栏，显示：上下文窗口使用率、git 状态、当前模型、费用等。支持自定义模板。

十八、账号与费用

命令	作用
`/usage`	会话费用、用量限制、活动统计
`/extra-usage`	达速率上限时启用超额用量
`/login`	登录 Anthropic 账户
`/logout`	退出账户
`/upgrade`	升级到更高计划套餐

十九、常用工作流实例

代码审查

1
2
3

claude --resume       # 恢复当前分支的会话
/review               # 审查变更
/security-review      # 安全审查

持续监控

/loop 3m "检查 CI 状态并报告结果"

# 或创建云端持久化的 routine
/schedule "每天 9:00 检查 main 分支构建状态"

大规模重构

`1`	`/batch "把所有 React class 组件改成函数组件"`

计划优先

1
2
3

/plan "重构认证模块，支持 OAuth2"
# Claude 会先研究代码库，产出方案供你审查
# 满意后在计划模式下退出，进入编辑模式执行

跨会话工作

# 上午的工作
claude -n auth-refactor
# ... 工作 ...
/exit

# 下午继续
claude --continue      # 或 claude --resume auth-refactor

安全审查

1
2
3

/security-review
# 审查所有未提交变更的安全问题
# 产生 OWASP Top 10 维度的报告

Git 最佳实践

Thu, 07 May 2026 00:00:00 +0000

1. Git 要解决什么问题

版本可追溯：你能知道每次改了什么。
可回滚：系统改坏了能立即回到稳定节点。
分支隔离：功能迭代不污染主线（main）。
只提交代码：不把运行缓存、数据库、视频、截图、依赖目录提交进仓库（靠 .gitignore）。

2. 初始状态检查

刚开始时你可能处于：

在 main 分支
没有 commit
文件为 Untracked（未纳入版本管理）

下一步要做的是： .gitignore → git add . → git commit → git tag → git checkout -b

3. 必备：.gitignore

目的：避免提交运行产生的垃圾文件（例如构建产物、node_modules、SQLite、上传视频、截图等）。

3.1 检查 `.gitignore` 是否生效

在项目根目录执行：

`1`	`git status`

你不应该看到这些被 Git 追踪：

node_modules/
.next/ 或其他构建产物目录
数据库/上传/截图等运行时数据目录

3.2 如果发现上述目录出现在 status 里（被追踪了）

说明这些文件可能在 .gitignore 生效之前已经被 Git 记录过。用下面命令"从 Git 里移除追踪，但保留本地文件"：

1
2
3

git rm -r --cached node_modules .next data || true
git add .
git commit -m "chore: stop tracking generated/runtime files"

4. 建立第一个"稳定节点"（baseline checkpoint）

4.1 初始化仓库（若还没执行过）

`1`	`git init`

4.2 将当前版本加入暂存区

`1`	`git add .`

4.3 检查将提交内容（推荐必做）

`1`	`git status`

4.4 创建第一次提交（基线）

`1`	`git commit -m "checkpoint: runnable baseline"`

5. 打标签：做"回滚锚点"

标签（tag）= 你的"存档点"，以后随时可回到这个版本。

5.1 给当前提交打标签

`1`	`git tag v0.1-checkpoint`

5.2 查看标签是否存在

git tag

5.3 查看最近提交（带标签信息）

`1`	`git log --oneline --decorate -10`

6. 分支策略

规则

main：保持稳定、可演示的版本
feature/*：所有新功能/大改动在功能分支做
需要里程碑就打 tag（例如 v0.2 / v0.3）

6.1 创建并切换到功能分支

`1`	`git checkout -b feature/ui-upgrades`

6.2 查看当前分支

`1`	`git branch`

7. 日常工作流

7.1 每次开始一个新功能

从 main 拉一个新分支：

1
2

git checkout main
git checkout -b feature/<task-name>

示例：

`1`	`git checkout -b feature/alert-snapshots`

7.2 开发过程中查看改动

1
2

git status
git diff

7.3 分阶段提交

不要憋成一次超大提交：

1
2

git add .
git commit -m "feat: improve analysis UI"

7.4 完成一个里程碑，打标签（可选）

`1`	`git tag v0.2-ui-polish`

8. 回滚方式

8.1 推荐回滚：从某个 tag 开新分支继续开发（最安全）

不会破坏现有分支，也不会丢历史：

`1`	`git checkout -b rollback-from-v0.1 v0.1-checkpoint`

8.2 只"查看"某个 tag 的版本（不建议长期停留）

`1`	`git checkout v0.1-checkpoint`

注意：这会进入 “detached HEAD” 状态。若要继续开发，请开分支：

`1`	`git checkout -b hotfix/from-v0.1 v0.1-checkpoint`

8.3 强制把当前分支回到某个 tag（慎用：会丢未提交内容）

`1`	`git reset --hard v0.1-checkpoint`

若有未提交改动又不想丢，先 stash：

1
2
3

git stash -u
git reset --hard v0.1-checkpoint
git stash pop

9. 推荐 tag 命名

v0.1-checkpoint：系统跑通
v0.2-alert-snapshots：告警证据截图可用
v0.3-ui-pro：UI 升级到高级控制台
v1.0-demo-ready：最终可演示/可答辩版本

10. 可选：接入远端仓库

如果后面想同步到 GitHub/Gitee：

10.1 添加远端

`1`	`git remote add origin <your-repo-url>`

10.2 推送 main 和 tags

1
2

git push -u origin main
git push --tags

11. 最常用命令速查

git status
git diff
git add .
git commit -m "..."
git checkout -b feature/xxx
git log --oneline --decorate -10
git tag v0.x-xxx
git checkout -b rollback-from-tag <tagname>

Mac 命令行环境配置备忘

Thu, 07 May 2026 00:00:00 +0000

目的：把 Mac 上"终端里能用的工具从哪来、优先级如何、怎么自查"整理成一份备忘。

1. Git

当前 Git：git version 2.50.1 (Apple Git-155)
可执行位置：/usr/bin/git
来源：Apple / Xcode Command Line Tools（CLT）
CLT 路径：/Library/Developer/CommandLineTools

结论：

这是命令行工具，不是 GUI 应用，所以不会出现在「启动台」。
更新方式：随 macOS / Xcode / Command Line Tools 更新而更新（不是像 brew 那样单独升级）。

自查命令：

1
2
3

git --version
which git
xcode-select -p

2. Python / Conda

终端提示符有 (base)，conda 环境只有一个：

Conda 发行版：Miniforge（以 Cask 安装）
base 环境路径：/opt/homebrew/Caskroom/miniforge/base
当前默认 python/pip（因 PATH 优先级）：
- python → /opt/homebrew/Caskroom/miniforge/base/bin/python
- python3 → /opt/homebrew/Caskroom/miniforge/base/bin/python3
- pip → /opt/homebrew/Caskroom/miniforge/base/bin/pip
- pip3 → /opt/homebrew/Caskroom/miniforge/base/bin/pip3
系统也有：
- python3 → /usr/bin/python3
- pip3 → /usr/bin/pip3
- 但由于 conda 路径在 PATH 更前面，日常默认使用 conda 的 python/pip。

conda 的状态：

conda 在 shell 中既是一个函数（来自 ~/.zshrc），也有多个可执行文件路径。
这是 conda 初始化脚本的常见表现。

自查命令：

1
2
3

conda env list
conda list
type -a python python3 pip pip3 conda

3. Homebrew（命令行包管理器）

3.1 手动安装的顶层包

brew leaves 输出只有：

node
tree

这通常意味着：

真正"自己装来用"的命令行主工具基本就是 Node.js 和 tree
brew list 里看到的一大堆（cairo/pango/libpng/... 等）多为依赖库/被间接安装的组件

自查命令：

brew leaves
brew list
brew list --cask
brew uses --installed <包名>

3.2 Homebrew 是否"只在 base 环境里可用"？

不是。Homebrew 是系统级安装在 /opt/homebrew（Apple Silicon 常见路径）。在 base 环境也能用 brew/tree 的原因是：PATH 里包含 /opt/homebrew/bin。

验证命令：

type -a brew tree
which brew
which tree
conda deactivate
type -a brew tree

4. OrbStack（Docker / Kubernetes 命令来源）

PATH 里有 /Users/xiang/.orbstack/bin，该目录中包含：

docker
docker-compose
docker-credential-osxkeychain
kubectl
orb、orbctl

结论：当前的 docker / kubectl 很可能优先来自 OrbStack（取决于 PATH 排序）。

自查命令：

which docker
which docker-compose
which kubectl
type -a docker kubectl

5. PATH 优先级

当前 PATH（按优先级从高到低）：

/opt/homebrew/Caskroom/miniforge/base/bin ← conda base 的命令（python/pip 等）
/opt/homebrew/Caskroom/miniforge/base/condabin
/opt/homebrew/bin ← Homebrew 命令（brew、tree、node 等）
/opt/homebrew/sbin
/usr/local/bin
/System/Cryptexes/App/usr/bin
/usr/bin
/bin
/usr/sbin
/sbin
/opt/pmk/env/global/bin ← 非典型来源，可能是某个环境/工具链的全局 bin
/Library/TeX/texbin ← TeX/LaTeX 工具链（装了 mactex-no-gui）
/Users/xiang/.orbstack/bin ← OrbStack 的 docker/kubectl 等

重点记住：

谁在 PATH 前面，谁就"覆盖/优先"
目前：conda base 覆盖系统 python，brew 在其后；OrbStack 在较后但仍可用

快速查看某个命令到底来自哪里：

1
2

type -a <命令>
which <命令>

6. 与命令行相关的 GUI 应用（Homebrew Cask）

miniforge（决定 conda / base）
orbstack（提供 docker/kubectl 等）
mactex-no-gui（带来 /Library/TeX/texbin）
visual-studio-code（开发编辑器）

查看完整列表：

`1`	`brew list --cask`

7. “忘了装了啥"时的推荐排查顺序

先看 Homebrew 的"顶层包”：

`1`	`brew leaves`

再看 conda base 里装了什么（通常 python 相关在这里）：

1
2

conda list
python -m pip list

1
2
3

ls -1 /opt/homebrew/bin | head -n 80
ls -1 /opt/pmk/env/global/bin 2>/dev/null | head -n 80
ls -1 ~/.orbstack/bin 2>/dev/null | head -n 80

定位具体某个命令：

`1`	`type -a <命令>`

8. 关键结论一句话版

Git：Apple Git（CLT 提供，随系统/CLT 更新）
Python：主要来自 Miniforge conda base（覆盖系统 python3）
Brew 顶层工具：只剩 node、tree（其余多为依赖）
Docker/kubectl：很可能来自 OrbStack

Mac 深度残留清理助手

Thu, 07 May 2026 00:00:00 +0000

卸载 Mac 应用后，~/Library、/Library、Homebrew 等目录中常残留大量缓存、配置和失效启动项。本文提供一套系统化的清理方案，覆盖用户级和系统级路径，附带交叉验证逻辑与安全审批流程。

清理约束

不动 Downloads、Desktop、Documents
不删除正在使用的软件主数据，优先清理残留、缓存、日志、安装包工件、失效启动项
操作分两步：先出审批表，确认后再执行删除

扫描范围

用户级

~/Library/
  Containers、Group Containers、Application Scripts
  Application Support、Preferences、Caches
  WebKit、HTTPStorages、Saved Application State、Biome

~/.cache/          ← 大型工具运行时/编译缓存常在此
~/.config/         ← XDG 规范工具配置，卸载后常残留
~/.local/share/    ← XDG 数据目录
~/（根目录隐藏 dotfiles）← .android .putty 等工具遗留

系统级

/Library/
  LaunchAgents、LaunchDaemons、PrivilegedHelperTools
  Extensions、SystemExtensions、Application Support、Preferences

Homebrew

/opt/homebrew/Caskroom/              ← 多版本遗留及孤儿条目
~/Library/Caches/Homebrew/downloads/ ← 安装包缓存

交叉验证逻辑

用 ls /Applications ~/Applications + brew list --cask 建立已安装 App 清单
扫描上述路径时，对每条记录比对清单：找不到对应 App 的即为候选残留
对模糊项（如系统框架插件、SDK 组件）进一步用 mdfind / kextstat 确认后再归类

审批表格式

A 类 — 已卸载应用真实残留

编号	路径	大小	来源 App	风险	是否影响在用软件
—	—	—	—	—	—

B 类 — 可再生大型缓存

在用 App 产生，删后可自动重建。

编号	路径	大小	用途	清理方式	风险
—	—	—	—	—	—

C 类 — 后台持久化审查

编号	路径	对应 App	KeepAlive	RunAtLoad	建议
—	—	—	—	—	—

执行要求

非 sudo 项：确认后直接执行
需要 sudo 的项：以 sudo <命令> 格式提供，手动粘贴执行
删除完成后对比「清理前 → 清理后」磁盘可用空间，以及各类合计释放量

实用命令速查

# 查看已安装 Cask
brew list --cask

# 搜索某 App 的所有残留文件
mdfind "kMDItemFSName == 'AppName*'" -onlyin ~

# 查看 LaunchAgent/Daemon
ls ~/Library/LaunchAgents/
ls /Library/LaunchAgents/
ls /Library/LaunchDaemons/

# 查看磁盘可用空间
df -h /

YOLO 训练运维速查

Thu, 07 May 2026 00:00:00 +0000

1. 启动训练（后台运行）

先进入脚本所在目录，然后使用 nohup 启动。注意加上 -u 参数，否则日志会有严重延迟（写不进文件）。

# 进入目录
cd /root/autodl-fs/

# 启动命令 (解释：python -u 禁用缓存，> 输出到日志，2>&1 包含报错，& 后台运行)
nohup python -u ultralytics-yolo11-main/train_queue.py > train.log 2>&1 &
nohup python -u ultralytics-main/train_queue.py > train.log 2>&1 &

看见 [1] xxxxx 提示即表示启动成功。

2. 查看日志（实时监控）

训练在后台跑，你想看进度时：

`1`	`tail -f train.log`

退出查看：按 Ctrl + C（放心，这只会退出日志查看，不会停止训练）。

3. 管理进程（查杀）

检查还在不在跑：

# 方法A：看显卡有没有在转
nvidia-smi

# 方法B：搜进程号
ps -ef | grep train_queue.py

停止训练（杀进程）：

1
2

# 假设上面查到的进程号是 12345
kill -9 12345

终止所有 Python 进程：

`1`	`pkill -9 python`

4. 学术资源加速

`1`	`source /etc/network_turbo`

终端网络代理配置手册

Thu, 07 May 2026 00:00:00 +0000

问题背景

macOS 的终端（Terminal / iTerm2）默认不走系统代理设置，导致 brew install、git clone、curl 等命令行工具无法连接 GitHub 或速度极慢。

解决方案很简单：在 Zsh 配置中注入几个别名，手动控制终端的代理开关。

配置代码

将以下代码块添加到 ~/.zshrc 的最底部：

# =================================================
# 终端代理控制 (Proxy Control)
# Target: Clash Verge (Localhost: 7897)
# =================================================

# 开启代理
alias proxy='export https_proxy=http://127.0.0.1:7897 http_proxy=http://127.0.0.1:7897 all_proxy=socks5://127.0.0.1:7897; echo "\n✅ 终端代理已开启 (Port: 7897)"'

# 关闭代理
alias unproxy='unset https_proxy http_proxy all_proxy; echo "\n🚫 终端代理已关闭"'

# 检查当前 IP
alias myip='curl -s ipinfo.io/json | grep -E "ip|country"'

生效步骤

打开配置文件：nano ~/.zshrc
将上述代码粘贴到文件末尾
保存退出（Ctrl+O → Enter → Ctrl+X）
立即生效：source ~/.zshrc

命令速查

命令	说明	预期反馈
`proxy`	开启代理，在 `brew install` 或 `git clone` 前使用	`✅ 终端代理已开启...`
`unproxy`	关闭代理，恢复国内直连	`🚫 终端代理已关闭...`
`myip`	验证当前出口 IP 及国家	`{ "ip": "x.x.x.x", "country": "US" }`

常见问题

端口变更

不同代理软件默认端口不同：

ClashX Pro：7890
Surge：6152
Clash Verge：7897

修改方法：打开 ~/.zshrc，将 alias proxy='...' 行中所有端口号替换为你的代理端口，然后 source ~/.zshrc 生效。

代理开启后依然超时

确认代理软件正在运行，且"系统代理"开关已打开
检查代理软件设置中的"混合端口 (Mixed Port)“是否与配置一致
执行 myip 确认出口 IP 是否已变化

Mac 深度残留清理指南

Wed, 06 May 2026 00:00:00 +0000

目标

清理已卸载软件的残留文件——GUI 中不明显、但仍占空间或有持久化痕迹的垃圾，同时不影响正在使用的软件。

约束

不动 Downloads、Desktop、Documents
不删除正在使用的软件主数据；优先清理残留、缓存、日志、安装包工件、失效启动项
先出审批表，确认后再执行删除

扫描范围

用户级

路径	说明
`~/Library/Containers`、`Group Containers`、`Application Scripts`	App 沙盒数据
`~/Library/Application Support`、`Preferences`、`Caches`	App 配置与缓存
`~/Library/WebKit`、`HTTPStorages`、`Saved Application State`、`Biome`	系统级 App 痕迹
`~/.cache/`	重点：大型工具运行时/编译缓存
`~/.config/`	重点：XDG 规范工具配置，卸载后常残留
`~/.local/share/`	重点：XDG 数据目录
`~/`（根目录隐藏 dotfiles）	重点：`.android`、`.putty` 等工具遗留

系统级

路径	说明
`/Library/LaunchAgents`、`LaunchDaemons`、`PrivilegedHelperTools`	后台服务与开机启动项
`/Library/Extensions`、`SystemExtensions`	内核扩展
`/Library/Application Support`、`Preferences`	系统级 App 配置

Homebrew

路径	说明
`/opt/homebrew/Caskroom/`	检查多版本遗留及孤儿条目
`~/Library/Caches/Homebrew/downloads/`	安装包缓存

交叉验证逻辑

用 ls /Applications ~/Applications + brew list --cask 建立已安装 App 清单
扫描上述路径时，对每条记录比对清单：找不到对应 App 的即为候选残留
对模糊项（系统框架插件、SDK 组件）用 mdfind / kextstat 确认后再归类

审批表格式

A 类——已卸载应用真实残留

编号	路径	大小	来源 App	风险	是否影响在用软件

B 类——可再生大型缓存

在用 App 产生、删后可自动重建。

编号	路径	大小	用途	清理方式	风险

C 类——后台持久化审查

LaunchAgent / Daemon / PrivilegedHelper。

编号	路径	对应 App	KeepAlive	RunAtLoad	建议

执行要求

非 sudo 项：确认后直接执行
需要 sudo 的项：以 ! sudo <命令> 格式提供，在对话框内粘贴执行
删除完成后给出"清理前 → 清理后"磁盘可用空间对比及各类合计释放量

实用命令速查

# 查看已安装的 Cask
brew list --cask

# 查找某个 App 的所有残留文件
mdfind "kMDItemDisplayName == 'AppName'" | grep -i appname

# 查看磁盘可用空间
df -h /

# 查看 LaunchDaemons 中的第三方项
ls /Library/LaunchDaemons/ | grep -v com.apple

# 查看 LaunchAgents 中的第三方项
ls /Library/LaunchAgents/ | grep -v com.apple

# 查看 Homebrew 下载缓存大小
du -sh ~/Library/Caches/Homebrew/downloads/

从零开始搭建你的第一个 Docker 服务

Thu, 16 Apr 2026 00:00:00 +0000

Docker 已经成为现代后端部署的标配工具。本文将带你用 20 分钟，从零开始把一个 Python Web 服务容器化并运行起来。

为什么要用 Docker

在没有 Docker 的时代，部署一个服务需要手动安装运行时、配置依赖、处理环境差异。“在我机器上能跑"成了经典甩锅语录。

Docker 把应用和它的运行环境打包成一个镜像（Image），在任何装了 Docker 的机器上都能以相同方式运行。核心思路很简单：用代码定义环境，而不是手动配置。

几个关键概念：

镜像（Image）：只读的模板，包含应用代码和运行所需的一切
容器（Container）：镜像的运行实例，可以启动、停止、删除
Dockerfile：构建镜像的配方文件
docker-compose.yml：定义多个容器如何协同工作的配置文件

准备工作

确保机器上已安装 Docker 和 Docker Compose：

1
2

docker --version
docker compose version

如果没装，参考 Docker 官方文档。Linux 用户装完后把当前用户加入 docker 组，免得每次都加 sudo：

`1`	`sudo usermod -aG docker $USER`

重新登录终端生效。

第一步：写一个简单的 Web 服务

创建一个项目目录：

`1`	`mkdir docker-demo && cd docker-demo`

写一个最小的 Flask 应用 app.py：

from flask import Flask

app = Flask(__name__)

@app.route("/")
def index():
    return {"message": "Hello from Docker!"}

@app.route("/health")
def health():
    return {"status": "ok"}

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=5000)

再写一个 requirements.txt：

flask==3.1.*

第二步：编写 Dockerfile

在项目根目录创建 Dockerfile：

FROM python:3.12-slim

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

EXPOSE 5000

CMD ["python", "app.py"]

逐行解释：

指令	作用
`FROM python:3.12-slim`	基础镜像，slim 版本体积小
`WORKDIR /app`	设置容器内的工作目录
`COPY requirements.txt .`	先复制依赖文件，利用 Docker 层缓存
`RUN pip install ...`	安装依赖
`COPY . .`	再复制应用代码
`EXPOSE 5000`	声明端口（文档作用，不实际映射）
`CMD ["python", "app.py"]`	容器启动时运行的命令

为什么分两步 COPY？ Docker 会缓存每一层。如果代码改了但 requirements.txt 没变，pip install 那层会直接走缓存，构建速度更快。

第三步：编写 docker-compose.yml

services:
  app:
    build: .
    ports:
      - "5000:5000"
    restart: unless-stopped

这比直接用 docker run 更清晰，而且一条命令就能管理。

第四步：构建并运行

`1`	`docker compose up --build`

第一次会下载基础镜像并安装依赖，之后再构建会很快。看到 Flask 的启动日志后，打开另一个终端测试：

1
2

curl http://localhost:5000
# {"message":"Hello from Docker!"}

按 Ctrl+C 停止。如果想后台运行：

1
2
3

docker compose up -d      # 后台启动
docker compose logs -f     # 查看日志
docker compose down        # 停止并移除容器

第五步：加入数据库

实际项目通常需要数据库。给 docker-compose.yml 加一个 PostgreSQL：

services:
  app:
    build: .
    ports:
      - "5000:5000"
    environment:
      DATABASE_URL: postgresql://postgres:secret@db:5432/app
    depends_on:
      db:
        condition: service_healthy
    restart: unless-stopped

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_PASSWORD: secret
      POSTGRES_DB: app
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      timeout: 3s
      retries: 5

volumes:
  pgdata:

几个要点：

depends_on + service_healthy 确保数据库就绪后才启动应用
volumes 让数据库数据持久化，容器删了数据还在
同一个 compose 文件里的服务可以用服务名（db）作为主机名互相访问

常见问题

容器内访问宿主机服务

用 host.docker.internal（macOS/Windows）或 host.network（Linux）。

镜像太大

用 slim 或 alpine 基础镜像；多阶段构建把构建工具和运行时分开。

修改代码后不生效

挂载本地目录到容器内，开发时热更新：

services:
  app:
    build: .
    volumes:
      - .:/app
    ports:
      - "5000:5000"

如何查看运行中的容器

1
2
3

docker ps              # 查看运行中的容器
docker compose ps      # 查看当前项目的容器
docker exec -it <容器名> bash   # 进入容器内部

生产环境建议

这篇文章覆盖的是开发环境的基本用法。上生产前还需要考虑：

不要硬编码密码：用 .env 文件或密钥管理服务
网络隔离：数据库端口不要映射到宿主机，只让应用容器访问
日志管理：配置日志驱动，避免容器日志撑爆磁盘
资源限制：设置 CPU 和内存上限，防止单个容器耗尽资源

小结

整个流程就是四步：写代码 → 写 Dockerfile → 写 docker-compose.yml → docker compose up。Docker 的核心价值不在于技术有多复杂，而在于它把"部署"从一件靠记忆和运气的事，变成了一件可以版本控制、可以复现、可以自动化的事。

关于间歇性断食，你可能想问的几个问题

Thu, 16 Apr 2026 00:00:00 +0000

16:8 是什么意思？

每天有 8 小时进食窗口，其余 16 小时禁食。比如中午 12 点到晚上 8 点之间可以正常吃，其他时间只喝水、黑咖啡或无糖茶。

这是目前最流行的断食方案，因为进食窗口基本覆盖了午餐和晚餐，执行难度相对低。

除了 16:8，常见的方案还有：

18:6：进食窗口压缩到 6 小时，断食 18 小时。适合已经适应 16:8 后想进一步挑战的人
20:4（战士饮食）：每天只在 4 小时内进食，通常是一顿正餐加一份小食
5:2：一周中 5 天正常吃，2 天大幅减少热量（约 500-600 大卡）
24 小时断食：一周选 1-2 天完全不吃，只喝水。对新手来说比较激进

大多数人从 16:8 开始最合适。它的门槛最低，不会对社交生活造成太大影响，而且身体通常在两周内就能适应。

断食期间可以喝咖啡吗？

无糖黑咖啡可以。它热量极低，不会打破断食状态，还有一定的抑制食欲效果。绿茶、花草茶同理。

加了奶或糖就不行了——哪怕是一点点也会激活胰岛素分泌，打破断食的代谢状态。

断食期间可以喝的东西：

水（白水、气泡水、加柠檬片的水）
黑咖啡（不加任何东西）
绿茶、红茶、花草茶（无糖）
苹果醋兑水（少量）

需要注意的是，代糖（如阿斯巴甜、赤藓糖醇）虽然没有热量，但有研究表明它们可能引起胰岛素的条件反射分泌。如果你追求严格的断食效果，最好也避免。

会掉肌肉吗？

在保证蛋白质摄入充足（每公斤体重至少 1.2g）并坚持力量训练的前提下，掉肌肉的风险很低。

身体在断食状态下会优先燃烧脂肪，而不是分解肌肉——前提是你不处于极度热量赤字。

一些具体建议：

蛋白质分配：把每日蛋白质需求分散到两顿正餐中，每顿 30-40g，吸收效率最高
训练时机：在进食窗口内或刚结束时训练效果最好，此时身体有足够的氨基酸供应
补剂：如果担心，可以在进食窗口开始时补充 BCAA 或乳清蛋白
不要过度节食：断食不等于节食，进食窗口内要吃够基础代谢所需的热量

实际上，很多人反映在间歇性断食配合适当力量训练后，体脂率下降的同时肌肉量反而有所增加。关键在于吃得够、练得对。

断食期间饿了怎么办？

刚开始的前两周，饥饿感是最明显的。几个实用的应对方法：

喝水：很多时候口渴和饥饿的信号容易混淆，先喝一杯水等 15 分钟
黑咖啡：咖啡因有明显的抑制食欲效果
保持忙碌：饥饿感是波浪式的，通常持续 15-20 分钟就会消退。投入到工作中，等注意力转移后就不觉得饿了
慢慢缩窗口：如果 16:8 太难，先从 12:12 开始（比如晚 8 点到早 8 点不吃），每周推迟一小时进食，逐步过渡

一般坚持两周后，身体会适应新的进食节奏，饥饿感会显著减弱。很多人甚至会觉得早餐不再必要。

对健康有什么好处？

除了减脂，间歇性断食还有一些被研究支持的潜在好处：

改善胰岛素敏感性：断食期间胰岛素水平下降，细胞对胰岛素的敏感度提高，有助于预防 2 型糖尿病
促进自噬：细胞在断食状态下会启动自我清理机制，清除受损的蛋白质和细胞器。这个发现获得了 2016 年诺贝尔生理学或医学奖
降低炎症标记物：多项研究表明间歇性断食可以降低 C 反应蛋白等炎症指标
改善心血管健康：部分研究发现断食可以降低血压、改善血脂谱
提升认知清晰度：很多人反映断食期间注意力更集中，可能与酮体供能有关

不过需要指出的是，很多研究还停留在动物实验阶段，人体的长期效果仍需要更多数据支撑。

不适合哪些人？

孕期、哺乳期女性
有低血糖史或进食障碍史的人
正在服用需要随餐吃的药物的人
体重过轻（BMI < 18.5）的人
糖尿病患者（尤其是使用胰岛素的）
青少年和发育期的儿童

有慢性病或长期用药的人，建议先咨询医生再尝试。

执行上的几个细节

进食窗口怎么选？ 大多数人选中午 12 点到晚上 8 点，因为这样可以和同事吃午饭、和家人吃晚饭。但如果你是早起型的人，选上午 10 点到下午 6 点也完全可以。关键是保持一致。

周末可以放松吗？ 可以，但不建议完全打破节奏。周末把窗口调成 14:10 或 12:12 就够了，周一再回到 16:8。频繁地完全中断会让身体不断重新适应，反而更难受。

要不要计算热量？ 前期建议大致记录一下，确保自己没有在进食窗口内暴食。等养成习惯后可以不记——8 小时的进食窗口天然限制了你吃太多。

断食可以和生酮搭配吗？ 可以，而且效果会叠加。生酮饮食本身就会让身体进入酮供能状态，配合断食会更高效。但两者同时开始对身体的冲击比较大，建议先适应断食再尝试生酮。

我的建议

间歇性断食不是什么神奇的减肥法，它本质上是一种进食时间管理工具。它的最大优势在于简单——不需要计算卡路里、不需要买特殊食物、不需要改变你吃什么，只需要调整你什么时候吃。

如果你正在考虑尝试，我的建议是：从 16:8 开始，坚持两周看看感觉。不要对自己太严格，偶尔破戒也没关系。重要的是建立一个可以长期维持的节奏，而不是追求短期的极端效果。

开源大模型生态 2025 年中盘点

Thu, 16 Apr 2026 00:00:00 +0000

2025 年上半年，开源大模型赛道持续升温。多个头部团队相继发布参数规模在 700B 以上的新模型，推理效率较去年同期提升显著。

三大趋势

端侧部署普及

4B 以下的小模型在手机、边缘设备上的落地场景快速增多。量化技术的成熟让普通消费级 GPU 也能流畅运行 7B 模型。

具体来看：

手机端：苹果的 Core ML 和高通的 AI Engine 都在加速适配小模型，Llama 3.2 3B 在 iPhone 15 Pro 上可以实现每秒 30+ token 的生成速度
边缘设备：NVIDIA Jetson、树莓派 5 等设备跑 7B 模型已经不是新鲜事，量化到 4-bit 后内存占用可以控制在 4GB 以内
桌面端：Ollama、LM Studio 等工具让本地部署变得极其简单，一行命令就能跑起来

这个趋势的意义在于：很多对延迟敏感、对隐私要求高的场景（如医疗问诊、企业内部知识库）不再需要把数据送到云端。

多模态能力标配化

图文理解已成为主流开源模型的基础能力，视频理解正在跟进。以前需要专门的视觉模型，现在一个通用模型就能搞定。

几个关键进展：

图文理解：Llama 3.2 Vision、Qwen2.5-VL 等模型在图表理解、OCR、文档解析等任务上已经接近商业 API 的水平
视频理解：虽然还处于早期，但已经出现了可以处理短视频（30 秒以内）并回答问题的开源模型
音频理解：Whisper 的后继者们在语音识别和理解上持续进步，多语言支持越来越好
跨模态生成：文生图领域 Stable Diffusion 3 和 FLUX 系列开源后，图片生成的质量和可控性有了质的飞跃

多模态能力的普及意味着开发者可以用一个模型处理多种类型的数据，降低了应用架构的复杂度。

工具调用成熟度提升

多个模型在 BFCL 等基准上接近或超越闭源模型，Agent 应用的可靠性有了实质性进步。

工具调用（Function Calling）是大模型走向实际应用的关键能力。2025 年的变化包括：

标准化：OpenAI 定义的 function calling 格式已经成为事实标准，主流开源模型都支持
准确率提升：在 Berkeley Function Calling Leaderboard 上，开源模型的最佳成绩已经非常接近 GPT-4
复杂调用：从单步调用发展到多步调用、嵌套调用、并行调用，模型可以完成更复杂的任务链
MCP 协议：Anthropic 推出的 Model Context Protocol 为工具调用提供了统一的接口规范，生态正在快速建立

值得关注的模型

Llama 系列

Meta 持续更新，生态最完善，微调资源最多。Llama 3.1 提供了 8B、70B、405B 三个规格，覆盖从端侧到云端的完整需求。Hugging Face 上的衍生模型超过 10 万个，社区活跃度无人能及。

优势：社区大、资源多、微调工具链成熟。劣势：中文能力相对弱于 Qwen，大规格模型的推理成本高。

Qwen 系列

阿里出品，中文能力突出，对中文用户友好。Qwen 2.5 在多个中文基准上表现优异，同时英文能力也在快速追赶。最新的 Qwen 2.5 提供了从 0.5B 到 72B 的完整规格线。

优势：中文能力强、规格线完整、开源协议友好。劣势：英文社区影响力不如 Llama，部分工具链适配滞后。

Mistral 系列

法国团队，以小博大，推理效率高。Mistral 的模型以参数效率著称——用更少的参数达到相近的效果。Mixtral 8x7B 的 MoE 架构在推理时只激活部分参数，实现了性能和效率的平衡。

优势：推理效率高、架构创新、欧洲数据合规友好。劣势：大规格模型缺失，中文能力一般。

DeepSeek 系列

国内团队 DeepSeek 在 2025 年初的表现令人瞩目。DeepSeek-V3 和 R1 在推理任务上展现了极强的竞争力，尤其是 R1 的思维链推理能力在数学和编程任务上接近甚至超越闭源模型。

优势：推理能力强、开源彻底、训练成本控制出色。劣势：生态还在建设中，企业级部署工具链不够完善。

闭源 vs 开源

分析人士指出，开源与闭源之间的能力差距正在缩小，但在复杂推理和超长上下文任务上仍有明显差距。对于大多数实际应用场景，开源模型已经足够。

几个具体维度的对比：

维度	开源	闭源
通用对话	接近	略优
复杂推理	差距缩小	仍有优势
代码生成	接近	接近
多模态	快速追赶	领先半年
超长上下文	差距较大	明显优势
成本控制	优势明显	API 费用高
数据隐私	完全可控	依赖第三方

对于企业来说，选择开源还是闭源不再是一个非此即彼的问题。很多团队的做法是：核心业务用开源模型私有化部署，探索性项目用闭源 API 快速验证。

开发者生态

2025 年开源大模型的开发者生态也发生了显著变化：

微调工具链成熟：Axolotl、LLaMA-Factory、Unsloth 等工具让微调的门槛大幅降低。以前需要写大量训练代码，现在准备好数据集、选好参数就能开始训练。

推理引擎竞争：vLLM、TensorRT-LLM、SGLang 等推理引擎在吞吐量和延迟上持续优化，部署成本进一步下降。

评估标准统一：Open LLM Leaderboard、AlpacaEval、MT-Bench 等评估基准帮助开发者快速对比不同模型的表现。

模型合并兴起：不需要训练，通过合并多个现有模型的权重来创造新模型。DARE、TIES 等合并策略让社区可以快速迭代出针对特定场景优化的模型。

展望

2025 年下半年，几个方向值得持续关注：

推理效率：MoE 架构和投机解码（Speculative Decoding）技术会进一步降低推理成本
长上下文：128K 以上的上下文窗口会成为标配，RAG 的必要性可能会被重新评估
Agent 生态：模型能力不再是瓶颈，Agent 框架和工具生态会成为竞争焦点
合成数据：用大模型生成训练数据来训练小模型的范式会更加成熟

开源大模型的黄金时代才刚刚开始。

设计系统演示 (Design System Demo)

Thu, 16 Apr 2026 00:00:00 +0000

本文是一篇用于展示“克制、书卷气”前端设计的演示文章。它尽可能详尽地包含了博客排版中常见的所有基础与高级 Markdown 元素，方便您直观地预览全局设计语言。

1. 文本排版与格式

在这里，我们测试基础的文字排版效果。我们选用了华文中宋作为主要字体，赋予页面纸质阅读的沉浸感。大行高（2.0）与适当的字间距（0.02em）让视线能够在字里行间自由呼吸。

这也是一段包含加粗 (Bold)、斜体 (Italic)、~~删除线 (Strikethrough)~~ 以及高亮标记 (Highlight) 的测试文本。中英文混排时，适当的间距也是优雅阅读的关键，例如 Apple、Design 以及 Typography。我们还可以添加上标和下标：H₂O 和 X²。

如果你需要引用外部链接，可以点击这里访问 Google 或者查看文章底部的脚注。

2. 杂志风引用块

这是我们最新优化的杂志风格引用块。它去除了沉重的背景和边框，回归文字本身的力量：

“在一片喧嚣的互联网中，克制是一种稀缺的品质。设计不是为了填满屏幕，而是为了引导视线，让读者与文字本身产生对话。”

—— 摘自《设计与留白》

并且它支持多段落和嵌套：

第一层引用，讨论了排版的基本原则。

这是嵌套的第二层引用，通常用于引用中的引用或多重视角对话。

3. 媒体与图片融合

在亮色模式下，图片会带有极其微弱的 1px 边框；而在深色模式下，它会自动降低亮度并去除边框（Media Blending），以免刺伤眼睛。鼠标悬浮于图片之上时可恢复其原本的亮度。

4. 代码块与视觉降噪

所有的代码块顶部都加上了轻盈的红黄绿小圆点（Mac-style dots）。同时，原生厚重的复制按钮被隐藏了。当您将鼠标悬浮在代码块上时，右上角的语言标签（如 PYTHON）会优雅地隐去，而纯文本的 Copy 按钮会平滑地在原位置浮现出来。代码的字体也做了 Fallback 优化。

def fibonacci(n):
    """
    计算斐波那契数列的第 n 项
    """
    if n <= 0:
        return 0
    elif n == 1:
        return 1
    return fibonacci(n-1) + fibonacci(n-2)

# 测试代码
print(f"The 10th Fibonacci number is {fibonacci(10)}")

我们也支持行内代码的渲染：例如在终端中执行 sudo apt update 或 npm install。

5. 复杂的表格

下面展示了一个支持对齐方式的 Markdown 表格排版，表格本身也没有多余的粗边框，保持极致干净：

属性 (左对齐)	值 (居中)	描述 (右对齐)
`margin`	`10px`	控制外边距
`padding`	`2em`	控制内边距
`border`	`none`	移除所有边框

6. 列表系统

无序列表，常用于随意的列举：

第一项：极简滚动条 (Minimalist Scrollbar)
第二项：极细分割线 (Hairline Borders)
- 子项目 A
- 子项目 B
第三项：双主题平滑切换 (Dark/Light mode)

有序列表，带有明确的顺序：

构思设计语言
调整 CSS 变量
1. 定义颜色
2. 调整间距
部署与重构

任务列表（Task List），用于待办事项跟踪：

修复 LaTeX 无法渲染的问题
优化代码块文字与右上角按钮交互
补全所有 Markdown 元素的测试样例
继续撰写新的博客文章

7. 数学公式 (LaTeX)

感谢注入了 KaTeX 引擎，现在博客可以完美渲染复杂的数学公式了。

这是行内公式的展示：质能方程 $E = mc^2$ 以及欧拉公式 $e^{i\pi} + 1 = 0$。

这是块级公式（Display Math）的展示，支持多行和积分等复杂符号：

$$ \mathcal{L} = \int \left( \frac{1}{2} (\partial_\mu \phi)(\partial^\mu \phi) - \frac{1}{2} m^2 \phi^2 \right) d^4x $$$$ f(x) = \int_{-\infty}^\infty \hat f(\xi)\,e^{2 \pi i \xi x} \,d\xi $$

8. 交互折叠块 (Details / Summary)

我们还为原生的 HTML 折叠块添加了平滑的下拉动画：

{{< details “点击这里展开查看隐藏的惊喜” >}} 这是被隐藏的内容！在点击上方文字后，它会带有平滑的向下展开动画（slide-down animation）浮现出来。非常适合用于剧透警告或大段非核心代码的折叠。 {{< /details >}}

总结

所有的细节（如边框、阴影、间距、字体权重的把控，以及修复后的代码展示与数学公式）共同构成了目前的“纯粹书卷”风格。您可以利用右上角的太阳/月亮图标，随时切换深浅模式，查看这些元素在不同光线下的表现。

一个人的深夜食堂

Thu, 16 Apr 2026 00:00:00 +0000

凌晨十二点，冰箱里只剩半块豆腐、两个鸡蛋和一把小葱。

这种时候不适合想太多。烧水、切豆腐、打蛋，动作自然而然地接起来。油热了倒进去，滋的一声，整间厨房一下子有了烟火气。

做好端上桌，配一碗白米饭，窗外偶尔有车驶过。没什么特别的，但吃完感觉好多了。

深夜做饭这件事，有一种白天很难体会到的专注。

白天做饭的时候，脑子里总在转别的事情——下午的会议、还没回的消息、明天要交的东西。刀在切菜，心思却不在。有时候切完一盘黄瓜，发现自己根本不记得是怎么切的。

但深夜不一样。整个世界都安静了，没有消息要回，没有电话会响。你只需要面对眼前的食材，听油在锅里的声音，闻葱花遇到热油时瞬间爆发的香气。每一个动作都被放大了，每一个细节都变得清晰。

这种专注本身就很治愈。

我深夜做得最多的是三样东西：蛋炒饭、番茄鸡蛋面、葱油拌面。

蛋炒饭的关键是隔夜饭。刚煮好的米饭太湿，炒不出粒粒分明的效果。头天晚上多煮一点，放冰箱过夜，第二天晚上拿出来刚好。油热了先把蛋液倒进去，半凝固的时候把饭倒进去一起翻炒，让每一粒米都裹上蛋液。最后撒一把葱花，盐都不用放太多，米饭本身的甜味就出来了。

番茄鸡蛋面更简单。番茄切块，炒出汁，加水煮开，下面条，打个蛋花进去。整个过程不超过十分钟，但热汤下肚的那一刻，整个人从胃暖到心。

葱油拌面是跟一个朋友学的。小葱切段，小火慢炸，等葱变成深棕色、变得酥脆的时候捞出来。面条煮好过凉水，拌上葱油、生抽、一点点糖。简单到不能再简单，但那个葱油的香气能让人暂时忘掉所有烦心事。

深夜做饭还有个好处：没有人评判你。

白天做饭，总会不自觉地想这道菜够不够好看、味道够不够好、是不是太简单了。但深夜的厨房是完全属于你自己的空间。你可以把鸡蛋煎糊了重来，可以把面条煮烂了也照吃，可以把所有调料都放多一点——反正是给自己吃的，怎么开心怎么来。

我有个朋友说，他深夜最喜欢做的是泡面加芝士片和午餐肉。听起来很粗糙，但他说那是他一天中最放松的时刻。我觉得这就够了。

有时候做着做着，会想起一些很久没想起的事。

切豆腐的时候想起小时候妈妈做麻婆豆腐的样子——她总是先把豆腐在盐水里泡一会儿，说这样豆腐不容易碎。我不知道这个技巧有没有科学依据，但我每次切豆腐前都会泡一下，好像这样就能和她多一点联系。

打蛋的时候想起大学食堂的番茄炒蛋。食堂阿姨做的番茄炒蛋永远是甜的，我一开始觉得奇怪，后来吃了四年，竟然也习惯了。现在自己做的时候，偶尔也会放一小勺糖。

食物是记忆的容器。你以为你只是在做饭，其实你是在和过去的自己对话。

很多时候治愈自己的方式就这么朴素：给自己认认真真做一顿饭，哪怕只是豆腐炒蛋。

不需要摆盘，不需要发朋友圈，就是坐在自己家的桌前，安静地吃完，然后洗碗，然后睡觉。

有时候我觉得，一个人能把自己照顾好，就已经很了不起了。

吃完饭，把碗筷洗干净放好，擦干净灶台。厨房恢复整洁，好像什么都没发生过。

但你知道，那顿饭已经安安静静地完成了它的使命。

关灯，回房间。窗外的城市还在运转，但此刻的你是安静的。带着一点点饱足感和一点点困意，钻进被窝。

明天又是新的一天，但至少今晚，你好好吃了顿饭。

我认识的人里，深夜做饭的不少。

有个朋友喜欢在凌晨烤面包。他说喜欢面团发酵的过程——你把酵母揉进去，然后等待，面团会自己膨胀起来。这种"你什么都不用做，它自己会变好"的感觉让他安心。

另一个朋友深夜只煮粥。白米粥，什么都不加，煮到米粒开花。她说小时候生病了妈妈就煮这个，所以每次觉得累的时候就想喝一碗。

还有人深夜只泡茶。不是什么名贵的茶，就是普通的茉莉花茶，烧一壶开水，看茶叶在杯子里慢慢舒展。喝茶本身不算做饭，但那种仪式感是一样的——你在用一个简单的动作告诉自己：今天到此为止了。

深夜的厨房是一个很特别的空间。

它不像白天的厨房那样功能明确——早餐匆匆忙忙烤个面包，午餐晚餐有固定的菜式。深夜的厨房是自由的，你可以做任何你想做的东西，没有"应该吃什么"的约束。

也不像深夜的酒吧或便利店——那些地方虽然也属于深夜，但它们是公共的，你只是其中一个顾客。厨房是完全私密的，只有你一个人，只有你和食物之间的对话。

我觉得每个人家里都应该有一个这样的角落。不一定是厨房，也可以是阳台、书房、甚至浴室。一个你在深夜可以去的地方，做一件简单的事，让自己从白天的喧嚣中安静下来。

写到这里，已经凌晨一点了。

窗外的车声更少了，远处偶尔传来一两声狗叫。厨房的灯还亮着，灶台擦得很干净，锅里还有一点余温。

明天我会在正常时间起床，正常时间吃早饭、午饭、晚饭。深夜做饭这件事会被日常的节奏覆盖，就像什么都没发生过。

但我知道，在某个睡不着的夜晚，我还会走进厨房，打开冰箱，看看有什么能做的。

因为有些时候，最好的治愈不是别的，就是给自己认认真真做一顿饭。

用了三个月 Obsidian，我有话说

Thu, 16 Apr 2026 00:00:00 +0000

三个月前，我把笔记软件从 Notion 换成了 Obsidian。现在回头看，这是今年做得最对的几件事之一。

最喜欢的地方

本地存储让我彻底告别了万一服务器挂了怎么办的焦虑。所有笔记都是纯 Markdown 文件，用任何编辑器都能打开。

这一点在实际使用中比想象中更重要。Notion 的数据导出虽然支持 Markdown，但格式经常出问题——嵌套的数据库、内嵌的图片、复杂的表格，导出来基本没法直接用。而 Obsidian 的笔记从第一天起就是标准 Markdown，不管你以后换什么工具，这些笔记都能无缝迁移。

双向链接一开始觉得是噱头，用了一段时间后发现它真的改变了我的思维方式——记录一个想法时，自然会去想它和哪些旧知识有关联。

举个例子：我在写一篇关于 Docker 的笔记时，提到了网络配置。在 Notion 里我可能就写一句"详见网络配置文档"然后放个链接。但在 Obsidian 里，我直接写 [[Docker 网络配置]]，这会自动建立双向关联——以后打开"Docker 网络配置"那篇笔记时，我能直接看到谁引用了它。

时间长了，这些关联形成了一张知识网络。用 Obsidian 自带的 Graph View 看，你能直观地看到哪些概念联系紧密、哪些领域你还涉足不深。这种可视化的知识地图是传统文件夹结构做不到的。

插件生态非常丰富。从日历视图、Kanban 看板到 LaTeX 公式渲染，几乎你能想到的需求都有插件覆盖。

我目前在用的插件清单：

Calendar：日历视图，快速定位到某一天的日记
Dataview：把笔记当数据库查询，比如"列出所有未完成的任务"
Templater：高级模板引擎，新建笔记自动填充日期、标题等
Tasks：跨笔记的任务管理，支持到期日、重复任务
Excalidraw：在笔记里嵌入手绘图，适合画架构图和流程图
Kanban：看板视图，适合项目管理
Git：自动同步笔记到 Git 仓库，相当于免费的版本控制和备份

不太满意的地方

移动端体验比桌面端差一截，同步需要额外付费或自己折腾 iCloud / Syncthing。对于重度手机用户来说，这是一个实际的障碍。

具体来说：

同步方案：官方的 Obsidian Sync 要 8 美元一个月，对个人用户来说不算便宜。免费方案是 iCloud（仅限苹果设备）或 Syncthing（需要一定技术能力）。我目前用的是 iCloud，偶尔会遇到同步冲突
移动端性能：打开大型 Vault 时明显比桌面端慢，插件加载也需要等
编辑体验：手机上编辑 Markdown 不如在电脑上顺畅，尤其是长文档

学习曲线也比 Notion 陡一些——刚上手时面对空白的 Vault 可能会有点迷茫，不知道从哪里开始组织。

Notion 的开箱即用体验确实更好：数据库、看板、日历都是内置的，不需要装插件就能用。而 Obsidian 的很多核心功能需要通过插件实现，新手面对上百个插件可能会选择困难。

我的建议是：不要一开始就装太多插件。先用原生功能写两周笔记，等你真正感到"要是有个 XX 功能就好了"的时候，再去搜插件。这样你装的每一个插件都是真正需要的，不会被花哨的功能分散注意力。

和 Notion 的对比

维度	Obsidian	Notion
数据存储	本地 Markdown 文件	云端专有格式
离线使用	完全支持	部分支持
双向链接	原生支持，体验好	支持但不够自然
插件生态	极其丰富	有限的集成
协作	弱（需要额外工具）	强（原生支持）
数据库	通过 Dataview 插件	原生支持，体验好
学习曲线	较陡	平缓
价格	免费（同步另算）	免费版有限制
数据导出	天然 Markdown	导出格式有限

简单来说：Obsidian 适合个人深度使用，Notion 适合团队协作。如果你的笔记主要是给自己看的，Obsidian 更好；如果需要频繁和别人共享、协作编辑，Notion 更方便。

我的使用场景

经过三个月的摸索，我目前的 Obsidian 主要用于三个场景：

技术笔记：学习新技术时记录要点、代码示例、踩坑记录。用标签分类（#docker、#python、#前端），用双向链接把相关概念串起来。这是我用得最多的部分。

日记：用 Templater 插件自动创建每日日记模板，记录当天做了什么、遇到什么问题、有什么想法。不用写很多，几句话就行。回头看的时候能清楚地看到自己这段时间在忙什么。

项目管理：用 Kanban 插件管理待办事项。每个项目一个看板，分"待办"、“进行中”、“已完成"三列。比单纯的待办清单更直观，也比 Notion 的数据库更轻量。

适合谁用

愿意花时间配置，且主要在电脑上工作的人 → 强烈推荐
需要开箱即用、多端无缝同步 → Notion 可能更适合
学术党、需要大量引用和 LaTeX → 非常适合
程序员、技术人员 → 强烈推荐（Markdown 是你们的母语）
写作者、需要长期积累知识体系的人 → 非常推荐
需要团队协作、多人编辑 → 不推荐，用 Notion 或飞书

一些实用建议

如果你决定尝试 Obsidian，以下是我踩过坑后总结的建议：

先用起来再优化：不要花一周时间研究插件和主题，先写笔记。等你对工具足够熟悉后，再根据需求调整
文件夹结构保持简单：三层以内就够了。我见过有人建了七八层目录，最后自己都找不到笔记在哪
善用标签：标签比文件夹灵活，一个笔记可以有多个标签。我的习惯是用标签做主题分类，文件夹只按时间或项目分
定期回顾：每周花 10 分钟翻翻最近的笔记，看看有没有可以合并或整理的。笔记不回顾等于没记
备份一定要有：虽然本地存储很安全，但硬盘坏了就是没了。用 Git 或者云盘同步至少一份副本

常见问题

Q：Obsidian 免费吗？ A：软件本身完全免费，包括所有核心功能。收费的只有两个可选服务：Obsidian Sync（云同步，8 美元/月）和 Obsidian Publish（发布笔记为网站，16 美元/月）。对于大多数用户，免费功能完全够用。

Q：从 Notion 迁移过来麻烦吗？ A：Notion 支持批量导出为 Markdown，导出后丢进 Obsidian 的 Vault 文件夹就行。图片链接需要手动修复（Notion 导出的图片路径格式不同），但文本内容基本没问题。我迁移了大约 200 篇笔记，花了一个下午。

Q：数据安全吗？ A：本地存储意味着你的数据完全在你手里，不受任何服务商的影响。但反过来，你也需要自己负责备份。我的方案是 Git 仓库 + iCloud 双重备份，基本不用担心数据丢失。

Q：插件会不会导致笔记数据被读取？ A：Obsidian 插件是运行在本地的 JavaScript 代码，理论上可以访问你的文件。但 Obsidian 的插件审核比较严格，而且代码都是开源的。如果你特别在意隐私，可以只安装你信任的插件，或者自己审查代码。

最终评价

三个月用下来，Obsidian 给我最大的感受是：它尊重你的数据。

不像 Notion 把你的笔记锁在云端、用专有格式存储，Obsidian 把一切交给你。你的笔记就是普通的 Markdown 文件，存在你的硬盘上，你想怎么备份就怎么备份，想用什么工具打开就用什么工具打开。

这种开放性是有代价的——你需要自己处理同步、自己选择插件、自己组织结构。但换来的是完全的控制权和自由度。

对于我这种主要在电脑上工作、喜欢折腾、重视数据所有权的人来说，这个交换非常值得。

第一篇文章

Wed, 15 Apr 2026 00:00:00 +0000

欢迎来到 Xiang’s Blog！

这里会记录我的学习笔记、论文心得和个人思考。

Changelog

Mon, 01 Jan 0001 00:00:00 +0000

站点更新日志

2026-05 全面优化

引入 Palatino + 华文中宋双字体方案，Latin/CJK 自动匹配
RSS 支持 XSL 样式渲染
首页增加社交图标（GitHub、Email、RSS）
评论系统深度定制（字号、编辑器、IP 属地、楼中楼）
文章页增加图片放大、标题锚点、TOC 高亮、相关推荐
引用块改为左侧竖线样式
翻页导航视觉优化

2026-04 站点上线

Hugo + PaperMod 搭建
自定义 CSS 设计系统（Catppuccin 配色）
Twikoo 评论系统集成
KaTeX 数学公式支持
日夜模式切换

Contact

Mon, 01 Jan 0001 00:00:00 +0000

联系我

GitHub：github.com/nasymonk
Email：2947461909@qq.com

欢迎技术交流与讨论。文章中的疑问可直接在对应页面评论区留言。

Copyright

Mon, 01 Jan 0001 00:00:00 +0000

版权声明

本博客所有原创文章，除特别说明外，均采用 CC BY-NC-SA 4.0 许可协议。

你可以自由地：

分享 — 在任何媒介复制和分发本作品
演绎 — 修改、转换或以本作品为基础进行创作

但需遵守以下条件：

署名 — 必须给出适当的署名，提供指向本许可协议的链接
非商业性使用 — 不得将本作品用于商业目的
相同方式共享 — 如果你修改或基于本作品创作，必须以相同许可协议分发

博客中的代码片段（如无特殊说明）可自由使用，不受上述协议限制。

Now

Mon, 01 Jan 0001 00:00:00 +0000

此刻在做

受 Derek Sivers /now page 启发，记录当前阶段的状态。

学习：持续关注 LLM / Agent 方向，补系统设计与分布式基础。

阅读：重读《Designing Data-Intensive Applications》。

生活：规律作息与间歇性断食实验中。

最后更新：2026 年 5 月

Privacy

Mon, 01 Jan 0001 00:00:00 +0000

隐私说明

本博客为个人站点，原则上不收集任何访客个人信息。

评论系统使用 Artalk，评论内容存储于博主自有服务器。提交评论时你可能需要填写昵称、邮箱（可选）、网址（可选）。邮箱仅用于 Gravatar 头像展示，不会公开或用于其他用途。

访问日志由 Nginx 默认记录，包含 IP 地址、访问时间、User-Agent 等，仅用于排查技术问题，不会与第三方共享。

本博客不嵌入任何第三方追踪脚本或广告。

关于

Mon, 01 Jan 0001 00:00:00 +0000

👋 你好

我是 Xiang，一个对技术充满好奇的学生。日常和大模型、容器、开发工具打交道，偶尔也在深夜厨房里给自己做一顿饭。

这个博客是我的数字笔记本：记录学到的东西、踩过的坑、以及那些值得写下来的思考。如果某篇文章对你有帮助，或者你有不同的想法，欢迎在评论区聊聊。

Xiang's Blog

Claude Code 使用指南

一、安装与启动

二、会话管理

2.1 终端命令

2.2 会话内命令

三、权限模式

3.1 六种模式

3.2 切换方式

四、模式切换命令

五、代码与审查

六、权限与配置

七、任务与调度

7.1 任务（Task）系统

7.2 定时调度细节

八、Skills（技能）系统

8.1 技能 vs CLAUDE.md

8.2 内置技能

8.3 创建自定义 Skill

8.4 技能调用与生命周期

九、Hooks（钩子）系统

9.1 所有事件一览

9.2 钩子类型

9.3 退出码规则

9.4 配置位置

9.5 典型用法

十、快捷键

10.1 输入编辑

10.2 模式与界面

10.3 输入技巧

十一、上下文管理

11.1 核心概念

11.2 省上下文技巧

十二、Worktree（工作树）

十三、非交互（Headless）模式

十四、Checkpoint 与 Rewind

十五、Agent Teams（代理团队）

十六、IDE 与编辑器集成

十七、状态栏

十八、账号与费用

十九、常用工作流实例

代码审查

持续监控

大规模重构

计划优先

跨会话工作

安全审查

Git 最佳实践

1. Git 要解决什么问题

2. 初始状态检查

3. 必备：.gitignore

3.1 检查 .gitignore 是否生效

3.2 如果发现上述目录出现在 status 里（被追踪了）

4. 建立第一个"稳定节点"（baseline checkpoint）

4.1 初始化仓库（若还没执行过）

4.2 将当前版本加入暂存区

4.3 检查将提交内容（推荐必做）

4.4 创建第一次提交（基线）

5. 打标签：做"回滚锚点"

5.1 给当前提交打标签

5.2 查看标签是否存在

5.3 查看最近提交（带标签信息）

6. 分支策略

规则

6.1 创建并切换到功能分支

6.2 查看当前分支

7. 日常工作流

7.1 每次开始一个新功能

7.2 开发过程中查看改动

7.3 分阶段提交

7.4 完成一个里程碑，打标签（可选）

8. 回滚方式

8.1 推荐回滚：从某个 tag 开新分支继续开发（最安全）

8.2 只"查看"某个 tag 的版本（不建议长期停留）

8.3 强制把当前分支回到某个 tag（慎用：会丢未提交内容）

9. 推荐 tag 命名

10. 可选：接入远端仓库

10.1 添加远端

10.2 推送 main 和 tags

11. 最常用命令速查

3.1 检查 `.gitignore` 是否生效