WallBreakerNO4的博客

posts Purpose 博文核心目录，存放所有已发布的博客文章和草稿。这是博客内容的主体，Hugo 将此目录映射为 /posts/ section，自动生成文章列表。文件名以数字前缀排序，控制博文在列表中的显示顺序。此目录通过 Syncthing 与其他设备同步。 Key Files 文件描述 0.my-first-post.md Hello World（2023-11-16），首篇博文，简短的自我介绍 1.TS3.md TeamSpeak 3 客户端使用教程（2023-11-16），VoIP 语音聊天软件使用指南 2.我的博客.md 博客搭建过程记录（2023-11-20），从域名到部署的建站全流程 3.Ubuntu-zsh.md 在 Ubuntu 上安装 zsh 以及高亮、自动补全插件（2023-11-22） 4.Windows下生成并使用密钥登陆Linux.md Windows 下生成并使用 SSH 密钥登录 Linux（2024-06-12） 5.Docker代理.md 如何为 Docker 添加代理（2024-06-13），配置 Docker Daemon 代理拉取镜像 6.使用 Tailscale 组网.md 使用 Tailscale 组网（2024-08-01），NAS 内网穿透与组网方案 7.Tailscale 进阶使用教程 - 子网路由和自建中转.md Tailscale 进阶教程（2025-01-17），子网路由和自建 DERP 中转 8.白嫖腾讯云GPU跑Stable Diffusion WebUI.md 白嫖腾讯云 GPU 跑 Stable Diffusion（2025-01-18），Cloud Studio GPU 使用指南 9.CDS 新生电脑使用指南.md CDS 新生电脑使用指南（2025-07-28），面向新生的电脑使用习惯与工具推荐 Subdirectories 目录用途草稿/ 草稿目录，存放未完成的文章（见草稿/AGENTS.md）垃圾桶/ 空目录，已废弃的文章回收站，当前无内容 .stfolder/ Syncthing 同步标识目录，非项目内容，不要修改 For AI Agents Working In This Directory 命名约定：文件名以数字前缀 + 点号开头（如 0.、1.、9.），数字决定博文在列表中的排序 Frontmatter 约定：使用 YAML 格式（--- 分隔），必填字段为 title、date、draft（false 表示已发布）、author（通常为 WallBreakerNO4）草稿管理：未完成的文章放在草稿/ 子目录，frontmatter 中 draft 设为 true（部分文件使用字符串 "true"） Syncthing 同步：此目录通过 Syncthing 同步，修改文件后注意同步冲突（.sync-conflict 文件）。.stfolder 和 .uuid 是同步标识，不要删除日期格式：date 字段使用 ISO 8601 格式（如 2025-01-17T15:42:00Z），时区为 UTC（Z 后缀）图片引用：博文中的图片使用外部图床 URL（https://image.wall-breaker-no4.xyz/），不存放在本地 Testing Requirements 新增博文后，运行 ./testServer.sh 验证文章能正确渲染（该脚本启用 -D 会同时渲染草稿）发布前确认 draft 字段为 false（布尔值，非字符串）检查 frontmatter 的 date 是否正确，影响文章排序和归档正式部署前运行 hugo 命令（不带 -D），确认草稿不会被构建 Common Patterns 数字前缀排序：{序号}.{标题}.md，序号从 0 开始递增，新文章追加下一个序号 YAML Frontmatter：统一使用 --- 分隔的 YAML 格式，与 archetype 模板的 TOML 格式不同外部图床：所有图片通过 Markdown 图片语法或 figure shortcode 引用外部 URL 草稿隔离：草稿统一放在草稿/ 子目录，与已发布文章物理隔离 Dependencies Internal 依赖 archetypes/default.md 提供新建文章的初始 frontmatter 依赖 layouts/ 和 PaperMod 主题模板渲染文章页面草稿/ 子目录存放未完成内容，完成后移至此目录并修改 draft 为 false External Syncthing（目录同步）外部图床（image.wall-breaker-no4.xyz）