Skip to content

EasonZhu1997/Eason-Agent-Skills / skills/juejin-article-publisher

juejin-article-publisher

Verified

将 Word、TXT 或 Markdown 文章发布到掘金,或修复指定掘金文章的图片位置与排版。保留标题、正文、代码和图注,原生上传配图并核验发布状态。

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。

## 发布后验收

在当前编辑器中导入或粘贴最终稿,检查标题、各级章节、列表和代码块;发布后刷新真实页面,对照原稿逐图核对位置与图注,再检查图片是否完成加载、尺寸非零。惰性加载图片要滚到相应段落后检查,不能只核对首屏。

总图数相等不等于顺序正确;也不要把草稿中的上传成功视为公开页面显示正常。记录公开链接和实际状态(如“审核中”)。若检查受锁屏、登录或权限限制,明确说明尚未验证的范围。
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall