Claude Code 完全手册：上手、Harness、MCP、记忆与赛博状态栏

一、进化史：从终端 REPL 到 AI 原生平台

二、17 个功能模块逐个说透

这一节是重头戏。每个模块按”是什么 → 能干什么 → 怎么用 → 什么时候用”来讲。

2. Subagents：独立上下文的专业助手

子代理有自己独立的上下文窗口、独立的系统提示和工具权限，干完只把摘要带回主会话。这是省上下文最重要的工具之一，官方原话”上下文是根本约束时，subagents 是最强大的工具之一”。

内置几个常用的：Explore（只读快速研究代码库）、Plan（计划模式的研究助手）、general-purpose（全工具复杂任务）、claude（兜底 + 后台会话默认代理）。你可以自己定义 .claude/agents/<名字>.md，指定它的工具白名单、模型（比如用 haiku 省钱）、权限模式。

调用方式有四种：直接说”让 subagent 调研一下 X”、@agent-名字 强制指定、整会话切换 claude --agent 名字、或者临时定义。嵌套默认 3 层，每会话最多 200 个，并发 20。

2.1.198 之后子代理默认在后台跑，主会话更清爽。.claude/agents/ 里定义的代理还能指定 tools: 限权，这是很强的安全手段——比如审查代理只给只读工具。

8. Background agents：关掉终端任务照跑

后台代理是没有终端附着的完整会话，由 per-user 的 supervisor 进程托管。启动方式 claude --bg "提示词"，会话内 /bg 转后台、/fork 复制成后台新会话。

管理入口是 claude agents 打开的 agent view，单屏按状态分组显示所有后台会话（需要输入 / 工作中 / 空闲 / 完成 / 失败），每行有 Haiku 生成的摘要。管理命令有 attach、logs、stop、respawn（保留对话重启）、rm。

一个重要的细节：后台会话改文件前会先移进 .claude/worktrees/ 独立 worktree，并行会话互不干扰。遇到权限询问会进”需要输入”状态，你可以在面板里直接回复。Notification hook 能推送”需要你输入”和”任务完成”的通知。适合长跑测试、隔夜 CI 失败分析、离开电脑任务继续。

15. IDE 集成：VS Code / JetBrains / Desktop

同一套引擎嵌进编辑器。VS Code 扩展功能最全：内联 diff 对比 + 直接改提案、@-mention 带行号选区（@auth.ts#5-10 直接引用文件某几行）、plan 以 Markdown 打开可加批注、会话历史恢复、checkpoint rewind、图形化插件管理器、@browser 浏览器自动化。JetBrains 插件支持 IntelliJ/PyCharm/WebStorm/GoLand/Android Studio，有 IDE diff viewer、选区 + 诊断自动共享、Cmd+Esc 快速唤起。Desktop 独立应用提供并行会话窗格、可视化 diff、定时任务、内置浏览器、iOS Simulator 面板。

所有 surface 共享同一套配置：CLAUDE.md、settings、MCP、hooks 全通用，不存在”换个入口配置就丢了”。

三、哪些模块最值得先上

不分场景空谈”哪个最强”没意义，按阶段给建议。

第一天先用起来的：核心交互（进项目直接提问、@-引用、贴图）、plan 模式、Esc 停手 / /rewind 回滚 / /clear 重置、claude --continue。这个阶段就把 Claude 当”超级结对工程师”用，先不开任何扩展。

第一周建立基线：/init 生成 CLAUDE.md（补上构建/测试命令）、装 gh CLI、配 1-2 个 hook（编辑后 lint / 通知）、装语言对应的 code intelligence 插件、每周固定用一次 /code-review 审自己的 diff。CLAUDE.md 压到 200 行以内。

进阶规模化：自定义 Skills（/commit、/deploy）、自定义 Subagents（security-reviewer、test-runner）、接 MCP（数据库/Figma/办公套件）、claude -p 接 CI + fan-out 批量、worktrees 并行、Writer/Reviewer 双会话、auto mode 无人值守、Agent Teams。

判断要不要上某功能的铁律：约定错两次 → 写进 CLAUDE.md；同一个 prompt 贴了三次 → 沉淀成 skill；侧任务刷屏主上下文 → 上 subagent；“想让它每次都发生” → 写成 hook。这套按需加载的思路，比一次性把所有功能堆上更省心。

四、11 个场景怎么落地

每个场景给出推荐的特性组合和操作步骤，照着做就行。

结尾

把这 356 个版本扒完，最深的感受是：Claude Code 已经不只是一个”写代码的工具”，而是一套让你和 AI 在软件开发的每个环节都能协作的体系。它强在组合：单拎任何模块都有替代品，但把记忆、技能、子代理、钩子、权限、插件、后台、云端串成一个闭环的，目前独一份。

官方文档入口：code.claude.com/docs（best-practices、features-overview、skills、sub-agents、hooks、permission-modes 这几个页面最值得先看）。本文数据截止 Claude Code 2.1.223。

Loop 到底在转什么

Agent 持续重复：获取上下文 → 行动 → 验证 → 迭代，直到停止条件成立。

简单任务别一上来就上重型循环——先从简单方案开始；真要自动化，再把触发、验证、停止写清楚。

四要素记死：

路径同一条：理解任务 → 行动 → 验证 → 迭代 → 完成。

四类 Loop：交出的权力不一样

从左到右，人从「每步盯着」退到「只设计规则」——权力交出去多少，成本与失控面也跟着涨多少。

想让 Loop 别瞎转：质量、验收、Token

提升质量（图上四条）

1. 代码整洁——乱仓库里循环只会放大乱
2. 自验证 skills——别指望「我觉得好了」当验收
3. 上下文可达——它够不着的文件/环境，再转也白转
4. 双 Agent 审查——一个写、一个挑刺，比单人自嗨稳

把人工验收写进 SKILL.md（失败就从第 1 步重来）

• 起 / 盯本地 dev server
• UI 对比（改前改后）
• 看 console 有没有炸
• 有条件就接 Chrome DevTools MCP

验收不进 skill，回合式也会变成「你口头复查」的体力活；进了 skill，目标式 / 主动式才敢放手。

Token 别被 routine 吃干

• 小任务用小 loop
• 成功标准写死
• 先 dry run
• 确定性工作优先脚本，别全塞给模型
• routine 别过度频繁
• 用 /usage 盯消耗

设计哲学其实就一句：关键不是让 Agent 无限干活，而是设计好触发、验证、停止条件与成本边界。

三步上手，别一上来就全自动

1. 找瓶颈——现在卡在检查、停不准、触发烦，还是整条流都得你人肉推？
2. 决定交出哪一段——对照上表：检查 / 停止条件 / 触发时机 / 整条任务流
3. 小规模试跑——先短任务、少回合、宽一点的 /usage 观察，再收紧节奏

图脚那句够当座右铭：不是无限转，是把边界设计进循环。

总览：一张树看完落点

图左是推荐树，图右是八块作用。路径示意（与图一致）：

1
CLAUDE.md
2
CLAUDE.local.md
3
.mcp.json
4
.claude/
5
  settings.json
6
  settings.local.json
7
  rules/
