Beginner Guide on Yanmu

C Drive Full? Expand It Using Other Drives

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

C drive turning red is a common headache for Windows users—system update cache, temp files, desktop files, WeChat chat records… Before you know it, your C drive is packed. Replacing the hard drive is expensive, and cleaning only treats the symptoms. The most thorough solution is: borrow space from other drives for your C drive.

📖 Table of Contents (click to expand)

#	Section	Description
1	Preparation	Download, install, enter PE environment
2	Resize	8-step guide with Partition Assistant
3	Reboot & Cleanup	Return to Windows, clean boot menu
4	Tips	Additional advice and FAQs

📦 Preparation

⚡ In a nutshell: Put Windows into a “hibernation box” so the C drive isn’t occupied.

① Download WePE Toolbox

WePE Toolbox — a lightweight PE (Preinstallation Environment) tool, clean and ad-free.

② Install to System

Open the downloaded program and click 「Install into System Now」. It will automatically write the boot entry.

After installation, restart your computer. You’ll see the system boot selection screen.

⏱ Note: The countdown is only a few seconds. If it times out, it will boot into the current system. Watch closely and select quickly!

④ Enter PE Environment

Use arrow keys to select WePE Toolbox and press Enter.

💡 Why enter PE?

In the PE environment, your Windows system is completely “hibernated”—the C drive is not occupied by any process. This allows safe partition resizing. Think of it like surgery: the patient must be anesthetized before the operation. Other partition tools work on the same principle.

🛠️ Resize

Once in PE, the tool menu will pop up automatically. Click 「Partition Assistant」.

Step 1 · Check Disk Layout

Partition Assistant will show you the layout of all disk partitions. Identify which drive has free space to “donate” to the C drive.

Step 2 · Choose the Drive to Shrink

Here we use Software (D drive) as an example. We’ll “cut” some space from D drive to give to C drive.

💡 Which drive to choose?

✅ Prefer drives with plenty of free space that you don’t use often

❌ Avoid touching system recovery partitions or EFI partitions

Step 3 · Adjust Partition

Right-click D drive → 「Adjust Partition」.

Step 4 · Shrink the Drive

In the popup window, drag the slider or enter a value to decide how much space to take from D drive.

✅ Example: If you want to add 50GB to C drive, shrink D drive by 50GB here.

⚠️ Note: The shrink value must not exceed the used space on D drive, or it will error.

Click 「OK」 when done.

Step 5 · Merge into C Drive

You’ll now see a block of 「Unallocated Space」 next to D drive.

Step	Action
1	Right-click C drive → 「Adjust Partition」
2	Drag the slider all the way to the right to merge all unallocated space into C drive
3	Click 「OK」

Step 6 · Submit Task

Click 「Submit」 in the top-left corner.

⚠️ Critical Reminder

All the adjustments so far are just “plans” — they haven’t taken effect yet.

Only after clicking 「Submit」 will the system actually execute the partition operations. Double-check before submitting!

Step 7 · Wait for Execution

Partition Assistant will begin executing the adjustments. This may take several minutes to over ten minutes, depending on your disk size and speed.

⚠️	🔴 Do NOT power off or force shutdown during this process!
Otherwise, the partition table may be corrupted, causing data loss
Plug in the power adapter (laptop users)
Grab a cup of tea and wait patiently 🍵

Step 8 · Done 🎉

When you see the success message, the expansion is complete!

🚀 Reboot & Cleanup

#	Action
①	Click 「Restart」
②	At the boot menu, select your Windows system to boot normally
③	Open This PC and verify that C drive space has increased ✅

🧹 Final step: If you don’t want to see the boot selection screen every time, open WePE Toolbox → click 「Uninstall」 to restore the original state.

📌 Tips

Scenario	Recommendation
🟢 C drive is too small (< 30GB)	Expand to at least 80 ~ 100GB
🟡 D drive also has no free space	Clean up D drive, or use an external drive to transfer large files
🔴 Worried about data loss before operation	Strongly recommend backing up important files first! Partition Assistant is stable, but better safe than sorry

✨ That's the complete guide to expanding your C drive. May your computer never see red again!

OpenCode Beginner to Advanced: A Complete Guide to Parallel Scheduling and Usage Tips

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

📋 Table of Contents

📌 Key Points Summary

Feature	One-Line Description
Session Parallelism	OpenCode’s killer feature — multiple tasks running simultaneously, no interference, double efficiency
Ultra Work Mode	Type `ULW`, the main agent auto-breaks tasks and dispatches sub-agents to work in parallel
@ Designate Agent	Let the frontend expert do frontend, the architect do reviews — everyone does what they’re best at
Timeline Time Machine	Roll back to any historical checkpoint anytime, zero-cost experimentation
Ralph Loop	Let AI work in loops for hours, tackling the hardest tasks

1. Session Parallelism: Let AI Handle Multiple Tasks Simultaneously

This is OpenCode’s greatest differentiating advantage over other AI programming tools. Traditional tools can only work sequentially — one task must finish before the next begins. OpenCode can run multiple Sessions simultaneously without interference.

Basic Operations

/new              # Create a new Session
/sessions         # View all Session statuses (spinning = running)
/session <id>     # Switch to a specific Session
/session prev     # Return to the previous Session

Real-World Scenario

Suppose you’re developing a “Draw and Guess” game with two independent requirements:

Requirement A: Add a timer that starts on first brush stroke, game fails after 20 seconds
Requirement B: Brush color adjustment

Traditional Approach

Finish A first, then B → Requirement B waits 5-10 minutes for nothing.

OpenCode Approach

1. Enter requirement A, AI starts working
2. Enter /new, create a new Session
3. Enter requirement B, AI starts working
4. Enter /sessions to check progress:

   Session 1  ◐  Adding timer logic...
   Session 2  ◐  Adding color picker...

Both requirements developed in parallel, total time compressed from 15 minutes to 8 minutes.

Notes

⚠️ Sessions are completely isolated — modifying the same file may cause conflicts, assign to different modules
⚠️ Background Sessions don’t auto-notify completion, manually check with /sessions
✅ You can /new anytime to open a third, fourth… no limit

2. Ultra Work: One-Click AI Programming Team

If Session parallelism is “manual transmission,” then Ultra Work is “full self-driving.” Enter a magic word and AI automatically splits tasks, assigns them to the most suitable agents, and executes in parallel.

Trigger Method

Include any of these keywords in your prompt:

1
2
3

ULW
ultrawork
Ultra Work

How It Works

Your requirement: Help me build a pet store website
        │
        ▼
  ┌─────────────────────────────┐
  │  Sisyphus (Main Agent)       │
  │  1. Break down → Todo List   │
  │  2. Assign subtasks          │
  └──────┬──────────┬───────────┘
         │          │
    ┌────▼───┐ ┌───▼────┐ ┌────────▼────┐
    │ Prophet │ │ Frontend│ │ Doc Writer  │
    │ Arch.   │ │ UI Dev  │ │ Docs Gen    │
    └────────┘ └────────┘ └─────────────┘
         │          │            │
         └──────────┴────────────┘
                    │
                    ▼
              Complete Project Delivery

Auto-split into Todo List
Launch 3 background tasks running in parallel
Main agent orchestrates from center
Final delivery of complete project

When to Use?

Scenario	Suitable	Notes
Create complete project from scratch	✅ Excellent	Auto-splits frontend, backend, docs
Multi-module parallel development	✅ Excellent	Clear agent division of labor
Single-file small changes	❌ Not recommended	Overkill, actually slower
Simple bug fix	❌ Not recommended	Regular chat is faster

💡 The higher the complexity, the greater Ultra Work’s value. Simple tasks get slower due to scheduling overhead.

Actual Results

Used Ultra Work mode to create a pet store website:

✅ Used emojis as decorations with no image assets
✅ Clean interface, smooth interactions, complete animations

3. @ Designate Agent: Let Experts Do What They Do Best

After installing Oh My OpenAgent (OMO), you have an AI programming team. Use @ to call specific agents.

Agent Capability Table

Agent	Specialty	Best Model	Example Usage
🧠 Sisyphus	Planning, task orchestration	Claude Opus	Complex multi-step tasks
🔮 Prophet	Architecture design, code review	GPT 5.5	Project structure design
🎨 Frontend Engineer	UI development, page layout	Gemini 3 Pro	Responsive layout optimization
🔍 Explorer	Web search, research	MiniMax	Find latest API docs
📚 Librarian	Literature review, doc retrieval	—	Analyze open-source codebases
📝 Document Writer	README, comments generation	—	Generate project docs
🖼️ Multimodal	Image/PDF understanding	—	Write code from design mockups

Usage Examples

@Frontend Engineer Convert this login page to responsive layout, mobile should look good too

@Prophet Review the code under src/service/, find potential performance issues

@Explorer Look up the latest usage of React 19 Server Components

@Document Writer Generate API documentation for the entire project

Switch Main Agent

Press Tab to switch the main agent for the current conversation — great for extended use of a specific role.

4. Timeline Time Machine: Experiment Freely, Rollback Anytime

