<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>IMX-博客</title><link>https://blog.cbzmx.com/</link><description>Recent content on IMX-博客</description><generator>Hugo</generator><language>zh-CN</language><lastBuildDate>Wed, 21 Oct 2026 15:58:56 +0800</lastBuildDate><atom:link href="https://blog.cbzmx.com/index.xml" rel="self" type="application/rss+xml"/><item><title>服务器基础安全配置</title><link>https://blog.cbzmx.com/posts/fu-wu-qi-ji-chu-an-quan-pei-zhi/</link><pubDate>Wed, 21 Oct 2026 15:58:56 +0800</pubDate><guid>https://blog.cbzmx.com/posts/fu-wu-qi-ji-chu-an-quan-pei-zhi/</guid><description>&lt;h2 id="前言"&gt;前言&lt;/h2&gt;&#10;&lt;p&gt;新买的 VPS 能通过 SSH 登录，并不代表基础安全已经配置完毕。本文以 &lt;strong&gt;Debian 13&lt;/strong&gt; 为例，从本机生成 SSH 密钥开始，完成普通管理账号、SSH 登录限制、防火墙和自动安全更新的配置。&lt;/p&gt;&#10;&lt;p&gt;本机可以使用 &lt;strong&gt;macOS 或 Windows&lt;/strong&gt;，SSH 客户端不限品牌。文中的命令行示例使用标准 OpenSSH；使用图形客户端时，按对应字段填写即可。&lt;/p&gt;&#10;&lt;p&gt;本文适合刚安装系统、尚未部署业务的新服务器。已经运行网站、容器、VPN 或其他服务的机器，需要先核对现有账号、端口和防火墙规则，再决定如何合并配置。&lt;/p&gt;&#10;&lt;h2 id="一先看懂操作位置和自定义参数"&gt;一、先看懂操作位置和自定义参数&lt;/h2&gt;&#10;&lt;h3 id="1-哪些命令在本机执行哪些在服务器执行"&gt;1. 哪些命令在本机执行，哪些在服务器执行&lt;/h3&gt;&#10;&lt;p&gt;本文使用三种标记：&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;标记&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;执行位置&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;使用的环境&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;strong&gt;本机 · macOS&lt;/strong&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;自己的 Mac&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;终端中的 Bash 或 Zsh&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;strong&gt;本机 · Windows&lt;/strong&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;自己的 Windows 电脑&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;PowerShell，已安装 OpenSSH 客户端&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;strong&gt;服务器&lt;/strong&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;已连接 VPS 的 SSH 窗口&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Debian 的 Bash&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;Mac 和 Windows 的本机步骤是两条分支，选择自己正在使用的一条。服务器步骤相同。&lt;/p&gt;&#10;&lt;p&gt;建议保留一个窗口用于本机命令，另一个窗口用于连接服务器。执行 &lt;code&gt;ssh&lt;/code&gt; 后，这个窗口就进入了服务器；不要在里面误执行标记为“本机”的命令。新开本机终端时，也要重新设置该终端需要使用的连接和密钥变量。&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;不要把整篇文章一次性粘贴执行。&lt;/strong&gt; 尤其是安装软件、创建用户、输入密码等交互步骤，应逐步执行，核对输出后再继续。遇到报错，先解决当前问题。&lt;/p&gt;&#10;&lt;h3 id="2-可以自定义的内容"&gt;2. 可以自定义的内容&lt;/h3&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;参数或项目&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;本文示例&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;自定义说明&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;服务器地址&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;203.0.113.10&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;替换为自己的公网 IP 或域名。这是文档示例地址，不能直接用于连接&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;初始登录用户&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;root&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;如果商家提供的是可使用 sudo 的普通账号，填写那个账号&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;新管理用户名&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;myadmin&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;可以自定义，例如 &lt;code&gt;imx&lt;/code&gt;、&lt;code&gt;opsuser&lt;/code&gt;。建议以小写英文字母开头，使用字母、数字、下划线或连字符；不要用 &lt;code&gt;root&lt;/code&gt; 或已有系统账号&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;当前 SSH 端口&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;22&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;必须填写服务器&lt;strong&gt;实际正在监听&lt;/strong&gt;的端口；设置变量不会修改服务器的 SSH 监听端口&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;本机私钥文件名&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;vps_ed25519&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;可以改名，也可以使用 &lt;code&gt;.pem&lt;/code&gt; 后缀；后缀不决定文件内容格式&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;密钥备注&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;my-laptop&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;可以自定义，用来区分设备或用途；建议使用简短英文，不要填写密码&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;密钥类型&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ed25519&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;由 &lt;code&gt;-t&lt;/code&gt; 指定，适用于本文环境；其他类型需要同时核对客户端和服务器兼容性，不靠修改文件后缀转换&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;私钥密码派生轮数&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;64&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;由 &lt;code&gt;-a&lt;/code&gt; 指定，可调整；使用 Passphrase 时影响私钥保护的派生开销，数值越大，解锁通常越慢&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;上传到服务器的公钥文件名&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;client-login.pub&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;可以改名，但本机上传和服务器读取时必须一致&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;密钥保护密码&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;创建密钥时输入&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;自行设置，用于保护本机私钥&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;新用户密码&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;创建账号时输入&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;自行设置，后续 sudo 提权时使用&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;自动回滚等待时间&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;10m&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;可以改成 &lt;code&gt;15m&lt;/code&gt; 等，给自己留出重新连接和验证的时间&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;回滚任务名称&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ufw-safety-rollback&lt;/code&gt;、&lt;code&gt;ssh-safety-rollback&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;可以改名，但创建、检查和停止任务时必须使用同一个名称&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;业务端口与协议&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;按实际服务填写&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;部署服务后再放行，注意区分 TCP 和 UDP&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;&lt;code&gt;/etc/ssh/sshd_config&lt;/code&gt;、&lt;code&gt;authorized_keys&lt;/code&gt; 等是本教程使用的标准配置路径或文件名，不是随意替换的占位符。如果镜像修改了默认路径，应先核对实际配置。&lt;/p&gt;</description></item><item><title>Google / Squarespace 域名接入 Cloudflare DNS：完整保姆级教程</title><link>https://blog.cbzmx.com/posts/google-squarespace-yu-ming-jie-ru-cloudflare-dns-wan-zheng-bao-mu-ji-jiao-cheng/</link><pubDate>Wed, 07 Oct 2026 13:47:15 +0800</pubDate><guid>https://blog.cbzmx.com/posts/google-squarespace-yu-ming-jie-ru-cloudflare-dns-wan-zheng-bao-mu-ji-jiao-cheng/</guid><description>&lt;blockquote&gt;&#10;&lt;p&gt;适用场景：&lt;strong&gt;域名继续在原注册商（例如 Google / Squarespace）续费，不转移注册商，只把 DNS 托管到 Cloudflare。&lt;/strong&gt;&lt;/p&gt;&#10;&lt;p&gt;本文面向第一次接触域名、DNS、Nameserver、Cloudflare 的用户，按“先解释，再操作，再验证，再收尾”的顺序编写。&lt;/p&gt;&#10;&lt;/blockquote&gt;&#10;&lt;hr&gt;&#10;&lt;h2 id="隐私说明"&gt;隐私说明&lt;/h2&gt;&#10;&lt;p&gt;本文中的所有账号、邮箱、域名、IP、Nameserver、DNSSEC 参数、密钥标记、摘要等示例均为&lt;strong&gt;虚构或保留测试值&lt;/strong&gt;，不对应真实账户。&lt;/p&gt;&#10;&lt;p&gt;示例：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;域名：aurora-lab.example&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;邮箱：admin@aurora-lab.example&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;个人邮箱：owner.demo42@gmail.com&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;测试 IP：&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;192.0.2.44&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;192.0.2.45&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;198.51.100.44&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;198.51.100.45&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;示例 Cloudflare Nameserver：&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;atlas.ns.cloudflare.example&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;lyra.ns.cloudflare.example&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;.example&lt;/code&gt; 是专门用于文档示例的保留域名后缀。操作时必须以你自己的 Cloudflare / Squarespace 页面显示的实际值为准，&lt;strong&gt;不要照抄本文示例值&lt;/strong&gt;。&lt;/p&gt;&#10;&lt;hr&gt;&#10;&lt;h2 id="一先理解我们到底在做什么"&gt;一、先理解我们到底在做什么&lt;/h2&gt;&#10;&lt;p&gt;这次操作不是“把域名转到 Cloudflare”，而是：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;域名注册 / 续费&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;Google / Squarespace&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; │&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; │ 只修改 Nameserver&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; ▼&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;Cloudflare&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;负责 DNS / CDN / SSL / 安全&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; │&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; ▼&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;网站源站&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;Squarespace / GitHub Pages / Vercel / VPS 等&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;最终分工：&lt;/p&gt;</description></item><item><title>skill和mcp</title><link>https://blog.cbzmx.com/posts/skill-and-mcp/</link><pubDate>Wed, 16 Sep 2026 11:35:27 +0800</pubDate><guid>https://blog.cbzmx.com/posts/skill-and-mcp/</guid><description>&lt;h2 id="什么是skill"&gt;什么是&lt;strong&gt;Skill&lt;/strong&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;strong&gt;Skill&lt;/strong&gt; 理解成给 AI Agent 安装的“可复用专业工作包”&lt;/p&gt;&#10;&lt;p&gt;一个典型 Skill 会把某项工作的 &lt;strong&gt;规则、SOP、参考资料、脚本、模板&lt;/strong&gt; 打包起来，让 Codex等 Agent 遇到对应任务时知道“应该按照什么流程做”&lt;/p&gt;&#10;&lt;p&gt;openai官方的定义：一个独立目录，以 &lt;code&gt;SKILL.md&lt;/code&gt; 为入口，可以附带脚本、references、assets 等资源&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;references&lt;/strong&gt;可以理解为“参考资产/知识库”，比如做漫剧&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-txt" data-lang="txt"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;my-skill/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;├── SKILL.md&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;└── references/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; ├── api-guide.md&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; ├── storyboard-rules.md&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; ├── character-consistency.md&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; └── output-schema.md&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-txt" data-lang="txt"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;处理分镜任务前，读取：&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;[分镜规范](references/storyboard-rules.md)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;涉及角色一致性时，读取：&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;[角色一致性规则](references/character-consistency.md)&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;这样做的优点是，不需要把几万字规则全写进 &lt;code&gt;SKILL.md&lt;/code&gt;&lt;/p&gt;&#10;&lt;p&gt;&lt;strong&gt;assets&lt;/strong&gt;可以理解为“可直接拿来使用的素材或模板”&lt;/p&gt;&#10;&lt;p&gt;它不一定是让 Agent 阅读的，很多时候是 &lt;strong&gt;直接复制、修改、输出或作为程序输入&lt;/strong&gt;，像是一个可以使用的现成模板&lt;/p&gt;&#10;&lt;p&gt;references = 给 AI 看&lt;/p&gt;&#10;&lt;p&gt;assets = 给 AI 拿来用&lt;/p&gt;&#10;&lt;p&gt;一个完整的skill：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-txt" data-lang="txt"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;my-skill/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;├── SKILL.md&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;├── scripts/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ ├── process.py&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ └── check.py&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;├── references/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ ├── workflow.md&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ └── api-guide.md&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;├── assets/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;│ └── template.json&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;└── agents/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; └── openai.yaml&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;解释：&lt;/p&gt;</description></item><item><title>AI 漫剧</title><link>https://blog.cbzmx.com/posts/ai-man-ju/</link><pubDate>Sat, 05 Sep 2026 14:21:01 +0800</pubDate><guid>https://blog.cbzmx.com/posts/ai-man-ju/</guid><description>&lt;h2 id="ai漫剧制作sop"&gt;AI漫剧制作SOP&lt;/h2&gt;&#10;&lt;div class="mermaid" data-mermaid-source&gt;flowchart LR&#10; A[&amp;#34;需求对接&amp;lt;br/&amp;gt;（商务）&amp;#34;] --&amp;gt; B[&amp;#34;剧本拆解&amp;lt;br/&amp;gt;（导演）&amp;#34;]&#10; B --&amp;gt; C[&amp;#34;人员分工&amp;lt;br/&amp;gt;（制片）&amp;#34;]&#10;&#10; C --&amp;gt; D[&amp;#34;设定制作&amp;lt;br/&amp;gt;（主美、生图师）&amp;#34;]&#10; C --&amp;gt; E[&amp;#34;分镜拆分&amp;lt;br/&amp;gt;（生图师）&amp;#34;]&#10; C --&amp;gt; F[&amp;#34;声音素材筹备&amp;lt;br/&amp;gt;（制片、后期）&amp;#34;]&#10;&#10; E --&amp;gt; G[&amp;#34;静帧生成&amp;lt;br/&amp;gt;（生图师）&amp;#34;]&#10; G --&amp;gt; H[&amp;#34;静帧审核定稿&amp;lt;br/&amp;gt;（主美、导演）&amp;#34;]&#10;&#10; H --&amp;gt; I[&amp;#34;视频生成&amp;lt;br/&amp;gt;（生图师）&amp;#34;]&#10; I --&amp;gt; J[&amp;#34;视频审核&amp;lt;br/&amp;gt;（主美一审）&amp;#34;]&#10; J --&amp;gt; K[&amp;#34;视频审核&amp;lt;br/&amp;gt;（导演终审）&amp;#34;]&#10;&#10; K --&amp;gt; L[&amp;#34;影片合成&amp;lt;br/&amp;gt;（后期）&amp;#34;]&#10; L --&amp;gt; M[&amp;#34;成品审核&amp;lt;br/&amp;gt;（导演终审）&amp;#34;]&#10; M --&amp;gt; N[&amp;#34;成品交付&amp;lt;br/&amp;gt;（商务）&amp;#34;]&lt;/div&gt;&#10;&lt;p&gt;阶段说明&lt;/p&gt;&#10;&lt;div class="mermaid" data-mermaid-source&gt;flowchart LR&#10; A[&amp;#34;剧本&amp;lt;br/&amp;gt;创意与结构化&amp;#34;]&#10; B[&amp;#34;分镜&amp;lt;br/&amp;gt;可视化设计&amp;#34;]&#10; C[&amp;#34;生图&amp;lt;br/&amp;gt;静帧画面生成&amp;#34;]&#10; D[&amp;#34;视频&amp;lt;br/&amp;gt;动态化处理&amp;#34;]&#10; E[&amp;#34;合成&amp;lt;br/&amp;gt;声画定稿&amp;#34;]&#10;&#10; A --&amp;gt; B --&amp;gt; C --&amp;gt; D --&amp;gt; E&#10;&#10; classDef step fill:#F4F3FF,stroke:#9C83D9,stroke-width:1.5px,color:#333;&#10; class A,B,C,D,E step;&lt;/div&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;阶段&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;核心输入&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;核心产出&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;1. 剧本&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;小说 / IP&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;结构化分镜脚本：包含场景、景别、人物动作 / 表情、关键台词&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2. 分镜&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;分镜脚本&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;视觉化分镜稿：精准的提示词，指导画面生成&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;3. 生图&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;分镜提示词&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;风格统一的静帧图片：解决角色一致性是关键&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;4. 视频&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;静帧图片&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;动态视频片段：为静态图添加运镜、动态&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;5. 合成&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;视频片段、音频素材&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;成品漫剧：完成剪辑、配音、音效、字幕、调色&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;</description></item><item><title>Hugo Theme IMX 主题配置指南</title><link>https://blog.cbzmx.com/posts/hugo-theme-imx-configuration-guide/</link><pubDate>Tue, 07 Jul 2026 10:00:00 +0800</pubDate><guid>https://blog.cbzmx.com/posts/hugo-theme-imx-configuration-guide/</guid><description>&lt;p&gt;&lt;img&#10; src="https://blog.cbzmx.com/posts/hugo-theme-imx-configuration-guide/images/cover-v2.webp"&#10; alt="以纸艺模块展示 IMX 配置关系的封面"&#10; width="1672"&#10; height="941"&#10; loading="lazy"&#10; decoding="async"&gt;&lt;/p&gt;&#10;&lt;p&gt;IMX 是一个通过 Hugo Module 使用的中文博客主题。它不需要放进 &lt;code&gt;themes/&lt;/code&gt; 目录，也不需要在配置里写 &lt;code&gt;theme = &amp;quot;...&amp;quot;&lt;/code&gt;，站点通过 Go Module 引入主题，然后由 Hugo 在构建时合并主题模板、资源和默认配置。&lt;/p&gt;&#10;&lt;p&gt;这篇文章集中说明 &lt;strong&gt;如何把 IMX 主题配置清楚&lt;/strong&gt;。第一次搭建站点，可先读 &lt;a href="https://blog.cbzmx.com/posts/hugo-imx-theme-tutorial/"&gt;Hugo 与 IMX 入门指南&lt;/a&gt;；准备上线时再读 &lt;a href="https://blog.cbzmx.com/posts/github-pages-deployment-guide/"&gt;GitHub Pages 部署指南&lt;/a&gt;。如果你已经有一个 Hugo 站点，照着本文检查一遍，基本可以把首页、文章列表、关于页、评论、搜索、图片和部署流程都理顺。&lt;/p&gt;&#10;&lt;p&gt;&lt;img&#10; src="https://blog.cbzmx.com/posts/hugo-theme-imx-configuration-guide/images/config-map-v2.svg"&#10; alt="IMX 主题配置地图"&#10; loading="lazy"&#10; decoding="async"&gt;&lt;/p&gt;&#10;&lt;h2 id="一配置文件放在哪里"&gt;一、配置文件放在哪里&lt;/h2&gt;&#10;&lt;p&gt;站点的主配置文件一般是根目录下的 &lt;code&gt;hugo.toml&lt;/code&gt;：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;your-site/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;├── content/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;├── static/&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;├── go.mod&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;├── go.sum&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;└── hugo.toml&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;IMX 主题推荐把主要配置都写在 &lt;code&gt;hugo.toml&lt;/code&gt; 里。除非站点规模很大，否则没有必要一开始就拆成多个配置文件。&lt;/p&gt;&#10;&lt;p&gt;一个可以工作的最小配置如下：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-toml" data-lang="toml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;baseURL&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;https://example.com/&amp;#39;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;defaultContentLanguage&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;zh-cn&amp;#39;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;locale&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;zh-CN&amp;#39;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;title&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;我的博客&amp;#39;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;params&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;description&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;站点描述&amp;#39;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;subtitle&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;首页副标题&amp;#39;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;author&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;你的名字&amp;#39;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;mainSections&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;posts&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;outputs&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;home&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;HTML&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;RSS&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;JSON&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;module&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;[[&lt;/span&gt;&lt;span class="nx"&gt;module&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;imports&lt;/span&gt;&lt;span class="p"&gt;]]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;path&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;github.com/c-x-x/hugo-theme-imx&amp;#39;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;这几项先不要省：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;code&gt;baseURL&lt;/code&gt;：站点最终访问地址，影响 canonical、RSS、Open Graph 图片地址。&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;title&lt;/code&gt;：站点标题，会出现在导航、首页、关于页和网页标题里。&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;[params]&lt;/code&gt;：主题参数区，IMX 的头像、Logo、默认图片、评论、社交链接都在这里配置。&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;[outputs].home&lt;/code&gt;：必须保留 &lt;code&gt;JSON&lt;/code&gt;，站内搜索依赖首页生成的 &lt;code&gt;index.json&lt;/code&gt;。&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;[module.imports]&lt;/code&gt;：主题通过 Hugo Module 引入，不能用传统 &lt;code&gt;theme = &amp;quot;xxx&amp;quot;&lt;/code&gt;。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="二安装与更新主题"&gt;二、安装与更新主题&lt;/h2&gt;&#10;&lt;p&gt;如果站点还没有 &lt;code&gt;go.mod&lt;/code&gt;，先执行：&lt;/p&gt;</description></item><item><title>Hugo 博客搭建与 IMX 主题完全使用指南</title><link>https://blog.cbzmx.com/posts/hugo-imx-theme-tutorial/</link><pubDate>Tue, 07 Jul 2026 10:00:00 +0800</pubDate><guid>https://blog.cbzmx.com/posts/hugo-imx-theme-tutorial/</guid><description>&lt;p&gt;这篇指南带你从空目录走到一个能本地预览的 IMX 博客。完成后，你会知道站点文件放在哪里、怎样写文章，以及修改后该检查什么。已有 Hugo 站点的读者可以直接看 &lt;a href="https://blog.cbzmx.com/posts/hugo-theme-imx-configuration-guide/"&gt;IMX 主题配置指南&lt;/a&gt;；准备上线时再看 &lt;a href="https://blog.cbzmx.com/posts/github-pages-deployment-guide/"&gt;GitHub Pages 部署指南&lt;/a&gt;。&lt;/p&gt;&#10;&lt;p&gt;&lt;img&#10; src="https://blog.cbzmx.com/posts/hugo-imx-theme-tutorial/images/cover-v2.webp"&#10; alt="从纸页延伸为博客页面的 IMX 主题概念图"&#10; width="1672"&#10; height="941"&#10; loading="lazy"&#10; decoding="async"&gt;&lt;/p&gt;&#10;&lt;h2 id="开始前需要什么"&gt;开始前需要什么&lt;/h2&gt;&#10;&lt;p&gt;安装 Git、Go 和 &lt;strong&gt;Hugo Extended&lt;/strong&gt;。IMX 通过 Hugo Module 加载，主题示例站给出的最低要求是 Hugo Extended 0.112.0 与 Go 1.20；新项目建议让本地与 CI 使用经过验证的相同版本。&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;hugo version&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;go version&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;git --version&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;确认 &lt;code&gt;hugo version&lt;/code&gt; 的输出包含 &lt;code&gt;extended&lt;/code&gt;。建站和写作不需要安装 Node.js；主题仓库里的前端测试依赖只用于维护主题。&lt;/p&gt;&#10;&lt;h2 id="1-创建站点并安装主题"&gt;1. 创建站点并安装主题&lt;/h2&gt;&#10;&lt;p&gt;以下以 &lt;code&gt;my-blog&lt;/code&gt; 为目录名，&lt;code&gt;your-name&lt;/code&gt; 为 GitHub 用户名。请替换这两个占位符。&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;hugo new site my-blog&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nb"&gt;cd&lt;/span&gt; my-blog&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;git init&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;hugo mod init github.com/your-name/my-blog&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;在根目录的 &lt;code&gt;hugo.toml&lt;/code&gt; 写入最小配置：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-toml" data-lang="toml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;baseURL&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;https://your-name.github.io/&amp;#39;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;defaultContentLanguage&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;zh-cn&amp;#39;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;locale&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;zh-CN&amp;#39;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;title&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;我的博客&amp;#39;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;params&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;description&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;记录技术与生活&amp;#39;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;subtitle&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;把值得记住的事写下来&amp;#39;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;author&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;你的名字&amp;#39;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;mainSections&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;posts&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;outputs&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;home&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;HTML&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;RSS&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;JSON&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;module&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;module&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;hugoVersion&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;extended&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;min&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;0.112.0&amp;#39;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;[[&lt;/span&gt;&lt;span class="nx"&gt;module&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;imports&lt;/span&gt;&lt;span class="p"&gt;]]&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;path&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;github.com/c-x-x/hugo-theme-imx&amp;#39;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;安装一个明确的主题版本。例如，本站当前使用 &lt;code&gt;v1.5.6&lt;/code&gt;：&lt;/p&gt;</description></item><item><title>Claude Code 完全使用指南：常用命令与功能详解</title><link>https://blog.cbzmx.com/posts/claude-code-tutorial/</link><pubDate>Sat, 13 Jun 2026 22:00:00 +0800</pubDate><guid>https://blog.cbzmx.com/posts/claude-code-tutorial/</guid><description>&lt;h2 id="前言"&gt;前言&lt;/h2&gt;&#10;&lt;p&gt;哈喽&lt;/p&gt;&#10;&lt;p&gt;Claude Code 是 Anthropic 推出的官方命令行工具，让你可以直接在终端中与 Claude AI 交互，进行代码编写、调试、重构等工作。&lt;/p&gt;&#10;&lt;h3 id="为什么使用-claude-code"&gt;为什么使用 Claude Code？&lt;/h3&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;🚀 &lt;strong&gt;终端集成&lt;/strong&gt; - 直接在命令行中使用&lt;/li&gt;&#10;&lt;li&gt;💻 &lt;strong&gt;代码理解&lt;/strong&gt; - 自动读取项目文件&lt;/li&gt;&#10;&lt;li&gt;🔧 &lt;strong&gt;直接操作&lt;/strong&gt; - 可以直接编辑文件、运行命令&lt;/li&gt;&#10;&lt;li&gt;📁 &lt;strong&gt;项目感知&lt;/strong&gt; - 理解项目结构和依赖关系&lt;/li&gt;&#10;&lt;li&gt;🎯 &lt;strong&gt;高效协作&lt;/strong&gt; - 快速迭代，专注解决问题&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;hr&gt;&#10;&lt;h2 id="第一部分基础使用"&gt;第一部分：基础使用&lt;/h2&gt;&#10;&lt;h3 id="11-启动-claude"&gt;1.1 启动 Claude&lt;/h3&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 在当前目录启动&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;claude&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 指定工作目录&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;claude /path/to/project&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 快速提问&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;claude &lt;span class="s2"&gt;&amp;#34;如何在 Python 中读取 JSON 文件？&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id="12-文件操作"&gt;1.2 文件操作&lt;/h3&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 读取文件&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&amp;gt; 读取 src/main.py 文件&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 编辑文件&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&amp;gt; 在 app.js 中添加错误处理&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 创建文件&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&amp;gt; 创建一个 React 组件 Button.jsx&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id="13-项目操作"&gt;1.3 项目操作&lt;/h3&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 分析项目结构&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&amp;gt; 分析这个项目的结构&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 搜索代码&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&amp;gt; 找到所有使用 useState 的地方&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 运行命令&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&amp;gt; 运行测试&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&amp;gt; 安装依赖 axios&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;hr&gt;&#10;&lt;h2 id="第二部分常用斜杠命令"&gt;第二部分：常用斜杠命令&lt;/h2&gt;&#10;&lt;h3 id="核心命令"&gt;核心命令&lt;/h3&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;命令&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;功能&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;示例&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;/help&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;显示帮助&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;/help&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;/model&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;切换模型&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;/model opus&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;/clear&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;清除历史&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;/clear&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;/exit&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;退出&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;/exit&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;/remember&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;保存记忆&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;/remember 使用 PostgreSQL&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;/memory&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;查看记忆&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;/memory&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;h3 id="模型选择"&gt;模型选择&lt;/h3&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 复杂任务使用 Opus（最强大）&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;/model opus&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 日常开发使用 Sonnet（平衡）&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;/model sonnet&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 简单问题使用 Haiku（最快）&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;/model haiku&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;hr&gt;&#10;&lt;h2 id="第三部分工作流实践"&gt;第三部分：工作流实践&lt;/h2&gt;&#10;&lt;h3 id="31-新功能开发"&gt;3.1 新功能开发&lt;/h3&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 1. 描述需求&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&amp;gt; 我需要添加用户登录功能&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 2. Claude 会询问细节并实现&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&amp;gt; 使用 JWT，密码用 bcrypt 加密&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 3. 测试功能&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&amp;gt; 运行登录相关的测试&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id="32-代码重构"&gt;3.2 代码重构&lt;/h3&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 说明重构目标&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&amp;gt; 这个文件太长了，帮我重构一下&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# Claude 会分析并提出方案，确认后执行&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&amp;gt; 好的，按你的方案重构&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id="33-bug-修复"&gt;3.3 Bug 修复&lt;/h3&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 描述问题&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&amp;gt; 用户反馈登录后立即退出了&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# Claude 会调查、提出解决方案并修复&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id="34-代码审查"&gt;3.4 代码审查&lt;/h3&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&amp;gt; 审查这段代码的安全问题&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&amp;gt; 检查性能瓶颈&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&amp;gt; 提出代码改进建议&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;hr&gt;&#10;&lt;h2 id="第四部分高效使用技巧"&gt;第四部分：高效使用技巧&lt;/h2&gt;&#10;&lt;h3 id="41-清晰沟通"&gt;4.1 清晰沟通&lt;/h3&gt;&#10;&lt;p&gt;❌ &lt;strong&gt;不好的提问&lt;/strong&gt;：&lt;/p&gt;</description></item><item><title>Hugo 博客部署到 GitHub Pages 完全指南</title><link>https://blog.cbzmx.com/posts/github-pages-deployment-guide/</link><pubDate>Sat, 13 Jun 2026 00:00:00 +0000</pubDate><guid>https://blog.cbzmx.com/posts/github-pages-deployment-guide/</guid><description>&lt;p&gt;本篇从一个已经能运行 &lt;code&gt;hugo --minify&lt;/code&gt; 的博客开始。还没有站点，可以先完成 &lt;a href="https://blog.cbzmx.com/posts/hugo-imx-theme-tutorial/"&gt;Hugo 与 IMX 入门指南&lt;/a&gt;；需要调整主题细节，参见 &lt;a href="https://blog.cbzmx.com/posts/hugo-theme-imx-configuration-guide/"&gt;IMX 主题配置指南&lt;/a&gt;。&lt;/p&gt;&#10;&lt;p&gt;&lt;img&#10; src="https://blog.cbzmx.com/posts/github-pages-deployment-guide/images/cover-v2.webp"&#10; alt="从本地博客经工作流发布到 GitHub Pages 的概念图"&#10; width="1672"&#10; height="941"&#10; loading="lazy"&#10; decoding="async"&gt;&lt;/p&gt;&#10;&lt;h2 id="1-确认仓库与站点地址"&gt;1. 确认仓库与站点地址&lt;/h2&gt;&#10;&lt;p&gt;GitHub Pages 有两种常见地址，&lt;code&gt;baseURL&lt;/code&gt; 必须与最终公开地址对应：&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;类型&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;仓库名&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;&lt;code&gt;baseURL&lt;/code&gt;&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;用户站点&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;your-name.github.io&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;https://your-name.github.io/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;项目站点&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;my-blog&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;https://your-name.github.io/my-blog/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;本站是用户站点，但使用自定义域名，所以 &lt;code&gt;hugo.toml&lt;/code&gt; 中写的是 &lt;code&gt;baseURL = 'https://blog.cxx.pub/'&lt;/code&gt;。项目站点尤其要保留末尾的仓库路径；否则页面链接、图片或样式可能指向错误位置。&lt;/p&gt;&#10;&lt;p&gt;在发布前检查本地环境与构建：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;hugo version&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;go version&#10;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;hugo --minify&#10;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;IMX 需要 Hugo Extended 和 Go。Hugo Module 的依赖应记录在 &lt;code&gt;go.mod&lt;/code&gt;、&lt;code&gt;go.sum&lt;/code&gt;，并连同 &lt;code&gt;hugo.toml&lt;/code&gt; 一起提交。将 &lt;code&gt;/public/&lt;/code&gt;、&lt;code&gt;/resources/_gen/&lt;/code&gt;、&lt;code&gt;/.hugo_build.lock&lt;/code&gt; 放入 &lt;code&gt;.gitignore&lt;/code&gt;；Pages 工作流会构建 &lt;code&gt;public/&lt;/code&gt;，不必把它提交进源码仓库。&lt;/p&gt;&#10;&lt;h2 id="2-创建-github-仓库"&gt;2. 创建 GitHub 仓库&lt;/h2&gt;&#10;&lt;p&gt;在 GitHub 新建仓库。若希望使用根地址 &lt;code&gt;https://your-name.github.io/&lt;/code&gt;，仓库名必须是 &lt;code&gt;your-name.github.io&lt;/code&gt;；若使用项目地址，可以取普通仓库名。已有本地 Git 仓库时，建议创建空仓库，避免首次推送出现不必要的历史合并。&lt;/p&gt;&#10;&lt;p&gt;然后在仓库 &lt;strong&gt;Settings → Pages → Build and deployment → Source&lt;/strong&gt; 选择 &lt;strong&gt;GitHub Actions&lt;/strong&gt;。本文的工作流会上传构建产物并部署，不使用“从分支发布”的方式。&lt;/p&gt;</description></item><item><title>关于</title><link>https://blog.cbzmx.com/about/</link><pubDate>Sat, 13 Jun 2026 00:00:00 +0000</pubDate><guid>https://blog.cbzmx.com/about/</guid><description>&lt;h2 id="欢迎"&gt;欢迎&lt;/h2&gt;&#10;&lt;h3 id="关于我"&gt;关于我&lt;/h3&gt;&#10;&lt;p&gt;这里是我记录技术学习和生活思考的地方。&lt;/p&gt;&#10;&lt;h3 id="技术栈"&gt;技术栈&lt;/h3&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;前端:&lt;/strong&gt; JavaScript, TypeScript, Vue, React&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;后端:&lt;/strong&gt; Python, Go, Java&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;其他:&lt;/strong&gt; CodeX, Claude Code&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h3 id="博客内容"&gt;博客内容&lt;/h3&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;💻 技术文章&lt;/li&gt;&#10;&lt;li&gt;📚 学习笔记&lt;/li&gt;&#10;&lt;li&gt;🤔 思考总结&lt;/li&gt;&#10;&lt;li&gt;📝 生活随笔&lt;/li&gt;&#10;&lt;/ul&gt;</description></item></channel></rss>