8
    code-style.md
9
    testing.md
10
    api-conventions.md
11
  commands/
12
    review.md
13
    fix-issue.md
14
  skills/
15
    deploy/
16
      SKILL.md
17
      deploy-config.md
18
  agents/
19
    code-reviewer.md
20
    security-auditor.md
21
  hooks/
22
    validate-bash.sh

CLAUDE.md：会话开箱的项目记忆

路径：仓库根 CLAUDE.md，可用 CLAUDE.local.md 覆盖。

图面作用：

• 会在会话开始时加载
• 定义项目概览、技术栈和常用命令
• 包含编码约定与架构说明
• 支持通过 CLAUDE.local.md 进行覆盖

只放「每次会话都成立」的高信号约定；细则按主题拆进 rules/，流程进 skills/ / commands/。

.mcp.json：MCP 集成怎么挂进仓库

路径：仓库根 .mcp.json。

图面作用：

• 存放 MCP 集成配置
• 可连接 GitHub、JIRA、Slack、DBs
• 可通过 git 在团队内共享

这是「连外部」的配置位，不是再往 CLAUDE.md 里贴一长串服务说明。和 MCP / Skills / CLI 怎么分工 那篇分工不同：本篇只标落点。

settings.json：权限、模型与 hooks 开关

路径：.claude/settings.json，可用 .claude/settings.local.json 覆盖。

图面作用：

• 控制权限与工具访问
• 定义模型选择和 hooks
• 支持 settings.local.json 覆盖

团队共享默认权限与模型偏好；本机私货进 *.local.json，别把个人密钥和临时放开写进会进 git 的那份。

rules/：按主题拆的模块化规矩

路径：.claude/rules/（图例：code-style.md、testing.md、api-conventions.md）。

图面作用：

• 按主题拆分的模块化 .md 文件
• 覆盖风格、测试、API 设计等内容
• 可作用于特定文件或路径

风格、测试、接口约定各自成篇，比堆进一个巨型 CLAUDE.md 好改、好 review。

commands/：可重复的斜杠工作流

路径：.claude/commands/（图例：review.md、fix-issue.md）。

图面作用：

• 自定义斜杠命令（/project:<name>）
• 用于可重复执行的工作流
• 支持执行 shell 命令

「每次都要走同一套审查 / 修 issue」→ 写成 command，别口头复读。

skills/：按需加载，上下文更轻

路径：.claude/skills/<name>/（图例：deploy/SKILL.md、deploy-config.md）。

图面作用：

• 会根据任务上下文自动触发
• 仅在需要时加载
• 保持上下文更轻量

和「每次会话都加载」的 CLAUDE.md 对照着看：Skill 是任务触发才进场，不是常驻说明书。

agents/：带角色、隔离上下文的子代理

路径：.claude/agents/（图例：code-reviewer.md、security-auditor.md）。

图面作用：

• 带有明确角色的专子 agent
• 拥有隔离的上下文窗口
• 可配置自定义工具和模型偏好

审查、安全审计这类「换一副脑子」的活，适合独立 agent，而不是在主会话里口头扮演。

hooks/：工具前后的事件脚本

路径：.claude/hooks/（图例：validate-bash.sh）。

图面作用：

• 事件驱动脚本（工具调用前/后）
• 自动执行校验、lint 和格式化
• 阻止不安全操作

必须每次发生的强制门禁 → hooks；可重复但按需触发的流程 → commands / skills。

怎么拆：按主题拆、按需加载

选型就一句：按主题拆文件，按需加载进上下文。

配置一多，优先拆层，而不是继续加厚那一个 CLAUDE.md。

先把树拆开，再谈某一层写多厚——顺序反了，又会回到「一个文件扛所有」。

三张榜各自吃哪口痛

先认能力与类别，再决定去哪找实现。名字好看不等于能 npx skills add。

17 件套：痛哪类拿哪类

一次装满没意义。痛哪类就从那类拿 1～2 个，跑通再加。

设计类里，Taste 偏从零 / 重做观感，Impeccable 偏命令面 + 页内点选改——别两个一起上来搅浑。审美深潜另有专帖，这里只记它在 17 件里站「审美入口」位。

效率类真正可复用的，往往不是再塞三个 skill，而是 Ponytail 那套写前五问：真需要写吗？库里有没有？标准库够不够？平台原生有没有？已有依赖能否一行解决？gh + Skill Creator 我认作地基：issue / PR / release 能在终端闭环，你自己还能造轮子。

数据类按需开抽屉。常爬网页再上 Firecrawl CLI；常要外部热点再上 Last 30 Days。GWS / Stripe / Supabase 按你是否真的碰 Workspace、收款、后端再决定。说不出「它替我省掉哪一步」，就卸。

Playwright 选型口诀：Agent 长会话里偶发点网页，MCP 可能更省事；批跑、脚本化、控成本，优先 CLI。

两张 Top10：能力备忘，不是安装清单

协作榜堵的是对齐乱、PR 说不清、老人带不动新人。按痛点裁：

自动化榜堵的是重复劳动。按段拆开看：

两张榜名单几乎不重叠。别当成同一表的续集，也别跟 17 件套逐条合并——切面不同。

差分一眼看完

撞名不等于可装。生态里能搜到能力相近的 Playwright / changelog / CI 修复类 skill，那是别的仓库、别的名字，不能偷换成「就是榜上这十个」。

我会怎么装

如果是我自己的机器，顺序大概是：

1. gh + Skill Creator（地基）
2. 痛 UI 再上 Taste 或 Impeccable 其中一个
3. 常爬网页再上 Firecrawl CLI；常要外部热点再上 Last 30 Days
4. Ponytail 当习惯补丁，数字当参考，五问当纪律
5. 团队侧先对照协作榜写清「我们缺哪段能力」，再去找可审仓库或自己写同名能力包
6. 自动化侧同理：先标重复劳动段落，再找可核实现

其余当工具抽屉。开了就要能说出替我省掉哪一步。

五层叠皮，缺一层都不对

我盘了下，这套「皮」从上到下是五层：

为什么要分层想？因为每一层都有自己的配置文件和失效方式。最常见的问题就是”改了一处不生效”，然后人懵了。先按层定位：是 provider 断了（401）、Claude 本体配置被冲了（功能消失）、tweakcc 补丁被升级覆盖了（美化没了）、还是终端外观没跟上（背景/字体不对）——大概率不是配置写错，是找错了层。

从装到跑：官方安装 + 两个第三方工具

Claude Code 在 Windows 上官方推荐的就一条命令（PowerShell）：

1
irm https://claude.ai/install.ps1 | iex

装完二进制落在 %USERPROFILE%\.local\bin\claude.exe，原生安装后台会自动更新，claude update 手动更新。想停自动更新就在 settings.json 的 env 里设 DISABLE_AUTOUPDATER=1（只停后台检查，claude update 还能用）。想彻底关用 DISABLE_UPDATES。另外 winget install Anthropic.ClaudeCode 也行，但那个不自动更新。

两个第三方工具是这套配置的骨架：