What’s the scariest thing in programming? Changing a ton of code, realizing the approach was wrong, and having no way back. Timeline is your undo button.

Basic Usage

`1`	`/timeline # List every conversation step in the current Session`

Select any node:

Revert: Roll back both code and chat content to that point, like nothing happened
View: See what modifications the AI made at that time

Real-World Scenario

1
2
3

1. You had AI refactor a module → Results are unsatisfactory
2. /timeline → Select pre-refactor node → Revert
3. Code returns to pre-refactor state, try a different approach

Tips

🕐 After completing a milestone, mentally note that checkpoint (which conversation step)
🕐 Boldly try radical approaches — one-click rollback anytime
🕐 Compare two approaches: Revert to Approach A → Check results → Revert to Approach B → Compare

This is the programming version of “save/load” — explore any possibility fearlessly.

5. Ralph Loop: Let AI Push Through to the End

This mode makes AI work in continuous loops until the task is truly complete. Perfect for tough tasks requiring iterative refinement.

Launch Method

`1`	`/ralph-loop`

Use Cases

"Refactor the entire project using the latest Spring Boot 4 standards until all test cases pass"

"Check every file under src/ for code standard violations and fix each one"

"Add complete unit tests to the project until coverage reaches 90%"

Difference from Ultra Work

Dimension	Ultra Work	Ralph Loop
Mechanism	Parallel split, multi-agent collaboration	Serial loop, continuous iteration
Best for	Building from scratch, multi-module projects	Refactoring, fixing, target-reaching tasks
Duration	Minutes to tens of minutes	Potentially hours
End point	Task breakdown complete	Termination condition met

⚠️ Ralph Loop may run for a long time — watch your API quota consumption.

6. Daily Speed Tips

1. Use `/compact` to Save Context

When you’ve chatted many rounds with AI and the context window is nearly full:

`1`	`/compact`

AI refines previous conversations into a summary, freeing space to continue working. No need to start a new chat and lose context.

2. Use `/init` to Get AI Up to Speed on New Projects

When entering a new project, have AI read through the code first:

/init

AI scans the entire project and generates agents.md as a system prompt. All subsequent conversations will be based on this understanding — massive efficiency boost.

1
2
3

/share      # Generate a share link showing complete conversation and code changes
/unshare    # Stop sharing, link becomes invalid
/export     # Export conversation history as a file

Great for:

Showing colleagues how you solved a problem with AI
Documenting pitfalls for team reference 素材 for blog posts

4. View Available Models

`1`	`/models # Models marked "free" are free to use`

GLM-4.7 and MiniMax-2.1 have decent programming capabilities, suitable for lightweight tasks.

5. Quick Code Paste (VS Code Plugin)

In VS Code, select a code snippet → Ctrl + Alt + K → Directly paste into OpenCode dialog.

Eliminates copy-paste switching costs, maintaining your flow state.

7. Recommended Workflow for Beginners

┌─────────────────────────────────────────────┐
│                 New Requirement              │
└──────────────────┬──────────────────────────┘
                   │
                   ▼
          ┌────────────────┐
          │ Simple?         │
          └───┬────────┬───┘
              │ Yes     │ No (Complex/Multi-module)
              ▼         ▼
    ┌─────────────┐  ┌─────────────────┐
    │ Regular chat │  │ Enter ULW to    │
    │ handles it   │  │ trigger Ultra   │
    └─────────────┘  │ Work mode       │
                     └────────┬────────┘
                              │
                   ┌──────────▼──────────┐
                   │ Multiple independent │
                   │ subtasks?            │
                   └───┬──────────┬──────┘
                       │ Yes       │ No
                       ▼           ▼
              ┌─────────────┐ ┌──────────────┐
              │ /new open    │ │ Wait for Ultra│
              │ multiple     │ │ Work to auto  │
              │ Sessions     │ │ complete      │
              └──────┬──────┘ └──────────────┘
                     │
                     ▼
              ┌─────────────┐
              │ /sessions    │
              │ Check all    │
              │ progress     │
              └──────┬──────┘
                     │
                     ▼
              ┌─────────────┐
              │ Wrong        │
              │ direction?   │
              └───┬─────────┘
                  │
                  ▼
              ┌─────────────┐
              │ /timeline →  │
              │ Revert       │
              └─────────────┘

One-Line Summary

Small tasks chat directly, big tasks call ULW, parallel with Sessions, mistakes get Timeline rollback, stubborn problems activate Ralph Loop.

8. A Real-World Case Study

After installing Oh My OpenAgent, I wanted to adjust agent model configuration — making GitHub Copilot the primary and free OpenCode Zen the fallback.

First Attempt

Said directly in an OpenCode conversation:

“I also have your free OpenCode Zen, but I’ve already logged into GitHub Copilot — help me modify it”

AI set OpenCode Zen as primary — because the primary/secondary relationship wasn’t clear. ❌

Correction

“No, GitHub Copilot should be primary, and OpenCode Zen’s built-in free model as fallback”

