[qbqian]

这次改了什么

摘要

企业成员登录、切换身份或重启时，获取服务端按部门计算的技能安装名单，复用现有 Skill Hub 下载、校验和安装流程。原有产品自动同步配置继续生效，企业同名项优先。

变更类型

• feat 新功能
• fix 缺陷修复（N/A）
• refactor / perf 重构或性能优化（N/A）
• docs / test / chore 文档、测试或工程维护
• 其他：N/A

范围

• 关联 Issue / 需求：企业技能按部门自动分发；服务端配套 PR 待关联。
• 本 PR 包含：分页获取组织安装名单、严格响应校验、身份切换取消检查、同账号重新登录重拉策略、复用现有安装器。
• 明确不包含：后台页面、服务端权限判断、自动卸载、实时推送。
• 用户可见变化：符合可见范围和安装范围的企业成员自动获得指定技能；用户原有忽略偏好保留。
• 是否存在 breaking change：无；旧服务缺少新接口或请求失败时保留原有产品自动同步。部门归属由服务端判断，客户端不提交部门 ID。

UI 变化

不涉及。

• 引用的设计规范：不涉及：仅修改 main 进程同步逻辑，未改界面、交互控件或文案。

怎么验证的

自动验证

corepack pnpm test:unit:related
结果：PASS test:runner，PASS apps/desktop unit
corepack pnpm --filter desktop typecheck
结果：PASS，0 errors
vitest run organizationAutoInstall.test.ts autoSyncService.test.ts
结果：2 文件、60 测试通过

手工验证

配套服务端已完成隔离 PostgreSQL 联调及 Console 浏览器页面验证；本 PR 的 Desktop 安装行为通过单元测试验证。

未执行的验证

未在正式环境实测桌面自动安装；未进行 Windows 实机验证。复用既有安装器，不改平台文件布局。

风险

风险分类

• 无已知风险（N/A：涉及跨端协议）
• SQLite / migration（N/A）
• system prompt（N/A）
• 协议兼容
• 权限 / 安全 / 用户数据
• 存量插件兼容（批准状态 / 指纹 / manifest 校验 / 安装布局 / 包格式）（N/A：未改插件）
• 原生层 / fingerprint / OTA（N/A）
• 跨平台差异（N/A：复用现有安装器）
• 其他：N/A

影响与回滚

• 影响范围：Skill Hub 自动同步。新增 GET /api/skills-hub/auto-install，校验分页游标与候选版本，限制分页数量。拉取或安装期间身份变化会取消；名单失败不清除忽略偏好。
• 回滚 / 降级方式：先部署配套服务端再发布客户端。旧服务不支持新接口时继续原有产品同步；客户端回滚后不再消费企业名单，已安装技能保留。关闭策略不自动卸载。存量插件影响：无。

提交前检查

• 已 review 完整 diff
• 每个 commit 都带 DCO 签名（git commit -s）
• UI 改动已在「UI 变化」注明引用的设计规范章节（N/A：无 UI 改动）
• 未提交凭证、令牌或授权文件
• 已补充必要文档
• 已确认测试结果或说明未执行原因

[greptile-apps]

Confidence Score: 2/5

此 PR 暂不适合合并，因为组织接口挂起会阻塞原有产品同步，同账号快速重登可能漏拉策略，同名企业技能也无法接管已有 market 自动安装。

Findings

1.  组织请求会阻塞产品同步 ▶
2.  同账号重登可能漏拉策略 ▶
3.  企业技能无法接管同名安装 ▶

Fix with agent prompt

### Issue 1
apps/desktop/src/main/skillhub/autoSyncService.ts:511-513
组织名单请求没有超时，却与产品配置一起被 `Promise.allSettled` 等待。`skillhubApiFetch` 未传 `timeoutMs`，下层默认不创建超时控制器；如果旧服务或网络连接一直不返回，组织请求就不会结束，已经成功取得的产品配置也无法继续处理，整次自动同步会永久停在这里。这违背了“新接口失败时继续原有产品同步”的降级要求。请为组织分页请求设置有限超时，或将其与产品同步解耦。

### Issue 2
apps/desktop/src/main/skillhub/autoSyncService.ts:158
清空 `completedUserId` 仍不能保证同账号重新登录会重拉策略。如果旧同步尚未结束，重新登录触发的 `runOnceAfterLogin()` 会因 `inFlightUserId` 与当前用户相同而直接复用正在取消的旧 Promise；旧任务结束后不会为新会话排队同步，因此这次企业策略拉取会被静默跳过。应记录取消后的重跑请求，或像不同账号分支一样在旧任务结束后重新调用同步。

### Issue 3
apps/desktop/src/main/skillhub/autoSyncService.ts:518
企业同名项覆盖产品项后，已有的 market 自动安装无法切换到 team 来源。现有安装按 `catalogScope` 建索引，因此 `market:<slug>` 不会被新的 `team:<slug>` 识别为可更新项；它又因 `autoSynced` 被排除在冲突保护表之外。随后代码会对同一个物理目录执行一次不带 `force` 的全新安装，安装器返回 `CONFLICT_USER_OWNED` 并被静默跳过。结果是用户一直保留旧 market 技能，而企业优先的 team 版本无法安装。

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Summary