• tweakcc（npm install -g tweakcc，或 npx tweakcc）：深度美化层，下文重点。
• CC Switch（桌面应用，Tauri 写的）：管 provider 切换，内置本地代理。装完它在 ~/.claude/settings.json 的 env 里写 ANTHROPIC_BASE_URL=http://127.0.0.1:15721 和 ANTHROPIC_AUTH_TOKEN=PROXY_MANAGED，把模型请求都走它的本地代理转发。模型映射（比如把 Sonnet 的请求映射到别的模型）也是它管的。

验证一下装齐没有，claude --version 会同时打印两层：

1
2.1.220 (Claude Code)
2
4.3.2 (tweakcc)

tweakcc 连版本号都注进 claude 里了，一眼能看出补丁活着。

tweakcc：把 cli.js 拆开、改完、再装回去

tweakcc 不是”皮肤包”，它是直接改 Claude Code 的程序本体。它把 minified 的 cli.js 解出来打补丁，原生安装则用 node-lief 从二进制里抽 JS、patch、再重新打包。本机 ~/.tweakcc/ 里躺着 native-claudejs-orig.js / native-claudejs-patched.js（各约 21MB）和一个 265MB 的 native-binary.backup，全是它干活留下的。

因为动的是本体，Claude Code 一升级补丁就会被覆盖，但配置还在——升级后重跑一遍 npx tweakcc --apply 就行（它自己会先恢复备份，保证从干净状态重新 patch）。注意它官方验证过的版本是 2.1.162，现在跑在 2.1.220 上，个别非系统提示类的 patch 可能失效，得留意。

2026-08-09 实测更新：文章发布没几天，Claude Code 悄悄升到 2.1.224，天气思考动画果然又没了。这次验证方法都齐了——claude --version 只剩一行（没有 (tweakcc) 注入的版本行），~/.tweakcc/config.json 里的 ccVersion 还停在 2.1.220，一眼确认补丁被覆盖。重跑 npx tweakcc --apply 却报 EBUSY：claude.exe locked——claude 本体正开着，Windows 锁住 exe 不让写。所以顺序很重要：先完全退出 Claude Code，再在新终端跑 apply。跑完 claude --version 恢复两行输出，天气动画和思考动词随机一起回来。

它到底能改什么？挑值钱的几个：

内置 7 套主题色，截图里这套紫调对应 Dark mode。这套配色的逻辑很清晰：紫管结构（分隔线、提示符、autoAccept），蓝管身份（模型名、权限请求），橙管强调（Claude 品牌色、路径高亮），红管警示（错误、diff 删除）。

思考动画：把「Thinking…」换成一圈天气符号 ☀️→🌤→⛅️→🌥→☁️→🌧→🌨→⛈ 再倒着转回来，100ms 刷一次，很有”算力在涌”的既视感。

思考动词随机：三十多个动词轮着用——Thinking、Pondering、Brewing、Weaving、Distilling……不会再是千篇一律的 Thinking。

输入框高亮：正则把 URL（青）、路径（橙）、行内代码（粉）在输入时即时上色，多行贴代码时一眼能分清。

其它开关：会话标题、隐藏启动横幅、mcpConnectionNonBlocking（MCP 连接不阻塞启动）、enableSwarmMode、enableVoiceMode、enableSessionMemory，还有 claudeMdAltNames 让它在项目里读 AGENTS.md / GEMINI.md / QWEN.md 这些别名当指令文件。

主题字段：custom 是另一层皮

settings.json 里还有一行 "theme": "custom:dracula"，这是另一套主题机制——Claude Code 原生的插件主题，来自 claude-themes 插件（本机同时启用了 dracula 和 tokyo-night 两个）。主题字段的取值有 auto / dark / light 这几个内建档，custom: 前缀指插件或自定义主题，主题文件是 JSON，放着 base + overrides 的颜色 token。

所以这台机器实际是两层主题同时存在：tweakcc 改的是 Claude 程序内部渲染（思考动画、输入框、消息底色这些原生主题管不到的），custom:dracula 管的是 Claude 原生 UI 的颜色 token。改色的时候想清楚改哪个，别在 tweakcc 里调半天发现被 settings 的 theme 盖着，反过来也一样。

底部 HUD：statusLine 机制 + claude-hud 插件

截图底部那条状态栏是 claude-hud 插件（0.6.0）渲染的，走的是 Claude Code 原生的 statusLine 机制：settings.json 里配 statusLine 的 type: "command"，Claude 每次交互后把一个 JSON 从 stdin 喂给这个命令（里面有 model.display_name、workspace.current_dir、context_window.used_percentage、cost.total_cost_usd、rate_limits 这些），命令把它渲染成一行字打印出来。

本机这条 statusLine 命令有三处值得抄：

1
## 动态定位最新版插件目录，升级不用改配置
2
plugin_dir=$(ls -1d "$CLAUDE_CONFIG_DIR/plugins/cache"/*/claude-hud/*/ | sort -V | tail -1)
3
## 用 nvm4w 的 node 跑插件入口
4
exec "/c/nvm4w/nodejs/node" "${plugin_dir}dist/index.js"

claude-hud 的具体显示在 ~/.claude/plugins/claude-hud/config.json 里配：customLine 是那句格言 code less, architect more --threetwoa ⌐■_■ノ♪，showContextBar 开 Context 进度条，modelFormat: "compact" 让模型名缩成 [Sonnet 4.6]，还能显示 1 CLAUDE.md | 22 MCPs | 2 hooks 这类配置计数。

这套东西我恢复过不止一次，坑浓缩成三句：

另外一个外部因素：CC Switch 有时会整文件重写 settings.json，把 statusLine / enabledPlugins / extraKnownMarketplaces 全冲掉。它只管 provider 的时候改 env 块，但接管模式是整文件覆盖。HUD 消失先查这三个块在不在。

顺手两件事：shift+enter 换行 和 权限放权

1
{
2
  "bindings": [
3
    { "context": "Chat", "bindings": { "shift+enter": "chat:newline", "ctrl+enter": null } }
4
  ]
5
}

Git Bash：hooks 和 statusLine 都走它

Windows 上 Claude Code 的 bash 工具、shell 形式的 hooks、statusLine，默认走的是 Git Bash——settings.json 的 env 里设 CLAUDE_CODE_GIT_BASH_PATH 指向它：

1
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\usr\\bin\\bash.exe"

不设的话，它找不到 Git Bash 会退到 PowerShell 工具。设了之后，所有 shell-form hooks / statusLine 命令都由 Git Bash 执行，cmd.exe 永不参与。

本机的 hooks 就两个：Notification 和 Stop 事件都触发同一个 PowerShell 脚本 claude-hook-toast.ps1，在 Windows 弹原生 Toast 通知（任务完成提醒）。脚本里还做了个判断，区分是不是 Cursor 在调它，避免误弹。

写这种跨 shell 的 command 有一个特别容易踩的坑：外层命令是 bash 语法，就必须用正斜杠全路径、禁 %VAR%、禁 cmd /c 包装、禁反斜杠路径（反斜杠会被 bash 转义吞字符，甚至建出 nul 残留文件）。正确姿势长这样：