AI immediately corrected it, updating oh-my-openagent.json so all Agents use github-copilot/* as primary and opencode/* as fallback. ✅

💡 Lesson: When describing requirements to AI, always make the primary/secondary relationship clear — “XX as primary, YY as fallback” — don’t just say “add YY for me.”

📚 Reference: OpenCode In-Depth Guide, Oh My OpenAgent 📅 Note generated: 2026-05-07

Install Claude Code and Connect DeepSeek (Beginner-Friendly Guide)

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

Overview

Who Is This Tutorial For?

This tutorial is for users with no computer background at all. You don’t need to know what a “command line” is, what “environment variables” are, or what “version management” is — I will break down every step to the finest detail, telling you where to click, what to click, what to type, and what you should see to know it worked.

What Are We Installing? Why Do We Need These?

Before we start, let’s understand the 3 things we need to install and what each one does:

#	Software	One-Line Explanation	Why It’s Required
1	Node.js	The “engine” that lets your computer run JavaScript programs	Claude Code is written in JavaScript and won’t run without it
2	Claude Code	An AI programming assistant that lives in your computer’s terminal	This is what we ultimately want to use
3	CC-Switch	A small tool to “swap the brain” of Claude Code	Switches Claude Code from the expensive official model to the affordable DeepSeek

The whole process takes about 10-15 minutes. Please follow the steps in order — don’t skip around.

📌 Prerequisites

You need a Windows computer (Windows 10/11) with a working internet connection.

Install Node.js

What is Node.js?

Node.js = the runtime environment that lets your computer run Claude Code. It’s completely free. Just like you need Windows installed before you can run software, you need Node.js installed before you can run Claude Code.

Download Node.js

Step 1: Open Your Browser

Open any browser on your computer (Chrome, Edge, or Firefox).

Step 2: Visit the Node.js Official Website

Type the following URL into the browser’s address bar (the long bar at the top where you enter web addresses) and press Enter:

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

Step 3: Find the Download Button

Once the page loads, you’ll see two large buttons in the center:

The left button says LTS (with a recommended version number, e.g., 22.16.0 LTS)
The right button says Current

Click the left LTS button — your browser will automatically start downloading a .msi file.

Step 4: Find the Downloaded File

Once the download completes (usually just a few seconds), there are two ways to find the file:

Method 1: Click the download list in the top-right corner of your browser (usually a downward arrow ↓ icon) and find the file you just downloaded — the filename will be something like node-v22.16.0-x64.msi
Method 2: Open File Explorer (the window you use to browse folders), find the Downloads folder in the left sidebar, and the file will be inside

Install Node.js

Step 1: Double-click the Installer

In the Downloads folder, find node-v22.16.0-x64.msi (the version number may differ slightly) and double-click it.

Step 2: Welcome Screen

A window titled Node.js Setup will appear. Click the Next button at the bottom.

Step 3: License Agreement

The window displays a long block of English license text.

Check the box in the bottom-left corner: I accept the terms in the License Agreement
Click Next

Step 4: Installation Location (⚠️ Important! You Need to Change the Path)

This shows where Node.js will be installed on your computer.

The default path is: C:\Program Files\nodejs\

📌 Move It to the D Drive!

It’s recommended to install to the D drive because:

The C drive is your system drive — putting too much on it slows down your computer

The D drive is for software — if you ever need to reinstall Windows, everything on D stays safe

It’s easier to manage and find things

Steps to change:

Click inside the path input box, select everything (press Ctrl + A), then delete it
Type the new path:
1

D:\nodejs\
Click Next

💡 Note

Make sure the path has no Chinese characters or spaces, or the installation may fail.

Step 5: Custom Setup

A page with a tree-like checkbox list appears (Custom Setup).

Don’t change anything — just click Next.

Step 6: Confirm Installation

Click the Install button. If a security prompt appears, click Yes.

Step 7: Wait for Installation

The progress bar will complete — usually takes just 10-30 seconds.

Step 8: Finish

Click Finish.

Node.js Installation Complete!

Both Node.js and npm (Node.js’s package manager — think of it as an “app store”) are now installed.

Verify Node.js Is Installed Correctly

After installation, we need to verify everything — like checking your groceries to make sure nothing’s missing.

Step 1: Open Command Prompt (CMD)

What is “Command Prompt”?

Command Prompt (also called CMD) is a black window with white text where you can type text commands to make your computer do things. You’ll use it often going forward.

How to open it (choose one):

Method 1 (Recommended):
1. Hold down the Win key on your keyboard (bottom-left corner, the key with the Windows logo)
2. While holding it, press the R key
3. A small window titled “Run” will pop up — type cmd in it
4. Click OK or press Enter
Method 2:
1. Click the Start menu in the bottom-left corner of your desktop (Windows icon)
2. Type cmd in the search box
3. Click Command Prompt in the search results

Step 2: Enter Verification Commands

In the black window that opens, type the following (the characters will appear on screen as you type), then press Enter:

node -v

If the window displays something like v22.16.0, Node.js is installed successfully ✅

Now type this command and press Enter:

npm -v

If it displays a version number like 10.9.2, npm is also working ✅

⚠️ Seeing “’node’ is not recognized as an internal or external command”?

Your environment variables aren’t set up correctly. See 1.4 How to Configure Environment Variables below.

How to Configure Environment Variables

What Are Environment Variables (PATH)?

PATH can be thought of as your computer’s “address book.” When you type node in the command prompt, your computer doesn’t know where node is installed — it looks it up in PATH, the “address book.” If Node.js’s installation directory isn’t in PATH, the computer can’t find it and reports “’node’ is not recognized.”

Normally, the Node.js installer adds itself to PATH automatically. But if something goes wrong, you need to add it manually.

Check If Node.js Is Already in PATH

Press Win + R, type sysdm.cpl, press Enter
Click the Advanced tab at the top
Click the Environment Variables button at the bottom
In the System variables list at the bottom, find the Path row, select it, and click Edit

In the list that pops up, check if there’s an entry like:

`1`	`D:\nodejs\`

💡 The Path Must Match Where You Installed

If you installed to D:\Software\nodejs\, then the entry should show D:\Software\nodejs\.

If the entry exists: PATH is fine, but if it’s still not working, close all current Command Prompt windows and open a new one, then try again.

If the entry doesn’t exist: Follow the steps below to add it manually.

Manually Add Node.js to PATH

In the Edit Environment Variable window you just opened, click New
Type the Node.js installation path:
1

D:\nodejs\
Click OK
Click OK to close the Environment Variables window
Click OK to close the System Properties window
Close all open Command Prompt windows and open a new one (old windows won’t pick up the new settings)
Type node -v again to verify

Configure npm Domestic Mirror (Strongly Recommended)

💡 Why Configure This?

By default, npm downloads software from overseas, which is very slow. Configuring a domestic mirror speeds up downloads by more than 10 times.

In Command Prompt, type the following command and press Enter:

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

Verify with this command — if it shows https://registry.npmmirror.com/, it worked ✅:

`1`	`npm config get registry`

Step 1 Complete!

You’ve installed Node.js on your computer and configured the domestic mirror. Now let’s install Claude Code.

Install Claude Code

Install Claude Code via npm

Open Command Prompt (if not already open), type the following command, and press Enter:

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

Wait for the installation to finish (usually 1-3 minutes). Text will scroll on the screen — as long as there’s no error at the end, you’re fine.

Verify Installation

Type:

`1`	`claude --version`

Press Enter. If it shows a version number (e.g., 1.0.x), installation was successful ✅

Why Skip Login?

Claude Code officially requires you to log in with an Anthropic account. But Anthropic’s services require an overseas credit card for payment, which is inconvenient for domestic users.

Our approach: skip login first, then use the CC-Switch tool to connect to the domestic DeepSeek model. This way you don’t need an Anthropic account at all, and the cost is much lower.

Step 1: Launch Claude Code Once

Type this in Command Prompt:

claude

Press Enter. Claude Code will launch and may display some introductory information or ask you to log in.

Ignore it — just close the Command Prompt window (click the × in the top-right corner).

Step 2: Find the Configuration File

Press Win + R (Win key and R key at the same time)
In the “Run” window that pops up, type %USERPROFILE%
Click OK or press Enter
You’ll see a folder with various files and subfolders

Step 3: Find the .claude.json File

In this folder, look for a file named .claude.json.

⚠️ Can’t Find This File?

If you can’t find .claude.json, possible reasons:

File extensions are hidden — in the folder window, click View → check File name extensions and Hidden items

Claude Code hasn’t created this file yet — go back to Step 1 and make sure you launched Claude Code at least once

In some cases, the file might be inside the .claude folder, named settings.json

Step 4: Open the Config File with Notepad

Right-click the .claude.json file
In the popup menu, select Open with
Choose Notepad
- If Notepad isn’t in the list, select Choose another app → find Notepad in the list → click OK

Step 5: Edit the Config File

When you open it, you’ll see something like this (the exact content may vary):

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

We need to add the line "hasCompletedOnboarding": true before the final }.

After editing, it should look like this:

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

📌 ⚠️ Three Critical Details — Get These Wrong and It’ll Break!

Add a comma: the line before hasCompletedOnboarding needs an English comma , at the end

Use English quotes: the quotes must be English ", not Chinese "

true is lowercase: it must be true, not True

Step 6: Save the File

Press Ctrl + S to save (or click File → Save in the top-left corner)
Close the Notepad window

Step 7: Verify Skip Login Worked

Reopen Command Prompt (Win + R → cmd → Enter)
Type claude, press Enter
If you go straight into Claude Code’s main interface (with no login prompt), skip-login was successful ✅

Step 2 Complete!

Claude Code is installed and login has been skipped. Now let’s install CC-Switch to connect DeepSeek.

Install CC-Switch (Model Switching Tool)

What Is CC-Switch?

CC-Switch is a visual tool that lets you swap Claude Code’s “brain” from the official model to DeepSeek — no manual config file editing needed, just point and click.

Download CC-Switch

Step 1: Open the Download Page

Type the following URL into your browser’s address bar and press Enter:

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

Step 2: Find the Latest Version

Once the page loads, find the version with the green Latest label and click to expand it.

Step 3: Find the Download Link

After expanding, scroll down, find the word Assets (there may be a small arrow ▾ next to it), and click to expand it.

Find the file ending with .msi (Windows installer) and click the filename to start the download.

💡 Which File to Choose?

Windows computer: choose the file ending in x64.msi

Mac computer: choose the file ending in .dmg

Install CC-Switch

Step 1: Double-click the Installer

In the Downloads folder, double-click the downloaded .msi file. If a security prompt appears, click Run anyway or More info → Run anyway.

Step 2: Follow the Prompts

The installation wizard is similar to Node.js:

Click Next
Accept the agreement → Next
Keep the default installation path → Next
Click Install
Wait for installation to complete → Finish

Step 3 Complete!

CC-Switch is installed. Now let’s get a DeepSeek API Key.

Get a DeepSeek API Key

What Is DeepSeek?

A domestic large language model with powerful performance and low pricing (about 10-30 RMB per month for daily use). Connecting to it dramatically reduces your usage costs.

What Is an API Key?

An API Key is a key used to access DeepSeek’s AI services. Each use deducts from your account balance. You need to: ① Register an account ② Add funds ③ Create a Key

Register a DeepSeek Account

Step 1: Open the DeepSeek Open Platform

Type this into your browser’s address bar:

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

Press Enter.

💡 Note

This is DeepSeek’s developer platform (platform.deepseek.com), not the chat website (chat.deepseek.com). Don’t mix them up.

Step 2: Register / Log In

In the top-right corner of the page, there are Log In / Sign Up buttons
Click Sign Up (if you don’t have an account) or Log In (if you already have one)
Follow the on-screen prompts to complete registration

Add Funds to Your Account

💡 Cost Reference

Daily use costs only about 10-30 RMB per month. A first-time top-up of 20-50 RMB is recommended.

After logging in, find Top Up (or Wallet / Billing) in the left sidebar menu and click it
Select the amount, choose a payment method, and complete the payment
Make sure your account balance is greater than 0 (you can’t use the API without a balance)

Create an API Key

Step 1: Go to the API Keys Page

After logging in, find API Keys in the left sidebar menu and click it
You’ll see an API Keys management page

Step 2: Create a New API Key

Click the Create API Key button
A dialog will pop up asking you to name your Key
- You can name it anything — claude-code, my-key, test are all fine
- The name is just for your own reference to distinguish different Keys
Click Confirm or Create

Step 3: Copy the API Key (⚠️ Most Critical Step!)

Once created, the page will display your API Key in a format like:

`1`	`sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

⚠️ This Key Is Only Shown Once!

After you close the dialog, you’ll never see it again. Copy and save it immediately to Notepad or WeChat File Transfer.

🚨 Security Reminder

An API Key is equivalent to your account password. Don’t share it with anyone and don’t post it publicly. If you suspect it’s been leaked, delete it immediately and create a new one.

Step 4 Complete!

You now have a DeepSeek API Key. For the final step, we’ll give this key to CC-Switch to complete the connection.

Configure CC-Switch to Connect DeepSeek

Open CC-Switch

Find the CC-Switch icon on your desktop or in the Start menu and double-click to open it.

Add a DeepSeek Configuration

Step 1: Click the Add Button

Once CC-Switch opens, find the + button (plus sign) in the top-right corner and click it.

Step 2: Fill In the Configuration

After clicking +, a configuration panel will pop up. Fill in the following:

① Model Preset: Select DeepSeek

② API Key: Paste the DeepSeek API Key you copied earlier (make sure there are no leading or trailing spaces)

③ Model Name: Delete whatever is in the input box and type:

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

④ Base URL / API Address (if present):

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

Step 3: Save the Configuration

After double-checking all fields, click Add / Save / Confirm.

Switch to DeepSeek

Return to CC-Switch’s main interface
You’ll see the DeepSeek configuration you just added in the list
Click the Switch / Enable button next to that configuration
The interface should show “Current Model: DeepSeek” or similar

Verify the Connection

Open Command Prompt and type claude to launch Claude Code.

Inside Claude Code, type:

/model

Press Enter. If the displayed model info includes DeepSeek, the connection is successful ✅

All Configuration Complete!

You can now start using the AI programming assistant!

Start Using It (Hands-on Example)

Now that everything is configured, let’s do a simple exercise to make sure it all works.

Create a Project Folder and Open Command Prompt

Right-click on the desktop → New → Folder, name it my-first-ai-project
Double-click to open the folder
Click the address bar at the top of the window, type cmd, and press Enter

Launch Claude Code

In the Command Prompt window that appears, type:

claude

Press Enter. If asked whether to trust this folder, type y and press Enter.

Give Your First Instruction

Once Claude Code starts, type the following (you can use plain English):

`1`	`Help me create a simple personal homepage using HTML + CSS + JavaScript, with a title, a short self-introduction, and a dark mode toggle button`

Press Enter to submit.

Handle Permission Requests

During execution, Claude Code may ask for permission to create/modify files — just select Yes. For your own projects, you can choose Yes, always allow (won’t ask again).

Check the Result

After completion, go back to the project folder and double-click index.html — it’ll open in your browser, and you’ll see the webpage the AI created for you!

Congratulations!

You’ve completed your first project with Claude Code + DeepSeek!

Command Quick Reference

Operation	Command	Description
Check Node.js version	`node -v`	Verify Node.js is installed
Check npm version	`npm -v`	Verify npm is working
Set npm mirror	`npm config set registry https://registry.npmmirror.com/`	Speed up downloads
Check npm mirror	`npm config get registry`	Verify mirror is active
Install Claude Code	`npm install -g @anthropic-ai/claude-code`	Global install
Check Claude Code version	`claude --version`	Verify Claude Code is installed
Launch Claude Code	`claude`	Start in current folder
Check current model	`/model`	Type inside Claude Code
Exit Claude Code	`/exit` or press `Ctrl + C` twice	Quit the program

FAQ

node -v says “’node’ is not recognized as an internal or external command”?

Node.js environment variables (PATH) aren’t configured correctly. Open File Explorer and go to D:\nodejs\ to see if node.exe is there:

The file exists: Node.js is installed but PATH isn’t set up — follow the steps in 1.4 How to Configure Environment Variables to add it manually

The file doesn’t exist: Installation failed — re-download and reinstall

claude says “‘claude’ is not recognized as an internal or external command”?

Claude Code installation failed. First verify node -v and npm -v are working, then re-run npm install -g @anthropic-ai/claude-code.

Claude Code asks me to log in to an Anthropic account after launching?

The .claude.json file wasn’t edited correctly. Press Win + R, type %USERPROFILE% and press Enter, find .claude.json and open it with Notepad. Make sure it contains "hasCompletedOnboarding": true, with an English comma at the end of the preceding line, true in lowercase, and English quotation marks.

Claude Code shows errors or no response during conversation?

Common causes: ① DeepSeek account balance is insufficient ② API Key is entered incorrectly ③ Model name isn’t deepseek-v4-pro[1m] ④ Network issues. Check each one.

npm install of Claude Code is very slow (over 5 minutes)?

Check if the domestic mirror is configured: npm config get registry (should show registry.npmmirror.com). If not, run npm config set registry https://registry.npmmirror.com/ and retry.

CC-Switch won’t open or crashes on launch?

Download the latest version from GitHub Releases, or try right-clicking and running as administrator.

GitHub page won’t load?

Cause: GitHub may be unstable to access from within China. Solutions:

Refresh the page several times

Try a different browser

If you still can’t access it, search for “CC-Switch download” online — some domestic mirror sites may also host the download

Complete Process Review

Step Content One-Line Summary

Step 1 Install Node.js Set up the “runtime engine” so your computer can run JavaScript programs

Step 2 Install Claude Code Install the “AI assistant” and skip login

Step 3 Install CC-Switch Install the “brain-swapper” to change AI models

Step 4 Get DeepSeek API Key Get the “key” to access DeepSeek’s AI services

Step 5 Configure CC-Switch Use the “brain-swapper” + “key” to switch Claude Code’s brain to DeepSeek

Step 6 Start Using Type claude in any folder to launch your AI assistant!

After completing all steps, you can open any folder on your computer, type the claude command, and launch a DeepSeek-powered AI programming assistant!

Step	Content	One-Line Summary
Step 1	Install Node.js	Set up the “runtime engine” so your computer can run JavaScript programs
Step 2	Install Claude Code	Install the “AI assistant” and skip login
Step 3	Install CC-Switch	Install the “brain-swapper” to change AI models
Step 4	Get DeepSeek API Key	Get the “key” to access DeepSeek’s AI services
Step 5	Configure CC-Switch	Use the “brain-swapper” + “key” to switch Claude Code’s brain to DeepSeek
Step 6	Start Using	Type `claude` in any folder to launch your AI assistant!

Install Claude Code in 5 Minutes and Connect DeepSeek

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

Overview

Claude Code is a command-line AI programming assistant launched by Anthropic, with a variety of built-in Skills plugins. Through different combinations, it can accomplish many things that AI alone cannot do. After connecting to the domestic large model DeepSeek V4, usage costs can be significantly reduced.

Core uses:

Building a personal knowledge base, automating the organization of study notes
Collecting industry information on schedule and organizing it into manuscripts
Automatically publishing to various social media platforms

Step 1: Install the Runtime Environment

1.1 Install Node.js

Go to the Node.js official website to download the Windows installer (.msi), double-click and follow the prompts.

Verify installation:

1
2

node -v
npm -v

1.2 Configure npm Domestic Mirror

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

💡 Why configure a mirror?

The default npm source is overseas, and download speeds are very slow. After configuring a domestic mirror, installation speed can be improved by more than 10 times.

1.3 Install Git

Go to the Git official website to download the corresponding version installer and follow the prompts.

Verify installation:

git -v

1.4 Install CC-Switch

CC-Switch is used to connect third-party models to Claude Code.

Go to the GitHub Release page to download the corresponding version (e.g., Windows MSI), double-click to install, and follow the prompts.

Step 2: Install Claude Code

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

Verify:

`1`	`claude --version`

Launch Claude Code once and then close it
Find the .claude.json file in your user directory
Add the following field (note that a comma must be added at the end of the previous field):

`1`	`"hasCompletedOnboarding": true`

Re-execute claude to start, and choose to trust the current folder

⚠️ Common Error

If you forget to add a comma at the end of the previous field, it will cause a JSON parsing error and Claude Code will fail to start.

Step 3: Connect DeepSeek

3.1 Get API Key

Open DeepSeek Open Platform, register and log in
Ensure your account has a balance
Click API Keys on the right → Create API Key → Copy and save (cannot be viewed again after closing)

🚨 Key Security

Do not share your key with others, as it will consume your balance.

3.2 Configure CC-Switch

Open CC-Switch, click the + button in the upper right corner
Select DeepSeek as the model preset
Enter the API Key
Change the model name uniformly to: deepseek-v4-pro[1m] (context 1M, Claude Code uses 128K by default)
Click Add

3.3 Verify the Model

In the Claude Code dialog box, enter:

/model

You can view the currently available models, or directly ask “What model are you currently using” to confirm successful connection.

Step 4: Hands-on Example

Create a new folder on the desktop
Enter CMD in the address bar and press Enter
Execute claude to start, and choose to trust the current folder
Enter your requirement: Use HTML + JS + CSS to create a Todo app
During execution, it will request tool permissions — select Yes
After completion, ask it to open the page for preview

💡 Tip

You can describe your requirements directly in Chinese — Claude Code supports mixed Chinese and English input.

Command Quick Reference

Operation	Command
Node version check	`node -v`
npm version check	`npm -v`
npm domestic mirror	`npm config set registry https://registry.npmmirror.com/`
Git version check	`git -v`
Install Claude Code	`npm install -g @anthropic-ai/claude-code`
Claude Code version check	`claude --version`
Launch Claude Code	`claude`
Switch model	`/model`

FAQ

Command not found after running claude?

Check if Node.js is installed successfully (node -v) and whether the npm global path is in the system PATH.

Prompts to log in to Anthropic account after starting?

The hasCompletedOnboarding in .claude.json is not configured correctly. Please go back to Step 2 to check.

Model call error / no response?

Check if your DeepSeek account balance is sufficient, and whether the API Key in CC-Switch is entered correctly.

Learn to Create Beautiful Tech Architecture Diagrams with AI

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

✈️ Learn to Create Beautiful Tech Architecture Diagrams with AI

👋 This guide is written for complete beginners who have never drawn an architecture diagram before. You don’t need design skills, you don’t need to write code — just know how to chat with AI.

What is a Tech Architecture Diagram and Why Should I Draw One?

Simply put, a tech architecture diagram helps you “draw out” the system in your head.

For example, if you’re building an app: what functional modules does it have? How do users interact with it? How does data flow? Drawing these relationships as a diagram is an architecture diagram.

The benefits are real:

✅ Clarify your own thinking — the process of drawing helps you organize your system design
✅ Communicate with coworkers effortlessly — a picture is worth a thousand words
✅ Impress in presentations — bosses and clients instantly understand how great your solution is
✅ AI draws for you, saving time and effort — with AI, you can get a decent diagram in minutes

🤔 Which Method Should a Beginner Choose? (Read This First)

Your Situation	Recommended Method	Difficulty
Just want the fastest way to get a good-looking image, no changes later	Method 1 (AI generates image directly)	⭐
Willing to take one more step for easier future edits	Method 2 (Mermaid.js code generation)	⭐⭐
Creating formal docs that need repeated edits and consistent style	Method 3 (Excalidraw local drawing)	⭐⭐⭐

💡 Beginner tip: Try Method 1 first to get a feel, then try Method 2. Save Method 3 for when you need to create formal documents.

Method 1: Let AI Draw a Picture for You (Simplest, Fastest)

⏱ Time: 2-3 minutes 🛠 Tool: Gemini 3.1 Pro (by Google, free)

How It Works in One Sentence

Ask your AI (like Gemini) to write a “visual description prompt” first, then feed that prompt to the AI’s image generation feature, and the AI draws the picture for you.

Step-by-Step Guide

Step 1: Ask AI to Write a “Visual Description Prompt”

Open Gemini and enter the following (copy and replace with your content):

Please write a prompt for generating a technical architecture diagram.
I want to draw an architecture diagram for [your system name, e.g., e-commerce website],
with the following modules: user interface, product management, order system, payment system, admin panel.
The data flow is: user places an order → order system calls payment → payment completion notifies product management to update inventory.
Please provide a detailed prompt in English suitable for text-to-image models. The style should be professional, clean, and visually appealing.

The AI will return a detailed English description.

Step 2: Feed the Prompt to AI for Image Generation

In Gemini (or other AI with image generation), select the image generation feature (like Gemini’s built-in Banana 2.0 model), paste the prompt from the previous step, and click generate.

Step 3: Done 🎉

The AI will output an image. If you’re not satisfied, regenerate until you’re happy.

Pros and Cons

✅ Pros	❌ Cons
Fastest — done in minutes	Hard to modify — system changes require full regeneration
Great visual quality, rich colors	Results can be inconsistent
No extra tools needed	Poor prompts lead to poor results

📌 Beginner Tips

Be detailed in your prompt — the more specific you are, the better the output. Don’t just say “draw an architecture diagram” — specify the modules and how they connect
Try multiple times — it’s normal to not get a perfect result on the first try
English prompts work better — most image generation models understand English better

Method 2: Let AI Generate Code, Then Render It into a Diagram (Recommended for Beginners)

⏱ Time: 3-5 minutes 🛠 Tool: Any AI (ChatGPT, Claude, Gemini) + Mermaid.js

How It Works in One Sentence

A flowchart is essentially code (Mermaid.js syntax). You ask AI to write this code, then use a free online tool to render it as an image. Want to change the diagram? Ask AI to modify the code and re-render.

Step-by-Step Guide

Step 1: Ask AI to Generate Mermaid Code

Open your preferred AI (ChatGPT, Claude, Gemini) and enter (copy and replace with your content):

Please use Mermaid syntax to draw an architecture diagram for an e-commerce system.
The system includes: user interface, product management, order system, payment system, admin panel.
Data flow: user places order → order system calls payment → payment completion notifies product management to update inventory.
Output pure Mermaid code using graph TD format.

The AI will return something like:

graph TD
    A[User Interface] --> B[Order System]
    B --> C[Payment System]
    B --> D[Product Management]
    C --> E[Payment Complete]
    E --> D

Step 2: Render the Code as an Image

Open this free website: mermaid.live

Paste the AI-generated code into the left editor panel
The right panel will instantly display the flowchart
Click the “Export” button in the top-right corner and choose PNG or SVG format (SVG is a vector format — it stays sharp at any size, great for formal documents)

Step 3: Want to Modify It? Ask AI to Change the Code

Paste the old code back to the AI and tell it what you want to change:

`1`	`Modify the code above to add a "Login Verification" module between "User Interface" and "Order System".`

After modification, go back to mermaid.live to paste and export.

Pros and Cons

✅ Pros	❌ Cons
Good image quality, professional look	Complex diagrams are still hard to modify later
Easier to modify than Method 1 — change code, re-render	Major architecture changes essentially require regeneration
No software installation needed — works in a browser

📌 Beginner Tips

Mermaid has fixed syntax — when asking AI, clearly say “use Mermaid syntax”
mermaid.live is a gem — paste and preview instantly, completely free, no account needed
Export as SVG for best results — vector format stays sharp at any size
Save your code — for future modifications, just send the old code to AI

Method 3: Let AI Generate Editable Architecture Diagrams (For Formal Documents)

⏱ Time: 10-15 minutes (first setup takes a bit longer) 🛠 Tools: An AI coding tool + Obsidian + a “Drawing Instruction Pack”

How It Works in One Sentence

This is the most professional method, but requires some initial setup. Once configured, you tell AI what to draw, and AI generates a draggable, editable architecture diagram file that you open in Obsidian — adjust anything you don’t like manually. Methods 1 and 2 produce “static” images; this method produces “living” ones.

🤔 First, Understand: What is a “Drawing Instruction Pack” (Skills)?

Skills are a set of “instruction manuals” that tell AI how to draw diagrams for you.

Without it: You say “draw an architecture diagram” — AI can only give you a text description
With it: AI knows how to generate an editable architecture diagram file

Think of it as installing a “diagram plugin” for your AI.

This instruction pack is called axton-obsidian-visual-skills — a free open-source project by Axton. It includes 3 drawing abilities:

Drawing Method	Generated File	Best For	Visual Style
Excalidraw	`.excalidraw` file	Flowcharts, mind maps, architecture diagrams	✏️ Hand-drawn style (like a whiteboard)
Mermaid	Text rules	Flowcharts, sequence diagrams, comparison charts	🎯 Professional business style
Canvas	`.canvas` file	Mind maps, knowledge organization	🎨 Colorful cards

💡 You can also use Draw.io — Draw.io is another free drawing tool with its own instruction pack. This guide uses Excalidraw as an example.

🔧 Prerequisite Installation (One-Time)

💡 Where Should This Instruction Pack Go?

AI tools look for these instruction files in a fixed location on your computer. Recommended location:

C:\Users\yourusername\.claude\skills\

🤔 What’s this path?

C:\Users\yourusername\ ← Your “user folder” — where software stores config files by default

\.claude\ ← Configuration folder created by Claude Code

skills\ ← Where drawing instructions are stored

Don’t know your username? Open File Explorer, type %USERPROFILE% in the address bar and press Enter — that’s the folder.

🤔 Why on C drive? Because your user folder is on C by default. This makes the instruction pack available to all projects on this machine.

This location works for both OpenCode and Claude Code — install once, use with both tools.

Other tools may use different locations, but beginners can just use the path above.

Installation Method 1: Let AI Install It for You (Recommended, Easiest)

Whether you use OpenCode, Claude Code, or Cursor, just say:

1
2
3

Help me download axtonliu/axton-obsidian-visual-skills from GitHub,
unzip it, and put the excalidraw-diagram, mermaid-visualizer, and obsidian-canvas-creator
folders into C:\Users\yourusername\.claude\skills\ directory.

AI will handle downloading, unzipping, and copying. Restart your tool when done.

💡 Replace “yourusername” with your actual username.

Installation Method 2: Manual Download

If your AI doesn’t support file operations:

Open the axton-obsidian-visual-skills download page
Click the green Code button → Download ZIP
Unzip the file — you’ll see 3 folders
Open your C:\Users\yourusername\.claude\ folder (create a skills folder if it doesn’t exist)

Drag all 3 folders in

Final structure:

C:\Users\yourusername\.claude\skills\
   ├── excalidraw-diagram\
   │     └── SKILL.md
   ├── mermaid-visualizer\
   │     └── SKILL.md
   └── obsidian-canvas-creator\
         └── SKILL.md

Installation Method 3: Claude Code Quick Install

If you use Claude Code (only works with it), type in the chat:

1
2

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

Restart Claude Code after installation. Not supported by OpenCode or Cursor.

You’ll Also Need:

Software	Purpose	Cost
OpenCode / Claude Code / Cursor	Runs AI to generate diagram files	Free tiers available
Obsidian	View and manually adjust diagrams	Free
Obsidian Excalidraw Plugin	Edit Excalidraw files in Obsidian	Free (search “Excalidraw” in the plugin marketplace)

🖐️ Step-by-Step Guide

Step 1: Install Skills, Tell AI What to Draw

After installing Skills, type directly in OpenCode, Claude Code, or Cursor:

For Excalidraw hand-drawn style architecture diagram:

Use Excalidraw to draw an e-commerce system architecture diagram, including:
user interface, product management, order system, payment system, admin panel.
User places order → order system calls payment → payment completion updates inventory.
Use Chinese labels.

AI will automatically generate a .excalidraw file in the current directory.

🔍 Can’t find the file? Check the AI’s output — it usually tells you the save path.

For Mermaid business-style flowchart:

1
2

Convert this flow into a Mermaid diagram:
User visits homepage → browses products → adds to cart → submits order → pays online → completes transaction

AI will generate Mermaid code — copy it to mermaid.live to render.

For Canvas mind map:

1
2

Organize this article into an Obsidian Canvas mind map:
[paste your content]

AI will generate a .canvas file — open with Obsidian to see a colorful card layout.

Step 2: Manual Adjustments in Obsidian

Open Obsidian and drag the generated file in
For Excalidraw files (.excalidraw or .md), double-click to enter edit mode
Freely drag boxes, adjust arrows, modify text, change colors
Drag a new box to add a module, select and press Delete to remove

💡 This is the key advantage — you have a “living” architecture diagram.

Step 3 (Optional): Change Style with AI

After adjusting content and layout, screenshot it and send to Gemini (or other AI) with a reference image:

`1`	`Help me convert Image 1 to a hand-drawn style similar to Image 2, adding appropriate illustrations to help users understand`

(Prompt 1: Major changes — content layout may also be adjusted)

`1`	`Convert to a hand-drawn style similar to Image 2`

(Prompt 2: Minor changes — only colors and style, content layout stays the same)

🔍 What Diagrams Can Excalidraw Skills Draw?

Diagram Type	Best For
Flowchart	Business processes, operation steps, task sequences
Mind Map	Concept expansion, topic classification, brainstorming
Hierarchy Diagram	Organization structure, system layers, directory structure
Relationship Diagram	Dependencies, influence relationships, element interactions
Comparison Chart	Solution comparison, option analysis, before/after
Timeline	Event evolution, project milestones, version iterations
Matrix	2D classification, priority matrix, capability positioning
Free Canvas	Scattered ideas, initial drafts, free-form notes

⚠️ Common Issues & Solutions

Q: Chinese text doesn’t have a hand-drawn look? A: Excalidraw’s hand-drawn font (Excalifont) supports English by default; Chinese fonts need online loading. If Chinese shows as regular font:

Ensure access to Excalidraw.com (needs internet)
Or download Chinese font files from the Excalidraw official font library
Place them in your Obsidian vault under Excalidraw/CJK Fonts
Enable “Load Chinese fonts at startup” in Excalidraw plugin settings and restart Obsidian

Q: The generated diagram looks messy? A: That’s normal — AI-generated layouts aren’t always perfect. Just drag and adjust in Obsidian — that’s the biggest advantage of Method 3.

Q: Do I have to use Claude Code? A: No. These Skills work on OpenCode, Claude Code, and Cursor. OpenCode is compatible with Claude Code’s Skills format.

Pros and Cons

✅ Pros	❌ Cons
Edit anything — drag to adjust	First-time environment setup takes time
Not dependent on prompt quality — content can be manually refined	Longer workflow, more steps
Create a set of consistently styled document diagrams	Occasional text encoding or alignment issues
Works well with Obsidian for knowledge management
One Skills install gives three drawing methods

📌 Beginner Tips

Try Methods 1 and 2 first, then move to Method 3 when you’re comfortable
Skills installation is the key step — once installed, AI knows how to generate editable files
Excalidraw defaults to hand-drawn style, giving a亲切, approachable look
Obsidian’s Excalidraw plugin offers the best viewing and editing experience
Method 3’s greatest value is editability — once set up, future changes are just drag-and-drop
Check out the demo video on GitHub before deciding

🔧 Tools Summary

Tool	Purpose	Cost	Difficulty
Gemini	Chat + text-to-image generation	Free	Low
ChatGPT	Chat + text-to-image generation	Paid/Free	Low
OpenCode	AI coding tool, auto-loads `~/.claude/skills/`, supports parallel execution	Free	Medium
Claude Code	AI coding tool, supports Skills	API usage pricing	Medium
Cursor	AI coding tool	Free tier sufficient	Medium
mermaid.live	Convert Mermaid code to images	Free	Low
Excalidraw	Editable diagram tool	Free & open source	Low
Obsidian	Note-taking + Excalidraw plugin for editable diagrams	Free	Medium
axton-obsidian-visual-skills	AI drawing instruction pack (Excalidraw / Mermaid / Canvas)	Free & open source	Medium

🎯 Beginner Quick Start Roadmap

Day 1 → Try Method 1: Generate images with Gemini (just try it)
         ↓
Day 2 → Try Method 2: Generate flowcharts with Mermaid.js
         (Learn the "change code = change diagram" approach)
         ↓
Day 3 → Use Method 2 diagrams in your documents
         ↓
When needed → Explore Method 3: Install Skills + Obsidian + Excalidraw plugin
(No rush — Methods 1 and 2 are already sufficient)

💬 FAQ

Q: Are all these tools free? A: Gemini and mermaid.live are completely free. ChatGPT and Claude have free tiers — you only pay after using them up.

Q: Can I use generated images commercially? A: Yes, the architecture diagram is your own design — AI is just a tool to draw it.

Q: I’m a product manager/operations person, not a developer — can I still draw? A: Absolutely. Method 1 only requires typing, Method 2 only requires copy-pasting — no coding needed.

Q: Are there copyright issues with generated images? A: The copyright of tool-generated images belongs to you.

Q: Do Mac and Windows both work? A: All tools mentioned have web versions, so the OS doesn’t matter.

Q: What exactly is “axton-obsidian-visual-skills” in Method 3, do I have to install it? A: It’s an open-source AI drawing “instruction pack.” You can draw without it, but with it installed, AI can directly generate editable architecture diagram files instead of static images. If you only need occasional diagrams, Methods 1 and 2 are sufficient. If you need frequent edits and formal documents, highly recommended.

Q: What’s the difference between the 3 drawing methods (Excalidraw / Mermaid / Canvas) in Method 3? A: Simply put — Excalidraw is like a hand-drawn whiteboard, best for architecture diagrams; Mermaid has a professional business style, great for formal docs; Canvas is a colorful mind map tool for organizing ideas. Choose based on what you need.

Q: Does Method 3 require Claude Code? Can I use ChatGPT? A: These Skills are designed for AI coding tools that can manipulate local files — OpenCode, Claude Code, Cursor all work. ChatGPT’s web version can’t handle local files, so it won’t work.

Q: Where should the installed Skills be? How do I check? A: They go in ~/.claude/skills/. Check that directory — it should have excalidraw-diagram, mermaid-visualizer, and obsidian-canvas-creator folders. Restart your AI tool and it should recognize them.

📝 Final words: The most important thing about drawing architecture diagrams is clarifying what you want to express. AI is just a tool to turn your ideas into images. Start with the simplest Method 1 — the first step is the most important!

Hugo + Stack + GitHub Pages Blog Setup Guide

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

Hugo + Stack + GitHub Pages Blog Setup Guide

A complete guide to building a personal blog with Hugo + Stack theme and deploying it to GitHub Pages.

This guide covers both new Stack (v4.x, split .toml config format) and legacy (v3.x, single hugo.yaml) configuration differences, with annotations where key differences exist.

Environment Setup

Install Git

Go to the Git website to download and install: https://git-scm.com/downloads
Use all default options during installation

Install Hugo (Extended Version)

Go to Hugo GitHub Releases: https://github.com/gohugoio/hugo/releases
Choose the extended version (marked with extended) — the Stack theme requires extended SCSS compilation support
Windows users: download hugo_extended_xxx_windows-amd64.zip and extract hugo.exe

This guide was written using Hugo v0.161.1 and Stack theme v4.0.2.

GitHub Account

Register a GitHub account: https://github.com
It’s recommended to enable two-factor authentication (2FA) — you can install the Authenticator 2FA Client plugin in Edge

Create a Hugo Site

Initialize the Project

Open a terminal in the directory where hugo.exe is located (type cmd or powershell in the address bar) and run:

# Create a new site
hugo new site myblog

# Enter the site directory
cd myblog

Generated file structure:

myblog/
├── archetypes/    # Article templates
├── assets/        # Static assets (images, CSS, JS)
├── content/       # Blog content (articles)
├── data/          # Data files
├── i18n/          # Multilingual support
├── layouts/       # Layout templates
├── public/        # Build output (generated by hugo command)
├── static/        # Static files (copied directly to public)
├── themes/        # Themes
└── hugo.toml      # Site configuration

Test the Default Site

`1`	`hugo server -D`

Visit http://localhost:1313/ in your browser. The page will be basic (no theme). Press Ctrl + C to stop the server.

Configure the Stack Theme

Download the Theme

Go to the Stack theme GitHub: https://github.com/CaiJimmy/hugo-theme-stack
Download the latest Release archive (or click “Download ZIP”)
Extract to the site’s themes/ directory

1
2

myblog/themes/
└── hugo-theme-stack-4.0.2/   # Folder with version number

Configure Theme Files — Critical Step

This is the step where errors are most likely to occur. The new Stack (v4.x) and legacy (v3.x) have completely different file structures:

Comparison	Legacy Stack (v3.x)	New Stack (v4.x)
Example site folder name	`exampleSite/`	`demo/`
Config files	Single `hugo.yaml`	Multiple `.toml` files in `config/_default/`
Theme reference	`theme: hugo-theme-stack`	`[[module.imports]]` (Hugo Modules)

New Version (v4.x) Steps:

Step 1: Copy Configuration Files

# Create config/_default directory
mkdir -p config/_default

# Copy all config files from demo
cp themes/hugo-theme-stack-4.0.2/demo/config/_default/*.toml config/_default/

After copying, config/_default/ contains 6 config files:

File	Purpose
`hugo.toml`	Base config (baseURL, title, pagination, permalinks, etc.)
`languages.toml`	Multilingual configuration
`markup.toml`	Markdown rendering config (code highlighting, TOC, etc.)
`menu.toml`	Menu config (navigation bar, social links)
`params.toml`	Theme parameters (sidebar, comments, widgets, etc.)
`related.toml`	Related content recommendation config

Step 2: Change Theme Reference Method

Open config/_default/hugo.toml, find:

1
2

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

Replace with:

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

This traditional method doesn’t require Go environment or Hugo Modules, making it simpler and consistent with this guide.

Step 3: Handle Root hugo.toml Conflict

The root hugo.toml and config/_default/hugo.toml will conflict. Back up or delete the root file:

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

Step 4: Copy Example Content

# Back up existing content (if any)
mv content content_backup

# Copy demo content
cp -r themes/hugo-theme-stack-4.0.2/demo/content .

Step 5: Copy Avatar and Static Assets

1
2

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

Legacy Version (v3.x) Steps:

Enter the theme’s exampleSite/ folder
Copy the content folder and hugo.yaml to the site root
Delete the root hugo.toml (since you now have hugo.yaml)
Confirm that the theme field in hugo.yaml matches the theme folder name (version number removal recommended)

Verify by Starting

`1`	`hugo server -D`

Visit http://localhost:1313/ in your browser. You should now see the complete Stack theme (with sidebar, search, example articles, etc.).

If the page is incomplete, check the terminal for WARN messages (e.g., “Search page not found”, “Archives page not found”). This is usually because example content wasn’t copied.

Custom Configuration

Basic Information

Edit config/_default/hugo.toml (new version) or hugo.yaml (legacy):

1
2

baseURL = "https://your-username.github.io/"
title   = "My Blog"

If your primary language is Chinese, it’s recommended to set:

1
2

defaultContentLanguage = "zh-cn"
hasCJKLanguage         = true   # Set to true for Chinese/Japanese/Korean

Edit config/_default/params.toml (new version) or the params.sidebar section in hugo.yaml:

[sidebar]
    emoji    = "✏️"
    subtitle = "Your personal tagline"
    avatar   = "img/avatar.png"

Place the avatar image at assets/img/avatar.png
Choose emojis from emojiall.com

Edit config/_default/menu.toml (new version) or the menu.social section in hugo.yaml:

[[social]]
    identifier = "github"
    name       = "GitHub"
    url        = "https://github.com/your-username"
    params.icon = "brand-github"

Icon names reference: Tabler Icons (use brand-xxx format).

Comment System

Stack supports multiple comment systems. Here’s an example using utterances (based on GitHub Issues, no extra registration needed):

[comments]
    enabled  = true
    provider = "utterances"

    [comments.utterances]
        repo      = "your-username/your-username.github.io"
        issueTerm = "pathname"
        label     = ""

For more comment system configurations, see the theme documentation: https://stack.jimmycai.com/config/comments

1
2

[footer]
    since = 2026

Creating Articles

Article Structure

The Stack theme recommends each article in its own folder with index.md and image assets:

`1`	`hugo new content post/my-first-article/index.md`

Generated directory structure:

1
2
3

content/post/my-first-article/
├── index.md      # Article content
└── image.jpg     # Article image (optional)

Article Front Matter Example

---
title: My First Article
date: 2026-05-12
description: Article summary description
tags:
  - Hugo
  - Blog
categories:
  - Tutorial
image: image.jpg   # Article cover image (optional)
---

Deploy to GitHub Pages

Create a GitHub Repository

Log in to GitHub, click New repository
Repository name: your-username.github.io (must match exactly)
Select Public (GitHub Pages free tier requires public)
Do not check “Add a README file”

Manual Deployment

# 1. Build the static website (output to public/)
hugo -D

# 2. Enter the public directory
cd public

# 3. Initialize Git and push
git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/your-username/your-username.github.io.git
git push -u origin main

After pushing successfully, visit https://your-username.github.io/ to see your blog (the first time may take 1-2 minutes).

Automatic Deployment (GitHub Actions)

Manually building and pushing every time is tedious. Use GitHub Actions to automatically build and deploy when you push code.

Step 1: Create a Source Repository

In addition to the username.github.io deployment repository, create a source repository (e.g., myblog) and push the entire Hugo project to it:

# In the site root directory (not inside public/)
git init
git add .
git commit -m "init hugo site"
git branch -M main
git remote add origin https://github.com/your-username/myblog.git
git push -u origin main

Step 2: Create GitHub Actions Workflow

Create .github/workflows/deploy.yml in the site root:

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: your-username/your-username.github.io
          publish_branch: main
          publish_dir: ./public

Step 3: Configure GitHub Token

Go to GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)
Generate a new Token with repo and workflow permissions
Copy the generated Token
Go to your source repository → Settings → Secrets and variables → Actions → New repository secret
Name: PERSONAL_TOKEN, Value: paste the Token

From now on, every git push to the source repository’s main branch will trigger GitHub Actions to automatically build and deploy to username.github.io.

Tip: Enable Automatic lastmod Add the following to config/_default/hugo.toml (new version) or hugo.yaml (legacy):
1
2
3
enableGitInfo = true
[frontmatter]
  lastmod = [":git", ":fileModTime"]
This will automatically display the Git commit time as the last modified time for articles. This requires fetch-depth: 0 in the GitHub Actions checkout step (already included in the configuration above).

FAQ

Q1: Page is blank/incomplete after starting?

Check whether you copied the demo’s content folder. Missing example pages (search, archives, etc.) will cause the theme to display incompletely.

Q2: `hugo server` throws “Theme not found” error?

New version: Check that theme = "xxx" in config/_default/hugo.toml matches the folder name under themes/
Legacy: Check the theme field in hugo.yaml

Q3: Root `hugo.toml` conflicts with `config/_default/hugo.toml`?

Delete or back up the root hugo.toml. Hugo will prioritize config files under config/_default/.

Q4: Push to GitHub fails?

This may be a network issue. Try removing the proxy:

1
2

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

Q5: What is the new `[[module.imports]]`?

The new Stack uses Hugo Modules (Go modules) to import the theme by default, which requires a Go environment. If you don’t want to deal with Go, simply switch to the traditional theme = "theme-folder-name" method.

Q6: Blog styles are broken after deployment?

Check that baseURL is correctly set to https://your-username.github.io/ (note the trailing /). An incorrect baseURL will cause CSS/JS resources to fail to load.

References

MCP Beginner's Guide: The Universal AI Plug Anyone Can Understand

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

Overview

Have you ever thought: ChatGPT, Claude and other AIs are smart, but they can only chat in a dialog box — they can’t help you check your calendar, manage files, or operate databases because they’re “locked in a cage” with no access to the outside world.

MCP (Model Context Protocol) is here to break down that wall.

Simply put, MCP is an open standard protocol that enables AI applications to connect to external systems — files, databases, APIs, various tools — just like giving AI a universal plug (USB-C port). Plug in anything and it works.

One sentence to understand MCP: It’s the “USB-C port” for the AI world — a unified standard, plug and play.

Why Use MCP?

Before MCP

Before MCP existed, if you wanted to connect AI to external tools (like checking the weather, reading calendars, operating databases), each AI application and each tool required custom integration development.

This was like the early days of phone charging ports — one for Android, one for Apple, one for Type-C. Every time you switched devices, you needed a new cable.

The problems were obvious:

High development costs: Every integration started from scratch
Not universal: Tools written for Claude couldn’t be used by ChatGPT
Difficult to maintain: When a tool was upgraded, all integrations had to be changed

After MCP

MCP defines a unified standard:

Tool providers develop an MCP Server following the MCP standard
AI applications act as MCP Clients to connect to it
As long as both sides follow the MCP protocol, plug and play, no redundant development

This is like how USB-C unified charging ports — one cable to rule them all.

What Can MCP Do? Use Cases at a Glance

1. Personal AI Assistant

Let AI help you manage your daily life:

Connect Google Calendar to check schedules and create meeting reminders
Connect Notion to organize notes and manage to-do lists
Connect Gmail to read and reply to emails
Connect Slack to summarize chat history

Example: You tell the AI “check what meetings I have tomorrow and summarize last week’s project progress notes” — the AI can automatically check your calendar, go through Notion, and give you a summary.

2. Programming & Development

Let AI coding assistants actually “get their hands dirty”:

Connect to the local file system via MCP to read and write project files
Connect to databases to directly query and modify data
Connect to GitHub to automatically create Issues and submit PRs
Connect to Figma to generate code directly from design mockups

Example: Claude Code connects to Figma via MCP, obtains the design mockup, and generates a complete web application.

3. Enterprise Applications

Make a big impact in the corporate world:

Connect to multiple databases so employees can query business data in natural language
Connect to internal systems (CRM, ERP) for AI to automatically compile reports
Connect to knowledge bases so AI can answer questions based on company documentation

4. Creative & Design

Connect to Blender to let AI generate 3D models
Connect to 3D printers to print designs directly
Connect to video editing tools to automate the editing workflow

MCP Core Architecture

MCP’s architecture is very simple, with only three roles:

┌──────────────┐         ┌──────────────┐         ┌──────────────┐
│  AI App      │ ◄─────► │  MCP Protocol │ ◄─────► │ MCP Server   │
│ (MCP Client) │         │ (Transport)   │         │ (External    │
└──────────────┘         └──────────────┘         │  Tool)       │
                                                   └──────────────┘

Role	Description	Analogy
MCP Client	AI applications (Claude, ChatGPT, Cursor)	Phone
MCP Server	Services providing specific capabilities (weather, file management)	Charger
MCP Protocol	The “language” both sides communicate in	USB-C Standard

What Can an MCP Server Provide?

An MCP Server can expose three types of capabilities to AI:

Type	Description	Examples
Tools	Functions/operations AI can call	Search the web, send emails, query databases
Resources	Data AI can read	File contents, database records, API responses
Prompts	Preset prompt templates	Code review templates, translation templates

How to Use MCP?

Method 1: Use Existing MCP Servers (Recommended for Beginners)

This is the simplest approach — others have already written the MCP Server, you just need to “install and connect”.

Step 1: Find the MCP Server You Need

The MCP ecosystem already has a large number of Servers available. Common sources:

Official repository: github.com/modelcontextprotocol/servers
MCP marketplaces: mcp.so, smithery.ai
GitHub search: Search for mcp-server

Popular MCP Servers:

MCP Server	Function
`filesystem`	Read and write local files
`github`	Operate GitHub (Issues, PRs)
`fetch`	Fetch web page content
`sqlite`	Operate SQLite databases
`notion`	Operate Notion notes
`memory`	Persistent memory storage

Step 2: Configure MCP Server in Your AI Application

Using Claude Desktop as an example, find the configuration file:

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

Add MCP Server configuration (using filesystem as an example):

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/your/work/directory/path"
      ]
    }
  }
}

After saving, restart Claude Desktop, and the AI will have file management capabilities.

Step 3: Start Using

After restarting, simply ask the AI to use these tools in conversation:

“Create a notes folder in my work directory”
“Read the README.md content and give me a summary”
“Search for recent project Issues”

The AI will automatically call the corresponding MCP Server to complete the task.

Method 2: Use MCP in Cursor / VS Code

If you use Cursor or VS Code for programming development, the configuration is similar.

Create .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code) in your project root:

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

After configuration, you can use these tools in AI conversations.

Method 3: Develop Your Own MCP Server (Advanced)

If you want to connect AI to your own systems (like a company’s internal API), you can write your own MCP Server.

MCP supports multiple programming languages with official SDKs:

Language	SDK
TypeScript	`@modelcontextprotocol/sdk`
Python	`mcp` (PyPI)
Java / Kotlin	`io.modelcontextprotocol`

Minimal example (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"
});

// Define a "check weather" tool
server.tool(
  "get_weather",
  { city: z.string().describe("City name") },
  async ({ city }) => {
    // Your business logic here
    const weather = `${city} is sunny today, 25°C`;
    return {
      content: [{ type: "text", text: weather }]
    };
  }
);

// Start the service
const transport = new StdioServerTransport();
await server.connect(transport);

Once written, configure it in your AI application and start using it.

Which AI Applications Support MCP?

MCP has become an industry standard, with mainstream AI applications offering support:

AI Application	Support Status
Claude Desktop / Claude Code	Native support
ChatGPT	Supported
Cursor	Supported
VS Code (Copilot)	Supported
Windsurf	Supported
OpenCode	Supported

Configure once, use everywhere — an MCP Server configured in Claude will work in other applications too.

FAQ

Q: What’s the difference between MCP and APIs?

An API is a “private protocol” between two parties, with each API having different calling methods. MCP is a unified standard — all tools that follow MCP can be called by AI in the same way. Think of MCP as “a standard API layer specifically for AI.”

Q: Do I need programming skills to use MCP?

No! If you’re just using existing MCP Servers, you only need to know how to copy and paste configuration files. Programming is only needed when developing your own MCP Server.

Q: Is MCP secure?

MCP Servers run locally by default, and data is not uploaded to the cloud. However, when using third-party MCP Servers, it’s recommended to check their source code and permissions to ensure security.

Q: What environment does an MCP Server need to run?

Most MCP Servers run on Node.js, so you need to install Node.js first. Python-based Servers require a Python environment.

Summary

Question	Answer
What is MCP?	A unified standard protocol for AI to connect to external tools
Why use it?	To let AI actually “do work” instead of just chatting
Who can use it?	Everyone — beginners use existing Servers, developers can write their own
How to use it?	Find an MCP Server → Configure it in your AI app → Restart and use

The essence of MCP is: creating a unified “plug standard” for the AI world, allowing tools and AI to connect freely.

Further reading:

MCP Official Documentation

MCP Server Repository

MCP Marketplace

Beginner Guide on Yanmu

C Drive Full? Expand It Using Other Drives

📦 Preparation

① Download WePE Toolbox

② Install to System

③ Reboot into Boot Menu

④ Enter PE Environment

🛠️ Resize

Step 1 · Check Disk Layout

Step 2 · Choose the Drive to Shrink

Step 3 · Adjust Partition

Step 4 · Shrink the Drive

Step 5 · Merge into C Drive

Step 6 · Submit Task

Step 7 · Wait for Execution

Step 8 · Done 🎉

🚀 Reboot & Cleanup

📌 Tips

OpenCode Beginner to Advanced: A Complete Guide to Parallel Scheduling and Usage Tips

📋 Table of Contents

📌 Key Points Summary

1. Session Parallelism: Let AI Handle Multiple Tasks Simultaneously

Basic Operations

Real-World Scenario

Traditional Approach

OpenCode Approach

Notes

2. Ultra Work: One-Click AI Programming Team

Trigger Method

How It Works

When to Use?

Actual Results

3. @ Designate Agent: Let Experts Do What They Do Best

Agent Capability Table

Usage Examples

Switch Main Agent

4. Timeline Time Machine: Experiment Freely, Rollback Anytime

Basic Usage

Real-World Scenario

Tips

5. Ralph Loop: Let AI Push Through to the End

Launch Method

Use Cases

Difference from Ultra Work

6. Daily Speed Tips

1. Use /compact to Save Context

2. Use /init to Get AI Up to Speed on New Projects

3. Share Your Programming Process

4. View Available Models

5. Quick Code Paste (VS Code Plugin)

7. Recommended Workflow for Beginners

One-Line Summary

8. A Real-World Case Study

First Attempt

Correction

Install Claude Code and Connect DeepSeek (Beginner-Friendly Guide)

Overview

Who Is This Tutorial For?

What Are We Installing? Why Do We Need These?

Install Node.js

Download Node.js

Install Node.js

Verify Node.js Is Installed Correctly

How to Configure Environment Variables

Configure npm Domestic Mirror (Strongly Recommended)

Install Claude Code

Install Claude Code via npm

Verify Installation

First Launch (Skip Login)

Install CC-Switch (Model Switching Tool)

Download CC-Switch

Install CC-Switch

Get a DeepSeek API Key

Register a DeepSeek Account

Add Funds to Your Account

Create an API Key

Configure CC-Switch to Connect DeepSeek

Open CC-Switch

Add a DeepSeek Configuration

Switch to DeepSeek

1. Use `/compact` to Save Context

2. Use `/init` to Get AI Up to Speed on New Projects