一句话结论：Windows Terminal + PowerShell 7，把 Windows 侧的命令行底座一次搭好，从此告别蓝色老窗口。

现在很多 AI 编程工具都依赖一个靠谱的终端环境，终端好不好用，直接决定你折腾的效率。以前 Windows 用户只能忍着 cmd.exe 或者那个老旧的 PowerShell 蓝色窗口：没有多标签、没有配置化、复制粘贴都不太顺手，一个字——丑。如今 Windows Terminal + PowerShell 7 已经是 Windows 开发的标准配置，装完你就知道差距在哪了。

先分清两个东西：终端和 Shell

动手之前先分清两个概念，不然后面容易绕晕：

• 终端（Terminal）：你看到的那扇"窗口"，负责展示和输入。
• Shell：窗口里跑的命令解释器，你敲的命令由它翻译执行。

简单来说，终端是"饭店大厅"，Shell 是"后厨"。以前 Windows 是把大厅和后厨焊死的（CMD 窗口只能配 cmd.exe），现在终于能自由搭配了。Windows Terminal 就是微软出的现代化终端模拟器，开源、支持多标签，一个窗口里能开 CMD、PowerShell、WSL 多种环境，随便切。

| 组件 | 推荐选择 | 理由 | |---|---|---| | 终端模拟器 | Windows Terminal | 目前 Windows 上最好的终端入口，没有之一 | | Shell（原生） | PowerShell 7 (Core) | 比系统自带的 PowerShell 5.1 更快、跨平台、功能更强 |

安装

1. 装 Windows Terminal

打开 Microsoft Store（商店），搜索 terminal，装 Windows Terminal：

2. 装 PowerShell 7

还是在商店，搜 powershell，装 PowerShell：

注意：认准黑色图标那个 PowerShell，蓝色图标的是系统自带的旧版 Windows PowerShell 5.1，别装错了。另外安装时如果开着代理，商店可能下载失败，先关掉代理再装。

配置

1. 固定到任务栏

搜索"终端"，右键选择固定到任务栏。以后单击任务栏图标就能打开，不用每次翻开始菜单：

2. 进入设置

打开终端，点窗口标题栏的下拉箭头，选设置（快捷键 Ctrl+,）：

3. 设置默认启动

在设置左侧点启动，改三个地方：

• 默认配置文件：选刚装的 PowerShell。不选的话，打开还是老的蓝色窗口，等于白装。
• 启动大小：我喜欢 100 × 25（列 × 行），窗口不会太小挤得慌，也不会太大占满屏。
• 在计算机启动时启动：默认是关的，想开机就自动开终端的打开它就行。

外观调教（我的习惯数值）

进配置文件 → 默认值 → 外观，下面几个是我用下来比较顺手的数值，分享给你参考：

• 边框间距：12（四个方向都设 12，文字不会贴边）
• 背景不透明度：89%（稍微透一点点，能隐约看到后面的窗口，但不影响阅读）
• 字号：9
• 行高：1.2
• 单元格宽度：0.6

小提示：这些数值是我自己用着舒服的参数，没有标准答案，按你的屏幕分辨率和喜好调就行。

全部配置完，记得点右下角保存。

使用

之后从任务栏点开终端，默认就是 PowerShell 7，直接开干。日常写命令、跑脚本、切 WSL，都在这个窗口里搞定，不用再开一堆乱七八糟的黑色窗口。

总结

| 组件 | 用什么 | |---|---| | 入口 | Windows Terminal | | 日常操作 | PowerShell 7 |

别再用老旧的 CMD 了。一个窗口装下 CMD、PowerShell、WSL，还能自定义外观——这套底座搭好，后面折腾 AI 编程工具、跑脚本都顺手很多。

一句话结论：我把「多智能体协同开发」封装成了一个开箱即用的 AI Skill —— 加载后 AI 会按「计划 → 开发 → 测试 → 修正」的工程化流程干活，主智能体只调度不写码，修 bug 靠 resume 同 ID 保住上下文。已开源（MIT），也在腾讯 SkillHub 发布了。

为什么写这个东西

先说动机。我用 AI 写代码的时间不算短，但每次把一个大项目丢给单个 agent 从头做到尾，总会撞上三个瓶颈：

| 瓶颈 | 具体表现 | |---|---| | 上下文窗口爆炸 | 对话一长，模型注意力就散了，连自己之前为什么这么写都记不住 | | 修 bug 失忆 | 改 bug 的时候，agent 已经忘了当初的实现意图、忘了测试报告里的具体缺陷 | | 测试与开发互相污染 | 写代码的 agent 自己测自己的代码，永远缺一个独立审查的视角 |

我试过手动拆任务、手动切对话，也能跑，但每次都要重复一套流程，太折腾。后来想明白了：与其每次手搓，不如把整套「角色分工 + 修正循环」固化成一份可加载的 Skill。于是就有了 Super Agent。

它是什么

Super Agent 是一个 AI Agent Skill：加载之后，AI 会按「计划 → 开发 → 测试 → 修正」的工程化流程推进项目，而不是一口气把代码写完就交差。

简单来说，它给 AI 配了一个「项目经理 + 一支分工明确的团队」：

| 角色 | 剧本文件 | 职责 | |---|---|---| | 主智能体（编排者） | agents/orchestrator.md | 拆任务、调度、写日志、判 PASS/FAIL。永不修改业务代码，就是个包工头 | | 计划智能体 | agents/planner.md | 读需求文档，一次性生成 dev-plan.md 和 dev-spec.md，整个流程只跑一次 | | 开发智能体 | agents/developer.md | 按单个任务写代码、记录变更、修 bug | | 测试智能体 | agents/tester.md | 只读审查、写测试报告。也不修改业务代码，保证独立视角 | | 评估智能体（可选） | agents/grader.md | 回归评估，输出 benchmark.json |

五个角色都有独立的剧本文件，你可以按项目替换，但不能改主智能体的串行调度、同 ID resume 和上下文隔离规则。

核心机制：角色分离 + 修正循环

修正循环：修 bug 不失忆的关键

测试不通过时，不是重新开一个 agent，而是 resume 同一个 agent：

开发 Agent（新 ID）→ 测试 Agent（新 ID）
 ↑                    │
 │                    │ FAIL
 └── resume 同一 dev ←┘
      （修完）
      ↓
      resume 同一 tester（重测）

为什么这么设计？因为上下文就是记忆。重开一个新 agent 等于让一个失忆的人来修 bug——它看不到当初写代码时的思路，只能瞎猜。resume 同 ID，才能保证「我当初为什么这么写」「测试报告里具体哪里不达标」这些信息还在脑子里。

注意：同一任务最多测 5 轮，第 5 轮仍 FAIL 就标记 ⚠️ 强制通过，不阻塞后续任务。防止死循环耽误总进度。

五条不可破坏的原则

| 原则 | 含义 | |---|---| | 文件即记忆 | 所有产出（计划、代码、报告、经验）落盘到批次目录，不依赖对话上下文 | | 隔离即常态 | 每个子智能体只看到主智能体传过去的内容，假设它什么业务背景都不知道 | | 记录即保险 | 所有时间由 scripts/now.py 获取，禁止推算 | | 路径即接口 | 主智能体只拿文件路径、不读内容；子智能体收到路径后自己读 | | resume 同 ID | 修 bug resume 同开发 Agent，重测 resume 同测试 Agent，新任务开新 Agent |

为什么必须严格串行

这个 skill 里所有智能体调用必须严格串行，包括测试子代理之间。这不是性能取舍，而是保护 resume 机制和上下文隔离的设计前提。违反任何一条都算破坏这个 skill：

1. 主智能体修改业务代码 → 严格禁止
2. 一个任务对应一个 dev Agent → 禁止复用同 ID dev 处理多个任务
3. 下一个任务必须等当前任务完全完成（含修正循环）
4. 测试子代理之间必须串行，不能多个 tester 同时跑
5. tester FAIL → 修 bug 必须 resume 同一 dev Agent
6. dev 修完 → 重测必须 resume 同一 tester Agent
7. 跨 role 并行（如前后端同时跑）→ 不允许
8. 更新 dev-plan.md 只能用 Edit 单行替换，禁止 Write 覆盖整个文件

真实跑通：在 TRAE 里开发 CLI Manager

光说不练假把式，我直接用它在 TRAE 里跑了一个真实项目：CLI Manager（极轻量桌面 CLI 工具管理器，Tauri 2 + React 18 技术栈，识别·运行·升级一条龙）。需求文档和 UI 线框图丢给它，剩下的全看它自己表演。

阶段 A：加载 skill，自动初始化

加载 skill 后只给了一句话需求，它先检查环境（Rust 1.98.1 / Node v24.20.0），然后跑 init_workspace.py 创建独立批次目录，所有产出都会落在里面，不污染对话上下文：

阶段 B：planner 生成完整计划

初始化完进入阶段 B，启动 planner 计划智能体。它读需求文档和线框图后，一次性产出 dev-plan.md（阶段任务表）、dev-spec.md（编码规范）、requirements.md（需求摘要）：

阶段 C：任务循环，逐个开发 + 独立测试

计划就绪后进入任务循环，每个任务都是「新 dev → 新 tester → 判定 PASS/FAIL」。T0 脚手架任务里，开发智能体一口气创建了根配置 7 个、后端 7 个、Rust 源码 4 个、业务模块占位 7 个文件：

验收：双重验收 + 浏览器走查

