今天是 publishing-system 上线以来最充实的一天。我们一边修 Bug,一边做了一次大规模的数据清理与统一。最重要的成果是修复了第三方脚本调用 API 时遇到的一个老问题:用户直接用 curl 或者 urllib 去打 ws 网站的接口,遇到 401 错误时往往拿不到任何错误信息,根本不知道是 token 不对、IP 被屏蔽、还是时间戳过期。
我们的修法是新增了一个 /api/hermes/v1/health 的公开端点,不要求任何认证,专门用于探活。返回结构里带上了 auth_required_for 字段,列出了所有需要认证的接口路径。第三方脚本现在可以先调 /health 确认通道畅通,再决定要不要走 HMAC 签名流程。改动只有一个新文件,30 行代码,但端到端跑了 7 个场景全部通过,包括用 Python urllib.request 模拟真实脚本的调用。

图1是 ws 网站修复后的主页截图。可以看到每篇文章下方的摘要(entry-summary)长度现在完全一致,都是 77 个中文字符 + “…”,整体节奏比之前协调了很多。之前的摘要有长有短,最短的只有 18 个字,最长的有 270 字节,视觉上参差不齐。今天批量重写后,所有摘要都被裁剪或补全到 80 字符(77 中文字 + 3 字符省略号)。
第二件事是修复了一篇重要的历史遗留文章:id=19《OpenClaw 中 MCP 协议与 SKILLS 的协同实战》。这篇在 5-28 第一批迁移时过来,分类被错填成了”用户故事”(category_id=4),但原文实际上是”OpenClaw 教程”。slug 也错——早期版本的 slugify 工具把中文全删了,英文词又黏在一起,生成了一个很奇怪的长串。今天我们直接 SQL 修复了 category、slug、并补全了 4 个标签。现在按 temp 源 URL /posts/openclaw-mcp-skills-context-engineering 就能正确访问。
图2是 ws 网站”OpenClaw 教程”分类页的截图。修复前 MCP 那篇根本不会出现在这里(因为分类错),修复后能在分类页第一篇就看到。这就是为什么用户报告”在分类列表里看不到这篇文章”——不是迁移失败,是迁移时分类写错了。直接动 SQL 修最干脆(HermesAgent 同标题查重会跳过,而且图片下载走 https 本地会卡 SSL 校验)。

第三件事是数据清理。我们列出了 ws 数据库里所有疑似测试的文章,删除了 3 篇:id=1《测试文章》、id=13《为你的硬件找到最佳本地 LLM》(标题含”基准测试”被搜索关键词误中)、id=23《Hermes publishing-system 接收端测试》。但保留了 6 篇【开发日志】(id=34-44),用户希望这些留作透明度说明,让用户能看到我们是怎么一步步把 publishing-system 做出来的。删除后已发布文章从 28 篇降到 25 篇。
第四件事是全文摘要统一规则。之前只有开发日志要求”77 中文字符 + 省略号”,今天我们把这个规则推广到所有已发布文章,用 Python 脚本从每篇 content 里提取前 77 个中文字符(含中文标点),末尾追加 “…”。规则是只算中文字符 + 中文标点,不算英文字母和数字——这意味着英文品牌名(如 Claude Code、ChatGPT、Anthropic)会被跳过,少数摘要开头会有点”残”。但用户已确认接受这个副作用,因为严格遵循 77 字规则比摘要的语法完整更重要。
图3是 修复后的 MCP 文章页截图。可以看到文章顶部显示”OpenClaw 教程”分类,标题”OpenClaw 中 MCP 协议与 SKILLS 的协同实战:从原理到 Agent 落地”完整呈现,下方标签栏(如果页面有渲染标签)会显示 OpenClaw、AI Agent、MCP 协议、SKILLS 四个标签。这就是我们想要的效果:分类正确、URL 跟 temp 源一致、标签齐全。

最后还顺手配通了 hk 服务器的 GitHub deploy key。之前 hk 端 git fetch origin 会报 Permission denied (publickey),因为默认 id_ed25519 不在 GitHub。专门给 publishing-system 配的 deploy key 在 ~/.ssh/github_key,配上 core.sshCommand 之后,后续部署再也不用每次都加 GIT_SSH_COMMAND= 前缀了。
今天一共 3 个 git 提交推到了 GitHub(v7.5 health 端点 + 2 个 docs),hk 服务器的 publishing-system 也已重启生效。明天我们计划把 generateExcerpt() 函数加到服务层,新迁的文章就不用再手动补摘要了。
关于作者:WoodStone,技术爱好者,专注于 AI 和 Web 开发。
记录时间:2026年6月4日
OpenClaw—AI研究