用途:将用户明确验收的 Skill 结果整理为事实性公开案例,默认走与手动编辑器相同的已登录网站 API,无需本地 Skill 检出、GitHub 账号、仓库写权限、管理员角色或付费 Session。免费与付费目录 Skill 在其来源接受网站投稿时均支持。
触发条件:用户表示“这个结果不错,加入这个 Skill 的案例并同步官网”“用 skill-add-case 收录刚才的结果”,或英文的 add this accepted result as a skill case / publish this case to the website。不适用于:仅调用其他 Skill 或结果未被验收;结果失败、仍是草稿或无可审阅输出证据;要创建或重设计 Skill(用 lov-skill-creator);只做普通发布而无新案例(用 lov-skill-publisher)。
主要流程:先解析 SKILL_DIR 与 skill.yaml,从已验证的网站 URL 或目录条目确定准确 catalog ID,并运行 python3 "$SKILL_DIR/scripts/submit_case.py" contract CATALOG_ID 读取契约,确认目标、可用性、表单 URL、限制、认证与 Session 策略。随后确认验收(须针对该确切输出,命令成功或 Agent 自评不算验收),记录被验收产物、实际提示词、验证方式与日期,并做脱敏。再准备案例包:python3 "$SKILL_DIR/scripts/submit_case.py" prepare CATALOG_ID --case CASE_JSON --image FINAL_IMAGE --output SUBMISSION_JSON。视觉作品需已验收的最终产物,最多 4 个 PNG/JPEG/WebP,单个 1 MiB、合计 2 MiB、请求 3 MiB。
预览与提交:默认手动交接,把 SUBMISSION_JSON 与已验证 formUrl 交给用户,由其登录导入、预览并确认;在回读结果 URL 前只报告 prepared。直接由 Agent 投稿时,先运行 check(POST dryRun: true,不写入),展示完整包并取得明确同意后,用 check 返回的 payloadFingerprint 执行 publish --confirm REVIEWED_PAYLOAD_FINGERPRINT。任何编辑都需重新审阅。
验证与限制:published 仅确认源提交,cacheRefreshed 独立,二者都不证明渲染;需在未认证状态下读取案例 URL 与父 Skill 页,检查标题、Input → Prompt → Output、全部最终图片与可选公开 Session。Session 为可选,仅接受所有者自愿分享的公开 LovStudio Session,API 拒绝付费 Session、内嵌 session 对象、价格与转录文本。依赖 Python 3.10+(标准库),准备阶段可离线无账号进行;直接投稿需 LovStudio 账号与网络;PyYAML 仅用于源校验;Git/GitHub 与 lov-skill-publisher 仅用于维护者路线。