每个任务完成后不是它自己说了算，要过静态测试 + 浏览器走查双重验收。T0 完成后判定 PASS，才放行进入 T1 元数据模块：

走查环节用的是浏览器自动化 Agent，8 项检查（页面加载、5 个 tab 切换、侧栏导航、纸张手绘风视觉、深浅主题切换、console 无报错、mock 数据可见）逐项验证并留存截图证据：

结果：14 个任务全部完成

整个项目 5 个阶段、14 个任务全部跑完，11 份测试报告全部 PASS：

从晚上 9 点干到第二天早上 9 点半，任务耗时 11 小时 39 分——中间我完没全管，全程就是它自己循环。对比以前手动拆任务、手动催进度的日子，效率翻了好几倍。并且我验收的时候，工具上除了加载速度有点小问题是我当初没有考虑到的问题没有写入开发文档之外，其他的包括打包文件什么的是完全跑通并且实测可用了的

怎么安装使用

打开技能页 skillhub.cn/skills/user_dd51ca54/super-agent，复制页面上的安装指令（一句话），粘贴给你的 AI 工具——WorkBuddy、OpenClaw、QClaw 这类支持 SkillHub 的都行，它自己就会装好。WorkBuddy 用户更省事：直接在左侧技能库切到 SkillHub 来源，搜索 super-agent，点安装就行。

依赖：Python >= 3.10（脚本只用标准库，无第三方依赖）。

加载后启动也很简单，一句话：

加载 super-agent skill，帮我开发 my-project 项目，需求文档在 /path/to/requirements.md

它会自动创建批次目录进入阶段循环。所有产出都落在 <你的项目>/.super-agent/runs/<项目名-日期--批次号>/ 下：计划、测试报告、经验库、最终报告，全部可追溯。

小提示：如果没给需求文档，它会扫描已有批次，列出未完成的批次问你是继续还是新建——相当于自带断点续传。

适用 / 不适用

| 场景 | 结论 | |---|---| | 长期、可追溯、需要独立审查的开发任务 | ✅ 适用 | | 有明确需求文档、任务可拆分可独立验证的项目 | ✅ 适用 | | 修 bug 时需要复用原 Agent 上下文的任务 | ✅ 适用 | | 一次性小修改 | ❌ 杀鸡用牛刀，agent 直接改就行 | | 强耦合、无法独立验证的任务 | ❌ 拆了反而更难 | | 只是回答问题、解释概念 | ❌ 不需要多智能体协作 |

写在最后

这次把 super-agent 开源 + 发布 SkillHub，对我来说算是把「多智能体协作」从一次性实验变成了可复用资产。文件即记忆、隔离即常态、路径即接口这三条，对我自己写 Agent 工作流也很有启发。

• 开源地址：github.com/super-mortal/super-agent（MIT，欢迎 Star ⭐）
• SkillHub 发布页：skillhub.cn/skills/user_dd51ca54/super-agent（v0.0.2，AI 评分 4.6）

如果你也在折腾多智能体，或者想让 AI 开发流程变得可追溯、可审查，欢迎拿去试试。

一句话：从 0 到 1 搭一套可复用 Agent 工作系统的开源实战指南 —— E-INK 视觉、6 种语言、一切皆插件，命令可复制、报错可复现，照着做就能跑通。

先交代下背景：我从 dsh 刚出来就在折腾 DeepSeek Harness（简称 dsh），一路踩了不少坑。想找份"从入门到生产"的完整教程，结果翻了一圈官方仓库——只有 API 文档，没有一篇能照着跑的实战指南。行吧，没人写，那我写。于是就有了这份 DeepSeek Harness 蓝皮书（GitHub 仓库）。

这是什么

简单来说，这是一份以真实任务为主线的 dsh 学习指南：从跑通第一个能验收的 Agent 开始，到搭出一套可复用的工作系统。它不是 API 文档的翻译——官方文档讲"是什么"，我讲"怎么跑通"。每一步的命令、截图、甚至报错，都是真实操作记录下来的，照着做就能复现。

视觉上我搞了一套 E-INK 纸感 × DeepSeek 墨蓝 主题：米白纸底、墨色文字、荧光黄标注，动效几乎为零，读起来更像一本纸书而不是网页。支持中/英/日/韩/西/葡 6 种语言，还内置了自研图片灯箱（点击放大、Ctrl+滚轮缩放、拖拽平移）。

这份指南适合谁

• 刚接触 dsh，想从"装上能跑"走到"搭一套工作系统"的开发者
• 用过一阵 dsh，但对插件树、消息流、调度、MCP 还没串起来的进阶用户
• 想给团队沉淀一套 Agent 工作流模板、而不是每次从零写脚本的负责人

讲些什么

全书按 PART 组织，从入门一路到生产环境：

• PART 00-01 · 入门：为什么是 Agent 的乐高时代；认识 dsh、安装、Web UI、headless 模式、模型配置与排错
• PART 02-03 · 核心机制：插件树、核心子系统与消息流、会话日志；工具与沙箱、MCP、子代理、Skill、调度、本地部署
• PART 04 · 插件开发：dsh 的精髓"一切皆插件" —— 从安装插件到编写插件再到发布插件，defineTool、Hooks、UI 一条龙
• PART 05-06 · 实战与生产：个人网站、PPT、视频三个实战场景；部署、安全、可观测性与上下文管理
• 附录：术语表、命令速查、学习路径、面试题

每章遵循同一个模板：本章目标 → 动手 → 分节实操 → 这一章你学到了什么。实操章节还附赠"让 dsh 自己来：一句提示词"的玩法 —— 毕竟学 Agent 工具最好的方式，就是用 Agent 来干活。

怎么读（按需挑）

• 想跑起来：直接看 PART 00-01，跟着命令敲一遍，30 分钟内能跑通第一个 Agent
• 想搞懂原理：从 PART 02 开始读，重点看插件树、消息流、调度三块
• 想自己写插件：直奔 PART 04，把 defineTool / Hooks / UI 三件套跑通一遍就能上手
• 要上生产：PART 05-06 看部署、安全、可观测性，附录有命令速查和面试题

写在最后

如果你也在用 dsh，或者对 Agent 工作流感兴趣，直接在仓库按 PART 目录读就行。觉得有用的话，点个 Star 就是最大的鼓励 ⭐

• 在线阅读：dsh.supermortal.top
• 仓库地址：super-mortal/DeepSeekHarnessGuide

1. VMware Workstation Pro 下载

• 官方下载地址：VMware 官网产品页

2. fnOS 飞牛私有云镜像下载

• 官网下载：https://www.fnnas.com

进官网找到最新版的 fnOS ISO 镜像下载。x86 设备选标准版就行，ARM 设备可以留意官网的 ARM 公测版

二.检查并开启 CPU 硬件虚拟化

1 Windows 系统内查看虚拟化是否启用

1. 右键底部任务栏 → 打开任务管理器
2. 顶部切换到【性能】→ 点击左侧【CPU】
3. 右侧下拉找到虚拟化选项

• 显示【已启用】→ 系统层面没问题，跳过这步
• 显示【已禁用】→ 需要进 BIOS 开启，往下看

2 进 BIOS 开启 VT-x（虚拟化技术）

虚拟化如果显示禁用，需要进电脑的 BIOS 把 VT-x 打开。不同品牌进 BIOS 的方式略有不同，这里整理了一下常见的按键

| 电脑品牌 / 主板类型 | 开机时按键 | | --------------------- | ---------------------- | | 华硕 ASUS | F2（或 Del） | | 技嘉 GIGABYTE | Del | | 微星 MSI | Del | | 华擎 ASRock | F2（或 Del） | | 联想 Lenovo（笔记本） | F2（或 Fn+F2） | | 联想 ThinkPad | F1（或 Enter 再按 F1） | | 戴尔 Dell | F2 | | 惠普 HP | F10 | | 宏碁 Acer | F2 | | 小米 / Redmi 笔记本 | F2 | | 华为 MateBook | F2（或 Fn+F2） |

操作步骤：

1. 重启电脑，在开机画面（品牌 Logo 出现时）连续按上面对应的按键
2. 进入 BIOS 界面后，找到 Advanced 或 Configuration 菜单（中文界面叫"高级"或"配置"）
3. 寻找以下选项之一（不同主板命名略有差异）：
   • Intel Virtualization Technology（Intel VT-x）
   • SVM Mode（AMD 平台的叫法）
   • Virtualization Technology
   • VT-x
4. 把它设为 Enabled（启用）
5. 按 F10 保存并退出，选择 Yes 重启

小提示：如果进 BIOS 后发现找不到这些选项，可能是 BIOS 被锁定了高级菜单。华硕等品牌需要在 BIOS 中按 F7 进入 Advanced Mode 才能看到完整选项。

3 关闭 Windows 自带 Hyper-V

这一步很容易忽略。Windows 自带的虚拟机服务和 VMware 冲突，哪怕 BIOS 开了虚拟化，Hyper-V 不关的话依然会报错、网络不通、后台打不开。

1. 打开控制面板 → 程序 → 启用或关闭 Windows 功能
2. 下拉列表，把以下三项全部取消勾选：
   • Hyper-V（全部子目录一起取消）
   • 虚拟机平台
   • Windows 沙箱/盒
3. 点击确定，根据提示重启电脑生效

核心总结：虚拟化一共两层开关——BIOS 底层 + Windows 系统层。两层全部打开，VMware 才能正常运行，缺一不可

三.安装飞牛和创建储存空间

1.安装飞牛

