EasonZhu1997/Eason-Agent-Skills / skills/juejin-article-publisher
juejin-article-publisher
Verified将 Word、TXT 或 Markdown 文章发布到掘金,或修复指定掘金文章的图片位置与排版。保留标题、正文、代码和图注,原生上传配图并核验发布状态。
| File | Kind | Size |
|---|---|---|
| LICENSE | other | 1.0 KB |
| README.md | markdown | 4.4 KB |
| SKILL.md | skill md | 5.3 KB |
| agents/openai.yaml | config | 310 B |
| references/browser-workflow.md | markdown | 5.0 KB |
| references/image-mapping.md | markdown | 4.7 KB |
| references/text-input.md | markdown | 6.7 KB |
| references/verification.md | markdown | 3.1 KB |
| references/word-input.md | markdown | 3.3 KB |
| scripts/docx_inventory.py | script | 21.4 KB |
| scripts/finalize_images.py | script | 10.1 KB |
| scripts/prepare_text.py | script | 24.2 KB |
| scripts/test_docx_inventory.py | script | 14.2 KB |
| scripts/test_finalize_images.py | script | 11.3 KB |
| scripts/test_prepare_text.py | script | 19.5 KB |
references/image-mapping.md
View on GitHub# 图片回填:按原位置,不按上传完成先后
这个步骤只处理本地文件。脚本不联网、不上传、不读取浏览器登录态,也不能证明图片已发布。浏览器操作必须通过当前会话支持的界面工具完成。
## 输入与边界
`prepare_text.py` 输出 `article.md`、`manifest.json` 和 `media/`。每次出现一张图片,就得到一个唯一占位符,例如 `{{JJ_IMAGE_0001}}`;即使原图相同,也分别保留位置。清单的 `order` 从 1 连续递增。
只有 `blocking_issues` 为空、每张图都是已准备的 `local` 文件且 SHA-256 未变,才可回填。清单还必须有有效的 `baseline.prepared_markdown_sha256`,并与 `article.md` 的原始字节完全匹配;即使图片占位符没变,改正文、换行或给全文套上代码围栏,也会拒绝回填。要修改内容,请改原稿并重新准备,不要手改基线去绕过校验。
远程图片、缺图、越界图片和未确认内容必须先解决:请用户提供有权使用的本地图,改好原稿中的引用后重新准备。不要直接把第三方外链冒充掘金托管图片,不要为了通过检查手动清空 blocker。
上传时以清单里的原图、占位符、SHA-256 建立对应关系。在编辑器中逐图或小批上传,确认平台生成的图片与原图一致,再记录平台实际返回并已渲染的图片 URL。异步完成顺序不等于原稿顺序;图片尺寸只能辅助核对,不是唯一识别依据。可重复图片允许共享一条已经核对的 URL。
## hosted-map.json 格式
JSON 顶层键必须恰好覆盖所有占位符,每个值包含 `url` 和可选的 `source_sha256`。推荐填写 SHA-256,来源是清单,不是上传后的压缩文件。对象的键顺序无关紧要,重复键会被拒绝。
以下只是格式说明;示例地址并非真实上传结果,不可用于发布:
```json
{
"{{JJ_IMAGE_0001}}": {
"url": "https://p3-juejin.byteimg.com/example-only/not-a-real-upload.png?signature=EXAMPLE%2B%2F",
"source_sha256": "填写清单中该图片的64位小写十六进制SHA-256"
}
}
```
真实映射文件属于当前文章的工作材料,不应装入技能分享包。不要把签名 URL、登录态、手机号、账号信息写进可复用技能或测试。脚本的正常输出和校验错误均不回显 URL;最终 Markdown 自然包含发布所需的图片地址,分享前按需要检查。
## 离线回填
在技能目录执行,替换成实际工作目录:
```bash
python3 scripts/finalize_images.py \
--manifest /absolute/work/prepared/manifest.json \
--article /absolute/work/prepared/article.md \
--hosted-map /absolute/work/hosted-map.json \
--output /absolute/work/article.ready.md
```
输出文件必须不存在,脚本不会覆盖原稿。成功输出 `ready_for_editor` 表示本地回填完成,不代表发布成功。脚本先完成全部校验,再创建新文件;替换之外的正文、换行和代码字节保持原样。
默认仅接受 HTTPS 的 `juejin.cn`、`byteimg.com` 及其真正的子域。未来平台若使用其他图床,包括不同的字节 CDN 域名,必须在当前上传后的界面中核实其准确主机名,再显式添加:
```bash
python3 scripts/finalize_images.py \
--manifest /absolute/work/prepared/manifest.json \
--article /absolute/work/prepared/article.md \
--hosted-map /absolute/work/hosted-map.json \
--output /absolute/work/article.ready.md \
--allow-host verified-upload-host.example
```
`--allow-host` 只接受准确的小写主机名,不接受通配符、协议、路径或端口;不要根据外观相似直接放行。URL 的签名参数会原样保留,不会擅自去签名、改域名或猜测无签名地址。如果地址含不适合直接放入 Markdown 的未转义字符,脚本拒绝,需从编辑器取得正确的可用地址,不手工改写签名。
以下情况会失败且不输出新稿:缺少有效正文基线、准备后正文被改动、漏图或多余映射、重复键、占位符丢失/重复/错序、未解决 blocker、源图被替换、源图越界、非平台域、危险协议、URL 用户信息、非 443 端口,以及不同源图意外映射成同一条 URL。
## 发布后验收
在当前编辑器中导入或粘贴最终稿,检查标题、各级章节、列表和代码块;发布后刷新真实页面,对照原稿逐图核对位置与图注,再检查图片是否完成加载、尺寸非零。惰性加载图片要滚到相应段落后检查,不能只核对首屏。
总图数相等不等于顺序正确;也不要把草稿中的上传成功视为公开页面显示正常。记录公开链接和实际状态(如“审核中”)。若检查受锁屏、登录或权限限制,明确说明尚未验证的范围。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |