heicode/cc-haha/README.sync-conflict-20260430-013912-GVADS2N.md

Heicode（源码目录 cc-haha）

本目录实现 Heicode 终端与桌面客户端（CLI + Desktop + 本地服务）。目录名 cc-haha 为历史工程名；对外产品与文档统一称 Heicode（与 Heicode Manager 区分时亦称「Heicode 客户端」）。目标是把终端编程体验产品化，并对接企业模型平台。

你能得到什么

• 一个可运行的 CLI + Desktop 客户端
• 双平台登录入口（TaijiAICloud / ClawdRouter）
• 动态模型拉取，不写死模型名单
• 适配企业交付的品牌化 UI

核心能力

• 登录流程：优先浏览器 OAuth，兼容平台令牌登录
• 模型发现：通过 provider API 拉全量模型，不强绑定某一家模型
• 运行方式：同一套 provider 配置可在 CLI 与 Desktop 复用
• 本地 sidecar：桌面端通过本地服务层与 provider 通信，便于状态管理和扩展

目录速览

cc-haha/
├── bin/                        # 启动入口（heicode、兼容别名）
├── src/
│   ├── server/                 # 本地 API/WS 服务
│   │   ├── api/heicode-auth.ts # 登录相关接口
│   │   ├── api/providers.ts    # 模型拉取与 provider API
│   │   └── config/providerPresets.*
│   └── ...                     # CLI 逻辑
├── desktop/                    # Tauri + React 桌面端
└── docs/                       # 产品和技术文档

快速启动

# 安装依赖
bun install

# 启动本地服务
bun run src/server/index.ts

# 启动桌面端（新终端）
cd desktop
bun run tauri dev

本地联调 TaijiAICloud：

HEICODE_TAIJIAICLOUD_BASE_URL=http://localhost:3000 bun run src/server/index.ts

开发约定

• providerPresets 只保留产品确定的 provider
• UI 不暴露无关配置项（例如已移除 Providers 菜单）
• 模型来源以 provider 实际返回为准
• 认证相关改动优先保持“零配置”用户体验

已完成改造（本分支）

• 品牌统一为 Heicode
• 登录页去除 API Key 输入区域及相关提示文案
• 设置页移除 Providers 菜单
• 侧边栏和 About 移除 GitHub 链接与图标
• 模型选择器按 provider API 动态拉取模型，修复无 Claude provider 仍展示 Claude 模型的问题

下一步建议

• 增加登录与模型发现的 E2E 冒烟测试
• 将 OAuth 流程状态可视化（处理中/失败原因/重试）
• 增加 provider 超时与降级策略（提升桌面端可用性）