1. 打开 VMware → 创建新的虚拟机 →选典型 (推荐) → 下一步

2. 选择安装程序光盘镜像文件 (ISO) → 选择刚下的 fnos ISO → 下一步

3. 客户机操作系统选 Linux → 版本选 Debian 12.x 64 位 → 下一步

4. 给虚拟机取个名字，我的是 fnOS；位置：选一个非 C 盘、空间大的目录 → 下一步

5. 最大磁盘大小：15-20G，这里直接选择15-20G就够了，用作安装系统的镜像，后续再扩展磁盘做硬盘储存

6. 点自定义硬件（最关键的一步）在弹出的窗口里，改这 4 项

• 内存：改成 4096 MB（4GB），有 8G 内存就给 8192
• 处理器：2 核 或更多，勾选「虚拟化 Intel VT-x/EPT」
• 新CD/DVD(IDE)：确认是你那个 fnOS ISO，勾选启动时连接
• 网络适配器：选 NAT 模式（最简单，能上网）

7. 都弄好之后 → 点 关闭 → 再点完成，就可以看见回到了主页面

8. 然后选中fnOS（自己填写的名字），点击开启此虚拟机

9. 虚拟机开启后会看到如上页面，直接点击下一步，再点击下一步，然后会弹出一个关于格式化硬盘的说明直接点击确定即可，这里说的操作只针对 VMware 生成的虚拟磁盘文件，跟本机硬盘完全隔离，数据百分百安全，无需担心
10. 启动完成后自动进网络设置，默认 DHCP（自动获取 IP 的意思）不需要修改 ，然后记录下面显示的 IP 地址即可→ 保存
11. 等一会之后，浏览器打开第10步中记录的 IP 就能进入 fnOS 的 Web 后台初始化界面了

12. 然后自己设置一个名称，账号以及密码就可以进去了，到了这里还需要给他扩展磁盘做存储用的磁盘

2. 扩展磁盘空间

1. 关机这个虚拟机，再设置的地方找到硬盘选项，点击扩展硬盘，选择要扩展的大小，根据喜好即可
2. 然后重新启动虚拟机，输入之前记录的 IP 进入飞牛的web页面，点击系统设置，点击储存空间管理，创建储存空间

3. 选择系统推荐的然后点击下一步，然后选择刚刚扩展的那个硬盘，然后储存模型选择 Basic 和 Linear 都可以，然后一直下一步最后输入管理员密码进行插件即可
4. 完成之后点击 Docker 进行首次启动，选择docker的数据目录就行了，就可以看见docker服务弄好了

四.开启 FN-Connect 远程访问

FN-Connect 是飞牛自研内网穿透服务，无需公网IP，凭FN ID加密远程访问NAS，开启之后就可以在任何设备上直接访问你这个电脑的虚拟机上安装的飞牛了，需要有飞牛账号，前往飞牛官网 进行免费注册就行了

1. 在飞牛的 web 后台，点击系统设置，然后选择远程访问，点击开启 FN-Connect ，在弹出的登录框中直接登录的飞牛账号就行了，然后设置自己名字，这个名字是唯一的，如果其他用户有了会让你重新设置，好了之后，剩下的会全自动完成，最后就可以获得一个格式为 https://fnos.net/你设置的名字的远程访问地址了

五.常见问题

Q1：虚拟机硬盘格式化，会不会清空我电脑本地的资料？

A：绝对不会。所有操作只针对 VMware 生成的虚拟磁盘文件，跟本机硬盘完全隔离，数据百分百安全。

Q2：开机一直提示移除安装镜像，必须移除吗？

A：不一定，虚拟硬盘已经装好系统了，光驱挂着的 ISO 不影响启动和使用。关机之后再去删除就行

# 配置全局用户名（和你的 GitHub 用户名一致）
git config --global user.name "你的GitHub用户名"

# 配置全局邮箱（和你 GitHub 账号绑定的邮箱一致）
git config --global user.email "你的GitHub邮箱"

二.关联电脑

第一步：打开终端（ CMD / PowerShell 都行）

执行下面这条命令，一路回车，不要输入任何密码

ssh-keygen -t ed25519 -C "你的GitHub注册邮箱"

第二步：复制公钥内容

type C:\Users\你的电脑用户名\.ssh\id_ed25519.pub

执行后，终端会输出一长串以 ssh-ed25519 开头、邮箱结尾的字符串，把它完整复制下来

第三步：把公钥粘贴到 GitHub

1. 打开 GitHub 右上角头像 → Settings

2. 左侧找到 SSH and GPG keys

3. 点击 New SSH key

4. Title 随便填（比如：我的笔记本）

5. Key type 选 Authentication key

6. Key 框里粘贴你刚才复制的那串字符

7. 点 Add SSH key → 完成！

第四步：测试连接是否成功

ssh -T git@github.com
# 如果出现：Hi xxx! You've successfully authenticated...
# ✅ **说明 SSH 配置 100% 成功！**

三.前提条件

在开始之前，确保你已经：

1.绑定电脑和关联电脑已经完成

同一个电脑只需要一次，后续不用再重复操作，完成后会在C:\Users\你电脑的用户名\.ssh目录下有凭证

2. 验证本地已安装 Git

打开终端

git --version

3. 已在 GitHub 上创建新仓库

• 登录 GitHub

• 点击右上角 "+" → "New repository"

• 填写仓库名称（如 my-new-blog）

• 不要勾选 "Add a README file"、"Add .gitignore" 等选项

• 点击 "Create repository"

四.标准推送流程

步骤 1：初始化 Git

# 项目根目录初始化 git 仓库（这会在文件夹里创建一个 .git 隐藏文件夹）
git init

步骤 2：添加文件到暂存区

# 添加所有文件到暂存区（. 代表当前目录所有文件）
git add .

# 如果只想添加特定文件，比如只加 README.md：
git add README.md

步骤 3：提交暂存区的文件

# 提交文件，-m 后面是提交说明（必须写，描述这次提交的内容）
git commit -m "initial commit: 初始化项目，添加基础代码"

步骤 4：关联 GitHub 远程仓库

回到 GitHub 的新仓库页面，复制仓库的 HTTPS/SSH 地址（推荐用 SSH），然后执行：

# 关联远程仓库（替换成实际的仓库地址）

# HTTPS 方式：
git remote add origin https://github.com/你的用户名/仓库名.git

# SSH 方式（推荐）：
git remote add origin git@github.com:你的用户名/仓库名.git

步骤 5：推送到 GitHub 仓库

# 把本地 master/main 分支推送到远程 origin 仓库，并设置默认上游分支

# 如果 GitHub 仓库默认分支是 main（直接推送）
git push -u origin main

# 如果 GitHub 仓库默认分支是 master（老项目）：
git push -u origin master

# 如果本地分支是 master，但想推送到远程 main：

# 重命名本地分支
git branch -m master main

# 推送并重命名远程分支
git push -u origin main

说明：

• -u 参数用于绑定本地分支与远程分支，之后直接用 git push 就能自动推送

• GitHub 新仓库默认分支是 main，老项目可能是 master

五.Git 分支管理基础

1. GitHub 主分支的两种习惯

• 早期 GitHub 默认主分支：master

• 现在 GitHub 新仓库默认主分支：main

• 你也可以在仓库设置里把任意分支设为默认主分支

2. 本地分支与远程分支的对应关系

本地分支名 ≠ 远程分支名

它们可以不一样，但强烈建议保持同名，避免混淆。

推送时对应关系

• 同名推送（最推荐）：本地分支名 = 远程分支名

• 手动指定不同名：也可以手动指定不同名，但不建议，容易搞乱

3. 分支命名规范（行业通用）

| 分支类型 | 命名示例 | 用途 | | ---------- | ----------------- | ----------------------------------- | | 主分支 | main / master | 稳定可发布的代码 | | 开发分支 | develop / dev | 日常开发集成 | | 功能分支 | feature/xxx | 新功能开发，如 feature/user-login | | 修复分支 | fix/xxx | 修复 bug，如 fix/payment-error | | 热修复分支 | hotfix/xxx | 线上紧急修复 | | 发布分支 | release/v1.2 | 版本发布前的准备 |

4. 常用 Git 分支命令

# 查看所有分支
git branch

# 查看当前分支
git branch

# 重命名当前分支
git branch -m 旧名 新名

# 切换分支
git checkout 分支名

# 创建新分支
git branch 新分支名

# 切换并创建新分支
git checkout -b 新分支名

# 推送新分支到远程
git push -u origin 新分支名

六.快速参考

常用命令速查

# 初始化仓库
git init

# 添加文件
git add .

# 提交
git commit -m "说明"

# 关联远程仓库
git remote add origin git@github.com:用户名/仓库名.git

# 推送
git push -u origin main

# 查看状态
git status

# 查看分支
git branch

# 查看远程仓库
git remote -v

完整示例（从零开始）

# 1. 进入项目目录

# 2. 初始化 Git
git init

# 3. 添加所有文件
git add .

# 4. 提交
git commit -m "initial commit: 初始化项目"

# 5. 关联远程仓库
git remote add origin git@github.com:super-mortal/my-new-blog.git

# 6. 推送到 GitHub（本地是 master）
git push -u origin master

# 或者推送到 main（本地 master → 远程 main）
git branch -m master main
git push -u origin main

TL;DR：本次 SEO 优化只做了一件事——给博客加上 JSON-LD 结构化数据。文章页自动输出 BlogPosting，首页自动输出 WebSite，以后发文无需手动维护

