新手入门 on Yanmu

C 盘爆满？用其他盘给 C 盘扩容

Sun, 24 May 2026 16:00:00 +0800

C 盘飘红是 Windows 用户的"老毛病"了——系统更新缓存、临时文件、桌面文件、微信聊天记录……不知不觉就把 C 盘塞得满满当当。换硬盘成本高，清理治标不治本，最一劳永逸的办法就是：从其他盘借空间给 C 盘。

📖 目录（点击展开）

#	章节	说明
1	准备工作	下载、安装、进入 PE 环境
2	开始扩容	分区助手 8 步详解
3	重启 & 收尾	回到 Windows，清理引导菜单
4	小提示	补充建议与常见问题

📦 准备工作

⚡ 一句话概括：把 Windows 装进一个"休眠箱"里操作，这样 C 盘才不会被占用。

① 下载微 PE 工具箱

微 PE 工具箱——轻量级 PE（预安装环境）工具，干净无捆绑。

② 安装到系统

打开下载好的程序，点击 「立即安装进系统」，它会自动写入引导项。

③ 重启进入引导页面

安装完成后重启电脑，启动时会看到系统引导选择页面。

⏱ 注意：倒计时只有几秒钟，超时后会自动进入当前系统，盯紧屏幕快速选择！

④ 进入 PE 环境

方向键选择 微 PE 工具箱，回车进入。

💡 为什么要进 PE？

进入 PE 环境后，你的 Windows 系统处于完全"休眠"状态——C 盘没有被任何进程占用，此时才能安全地调整分区大小。这就像一个手术，病人必须麻醉后才能动刀。其他分区工具也是同样的原理。

🛠️ 开始扩容

进入 PE 后，桌面会自动弹出工具菜单，点击 「分区助手」。

第一步 · 查看磁盘布局

分区助手打开后，你会看到所有磁盘分区的直观布局。确认一下哪个盘有空余空间可以"支援"C 盘。

第二步 · 选择要缩小的盘

这里以 Software（D 盘） 为例，我们要从 D 盘"切"出一部分空间给 C 盘。

💡 选哪个盘好？

✅ 优先选 空间充裕、且不常用的大盘

❌ 尽量别动系统恢复分区或 EFI 分区

第三步 · 调整分区

右键点击 D 盘 → 「调整分区」。

第四步 · 缩小盘符

在弹出的窗口中，拖动滑块或直接输入数值，决定从 D 盘分出多少空间。

✅ 示例：你想给 C 盘扩充 50GB，就在这里缩小 50GB

⚠️ 注意：缩小的数值不要超过 D 盘当前已用空间，否则会报错。

确认无误后点击 「确定」。

第五步 · 合并给 C 盘

此时你会看到 D 盘旁边多了一块 「未分配空间」。

步骤	操作
1	右键点击 C 盘 → 「调整分区」
2	将滑块拖到最右侧，把全部未分配空间并入 C 盘
3	点击「确定」

第六步 · 提交任务

点击左上角的 「提交」。

⚠️ 关键提醒

前面所有的调整都只是**“计划”**，并没有实际生效。

只有点击「提交」后，系统才会真正执行分区操作。确认无误再提交！

第七步 · 等待执行

分区助手会开始执行调整，这个过程可能需要几分钟到十几分钟，具体取决于你的磁盘大小和速度。

⚠️	🔴 千万不要中途断电或强制关机！
否则可能导致分区表损坏，数据丢失
建议插上电源适配器（笔记本用户）
去泡杯茶，耐心等它跑完 🍵

第八步 · 完成 🎉

看到成功提示后，扩容就完成了！

🚀 重启 & 收尾

顺序	操作
①	点击「重启」
②	在引导界面选择你的 Windows 系统正常进入
③	打开此电脑，确认 C 盘空间已经变大 ✅

🧹 最后一步：如果你不想每次开机都看到系统选择界面，打开 微 PE 工具箱 → 「卸载」 即可恢复如初。

📌 小提示

场景	建议
🟢 C 盘空间太小（< 30GB）	建议至少扩充到 80 ~ 100GB
🟡 D 盘也没有多余空间	清理 D 盘，或外接硬盘转移大文件
🔴 操作前担心数据丢失	强烈建议先备份重要文件！虽然分区助手很稳定，但小心驶得万年船

✨ 以上就是完整的 C 盘扩容教程，希望你的电脑从此远离"飘红"！

OpenCode 新手进阶：并行调度与使用技巧全攻略

Thu, 30 Apr 2026 02:00:15 +0800

📋 目录

📌 核心要点概括

功能	一句话说明
Session 并行	OpenCode 杀手级功能，多个任务同时跑，互不干扰，效率翻倍
Ultra Work 模式	输入 `ULW`，主智能体自动拆解任务、调度多个子智能体并行干活
@ 指定智能体	让擅长前端的干前端，擅长架构的做评审，人尽其才
Timeline 时光机	随时回退到任意历史节点，大胆试错零成本
Ralph Loop	让 AI 循环工作数小时，攻坚极难任务

一、Session 并行：让 AI 同时干多件事

这是 OpenCode 相比其他 AI 编程工具最大的差异化优势。传统工具只能串行——一个任务跑完才能开始下一个。OpenCode 可以同时开启多个 Session，互不干扰。

基础操作

/new              # 创建新 Session
/sessions         # 查看所有 Session 的状态（打转符号 = 正在运行）
/session <id>     # 切换到指定 Session
/session prev     # 回到上一个 Session

实战场景

假设你在开发一个"你画我猜"小游戏，有两个独立需求：

需求 A：增加一个计时器，首次落笔开始计时，超过 20 秒游戏失败
需求 B：画笔可以调节颜色

传统做法

先做完 A，再做 B → 需求 B 白白等待 5-10 分钟。

OpenCode 做法

1. 输入需求 A，AI 开始工作
2. 输入 /new，创建新 Session
3. 输入需求 B，AI 开始工作
4. 输入 /sessions 查看进度：

   Session 1  ◐  正在添加计时器逻辑...
   Session 2  ◐  正在添加颜色选择器...

两个需求完全并行开发，总耗时从 15 分钟压缩到 8 分钟。

注意事项

⚠️ Session 之间完全隔离，修改同一文件可能冲突，建议分配给不同模块
⚠️ 后台 Session 不会自动通知完成，需要手动 /sessions 查看
✅ 可以随时 /new 开第三个、第四个……没有数量限制

二、Ultra Work：一键召唤 AI 编程团队

如果说 Session 并行是"手动挡"，那 Ultra Work 就是"全自动驾驶"。输入一个魔法词，AI 自动把任务拆开、分配给最合适的智能体、并行执行。

触发方式

在 prompt 中包含以下任一关键词：

1
2
3

ULW
ultrawork
Ultra Work

工作原理

你的需求：帮我做一个宠物商店网站
        │
        ▼
  ┌─────────────────────────────┐
  │  西西弗斯（主智能体）         │
  │  1. 拆解任务 → Todo List     │
  │  2. 分配子任务              │
  └──────┬──────────┬───────────┘
         │          │
    ┌────▼───┐ ┌───▼────┐ ┌────────▼────┐
    │ 先知    │ │ 前端    │ │ 文档编写者   │
    │ 架构设计 │ │ UI 开发 │ │ 文档生成     │
    └────────┘ └────────┘ └─────────────┘
         │          │            │
         └──────────┴────────────┘
                    │
                    ▼
              完整项目交付

自动拆分 Todo List
同时开启 3 个后台任务并行执行
主智能体居中调度
最终交付完整项目

什么时候用？

场景	适用	说明
从零创建完整项目	✅ 极佳	自动拆分前端、后端、文档
多模块并行开发	✅ 极佳	各智能体分工明确
单文件小修改	❌ 不推荐	杀鸡用牛刀，反而更慢
简单 bug 修复	❌ 不推荐	普通对话更快

💡 复杂度越高，Ultra Work 的价值越大。简单任务反而会因为调度开销变慢。

实际效果

用 Ultra Work 模式创建了一个宠物商店网站：

✅ 在没有任何图片素材的情况下，用 emoji 作为装饰
✅ 界面清新、交互流畅、动画完整

三、@ 指定智能体：让专业的人干专业的事

安装了 Oh My OpenAgent（OMO）后，你拥有一个 AI 编程团队。通过 @ 可以点名让特定智能体干活。

智能体能力表

智能体	擅长领域	最适模型	示例用法
🧠 西西弗斯	统筹规划、任务调度	Claude Opus	复杂多步骤任务
🔮 先知	架构设计、代码评审	GPT 5.5	项目结构设计
🎨 前端工程师	UI 开发、页面布局	Gemini 3 Pro	响应式布局优化
🔍 探索者	网络搜索、查资料	MiniMax	查最新 API 文档
📚 图书管理员	文献查阅、文档检索	—	梳理开源项目源码
📝 文档编写者	README、注释生成	—	生成项目文档
🖼️ 多模态	图片/PDF 理解	—	根据设计稿写代码

使用示例

@前端工程师 帮我把这个登录页改成响应式布局，移动端也要好看

@先知 审查一下 src/service/ 目录下的代码，找出潜在的性能问题

@探索者 查一下 React 19 的 Server Components 最新用法

@文档编写者 给整个项目生成一份 API 文档

切换主智能体

按 Tab 键可以切换当前对话的主智能体，适合长时间使用某个特定角色。

四、Timeline 时光机：随意试错，随时回退

编程中最怕什么？改了一大堆代码，发现方向错了，又回不去。Timeline 就是你的后悔药。

基本用法

`1`	`/timeline # 列出当前 Session 的每一步对话记录`

选择任意节点：

Revert：代码和聊天内容同时回退到该节点，就像什么都没发生过
View：查看当时 AI 做了什么修改

实战场景

1
2
3

1. 你让 AI 重构了某个模块 → 效果不理想
2. /timeline → 选择重构前的节点 → Revert
3. 代码回到重构前，换个思路重新来

使用技巧

