mirror of https://github.com/NanmiCoder/cc-haha synced 2026-07-16 13:03:31 +08:00

程序员阿江(Relakkes) 8b5de63ae9 Document opt-in H5 browser access

The desktop docs now explain the intended H5 setup path for personal and team use: enable H5 in Settings, generate a one-time token, configure allowed origins, and use LAN or a reverse proxy to open the mobile browser chat surface.

Constraint: H5 is opt-in browser access, not a public multi-tenant auth system.

Rejected: Hide the setup details in the implementation spec only | users need operational guidance for token handling, CORS, and reverse proxy routing.

Confidence: high

Scope-risk: narrow

Directive: Keep this page aligned with Settings labels and the token/CORS behavior before documenting broader public hosting.

Tested: bun run check:docs

Tested: Live local smoke with temporary HOME: /health 200, H5 verify without token 401, H5 verify with token 200, configured Origin echoed by CORS.

2026-05-10 01:15:50 +08:00

2.1 KiB

Raw Blame History

桌面端文档

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

文档目录

快速上手

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

架构设计

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

功能详解

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

安装指南

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

H5 访问

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

快速开始

用户

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

开发者

阅读架构设计理解三层架构
关键源码位置：
- desktop/src/ — React 前端
- desktop/src-tauri/ — Tauri Rust 后端
- desktop/sidecars/ — Sidecar 入口
- src/server/ — Express API 服务端
- adapters/ — IM 适配器

核心概念

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

2.1 KiB Raw Blame History Unescape Escape