此 PR 在桌面端 Skill Hub 自动同步中加入企业部门策略名单：登录后分页读取组织候选，将企业同名技能置于产品默认项之前，并复用现有市场同步、安装、校验、忽略偏好和取消清理流程。

• 新增组织自动安装响应及分页游标的严格校验。
• 登出时重置自动同步完成标记，意图支持同账号重新登录后重新拉取。
• 当前仍存在组织请求无超时、同账号快速重登漏跑，以及跨 catalog scope 的同名技能无法接管三个阻塞问题。

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart TD
  Login[企业成员登录或切换身份] --> Product[获取产品自动同步配置]
  Login --> Org[分页获取组织部门策略]
  Product --> Merge[按技能名称合并]
  Org --> Merge
  Merge -->|企业同名项优先| Ignore[应用用户忽略偏好]
  Ignore --> Sync[按 catalog scope 同步 Skill Hub]
  Sync --> Registry[匹配本地安装记录]
  Registry --> Install[复用下载、校验与安装器]
  Install --> Links[更新注册表与共享技能链接]

Loading

_{Reviews (1) · Last reviewed commit: "feat(skillhub): install organization ski..."}

[greptile-apps]

组织请求会阻塞产品同步

组织名单请求没有超时，却与产品配置一起被 Promise.allSettled 等待。skillhubApiFetch 未传 timeoutMs，下层默认不创建超时控制器；如果旧服务或网络连接一直不返回，组织请求就不会结束，已经成功取得的产品配置也无法继续处理，整次自动同步会永久停在这里。这违背了“新接口失败时继续原有产品同步”的降级要求。请为组织分页请求设置有限超时，或将其与产品同步解耦。

Knowledge Base Used: Desktop runtime processes

Prompt To Fix With AI

This is a comment left during a code review.
Path: apps/desktop/src/main/skillhub/autoSyncService.ts
Line: 511-513

Comment:
**组织请求会阻塞产品同步**

组织名单请求没有超时，却与产品配置一起被 `Promise.allSettled` 等待。`skillhubApiFetch` 未传 `timeoutMs`，下层默认不创建超时控制器；如果旧服务或网络连接一直不返回，组织请求就不会结束，已经成功取得的产品配置也无法继续处理，整次自动同步会永久停在这里。这违背了“新接口失败时继续原有产品同步”的降级要求。请为组织分页请求设置有限超时，或将其与产品同步解耦。

**Knowledge Base Used:** [Desktop runtime processes](https://app.greptile.com/xindong/-/custom-context/knowledge-base/xindong/cindy/-/docs/desktop-runtime-processes.md)

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

[greptile-apps]

同账号重登可能漏拉策略

清空 completedUserId 仍不能保证同账号重新登录会重拉策略。如果旧同步尚未结束，重新登录触发的 runOnceAfterLogin() 会因 inFlightUserId 与当前用户相同而直接复用正在取消的旧 Promise；旧任务结束后不会为新会话排队同步，因此这次企业策略拉取会被静默跳过。应记录取消后的重跑请求，或像不同账号分支一样在旧任务结束后重新调用同步。

Knowledge Base Used:

• Authentication and identity
• Desktop runtime processes

Prompt To Fix With AI

This is a comment left during a code review.
Path: apps/desktop/src/main/skillhub/autoSyncService.ts
Line: 158

Comment:
**同账号重登可能漏拉策略**

清空 `completedUserId` 仍不能保证同账号重新登录会重拉策略。如果旧同步尚未结束，重新登录触发的 `runOnceAfterLogin()` 会因 `inFlightUserId` 与当前用户相同而直接复用正在取消的旧 Promise；旧任务结束后不会为新会话排队同步，因此这次企业策略拉取会被静默跳过。应记录取消后的重跑请求，或像不同账号分支一样在旧任务结束后重新调用同步。

**Knowledge Base Used:**
- [Authentication and identity](https://app.greptile.com/xindong/-/custom-context/knowledge-base/xindong/cindy/-/docs/authentication-and-identity.md)
- [Desktop runtime processes](https://app.greptile.com/xindong/-/custom-context/knowledge-base/xindong/cindy/-/docs/desktop-runtime-processes.md)

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

[greptile-apps]

企业技能无法接管同名安装

企业同名项覆盖产品项后，已有的 market 自动安装无法切换到 team 来源。现有安装按 catalogScope 建索引，因此 market:<slug> 不会被新的 team:<slug> 识别为可更新项；它又因 autoSynced 被排除在冲突保护表之外。随后代码会对同一个物理目录执行一次不带 force 的全新安装，安装器返回 CONFLICT_USER_OWNED 并被静默跳过。结果是用户一直保留旧 market 技能，而企业优先的 team 版本无法安装。

Prompt To Fix With AI

This is a comment left during a code review.
Path: apps/desktop/src/main/skillhub/autoSyncService.ts
Line: 518

Comment:
**企业技能无法接管同名安装**

企业同名项覆盖产品项后，已有的 market 自动安装无法切换到 team 来源。现有安装按 `catalogScope` 建索引，因此 `market:<slug>` 不会被新的 `team:<slug>` 识别为可更新项；它又因 `autoSynced` 被排除在冲突保护表之外。随后代码会对同一个物理目录执行一次不带 `force` 的全新安装，安装器返回 `CONFLICT_USER_OWNED` 并被静默跳过。结果是用户一直保留旧 market 技能，而企业优先的 team 版本无法安装。

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.