WorkBuddy 技能市场·上架发布全流程（新发 + 重提）

老板 09-29 授权：蒸馏好的 skill 全部由虎子自主发布，做完一个发一个，不用等。本 skill 同时覆盖「首次发布新技能」与「被驳回后重提」两种场景，复用同一套 bsk 浏览器自助流程。

零、首次发布全新 skill（与重提的差异）

• 入口不同：首次发布走 open.workbuddy.cn 左侧「发布技能」（不是列表里的「重新提交」）；重提才走「重新提交」。
• name 不可改：首次填的 name 是终身唯一标识，定下后不能改（09-29 孙子兵法因此被拦一次）。起名规范＝语义清晰、全小写带连字符，且 zip 内目录名、SKILL.md 的 name 字段、市场填的 name 三者完全一致（建议 fengjin-xxx 或个人语义名）。
• version 从 1.0.0 起：首次无"必须大于已存在版本"约束；重提必须 > 已存在版本。
• 类目从第一次就选对（最关键，避免一上来就驳回）：国学/处世/管理类走「商业服务 > 企业管理」（个人账号可发）；工具/效率/软件类走「工具」或「商业服务 > 软件/建站/技术开发」，这两类必须企业认证（法人不在时挂起，等认证后再发）。不确定就先选「商业服务 > 企业管理」。
• 其余步骤（上传 zip、确认信息、提交审核）与下文第三节一致。

一、前置：bsk CLI + 浏览器扩展（一次性）

1. 装 bsk CLI（Windows）：从 GitHub release 下载 bsk-vX.X.X-x86_64-pc-windows-msvc.zip，解压 bsk.exe 到 ~/.local/bin/。v0.3.1 校验和已核过，可用。
2. 启动 daemon（后台持久）：bsk daemon start --foreground 用 Bash run_in_background。每次新开 Bash 调用前 export BSK_AUTO_START=0 避免重复拉起。检查：bsk status --json 看 browsers 列表（目标有 edge/chrome 实例且 browsers 非空＝扩展已连）。
3. 老板装 BrowserSkill 扩展并开权限：Edge/Chrome 商店装 BrowserSkill 扩展；装好后必须在扩展管理页打开「允许访问文件网址」（否则上传被拦，报 Not allowed）。

二、读驳回原因（仅重提场景需要）

1. bsk session start --no-focus（记下 session id，如 jwzw；每次会话断开后需重建）。
2. bsk navigate "https://open.workbuddy.cn" --session <id> → 点登录（李彦林·超管通常自动登录）。
3. 进「技能」列表 → 对每个已驳回技能点「驳回原因」按钮 → bsk get-html --session <id> 抓 DOM，grep text-[var(--wb-color-text-error-default)] 或 驳回|原因 提取原文。
4. 驳回根因常见两类：类目选错（按审核要求的类目重提即可，内容无需改）；内容/版权/质量问题（需改包）。

三、发布/重提流程（每个技能走一遍）

1. 发布：左侧「发布技能」→ 进入「配置技能」上传步。
   重提：列表点该技能的「重新提交」→ 进入「配置技能」上传步。
2. 上传 zip：bsk upload --file <path> --session <id> --ref @e18 --mode drop（input 模式在上传区不激活，drop 才生效）。
   - 包要求：重提时版本号 必须 > 已驳回版本（否则报「版本号必须大于当前最新版本」）；zip 内 name 字段必须和平台原资产完全一致（name 是唯一标识不可改，否则报「name 不一致」）。
   - 改包：源 SKILL.md version: 1.0.0→1.0.1；如从旧 zip 改，注意 name 还原。
3. 上传成功后点「继续」→ 进「确认信息」步。
4. 改/填服务类目（核心）：删掉错误的旧类目（如「教育服务 - 教育信息展示」，点其「删除类目」），点「添加」→ 展开选「商业服务」→ 选二级「企业管理」。
   - 注意：市场展示分类 是另一个字段，不是驳回点，一般不动。
5. 点「继续」→「提交审核」步，确认类目/版本无误 → 点「提交」→ 显示「已提交审核，预计 7 个工作日内出结果」即成功。

四、致命坑（必看）

• 解析报错后用 input 模式重置：若页面停在「解析失败」，先 bsk upload ... --mode input 点一次上传区（会把页面重置成「未上传」），再 --mode drop 干净重传，否则旧解析缓存会重复报旧错。
• 类目权限：平台注——「工具」「商业服务 > 软件/建站/技术开发」仅企业开发者可发（需企业认证）；「商业服务 > 企业管理」个人账号大概率可直接发。老板法人不在时，先发不依赖认证的类目，认证类目等法人回来再做。
• 每个技能重提都会生成新技能ID（原资产名不变，ID 刷新），属正常。
• session 易掉线：每次长时间操作后回到列表可能需重新 session start + 登录，属正常，重连即可。

五、收尾

发布/重提后回列表确认状态＝「审核中 v1.0.x」，然后：①更新 D:\AI\技能市场发布台账.csv（真相源）②全量广播 + 跨窗口日志 + 记忆三处登记（老板铁律）。

六、2026-10-06 实战新增（Claw 窗 6 连发后沉淀）