一.为什么要做这次优化

博客基于 Astro + astro-theme-pure，原本已经具备较完整的 SEO 基础：页面 title / description、Open Graph、Twitter Card、canonical 链接、sitemap、RSS、robots.txt 等。

但全站缺少 JSON-LD 结构化数据（application/ld+json）。

JSON-LD 是一段嵌在页面里的 JSON，用 Schema.org 标准告诉搜索引擎：

• 这是博客文章还是普通网页
• 标题、作者、发布时间分别是什么
• 站点名称和 URL 是什么

对 Google 富摘要、AI 搜索引用都有帮助。更重要的是：只要在布局里配置一次，每篇新文章都会自动生成，不用在 Markdown 里重复写。

二.我具体做了什么

1. 文章页：BlogPosting

新建组件 src/components/BlogPostingJsonLd.astro，在 src/layouts/BlogPost.astro 中挂载。

组件会读取文章 frontmatter 里已有的字段，自动拼出 JSON-LD：

| JSON-LD 字段 | 数据来源 | | ---------------------- | ----------------------------------------- | | headline | frontmatter title | | description | frontmatter description | | datePublished | publishDate | | dateModified | updatedDate（没有则用 publishDate） | | author.name | 站点配置 config.author | | image | heroImage 或默认 socialCard | | mainEntityOfPage.@id | https://supermortal.cn/blog/{文章 slug} |

最终页面 <head> 中会出现类似：

<script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "BlogPosting",
    "headline": "文章标题",
    "author": { "@type": "Person", "name": "Mortal" },
    ...
  }
</script>

2. 首页：WebSite

新建组件 src/components/WebSiteJsonLd.astro，在 src/pages/index.astro 中挂载。

自动读取 site.config.ts 里的站点名、描述、作者、语言，输出：

<script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "WebSite",
    "name": "super-mortal",
    "url": "https://supermortal.cn",
    ...
  }
</script>

3. 布局改造：head 插槽

JSON-LD 需要放在 <head> 里。为此改动了两个布局文件：

• src/layouts/BaseLayout.astro：在 <head> 中增加 <slot name="head" />
• src/layouts/ContentLayout.astro：把 head 插槽转发给 BaseLayout

文章页走 BlogPost → ContentLayout → BaseLayout，首页直接走 BaseLayout，两条路径都能把 JSON-LD 注入到 head

三.附 Cloudflare近一个月流量统计

1.查看所有容器

docker ps -a

输出说明：可清晰看到每个容器的 CONTAINER ID（容器唯一ID）、IMAGE（所用镜像）、NAMES（容器名称），记录要删除的容器的名称或ID

2.执行容器删除操作

删除单个容器

docker rm -f -v 容器名或容器ID

删除多个容器

docker rm -f -v 容器1名/ID 容器2名/ID 容器3名/ID

命令解释

• -f：强制停止并删除目标容器（即使容器处于运行中，也能直接删除）
• -v：删除容器自带的内部存储、临时缓存及专属数据卷，确保容器相关缓存彻底清理
• 此操作仅删除 Docker 容器及内部关联缓存，不会删除服务器本地的项目文件（如挂载的代码目录）
• 仅删除指定容器，不影响服务器上其他正在运行或已停止的容器

3.挂载目录一起删除

# 查看挂载路径

docker inspect 容器名 | grep -E 'Source|Destination'

# 输出举例

"Source": "/root/devhome/mysql-data",
"Destination": "/var/lib/mysql"
Source：你服务器本地的真实目录（数据库数据存在这里）
Destination：容器内部目录（不用管）

# 删除容器

docker rm -f -v 容器名/ID

# 删数据库数据

rm -rf 服务器本地Source路径

二.删除对应镜像

1.查看所有镜像

docker images

输出说明：通过第一步记录的容器所用镜像（IMAGE 字段），对应找到需要删除的镜像，记录镜像名或镜像ID

2.执行镜像删除操作

删除单个镜像

docker rmi 镜像名或镜像ID

删除多个镜像

docker rmi 镜像1名/ID 镜像2名/ID 镜像3名/ID

3.清理 Docker 无用残留缓存

删除镜像后，执行以下命令，清理 Docker 系统中无用的残留缓存（如悬空镜像、废弃网络、临时构建产物等），不影响其他在用容器和镜像

docker system prune -f

4.注意事项

• 必须先删除容器，再删除镜像（若镜像仍被容器引用，直接删除镜像会失败）

• docker system prune \-f 仅清理“无人引用”的垃圾缓存，不会误删正在使用的镜像、容器或网络

三.删除目标项目绑定的 SSL 证书

此步骤仅针对目标项目绑定的域名 SSL 证书（由 acme.sh 申请），彻底删除证书及相关配置，不影响其他域名的证书。

1.查看所有 SSL 证书（定位目标证书）

执行以下命令，查看服务器上所有由 acme.sh 申请的 SSL 证书，找到目标项目绑定的域名

acme.sh --list

2.注销 SSL 证书

通知证书颁发机构（如 Let's Encrypt），该域名的证书不再使用，执行注销命令：

acme.sh --revoke -d 目标域名

补充：若证书为 ECC 类型，需在命令后添加 --ecc，即：acme\.sh \-\-revoke \-d 目标域名 \-\-ecc

3.从 acme.sh 管理列表删除证书

将目标域名的证书从 acme.sh 的管理列表中删除，避免后续自动续期：

acme.sh --remove -d 目标域名

4.彻底删除证书文件及缓存

acme.sh 申请的证书文件默认存储在 ~/.acme.sh/ 目录下，执行以下命令删除对应域名的所有证书文件、私钥及缓存：

rm -rf ~/.acme.sh/目标域名
rm -rf ~/.acme.sh/目标域名_ecc

5.删除 Nginx 中对应域名的配置

目标域名的反向代理、SSL 配置文件一般存储在 /usr/local/nginx/conf/ssl/ 目录下，执行以下命令删除

具体路径说明可以查看往期文章: 理解服务器中的Nginx)

6.重载 Nginx 使配置生效

nginx -t  # 检查配置语法，输出 test is successful 即为正常
systemctl reload nginx  # 重载 Nginx

四.重新构建容器时无缓存方法

此步骤适用于删除旧项目后重新构建，或更新项目代码后重新构建，全程不产生缓存，确保构建的容器为最新版本，避免缓存导致的旧代码残留。

1.先删除旧容器

若重新构建的是原有项目，需先删除旧的容器（避免端口冲突、缓存残留）

docker rm -f 旧容器名或ID

2.进入项目目录

切换到存放项目 Dockerfile 的目录（必须进入该目录，否则构建会失败）

cd /服务器上的项目目录

3.无缓存构建镜像

执行无缓存构建命令，确保不使用任何旧缓存，完全基于最新代码构建镜像：

docker build --no-cache -t 镜像名 .

注意⚠️： --no-cache 是核心参数，用于禁用缓存；-t 用于指定镜像名称（自定义，与后续启动容器时的镜像名一致）；末尾的 . 表示当前目录（即 Dockerfile 所在目录）。

4.启动新容器

镜像构建完成后，执行启动命令，启动新容器（使用自己的启动参数，如端口映射、目录挂载等）

docker compose up -d --build

5.清理构建残留缓存

构建完成后，执行以下命令，清理构建过程中产生的无用缓存（如中间构建层），节省磁盘空间

docker image prune -f

6.注意事项

• --no-cache 必须添加，否则 Docker 会复用旧缓存，导致构建的镜像不是最新代码

• 启动容器时，确保端口、目录挂载等参数正确，避免与其他容器冲突

• docker image prune -f 仅清理构建残留的无用缓存，不影响正在使用的镜像和容器

• 若构建失败，需先检查 Dockerfile 是否正确，再重新执行构建命令

偶然之间，我发现网络爬虫在抓取我的博客页面时，生成的 Open Graph (OG) 图片地址显示为：

https://localhost/images/social-card.png

# 而不是https://supermortal.cn/images/social-card.png，导致图片无法显示，下图为修复之后的截图

二.问题排查过程

第一步：检查配置文件

首先，我检查了项目中的所有配置文件：

1. astro.config.ts（第 28 行）：

site: 'https://supermortal.cn',

这里已经正确配置了正式域名

2. src/site.config.ts（第 14 行）：

socialCard: '/images/social-card.png',

这里使用的是相对路径

第二步：分析代码逻辑

在 src/components/BaseHead.astro 中，找到生成 meta 标签的关键代码（第 14 行）：

const socialImageURL = new URL(ogImage ? ogImage : config.socialCard, Astro.url).href

这里的问题是使用了 new URL(..., Astro.url) 方法。

第三步：理解关键概念

1. 我意识到这里涉及两个不同的 URL：

• astro.config.ts 的 site 配置：定义网站在互联网上的正式域名（用于 RSS、sitemap 等元数据）
• Astro.url：在运行时由框架根据浏览器实际请求的 URL 提供的当前请求地址

2. 在开发环境中，浏览器请求 http://localhost:3000/，所以 Astro.url 就是 http://localhost:3000。
3. 但是网络爬虫的工作环境可能与本地浏览器不同，在某些情况下，Astro.url 可能被错误识别为 https://localhost

第四步：URL 拼接验证

当使用 new URL('/images/social-card.png', Astro.url) 时：

• 如果 Astro.url 是 http://localhost，结果就是 http://localhost/images/social-card.png
• 如果 Astro.url 是 https://supermortal.cn，结果就是 https://supermortal.cn/images/social-card.png

