# 封面与导读
> 一句话认识项目，看清这本手册怎么读。

- **Part**: 起点
- **Reading Time**: ~5 min
- **Estimated Tokens**: ~1536

---

手册 v2.0 更新于 2026-09-08  · 源码基线 dev@687bca3 · 维护者 [Ike-li](https://github.com/Ike-li)

Claude Chat Mobile 是一层默认上锁的桥接转发层：把你本机已登录的 `claude` CLI 接到手机浏览器。同一会话、同一份 transcript、同样的权限与配置。

 
    1  用户 / 实例 (n=1)  
    0  多租户设计  
    2000  事件环形缓冲  
    28  本手册页数  
 

 
    定位 
#### 终端等价入口

不是远程桌面，也不是 Claude 的重新实现。坐在电脑前对终端打字，和在手机上打字效果等价。
 
    形态 
#### 自托管桥 (n=1)

Node ≥20 · ESM · Express 5 · Socket.IO 4 · Agent SDK 驱动本机 CLI。坚守单用户自托管立场。
 
    手册 
#### 按认知顺序

认识 → 演进 → 方法论 → 实现 → 数据 → 运维 → 规范。以 `dev` 代码与最新门禁体系为事实基线。
 
 

## 这本手册从哪来

源码分支为 **dev**（当前基线 HEAD `687bca3`）。仓库采用产品宪法 C1–C5 与硬性规则治理（详见 `docs/hard-rules.md` 与 `docs/architecture.md`），本手册按真实运行代码与架构契约重叙述，不照搬历史陈旧文档。

> **WARNING:** 事实基线约定 — 手册关键数字、协议契约与模块边界以当前 dev 代码为准。若代码演进后行为与手册发生漂移，以生产代码及 tests/gates/ 门禁为准，并应在漂移清单中透明登记。

> **NOTE:** 范围 — 本手册描述产品源码（dev 分支），产物部署于 gh-pages 分支的 docs-site/ 目录，与展示站点统一维护。

## 三条阅读路线

 
    主线 
#### 完整通读 · 约 2–3 小时

从起点到规范，按认知层次逐章顺读。适合准备深入二次开发、维护或接手仓库的人。
 
    速览 
#### 30 分钟速读

封面 → 总览 → 架构 → 职责边界 → 终端等价 → 安全模型 → 快速开始 → 漂移清单。详见[阅读顺序指南](reading-guide.md)。
 
    角色 
#### 按关注面切入

运维部署直奔第六部分；同步与通信查「单驾驶员」与「事件信封」；鉴权安全查第四部分鉴权页。
 
 

## 技术栈一瞥

| 层级 | 技术选型 | 关键特性 |
| --- | --- | --- |
| 运行时 | Node ≥20 · ESM · Express 5 · Socket.IO 4 | 三层架构，前后端零构建纯 ESM |
| Agent 驱动 | @anthropic-ai/claude-agent-sdk 0.3.263 | 双向流控制，驱动本机已登录的 claude CLI |
| 配置与运维 | ccm.config.json · env-schema.js | 统一结构化配置、热重载工作区、统一读写源 |
| 鉴权与安全 | jose 6 (JWT) · 设备 TOFU · IPv6 /64 限速 | 单用户强制 Token，非本地网络设备指纹审批 |
| 离线推送 | web-push (VAPID) · 可选 ntfy | 审批/提问无条件推送，前台可见连接智能抑制 |
| 测试与门禁 | node --test · Playwright · 宿主机白名单 | S0–S7 执行槽分层，容器沙箱 HOME 隔离破坏性操作 |
| 开源许可 | AGPL-3.0-only · NOTICE 补充条款 | 严格保障自托管权益 |

从[阅读顺序指南](reading-guide.md)或[项目总览](overview.md)继续。