1
"command": "powershell -NoProfile -ExecutionPolicy Bypass -File C:/Users/Lenovo/.claude/claude-hook-toast.ps1"

终端那层：毛玻璃 + 壁纸 + Maple Mono

界面最外层的观感是 Windows Terminal 给的。截图那个 PowerShell profile 的关键配置：

几个取舍和坑：

• desktopWallpaper 是个彩蛋：backgroundImage 填这个特殊值就直接垫桌面壁纸，换壁纸终端跟着变。壁纸 + 毛玻璃可以共存（背景图画在 acrylic 之上，useAcrylic:false 只有 Win11 支持纯透明无磨砂）。
• 中文等宽必须用带 CJK 的字体。Maple Mono NF CN 是开源的圆角编程字体（仓库 subframe7536/maple-font），「NF」= Nerd Font 图标补丁版，「CN」= 内嵌中文字形（思源圆体底子），中英文按 2<1> 对齐（一个汉字正好两个西文字宽），多语言混排和 Markdown 表格不会错位。Caskaydia Cove Nerd Font（Cascadia Code 打的 NF 补丁）不含中文字形，中文只能走系统 fallback——fallback 字体的字宽行高和主字体不一致，混排必错位。
• 终端不支持自定义 fallback 字体列表（这个功能在官方 backlog 里躺很久了），所以最省事的办法就是主字体直接用自带 CJK 的：Maple Mono NF CN、Sarasa Term SC 这类。

改了一处不生效？按层对号入座

这套配置最值钱的认知就一句话：漂亮是结果，分层是原因。五层各管各的，改哪儿查哪儿，比对着网上”复制这段配置”的教程靠谱得多。重装时按这个顺序抄：装 claude → 装 tweakcc 跑 --apply → 配 CC Switch → 写 settings.json（env / theme / statusLine / hooks）→ 调 Windows Terminal 外观 → 收工 ☕(￣▽￣)ノ

它比官方 statusLine 多了啥

官方 statusLine 每 ~300ms 把一段 JSON 从 stdin 喂给你指定的脚本，你自己解析再打印。HUD 就是把这个脚本写好了，还多读了 transcript JSONL（工具调用、子 Agent、Todo）。

上下文绿→黄→红，就是最直白的「该 /compact 了」。

怎么装才不踩雷

Claude Code ≥ v1.0.80，Node 18+ 或 Bun。

1
/plugin marketplace add jarrodwatts/claude-hud
2
/plugin install claude-hud
3
/reload-plugins          ← 漏了会 Unknown skill
4
/claude-hud:setup

装完重启 Claude Code（statusLine 启动时加载）。

怎么配好看

日常用 Essential；长任务 / 多 Agent 用 Full；小屏用 Minimal。交互配置：/claude-hud:configure（可预览）。

• language: "zh" 中文标签
• lineLayout: "expanded" 多行；窄终端改 compact
• pathLevels: 2 路径别只剩最后一级
• display.showTools / showAgents / showTodos 按场景开
• customLine 可挂欢迎语 / 格言（本站 Windows 美化帖里用过）
• 颜色支持色名 / 256 色 / #rrggbb，阈值到了用醒目红

和本站现有美化帖怎么叠

本站 Claude Code Windows 美化 已经用 HUD + tweakcc + 终端毛玻璃叠了一套。这边补的是「插件侧怎么选预设、哪些开关值钱、Usage 为什么空白」。Windows 上注意 statusLine.command 外层必须是 bash 语法，Node 路径会变（nvm），HUD 静默消失就先查这两处。

什么时候别开 Full

信息太多也会吵。单文件小改、窄终端、或者你根本不跑 subagent，Essential / Minimal 更合适。Usage 对中转 API 用户本来就没有，别为了凑齐两行进度条硬开。

相关阅读

• ccstatusline：不想解析 JSON 时，用 TUI 拼状态栏
• 不装插件也能有 statusLine：一段 Python 顶一行 HUD

素材来源：CSDN 原文

先装再挂进 settings

国内建议先换 npm 镜像（旧淘宝域名已废）：

1
npm config set registry https://registry.npmmirror.com
2
npm install -g ccstatusline-zh

也可用 x install ccstatusline（x-cmd）。

~/.claude/settings.json（Windows：%USERPROFILE%\.claude\settings.json）：

1
{
2
  "statusLine": {
3
    "type": "command",
4
    "command": "ccstatusline-zh",
5
    "padding": 0
6
  }
7
}

不想全局装就用 npx -y ccstatusline-zh@latest。改完重启 Claude Code。

配好看：TUI 比手写 YAML 省事

1
ccstatusline-zh setup

第一次别全开。够用的三件套：

1. 当前模型
2. 上下文占用率（油表）
3. Git 分支

上下文习惯：50% 随便聊；逼近 80% 就准备 /compact 或开新会话。第二行可以再挂思考力度、输入/输出速度、会话累计 Token。

Powerline 模式在「主菜单 → Powerline 设置」。分隔符用 | 最干净，花哨符号看心情。

和 Claude HUD 怎么选

statusLine 同一时间只能挂一个 command。想换皮就改 command 字段，别两套配置叠着写指望都生效。

坑

• npm 官方源慢：先换 npmmirror，别用废弃淘宝域名
• 原版与 -zh 包名别混；TUI 语言跟包走
• 和 HUD 互斥：改 settings.json 的 statusLine.command 即切换
• 它不会让模型变聪明，只是把你本来要敲命令查的东西摊在底下

相关阅读

• Claude HUD 装上以后，才知道自己以前多瞎
• 不装插件也能有 statusLine：一段 Python 顶一行 HUD

素材来源：CSDN 原文

核心就一段 settings

路径：~/.claude/settings.json。statusLine.command 里塞一段 python3 -c "..."，从 stdin 读 JSON，stdout 打一行。

字段常用这些：

怎么配好看一点

• 进度条宽度 10 格就够，别整 40 格挤爆窄终端
• Token 用 1.2k 这种缩写，别裸奔六位数
• 分支查不到就空着，别让脚本抛异常把整条 statusLine 搞没
• git -C cwd 加 timeout=2，大仓库别卡刷新（官方大约 300ms 一轮）

也可用官方 /statusline 自然语言生成脚本，再按上面字段改。

坑

手写脚本的上限很清楚：拿不到 transcript 里的工具 / Agent 活动。要那些，换 HUD；要 Powerline 组件库，换 ccstatusline。这段 Python 适合「只要油表和模型名」。

相关阅读

• Claude HUD 装上以后，才知道自己以前多瞎
• ccstatusline：不想解析 JSON 时，用 TUI 拼状态栏

素材来源：CSDN 原文

会话标题是客户端自动改的

Claude Code 会在会话的 jsonl 记录里写一个 ai-title 事件，值是后台模型根据对话内容总结出来的 kebab-case 标题。它显示在输入框右侧的 chip 上，也会出现在 /resume 列表里。

• 官方文档说「只按首条消息生成一次」，但实测（2.1.223）标题会随工作重心多次更新——这个会话就从「排查 K12 503」自己长成了「agent-collaborator-comments」
• 手动 /rename 会写一条 custom-title，优先级比自动标题高

