## OctoHz Publishing Skill 官方公开版。原为私有"我的资源"条目，2026-10-10 正式公开发布，今后以官方资源库这份为唯一权威版本。 > **⚠️ 维护规则**：官方资源库是唯一权威源，本地装的是安装镜像，不得独立演进。MCP：`site_resource{action:"get",id:21}`→编辑→`site_resource{action:"publish_version",...}`+`site_resource{action:"patch",...}`；CLI：`octohz site-resource get/publish-version/patch 21`（管理员权限）。同类规则见官方资源库的 `OctoHz CLI Skill`/`OctoHz MCP Skill`。 Agent skill：OctoHz 内容发布（`octohz publish` / `product patch`）的标准工作流，2026-08 经实测纠偏定型。需配合 `OctoHz CLI Skill` 使用。 ## 安装解压后把 `SKILL.md` 放进你的智能体框架的技能目录（目录名建议 `octohz-publishing`）：DSH 用 `~/.dsh/skills/octohz-publishing/`，Claude Code / Codex 用各自的 `skills/` 目录。 ## 核心规则 - **publish 还是 doc**：「发到octohz / 发个推荐」= `octohz publish`（公开推荐，octohz.com/p/）；「存到我的文档」= `octohz doc add`。发错补救：重新 publish + `doc rm` 删错的 - **先查重**：`product list --url-contains "<关键词>"`（返回 `{items:[...]}` 对象不是扁平数组，用 `.items[]`） - **正文**：markdown 写文件，用 `--description-file`，不内联转义 - **封面图**：无现成图用你能访问的 AI 画图工具现画一张，`--img` 上传，发完 `product get | jq .img` 确认非空 - **分类**：essay(13) / software(4) / film(11) / tutorial(8) / music(71)——**music(71) 只收"一条记录=一首歌的分享链接"这种内容**，卡片渲染固定按单曲播放器处理（按钮永远显示"点击播放"）；歌单/音乐随笔/下载站推荐等非单曲内容别进 music，归 essay(13)。`--buy-text` 填单曲分享链接会自动生成站内播放器，不是普通外链；**2026-10-26 实测（E362）：目前只有网易云真的能播**，含 VIP 曲目（2026-10-25 起改用自建 ncm-api，能完整播放，不再是旧规则"30–45 秒试听"）——**QQ音乐/酷狗链接会生成播放器组件但点播放没反应**（meting-api 解析不出播放地址，原因待查），暂时别发这两个平台链接到 music 分类。**网易云 DJ 电台节目链接（`music.163.com/dj?id=`）也不能直接当单曲填**：dj 节目 id 不是歌曲 id，Meting `type=song` 查不到，buyText 填进去播放器组件照样生成，但点播放返回空数组——必须先 `curl -s 'https://music.163.com/api/dj/program/detail?id=' -H 'User-Agent: Mozilla/5.0' -H 'Referer: https://music.163.com/'` 取出 `program.mainSong.id`，buyText 改填标准长链 `https://music.163.com/song?id=`，发布前用 `curl -s 'https://octohz.com/meting/api?server=netease&type=song&id=' | jq '.[0].url'` 实测确认真的解析出播放地址（别只看命令返回成功）。封面优先用 dj 节目接口的 `coverUrl`——通常是这首歌唯一可用的官方正主图；QQ音乐图库搜同名曲多是其他歌手翻唱封面，歌手名对不上一眼露馅，别用（2026-10 p/3212「织毛衣」实测） - **可见性三档**：默认公开；用户说「只给会员看」加 `--visibility member`（登录会员仍能看到，需 CLI ≥2.14.0，旧式 `--members-only`）；用户说「只给我自己看/真不想被任何人看到」加 `--visibility private`（连会员都看不到，等价"不公开"，需 CLI ≥2.39.0）；事后 `product patch --visibility ` 切换，`product get/list` 的 `visibility` 字段可核对 - **审批**：发布命令**可能**触发审批（取决于客户端策略，并非必然弹窗）；真出现审批超时 = block 且禁止自动重试，不要改写命令绕行 ## 草稿预览（可选，推荐）有目标 URL 时先 `octohz publish --from-url --category --dry-run` 自动抓 og 标签填草稿、只预览不提交，抓不全的字段再手动补，省去来回整理。 ## 更新已发布内容 `product patch --description-file` 是**整体替换**：先取旧文存档 → 局部编辑新文件 → 整体替换 → grep 文尾验证。 ## 实测坑 - `--intro` 上限 100 字符 - CLI 2.3.1 `--img` 上传假报错「封面图只支持 PNG/JPEG/GIF/WEBP」——是版本 bug，升到 2.5.6+ 即可 - `product patch` 返回的 updatedAt 可能为 null，用内容验证 - 服务类推荐每条都要给入口（官网/商店/TG群），没有的要注明获取路径，不编造链接 - `--members-only` 是「会员可见」不是「不公开」：登录会员照样看得到，只是游客/搜索引擎/未登录访问被挡；真不想公开就别发（需 CLI ≥2.14.0，旧版会直接报错、不会悄悄发成公开） - 网易云 DJ 电台节目链接不能当单曲发：`dj?id=` 的 id 是节目 id 不是歌曲 id，直接填 buyText 会"假成功"——播放器组件照常生成，点播放却是空数组，不报错也不提示；必须拆出 `mainSong.id` 换成标准单曲长链，发布前用 meting-api 实测确认真的返回播放地址 ## 版本 1.0.12（2026-11-02）新增可见性第三档 `private`（仅自己可见，需 CLI ≥2.39.0）。此前只有 public/member 两档，`--members-only`/`member` 档登录会员照样能看到，不是真正的"不公开"；用户提出"自己可见"需求后补上 `--visibility public|member|private`，private 才等价于真正的不公开——除作者本人和管理员外，详情页/md/搜索/列表一律当不存在处理（404）。旧式 `--members-only`/`--no-members-only` 仍可用，建议统一改用 `--visibility`。更新内容：核心规则第5条、MCP对照表、可见性速查表（新增 private 行）、Pitfall 6（原先的警告升级为明确指向 private 的解决方案）。 ## 版本 1.0.11（2026-10-27）精简废话：删掉三段纯日期复核注记（2026-09-15/09-26/10-01）——里面的事实（members-only 的 CLI 版本要求、`--from-url`/`--dry-run`、music 分类等）全部跟正文「核心规则」「发布标准流程」重复，没有任何正文没覆盖到的新信息。Pitfall 9 砍掉"2026-10-10 当天连续发布十几个版本"的复发经过叙事，只留"`--title`/`--note` 是两个独立字段，两个都要传"这条可执行规则。全文信息量不变，SKILL.md 正文少了约 15 行。 ## 版本 1.0.10（2026-10-27）新增网易云 DJ 电台节目链接的坑（p/3212「织毛衣」实测）：buyText 直接填 dj 节目 id 会"假成功"——播放器组件照常生成，但 Meting `type=song` 查不到节目 id，点播放返回空数组。必须先调 `music.163.com/api/dj/program/detail?id=` 取出 `mainSong.id`，换成标准单曲长链 `music.163.com/song?id=` 才能播，发布前还要用站内 meting-api 实测一遍确认真的解析出播放地址。顺带补充：dj 节目接口返回的 `coverUrl` 通常是这首歌唯一可用的官方正主图，优先用它，别去 QQ音乐图库搜同名曲（大概率是别的歌手翻唱封面）。 ## 版本 1.0.9（2026-10-26）实测发现三处需要更新：①旧规则"VIP曲目站内只能播30-45秒试听"已过时，网易云自D074起改用自建ncm-api，VIP曲目能完整播放；②新发现QQ音乐/酷狗的分享链接会被识别生成播放器组件，但meting-api解析不出真实播放地址，实测type=url全部404，点播放没反应（见项目归档E362），暂时别发这两个平台链接到music分类；③补充边界说明：music(71)只收单曲链接，歌单/音乐随笔/下载站推荐等非单曲内容应归essay(13)（迁移wangbixi.com博客时发现过这个误用）。 ## 版本 1.0.8（2026-10-11）另一个智能体复核反馈三处：①把 `submit_post` 错误归类成"免鉴权读接口"（跟 `product list` 并列），实际它是需要鉴权的发布写工具，不应该被当成验证身份的测试请求；②MCP 对照表补充 `imageBase64` 传纯 base64（非 data URL）时必须同时带 `imageMimeType`；③澄清分类字段只在 `submit_post` 发布时有效，`product` 的 `patch` schema 里没有 `category`/`categoryId` 可写字段，MCP 侧改不了已发布内容的分类，需要改分类得用 CLI 或网页后台 ## 版本 1.0.7（2026-10-10）用户发现网页版本历史表格"更新内容"列全是空的——维护规则块给的 `publish-version` 命令模板本身没写 `--title`/`updateTitle`，照抄模板发版就会漏传，坑9早就写了这两个字段的区别但模板本身没照着改，这次把模板也补上了，坑9正文补了一句说明这是真实复发过的问题（2026-10-10 当天这几份 skill 自己连续发布十几个版本全程没传过 `--title`） ## 版本 1.0.6（2026-10-10）另一个智能体审查反馈四处问题：①"`product list` 成功 = 验证能发布"是逻辑错误，实测该接口免鉴权、连没配 token 都会成功，改用需要鉴权的 `todo list` 验证身份，并注明鉴权成功不等于有发布权限；②声称 CLI/MCP 任一接入即可但正文示例全是 CLI，补了一张用验证过的 `product`/`submit_post` 真实 schema 写的「MCP 对照」表，并注明 `--from-url`/`--dry-run` 这两个草稿预览选项没有 MCP 等价物；③「更新已发布内容」只核对文档尾部查不出开头/中间的改动漏生效，改成整篇 diff 对比；④查重示例没提默认 `limit=20` 分页、也没说是全站查重还是只查自己发的，都补上了 ## 版本 1.0.5（2026-10-10）按用户选定的重组方案第2步——取消强制串读：Overview 不再要求"先读 octohz-cli skill 获取完整命令参考"，补一段「前置条件（最小够用）」把 token 配置自给自足，发布/修订流程需要的命令本 skill 内已经齐全；只有要用密码库/工作台 AI 生成/智能互通等范围外功能才需要装 CLI/MCP 技能。「安装」小节同步改措辞。 ## 版本 1.0.4（2026-10-10）另一个智能体再审计反馈——上一版只改了三处具体规则，仍残留三处：Overview/安装小节仍写"用户专属工作流偏好"这类框架性措辞；误发后的删除补救直接要求 `doc rm`，没写授权条件，跟 `octohz-cli` 技能"破坏性 rm 需用户明确确认"矛盾；封面图 AI 画图那条"prompt 必须英文"写成了绝对要求。三处都改成按情况判断/按当前用户授权。 ## 版本 1.0.3（2026-10-10）另一个智能体审计反馈：「标题/简介发布前先给用户过目」「发布前提醒用户'马上点批准'」「写作风格」小节，都是某个用户的历史个人偏好，被写成了所有安装者都要照搬的通用规则，审批要求也没按安装者实际环境判断。改成按对方当场要求/实际环境判断，写作风格小节标题和开头加说明——不预设所有人都要照搬同一套文风/流程。 ## 版本 1.0.2（2026-10-10）修正包内 frontmatter 的 `metadata.version` 字段——另一个智能体安装后发现网页显示 1.0.1，但解压出来的包内一直停留在 1.0.0，是之前 publish-version 忘了同步这一行，内容本身无变化。 ## 版本 1.0.0（2026-10-10）官方公开版首发，内容对齐私有版 v1.3.4。本次发布后私有版"我的资源"条目退役，今后只维护这份。 ## 版本 1.3.3（2026-10-02） - **补回从未进正文的坑9**：1.3.1 的更新说明里写着"新增坑9：publish-version 只写 --note 时更新内容栏空白"，但 1.3.0 和 1.3.1 挂的是完全相同的文件（fileUrl 一样），说明那次根本没重新上传文件；1.3.2 也只改了版本号这一行。核实后正文 Pitfalls 一直只有 8 条，坑9 从头到尾只存在于这个版本的更新说明里，装这个 skill 的人从没看到过。现已核实问题本身真实（`--title` 存 `updateTitle`、`--note` 存 `updateNote` 是两个独立字段，网页主要展示 `updateTitle`，只传 `--note` 那一栏确实是空的）并补进正文第9条 ## 版本 1.3.2（2026-10-02） - 修正包内frontmatter的version字段——网页version(1.3.1)跟包内(1.3.0)不一致，是1.3.0→1.3.1那次只patch了网页版本号没重新publish-version，内容本身没问题，这次只改版本号这一行。（1.3.0/1.3.1 两版新增的发布工作流内容——AI工具分类规则/from-url坑/写作风格指南/封面图处理优先级等——没有对应的版本小节记录，这里先补一句说明，不回溯重写） ## 版本 1.2.3（2026-10-01） - 维护规则补充"发布前自救"两步：① 每次 publish-version 前重新 get 一遍，不要用旧本地缓存继续改；② 发布前自己 diff 新旧内容，确认没有意外删掉大段内容再发。直接起因是 1.2.1 覆盖掉别人加的「仅限会员」内容那次真实事故 - **1.2.4（2026-10-02）**：维护规则块里举例的 MCP 调用是收敛前的旧工具名，这次 OctoHz MCP server 当天改成「一个工具+action参数」，顺手把示例改成新写法；publish 流程本体不受影响 ## 版本 1.2.2（2026-10-01） - **修复 1.2.1 的内容回退**：恢复被误删的「仅限会员」整块共 6 处（核心规则第 5 条可见性、可见性速查三行表、表下两条说明、Pitfalls 第 6 条、2026-09-26 复核注、frontmatter description 的 members-only 说明） - 修正两处与实测不符：`--from-url` 不保证填 img；审批并非必然弹窗 - music 分类补一句 VIP 试听说明；补 `## 安装` 小节 ## 复核（2026-10-01） - 发现 `publish` 一直有 `--from-url`（按官方 help 只保证填 name/intro/description/buy-text，og:image 经常为空、img 必须复核）/`--dry-run` 两个选项本 skill 之前没写过，已补（见上「草稿预览」）；新增 music(71) 分类及其播放器用法 ## 复核（2026-09-15） - 现行 CLI 2.13.1：上述命令与参数逐条核对仍然有效；历史 2.3.1 的 `--img` 假报错已不存在。 - 长文随笔（>100 字 / 要标题、简介、Markdown、封面）改用 `publish --category essay`；`essay` 子命令只收 ≤100 字。