很多工具的起点都不宏大，往往只是为了去掉一段反复出现、但没有创造性的劳动。

把这件事拆开以后真正需要被自动化的部分其实非常集中：

• 登录态最好能复用，而不是每次重新处理登录流程。
• 分类、标签和热榜信息应该可以直接查询，最好还能给出合理推荐。
• 本地图片需要在发布前完成上传和替换，不能把相对方法带到线上。
• 已发布文章需要支持基于本地稿件继续更新。
• 真正公开发布时应该保留一次明确确认。

于是就有了 juejin-skill。它现在是一套同时面向 Codex 和 Claude Code 的掘金发文 Skill，底层共用一套 Node.js CLI。两个 Agent 的接入方式不同，但最终执行的是同一条发布链路。

这篇文章会按照实现顺序，讲清楚它为什么这样拆、哪些设计后来证明是必要的。出于安全和稳定性的考虑，文中对少量网站内部接口方法、字段名和上传链路细节做了抽象化处理。但整体实现思路与工程结构保持真实。

一、先把能力收敛到 CLI

做 Agent Skill 时很容易先写提示词，让模型去判断“什么时候该发布、什么时候该更新、参数该怎么组装”。这种方式短期能跑，但因为功能变多，维护成本会上升得很快。更稳妥的做法，是先把确定性的动作收敛到 CLI。再让不同网站的 Skill 文档去调用这套命令。不过，

现在 juejin-skill 的命令大致是这几类：

juejin-skill login
juejin-skill verify
juejin-skill categories
juejin-skill tags --category 
juejin-skill hot --limit
juejin-skill publish --file ./article.md --category 
juejin-skill update --article https://juejin.cn/post/ --file ./article.md
juejin-skill download --article https://juejin.cn/post/

CLI 放在 src/commands/cli.js职责尽量保持简单：解析参数、读取文件、组装调用、输出结果。真正的业务逻辑都下沉到 src/core/例如登录、热榜、发布、图片上传、下载等能力都在这一层实现。

这个分层没有复杂设计，价值却非常直接。说起来，Codex Skill 和 Claude Code 命令不需要各写一套发布逻辑。只要约定如何调用 CLI 即可。后续修复 bug、补充参数或调整发布流程时也能保证两个网站的行为保持一致。

二、HTTP 层尽量薄，错误尽量早暴露

掘金的主要操作最终都落在 HTTP 请求上。所以我先写了一个比较薄的 JuejinHttpClient。它主要负责统一请求头、带上本地会话信息，还有处理非成功响应。

export class JuejinHttpClient {
constructor {
this.cookie = cookie;
this.fetchImpl = fetchImpl;
}
async post {
return this.#request(url。{
说到method，"POST",headers,body: JSON.stringify
});怎么说呢，}
}

这里我刻意没有做太厚的封装。 比如自动重试、业务错误猜测、静默降级等。和第三方站点打交道时接口变化、登录失效、参数缺失往往对应完全不同的问题。越早看到状态码和响应片段，排查就越快。如果客户端层过度“聪明”，出问题时反而不容易定位。

对了保留 fetchImpl 这个注入点，是为了让测试更干净。单元测试可以直接替换成假的 fetch。只验证请求结构和分支逻辑，不需要真的访问网站。

User Pain Point:

• 登录失效导致所有后续操作均报错，让人抓狂且难以快速定位原因；
• 接口变动导致工具频繁报错，却没有及时反馈给使用者；
• 缺乏清晰错误提示，使得开发者花费大量时间排查根源。

端点和配置统一收敛在 src/core/config.js。这点看起来普通，但对这类依赖网页端实现细节的工具非常关键。网站调整接口时只改配置层，维护成本会低很多。

三、登录交给浏览器，会话交给本地文件

发布、更新和上传图片都依赖登录态。对使用者最自然的体验不是把账号密码交给工具。而是用浏览器完成正常登录，接下来让程序复用登录结果。

• 手动输入账号密码或扫码过程繁琐，一旦出现验证码无法自动化；
• 每次操作都需重新登录耗时且易忘记更新 Cookie；按理说，
• 会话过期后只能通过 手动执行全部步骤才能恢复使用。其实，

Error Prevention:

• 仅需一次浏览器登陆。即可将 Session Cookie 保存至 ~/.juejin‑skill/session.json；按理说，随后所有命令均可复用此文件；
• 若 Session 失效。只需执行 login 命令即可，无需改动其它逻辑；删除 session.json 可立即撤销本地授权；
• verify 命令可快速校验当前 Session 有效性，从而避免因无效 Cookie 导致 “发布失败” 的尴尬场景。老实说，

四、把分类、标签和热榜纳入同一条工作流

- 发布文章不仅是正文上传。更要确认分类与标签，还有获取受关注内容作为参考。我将查询分类列表、指定分类下推荐标签还有全站或指定分类热榜等辅助能力集成进同一个工具里让发文流程更顺手、更符合实际需求。按理说，

说到使用者痛点，- 缺乏实时数据支持导致选择错误分类 - 手动查找热门趋势耗时 - 对于新手作者而言，对正确标签毫无概念 说到提供方法，- 一键查询所有可选分类及其推荐标签 - 自动匹配关键词并建议最优分类 - 同步热门榜单。为作者提供灵感来源