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 |
README.md
View on GitHub# Rokid 图文发布技能分享包
把 Word、TXT、MD / Markdown 或 HTML 文章发布到 Rokid 开发者论坛;也可给原帖补图、校正图片位置、恢复标题层级与代码块。它是一套让 AI 按步骤执行、检查和交付的工作说明,不是免登录上传程序,也不保证平台审核或活动奖励。
## 如何交给别人使用
1. 发送整个 ZIP,不要只发 `SKILL.md`。解压后应保留 `rokid-article-publisher` 文件夹及其子目录。
2. 接收者在自己的 Codex 中打开该文件夹,请 AI 先读 `SKILL.md`,检查需要的浏览器控制能力是否可用。
3. 如需常用安装,可将整个文件夹复制到个人目录的 `.agents/skills/` 下;仅用于某个项目时,复制到该项目的 `.agents/skills/` 下。若有同名技能,先备份并比较,不要直接覆盖。不要把目录重复套成两层同名文件夹。
4. Codex 通常会自动发现技能;未显示时重新打开 Codex。安装后可在提示中提及 `$rokid-article-publisher`。
本包只交付桌面文件,没有自动安装、登录或授予网站权限。宿主若没有可用的浏览器控制工具,请先按宿主说明配置;不要把登录密码发给分享包作者。
## 可直接复制的使用示例
> 使用 $rokid-article-publisher。把我提供的 Word 发布到 Rokid 开发者论坛,使用内部浏览器,我来登录。保留标题和正文,图片按 Word 的图注顺序放置,恢复章节标题、列表和代码块。板块由我指定。发布前检查图片、链接和可见范围,发布后刷新原帖验证。
> 使用 $rokid-article-publisher。修复我指定的 Rokid 原帖,只补图和调整排版,不新建帖子,不改标题和正文措辞。保留我在网页中做过的修改。若 Word 与原帖有差异,先标出来再处理。
> 使用 $rokid-article-publisher。把 article.md 发布到我指定的 Rokid 论坛板块。配图文件夹与 Markdown 一起提供;保留标题、列表、代码和图注位置,先上传到论坛原生图床,再转成兼容富文本。遇到混排或表格内图片,先说明需要规范的地方,不直接丢图。
> 使用 $rokid-article-publisher。准备 article.txt 的论坛稿,保留原文连续空格、缩进、空行和字面符号,不把它擅自当成 Markdown;先给我本地预览,不发布。
> 使用 $rokid-article-publisher。先准备本地发布材料并校验,不要登录网站、上传或发布。
提供:源文件、目标网站或原帖链接、新发还是修改、是否现在发布、目标板块。账号登录、验证码、缺少的个人资料由使用者完成或明确提供。
## 包含什么
- `SKILL.md`:工作流程与适用边界。
- `references/`:Rokid 编辑器的实测兼容说明及检查方法。
- `scripts/`:Word 图片清单、原 HTML 图片映射、TXT / MD 预处理、MD 图片回填和 Rokid 兼容富文本助手,以及合成测试。
- `requirements-render.txt`:仅 Markdown 转富文本所需的固定版本依赖。
- `agents/openai.yaml`:技能显示信息。
脚本不会联网、登录或点击发布。Word 清单、原 HTML 映射、TXT 纯文本路线和 MD 预处理 / 图片回填只需 Python 3.9+ 标准库;MD 转富文本另需 `markdown-it-py==3.0.0`,按 [富文本说明](references/richtext.md) 在适当虚拟环境安装。依赖安装会访问包源,转换脚本本身不联网;浏览器打开带图预览时可能加载已上传的图片。
TXT 默认使用 `render_richtext.py --literal-txt`;只有明确写成 Markdown 的 TXT 才使用 `prepare_text.py --txt-as-markdown`。MD 支持标题、列表、引用、表格、代码与独立图片段;混排、列表 / 表格内图片、链接包图会暂停,需在工作副本规范或用原生编辑器插入。没有承诺把任意 Markdown 扩展无损一键导入。
所有 MD 图片须经论坛原生上传,回填和渲染时均使用实际观察到的精确 `--allow-host`,没有默认图床放行。MD 的 `RK_IMAGE` 清单与 Word / HTML 的 `IMAGE_1` 清单相互独立,不能混用。脚本输出是核对材料,不等于网页上传成功。运行与检查命令见 [SKILL.md](SKILL.md);测试范围见 [验证记录](references/validation.md)。
## 分享与隐私
本包不附带真实文章、原图、账号、密码、Cookie、验证码、帖子 ID 或用户上传地址。使用中产生的原帖备份、Word 图片、上传映射、联系方式和截图应留在使用者自己的任务目录,不要加入公开分享包。对方须使用自己的账号,并确认拥有文章和配图的发布权。
## 官方说明与兼容性
本包的安装与调用说明参考 [OpenAI 官方技能文档](https://developers.openai.com/codex/skills/),核对日期:2026-09-05。官方建议更广泛的可安装分发使用插件;本包按需求提供可复制的独立技能目录,未注册插件商店。
Rokid 的图片粘贴和排版经验是特定编辑器版本的实测结果,不是永久接口约定。首次在新环境使用时,先用少量内容检查;网站界面变化后应重新核对。
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 |