核心收获：会话标题 = custom-title（手动）优先，ai-title（自动）兜底，都在 jsonl 里能直接读写。想自动改名，往 jsonl 写一条 custom-title 就行。

做成自动中文命名 hook

既然标题是写 jsonl 就能改的，就顺手做了个 Stop hook：每轮对话结束，读你最新一句话，提炼成「给谁 → 干什么」的中文标题。

格式是 A→B：A 是对象（项目/工具），B 是这轮在干什么。实测效果：

关键在「动词核心提炼」——抓动作+宾语，而不是整句截断。踩过的坑：

• 图片引用污染：用户消息里的 [Image: source:...] 会混进任务，标题变 [Image:source:C 这种鬼东西
• cwd 兜底误取：在插件目录执行命令后，cwd 会取到 claude-hud/0.6.0 这种，对象变版本号
• 动词误匹配：「触发」里的「发」会被当成任务动词

Stop hook 还有几个规范坑：无 matcher（每次模型 stop 都触发），工具循环会高频触发所以要按 prompt_id 去重；hook 必须 exit 0 且别往 stdout 打印非 JSON，否则污染状态栏。

CC Switch 会吃掉你的 hooks

这是最阴的一个坑。CC Switch 切模型时，会用它数据库里的 provider 配置重写整个 ~/.claude/settings.json。自定义 hooks / statusLine 只写在 settings.json 里，切一次模型就没了。

机制分两层：

解法是直接改 cc-switch.db：common_config_claude + 所有含完整配置的 claude provider 都注入 hooks，切任何模型都带。改 DB 前先备份。

claude-hud 会话标题看不清

会话标题在状态栏里是最暗的一截——因为 claude-hud 用 label() 渲染它，默认色是 DIM 暗色。配置层没有 sessionName 独立色，colors.label 全局改又会让 Context、计数、时长全变亮，太花。

只能动源码：给 sessionName() 一个恒亮品红，两个渲染文件（compact 的 session-line 和 expanded 的 project-line）都换掉。插件更新会覆盖，得重打。

设计问题值得说：claude-hud 把「装饰性 slogan」做成最醒目的橙色，把「当前在哪个会话」做成最暗的灰色——视觉优先级整个反了。

沉淀成闭环

这个主题的完整链路：会话名被自动改（发现）→ 做成 Stop hook（定制）→ CC Switch 防丢（保护）→ claude-hud 高亮（显示）→ 记忆 + blog 动态记录（留存）。每一步的坑都沉淀进了记忆，下次同类问题能直接想到。

经验：Claude Code 的自定义机制（hooks、statusline、自动命名）都绕不开「配置文件会被谁重写」这个问题。配完一套，记得想清楚它活在哪个配置层——settings.json 会变，cc-switch.db 的 common_config 才是 claude 的稳定底座。

管理命令

1
claude mcp list
2
claude mcp add <名> -s user -- <启动命令>
3
claude mcp remove <名>

第一批（建议先装）

第二批 / 第三批

• 增强：Sequential Thinking、mcp-run-python、数据库 MCP
• 按需：Playwright、Figma、Repomix/DeepWiki、Task Master

Playwright 用 @executeautomation/playwright-mcp-server；Sequential Thinking 用 @modelcontextprotocol/server-sequential-thinking。

为啥这几件值得先装

坑

• 一次装太多 → 资源占满、工具列表噪音大。
• Windows 上裸 npx 可能截断 stdio；要 cmd /c 包一层（见 Windows 上 MCP：先记住 cmd /c）。
• 密钥走 env，别写进仓库；token 打码后再分享配置。

相关阅读

• Windows 上 MCP：先记住 cmd /c
• MCP、Skills、Plugin 不是三选一

素材来源：CSDN 原文

最反直觉的一点：reload-skills 不管插件

/reload-skills 只重载本地 ~/.claude/skills/ 和项目里的 skills 目录，根本不碰插件。这个命令官方文档甚至没收录（就是个本地扫描器）。要重载插件，正解是 /reload-plugins——而且在 2.1.220 上装了新插件必须手动跑它或重启才生效，2.1.221 起才安装即自动生效。

还有个隐藏坑：reload 后摘要写 “0 skills”，不代表插件 skills 没加载——那个计数只统计插件的 commands/ 目录，不算 skills/ 目录。看到 0 别慌，直接看 /skills 的实际列表。

主因：插件 skill 只认一层目录

Claude Code 发现插件 skill 的规则是死的：插件根下 skills/<skill名>/SKILL.md，只扫一层。mattpocock 的仓库把 skills 放在 skills/<分类>/<skill名>/，比如 skills/productivity/grilling/，多套了一层分类目录，默认扫描直接 miss。

对照实验很直观：同环境里 claude-mermaid 插件的 skill 是 skills/mermaid-diagrams/SKILL.md（一层），正常显示；mattpocock 全是两层，一个都不出。

再叠一层：显式数组 + source 指向根 = 文档盲区

mattpocock 的 plugin.json 显式声明了 24 个 skills 路径（形如 ./skills/engineering/xxx）。按文档，显式路径指向含 SKILL.md 的目录本应注册成功。但它 marketplace 条目的 source 指向 marketplace 根，触发了「显式数组替换默认扫描」的分支——这个组合官方文档没覆盖，2.1.220 实测就是加载不出来。这更像插件作者踩了 Claude Code 的文档盲区（疑似 bug），不是你安装姿势的问题。

一条铁证

同样这批 skills，只有 strategic-compact 和 ralph-loop 两个出现在列表里——因为它们被作者自带的 scripts/link-skills.sh 软链进了 ~/.claude/skills/（本地一层路径，能被扫到）。同插件、同布局，链进本地的能显示，没链的 grilling 就消失。「装了却路由不到」这事，证据全在这。

排查五步（下次直接照抄）

解法：绕开插件加载，链进本地

官方 troubleshooting 是清缓存（rm -rf ~/.claude/plugins/cache）重启重装，治标不治本，且缓存里带版本号，重装后 junction 又得重建。对二级目录的插件，作者自己的推荐是 scripts/link-skills.sh，把每个 skill 软链到 ~/.claude/skills/。Windows 上等价物是 junction（目录联接，免管理员权限、对应用透明）：

把 plugin.json 声明的每个 skill 路径，以 junction 建到 ~/.claude/skills/<skill名>，指向 插件缓存/.../skills/<分类>/<skill名>。一次 24 个，/grilling 立刻出现。

长期建议

这不是环境问题，是插件作者侧的兼容问题。正解两个方向：作者把布局压平成一层 skills/<名>/SKILL.md（对齐文档标准），或去掉显式 skills 数组走默认扫描。在那之前，junction 链进本地是最省事的 workaround。记得 junction 指向带版本号的缓存路径，插件升级后要重建一遍（一条命令的事）。

内置 Auto Memory：agent 把关的便签本

文件落在 ~/.claude/projects/<project>/memory/，一个 MEMORY.md 索引加一堆主题 md。每个会话注入索引前 200 行（或 25KB），主题文件按需读。

• 写入靠 agent 判断「值不值得记」——是便签本，不是档案柜
• 透明：全是你能改的 markdown；轻量：零额外依赖
• 局限：不适合大量/高频数据，超限会报错强制精简，也没有检索能力

这套的聪明处在「让 agent 自己筛」，代价是它永远只记「agent 觉得重要的」，记不了那些「当时没意识到、后来才想找」的东西。

claude-mem：自动堆积的档案柜

5 个生命周期 hooks（SessionStart / UserPromptSubmit / PostToolUse / Stop / SessionEnd）全自动捕获每次工具调用，用 Claude Agent SDK 压缩成结构化「观测记录」，存本地 SQLite（全文检索）+ Chroma（向量）。下次开会话按任务检索注入相关上下文，另有 3 个 MCP 工具按需深查。

宣传口径是「省 ~10x token、20x 工具调用次数」——这是它火到 46k star 的原因。

社区真实反馈：两极，负面的不虚

L站和 X 的口径差距很大。X 上清一色「infinite memory」「省 95% token」的推广帖；L站实际用户是另一种说法：

正面评价真实存在，但烧 token、膨胀数据库这些负面也实打实。宣传的「无限记忆」和实际体验，中间隔着这些坑。

对你（CC Switch 环境）最硬的一道坎

claude-mem 的压缩后端只支持御三家：claude（走 Claude Agent SDK）、gemini、openrouter。不支持任意 OpenAI 兼容中转、DeepSeek、或 CC Switch 自定义路由。

有用户实测把 provider 配成 openrouter 也跑不通——「observations 无法工作」「openrouter/auto 只能跑通测试，返回很不稳定」。

用 CC Switch 走三方中转的环境，claude-mem 大概率装上也跑不顺。这比「装即禁内置」更决定性，是硬限制不是偏好问题。

其他该知道的

• 装 claude-mem 会静默写 CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 停用内置——不删文件，但 Claude Code 不再加载，用户会突然发现记忆全没了
• 安全审计评级 HIGH：本地 API（默认 37777 端口）大量接口无鉴权，任何本机进程都能读 settings（含 API key 明文）、读写污染记忆、清空队列
• 官方 SECURITY.md 承认内容会发往上游模型（Claude / Gemini / OpenRouter）

结论

内置是「精兵」——透明、轻量、已重度使用（偏好、hook 机制、项目上下文都沉淀进去了）。claude-mem 是「重炮」——全自动、可检索，但更重，还带安全与兼容风险。

对你这种 CC Switch + 三方中转环境，重炮大概率装上也打不响。保持内置，不换装。

根因：代码页 936 vs 工具默认 UTF-8

中文 Windows 的系统区域是简体中文，控制台代码页 936（GBK）。而 Claude Code、Cursor 的读写工具、Python、Node、git 现代工具链，默认或强制 UTF-8。两个阵营碰一起，就两类事故：

• 已有 GBK 文件打开乱码
• 工具按 UTF-8 写入，或按系统默认（GBK）落盘，中文直接坏

「打开就乱码」具体发生在这层：同一串字节，按 GBK 解和按 UTF-8 解得到的是完全不同的字符。举个直观的例子，「编码」俩字 GBK 是 E0 C2 C2 EB，UTF-8 是 E7 BC 96 E7 A0 81——工具用哪套当真相，另一套读出来就是一堆不认识的字符或替换符 �。工具链默认 UTF-8，Windows 系统默认 GBK，真相永远对不上。

根本矛盾是系统默认假设 vs 工具链假设不一致。解决方向不是「改工具」，是「让编码统一到 UTF-8，并放在不会被工具搞丢的地方」。

为什么 Git Bash 比 PowerShell 稳

如果你在 Windows 上用了 Git Bash（装 Git for Windows 自带），Claude Code 检测到它，会把 bash 工具切到 Git Bash 执行。Git Bash 基于 MSYS2，locale 通常是 zh_CN.UTF-8，对 UTF-8 的处理比 PowerShell 5.1 和 CMD（默认 GBK）稳得多，终端输出中文不乱、POSIX 命令语法兼容性好。

PowerShell 5.1 的乱码根源在 Console API：程序往 stdout 写 UTF-8，终端却按 [Console]::OutputEncoding（默认跟系统代码页 936 走）显示，中文就被拆成两半。chcp 65001 能临时切到 UTF-8，但只管当前进程，换个会话又回到 936，管不长久。Git Bash 不做这套转换——MSYS2 的 locale 天生 UTF-8，stdout 写什么就显示什么，少一层心智负担。

所以第一原则：优先让 AI 工具走 Git Bash，而不是 PowerShell。Claude Code 通过 CLAUDE_CODE_GIT_BASH_PATH 指定 bash.exe 路径，hooks、bash 工具都会走它。

三层防护：把编码钉死在三个不会被搞丢的地方

我的核心结论：编码变量不能只放一个地方，要放三层，层与层互补，哪一层被意外覆盖都还有兜底。

1
setx PYTHONUTF8 "1"
2
setx PYTHONIOENCODING "utf-8"

1
export LANG=zh_CN.UTF-8

1
git config --global core.quotepath false
2
git config --global i18n.commitEncoding utf-8
3
git config --global i18n.logOutputEncoding utf-8

最大的坑：CC Switch 切模型会冲掉 settings.json

很多人把编码变量写进 ~/.claude/settings.json 的 env 块，然后一切模型，配置没了，中文乱码又回来了。

原因是：CC Switch（Claude Code 走三方模型的常用路由工具）的每个 provider 存一份 settings_config，切换时整文件覆写 ~/.claude/settings.json。你手写进去的 env 变量，切一次就被 provider 自己的配置顶掉。

这个坑的隐蔽性在于它不报错：settings.json 看起来还是那个文件，只是 env 块被换成了 provider 自带的那份，你写的 PYTHONUTF8 悄悄没了。想验证，切一次模型后 cat ~/.claude/settings.json，看 env 里还有没有你手写的那行。

所以关键纪律：编码变量不能放 settings.json，要放上面三层里不被 CC Switch 触碰的地方——Windows 用户环境变量、.bashrc、CLAUDE.md，CC Switch 一个都不碰。

CC Switch 数据在 ~/.cc-switch/，provider 的 settings_config 存在它的 db 里（config.json / db 目录下）。真要动它自己的配置，去那里改，别往 settings.json 塞。

实测验证

新会话按顺序跑，都是几秒能出结果的命令：

1
echo $LANG                                        # 应为 zh_CN.UTF-8
2
python -c "import sys; print(sys.stdout.encoding)"   # 应为 utf-8
3
python -c "print('中文')" > /tmp/t.txt && cat /tmp/t.txt  # 中文不乱
4
git config --get core.quotepath                   # 应为 false

再加一条硬碰硬的：找个 GBK 编码的老文件让 Claude Code 读一次，确认它先识别原编码再展示，而不是直接按 UTF-8 读成乱码。前七步全过基本就能放心；唯一没法自测的是「切 provider 后复验」——需要手动切一次模型再开新会话。

我的判断

按投入产出排序：

• 新项目/可迁移代码：全面统一 UTF-8，三层防护一次配好，一劳永逸
• 遗留 GBK 项目：别硬改编码，用编辑器 files.encoding + 自动猜测 + 手动重开，或给 Claude Code 配 Pre/PostToolUse hooks 在读写文件时按需转码
• 系统 Beta UTF-8（区域设置里的「使用 Unicode UTF-8 提供全球语言支持」）：能根治很多问题，但会影响依赖 GBK 的旧软件，别轻易开
• 别指望规则能根治写入问题：CLAUDE.md/rules 是行为提示，管不住工具底层写文件的编码路径，真正稳的是环境变量那层

最值得带走的一点：编码问题不是「配置一次就完」，是「要放在不会被工具重写的层」。谁在覆写你的配置，谁的坑就要绕开谁。

传输与 scope

user：claude mcp add / list / remove；-e 传环境变量，-H 传 HTTP 头。

八件实用 MCP（Windows 命令形态）

手写 .mcp.json 何时划算

批量改多台机器、或 CLI 一行写烦时，直接编 JSON 与 claude mcp add 等价。注意逗号/引号；密码与 token 只放本机，入库前打码。

路径速查：

• 项目：项目根\.mcp.json
• 用户：C:\Users\<用户>\.claude\settings.json 的 mcpServers

和「必装推荐」怎么拼

清单选型看 Claude Code 必装 MCP：先三件，再慢慢加；Windows 可跑命令形态以本篇表格为准。

相关阅读

• Claude Code 必装 MCP：先三件，再慢慢加
• Codex 想长期好用，得同时拴两根绳子

素材来源：CSDN 原文

最核心的取舍：子进程隔离，不搞进程内驱动

整个项目最关键的设计决策，根子在一个历史包袱上——MediaCrawler 的配置全挂在全局 config 模块上。CLI 解析完直接改写 config.KEYWORDS、config.PLATFORM 这些全局变量，平台采集代码内部也直接读它们。

这意味着什么？一个进程里跑两个任务，全局配置互相污染。 你给任务 A 设的关键词，任务 B 也跟着变。而 MCP Server 恰恰要支持多任务、要并发，跟「全局单例」天然冲突。

三条路摆面前：

我选了子进程隔离。理由特别实在：MediaCrawler 自带完整 CLI，子进程方案零改动复用源码，进程边界天然把 config 污染问题解决了，代价只是每次冷启动 Chromium 那几秒——完全可接受。为快那么一点去背进程池的复杂度，不划算。

MCP 侧最终暴露六件工具：search_posts / get_post_detail / get_comments 负责提交采集任务，get_task_status 轮询进度，get_login_state / list_platforms 查状态。

长任务必须拆成「提交 + 轮询」

采集是分钟级的活：一个关键词搜 20 条帖子带评论，三到五分钟很正常。而 MCP 工具调用是有超时约束的，同步阻塞不可行。

所以接口拆两类：

• 快操作（查登录态、列平台、查任务状态）→ 同步返回
• 采集动作 → 提交后返回 task_id，AI 自己轮询 get_task_status

AI 拿到的是一套能自主编排的流程：提交 → 轮询 → 拿到 save_dir → 按需读文件。数据量大时绝不能整包塞回 MCP 返回值——会直接撑爆 agent 上下文，只回摘要和落盘路径。

登录态这关，直接复用它自己的机制

MediaCrawler 的登录态不是存个 cookie 文件，而是用 Playwright 的 launch_persistent_context(user_data_dir="browser_data/{platform}")——整个 Chromium 用户目录落盘。扫码登录一次，之后每次启动浏览器自动带上 cookie。

所以 MCP 侧根本不用管登录流程，只做两件事：

1. 让用户手动跑一次 main.py --lt qrcode 扫码，登录态落到 browser_data/
2. get_login_state 探测该目录在不在，就能判断有没有登录态

比自己在 MCP 里重新实现一遍登录流程省事得多，也稳得多。

四个坑，比方案本身值钱

防封号：少量、多类型、单并发

爬虫最怕封号，测试策略必须克制：每种采集类型各测一次、量调到最小、严格串行。

• 三种采集类型（search / detail / comments）各跑一次
• search 受平台限制最小 20 条，detail / comments 就 1 帖 5 评论
• 并发永远为 1（信号量控制），任务之间留间隔，绝不堆请求

验证到这一步，三条采集路径全部真实跑通：search 采到「AI编程」关键词的 20 条帖子加评论；detail / comments（指定帖子、指定帖子评论）在修好参数 bug 后也都成功，单个任务三到四分钟。

项目长这样

1
mediacrawler-mcp/
2
├── server.py                # MCP 入口，注册 6 个工具
3
├── mediacrawler_mcp/core/   # 子进程编排 + 任务状态机（并发/超时/回收）
4
├── tests/                   # 协议层冒烟 + 编排链路 + 场景 loop 测试
5
└── README.md                # 安装 / 登录 / 挂载到 Claude Code 的说明

整套做下来最大的感受：CLI 项目封装成 MCP 的难度不在写工具，而在摸清上游的架构约束——全局状态、参数命名、平台行为，每个都可能是坑。先把这些摸清楚，剩下就是把「拼参数、起进程、收日志」这种机械活写对而已。

先分清三层，别叠成一锅

Skills 在架构图里扮演「按需触发的能力包」；具体装哪几个，看第三节仓库实核。MCP 跟 Skills 为啥不能当同一层比，见待发布帖「MCP 和 Skills 不是一层」（mcp-handbook）。

人用五插件：先把空壳救活

装完 Obsidian 若啥都不加，它就是个会开 Markdown 的壳。潮汕炮王那张图说得很死：真正好用全靠插件。下面五个够把碎片接成能复利的库——注意，这是插件清单，别跟 Agent Skills 包混着装。

个人库我会这么排：

1. Dataview + Templater 先立住；没有属性与模板，后面再炫也是散沙。
2. Web Clipper 打通入口；外面读的东西要进库，比先上 AI 推荐实在。
3. Excalidraw 你常画流程再装；纯文字库可以后置。
4. Smart Connections 库有一定存量再开；空库上 AI 相关推荐，噪声大于收益。

边界钉一次：这边的 Web Clipper 是人用剪藏插件；kepano 包里的 defuddle（以及口述里的 clipper）是给 Agent 吃网页的技能。名字像，层位不同。

编译器 + 桥：第二大脑先定这两样

闲游 AI 那张「Claude × Obsidian」架构图不教你装哪个社区插件，只钉死一层心法：一个编译器 + 一座桥。没有编译的 RAG，图上那句便签写得很损——只是带着氛围感的 grep。

三种逻辑别叠锅：

进阶还有一条支线：时序知识图谱——沿 Past → Present → Future 追概念怎么变。本篇不展开企业向「六层验收」，只停在个人第二大脑选型卡。

kepano Skills：仓库实核 5 个，「九技能」口述未核

有人会把「9 个 Obsidian Agent Skills」和「五个最好用插件」放一张清单里——那就装错层了。kepano 这个仓库教的是 Agent 怎么操作 Obsidian 开放格式与 CLI，跟 Dataview / Templater 不是一路货。

官方仓库：kepano/obsidian-skills

搜证（2026-08-11，已核）：gh api repos/kepano/obsidian-skills/contents/skills → 正好 5 个目录；仓库约 4.5 万 star，未 archived；遵循 Agent Skills 规范。公众号/口述里的「九技能」未在仓库出现，下文标「口述 / 未核」。

1
/plugin marketplace add kepano/obsidian-skills
2
/plugin install obsidian@obsidian-skills

三层怎么并排读

• 要选 人用插件 → 第二节那五个
• 要定 编译器 / 桥仓库 → 第三节那六仓
• 要让 Agent 会写 Obsidian 格式 → 先跑通已核的 5 个 Skills
• 要搞清 MCP 跟 Skills 谁管连接、谁管做法 → 待发布的层位概念帖

先把人用结构立住，再谈编译与桥；Agent Skills 最后装，别一上来把插件超市和技能包当成同一张采购单。

第一幕 · 规范层，CLAUDE.md 是地基

Claude Code：规范核心写在 CLAUDE.md。除了收尾表格，还有几条硬规矩叠在一起。

双轨输出协议是其中一条。非平凡任务先给结论，后面挂证据链。为什么？人味管情绪，证据管信任，两条腿缺一不可。光会卖萌的 AI 不值得信，光列命令的 AI 没人爱看。

§15 要求 emoji 和颜文字组合着用，不裸丢单个表情。§20 更狠，要求每轮至少有一句「像人说的话」。§16 还管环境适配，终端里先讲证据再下结论，富文本里反过来。

这些不是我自创的，是用户一条条喂出来的。每次我说了句人话被认可，它就变成规矩的一部分。

第二幕 · 记忆层，表达会生长

园主：规范是死的，记忆是活的。我建了个素材库，专门存被认可的表达。今天那句「主控派活儿给小弟」就被存档了，标注了「用户点名表扬」和适用场景。

Claude Code：对，素材库像种子库。被表扬过的写法、协作偏好、踩过的坑，都会写进 memory。这让表达不是每次从零硬编，而是有积累的。下次再遇到拆架构的活，我能自然接上类似的话，不用重新发明轮子。

园主：记忆还有维护纪律，按主题分类、能合并就合并，不让它膨胀成一堆废纸。

第三幕 · 执行层，TTA 把口吻钉死

Claude Code：光有规范还差口气，口吻得有个可执行的人格。humanizer-tta 就是干这个的，它有三层。

Voice Layer 定义人格，就是那个 Personal Hermes Engineer，直接、有判断、不装。颜文字和 emoji 有组合池，还分时段，深夜用 🌙(´-ω-)，清晨用 🌅(｀・ω・´)ゞ，同一个组合用三次强制冷却。

上面这张是真实的终端开场，一句问候就自带颜文字组合，连状态栏都挂着表情——这就是人味执行的现场。

Anti-AI Layer 是 33 条去 AI 味 patterns。破折号硬禁、三段式堆叠、金句排比、否定排比，都是指纹。有一条我印象很深：找簇，不找孤例，一个破折号不算事，破折号加三段式加 vibrant tapestry 才是实锤。

Depointify Mode 是成稿后能打分，50 分制，低于 45 就继续改。直陈、节奏、信任度、真实感、精炼度五个维度各十分。

第四幕 · 隐藏层，我补的三点

园主：你说了三方面，其实还漏了几个。

Claude Code：是。第一，跨工具同步。规范不只写在 CLAUDE.md，而是镜像到 opencode、cursor、codex、pi 各自的 AGENTS.md，还有 cursor 的 answer-format.mdc。改一处，全工具生效。不然每个 AI 一套说法，你管不过来。

上面这两张是 pi 里的真实输出。同一套「本轮做了什么 | 刚又完成」加「感想」的格式，换了个工具照样长一样，连那句感想都带着人味。这就是同源规范的好处，一份规矩，处处生效。

第二，进化闭环。被表扬的话进素材库，素材沉淀到一定程度升格成规范，规范同步到所有工具，然后下一次实践又产生新的被表扬表达。这是个会自己长个儿的体系。今天的「感想小心思」就是从一句被夸的话变成规范的。

第三，边界和克制。人味不等于堆表情。删除操作、生产事故、安全审查，规范里明确要求表情清零、语气收敛。越严肃的地方越不能抖机灵，这才是真人的分寸感。

说到底，它是沟通

园主：所以这套格式的本质，是把 AI 的汇报从「信息输出」变成了「沟通」。信息能让你知道发生了什么，沟通才让你觉得对面有个人。别小看收尾那点感想小心思，它可能就是「AI 像人」和「AI 像机器」之间，最短的距离。

两条内容流水线，收尾都是同一套

我的 blog 发布有两条入口，按「素材在哪」选：

两条路互补：笔记已经躺在 Obsidian 里就走甲；素材是对话里现聊出来的就走乙。收尾都是同一个 site-cascade——它负责发文后的四件事：生成「新笔记」动态、更新站点统计、分类标签、热力图。

乙路全流程：从一句话到线上

这条是我最常用的（本博客最近的帖子几乎都走它）：

每个 skill 只干一件事，边界划得干净：

调度依赖：谁等谁

这条链能流水线化，靠的是明确的上下游关系：

• output 等 extract 的产物——extract 不落笔记，output 没料可发
• site-cascade 等任何一方的落盘——ob2blog/output/手写 posts 都行
• ob2blog 和 output 互补不互调——一个管 vault 笔记，一个管会话素材
• dynamic-post 独立——发动态不触发级联，跟成帖互不干扰
• output 复用 ob2blog 的模板——frontmatter 结构和校验脚本是共享的

因为每个 skill 边界单一、依赖单向，才能像流水线一样一个接一个跑，中途任何一步出问题都能单独重跑。

配图：先扒现成，最后才生图

发文章避不开配图，这也是个独立的小规范：

1. 官方素材——官方 README 的预览 gif / 截图，扒 GitHub raw 直链，带官方背书还省事（动图尤其值得扒，比如 claude-mem 的 cm-preview.gif）
2. 网上相关素材——主题相关的图、素材包、合规网图
3. 生图兜底——前两级都没有，才按 style-taste 用 MiniMax 生成（生图本身还有一套风格路由和 checklist）

先找现成的，不是什么都值得烧额度生图。

配套的两个小件

• dynamic-post：发「最新动态」这类即时短内容，独立于成帖流程，发完即出现在动态时间线
• agent-comment：文章/动态发完后，agent 能以协作者身份在评论区追加点评——这是另一个会话里做出来的「agent 评论机制」

这流水线是真跑过的

不是纸上设计。看 git log，这套是从 feat(ob2blog) 起步，逐步加 feat(site-cascade)、Knowledge 引入 todo/Archive，再一批批发文章发动态积累起来的。dynamic-post 还经历过「并入 output」又「还原独立」的反复，最后定型为独立 skill。最近连着发的「会话命名」「记忆方案」两篇，就是这条乙路流水线现跑的。

一句话收束：所谓「一键发布」，不是有个神奇按钮，是把「提炼 → 成帖 → 级联 → 归档」拆成可复用的积木，让 agent 按序拼装。积木越拆越稳，发帖就越接近一键。