三.解决方案

使用绝对 URL

直接在 src/site.config.ts 中使用完整的域名 URL：

socialCard: 'https://supermortal.cn/images/social-card.png'

修改之后可以看到爬虫正确抓取了我的博客信息，同时QQ分享链接时也正确显示了元数据信息

未修改之前无法正确抓取只能显示如下图所示的纯链接

四.问题根源总结

1. 配置分离的问题：astro.config.ts 的 site 配置和运行时的 Astro.url 是两个不同的概念
2. URL 拼接的不确定性：new URL(相对路径, Astro.url) 依赖于 Astro.url 的实际值，不可控
3. 开发环境与爬虫环境的差异：本地开发和爬虫访问的 URL 环境可能不同

五.经验踩坑

踩到的坑 1：相对路径在某些环境下失效

最初使用相对路径 /images/social-card.png 是因为：

• 静态资源部署简单
• 不需要关心域名变化

但实际上，在 URL 拼接时，相对路径仍然会依赖当前页面的 URL，这带来了不可预知的行为。

踩到的坑 2：依赖 Astro.url 的不确定性

Astro.url 在不同运行环境下表现可能不同：

• 开发环境：http://localhost:3000
• 生产环境：https://supermortal.cn
• 爬虫环境：可能不一样

依赖这个值进行 URL 拼接是危险的

写在前面：我之前手动部署的openclaw有两个问题。第一是在root用户下直接部署，一开始我是觉得这样最大权限，龙虾可以做的东西多一点，但是到了后来我发现很少情况需要用到root权限；第二是我允许通过公网访问，是因为我想浏览器也可以操作，但是实际运用起来发现，对接了通讯渠道之后再也用不到Web ui了，所以为了安全考虑，重新部署了我的”龙虾“，于是做了这个笔记，方便日后回顾和帮助同样想手动部署的人

一.概念解释

1.什么是 Root 用户？

root 是 Linux 系统的超级管理员，拥有最高权限。用 root 运行程序不安全，万一被攻击，攻击者就能控制整台服务器。

2.为什么要用专用用户？

把 OpenClaw 装在一个专门的"抽屉"里运行：

• OpenClaw 只能访问自己的文件
• 不会影响系统其他部分
• 更安全，即使被攻击也有限制

3.什么是 systemd

systemd 是 Linux 系统的"自动管家"，可以：

• 开机自动启动程序
• 程序崩溃自动重启
• 统一管理所有服务

二.登录 VPS

使用MobaXterm（Windows 推荐）

1. 下载 MobaXterm
2. 点击左上角 Session → SSH

• Remote host：你的 VPS IP地址

4. Specify username：填 root
5. 点击 OK，输入密码

三.确认工作

1.确认你的系统

连接服务器后，执行：

cat /etc/os-release

# 应该看到 `Ubuntu` 或 `Debian` 字样

2.确认你是 Root

执行以下命令，输出必须是 root

whoami

如果不是，执行下面命令输入密码就会切换到root

sudo -i

四.创建专用用户

1.执行创建用户命令

在 root 用户下执行：

useradd -r -s /usr/sbin/nologin -m -d /opt/openclaw openclaw

| 命令部分 | 含义 | 说明 | | ---------------------- | -------------- | --------------------------------- | | useradd | 创建新用户 | Linux 添加用户的命令 | | -r | 系统账户 | 创建系统用户，不占用户编号 | | -s /usr/sbin/nologin | 禁止登录 | 用户不能 SSH 登录，但程序可以运行 | | -m | 创建 home 目录 | 自动创建用户的主目录 | | -d /opt/openclaw | 指定 home 目录 | 用户的主目录放在这里 | | openclaw | 用户名 | 给这个用户起个名字 |

2.设置目录权限

在 root 用户下执行：

chown -R openclaw:openclaw /opt/openclaw

| 命令部分 | 含义 | | ------------------- | ---------------------------- | | chown | 改变文件/目录的所有者 | | -R | 递归，即包含所有子目录和文件 | | openclaw:openclaw | 用户名:用户组名 | | /opt/openclaw | 要修改权限的目录 |

意思是：把 /opt/openclaw 这个目录以及里面的所有东西都给 openclaw 用户。

3.验证用户创建成功

在 root 用户下执行：

id openclaw

成功的输出类似这样：

uid=998(openclaw) gid=998(openclaw) groups=998(openclaw)

# 能看到 uid、gid、groups 就说明用户创建成功了

五.安装 Node.js

1.安装 Node.js 24

在 root 用户下执行：

第一步：安装 NodeSource 仓库

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -

| 命令部分 | 含义 | | --------------------------------------- | --------------------------- | | curl | 下载文件的命令 | | -fsSL | 安静模式，失败跟随重定向 | | https://deb.nodesource.com/setup_24.x | NodeSource 官方安装脚本地址 | | sudo -E bash - | 用 root 权限执行下载的脚本 |

第二步：安装 Node.js

apt-get install -y nodejs

| 命令部分 | 含义 | | ----------------- | -------------------- | | apt-get install | apt 包管理器安装命令 | | -y | 自动确认，不再询问 | | nodejs | 要安装的包名 |

2.验证安装成功

在 root 用户下执行：

node --version
npm --version

# 成功的输出：

v24.0.0
10.9.0

六.安装 OpenClaw

1.执行官方安装脚本

在 root 用户下执行：

sudo -u openclaw bash -c 'curl -fsSL https://openclaw.ai/install.sh | bash'

| 命令部分 | 含义 | | -------------------------------- | ---------------------------------- | | sudo -u openclaw | 以 openclaw 用户身份执行后面的命令 | | bash -c '...' | 执行引号里的 bash 命令 | | curl -fsSL | 下载文件 | | https://openclaw.ai/install.sh | OpenClaw 官方安装脚本 | | \| bash | 把下载的内容作为脚本执行 |

2.为什么要加 sudo -u openclaw？

因为 OpenClaw 的配置文件和程序要装在 /opt/openclaw 目录里，这个目录属于 openclaw 用户。所以要用 openclaw 的身份来安装，这样所有文件都自动归 openclaw 用户。

3.等待安装完成

安装过程大约需要 3-5 分钟，看到程序开始运行安装向导就行，

向导选择可以点击查看教程 Gateway bind部分保持默认就行

4.找到 OpenClaw 安装位置

安装脚本会自动把 OpenClaw 装到 openclaw 用户的目录下。找到它：

find /opt/openclaw -name "openclaw" 2>/dev/null

会输出类似：

/opt/openclaw/.npm-global/bin/openclaw
/opt/openclaw/.npm-global/lib/node_modules/openclaw

这就是 OpenClaw 命令的实际位置

创建命令快捷方式

因为实际路径很长，给它创建一个短名字的快捷方式：

ln -s /opt/openclaw/.npm-global/bin/openclaw /usr/local/bin/openclaw

| 命令部分 | 含义 | | ---------------------------------------- | ------------------------ | | ln -s | 创建软链接（快捷方式） | | /opt/openclaw/.npm-global/bin/openclaw | 实际的 openclaw 程序位置 | | /usr/local/bin/openclaw | 快捷方式放在哪里 |

⚠️ 为什么这一步必不可少

安装脚本把 OpenClaw 装到了 openclaw 用户的 npm 全局目录里：

/opt/openclaw/.npm-global/bin/openclaw

这个路径不在系统的 PATH 环境变量中，所以 shell 直接打 openclaw 会报 command not found

在执行这一步之前，如果想运行 openclaw 命令，必须用完整路径：

/opt/openclaw/.npm-global/bin/openclaw plugins install @tencent-connect/openclaw-qqbot@latest

创建快捷方式后，相当于在 /usr/local/bin/openclaw 放了一个指向真实程序的链接，而 /usr/local/bin 是在 PATH 里的，所以现在直接打 openclaw 就能找到命令了。

本质就是：npm 把程序装到了一个不在 PATH 的自定义路径里，软链接这一步就是帮命令链接到系统 PATH 目录，让全系统都能直接调用。

验证安装成功

openclaw --version

# 显示版本号即为成功

七.配置环境变量

1.什么是环境变量？

环境变量就像"程序的环境设置"，告诉程序：

• 配置文件在哪里
• 状态文件在哪里
• 工作目录在哪里

2.官方推荐的环境变量

OpenClaw 官方文档推荐在非 root 部署时设置以下环境变量：

| 变量名 | 作用 | 我们的设置 | | ---------------------- | ---------------------------- | --------------------------------------- | | OPENCLAW_HOME | 程序的主目录，所有路径的基准 | /opt/openclaw | | OPENCLAW_STATE_DIR | 状态目录，存配置和会话 | /opt/openclaw/.openclaw | | OPENCLAW_CONFIG_PATH | 配置文件路径 | /opt/openclaw/.openclaw/openclaw.json | | NODE_COMPILE_CACHE | Node.js 编译缓存，加速启动 | /var/tmp/openclaw-compile-cache | | OPENCLAW_NO_RESPAWN | 避免重复启动开销 | 1 |

3.创建环境变量文件

在 root 用户下执行：

第一步：创建目录

sudo -u openclaw mkdir -p /opt/openclaw/.openclaw

| 命令部分 | 含义 | | ------------------------- | ---------------------------- | | sudo -u openclaw | 以 openclaw 用户执行 | | mkdir -p | 创建目录（如果已存在不报错） | | /opt/openclaw/.openclaw | 要创建的目录路径 |

