sdaduanbilei/cc-haha
1
0
Fork 0
mirror of https://github.com/NanmiCoder/cc-haha synced 2026-07-15 12:53:31 +08:00
Code Issues Packages Projects Releases Wiki Activity
cc-haha/docs/desktop/index.md
程序员阿江(Relakkes) 81845fbc49 fix: finalize Electron migration boundaries 
Complete the Electron replacement boundary before merging by removing the renderer-side Tauri host fallback, tightening H5/browser access so only desktop navigation is tokenless, and moving desktop release publication to a tag-driven GitHub Actions matrix with a single final publish job.

Constraint: H5/browser capability access must not gain tokenless access through localhost or retired Tauri origins

Constraint: Desktop release artifacts must be built by GitHub Actions from version tags, not treated as local build outputs

Rejected: Keep localhost browser origins trusted for convenience | local browser contexts can access loopback services and must use the H5 token path

Rejected: Publish from each matrix job | partial releases can be created before all platforms finish

Confidence: high

Scope-risk: broad

Directive: Do not reintroduce Tauri origins or localhost browser origins into the trusted desktop origin set without a reviewed security design

Tested: bun test src/server/__tests__/h5-access-policy.test.ts src/server/__tests__/h5-access-auth.test.ts src/server/__tests__/diagnostics-service.test.ts src/server/middleware/cors.test.ts

Tested: bun test scripts/pr/release-workflow.test.ts scripts/release-update-metadata.test.ts

Tested: bun run check:desktop

Tested: bun run check:native

Tested: git diff --check

Not-tested: bun run check:server is blocked by expired quarantine entries server:cron-scheduler, server:providers-real, server:tasks, server:e2e:business-flow, server:e2e:full-flow
2026-06-02 22:42:53 +08:00

3.1 KiB
Raw Blame History

桌面端文档

图形化的 AI Code Editor，支持多会话、多标签、IM 接入的完整桌面体验。

桌面端界面

文档目录

快速上手

面向用户的桌面端使用指南：界面布局、对话操作、多标签、权限控制、项目管理、模型配置、IM 适配器、定时任务。

架构设计

面向开发者的技术架构：三层架构（Electron Host → Server → CLI）、WebSocket 协议、HTTP API、状态管理、协议代理、适配器桥接、目录结构。

功能详解

深入每个功能模块：聊天引擎、代码展示、工具调用、Agent Teams、提供商管理、技能/Agent、定时任务、IM 适配器、设计系统。

安装指南

下载安装、macOS/Windows 常见问题、Web UI 模式。

H5 访问

面向个人和团队的可选浏览器访问：开启 H5、生成 Token、配置允许来源、通过局域网或反向代理在手机上访问聊天界面。

Tauri 迁移 Electron 调研索引

桌面端从 Tauri 2 迁移到 Electron 的系统能力盘点、React 复用边界、目标架构、安全要求和迁移路径。

Electron 迁移任务清单

逐阶段执行清单：host adapter、Electron main/preload、系统能力、build/release、跨平台 smoke 和 Computer Use 验收。

Electron 迁移验证清单

迁移收口验证：自动化证据、Review 收口项、macOS Computer Use smoke、Windows/Linux 实机验收边界。

Electron 迁移交互式验收清单

本地浏览器可直接打开的验收 checklist，支持勾选进度、记录问题、导出 Markdown。

快速开始

用户

  1. 阅读 安装指南 下载安装
  2. 阅读 快速上手 了解界面和操作
  3. 配置 AI 模型提供商，开始对话

开发者

  1. 阅读 架构设计 理解三层架构
  2. 关键源码位置：
    • desktop/src/ — React 前端
    • desktop/electron/ — Electron main/preload/系统能力 host
    • desktop/src-tauri/ — 历史资源目录，当前仅作为 sidecar、图标和 preview agent 的 Electron 打包输入
    • desktop/sidecars/ — Sidecar 入口
    • src/server/ — Express API 服务端
    • adapters/ — IM 适配器

核心概念

概念 说明
Electron Host 跨平台桌面壳层，管理窗口、系统能力、Sidecar 进程和更新
Sidecar 随主进程启动的后台服务，运行 API 服务器
Session 一次对话会话，绑定工作目录，通过 WebSocket 通信
Tab 标签页，对应一个 Session 或特殊页面
Provider AI 模型提供商，支持 Anthropic/OpenAI 兼容接口
Adapter IM 适配器，Telegram/飞书接入 Claude Code
Store Zustand 状态容器，按领域拆分管理