掘金技能集

核心用法

Juejin Skills 是一款面向掘金技术社区（juejin.cn）的自动化操作工具，提供三大核心能力：

1. 热门文章排行榜：查询全站或指定分类（前端/后端/AI等）的热门文章，支持按3天/7天/30天/历史维度筛选趋势。

2. Markdown 文章发布：通过 Playwright 浏览器登录获取 Cookie，将本地 Markdown 文件一键发布至掘金，支持设置分类、标签、摘要和封面图。

3. 文章下载：通过文章 URL 单篇下载或批量下载指定作者的全部文章，自动转换为 Markdown 格式并保留元数据。

显著优点

• 自然语言驱动：无需记忆命令，直接对话即可触发功能。
• 双层安全发布：API 层默认 save_draft_only=True，CLI 层需环境变量+交互确认，大幅降低误发风险。
• 凭证隔离：Cookie 以 0600 权限存储于本地，支持随时手动撤销。
• 域名白名单限制：图片下载、网络访问均严格限定于掘金官方域名，防范 SSRF。

潜在局限

• 依赖 Playwright 浏览器自动化，首次使用需安装 Chromium，环境较重。
• Cookie 以明文 JSON 存储，虽权限受限但仍存在本地泄露风险，不适合共享/CI 环境。
• 仅支持掘金官方 API 覆盖的功能，不支持评论、点赞等社交操作。

适合人群

• 掘金内容创作者，需批量管理或备份文章。
• 技术编辑团队，需监控热门趋势或快速分发内容。
• 开发者希望将掘金发布集成到本地 Markdown 写作工作流。

常规风险

• 凭证泄露：Cookie 文件若被复制，攻击者可完全控制账号。
• 误操作发布：虽有多层保护，但强制绕过确认参数仍可能导致意外公开。
• API 变更：掘金接口调整可能导致功能失效，需关注上游更新。

核心用法

Juejin Skills 是一款面向掘金技术社区的一站式操作工具，通过自然语言指令即可激活三大核心功能：

热门文章排行榜：支持获取掘金全站或指定分类（前端、后端、Android、iOS、人工智能等）的热门文章趋势，可按3天/7天/30天/历史等时间维度筛选，帮助开发者快速把握技术社区动态。

文章自动发布：通过 Playwright 浏览器自动化完成扫码/密码登录，将本地 Markdown 文件一键发布至掘金平台。支持设置文章分类、标签、摘要和封面图，默认保存为草稿模式，公开发布需多重确认。

文章下载：支持单篇或批量下载掘金文章并转换为标准 Markdown 格式，保留标题、作者、发布时间、标签等元信息，可选下载文章图片到本地，便于离线归档和内容学习。

显著优点

1. 安全设计完善：采用 API 层双标志拦截器（save_draft_only=True + allow_public_publish=False）、CLI 层三重确认机制（命令行开关 + 环境变量 + 交互式确认），有效防止误操作导致的意外公开发布。

2. 来源可信度高：作者 wscats（enoyao）为腾讯员工，GitHub 账号创建于 2016 年，拥有 2861 粉丝和 105 个公开仓库，代码质量经社区长期检验。

3. 网络访问受限：所有请求严格限定于掘金官方域名（juejin.cn、api.juejin.cn），图片下载实施域名白名单校验，有效防止 SSRF 攻击。

4. 依赖安全可靠：仅依赖 httpx、markdownify、playwright、beautifulsoup4、lxml 等知名开源库，无已知 CVE 漏洞。

潜在缺点与局限性

1. Cookie 明文存储：会话凭证以明文 JSON 保存于 ~/.juejin_cookie.json，虽设置 0600 权限仅所有者可读写，但仍存在系统被入侵后的泄露风险。

2. 网络权限声明宽泛：SKILL.md 中声明 network:all，虽实际代码有域名限制，但权限声明层面未遵循最小权限原则。

3. 缺乏速率限制保护：代码中未显示实现 API 调用速率限制，高频调用可能触发掘金平台限流或封禁。

4. 裸异常捕获：部分代码使用 except Exception 捕获异常，可能掩盖潜在问题，不利于调试和错误定位。

适合的目标群体

• 技术内容创作者：需要批量管理掘金文章、自动化发布流程的博主和技术写作者
• 开发者社区运营者：需要追踪热门技术趋势、分析内容数据的社区运营人员
• 技术学习者：希望批量下载优质技术文章进行离线学习和知识归档的开发者
• 多平台内容分发者：需要将 Markdown 内容一键同步至掘金的技术自媒体作者

使用风险

1. 账号安全风险：Cookie 文件包含掘金账号完整登录态，在共享机器或 CI 环境中使用可能导致账号被盗用。使用后应立即执行 rm ~/.juejin_cookie.json 撤销凭证。

2. 内容误发布风险：虽有多重确认机制，但用户仍需注意审核草稿内容，避免敏感信息泄露。

3. 平台依赖风险：技能高度依赖掘金 API 稳定性，若官方接口变更或限流策略调整，可能导致功能异常。

4. 浏览器自动化依赖：Playwright 需要本地 Chromium 环境，部分精简系统或容器环境可能面临部署兼容性问题。