feat(desktop): hc-406 v0.18 skill 全集重分级 + China seed 统装

[karlligamesvc-spec]

目标(hc-406, S6/P1)

把桌面 China skill 分级从 v0.17(73 skill / 49 关)扩到 v0.18 全集,并把 China seed 统装进桌面 seed。只开发,不合并、不出包、不 bump pin(发版批次统一)。

实扫全集

fork worktree 实扫:173 = skills/ 72 bundled + optional-skills/ 101 opt-in(任务书 162=66+96 数字对不上,以实扫为准)。

关键架构事实:

• bundled(72) 安装时自动拷进 ~/.hermes/skills/ 且 ACTIVE,除非进 skills.disabled → seed 只管这 72。
• optional(101) 随仓库发布但安装时不拷贝、hermes skills install 按需装(optional-skills/DESCRIPTION.md)→ 默认 off,永不进 seed。三项已拍决策据此落地:shopify/siyuan「默认开」= 二者是 optional(不被抑制,install 即用);notion 是 bundled、「灰度」= 留 seed OFF 按需开。
• 匹配键 = SKILL.md frontmatter name:(缺省回退目录名),大小写敏感(agent/skill_utils.py:643)。

分级结果(72 bundled,? 未决 = 0)

级	数	处置
A 本地纯执行	20	ON
A* 矩阵 A 但 v0.17 保留 OFF(创意小众)	5	OFF
B 国内可达	2	ON
C 需镜像/国产源	18	OFF
D 墙外/geo/竞品	7	OFF
DEV-B 能力足但 dev 小众	19	OFF

有效 22 ON / 50 OFF。 全 72 逐 skill 权威表见 cloud 文档 PR(karlligamesvc-spec/hermes-cloud#480,docs/DESKTOP-CHINA-SKILL-MATRIX.md)。

v0.18 delta vs v0.17

• +3 关(新 bundled):huggingface-hub(C)、maps(C)、plan(DEV-B)。
• −2 删(死 orphan,已非 bundled):kanban-orchestrator、kanban-worker。
• 22 新 bundled A/B 保持 ON:computer-use / apple* / powerpoint / obsidian / ocr-and-documents / nano-pdf / baoyu-infographic / llm-wiki / blogwatcher / yuanbao 等。

改动

• apex-managed.cjs:SEED_DISABLED_SKILLS 49→50 按 D/C/DEV-B 重分组;新增 add-only 并集愈合器 ensureSkillsDisabledYaml(存量机 v0.17→v0.18 升级路径:老 config 漏新关项靠 union 补齐,不移除、不重加用户已开项);公共行手术抽成 ensureListBlockYaml(plugins 语义 byte 不变)。
• backend-env.cjs:buildDesktopBackendEnv 注入 HF_ENDPOINT=https://hf-mirror.com(add-only,不覆盖父 env override)。解 STT 首用拉 ~150MB faster-whisper 模型国内裸网必挂(tools/transcription_tools.py::_transcribe_local → huggingface_hub 读 HF_ENDPOINT);两处 backend spawn 均 {...process.env, ...backend.env},注入真吃到;顺带覆盖 marker-pdf OCR / hf CLI Hub 下载。因此 ocr-and-documents 判 A 而非 C。
• main.cjs:guardConfigYamlProductBlocks 的 skills 补块从「仅缺失时 append」改为 union 愈合器(= 升级路径)。
• cli-config.yaml.example:skills.disabled 同步新 50 名单(与 seed byte-for-list 一致)。
• 测试:apex-managed.test.cjs(count 49→50 + 新/删/A-B 保 ON 断言 + ensureSkillsDisabledYaml 全场景),backend-env.test.cjs(HF 注入 + 不覆盖 override + 空值兜底)。CI Build desktop app + Check TypeScript(apps/desktop) 均 pass。
• WORK-NOTES-hc406.md:随 PR。

hc408/hc414 seed 键值(已读 S2/S3 WORK-NOTES,精确记入注释,暂不 emit)

S2/S3 的 WORK-NOTES 已在其分支落地(未并 cloud main),键值已精确抄进 apex-managed.cjs 注释,但未 emit 进 seed —— 两前提未满足,提前 seed 会让桌面搜/抽调到不存在的端点而 break:

• hc-408(feat/hc408-relay-search 未并 main)→ /api/v1/search/searxng/search 尚未上 prod。键:web.search_backend=searxng + SEARXNG_URL=https://api.apex-nodes.com/api/v1/search/searxng(末尾不带 /search)。
• hc-414(§4)明说公网 Firecrawl URL 未定(云侧仅绑 127.0.0.1;公网走向是 Kael/PM 决策),桌面 web_extract 是 opt-in。键:web.extract_backend=firecrawl + FIRECRAWL_API_URL=<待定>。
• 上线后激活方式已在注释写清(SEED_WEB_GATEWAY 常量 + seedWebGatewayBlockYaml + backend-env env + guard union,同 skills 套路)。

重 seed / 看门狗

• 新装:seedDefaultModelConfig(config.yaml 缺失才写)吃新 50 名单。
• 存量机:rm ~/.apexnodes/config.yaml 重启重 seed;不删也会被 guardConfigYamlProductBlocks(boot + fs.watch)union 补上 3 个新关项。plugins seed(feat(desktop): 0.16.1 批次——引擎胶囊/状态栏删减/plugins 种子/壳自更新 + 版本号 #48)ensurePluginsEnabledYaml 语义完全不变,基于 9790955aa 未冲掉。

给 PM

• 随下一个桌面发版批次(bump pin + 出签名包)生效,勿单独 bump。
• 存量机升级到 v0.18 runtime 后:①最简 = rm ~/.apexnodes/config.yaml 重启;②不删也会被 guard union 补关项(A/B 新技能已默认 ON,无需动作)。

🤖 Generated with Claude Code