Bug: 从 "插件 → 技能 → 更多" 入口打开 Skill Hub 提示 "is not configured for this environment"

[cindy-issue]

提交人: Cetaphil
客户端版本: 0.1.73

---

问题

在客户端通过「插件 → 技能 → 更多」路径打开 Skill Hub 时，界面提示：

加载失败：Cindy Skill Hub is not configured for this environment

现象

• 进入路径：插件 → 技能 → 更多
• 结果：Skill Hub 加载失败，提示未配置（"is not configured for this environment"）
• 该路径下的 Skill Hub 功能不可用

反馈分类

Bug

提交时的任务环境

仅代表提交时快照,不一定是故障环境。OS 来自提交客户端本机,不含 SSH 远端主机;Harness / 模型来自当前任务。与运行环境无关的反馈可忽略本段。
OS: win32 x64 (10.0.19045)
Harness: Codex
Model ID: minimax/minimax-m3:free
界面语言: zh-CN

[dash-s-cindy]

判断：Skill Hub 的客户端能力和“插件 → 技能 → 更多”入口已经在当前 main 中实现；本 Issue 值得继续处理，但现阶段更像是 0.1.73 的版本发布、endpoint 清单或服务部署未完整落地，需要先核对发布链路，不建议直接修改为回退旧 Skill Hub 地址。\n\n进一步检查发现，当前源码中的完整入口存在：apps/desktop/src/renderer/features/skillhub/SkillhubHomeView.tsx 将“更多”导航到 /skillhub/market，路由也注册了 SkillhubHomeView。首页同时直接加载公开/组织目录，因此不是能力完全缺失。\n\n## 证据与代码定位\n\n1. apps/desktop/src/main/skillhub/hubApi.ts 的 requireSkillhubApiBaseUrl() 只读取 getClientEndpoint('cindySkillHubApiBaseUrl')。端点为空时会抛出：\n UNSUPPORTED_CAPABILITY: Cindy Skill Hub is not configured for this environment。\n 同一文件还明确说明新客户端“不回退旧 skillhubApiBaseUrl”，原因是旧地址属于已发布客户端使用的 XD 服务，回退可能让新客户端误连错误服务。\n2. packages/maker-shared/src/clientEndpoints.ts 将 cindySkillHubApiBaseUrl 定义为可选端点：清单缺失或为空会解析为 ''，不会阻断整个客户端启动；消费者再决定关闭对应云能力。这正是 Issue 中错误文案的来源。\n3. 当前快照 e81a14c4dcaf0cb48c5b429f51abe392b469d809 的两个 endpoint 正本均已包含独立地址：\n - config/endpoint.json：https://skill-hub.cindy.com.cn\n - config/endpoint.global.json：https://skill-hub.cindy.app\n4. apps/desktop/src/main/skillhub/__tests__/hubApi.test.ts 已覆盖缺失端点时不调用相对 URL，并断言只使用 cindySkillHubApiBaseUrl；因此当前行为是有意设计并已有回归保护，不是偶然把空地址发出请求。\n\n## 发布状态与相关记录\n\n- #3682 已于 2026-09-02 合入。该 PR 引入独立 cindySkillHubApiBaseUrl、新的 Skill Hub 客户端连接和“公开 / 组织 / 本地技能 / 我的管理 / 更多”导航。PR 同时明确记录：连接新服务的 Cindy 客户端尚未发布；已发布旧客户端继续使用旧 skillhubApiBaseUrl。这与 0.1.73 报错高度相关：需要确认该版本究竟处于旧客户端、部分更新还是新客户端代码已发布但 endpoint 清单未同步的状态。\n- #3826 是 #3682 的后续 scope 边界修复，已于 2026-09-03 合入，涉及目录作用域、registry、Learn 和自动同步；它不改变入口或 endpoint 选择，因此不是当前“未配置”错误的直接修复，但说明 Skill Hub 主干仍在近期持续演进，发布版本与 main 的差距需要明确。\n\n## 建议行动\n\n1. 先核对实际发布产物，不改代码：确认受影响的 0.1.73 是 CN 还是 Global 构建、实际使用的 endpoint manifest 来源、清单中是否存在 cindySkillHubApiBaseUrl，以及清单是否在该版本启动时成功解析。应分别检查两个区域的 CDN 清单，而不能只看仓库正本。\n2. 确认版本与 #3682 的关系：若 0.1.73 早于 #3682，则这是新入口/新客户端发布顺序未完成，应安排包含 #3682 的正式客户端版本，并确保对应区域 endpoint 清单和 Skill Hub 服务先可用。若 0.1.73 已包含该 PR，则继续排查 CDN 清单上传、区域切换、构建区域选择或旧清单缓存。\n3. 确认服务端部署：验证两个区域的 skill-hub 地址已部署，并能响应新版客户端所需的 /api/skills-hub/* 契约；不要仅通过填值掩盖服务端未部署。\n4. 补充可复现信息：请提供实际区域、客户端是否 packaged、启动时 endpoint manifest 的来源/版本，以及进入页面时的脱敏错误码。没有这些信息，无法区分“旧版本预期行为”和“新版本发布配置缺失”。\n\n## 不建议的方案\n\n不建议让新版客户端在缺少 cindySkillHubApiBaseUrl 时自动回退到 skillhubApiBaseUrl。源码注释、#3682 的发布设计和现有测试都表明两个地址承担不同的兼容边界；直接回退可能把新版目录请求发送到旧 XD 服务，掩盖发布配置问题并引入协议/数据范围不一致。