1. 市场展示分类是必填（"*"）：选项=教育学习/知识与学习/效率工具/内容创作/信息资讯/办公协同/OPC·一人公司/开发工具/投资理财/数据分析/网站部署/生活服务/商业运营。国学/处世类选「教育学习」或「知识与学习」。漏选会报「请至少选择 1 个分类」卡在确认信息步。
2. 服务类目下拉槽的 ctx 标注不可信：快照里服务类目槽的 ctx 常错写为「市场展示分类 *」。判断方法：点开后弹出的选项树是「物流服务/教育服务/交通服务/生活服务/餐饮服务/旅游服务/工具/商业服务/体育」＝服务类目树；选项是「教育学习/效率工具…」＝市场展示分类。
3. 「添加」按钮每点一次新增一个空槽，多点了就用各槽的「删除类目」删到只剩需要的。
4. 新发可能弹「选择发布方式」对话框：公开发布（默认选中）vs 专用发布（disabled）→ 直接点「确定」。
5. 提交后草稿残留：提交成功后再点「创建」，可能带出上次的已上传 zip 草稿 → 点「返回」再点「创建」即是空白上传页。
6. 驳回新案例（10-05）：教育服务-教育信息展示被驳，审核员原文要求「至少应包含『工具>信息查询』类目，如需资质，请一并提供」→ 实测个人账号可直接选「工具-信息查询」，无资质弹窗。重提 version 必须+1（1.0.1→1.0.2）。
7. 掉登录是常态：navigate 回首页常变未登录态，点「登录」按钮等 5 秒自动恢复（李彦林·超管）。
8. 会话中途 bsk refs 失效：页面跳转后旧 @eN 引用报 unknown，重新 snapshot 取新 refs 即可。
9. 蒸馏书籍 skill 零积分纪律（老板 10-06 令）：全部由本地会话直接撰写 SKILL.md，不调云端付费模型。上架内容双检：不踩红线（合规声明）+ 不露家底（内部资产路径/数据绝不写入）。

七、2026-10-06 17:3x 再补充（三本新书被驳后沉淀）

1. 类目口径再收紧：「商业服务>企业管理」对国学/处世/家训类已被实测驳回（了凡四训/格言联璧/曾国藩家书 1.0.0 三本同因）。审核员统一口径＝必须含「工具>信息查询」。→ 今后新发书蒸馏类技能，服务类目第一次就直接选「工具-信息查询」，不要再选企业管理（个人账号实测可选、无资质弹窗）。
2. 驳回原因读取：列表页点「驳回原因」→ bsk snapshot，原文在 dialog "驳回原因" 下的 paragraph；get-html 则 grep text-\[var\(--wb-color-text-error-default\)\]">。
3. 重提流程精简版（每本约2分钟）：列表「重新提交」→ drop 上传 *-1.0.1.zip → 继续 → 添加类目（工具→信息查询）→ 删除旧类目槽 → 继续 → 提交。refs 每跳页必失效，重 snapshot。
4. python 打包防双嵌套：zip 结构必须与原包一致（<name>/SKILL.md 单层）。z.write(p, os.path.relpath(p, src)) 的 src 传内容目录，别传其父目录，否则出双层嵌套被解析拒。
5. 「待发布」状态含义：过审待上线的过渡态（老三本 1.0.2 即此态），非驳回，无需处理。

八、2026-10-07 07:2x 重大突破（SkillHub CLI 批量发布通道）

背景：此前只在 open.workbuddy.cn（开发者后台）上架，用户真正逛的市场是 skillhub.cn，实测搜「菜根谭」全是别人的 → 零曝光（"上错货架"）。

1. ⭐ 真市场 = skillhub.cn。后台(open.workbuddy.cn)只管审核，用户看的是 SkillHub。两边不互通，必须分别上架。
2. CLI 批量发布（比网页快 10 倍）：
   - 取包：https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/latest.tar.gz（64KB，内含 cli/skills_store_cli.py，Windows 下直接用 python 跑，不需要 bash wrapper）
   - 登录：网页 skillhub.cn → 用户菜单 → API 密钥 → 创建（token 形如 skh_...，仅显示一次，务必当场存 D:/AI/config/skillhub.token）→ python cli/skills_store_cli.py login --key skh_xxx
   - 发布：python cli/skills_store_cli.py publish <dir或.zip> --json（先 --dry-run 预检）
   - 本地路径：D:/AI/tools/skillhub-cli/cli/skills_store_cli.py
3. 🔴 SKILL.md 必须有三字段，缺一即拒：slug（kebab-case，^[a-z0-9]([a-z0-9-]*[a-z0-9])?$，2-128）+ version（SemVer）+ displayName（中文显示名）。原 open 平台的包只有 name/version → 必须补 slug 和 displayName 再打包（脚本 _skillhub_patch_slug.py）。
4. 发布需实名：平台要求腾讯云人脸核身（用户菜单 → 实名认证），必须老板本人操作；未实名点发布会被拦。
5. 限流：连续发第 4 个开始 429 RATE_LIMITED。间隔 ≥60 秒，退避重试（60/120/180s）。脚本 _skillhub_publish_all.py 已内置退避+心跳。
6. 发布后状态：reviewStatus=pending → 审核通过前搜索不到，属正常，不要误判为失败。