第二步：创建并编辑环境变量文件

sudo -u openclaw nano /opt/openclaw/.openclaw/.env

第三步：输入以下内容

把下面 5 行内容复制粘贴进去，完事后Ctrl+O保存内容**（注意是字母O不是数字0）**，再按Enter确认保存，最后Ctrl+X退出编辑

OPENCLAW_HOME=/opt/openclaw
OPENCLAW_STATE_DIR=/opt/openclaw/.openclaw
OPENCLAW_CONFIG_PATH=/opt/openclaw/.openclaw/openclaw.json
NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
OPENCLAW_NO_RESPAWN=1

4.设置缓存目录权限

mkdir -p /var/tmp/openclaw-compile-cache
chown openclaw:openclaw /var/tmp/openclaw-compile-cache

八.接入QQ机器人

前往QQ开放平台（openclaw）注册并创建自己的机器人

1.安装插件

sudo -u openclaw bash -c "cd /opt/openclaw && openclaw plugins install @tencent-connect/openclaw-qqbot@latest"

| 命令部分 | 含义 | | ---------------------------------------- | ------------------------------------------------ | | sudo -u openclaw | 以 openclaw 用户身份执行后面的命令 | | bash -c "..." | 打开一个新的 bash shell，执行引号里的命令 | | cd /opt/openclaw | 切换到 openclaw 安装目录 | | openclaw plugins install | openclaw 的插件安装命令 | | @tencent-connect/openclaw-qqbot@latest | QQ Bot 插件的 npm 包名，@latest 表示安装最新版本 |

2.添加 QQ 机器人账号

sudo -u openclaw bash -c "cd /opt/openclaw && openclaw channels add --channel qqbot --token '你的AppID:你的AppSecret'"

| 命令部分 | 含义 | | -------------------------------- | ----------------------------------------------------- | | sudo -u openclaw bash -c "..." | 同上，以 openclaw 用户执行命令 | | cd /opt/openclaw | 切换到 openclaw 目录 | | openclaw channels add | 添加频道账号的命令 | | --channel qqbot | 指定频道类型为 qqbot | | --token 'AppID:AppSecret' | QQ 机器人的凭证，格式是 AppID:AppSecret，用冒号分隔 |

3.重启服务

sudo systemctl restart openclaw-gateway

| 命令部分 | 含义 | | ------------------ | -------------------------------------------------- | | sudo | 以 root 身份执行（systemd 服务管理需要 root 权限） | | systemctl | systemd 服务管理工具 | | restart | 重启服务 | | openclaw-gateway | openclaw 网关服务的名称 |

4.验证网关状态

ss -tlnp | grep 18789

# 如果显示 LISTEN，说明正在运行，即成功

九.创建开机自启服务

1.第一步：检测你的环境支持哪种方式

在 root 用户下执行：

systemctl list-units --type=service --state=running 2>/dev/null | head -5

• 如果有输出（列出了一些服务名）→ systemd 可用，用 方案 A
• 如果报错或无输出（如 Failed to connect to bus）→ systemd 不可用，用 方案 B

方案 A：systemd 服务（推荐，适合完整 Linux 系统）

1.什么是 systemd 服务？

systemd 是 Linux 的"服务管理器"。创建服务后，OpenClaw 可以：

• 开机自动启动
• 崩溃后自动重启
• 不需要人工干预

2.创建服务配置文件

在 root 用户下执行：

nano /etc/systemd/system/openclaw-gateway.service

3.粘贴以下内容

把下面的内容完整复制，粘贴进去

[Unit]
Description=OpenClaw Gateway
Documentation=https://docs.openclaw.ai
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=openclaw
Group=openclaw
WorkingDirectory=/opt/openclaw
ExecStart=/opt/openclaw/.npm-global/bin/openclaw gateway --port 18789
Restart=always
RestartSec=5
TimeoutStartSec=90

Environment="OPENCLAW_HOME=/opt/openclaw"
Environment="OPENCLAW_STATE_DIR=/opt/openclaw/.openclaw"
Environment="OPENCLAW_CONFIG_PATH=/opt/openclaw/.openclaw/openclaw.json"
Environment="NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache"
Environment="OPENCLAW_NO_RESPAWN=1"

NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=read-only
PrivateTmp=true
ReadWritePaths=/opt/openclaw

[Install]
WantedBy=multi-user.target

配置解释

| 配置项 | 含义 | | -------------------------------- | -------------------------- | | Description | 服务的描述名称 | | After=network-online.target | 等网络准备好再启动 | | User=openclaw | 以 openclaw 用户身份运行 | | Group=openclaw | 以 openclaw 用户组身份运行 | | WorkingDirectory=/opt/openclaw | 工作目录 | | ExecStart=... | 启动时执行的命令 | | Restart=always | 崩溃后自动重启 | | RestartSec=5 | 崩溃后等 5 秒再重启 | | TimeoutStartSec=90 | 启动超时 90 秒 | | Environment="..." | 环境变量设置 | | NoNewPrivileges=true | 不提升权限（安全） | | ProtectSystem=strict | 限制访问系统目录（安全） | | ProtectHome=read-only | 禁止访问 home 目录（安全） | | PrivateTmp=true | 私有临时目录（安全） | | ReadWritePaths=/opt/openclaw | 允许读写的目录 | | WantedBy=multi-user.target | 开机在多用户模式下启动 |

4.重新加载 systemd

在 root 用户下执行：

systemctl daemon-reload

5.设置开机自启

在 root 用户下执行：

systemctl enable openclaw-gateway.service

6.立即启动服务

在 root 用户下执行：

systemctl start openclaw-gateway.service

7.验证是否成功

在 root 用户下执行：

systemctl status openclaw-gateway.service

# 成功的标志：

- 看到 `Active: active (running)` ✅
- 不是 `inactive` 或 `failed`

方案 B：Crontab 开机任务

1.编写启动脚本

在 root 用户下执行：

sudo -u openclaw tee /opt/openclaw/start-gateway.sh > /dev/null <<'EOF'
#!/bin/bash
source /opt/openclaw/.openclaw/.env
exec /opt/openclaw/.npm-global/bin/openclaw gateway --port 18789
EOF
chmod +x /opt/openclaw/start-gateway.sh
chown openclaw:openclaw /opt/openclaw/start-gateway.sh

2.添加开机任务

在 root 用户下执行：

crontab -e

# 如果是第一次用 crontab，选 `1` 用 nano 编辑

在文件最后添加这一行

@reboot /opt/openclaw/start-gateway.sh >> /var/log/openclaw-gateway.log 2>&1

按 Ctrl + O，回车保存，Ctrl + X 退出

3.立即启动 Gateway

在 root 用户下执行：

/opt/openclaw/start-gateway.sh &

4.查看是否启动成功

sleep 3 && sudo -u openclaw bash -c 'source /opt/openclaw/.openclaw/.env && openclaw gateway status'

看到 Listening: 127.0.0.1:18789 说明成功。

十.常用命令速查

| 操作 | 方案 A（systemd） | 方案 B（crontab） | | ------------ | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | 查看状态 | systemctl status openclaw-gateway.service | sudo -u openclaw bash -c 'source /opt/openclaw/.openclaw/.env && openclaw gateway status' | | 启动 | systemctl start openclaw-gateway.service | /opt/openclaw/start-gateway.sh & | | 停止 | systemctl stop openclaw-gateway.service | pkill -f "openclaw gateway" | | 重启 | systemctl restart openclaw-gateway.service | pkill -f "openclaw gateway" && /opt/openclaw/start-gateway.sh & | | 查看日志 | journalctl -u openclaw-gateway.service -n 50 | tail -50 /var/log/openclaw-gateway.log | | 实时日志 | journalctl -u openclaw-gateway.service -f | tail -f /var/log/openclaw-gateway.log | | Gateway 状态 | sudo -u openclaw bash -c 'source /opt/openclaw/.openclaw/.env && openclaw gateway status' | 同左 | | 健康检查 | sudo -u openclaw bash -c 'source /opt/openclaw/.openclaw/.env && openclaw health' | 同左 | | 查看版本 | openclaw --version | 同左 | | 初始化向导 | sudo -u openclaw bash -c 'source /opt/openclaw/.openclaw/.env && openclaw onboard' | 同左 | | 创建备份 | sudo -u openclaw bash -c 'source /opt/openclaw/.openclaw/.env && openclaw backup create' | 同左 | | 健康诊断 | sudo -u openclaw bash -c 'source /opt/openclaw/.openclaw/.env && openclaw doctor' | 同左 |

十一.常见问题

Q1: 安装脚本报 command not found

说明 OpenClaw 安装到了非标准路径。找到它：

find /opt/openclaw -name "openclaw" 2>/dev/null

然后创建快捷方式：

ln -s /opt/openclaw/.npm-global/bin/openclaw /usr/local/bin/openclaw

Q2: 服务启动失败？

先查看 Gateway 状态：

sudo -u openclaw bash -c 'source /opt/openclaw/.openclaw/.env && openclaw gateway status'

方案 A 用户查看 systemd 日志：

journalctl -u openclaw-gateway.service -n 50

方案 B 用户查看日志：

tail -50 /var/log/openclaw-gateway.log

Q3: 怎么完全卸载？

# 1. 停止服务

systemctl stop openclaw-gateway.service 2>/dev/null || pkill -f "openclaw gateway"
systemctl disable openclaw-gateway.service 2>/dev/null

# 2. 删除 systemd 服务文件（如有）

rm /etc/systemd/system/openclaw-gateway.service 2>/dev/null
systemctl daemon-reload 2>/dev/null

# 3. 删除 crontab 开机任务（如有）

crontab -l 2>/dev/null | grep -v "start-gateway.sh" | crontab - 2>/dev/null
rm /opt/openclaw/start-gateway.sh 2>/dev/null

# 4. 卸载 OpenClaw（保留配置和会话）

sudo -u openclaw bash -c 'source /opt/openclaw/.openclaw/.env && openclaw uninstall' 2>/dev/null

# 5. 删除用户和目录（谨慎，会删除所有数据！）

userdel openclaw 2>/dev/null
rm -rf /opt/openclaw
rm -rf /var/tmp/openclaw-compile-cache

在同一个服务器上部署两个项目时，宝塔面板一键申请SSL证书的时候，会因为重定向问题导致验证失败，所以我学习了手动部署SSL证书的方法，做了这个笔记，以docker部署的项目为例（本文的Nginx是在主机上，监听的是主机端口），通过本文，可以确保申请的证书独立对应域名，让Nginx正确处理域名分流

一.确定docker映射到宿主机的端口

1. 理解端口映射

127.0.0.1:8088->80/tcp
        ↓       ↓  ↓
   主机端口 →  容器  协议
              端口

含义：访问主机的 8088 端口 => 转发到容器的 80 端口

2. 找到需要代理的端口，终端执行以下命令

docker ps --format "table {{.Names}}\t{{.Ports}}"

找到要对外访问的容器，记下它的主机端口（冒号左边的数字）

二.创建 Nginx 配置文件

假设：

• 你的域名：yourdomain.com
• Docker 容器映射的主机端口：8088

1. 创建配置文件

nano /usr/local/nginx/conf/conf.d/yourdomain.com.conf

2. 粘贴以下内容**（只需要把 yourdomain.com 和 8088 改成实际的值即可）**

server {
    listen 80;
    server_name yourdomain.com;

    location /.well-known/acme-challenge/ {
        root /var/www/acme;
    }

    location / {
        return 301 https://$host$request_uri;
    }
}

server {
    listen 443 ssl;
    http2 on;
    server_name yourdomain.com;

    ssl_certificate /usr/local/nginx/conf/ssl/yourdomain.com/fullchain.pem;
    ssl_certificate_key /usr/local/nginx/conf/ssl/yourdomain.com/key.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers EECDH+CHACHA20:EECDH+CHACHA20-draft:EECDH+AES128:RSA+AES128:EECDH+AES256:RSA+AES256:!MD5;
    ssl_prefer_server_ciphers on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
    add_header Strict-Transport-Security "max-age=31536000";

    location / {
        proxy_pass http://127.0.0.1:8088;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 300s;
    }
}

三.申请 SSL 证书

以 Let's Encrypt 证书为例！Let's Encrypt 是全球最受信赖的免费 CA，浏览器默认信任

1. 先创建目录

mkdir -p /var/www/acme
mkdir -p /usr/local/nginx/conf/ssl/yourdomain.com

2. 申请 Let's Encrypt 证书

/root/.acme.sh/acme.sh --issue -d yourdomain.com -w /var/www/acme --keylength ec-256 --server letsencrypt

参数说明： | 参数 | 含义 | |------|------| | -d yourdomain.com | 要申请证书的域名 | | -w /var/www/acme | HTTP 验证目录（acme.sh 会在这个目录创建验证文件） | | --keylength ec-256 | 使用 ECDSA 256 位加密（更快更安全） | | --server letsencrypt | 指定使用 Let's Encrypt安装证书 |

3. 安装证书到目录

/root/.acme.sh/acme.sh --install-cert -d yourdomain.com \
  --key-file /usr/local/nginx/conf/ssl/yourdomain.com/key.pem \
  --fullchain-file /usr/local/nginx/conf/ssl/yourdomain.com/fullchain.pem \
  --reloadcmd "nginx -s reload"

四.证书到期更新

Let's Encrypt 的免费证书有效期是 90 天。安装的时候设置了--reloadcmd所以acme.sh 会在证书到期前 30 天自动续期，所以一般情况下不需要手动操作,安装时候就会自动设置定时任务每天检查

1. 确认自动续期已配置

# 终端执行命令

crontab -l | grep acme.sh

# 正常输出，这是每天13点02分自动执行

2 13 \* \* \* "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null

2. 查看证书到期时间

# 查看所有证书

/root/.acme.sh/acme.sh --list

# 查看单个证书详情

/root/.acme.sh/acme.sh --info -d 你的域名

3. 如果没有正确设置到定时任务自动续期，可以手动续期

# 强制续期（忽略是否到期）

/root/.acme.sh/acme.sh --renew -d 你的域名 --force

# 手动续期所有证书

/root/.acme.sh/acme.sh --cron --home "/root/.acme.sh"

五.测试并生效

1. 测试配置

/usr/local/nginx/sbin/nginx -t

2. 看到这些就对了：

nginx: the configuration file /usr/local/nginx/conf/nginx.conf syntax is ok
nginx: configuration file /usr/local/nginx/conf/nginx.conf test is successful

3. 重启 Nginx

/usr/local/nginx/sbin/nginx -s reload

六.多个项目如何确保网站不互串

1. 检查现有配置

ls -la /usr/local/nginx/conf/conf.d/

应该看到如下配置文件：

first.top.conf
second.top.conf
third.com.conf

2. 每个配置文件里的关键区别

| 网站 | server_name | proxy_pass | | ---------- | ------------ | ----------------------- | | first.top | first.top | http://127.0.0.1:8317 | | second.top | second.top | http://127.0.0.1:8088 | | third.com | third.com | http://127.0.0.1:8000 |

只要 server_name 不同，Nginx 就会精准匹配，互不干扰！

3. 所以同一个服务器部署多个网站对应多个域名时，只需要在创建配置文件时候，正确填写对应的域名即可

# 1. 创建配置（改域名和端口）
nano /usr/local/nginx/conf/conf.d/实际域名.conf

# 2. 申请证书（改域名，必须加 --server letsencrypt）
/root/.acme.sh/acme.sh --issue -d 实际域名 -w /var/www/acme --keylength ec-256 --server letsencrypt

# 3. 安装证书（改域名）
/root/.acme.sh/acme.sh --install-cert -d 实际域名 \
  --key-file /usr/local/nginx/conf/ssl/实际域名/key.pem \
  --fullchain-file /usr/local/nginx/conf/ssl/实际域名/fullchain.pem \
  --reloadcmd "nginx -s reload"

# 4. 测试并重载
/usr/local/nginx/sbin/nginx -t && /usr/local/nginx/sbin/nginx -s reload

七.一键配置脚本

整个流程相对来说不是很复杂不是很麻烦，但为了更加方便，我写了一键部署脚本，前提是nginx是通过编译安装的，当然里面也包含了一键安装nginx的脚本，目前已经开源，开源地址vps_tools

1.使用方法

# 克隆仓库

git clone https://github.com/super-mortal/vps_tools.git

# 进入目录

cd vps_tools

# 给脚本添加执行权限

chmod +x ssl_cert.sh

# 运行交互式脚本

./ssl_cert.sh

2.注意事项

# 先确认 443 端口真的是 Nginx 在监听
ss -tulnp | grep 443
# 查看 ufw 状态（Debian/Ubuntu）
ufw status
# 放行443端口（TCP协议，HTTPS标准端口）
ufw allow 443/tcp
# 重载防火墙规则，使配置生效
ufw reload
# 再次验证规则是否添加成功
ufw status

八.常见问题

Q: 申请证书报错 "Can't find directory"

mkdir -p /var/www/acme

Q: 申请证书报错 "Domain is not point to this server"

域名 DNS 还没生效，等几分钟再试。或者检查域名 A 记录是否指向当前服务器 IP。

Q: HTTPS 能访问但显示不安全

1. 检查证书是不是 Let's Encrypt：

   openssl x509 -in /usr/local/nginx/conf/ssl/你的域名/fullchain.pem -noout -issuer
   

   应该显示 Issuer: C = US, O = Let's Encrypt

2. 如果不是 Let's Encrypt，可能是其他的证书不受浏览器信任所以还是显示不安全，删除重新申请：

   /root/.acme.sh/acme.sh --remove -d 你的域名
   /root/.acme.sh/acme.sh --issue -d 你的域名 -w /var/www/acme --keylength ec-256 --server letsencrypt
   

3. 如果是 Let's Encrypt 的证书但仍然显示不安全，可能是浏览器缓存了旧的证书

1. 清除普通缓存

- 菜单 → 隐私和安全 → 清除浏览数据

- 勾选上述两项，清除

2. 清除HSTS（强制HTTPS策略）

**地址栏输入**

- Chrome： chrome://net-internals/#hsts 

- Edge： edge://net-internals/#hsts 

- 找到 Delete domain security policies

- 输入域名（如 example.com ）→ Delete

3. 清除单个网站HTTPS缓存（精准）

- 打开网站 → 地址栏左侧锁图标 → 网站设置 → 清除数据

打个比喻，你去饭店吃饭，前台问你定的哪个包间，这个前台在服务器上就叫 Nginx

| 餐厅前台 | 服务器 Nginx | | ---------------- | -------------------- | | 接待来吃饭的顾客 | 接待访问网站的用户 | | 问顾客订哪个包间 | 根据域名区分请求 | | 带顾客到包间 | 把请求转发给后端程序 | | 把菜端给顾客 | 把处理结果返回给用户 |

