Skip to content

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

rokid-article-publisher

Verified

将 Word、TXT、Markdown 或 HTML 图文稿发布到 Rokid 论坛,保留配图位置与正文格式,修复原帖缺图和标题排版,并在保存后刷新核对。不用于 AIUI 应用打包或平台提审。

references/md-image-mapping.md

View on GitHub
# 图片回填:按原位置,不按上传完成先后

这个步骤只处理本地文件。脚本不联网、不上传、不读取浏览器登录态,也不能证明图片已发布。浏览器操作必须通过当前会话支持的界面工具完成。

仅适用于 TXT-as-Markdown / MD 的 `prepare_text.py` 清单及 `RK_IMAGE` 占位。Word / HTML 的 `docx_inventory.py` 清单、`{{IMAGE_1}}` 和 `fill_image_map.py` 是另一条保留路线,不接受此映射格式,也不能改字段强行混用。

## 输入与边界

`prepare_text.py` 输出 `article.md`、`manifest.json` 和 `media/`。每次出现一张图片,就得到一个唯一占位符,例如 `{{RK_IMAGE_0001}}`;即使原图相同,也分别保留位置。清单的 `order` 从 1 连续递增。

只有 `blocking_issues` 为空、每张图都是已准备的 `local` 文件且 SHA-256 未变,才可回填。清单还必须有有效的 `baseline.prepared_markdown_sha256`,并与 `article.md` 的原始字节完全匹配;即使图片占位符没变,改正文、换行或给全文套上代码围栏,也会拒绝回填。要修改内容,请改原稿并重新准备,不要手改基线去绕过校验。

远程图片、缺图、越界图片和未确认内容必须先解决:请用户提供有权使用的本地图,改好原稿中的引用后重新准备。不要直接把第三方外链冒充Rokid 论坛托管图片,不要为了通过检查手动清空 blocker。

上传时以清单里的原图、占位符、SHA-256 建立对应关系。在编辑器中逐图或小批上传,确认平台生成的图片与原图一致,再记录平台实际返回并已渲染的图片 URL。异步完成顺序不等于原稿顺序;图片尺寸只能辅助核对,不是唯一识别依据。可重复图片允许共享一条已经核对的 URL。

## hosted-map.json 格式

JSON 顶层键必须恰好覆盖所有占位符,每个值包含 `url` 和可选的 `source_sha256`。推荐填写 SHA-256,来源是清单,不是上传后的压缩文件。对象的键顺序无关紧要,重复键会被拒绝。

以下只是格式说明;示例地址并非真实上传结果,不可用于发布:

```json
{
  "{{RK_IMAGE_0001}}": {
    "url": "https://verified-upload-host.example/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 \
  --allow-host verified-upload-host.example
```

输出文件必须不存在,脚本不会覆盖原稿。成功输出 `ready_for_editor` 表示本地 Markdown 回填完成,不代表已经转换成Rokid 论坛富文本,也不代表发布成功。脚本先完成全部校验,再创建新文件;替换之外的正文、换行和代码字节保持原样。

默认不接受任何图片主机。必须先在本次论坛原生上传后的界面核实图片及准确主机名,再显式添加该主机。不自动信任 Rokid、知乎、CSDN、掘金或云存储的整域及子域;域名符合仍不等于已经证明原生上传。

上面的示例主机必须替换成实际观察到的值;若本次上传确实使用多个不同主机,为每个主机分别传一次 `--allow-host`。下一步 `render_richtext.py` 必须使用同样的主机参数,没有自动继承。没有图片时清单的 `images` 为空、映射使用空 JSON 对象 `{}`,省略主机参数即可保持正文字节不变。

`--allow-host` 只接受准确的小写主机名,不接受通配符、协议、路径或端口;不要根据外观相似直接放行。URL 的签名参数会原样保留,不会擅自去签名、改域名或猜测无签名地址。如果地址含不适合直接放入 Markdown 的未转义字符,脚本拒绝,需从编辑器取得正确的可用地址,不手工改写签名。

以下情况会失败且不输出新稿:缺少有效正文基线、准备后正文被改动、漏图或多余映射、重复键、占位符丢失/重复/错序、未解决 blocker、源图被替换、源图越界、非平台域、危险协议、URL 用户信息、非 443 端口,以及不同源图意外映射成同一条 URL。

## 发布后验收

先按 [richtext.md](richtext.md) 使用 `scripts/render_richtext.py` 处理最终 Markdown,再通过当前界面支持的导入或富文本粘贴进入编辑器;不要把 Markdown 源码直接贴入正文并宣称标题和代码格式已保留。检查标题、各级章节、列表和代码块;发布后刷新真实页面,对照原稿逐图核对位置与图注,再检查图片是否完成加载、尺寸非零。惰性加载图片要滚到相应段落后检查,不能只核对首屏。

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