CC Deck
跑长任务离开电脑，回来发现 Claude Code 卡在等审批？
CC Deck 把会话、任务与审批装进手机——点一下 Allow，它继续跑。
局域网直连不经任何第三方，跨网中继端到端加密，可自建（Cloudflare / 自有服务器）。
电脑断网、重启，会话不丢——在手机上点一下即可恢复。
下载最新版 · 直链下载页 · 网页控制台（需先完成快速开始）
目录
功能
- 远程审批不卡流程：权限请求推到手机点 Allow / Reject，AskUserQuestion 提问远程点选，随时打断——人不在电脑前也不耽误
- 随时对话：给会话发消息、传图片与文件（App 支持语音输入），会话产出的文件可拉回查看 / 保存，历史会话可续聊
- 断线原地恢复：电脑死机、重启、意外断开，手机上会话卡片保留不丢——点一下发消息，电脑自动原地恢复原会话（权限模式原样镜像，无人值守也不卡确认）
- 任务完成主动汇报：悬浮框（可拖动、位置记忆）+ App 通知，点按直达任务；任何脚本 / 定时任务 / CI 都能把消息推到你手机
- 上下文水位 + 完整转录：会话还能跑多久一眼可见；工具调用 / diff / 思考过程全量转录，
#NNN 任务号点击速览，代码块语法高亮
- 四端一致：Android App、网页 / PWA、Windows / macOS 桌面端，同一套设计语言，一端操作三端同步
随身掌控
- 多会话实时同步，四态徽标（运行中 / 等待输入 / 出错 / 完成），断线重连不漏消息
- 消息即发即达：点发送立刻送达电脑（偶发按键丢失会自动重试，无需重发）
- 模型远程切换：下拉即换当前会话模型，App / 网页 / 桌面三端一致（上下文水位条同步显示当前模型）
一屏全览（桌面端 · 在电脑前使用同样顺手）
- 会话集中管理：多个 Claude Code 会话聚在一个面板，不用在终端窗口间来回切换
- 状态灯实时可见：运行中 / 等待输入 / 出错 / 完成，扫一眼就知道哪个会话在等你
- 输出物、任务清单、完成推送等增强与手机端实时同步
断线不怕
- Wi-Fi 中断数秒内自动切换到云桥（跨网中继服务，可自建）保持可用，网络恢复后自动切回更快的局域网直连
- 电脑端正常退出的会话自动从手机列表清除，列表里留下的都是真正能用的会话
替你盯着
- 待确认事项黄色悬浮框提醒，点按直达会话
- 上下文水位分级色条三端一致；上下文压缩（Compacting）进行中三端明示，不再误判「卡死」
- 子 Agent 活性可见：卡片角标显示并行运行数，点开面板看每个子 Agent 正在做什么（你自己开着的终端会话同样支持）
- 交付自动归集：会话产出的报告 / 文档汇入「输出物」看板，三端一处查看与打开；未主动登记的产出也会自动收进
- 验收单在线填报：一批功能一张验收单，手机 / 网页直接勾选，结果自动送回电脑端会话（跨网可提交）
- 任务清单可拖动排序：手机 / 网页长按拖动调整优先级，CLI 按新顺序执行
多源多端
- Android App、网页 / PWA、Windows / macOS（Apple 芯）桌面客户端，安装包约 10MB
- 多台 PC 可聚合同屏（默认关闭），卡片角标区分来源；新建会话可选发往哪台（记住上次选择）
- 一台电脑只显示一条：本机、局域网 IP、云桥等不同方式连入自动归并，不出现重复会话
- 跨网络经 8 位配对码接入云桥，全程密文，桥只见密文——在任何网络打开网页，输入家里 PC 领的 8 位码即连
- 三端在线更新：App 启动自动检查新版本（断点续传 + 安装包完整性校验），桌面端从 GitHub Releases 更新
细节到位
- 浅色模式默认、深色与跟随系统可选，App / 网页 / 桌面同一套设计语言
- 设置中心竖排菜单 + 卡片分区（连接 / Relay / 显示 / 关于）：连接状态、扫码配对、本机领码、添加手机收拢一页
- 会话列表三档密度（标准 / 紧凑 / 极简）、源徽章按来源着色，信息密度自己调；空闲会话自动置灰（阈值可配，负数永不变灰）
- 定时任务随身可查：cron 自动译成自然语言（如「每天 08:00」），点开看完整指令；过期的一次性任务自动滤除
| 能力 | 📱 手机 App | ⌚ 手表 | 🌐 网页 / PWA | 🖥️ 桌面客户端 |
|---|
| 会话列表 · 四态速览 | ✅ | ✅ 抬腕速览 | ✅ | ✅ 同网页 |
| 远程审批 · Ask 作答 | ✅ | ✅ 允许 / 拒绝 / 点选 | ✅ | ✅ |
| 发消息 · 图片 · 文件 | ✅ 语音 + 相册 + 文件 | — | ✅ 粘贴 / 拖入 | ✅ 粘贴 / 拖入 |
| 模型远程切换 | ✅ 水位行下拉 | — | ✅ | ✅ |
| 打断 / 停止 / 删除 | ✅ | ✅ 停止 | ✅ 删除带撤销 | ✅ |
| 任务清单 + 完成汇报 | ✅ 通知 | ✅ 轻震直达 | ✅ | ✅ |
| 子 Agent 活性面板 | ✅ 角标 + 面板 | — | ✅ | ✅ |
| 输出物看板（文档 / 报告） | ✅ 查看 + 打开 | — | ✅ | ✅ 查看 + 下载 |
| 上下文水位 / 定时任务 | ✅ | ✅ ctx 百分比 | ✅ | ✅ |
| 转录时间线 | ✅ 全量 | ✅ 压缩版 | ✅ 全量 | ✅ |
| 多源聚合（默认关） | ✅ | — 跟随手机 | ✅ | ✅ |
| 历史会话恢复 / 续聊 | ✅ | — | ✅ | ✅ |
快速开始
PC 端两种装法，选一种即可（也可以都用：桌面端检测到插件已在运行会自动让位，互不冲突）。
装法 A · Claude Code 插件（终端流）
claude plugin marketplace add humumu130/cc-deck
claude plugin install cc-deck@cc-deck-plugins
装好重启 Claude Code，在任意会话里执行 /cc-deck：后台启动本机控制服务 relay（电脑端常驻，手机 / 网页 / 桌面都连它），终端打出三张二维码（App 下载 / App 直连 / 网页控制台）。你自己新开的 Claude Code 会话自动接入；已运行的会话重开后接入。数据存于 ~/.cc-deck/data/，升级插件不影响已有数据。
配套命令：/cc-deck-pair 领 8 位云桥配对码（5 分钟内有效、一次性），/cc-deck-stop 停止后台 relay。
装法 B · 桌面客户端（图形流，不敲命令）
从 Releases 下载桌面端：
- Windows：
CC.Deck_<v>_x64-setup.exe（未签名 exe 首次运行触发 SmartScreen，选「更多信息 → 仍要运行」）
- macOS（Apple 芯）：
.dmg
- Intel Mac / Linux：暂无桌面包——用装法 A + 浏览器即可，功能不缺
启动即自动带起内置 relay，在设置里领配对码或扫码，手机 / 网页即连；桌面里新建的会话全功能可用。
💡 装法 B 下，你自己开的终端 CLI 会话不会自动接入（内置 relay 不装 hooks）——需要桥接终端会话请再装装法 A 的插件，两者共存无冲突。
连接你的设备
场景 A · 同一网络（局域网）
- 手机 App（Android）：Releases 或直链下载页下载 APK 安装，扫 App 直连码即可添加，无需手动输入；App 内可直接检查更新
- iPhone / iPad：暂未上架 App Store——先用网页版 PWA：Safari 打开网页控制台输码连接，「添加到主屏幕」即得类 App 全屏体验。系统推送通知目前是 Android App 专属，iOS 以页面内提醒为主（Web Push 在 Roadmap）
- 浏览器：本机浏览器打开时自动发现本机服务（
127.0.0.1:8787），无需配置即连；其他设备打开 http://<PC-IP>:8787/?token=…
场景 B · 跨网络（外出 / 异地）
- PC 保持运行（装法 A 的 relay 或装法 B 的桌面端均可），领 8 位配对码（PC 只发出站连接，无需公网 IP）
- 手机 App「新增服务器 → 配对码」输码；或任意浏览器打开 https://cc-deck.humumu.online 输码（PWA 可加主屏）
- 所在网络限制较严时，网页端自动改用兼容的连接方式保持在线
- 手动跑 relay：
cd relay && npm install && npm run dev；要接入自己开的 CLI 会话再执行 node scripts/install-hooks.mjs；领配对码 npx tsx src/index.ts --pair
- Wear OS 手表：
wear-app/ 构建安装。经手机蓝牙 RFCOMM 中继零配置接入（手表免联网、免录入，无 GMS 设备可用）；也支持 WS 直连 relay，或在手表设置粘贴云桥地址远程使用
- 平台说明：Windows / macOS / Linux 均可跑 relay。「向外部会话注入按键」支持 Windows 与 macOS（Terminal 内），Linux 上自开的终端会话为只读监控 + 审批；托管会话全平台全功能
- 外部会话 = 你自己开着的终端里的 Claude Code 会话；托管会话 = 由 CC Deck 从面板新建、代你启动的会话
架构
- 实线
→：同网直连（同一局域网 / 本机），token 鉴权，仅限可信局域网
- 绿色粗线
⇒：跨网云通道，端到端密文——桥只按公钥派生的设备 id 路由，无法解密、不落盘；手表外出时直连云桥 /wan 端点透传，网页被拦自动降级 HTTP 长轮询
- 虚线：ᛒ 蓝牙透传（手机 ↔ 手表）；手表为开发中版本，PC ② 为示意（更多同款 PC 各自连云桥）
- 详细模块图 / 数据流时序 / 持久化机制见 docs/architecture.md
安全模型
- LAN token 是共享秘密：拿到 token 即可完全控制你的会话。token 首启随机生成，请经安全渠道传递；换发删
data/token 重启或设 CCR_TOKEN
- 局域网直连无 TLS：token 出现在 URL / WebSocket 参数中，仅限可信局域网；跨公网走云桥
- 云通道端到端加密：手机与电脑各持独立密钥，中继服务器上流转的全部是密文，运营方也无法解密
- 配对码只用于首次接入：设备携公钥与配对码请求绑定，校验通过即配对；一次性、默认 5 分钟过期，此后配对码不再参与通信
- 更新链路完整性：App 下载更新包先校验结构完整性（防截断包进安装器），版本以 GitHub Releases 为源，镜像仅作分发
- 默认公共桥由作者运营（带连接数 / 设备数 / 帧率限流）：能防窃听，但桥运营方理论上可观测元数据。介意者按进阶4 条命令自建
进阶
把任意脚本 / cron / CI 的消息推到手机与网页的悬浮框。LAN token 鉴权；不指定 session_id 时自动投递给当前运行的会话（无则最新外部会话）。
# 绿色「任务完成」悬浮框（done 最多 10 条）
curl -X POST "http://127.0.0.1:8787/api/notify?token=<TOKEN>" \
-H "content-type: application/json" \
-d '{"done":["部署完成","冒烟全绿"]}'
# 黄色「待确认」悬浮框（text ≤120 字，点按直达会话）
curl -X POST "http://127.0.0.1:8787/api/notify?token=<TOKEN>" \
-H "content-type: application/json" \
-d '{"mode":"confirm","text":"发布包已就绪，等你确认"}'
| 变量 | 默认 | 说明 |
|---|
CCR_PORT | 8787 | 监听端口 |
CCR_TOKEN | data/token 文件 | 鉴权 token；设环境变量（≥8 位）可覆盖 |
CCR_CWD | 上次会话目录（无则主目录） | 托管新建会话的缺省工作目录 |
CCR_MODEL | ANTHROPIC_DEFAULT_SONNET_MODEL | 托管会话模型；不用默认值时请显式指定 |
CCR_DEBUG | – | 打印 CLI stderr 与工具原始结构 |
CCR_GATE_TOOLS | Bash,Edit,Write,NotebookEdit,WebFetch,WebSearch | 远程审批门控的工具名 |
CCR_BRIDGE_TOKEN | data/bridge-token 文件 | hooks 回连 relay 的桥接令牌 |
CCR_DATA_DIR | 插件 ~/.cc-deck/data / 开发 relay/data | 数据目录 |
CCR_CLOUD_URL | wss://cc.humumu.online/cloud | 云桥地址，逗号分隔可多桥；空串禁用 |
CCR_CLOUD_TOKEN | ccdeck-public-9f3k2m7v | 云桥层连接 token（自建桥换自己的） |
云桥是无状态密文路由：客户端帧 {to, data} 按设备 id 点对点转发，无持久化无缓冲。
| 形态 | 目录 | 适合 |
|---|
| Node + ws（Docker 就绪） | cloud-bridge/ | 有 VPS / 内网服务器 |
| Cloudflare Worker + Durable Object | cloudflare/ | 不想维护服务器，空闲不计费 |
# Cloudflare Worker（4 条命令）
cd cloudflare
npx wrangler login
npx wrangler secret put CLOUD_TOKEN # 设 ≥8 位随机串
# 编辑 wrangler.toml：改 name，routes 换成自己的域名（或删掉用默认 workers.dev）
npx wrangler deploy
# Node / Docker
docker build -t cc-cloud-bridge ./cloud-bridge
docker run -d -p 8790:8790 -e CLOUD_TOKEN=<8位以上随机串> cc-cloud-bridge
部署后 relay 侧设 CCR_CLOUD_URL 与 CCR_CLOUD_TOKEN 指向它，手机重新配对一次。
开发
# relay（Node ≥ 20）
cd relay && npm install
npm run dev # 前台跑 relay
npm run test:bus # EventBus seq / 环形缓冲 / 断线补发
npm run test:sessions # 双会话并发全生命周期
npm run test:ws # WS 鉴权 / 快照 / 补发 / 幂等
npm run test:history # 历史持久化与重启恢复
npm run test:bridge # hooks 桥接外部会话 / 远程审批 / 超时
npm run test:cloud # 云通道端到端
npx tsx scripts/smoke-e2e.ts <token> # 浏览器等价全流程
# 手机端（Expo 57 / React Native 0.86）
cd expo-app && npm install && npx expo run:android
# 手表端（Kotlin + wear-compose）
cd wear-app && ./gradlew assembleDebug
# 桌面客户端
cd desktop && npm install && npm run dist # Electron
cd desktop-tauri && npx tauri build # Tauri
# 从源码重建插件
cd relay && node scripts/build-plugin.mjs
仓库布局：relay/（核心，协议唯一定义源 relay/src/types.ts）、web-console/（网页控制台）、expo-app/（Android 手机端 + 手表网关）、wear-app/（Wear OS 手表端）、desktop-tauri/（桌面客户端）与 desktop/（Electron，过渡期保留）、cloud-bridge/ 与 cloudflare/（云桥双形态）、mobile/（APK 分发页）、cc-plugins/（Claude Code 插件成品）、docs/（架构文档）。
CI：relay · android · desktop。版本号与发版流程见 CONTRIBUTING.md。
Roadmap
- 单线沟通：只对 Leader 说一句话需求，分诊五档输出（咨询 / 随手办 / 轻立项 / 正经立项 / 建议暂缓）
- 物理隔离：项目组 = 编制 + git worktree + 任务板，cwd 即项目锚点，并行互不踩踏
- 记忆三层：个人层（手写 · 跨一切生效）/ 组织层（Leader 维护两本账）/ 项目层（跟目录走）
- 经验回流：结项经验以提案 diff 回流组织记忆，一键确认后跨项目沉淀复用
flowchart TB
YOU["👤 你"]
subgraph ORGBOX["🏛 常驻组织 · org 目录"]
direction TB
LEADER["🧭 Leader · 唯一<br/>分诊 · 立项 · 汇总 · 不进项目干活"]
BOOKS["📚 两本账<br/>组织记忆（经验 · 慢涨）<br/>派单台账（状态 · append-only）"]
ROUTE["🔀 路由表 · 熟手池<br/>亲和调度（M3）"]
LEADER ---|"读档恢复 / 先落账"| BOOKS
LEADER -.->|"查熟手"| ROUTE
end
subgraph PG["🧪 动态项目组 × N · cwd 物理隔离"]
direction TB
PJA["项目组 A · 在办<br/>编制 + worktree + 任务板"]
PJB["项目组 B · 挂起<br/>冻结任务板 · 成员退休"]
end
CASUAL["💬 普通会话<br/>逃生舱 · 不经组织"]
PERSONAL["✍️ 个人层记忆<br/>全局 CLAUDE.md · 你手写"]
YOU ==>|"一句话需求<br/>单线沟通"| LEADER
LEADER -->|"派单 · cwd=项目锚点"| PJA
LEADER -.->|"挂起 · 静默"| PJB
PJA -.->|"结项 · 经验回流（提案确认）"| BOOKS
YOU -.->|"直达"| CASUAL
CASUAL -.->|"随时可移交"| LEADER
YOU -.-|"手写 · 跨一切生效"| PERSONAL
- 粗箭头
⇒：核心通道（单线沟通）；虚线 ⇢：弱关联（逃生舱 / 挂起 / 回流提案）
- 手表 Tiles（不开 App 直接看状态）
- 更多手表平台：OPPO ColorOS Watch 适配进行中
- 多手机 / 多设备同时在线
- Web Push：iOS / 浏览器锁屏推送（网页端 PWA 补齐推送能力）
- LAN 直连 WSS / TLS 部署加固
- 会话恢复扩展到更多桌面场景（当前支持 macOS Terminal / Windows cmd）
反馈与交流
License
MIT © humumu130