二.Nginx 在服务器中起什么作用？

1. 先看看没有 Nginx 会怎样

2. 有 Nginx 之后

用户访问网站
           ┌───────────────────────────┐
           │        服务器              │
           │                           │
           │   ┌─────────────┐         │
           │   │  Nginx      │         │
           │   │  (前台)      │         │
           │   └──────┬──────┘         │
           │          │                │
           │          ↓                │
           │   ┌────────────┐          │
           │   │ 后端程序    │          │
           │   │ (厨师)      │          │
           │   └────────────┘          │   ->返回网页给用户
           └───────────────────────────┘

Nginx 专门负责"接待"，后端程序专门负责"做菜"，各司其职！

3. 更深层次理解Nginx 具体干什么

┌──────────────────────────────────────────┐
│                Nginx 的工作               │
├──────────────────────────────────────────┤
│  1️⃣  接收请求                             │
│      用户访问 → Nginx 先收到               │
│                                          │
│  2️⃣  区分域名                             │
│      first.com → A网站                    │
│      second.com → B网站                   │
│      third.com → C网站                    │
│                                          │
│  3️⃣  反向代理                             │
│      把请求转发给后端程序                   │
│                                          │
│  4️⃣  处理 HTTPS                          │
│      加密解密，证书验证                    │
│                                         │
│  5️⃣  提供静态文件                         │
│      图片、CSS、JS                       │
│                                         │
│  6️⃣  返回结果                            │
│      返回结果给用户                       │
└────────────────────────────── ──────────┘

4. 前台可以同时接待很多客人，Nginx也可以同时处理不同的用户请求

一个前台（Nginx），同时接待多个人：

访客1 ──→ 前台 ──→ A网站
访客2 ──→ 前台 ──→ B网站
访客3 ──→ 前台 ──→ A网站    ->高效处理

三.Nginx配置中的核心概念

1. 什么是server？

server = 一家公司/一个网站

server {
    server_name first.com;
    # 这就是 first.com 这个网站
}

server {
    server_name second.com;
    # 这就是 second.com 这个网站
}

同一个服务器上部署多个不同的服务，分别绑定对应的域名时，这里的server_name就是对应的域名，通过这个配置，Nginx就可以清楚的知道用户需要访问的是哪个服务，比如用户输入的是second.com，Nginx就会去找second.com对应的配置文件对应的服务然后返回给用户，而不会返回first.com域名对应的服务，这就是多域名共用一个服务器（域名分流）

2. 什么是 location？

location = URL 路径/部门

server {
    server_name first.com;

    location / {
        # 处理 first.com/ 的请求
    }

    location /api {
        # 处理 first.com/api 的请求
    }
}

3. 什么是 proxy_pass？

proxy_pass = 转交/外包

location / {
    proxy_pass http://127.0.0.1:3000;
    # 这个请求我不处理了
    # 转交给 http://127.0.0.1:3000
}

四.Nginx在服务器中的目录

• 一般情况下Nginx的安装目录

/usr/local/nginx/                    ← Nginx 安装目录
    │
    ├── conf/                        ← 配置文件目录
    │   │
    │   ├── nginx.conf               ← 主配置文件（不用改）
    │   │
    │   └── conf.d/                  ← ⭐ 网站配置放这里
    │       │
    │       ├── first.top.conf
    │       └── second.top.conf
    │
    ├── logs/                        ← 日志目录
    │   │
    │   ├── access.log               ← 访问日志（谁来过）
    │   └── error.log                ← 错误日志（出过错）
    │
    └── sbin/                        ← 可执行文件
        │
        └── nginx                    ← 启动命令

• SSL 证书存放目录

/usr/local/nginx/conf/ssl/            ← ⭐ SSL 证书放这里
    │
    ├── first.top/                    ← first.top 网站的证书
    │   │
    │   ├── fullchain.pem             ← 完整证书链
    │   └── key.pem                   ← 私钥
    │
    └── second.top/                   ← second.top 网站的证书
        │
        ├── fullchain.pem
        └── key.pem

• 快速查看命令

# 查看 Nginx 配置文件位置
ls -la /usr/local/nginx/conf/

# 查看所有网站配置
ls -la /usr/local/nginx/conf/conf.d/

# 查看 SSL 证书
ls -la /usr/local/nginx/conf/ssl/

# 查看日志
tail -f /usr/local/nginx/logs/access.log
tail -f /usr/local/nginx/logs/error.log

# 查看正在运行的 Nginx
ps aux | grep nginx

# 重启 Nginx
/usr/local/nginx/sbin/nginx -s stop
/usr/local/nginx/sbin/nginx

五.一个请求的完整旅程

以docker部署的服务为例，当你访问 https://first.top 时：

第1步：DNS 解析
    你输入 https://first.top
    DNS 服务器说：IP 是 1.2.3.4.55

第2步：连接服务器
    浏览器连接到 1.2.3.4.55:443

第3步：Nginx 接待
    Nginx 收到请求
    看看是哪个域名 → first.top
    找对应的配置 → first.top.conf

第4步：处理 HTTPS
    用 first.top 的 SSL 证书加密通信

第5步：反向代理
    把请求转发到 Docker 容器的 8088 端口

第6步：Docker 容器处理
    容器里的 nginx 再转发
    给 nav-site-nodejs 处理

第7步：返回结果
    网页返回给 Nginx
    Nginx 返回给浏览器
    浏览器显示页面

六.总结

所以在服务器中，Nginx主要负责这些工作（仅本文提到）

1. 域名分流：一个服务器对应多个域名多个网站服务，看域名转发给不同的服务
2. 静态资源处理：直接返回图片、JS、CSS，减轻后端压力
3. 反向代理：把请求转给后端服务（如Java、Node.js），隐藏真实端口
4. HTTPS加密：配置SSL证书，实现安全访问

关键目录速查

| 用途 | 目录 | | ------------ | --------------------------------------- | | Nginx 主配置 | /usr/local/nginx/conf/nginx.conf | | 网站配置 | /usr/local/nginx/conf/conf.d/***.conf | | SSL 证书 | /usr/local/nginx/conf/ssl/域名/ | | Nginx 日志 | /usr/local/nginx/logs/ | | 启动命令 | /usr/local/nginx/sbin/nginx |

一.标题

#和标题之间要加一个空格，最多六级标题

# 一级标题

## 二级标题

二. 换行

在一行末尾添加两个空格或使用 HTML的<br> 标签实现段内换行：

这是第一行  
这是第二行

三. 强调

| 语法 | 效果 | | -------------- | ------------ | | **粗体** | 粗体 | | *斜体* | 斜体 | | ***粗斜体*** | 粗斜体 | | ~~删除线~~ | ~~删除线~~ |

四. 引用块

>和引用内容之间需要加一个空格，可以多行引用和嵌套引用

嵌套引用：

> 外层引用
>
> > 嵌套引用

五. 列表

无序列表

可用 -、*、+ 三种符号，效果相同，一样需要加空格

- 项目一
- 项目二
  - 子项目（缩进2个空格）
    - 更深层（缩进4个空格）

• 项目一
• 项目二
  • 子项目
    • 更深层

有序列表

输出1.然后按空格

1. 第一项
2. 第二项
3. 第三项
   1. 子列表
   2. 子列表

任务列表

- [x] 已完成
- [ ] 未完成
- [ ] 另一个未完成

• [x] 已完成
• [ ] 未完成
• [ ] 另一个未完成

六. 代码

行内代码

左右两个反引号包裹内容

`console.log('hello')`

代码块

使用三个反引号包裹，并可指定语言：

​`javascript
function hello() {
  console.log('Hello!');
}
​`

七. 分隔线

使用三个或以上的 -、*、_：

---
---

---

八. 链接

[超级凡人](https://supermortal.cn)

超级凡人

九. 图片

![替代文字](图片URL)

十. 表格

| 表头1  | 表头2 |  表头3 |
| :----- | :---: | -----: |
| 左对齐 | 居中  | 右对齐 |
| 内容1  | 内容2 |  内容3 |

| 表头1 | 表头2 | 表头3 | | :----- | :---: | -----: | | 左对齐 | 居中 | 右对齐 | | 内容1 | 内容2 | 内容3 |

对齐说明：

• |:---| 左对齐
• |:---:| 居中
• |---:| 右对齐

十一. 嵌入视频

YouTube

<iframe width="560" height="315" src="https://www.youtube.com/embed/视频ID" frameborder="0" allowfullscreen></iframe>

Bilibili

<iframe src="//player.bilibili.com/player.html?bvid=BV号&page=1" width="560" height="315" frameborder="0" allowfullscreen></iframe>

快速参考

| 功能 | 语法 | | :----: | :--------------: | | 标题 | # - ###### | | 粗体 | **文字** | | 斜体 | *文字* | | 删除线 | ~~文字~~ | | 链接 | [文字](URL) | | 图片 | ![文字](URL) | | 代码块 | ```语言 ``` | | 引用 | > | | 列表 | - 或 1. | | 分隔线 | --- |

2026-09-06： 博客全面升级：支持自定义 slug ，增加 AI 支持等

2026-03-17： 新博客成立，使用 Astro 框架 astro-theme-pure 模板构建

2026-01-28： 博客迁移重构，使用 Astro 框架 Firefly 模板重新构建

2025-11-24： 博客正式成立，使用 typecho 框架的 wayxz 主题构建