EasonZhu1997/Eason-Agent-Skills / skills/rokid-article-publisher
rokid-article-publisher
Verified将 Word、TXT、Markdown 或 HTML 图文稿发布到 Rokid 论坛,保留配图位置与正文格式,修复原帖缺图和标题排版,并在保存后刷新核对。不用于 AIUI 应用打包或平台提审。
| File | Kind | Size |
|---|---|---|
| LICENSE | other | 1.0 KB |
| README.md | markdown | 5.1 KB |
| SKILL.md | skill md | 7.9 KB |
| agents/openai.yaml | config | 337 B |
| references/md-image-mapping.md | markdown | 5.4 KB |
| references/richtext.md | markdown | 9.9 KB |
| references/rokid-editor.md | markdown | 10.8 KB |
| references/text-input.md | markdown | 8.7 KB |
| references/validation.md | markdown | 1.9 KB |
| requirements-render.txt | markdown | 22 B |
| scripts/docx_inventory.py | script | 19.7 KB |
| scripts/fill_image_map.py | script | 12.2 KB |
| scripts/finalize_images.py | script | 10.1 KB |
| scripts/prepare_text.py | script | 24.2 KB |
| scripts/render_richtext.py | script | 16.5 KB |
| scripts/test_docx_inventory.py | script | 12.2 KB |
| scripts/test_fill_image_map.py | script | 8.2 KB |
| scripts/test_finalize_images.py | script | 13.0 KB |
| scripts/test_prepare_text.py | script | 19.6 KB |
| scripts/test_render_richtext.py | script | 16.6 KB |
| scripts/test_rokid_text_flow.py | script | 9.1 KB |
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 源码直接贴入正文并宣称标题和代码格式已保留。检查标题、各级章节、列表和代码块;发布后刷新真实页面,对照原稿逐图核对位置与图注,再检查图片是否完成加载、尺寸非零。惰性加载图片要滚到相应段落后检查,不能只核对首屏。
总图数相等不等于顺序正确;也不要把草稿中的上传成功视为公开页面显示正常。记录公开链接和实际状态(如“审核中”)。若检查受锁屏、登录或权限限制,明确说明尚未验证的范围。
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: 194k | 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: 194k | 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: 194k | Updated | Claude CodeCodex | Verified | Install |