🕐 完成一个阶段性任务后，在心里记下那个节点（第几次对话）
🕐 大胆尝试激进方案——反正可以一键回退
🕐 对比两个方案：Revert 到 A 方案 → 看看效果 → Revert 到 B 方案 → 对比

这就是编程版的"存档/读档"，让你敢于探索任何可能性。

五、Ralph Loop：让 AI 死磕到底

这个模式会让 AI 持续循环工作，直到任务真正完成。适合那些需要反复迭代的硬骨头。

启动方式

`1`	`/ralph-loop`

适用场景

"使用 Spring Boot 4 最新标准重构整个项目，直到所有测试用例通过"

"逐个检查 src/ 下所有文件的代码规范，修复每一个违规项"

"为项目添加完整的单元测试，直到覆盖率达到 90%"

和 Ultra Work 的区别

对比维度	Ultra Work	Ralph Loop
工作机制	并行拆分、多智能体协作	串行循环、持续迭代
适合场景	从零构建、多模块项目	重构、修复、达标类任务
耗时	几分钟到十几分钟	可能数小时
终点	任务拆解完成	满足终止条件

⚠️ Ralph Loop 可能运行很久，注意 API 额度消耗。

六、日常提速小技巧

1. 善用 `/compact` 节省上下文

当你和 AI 聊了很多轮，上下文窗口快满时：

`1`	`/compact`

AI 会把之前的对话提炼成一个摘要，释放空间继续工作。不需要开新对话丢失上下文。

2. 用 `/init` 让 AI 快速上手新项目

进入一个新项目时，先让 AI 通读代码：

/init

AI 会扫描整个项目，生成 agents.md 作为系统提示词。之后任何对话都会基于这个理解，效率大幅提升。

1
2
3

/share      # 生成分享链接，展示完整对话和代码修改
/unshare    # 取消分享，链接失效
/export     # 导出对话记录为文件

适合场景：

给同事展示你是如何用 AI 解决某个问题的
记录踩坑过程，供团队参考
写博客时的素材

4. 查看可用模型

`1`	`/models # 带 free 标记的是免费模型`

GLM-4.7 和 MiniMax-2.1 编程能力不错，适合轻量任务。

5. 快捷粘贴代码（VS Code 插件）

在 VS Code 中选中代码片段 → Ctrl + Alt + K → 直接粘贴到 OpenCode 对话框。

省去复制粘贴的切换成本，保持心流。

七、新手推荐工作流

┌─────────────────────────────────────────────┐
│                 拿到新需求                    │
└──────────────────┬──────────────────────────┘
                   │
                   ▼
          ┌────────────────┐
          │ 简单？          │
          └───┬────────┬───┘
              │ 是      │ 否（复杂/多模块）
              ▼         ▼
    ┌─────────────┐  ┌─────────────────┐
    │ 普通对话搞定  │  │ 输入 ULW 触发    │
    │             │  │ Ultra Work 模式  │
    └─────────────┘  └────────┬────────┘
                              │
                   ┌──────────▼──────────┐
                   │ 多个独立子任务？       │
                   └───┬──────────┬──────┘
                       │ 是        │ 否
                       ▼           ▼
              ┌─────────────┐ ┌──────────────┐
              │ /new 开多个   │ │ 等 Ultra Work │
              │ Session 并行  │ │ 自动完成       │
              └──────┬──────┘ └──────────────┘
                     │
                     ▼
              ┌─────────────┐
              │ /sessions    │
              │ 查看所有进度  │
              └──────┬──────┘
                     │
                     ▼
              ┌─────────────┐
              │ 某个方向错了？ │
              └───┬─────────┘
                  │
                  ▼
              ┌─────────────┐
              │ /timeline →  │
              │ Revert 回退   │
              └─────────────┘

一句话总结

小活直接聊，大活喊 ULW，并行用 Session，错了就 Timeline 回退，死磕开 Ralph Loop。

八、一个真实案例

在 Oh My OpenAgent 安装完成后，想调整 Agent 模型配置——让 GitHub Copilot 作为主力，免费的 OpenCode Zen 作为备选。

第一次尝试

直接在 OpenCode 对话中说：

“其实我还有你免费的 OpenCode Zen，但是我已经登录 GitHub Copilot 了，你帮我修改一下”

AI 把 OpenCode Zen 设成了主力——因为没说清楚主次关系。❌

纠正

“不是，是 GitHub Copilot 作为主力，OpenCode Zen 自带的免费模型作为备选”

