Blog Publisher

Medium 会员文章（Member-only story）特殊处理：

• 将 Medium URL 拼接到 https://freedium-mirror.cfd/ 后面，再交给 markdown.new。 示例：https://freedium-mirror.cfd/https://alirezarezvani.medium.com/...
• 引用说明中的链接继续保留原始 Medium 链接。

Reddit / 论坛讨论帖特殊处理：

• 抓取评论区时，优先覆盖：赞同并补充经验的、指出风险的、明确反对的代表性声音。

检测到未安装agent-browser时，自行安装并重试抓取

npm install -g agent-browser
agent-browser install  # Download Chromium

Step 2 — 消化与重构（撰写博客）

以资深技术博主的视角，对内容进行深度总结与重构。不要做机械的流水账翻译，而是要判断先行、融入思考、结构灵活。

2.1 写作风格与结构

• 判断先行：开篇直接抛出核心论点或你阅读后的最大启发，摒弃“本文总结了…”等机器味开场白。
• 灵活叙事：不要硬套传统的五段式模板。根据内容顺其自然地展开，如“核心争议 -> 各方观点 -> 我的取舍”，或“痛点 -> 巧妙解法 -> 局限性”。
• 去翻译化与高信息密度：用博主和你对话的语气表达。去除啰嗦的转场（“换言之”、“值得注意的是”），合并冗余段落，直击要害。
• 保留关键骨架：代码片段、核心数据、图表逻辑、关键命令必须准确精炼地保留。

2.2 frontmatter 与文件操作

1. 读取 src/constants.ts，以 FRONTMATTER_TAGS 作为 tags 的唯一来源。
2. 从主题推导简洁的 kebab-case slug（英文优先）。
3. 使用今天的日期作为 date 和 lastUpdated。
4. 检查 content/blog/YYYY-MM-DD--{slug} 是否已存在：
   • 不存在 → 新建
   • 存在且为空 → 复用
   • 存在且非空 → 追加后缀（如 -2）避免冲突
5. 创建文件：content/blog/YYYY-MM-DD--{slug}/index.mdx
6. 正文使用简体中文。
7. 正文开头（紧接 frontmatter 之后）插入引用说明块：

:::note[引用说明]
本文基于 <作者名> 的文章学习与整理：[<标题>](<URL>)。
:::

2.3 必须遵守的硬性约束

1. 术语准确：遇到专有名词、库名、API、核心概念，如果不确定准确的中文习惯叫法，宁可保留英文原词。
2. 站内链接规范：引用本站其他博客文章时，直接使用 slug（如 (/harness-engineering-agent-first)），绝不要添加 /blog/ 前缀。
3. 标题精简：小节标题使用直接的结论或名词短语，不要用冗长的提问或过度铺垫。

Step 3 — 校验

执行 blog-conventions.md 中的校验清单，并且本地验证通过：

cd $BLOG_ROOT
pnpm build:astro

发布前人工复核清单：

• 所有必填 frontmatter 字段均已填写，且 tags 符合 src/constants.ts。
• 目录名格式为 YYYY-MM-DD--{slug}，文件名为 index.mdx。
• 开篇是否做到了判断先行，直接给出了核心价值。
• 表达是否自然流畅，消除了大模型的“整理稿”或“AI翻译工厂”气味。
• 核心技术事实、代码、数据是否准确无误地保留。
• ## / ### 小节标题是否精炼直接。
• 站内博客引用链接是否使用了正确的 slug 格式（不含 /blog/ 前缀）。

Step 4 — 提交并推送

cd $BLOG_ROOT
git status --short
git add content/blog/YYYY-MM-DD--{slug}/
git commit -m 'docs: add post "<文章标题>"'
git push origin main

commit 格式遵循 blog-conventions.md 的规定。

提交边界： 除非用户明确要求，只暂存新建的文章目录，不包含其他文件。

技术博主写作原则