2026-05-08 Codex 工作记录

2026-05-08 Codex 工作记录

目标

为 HOLT-ZE 个人博客搭建和完善静态站点，并验证思源笔记与 AI/CLI 的联动能力。

今日完成

个人博客与服务器发布

• 阅读本地项目规则和服务器配置，确认不删除或修改本地思源原始数据。
• 搭建静态博客生成流程，从本机思源数据读取文章并生成网站。
• 将个人首页放到 /​，将文章列表迁移到 /articles/。
• 保留文章详情页路径 /articles//。
• 使用 main.jpg​ 生成压缩头像资源 profile.png，同时作为 favicon、Apple touch icon 和 Open Graph 图片。
• 为首页加入个人介绍、技术方向、经历卡片、阶段式生涯折线图与轻量动效。
• 配置并验证线上站点 https://holtze.xin/​ 与 https://holtze.xin/articles/。

文章渲染修复

• 修复思源图片资源在文章页和列表页的展示问题。
• 优化代码块展示样式，加入固定宽度风格的代码区和复制按钮。
• 保留文章标签筛选与代码复制交互。

内容过滤

• 只发布指定笔记本中的内容。
• 过滤数据结构、学校、考研、数学、基础30讲等暂时不希望展示的内容。
• 过滤只影响网站生成结果，不删除本地思源数据。

自动封面系统

• 文章有图片时，列表页优先使用正文第一张图片作为封面。
• 文章没有图片时，根据标题生成封面文字，例如 WSL、Git、Docker、C/C++、1Panel。
• 背景颜色根据更具体的 tag 选择，避免整排只显示栏目名。
• 当前自动封面逻辑位于 scripts/build.mjs​，视觉样式位于 public/styles.css。

README 文档

• 新增项目 README，记录项目结构、内容来源、本地构建、本地预览、上传发布、自动封面系统和写作流程。
• README 中没有记录 token、服务器密码等敏感信息。

Siyuan Skill 安装与测试

• 全局安装社区 siyuan-skill 到 Codex skills 目录。
• 修复该 skill 在 Linux 下的 CRLF 行尾问题。
• 创建全局命令 siyuan，可直接调用思源 API。
• 配置本机思源 API 地址和 token，配置文件权限设为仅当前用户可读写。
• 保持删除保护开启。
• 测试 siyuan notebooks 成功读取思源 3.6.5 中的笔记本列表。
• 测试 siyuan search docker --mode keyword --limit 3 成功返回搜索结果。

当前可用命令

npm run build
npm run serve
npm run publish:dry
npm run publish
siyuan notebooks
siyuan search docker --mode keyword --limit 5

后续建议

• 后续博客写作继续以思源笔记为主，发布时运行 npm run publish。
• 若文章没有合适图片，可先依赖自动封面系统；重要文章再补真实封面。
• AI 调用思源时优先使用搜索、读取、导出类命令，谨慎使用写入、移动和删除类命令。