AI 立即修正，更新了 oh-my-openagent.json，所有 Agent 都用 github-copilot/* 为主、opencode/* 为 fallback。✅

💡 教训：跟 AI 描述需求时，主次关系一定要说清楚——“XX 作为主力，YY 作为备选”，不要只说"帮我加上 YY"。

📚 参考来源：OpenCode 全深度指南、Oh My OpenAgent 📅 笔记生成日期：2026-05-07

5分钟安装ClaudeCode并接入DeepSeek

Sun, 26 Apr 2026 02:00:15 +0800

概述

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，内置多种 Skills 插件，通过不同组合可以完成许多 AI 单独做不到的事。接入国产大模型 DeepSeek V4 后，可以大幅降低使用成本。

核心用途：

构建个人知识库，自动化整理学习笔记
按时搜集行业资讯并整理成文稿
自动发布到各大社交媒体平台

第一步：安装运行环境

1.1 安装 Node.js

前往 Node.js 官网下载 Windows 安装包（.msi），双击后一路下一步。

验证安装：

1
2

node -v
npm -v

1.2 配置 npm 国内镜像

`1`	`npm config set registry https://registry.npmmirror.com/`

💡 为什么要配置镜像？

默认 npm 源在国外，下载速度很慢。配置国内镜像后安装速度可提升 10 倍以上。

1.3 安装 Git

前往 Git 官网下载对应版本安装包，一路下一步。

验证安装：

git -v

1.4 安装 CC-Switch

CC-Switch 用于将第三方模型接入 Claude Code。

前往 GitHub Release 页面下载对应版本（如 Windows MSI），双击安装，一路下一步。

第二步：安装 Claude Code

`1`	`npm install -g @anthropic-ai/claude-code`

验证：

`1`	`claude --version`

跳过登录（使用第三方 API）

启动一次 Claude Code 后关闭
在用户目录下找到 .claude.json 文件
添加以下字段（注意上一字段尾部需加英文逗号）：

`1`	`"hasCompletedOnboarding": true`

重新执行 claude 启动，选择信任当前文件夹即可

⚠️ 常见错误

如果忘记在上一字段末尾加逗号，会导致 JSON 解析错误，Claude Code 无法启动。

第三步：接入 DeepSeek

3.1 获取 API Key

打开 DeepSeek 开放平台，注册登录
确保账户有余额
右侧 API Keys → 创建 API Key → 复制保存（关闭后无法再次查看）

🚨 密钥安全

密钥不要分享给他人，否则会消耗你的余额。

3.2 配置 CC-Switch

打开 CC-Switch，点击右上角 + 号
模型预设选择 DeepSeek
填入 API Key
模型名称统一改为：deepseek-v4-pro[1m]（上下文 1M，Claude Code 默认使用 128K）
点击添加

3.3 验证模型

在 Claude Code 对话框中输入：

/model

可查看当前可用模型，或直接问"你当前是什么模型"确认接入成功。

第四步：实战示例

桌面新建一个文件夹
在地址栏输入 CMD 回车
执行 claude 启动，选择信任当前文件夹
输入需求：使用 HTML + JS + CSS 做一个 Todo 软件
运行中会申请工具权限，选择 Yes 即可
完成后让它帮你打开页面预览

💡 小技巧

可以用中文直接描述需求，Claude Code 支持中英文混合输入。

命令速查表

操作	命令
Node 版本检查	`node -v`
npm 版本检查	`npm -v`
npm 国内镜像	`npm config set registry https://registry.npmmirror.com/`
Git 版本检查	`git -v`
安装 Claude Code	`npm install -g @anthropic-ai/claude-code`
Claude Code 版本检查	`claude --version`
启动 Claude Code	`claude`
切换模型	`/model`

常见问题

执行 claude 后提示找不到命令？

检查 Node.js 是否安装成功（node -v），以及 npm 全局路径是否在系统 PATH 中。

启动后要求登录 Anthropic 账号？

说明 .claude.json 中的 hasCompletedOnboarding 未正确配置，请回到第二步检查。

模型调用报错 / 无响应？

检查 DeepSeek 账户余额是否充足，以及 CC-Switch 中 API Key 是否正确填写。

安装ClaudeCode并接入DeepSeek（面向小白）

Sun, 26 Apr 2026 02:00:15 +0800

概述

这份教程是给谁看的？

这份教程面向完全没有计算机基础的用户。你不需要知道什么是"命令行"、什么是"环境变量"、什么是"版本管理"——我会把每一步都拆解到最细，告诉你在哪里点、点什么、输入什么、看到什么说明成功了。

你要装什么？为什么要装这些？

在开始之前，先了解我们一共要安装 3 个东西，它们各自的作用：

序号	软件名称	一句话解释	为什么必须装
1	Node.js	让你的电脑能运行 JavaScript 程序的"引擎"	Claude Code 是用 JavaScript 写的，没有它就跑不起来
2	Claude Code	一个住在你电脑终端里的 AI 编程助手	这就是我们最终要用的东西
3	CC-Switch	一个给 Claude Code “换大脑"的小工具	让 Claude Code 从昂贵的官方模型换成便宜的 DeepSeek

整个过程大约需要 10-15 分钟。请按顺序一步步来，不要跳步。

📌 前提条件

你需要一台 Windows 电脑（Windows 10/11），能正常上网。

安装 Node.js

什么是 Node.js？

Node.js = 让电脑能运行 Claude Code 的运行环境。它是完全免费的，就像你需要先装好 Windows 系统才能运行软件一样，你需要先装好 Node.js 才能运行 Claude Code。

下载 Node.js

第 1 步：打开浏览器

打开你电脑上任意一个浏览器（Chrome、Edge、Firefox 都可以）。

第 2 步：访问 Node.js 官网

在浏览器地址栏（顶部输入网址的长条框）中输入以下网址，然后按回车：

`1`	`https://nodejs.org/`

第 3 步：找到下载按钮

打开网页后，你会看到页面中央有两个大按钮：

左边的按钮写着 LTS（推荐的版本号，比如 22.16.0 LTS）
右边的按钮写着 Current

点击左边的 LTS 按钮，浏览器会自动开始下载一个 .msi 文件。

第 4 步：找到下载好的文件

下载完成后（通常只需几秒钟），有两种方式找到这个文件：

方式一：点击浏览器右上角的下载列表（通常是一个向下的箭头 ↓ 图标），在列表中找到刚才下载的文件，文件名类似 node-v22.16.0-x64.msi
方式二：打开文件资源管理器（就是你看文件夹的那个窗口），在左侧找到下载文件夹，里面就有这个文件

安装 Node.js

第 1 步：双击安装文件

在下载文件夹中，找到 node-v22.16.0-x64.msi（版本号可能略有不同），双击它。

第 2 步：欢迎界面

弹出一个标题为 Node.js Setup（Node.js 安装向导）的窗口。点击底部的 Next（下一步）按钮。

第 3 步：许可协议

窗口中显示一大段英文协议文字。

勾选左下角的复选框：I accept the terms in the License Agreement（我接受许可协议中的条款）
点击 Next

第 4 步：安装位置（⚠️ 重要！需要修改路径）

这里显示的是 Node.js 将要安装到你电脑的哪个位置。

默认路径是：C:\Program Files\nodejs\

📌 我们要把它改到 D 盘！

建议安装到 D 盘，原因：

C 盘是系统盘，放太多东西会影响电脑速度

D 盘专门用来装软件，万一系统重装了，D 盘的东西还在

方便管理和查找

修改步骤：

点击路径输入框，把里面的内容全部选中（按 Ctrl + A），然后删除
输入新的路径：
1

D:\nodejs\
点击 Next

💡 注意

路径中不要有中文和空格，否则可能导致安装出错。

第 5 步：自定义安装

显示一个带有树状复选框的页面（Custom Setup）。

什么都不要改，直接点击 Next。

第 6 步：确认安装

点击 Install（安装）按钮。如果弹出安全提示，点击是。

第 7 步：等待安装

进度条会走完，通常只需 10-30 秒。

第 8 步：完成

点击 Finish（完成）。

Node.js 安装完成！

此时 Node.js 和 npm（Node.js 的包管理器，可以理解为"软件商店”）都已经装好了。

验证 Node.js 是否安装成功

安装完成后，我们需要验证一下——就像买完菜要检查一下有没有漏掉的东西。

第 1 步：打开命令提示符（CMD）

什么是"命令提示符"？

命令提示符（也叫 CMD）是一个黑色背景、白色文字的窗口，你可以在这个窗口里输入文字命令来让电脑执行操作。以后会经常用到它。

打开方式（任选一种）：

方式一（推荐）：
1. 按住键盘上的 Win 键（键盘左下角，画着 Windows 图标的那个键）
2. 同时按下 R 键
3. 弹出一个小窗口（标题是"运行"），在里面输入 cmd
4. 点击确定，或直接按回车键（Enter）
方式二：
1. 点击桌面左下角的开始菜单（Windows 图标）
2. 在搜索框中输入 cmd
3. 点击搜索结果中的 命令提示符

第 2 步：输入验证命令

在打开的黑色窗口中，输入以下内容（输入时屏幕上会显示你打的字），然后按回车键：

node -v

如果窗口中显示类似 v22.16.0 的内容，说明 Node.js 安装成功了 ✅

继续输入以下命令，按回车：

npm -v

如果显示类似 10.9.2 的版本号，说明 npm 也正常 ✅

⚠️ 提示"不是内部或外部命令"？

说明环境变量没有配置好，请看下面的 1.4 如何配置环境变量。

如何配置环境变量

什么是环境变量（PATH）？

PATH 可以理解为电脑的"通讯录"。当你在命令提示符里输入 node 时，电脑不知道 node 装在哪里，它会去 PATH 这个"通讯录"里找。如果 PATH 里没有 Node.js 的安装目录，电脑就找不到它，就会报"不是内部或外部命令"。

正常情况下，Node.js 安装时会自动把自己加到 PATH 里。但如果出了问题，你需要手动添加。

查看 PATH 里有没有 Node.js

按 Win + R，输入 sysdm.cpl，回车
点击顶部的高级选项卡
点击底部的 环境变量 按钮
在下方 系统变量 列表中，找到 Path 这一行，选中它，点击编辑

在弹出的列表中，检查有没有类似这样的条目：

`1`	`D:\nodejs\`

💡 路径要和你安装时设置的一致

如果你当时装在了 D:\Software\nodejs\，那这里也应该显示 D:\Software\nodejs\。

如果有这个条目：说明 PATH 没问题，但仍然报错的话，关掉当前命令提示符窗口，重新打开一个新的再试。

如果没有这个条目：按下面步骤手动添加。

手动添加 Node.js 到 PATH

在刚才打开的 编辑环境变量 窗口中，点击新建
输入 Node.js 的安装路径：
1

D:\nodejs\
点击确定
点击确定关闭环境变量窗口
点击确定关闭系统属性窗口
关掉所有已打开的命令提示符窗口，重新打开一个新的（旧窗口不会识别新配置）
再次输入 node -v 验证

配置 npm 国内镜像（强烈推荐）

💡 为什么要配置？

npm 默认从国外下载软件，速度很慢。配置国内镜像后下载速度提升 10 倍以上。

在命令提示符中输入以下命令，按回车：

`1`	`npm config set registry https://registry.npmmirror.com/`

输入以下命令验证，如果显示 https://registry.npmmirror.com/ 则成功 ✅：

`1`	`npm config get registry`

第一步完成！

你已经在电脑上安装好了 Node.js，并且配置了国内镜像。接下来安装 Claude Code。

安装 Claude Code

通过 npm 安装 Claude Code

打开命令提示符（如果还没打开的话），输入以下命令，按回车：

`1`	`npm install -g @anthropic-ai/claude-code`

等待安装完成（一般 1-3 分钟）。屏幕上会滚动一些文字，只要最后没有报错就行。

验证安装

输入：

`1`	`claude --version`

按回车。如果显示版本号（例如 1.0.x），说明安装成功 ✅

首次启动（跳过登录）

为什么要跳过登录？

Claude Code 官方要求你用 Anthropic 账号登录才能使用。但 Anthropic 的服务需要海外信用卡支付，对国内用户很不方便。

我们的方案是：先跳过登录，然后通过 CC-Switch 工具接入国产的 DeepSeek 模型，这样就不需要 Anthropic 账号了，费用也低得多。

第 1 步：先启动一次 Claude Code

在命令提示符中输入：

claude

按回车。Claude Code 会启动，可能会显示一些介绍信息或要求你登录。

不用管它，直接关闭这个命令提示符窗口（点右上角的 ×）。

第 2 步：找到配置文件

按 Win + R（Win 键 + R 键同时按）
在弹出的"运行"窗口中，输入 %USERPROFILE%
点击确定或按回车
打开后，你会看到一个文件夹，里面有各种文件和子文件夹

第 3 步：找到 .claude.json 文件

在这个文件夹中，找到一个名为 .claude.json 的文件。

⚠️ 找不到这个文件？

如果找不到 .claude.json，可能是以下原因：

文件扩展名被隐藏了——在文件夹窗口顶部，点击查看 → 勾选 文件扩展名 和 隐藏的项目

Claude Code 还没有创建这个文件——请回到第 1 步，确保你成功启动过一次 Claude Code

在某些情况下，这个文件可能在 .claude 文件夹里面，文件名为 settings.json

第 4 步：用记事本打开配置文件

右键点击 .claude.json 文件
在弹出的菜单中，选择 打开方式
选择 记事本（Notepad）
- 如果列表中没有记事本，选择 选择其他应用 → 在列表中找到 记事本 → 点击确定

第 5 步：编辑配置文件

打开后，你会看到类似这样的内容（具体内容可能不同）：

{
  "someField": "someValue",
  "anotherField": "anotherValue"
}

我们需要在最后的 } 前面，添加一行 "hasCompletedOnboarding": true。

修改后的样子应该是这样的：

{
  "someField": "someValue",
  "anotherField": "anotherValue",
  "hasCompletedOnboarding": true
}

📌 ⚠️ 注意三个细节，否则会报错！

加逗号：hasCompletedOnboarding 前面那行的末尾要加一个英文逗号 ,

用英文引号：引号必须是英文的 "，不能是中文的 "

true 是小写：必须写 true，不能写 True

第 6 步：保存文件

按 Ctrl + S 保存（或者点击左上角文件 → 保存）
关闭记事本窗口

第 7 步：验证跳过登录是否成功

重新打开命令提示符（Win + R → cmd → 回车）
输入 claude，按回车
如果直接进入了 Claude Code 的主界面（没有要求你登录），说明跳过登录成功 ✅

第二步完成！

Claude Code 安装完毕，并且跳过了登录步骤。接下来安装 CC-Switch 来接入 DeepSeek。

安装 CC-Switch（模型切换工具）

什么是 CC-Switch？

CC-Switch 是一个可视化工具，让你不用手动改配置文件，点点鼠标就能把 Claude Code 的"大脑"从官方模型换成 DeepSeek。

下载 CC-Switch

第 1 步：打开下载页面

在浏览器地址栏中输入以下网址，按回车：

`1`	`https://github.com/cc-switch/cc-switch/releases`

第 2 步：找到最新版本

打开页面后，找到带有绿色 Latest 标签的版本，点击展开。

第 3 步：找到下载链接

展开后往下滚动，找到 Assets 这个词（旁边可能有个小箭头 ▾），点击展开它。

找到以 .msi 结尾的文件（Windows 安装包），点击文件名开始下载。

💡 选哪个文件？

Windows 电脑：选 x64.msi 结尾的文件

Mac 电脑：选 .dmg 结尾的文件

安装 CC-Switch

第 1 步：双击安装文件

在下载文件夹中，双击下载好的 .msi 文件。如果弹出安全提示，点击 仍要运行 或 更多信息 → 仍要运行。

第 2 步：按提示安装

安装向导和 Node.js 类似：

点击 Next
接受协议 → Next
保持默认安装路径 → Next
点击 Install
等待安装完成 → Finish

第三步完成！

CC-Switch 安装好了。接下来获取 DeepSeek 的 API Key。

获取 DeepSeek API Key

什么是 DeepSeek？

国产大语言模型，性能强大且价格低廉（日常使用每月约 10-30 元），接入后可以大幅降低使用成本。

什么是 API Key？

API Key 是一把钥匙，用来调用 DeepSeek 的 AI 服务，每次使用会从账户余额中扣费。你需要：① 注册账号 ② 充值 ③ 创建 Key

注册 DeepSeek 账号

第 1 步：打开 DeepSeek 开放平台

在浏览器地址栏中输入：

`1`	`https://platform.deepseek.com/`

按回车。

💡 注意

这是 DeepSeek 的开发者平台（platform.deepseek.com），不是聊天网站（chat.deepseek.com），别搞混了。

第 2 步：注册/登录

页面右上角有登录 / 注册按钮
点击注册（如果没有账号）或登录（已有账号）
按页面提示填写信息完成注册

充值余额

💡 费用参考

日常使用一个月大约只需 10-30 元，建议首次充值 20-50 元。

登录后，在页面左侧菜单中找到充值（或钱包 / Billing），点击它
选择充值金额，选择支付方式，完成支付
确保账户余额大于 0（没有余额无法使用 API）

创建 API Key

第 1 步：进入 API Keys 页面

登录后，在左侧菜单中找到 API Keys，点击它
你会看到一个 API Keys 管理页面

第 2 步：创建新的 API Key

点击 创建 API Key 按钮
弹出一个对话框，要求你输入 Key 的名称
- 可以随意填写，比如 claude-code、我的key、test 都行
- 这个名称只是给你自己看的，用来区分不同的 Key
点击确认或创建

第 3 步：复制 API Key（⚠️ 最关键的一步！）

创建成功后，页面会显示你的 API Key，格式类似：

`1`	`sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

⚠️ 这个 Key 只会显示一次！

关闭对话框后就再也看不到了。请立即复制保存到记事本或微信文件传输助手。

🚨 安全提醒

API Key 等同于你的账号密码，不要分享给任何人，不要发到公开场合。如果怀疑泄露，立即删除并重新创建。

第四步完成！

你已经有了 DeepSeek 的 API Key（钥匙）。最后一步，把这把钥匙交给 CC-Switch，完成接入。

配置 CC-Switch 接入 DeepSeek

打开 CC-Switch

在桌面上或开始菜单中找到 CC-Switch 的图标，双击打开。

添加 DeepSeek 配置

第 1 步：点击添加按钮

CC-Switch 打开后，找到右上角的 + 号（加号按钮），点击它。

第 2 步：填写配置信息

点击 + 号后，会弹出一个配置面板，填写以下信息：

① 模型预设（Model Preset）：选择 DeepSeek

② API Key：粘贴你之前复制的 DeepSeek API Key（注意首尾不要有空格）

③ 模型名称（Model Name）：把输入框内容删掉，输入：

`1`	`deepseek-v4-pro[1m]`

④ Base URL / API 地址（如果有的话）：

`1`	`https://api.deepseek.com`

第 3 步：保存配置

检查所有信息都填好后，点击添加 / 保存 / 确认按钮。

切换到 DeepSeek

回到 CC-Switch 的主界面
你会看到刚才添加的 DeepSeek 配置已经出现在列表中
点击该配置旁边的切换 / 启用按钮
界面上应该会显示"当前模型：DeepSeek"或类似的信息

验证接入是否成功

打开命令提示符，输入 claude 启动 Claude Code。

在 Claude Code 中输入：

/model

按回车。如果显示的模型信息中包含 DeepSeek，说明接入成功 ✅

全部配置完成！

现在可以开始使用 AI 编程助手了！

开始使用（实战示例）

配置完成后，做一个简单的练习确保一切正常。

创建项目文件夹并打开命令提示符

在桌面右键 → 新建 → 文件夹，命名为 my-first-ai-project
双击打开这个文件夹
点击窗口顶部的地址栏，输入 cmd，按回车

启动 Claude Code

在弹出的命令提示符窗口中，输入：

claude

按回车。如果询问是否信任这个文件夹，输入 y 按回车。

发出第一个指令

Claude Code 启动后，输入以下内容（可以直接用中文）：

`1`	`帮我创建一个简单的个人主页，使用 HTML + CSS + JavaScript，包含一个标题、一段自我介绍和一个深色模式切换按钮`

按回车提交。

处理权限请求

运行过程中 Claude Code 可能会询问是否允许创建/修改文件，选择 Yes 即可。建议在自己创建的项目中选择 Yes, always allow（以后不再询问）。

查看成果

完成后，回到项目文件夹，双击 index.html，它会在浏览器中打开，你就能看到 AI 帮你创建的网页了！

恭喜！

你已经用 Claude Code + DeepSeek 完成了第一个项目！

常用命令速查表

操作	命令	说明
检查 Node.js 版本	`node -v`	验证 Node.js 是否安装
检查 npm 版本	`npm -v`	验证 npm 是否正常
设置 npm 镜像	`npm config set registry https://registry.npmmirror.com/`	加速下载
检查 npm 镜像	`npm config get registry`	验证镜像是否生效
安装 Claude Code	`npm install -g @anthropic-ai/claude-code`	全局安装
检查 Claude Code 版本	`claude --version`	验证 Claude Code 是否安装
启动 Claude Code	`claude`	在当前文件夹启动
查看当前模型	`/model`	在 Claude Code 内输入
退出 Claude Code	`/exit` 或按两次 `Ctrl + C`	退出程序

常见问题 FAQ

输入 node -v 提示"不是内部或外部命令"？

Node.js 的环境变量（PATH）没有配置好。打开文件资源管理器，进入 D:\nodejs\ 看看里面有没有 node.exe：

有这个文件：说明安装了但 PATH 没配好，按照上方 1.4 如何配置环境变量 的步骤手动添加

没有这个文件：说明安装失败了，重新下载安装

输入 claude 提示"不是内部或外部命令"？

Claude Code 安装没成功。先确认 node -v 和 npm -v 正常，然后重新执行 npm install -g @anthropic-ai/claude-code。

启动 Claude Code 后要求登录 Anthropic 账号？

.claude.json 没改对。按 Win + R，输入 %USERPROFILE% 回车，找到 .claude.json 用记事本打开，确认里面有 "hasCompletedOnboarding": true，且前面那行末尾有英文逗号、true 是小写、引号是英文引号。

Claude Code 对话时报错 / 无响应？

常见原因：① DeepSeek 余额不足 ② API Key 填写错误 ③ 模型名称不是 deepseek-v4-pro[1m] ④ 网络问题。逐项检查即可。

npm 安装 Claude Code 非常慢（超过 5 分钟）？

检查是否配置了国内镜像：npm config get registry（应显示 registry.npmmirror.com）。如果没有，执行 npm config set registry https://registry.npmmirror.com/ 后重试。

CC-Switch 打不开或闪退？

到 GitHub Release 重新下载最新版本，或尝试右键以管理员身份运行。

GitHub 页面打不开？

原因：GitHub 在国内可能访问不稳定。解决：

多刷新几次页面

尝试使用不同的浏览器

如果实在打不开，可以在网上搜索"CC-Switch 下载"，有些国内镜像站也提供了下载

完整流程回顾

步骤内容一句话总结

第一步安装 Node.js 装好"运行引擎"，让电脑能跑 JavaScript 程序

第二步安装 Claude Code 装好"AI 助手"，并跳过登录

第三步安装 CC-Switch 装好"换脑器"，用来切换 AI 模型

第四步获取 DeepSeek API Key 拿到"钥匙"，用来调用 DeepSeek 的 AI 服务

第五步配置 CC-Switch 用"换脑器"+“钥匙”，把 Claude Code 的大脑换成 DeepSeek

第六步开始使用在任何文件夹中输入 claude 启动 AI 助手！

完成全部步骤后，你就可以在电脑的任何文件夹中，输入 claude 命令，启动一个由 DeepSeek 驱动的 AI 编程助手了！

小白也能学会！用 AI 快速画出漂亮的技术架构图

Tue, 31 Mar 2026 19:51:00 +0800

✈️ 小白也能学会！用 AI 快速画出漂亮的技术架构图

👋 这篇文档是写给完全没画过架构图的新手看的。你不需要会设计、不需要会写代码，只要会用 AI 聊天就能跟着做。

什么是技术架构图？我为什么要画它？

简单说，技术架构图就是把你脑子里的系统"画出来"——

比如你要做一个 App，它有哪些功能模块？用户怎么用？数据怎么流转？把这些关系画成图，就是架构图。

画它的好处很实在：

✅ 自己理清思路——画图的过程就是你梳理系统设计的过程
✅ 跟同事沟通不费劲——一张图胜过千言万语
✅ 汇报展示有面子——老板和客户一看就明白你的方案有多牛
✅ AI 帮你画，省时省力——现在用 AI，几分钟就能出一张像样的图

🤔 新手该选哪种方法？（先看这个）

你的情况	推荐方案	难度
就想最快出一张好看的图，后期不改了	方案一（AI 直接生成图片）	⭐
愿意多一步，让图以后好修改	方案二（Mermaid.js 代码生成）	⭐⭐
做正式文档，需要反复修改、风格统一	方案三（Excalidraw 本地画图）	⭐⭐⭐

💡 新手建议：先试 方案一 感受一下，再尝试 方案二。方案三等你需要做正式文档时再研究。

方案一：直接让 AI 帮你画一张图（最简单，最快）

⏱ 耗时：2-3 分钟 🛠 工具：Gemini 3.1 Pro（谷歌出品，免费可用）

一句话原理

让你用的 AI（比如 Gemini）先写出"画图描述词"，再把这个描述词喂给 AI 的画图功能，AI 就帮你把图画出来了。

手把手操作步骤

第 1 步：让 AI 帮你写"画图描述词"

打开 Gemini，输入下面这段话（直接复制，替换你的内容就行）：

请帮我写一段用于生成技术架构图的提示词（prompt），
我要画的是一个 [你的系统名称，比如：电商网站] 的架构图，
包含以下模块：用户端、商品管理、订单系统、支付系统、后台管理。
模块之间的数据流向是：用户下单 → 订单系统调支付 → 支付完成通知商品管理扣库存。
请用英文给出适合文生图模型的详细提示词，风格要专业、清晰、好看。

AI 会还你一段英文描述词。

第 2 步：把提示词喂给 AI 画图

在 Gemini（或其他支持画图的 AI）里，选择画图功能（如 Gemini 自带的 Banana 2.0 模型），然后把上一步得到的描述词粘贴进去，点生成。

第 3 步：完成 🎉

AI 会输出一张图片。不满意就重新生成一次，直到满意为止。

优缺点

✅ 优点	❌ 缺点
速度最快，几分钟搞定	改起来麻烦——系统变了就得重新生图
图片效果好看，色彩丰富	结果不稳定，有时第一次出的图不满意
不需要任何额外工具	提示词写得不好，出图效果就不好

📌 小白避坑提示

提示词一定要详细——你给 AI 的信息越具体，出图越准。别只说"画个架构图"，要说清楚有哪些模块、怎么连接的
多试几次——第一次出的图如果不满意很正常，微调提示词再生成一两次
英文提示词效果更好——大部分画图模型对英文理解更好，所以第一步让 AI 生成英文描述词

方案二：让 AI 先生成代码，再用代码渲染成图（推荐新手尝试）

⏱ 耗时：3-5 分钟 🛠 工具：任意 AI（ChatGPT、Claude、Gemini 都行）+ Mermaid.js

一句话原理

流程图的本质是一段代码（Mermaid.js 语法）。你让 AI 帮你写出这段代码，然后通过一个免费在线网站把代码渲染成图片。想改图？让 AI 改代码，重新渲染就行。

手把手操作步骤

第 1 步：让 AI 生成 Mermaid 代码

打开你用的 AI（ChatGPT、Claude、Gemini 都行），输入（直接复制，替换成你的内容）：

请用 Mermaid 语法帮我画一个电商系统的架构图。
系统包含：用户端、商品管理、订单系统、支付系统、后台管理。
数据流向是：用户下单 → 订单系统调支付 → 支付完成通知商品管理扣库存。
请输出纯 Mermaid 代码，用 graph TD 格式。

AI 会返回一段像这样的代码：

graph TD
    A[用户端] --> B[订单系统]
    B --> C[支付系统]
    B --> D[商品管理]
    C --> E[支付完成]
    E --> D

第 2 步：把代码渲染成图片

打开这个免费网站：mermaid.live

把 AI 给你的代码粘贴到左边的编辑区
右边立刻就会显示出流程图
点右上角的"导出"按钮，选择 PNG 或 SVG 格式下载（SVG 是矢量图，放多大都不模糊，适合正式文档）

第 3 步：想修改？让 AI 改代码就行

把旧代码贴回给 AI，告诉它你想怎么改：

`1`	`把上面的代码改一下，在"用户端"和"订单系统"之间加一个"登录验证"模块。`

改好后重新去 mermaid.live 粘贴、导出就行。

优缺点

✅ 优点	❌ 缺点
图片质量好，专业感强	复杂的图后期修改仍然比较麻烦
比方案一好修改——改代码再渲染就行	架构逻辑有大的变化时，基本要重新生成
不需要安装任何软件，打开网页就能用

📌 小白避坑提示

Mermaid 语法有固定格式——让 AI 生成时明确说"用 Mermaid 语法"，AI 都知道
mermaid.live 是神器——粘贴即预览，完全免费，不用注册账号
导出选 SVG 更好——SVG 是矢量图，放多大都不模糊，适合正式文档
代码保存好——以后修改时直接把旧代码发给 AI，说"改这行"就行

方案三：让 AI 生成可编辑的架构图（适合做正式文档）

⏱ 耗时：10-15 分钟（第一次配置稍久） 🛠 需要：一个 AI 编程工具 + Obsidian + 一个"画图指令包"

一句话原理

这是最专业的方法，但第一次需要花点时间配置。装好之后，你告诉 AI 想画什么，AI 直接生成一个可以拖拽修改的架构图文件，你用 Obsidian 打开，哪里不满意就手动调一下。方案一方案二出的图是"死图"，这个方案出的图是"活的"。

🤔 先搞懂：什么是 “画图指令包”（Skills）？

Skills 就是一套写好的"说明书"，告诉 AI 怎么帮你画图。

没装之前：你跟 AI 说"帮我画个架构图"，AI 只能给你一段文字描述
装好之后：AI 知道怎么生成一个可以编辑的架构图文件

好比给你的 AI 装了一个"画图插件"。

这个指令包叫 axton-obsidian-visual-skills，是一个叫 Axton 的人做的免费开源项目。它含 3 种画图能力：

画图方式	生成的文件	适合画什么	画面风格
Excalidraw 画图	`.excalidraw` 文件	流程图、思维导图、架构图	✏️ 手绘风格（像白板上画的）
Mermaid 画图	一段文字规则	流程图、时序图、对比图	🎯 商务专业风格
Canvas 画布	`.canvas` 文件	思维导图、知识整理	🎨 彩色卡片

💡 也可以换 Draw.io——Draw.io 是另一款免费画图软件，也有对应的指令包。本教程以 Excalidraw 为例。

🔧 前置安装（只需一次）

💡 先搞懂：这个指令包要放哪里？

AI 工具会去你电脑上的固定位置找这些指令文件。推荐放这个位置：

C:\Users\你的用户名\.claude\skills\

🤔 这串路径是啥？

C:\Users\你的用户名\ ← 你的"用户文件夹"（也叫用户目录），你电脑上的软件默认把配置文件放这里

\.claude\ ← Claude Code 这个软件建的配置文件夹

skills\ ← 专门放画图指令的地方

不知道怎么查"你的用户名"？打开文件管理器，在地址栏输入 %USERPROFILE% 按回车，跳到的那个文件夹就是。

如果你的用户名是 xiaoming，那完整路径就是 C:\Users\xiaoming\.claude\skills\

🤔 为什么在 C 盘？ 因为你的用户文件夹默认就在 C 盘。放这里是让这台电脑上所有项目都能用这个指令包，不用每个项目都装一次。

这个位置 OpenCode 和 Claude Code 通用，文件放一次，两个工具都能用。

其他工具也可以放别的位置，但新手不用管，直接放上面那个路径就行。

安装方式一：让 AI 帮你装（推荐，最简单）

不管你用 OpenCode、Claude Code 还是 Cursor，直接对它说：

1
2
3

帮我从 GitHub 下载 axtonliu/axton-obsidian-visual-skills，
解压后把 excalidraw-diagram、mermaid-visualizer、obsidian-canvas-creator
这三个文件夹放到 C:\Users\你的电脑用户名\.claude\skills\ 目录下。

AI 会自动帮你完成下载、解压、复制。完成后重启工具即可。

💡 记得把上面路径里的"你的电脑用户名"换成你真正的用户名。

安装方式二：自己手动下载

如果 AI 不支持操作文件，或者你想自己来：

打开 axton-obsidian-visual-skills 下载页面
点绿色的 Code 按钮 → Download ZIP
解压下载的文件，你会看到 3 个文件夹
打开你的 C:\Users\你的用户名\.claude\ 文件夹（如果没有 skills 文件夹，就新建一个）

把解压出来的 3 个文件夹整个拖进去

最终效果是这样：

C:\Users\你的用户名\.claude\skills\
   ├── excalidraw-diagram\
   │     └── SKILL.md
   ├── mermaid-visualizer\
   │     └── SKILL.md
   └── obsidian-canvas-creator\
         └── SKILL.md

安装方式三：Claude Code 专属的快捷安装

如果你用的是 Claude Code（只有它支持这种方式），可以直接在聊天里输入：

1
2

/plugin marketplace add axtonliu/axton-obsidian-visual-skills
/plugin install obsidian-visual-skills

安装完重启 Claude Code 就能用。OpenCode 和 Cursor 不支持这种安装方式。

还需要装这些：

软件	用途	费用
OpenCode / Claude Code / Cursor	用来运行 AI 生成画图文件	各有免费方案
Obsidian	用来查看和手动调整架构图	免费
Obsidian Excalidraw 插件	在 Obsidian 里编辑 Excalidraw 文件	免费（插件市场直接搜 “Excalidraw” 安装）

🖐️ 手把手操作步骤

第 1 步：装好 Skills，告诉 AI 你想画什么

装好 Skills 之后，直接在 OpenCode、Claude Code 或 Cursor 里输入：

如果你想画 Excalidraw 手绘风格架构图：

用 Excalidraw 帮我画一个电商系统的架构图，包含：
用户端、商品管理、订单系统、支付系统、后台管理。
用户下单 → 订单系统调支付 → 支付完成扣库存。
用中文标注。

AI 会自动在当前目录下生成一个 .excalidraw 文件（比如 电商系统架构图.excalidraw.md）。

🔍 找不到文件？ 看看 AI 打印的输出信息，它通常会告诉你文件保存的路径，比如 文件已保存到：D:/project/电商系统架构图.excalidraw.md。记住这个路径，下一步要用。

如果你想画 Mermaid 商务风格流程图：

1
2

把这个流程转成 Mermaid 图表：
用户访问首页 → 浏览商品 → 加入购物车 → 提交订单 → 在线支付 → 完成交易

AI 会生成一段 Mermaid 代码，你复制到 mermaid.live 就能渲染成图。

如果你想画 Canvas 思维导图：

1
2

把这篇文章整理成 Obsidian Canvas 思维导图：
[粘贴你的内容]

AI 会生成一个 .canvas 文件，用 Obsidian 打开就能看到彩色卡片布局。

第 2 步：在 Obsidian 中手动调整

打开 Obsidian，把上一步生成的文件拖进去
如果是 Excalidraw 文件（.excalidraw 或 .md），双击就能进入编辑模式
你可以随意拖拽方框、调整箭头、修改文字、换颜色
想加模块就拖一个新框，想删除就选中按 Delete

💡 这一步相当于你有一个"活的"架构图，想怎么改就怎么改。

第 3 步（可选）：用 AI 换风格

调整好内容和布局后，如果你想要不同的视觉效果，可以截图发给 Gemini（或其他 AI），配上参考图说：

`1`	`帮我把图1转换成类似图2的手绘风格，并加入适量的图画帮助用户理解`

（提示词1：改变很大，连内容布局都可能调整）

`1`	`转换成类似图2的手绘画面风格`

（提示词2：改变较小，只改配色和画风，内容布局不变）

🔍 Excalidraw 技能能画哪些图？

这套 Skills 的 Excalidraw 画图支持以下类型：

图表类型	适合画什么
流程图	业务流程、操作步骤、任务顺序
思维导图	概念扩展、话题分类、头脑风暴
层级图	组织架构、系统分层、目录结构
关系图	依赖关系、影响关系、元素之间的交互
对比图	方案对比、选项分析、前后对比
时间线	事件演进、项目里程碑、版本迭代
矩阵图	二维分类、优先级矩阵、能力定位
自由画布	零散想法、初期构思、自由笔记

⚠️ 常见问题与解决

Q：中文字体没有手写效果怎么办？ A：Excalidraw 的手写字体（Excalifont）默认只支持英文，中文字体需要联网加载。如果你在 Obsidian 里中文显示为普通字体：

确保能访问 Excalidraw.com（需要网络）
或者从 Excalidraw 官方字体库下载中文字体文件
放到你的 Obsidian 笔记库的 Excalidraw/CJK Fonts 文件夹下
在 Excalidraw 插件设置里开启"启动时加载中文字体"，重启 Obsidian

Q：生成出来的图有点乱怎么办？ A：这很正常，因为 AI 生成的排版不一定完美。手动在 Obsidian 里拖拽调整一下就行——这也是方案三最大的优势。

Q：一定要用 Claude Code 吗？ A：不一定。这套 Skills 在 OpenCode、Claude Code、Cursor 上都能用。OpenCode 兼容 Claude Code 的 Skills 格式，直接安装就能用。

优缺点

✅ 优点	❌ 缺点
想怎么改就怎么改——拖拽就能调整	第一次配置环境需要花点时间
不依赖提示词质量，内容可手动精修	整体流程比较长，操作步骤多
可以做出一套风格统一的文档图	美化时偶尔会出现文字乱码或错位
结合 Obsidian 做知识管理很方便
一个 Skills 装好，三种画图方式随便选

📌 小白避坑提示

建议先用方案一和方案二，熟悉了再尝试方案三
Skills 安装是关键一步——装好了 AI 才知道怎么生成可编辑的文件
Excalidraw 默认是手绘风格，画出来像手画的，很亲切
Obsidian 的 Excalidraw 插件是体验最好的查看和编辑方式
方案三最大的价值是可修改——一次配置好，后续改图只需要拖拽几步就完成
动手前可以在 GitHub 上看这个仓库的演示视频，看到效果再决定要不要装

🔧 经常用到的工具汇总

工具	用途	费用	难度
Gemini	对话 + 文生图	免费	低
ChatGPT	对话 + 文生图	付费/免费版	低
OpenCode	AI 编程工具，自动加载 `~/.claude/skills/`，支持并行调度	免费	中
Claude Code	AI 编程工具，可加载 Skills	按 API 用量付费	中
Cursor	AI 编程工具	免费版够用	中
mermaid.live	Mermaid 代码转图片	免费	低
Excalidraw	可编辑架构图工具	免费开源	低
Obsidian	笔记软件 + Excalidraw 插件可编辑架构图	免费	中
axton-obsidian-visual-skills	AI 画图指令包（含 Excalidraw / Mermaid / Canvas 三种技能）	免费开源	中

🎯 新手快速入门路线图

第1天 → 试方案一：用 Gemini 直接生图（体验一下）
         ↓
第2天 → 试方案二：用 Mermaid.js 生成流程图
         （学会"改代码 = 改图"的思路）
         ↓
第3天 → 把方案二的图用在你的文档里
         ↓
需要了 → 再研究方案三：安装 Skills + Obsidian + Excalidraw 插件
（不着急，方案一和二已经够用）

💬 常见问题（小白 FAQ）

Q：这些工具都是免费的吗？ A：Gemini 和 mermaid.live 完全免费。ChatGPT 和 Claude 有免费额度，用完才需付费。

Q：生成出来的图片能商用吗？ A：可以，架构图是你自己的设计，AI 只是帮你画出来。

Q：我是产品经理/运营，不是程序员，也能画吗？ A：完全没问题。方案一只需要打字，方案二只要会复制粘贴，都不需要写代码。

Q：生成的图片有版权问题吗？ A：工具生成的图片版权归你所有，放心使用。

Q：Mac 和 Windows 都能用吗？ A：文中所有工具都有网页版，操作系统不影响。

Q：方案三说的 “axton-obsidian-visual-skills” 到底是什么，必须装吗？ A：它是一个开源的 AI 画图"指令包"。不装也能画图，但装了之后 AI 能直接生成可编辑的架构图文件（而不是一张死图片）。如果你只是偶尔画一两张图，用方案一方案二就够了；如果你需要反复修改、做正式文档，非常推荐装一下。

Q：方案三里的 3 种画图方式（Excalidraw / Mermaid / Canvas）有什么区别？ A：简单说——Excalidraw 像手绘白板，最适合画架构图；Mermaid 偏专业商务风，适合正式文档；Canvas 是彩色思维导图，适合整理思路。根据你要的效果选就行，不用全学。

Q：方案三一定要用 Claude Code 吗？用 ChatGPT 可以吗？ A：这套 Skills 是给 能操作本地文件的 AI 编程工具设计的，比如 OpenCode、Claude Code、Cursor 都行。ChatGPT 网页版没有本地文件操作能力，所以不能用。

Q：Skills 装好后在哪？我想看看装没装成功。 A：文件放到 ~/.claude/skills/ 目录下就算装好了。你可以手动去这个目录看一眼，里面应该有 excalidraw-diagram、mermaid-visualizer、obsidian-canvas-creator 三个文件夹。重启 AI 工具后，它就能识别到。

📝 最后的话：画架构图最重要的是理清你想表达什么，AI 只是帮你把想法变成图片。先从最简单的方案一开始动手，迈出第一步最重要！

Hugo + Stack + GitHub Pages 博客搭建指南

Mon, 08 Dec 2025 00:00:00 +0000

Hugo + Stack + GitHub Pages 博客搭建指南

使用 Hugo + Stack 主题搭建个人博客，并部署到 GitHub Pages 的完整流程。

本文兼顾 新版 Stack（v4.x，config 为 .toml 拆分格式） 和 旧版（v3.x，单文件 hugo.yaml） 的配置差异，关键差异处会标注说明。

环境准备

安装 Git

前往 Git 官网下载安装：https://git-scm.com/downloads
全部默认选项安装即可

安装 Hugo（Extended 版本）

前往 Hugo GitHub Releases：https://github.com/gohugoio/hugo/releases
选择 extended 版本（带 extended 字样），Stack 主题需要 extended 版本的 SCSS 编译支持
Windows 用户下载 hugo_extended_xxx_windows-amd64.zip，解压得到 hugo.exe

本文编写时使用的 Hugo 版本为 v0.161.1，Stack 主题版本为 v4.0.2。

GitHub 账号

注册 GitHub 账号：https://github.com
建议开启两步验证（2FA），可在 Edge 安装 Authenticator 2FA Client 插件

创建 Hugo 站点

初始化项目

在 hugo.exe 所在目录打开终端（地址栏输入 cmd 或 powershell），执行：

# 创建新站点
hugo new site myblog

# 进入站点目录
cd myblog

生成的文件结构：

myblog/
├── archetypes/    # 文章模板
├── assets/        # 静态资源（图片、CSS、JS）
├── content/       # 博客内容（文章）
├── data/          # 数据文件
├── i18n/          # 多语言
├── layouts/       # 布局模板
├── public/        # 构建输出（hugo 命令生成）
├── static/        # 静态文件（直接复制到 public）
├── themes/        # 主题
└── hugo.toml      # 站点配置

测试默认站点

`1`	`hugo server -D`

浏览器访问 http://localhost:1313/，此时页面会比较简陋（没有主题），Ctrl + C 停止服务。

配置 Stack 主题

下载主题

前往 Stack 主题 GitHub：https://github.com/CaiJimmy/hugo-theme-stack
下载最新 Release 的压缩包（或直接 Download ZIP）
解压到站点 themes/ 目录下

1
2

myblog/themes/
└── hugo-theme-stack-4.0.2/   # 带版本号的文件夹

配置主题文件 ⚠️ 关键步骤

⚠️ 版本差异注意

这一步是最容易出错的地方。新版 Stack（v4.x）和旧版（v3.x）的文件结构完全不同：

对比项	旧版 Stack（v3.x）	新版 Stack（v4.x）
样例目录名	`exampleSite/`	`demo/`
配置文件	单个 `hugo.yaml`	多个 `.toml` 文件在 `config/_default/`
主题引用	`theme: hugo-theme-stack`	`[[module.imports]]`（Hugo Modules 方式）

新版（v4.x）操作步骤：

Step 1：复制配置文件

# 创建 config/_default 目录
mkdir -p config/_default

# 复制 demo 的所有配置文件
cp themes/hugo-theme-stack-4.0.2/demo/config/_default/*.toml config/_default/

复制后 config/_default/ 内有 6 个配置文件：

文件	作用
`hugo.toml`	基础配置（baseURL、title、分页、永久链接等）
`languages.toml`	多语言配置
`markup.toml`	Markdown 渲染配置（代码高亮、目录等）
`menu.toml`	菜单配置（导航栏、社交链接）
`params.toml`	主题参数（侧边栏、评论、widgets 等）
`related.toml`	相关内容推荐配置

Step 2：修改主题引用方式

打开 config/_default/hugo.toml，找到：

1
2

[[module.imports]]
    path = "github.com/CaiJimmy/hugo-theme-stack/v3"

替换为：

`1`	`theme = "hugo-theme-stack-4.0.2"`

这种传统方式不需要 Go 环境和 Hugo Modules，更简单，和教程保持一致。

Step 3：处理根目录 hugo.toml 冲突

项目根目录的 hugo.toml 和 config/_default/hugo.toml 会冲突，备份或删除根目录的文件：

`1`	`mv hugo.toml hugo.toml.bak`

Step 4：复制示例内容

# 备份原有的 content（如果有内容的话）
mv content content_backup

# 复制 demo 的 content
cp -r themes/hugo-theme-stack-4.0.2/demo/content .

Step 5：复制头像等静态资源

1
2

mkdir -p assets/img
cp themes/hugo-theme-stack-4.0.2/demo/assets/img/avatar.png assets/img/

旧版（v3.x）操作步骤：

进入主题的 exampleSite/ 文件夹
复制 content 文件夹和 hugo.yaml 到站点根目录
删除根目录的 hugo.toml（因为已经有 hugo.yaml 了）
确认 hugo.yaml 中 theme 字段与主题文件夹名一致（建议去掉版本号）

启动验证

`1`	`hugo server -D`

浏览器访问 http://localhost:1313/，此时应该能看到完整的 Stack 主题效果（带侧边栏、搜索、示例文章等）。

如果页面不完整，检查终端是否有 WARN 提示（如 Search page not found、Archives page not found 等），通常是因为没有复制示例 content。

自定义配置

基础信息

编辑 config/_default/hugo.toml（新版）或 hugo.yaml（旧版）：

1
2

baseURL = "https://你的用户名.github.io/"
title   = "我的博客"

如果你以中文为主，建议设置：

1
2

defaultContentLanguage = "zh-cn"
hasCJKLanguage         = true   # 中文/日文/韩文设为 true

侧边栏

编辑 config/_default/params.toml（新版）或 hugo.yaml 的 params.sidebar 部分：

[sidebar]
    emoji    = "✏️"
    subtitle = "你的个性签名"
    avatar   = "img/avatar.png"

将头像图片放到 assets/img/avatar.png
emoji 可以在 emojiall.com 挑选

社交链接

编辑 config/_default/menu.toml（新版）或 hugo.yaml 的 menu.social 部分：

[[social]]
    identifier = "github"
    name       = "GitHub"
    url        = "https://github.com/你的用户名"
    params.icon = "brand-github"

图标名称参考 Tabler Icons（使用 brand-xxx 格式）。

评论系统

Stack 支持多种评论系统，以 utterances 为例（基于 GitHub Issues，无需额外注册）：

[comments]
    enabled  = true
    provider = "utterances"

    [comments.utterances]
        repo      = "你的用户名/你的用户名.github.io"
        issueTerm = "pathname"
        label     = ""

更多评论系统配置参考主题文档：https://stack.jimmycai.com/config/comments

页脚

1
2

[footer]
    since = 2026

创建文章

文章结构

Stack 主题推荐每篇文章用一个文件夹，包含 index.md 和图片资源：

`1`	`hugo new content post/我的第一篇文章/index.md`

生成的目录结构：

1
2
3

content/post/我的第一篇文章/
├── index.md      # 文章内容
└── image.jpg     # 文章配图（可选）

文章 Front Matter 示例

---
title: 我的第一篇文章
date: 2026-05-12
description: 文章摘要描述
tags:
  - Hugo
  - 博客
categories:
  - 教程
image: image.jpg   # 文章封面图（可选）
---

部署到 GitHub Pages

创建 GitHub 仓库

登录 GitHub，点击 New repository
仓库名填写：你的用户名.github.io（必须精确匹配）
选择 Public（GitHub Pages 免费版要求公开）
不勾选 “Add a README file”

手动部署

# 1. 构建静态网站（输出到 public/）
hugo -D

# 2. 进入 public 目录
cd public

# 3. 初始化 Git 并推送
git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/你的用户名/你的用户名.github.io.git
git push -u origin main

推送成功后，访问 https://你的用户名.github.io/ 即可看到博客（首次可能需要等待 1-2 分钟）。

自动部署（GitHub Actions）

每次手动构建推送很繁琐，可以用 GitHub Actions 实现推送代码 → 自动构建部署。

Step 1：创建源仓库

除了 用户名.github.io 这个部署仓库外，再创建一个源仓库（如 myblog），把整个 Hugo 项目推送到源仓库：

# 在站点根目录（不是在 public/ 里）
git init
git add .
git commit -m "init hugo site"
git branch -M main
git remote add origin https://github.com/你的用户名/myblog.git
git push -u origin main

Step 2：创建 GitHub Actions 工作流

在站点根目录创建 .github/workflows/deploy.yml：

name: Deploy Hugo site to GitHub Pages

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          submodules: true
          fetch-depth: 0

      - name: Setup Hugo
        uses: peaceiris/actions-hugo@v3
        with:
          hugo-version: 'latest'
          extended: true

      - name: Build
        run: hugo --minify

      - name: Deploy
        uses: peaceiris/actions-gh-pages@v4
        with:
          personal_token: ${{ secrets.PERSONAL_TOKEN }}
          external_repository: 你的用户名/你的用户名.github.io
          publish_branch: main
          publish_dir: ./public

Step 3：配置 GitHub Token

进入 GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)
生成新 Token，勾选 repo 和 workflow 权限
复制生成的 Token
进入源仓库 → Settings → Secrets and variables → Actions → New repository secret
Name 填写 PERSONAL_TOKEN，Value 粘贴 Token

之后每次 git push 到源仓库的 main 分支，GitHub Actions 就会自动构建并部署到 用户名.github.io。

💡 开启 lastmod 自动获取
在 config/_default/hugo.toml（新版）或 hugo.yaml（旧版）中添加：
1
2
3
enableGitInfo = true
[frontmatter]
  lastmod = [":git", ":fileModTime"]
这样文章会自动显示 Git 提交时间作为最后修改时间。这要求在 GitHub Actions 的 checkout 步骤中 fetch-depth: 0（已在上方配置中包含）。

常见问题

Q1：启动后页面空白/不完整？

检查是否复制了 demo 的 content 文件夹。缺少示例页面（search、archives 等）会导致主题显示不完整。

Q2：`hugo server` 报错 “Theme not found”？

新版：检查 config/_default/hugo.toml 中的 theme = "xxx" 是否与 themes/ 下的文件夹名一致
旧版：检查 hugo.yaml 中的 theme 字段

Q3：根目录 `hugo.toml` 和 `config/_default/hugo.toml` 冲突？

删除或备份根目录的 hugo.toml，Hugo 会优先使用 config/_default/ 下的配置文件。

Q4：推送到 GitHub 失败？

可能是网络问题，取消代理试试：

1
2

git config --global --unset http.proxy
git config --global --unset https.proxy

Q5：新版的 `[[module.imports]]` 是什么？

新版 Stack 默认使用 Hugo Modules（Go 模块）方式引入主题，需要 Go 环境。如果不想折腾 Go，直接改用 theme = "主题文件夹名" 的传统方式即可。

Q6：博客部署后样式错乱？

检查 baseURL 是否正确配置为 https://你的用户名.github.io/（注意结尾的 /）。baseURL 错误会导致 CSS/JS 资源加载失败。

参考资料

MCP入门指南：小白也能看懂的AI万能插头

Mon, 01 Dec 2025 01:46:03 +0800

概述

你有没有想过：ChatGPT、Claude 这些 AI 很聪明，但它们只能在对话框里聊天，没法帮你查日历、管文件、操作数据库——因为它们被"关在笼子里"，接触不到外面的世界。

MCP（Model Context Protocol，模型上下文协议） 就是来打破这堵墙的。

简单来说，MCP 是一个开放标准协议，让 AI 应用能够连接外部系统——文件、数据库、API、各种工具——就像给 AI 装了一个万能插头（USB-C 接口），插上什么就能用什么。

💡 一句话理解 MCP： 它是 AI 世界的"USB-C 接口"——统一标准，即插即用。

🤔 为什么要用 MCP？

没有 MCP 之前

在 MCP 出现之前，如果你想让 AI 连接外部工具（比如查天气、读日历、操作数据库），每个 AI 应用和每个工具之间都需要单独开发对接。

这就像早年的手机充电口——安卓一个、苹果一个、Type-C 一个，每换一个设备就得重新买线。

问题很明显：

开发成本高：每个对接都是从零开始
不通用：给 Claude 写的工具，ChatGPT 用不了
维护困难：工具一升级，所有对接都得改

有了 MCP 之后

MCP 定义了一个统一标准：

工具方按照 MCP 标准开发一个 MCP Server（服务端）
AI 应用作为 MCP Client（客户端）来连接它
只要双方都遵守 MCP 协议，即插即用，无需重复开发

这就像是 USB-C 统一了充电接口——一根线走天下。

🎯 MCP 能做什么？使用场景一览

1️⃣ 个人 AI 助手

让 AI 帮你管理日常生活：

📅 连接 Google Calendar，帮你查看日程、创建会议提醒
📝 连接 Notion，帮你整理笔记、管理待办事项
📧 连接 Gmail，帮你读取和回复邮件
💬 连接 Slack / 飞书，帮你总结聊天记录

举个例子： 你对 AI 说"帮我看看明天有什么会议，总结一下上周的项目进度笔记"——AI 就能自动查日历、翻 Notion，给你一份汇总。

2️⃣ 编程开发

让 AI 编程助手真正"动手干活"：

📁 通过 MCP 连接 本地文件系统，读写项目文件
🗄️ 连接 数据库，直接查询和修改数据
🐙 连接 GitHub，自动创建 Issue、提交 PR
🎨 连接 Figma，根据设计稿直接生成代码

举个例子： Claude Code 通过 MCP 连接 Figma，拿到设计稿后直接生成一个完整的 Web 应用。

3️⃣ 企业级应用

在公司里大展身手：

🏢 连接 多个数据库，让员工用自然语言查询业务数据
📊 连接 内部系统（CRM、ERP），AI 自动汇总报表
🔍 连接 知识库，让 AI 基于公司文档回答问题

4️⃣ 创意与设计

🖼️ 连接 Blender，让 AI 生成 3D 模型
🖨️ 连接 3D 打印机，直接打印设计
🎬 连接 视频编辑工具，自动化剪辑流程

🏗️ MCP 的核心架构

MCP 的架构非常简单，只有三个角色：

┌──────────────┐         ┌──────────────┐         ┌──────────────┐
│   AI 应用    │ ◄─────► │   MCP 协议    │ ◄─────► │  MCP Server  │
│ (MCP Client) │         │  (传输层)     │         │  (外部工具)   │
└──────────────┘         └──────────────┘         └──────────────┘

角色	说明	类比
MCP Client	AI 应用（如 Claude、ChatGPT、Cursor）	手机
MCP Server	提供具体能力的服务（如查天气、管文件）	充电器
MCP 协议	双方沟通的"语言"	USB-C 标准

MCP Server 能提供什么？

MCP Server 可以向 AI 暴露三类能力：

类型	说明	例子
Tools（工具）	AI 可以调用的函数/操作	搜索网页、发送邮件、查询数据库
Resources（资源）	AI 可以读取的数据	文件内容、数据库记录、API 返回值
Prompts（提示词模板）	预设的提示词模板	代码审查模板、翻译模板

🚀 怎么使用 MCP？

方式一：直接用现成的 MCP Server（推荐小白）

这是最简单的方式——别人已经写好了 MCP Server，你只需要"安装并连接"。

步骤 1：找到你需要的 MCP Server

MCP 生态已经有大量现成的 Server，常用的获取渠道：

官方仓库：github.com/modelcontextprotocol/servers
MCP 市场：mcp.so、smithery.ai
GitHub 搜索：搜索关键词 mcp-server

步骤 2：在 AI 应用中配置 MCP Server

以 Claude Desktop 为例，找到配置文件：

Windows：%APPDATA%\Claude\claude_desktop_config.json
macOS：~/Library/Application Support/Claude/claude_desktop_config.json

添加 MCP Server 配置（以 filesystem 为例）：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/你的/工作目录/路径"
      ]
    }
  }
}

保存后重启 Claude Desktop，AI 就拥有了操作文件的能力。

步骤 3：开始使用

重启后，在对话中直接让 AI 使用这些工具：

“帮我在工作目录下创建一个 notes 文件夹”
“读取 README.md 的内容，给我做个总结”
“搜索一下最近的项目 Issue”

AI 会自动调用对应的 MCP Server 来完成任务。

方式二：在 Cursor / VS Code 中使用 MCP

如果你用 Cursor 或 VS Code 进行编程开发，配置方式类似。

在项目根目录创建 .cursor/mcp.json（Cursor）或 .vscode/mcp.json（VS Code）：

{
  "mcpServers": {
    "fetch": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch"]
    },
    "sqlite": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sqlite", "./data.db"]
    }
  }
}

配置完成后，在 AI 对话中就可以使用这些工具了。

方式三：自己开发 MCP Server（进阶）

如果你想让 AI 连接自己的系统（比如公司内部 API），可以自己写一个 MCP Server。

MCP 支持多种编程语言，官方提供了 SDK：

语言	SDK
TypeScript	`@modelcontextprotocol/sdk`
Python	`mcp`（PyPI）
Java / Kotlin	`io.modelcontextprotocol`

最简示例（TypeScript）：

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const server = new McpServer({
  name: "my-server",
  version: "1.0.0"
});

// 定义一个"查天气"的工具
server.tool(
  "get_weather",
  { city: z.string().describe("城市名称") },
  async ({ city }) => {
    // 这里写你的业务逻辑
    const weather = `${city}今天晴天，25°C`;
    return {
      content: [{ type: "text", text: weather }]
    };
  }
);

// 启动服务
const transport = new StdioServerTransport();
await server.connect(transport);

写好后配置到 AI 应用中即可使用。

🌐 哪些 AI 应用支持 MCP？

MCP 已经成为行业标准，主流 AI 应用纷纷支持：

AI 应用	支持情况
Claude Desktop / Claude Code	✅ 原生支持
ChatGPT	✅ 支持
Cursor	✅ 支持
VS Code (Copilot)	✅ 支持
Windsurf	✅ 支持
OpenCode	✅ 支持

一次配置，多端通用——在 Claude 里配好的 MCP Server，换个应用照样能用。

❓ 常见问题

Q：MCP 和 API 有什么区别？

API 是两方之间的"私有协议"，每个 API 的调用方式都不同。MCP 是一个统一标准——所有遵守 MCP 的工具，AI 都能用同样的方式调用。可以把 MCP 理解为"AI 专用的 API 标准层"。

Q：使用 MCP 需要编程基础吗？

不需要！ 如果你只是使用现成的 MCP Server，只需要会复制粘贴配置文件就行。只有自己开发 MCP Server 时才需要编程。

Q：MCP 安全吗？

MCP Server 默认运行在本地，数据不会上传到云端。但使用第三方 MCP Server 时，建议查看其源码和权限，确保安全。

Q：MCP Server 运行需要什么环境？

大部分 MCP Server 基于 Node.js 运行，你需要先安装 Node.js。Python 版本的 Server 则需要 Python 环境。

📚 总结

问题	答案
MCP 是什么？	AI 连接外部工具的统一标准协议
为什么要用？	让 AI 真正"动手干活"，而不是只能聊天
谁能用？	所有人——小白用现成 Server，开发者可以自己写
怎么用？	找到 MCP Server → 配置到 AI 应用 → 重启使用

MCP 的本质就是：给 AI 世界统一一个"插口标准"，让工具和 AI 自由连接。

🔗 延伸阅读：

MCP 官方文档

MCP Server 仓库

MCP 中文社区

MCP Server	功能
`filesystem`	读写本地文件
`github`	操作 GitHub（Issue、PR）
`fetch`	抓取网页内容
`sqlite`	操作 SQLite 数据库
`notion`	操作 Notion 笔记
`memory`	持久化记忆存储

步骤	内容	一句话总结
第一步	安装 Node.js	装好"运行引擎"，让电脑能跑 JavaScript 程序
第二步	安装 Claude Code	装好"AI 助手"，并跳过登录
第三步	安装 CC-Switch	装好"换脑器"，用来切换 AI 模型
第四步	获取 DeepSeek API Key	拿到"钥匙"，用来调用 DeepSeek 的 AI 服务
第五步	配置 CC-Switch	用"换脑器"+“钥匙”，把 Claude Code 的大脑换成 DeepSeek
第六步	开始使用	在任何文件夹中输入 `claude` 启动 AI 助手！

新手入门 on Yanmu

C 盘爆满？用其他盘给 C 盘扩容

📦 准备工作

① 下载微 PE 工具箱

② 安装到系统

③ 重启进入引导页面

④ 进入 PE 环境

🛠️ 开始扩容

第一步 · 查看磁盘布局

第二步 · 选择要缩小的盘

第三步 · 调整分区

第四步 · 缩小盘符

第五步 · 合并给 C 盘

第六步 · 提交任务

第七步 · 等待执行

第八步 · 完成 🎉

🚀 重启 & 收尾

📌 小提示

OpenCode 新手进阶：并行调度与使用技巧全攻略

📋 目录

📌 核心要点概括

一、Session 并行：让 AI 同时干多件事

基础操作

实战场景

传统做法

OpenCode 做法

注意事项

二、Ultra Work：一键召唤 AI 编程团队

触发方式

工作原理

什么时候用？

实际效果

三、@ 指定智能体：让专业的人干专业的事

智能体能力表

使用示例

切换主智能体

四、Timeline 时光机：随意试错，随时回退

基本用法

实战场景

使用技巧

五、Ralph Loop：让 AI 死磕到底

启动方式

适用场景

和 Ultra Work 的区别

六、日常提速小技巧

1. 善用 /compact 节省上下文

2. 用 /init 让 AI 快速上手新项目

3. Share 分享你的编程过程

4. 查看可用模型

5. 快捷粘贴代码（VS Code 插件）

七、新手推荐工作流

一句话总结

八、一个真实案例

第一次尝试

纠正

5分钟安装ClaudeCode并接入DeepSeek

概述

第一步：安装运行环境

1.1 安装 Node.js

1.2 配置 npm 国内镜像

1.3 安装 Git

1.4 安装 CC-Switch

第二步：安装 Claude Code

跳过登录（使用第三方 API）

第三步：接入 DeepSeek

3.1 获取 API Key

3.2 配置 CC-Switch

3.3 验证模型

第四步：实战示例

命令速查表

常见问题

安装ClaudeCode并接入DeepSeek（面向小白）

概述

这份教程是给谁看的？

你要装什么？为什么要装这些？

安装 Node.js

下载 Node.js

安装 Node.js

验证 Node.js 是否安装成功

如何配置环境变量

1. 善用 `/compact` 节省上下文

2. 用 `/init` 让 AI 快速上手新项目