Skillget

cc-deck

skill
Guvenlik Denetimi
Basarisiz
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Basarisiz
  • network request — Outbound network request in cc-plugins/plugins/cc-deck/mobile/sw.js
  • process.env — Environment variable access in cc-plugins/plugins/cc-deck/scripts/guard-context.mjs
  • network request — Outbound network request in cc-plugins/plugins/cc-deck/scripts/guard-context.mjs
  • exec() — Shell command execution in cc-plugins/plugins/cc-deck/scripts/guard-lib.mjs
  • exec() — Shell command execution in cc-plugins/plugins/cc-deck/scripts/guard-lifecycle.mjs
  • process.env — Environment variable access in cc-plugins/plugins/cc-deck/scripts/guard-stop.mjs
  • exec() — Shell command execution in cc-plugins/plugins/cc-deck/scripts/hook.mjs
  • process.env — Environment variable access in cc-plugins/plugins/cc-deck/scripts/hook.mjs
  • network request — Outbound network request in cc-plugins/plugins/cc-deck/scripts/hook.mjs
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Claude Code 的随身工作台：手机 / 手表 / 网页 / 桌面四端远程操控（审批、注入、打断、切模型），更是工作流增强层——更强的任务管理（完成推送、定时任务）、插入问答、结构化转录、会话断线可恢复。自建云桥、端到端加密、一套协议四端同构。

README.md

CC Deck

relay CI
android CI
desktop CI
release
license

在手机上使用 PC 端的 Claude Code：查看会话状态、批准权限、发送消息、切换模型、接收任务汇报；电脑断网重启会话不丢，手机点一下即可远程恢复。自建 relay，不经过任何第三方云服务；不在同一网络时走 Cloudflare 中继，端到端加密。

🏠 项目主页 · 网页控制台 · 下载最新版 · 直链下载页

目录

功能

随身掌控

  • 多会话实时同步，四态徽标（运行中 / 等待输入 / 出错 / 完成），断线自动补发
  • 权限审批推到手机点 Allow / Reject；AskUserQuestion 提问远程点选；随时打断
  • 给会话发消息、传图片（App 支持语音输入）；历史会话可续聊
  • 消息即发即达：点发送立刻送达电脑（排队回显即时，注入后自动校验、回车被吞秒级补发）
  • 模型远程切换：下拉即切当前会话模型（注入 CLI 原生 /model），ctx 水位行内嵌当前模型，App / 网页 / 桌面三端一致

断线不怕

  • 电脑死机 / 重启 / 意外断开，手机会话卡片保留不丢：点一下发消息，电脑自动原地恢复原会话（权限模式原样镜像，无人值守也不卡确认）
  • 电脑端正常退出的会话自动从手机列表清除，列表里留下的都是真正能用的会话
  • Wi-Fi 中断数秒内自动切云桥保持可用，网络恢复后自动切回更快的直连；LAN 探测失败进入短冷却，不再拖慢切换

替你盯着

  • 任务完成主动汇报：悬浮框（可拖动、位置记忆）+ App 通知 + 手表震动，点按直达任务
  • 待确认事项黄色悬浮框 + /api/notify 注入接口：任何脚本都能把一条消息推到你手机上（用法见进阶）
  • 上下文水位三端同口径分级色条，会话还能跑多久一眼可见；上下文压缩（Compacting）进行中三端明示，不再误判"卡死"
  • 完整转录（工具调用 / diff / 思考过程），#NNN 任务号点击弹气泡速览详情
  • 任务清单可拖动排序：手机 / 网页长按拖动调整优先级，CLI 按新顺序执行
  • 定时任务随身可查：cron 表达式自动译成人话（"每天 08:00"），点开看完整指令；过期的一次性任务自动滤除

多源多端

  • Android App、Wear OS 手表、网页 / PWA、Windows 桌面客户端（Tauri 主推 3.4MB）
  • 多台 PC 可聚合同屏（opt-in），卡片角标区分来源；新建会话可选发往哪台（记住上次选择）
  • 同一台 PC 多通道自动归并：LAN 与云桥两条连接按公钥派生的设备 id 密码学合并；127.0.0.1 / 主机名 / IP 等写法差异同样收敛为一条，不再裂出重复条目
  • 跨网络经 6 位配对码接入云桥，全程密文，桥只见密文——在任何网络打开网页，输入家里 PC 领的 6 位码即连
  • 三端在线更新：App 启动自动检查（镜像优先 + 断点续传 + 安装包完整性校验），桌面内建 updater 对接 GitHub Releases

细节到位

  • 深色开发者工具风界面，App / 网页 / 桌面同一套设计语言
  • 设置中心竖排菜单 + 卡片分区（连接 / Relay / 显示 / 关于）：Relay 状态、扫码配对、本机领码、添加手机收拢一页
  • 会话列表三档密度（标准 / 紧凑 / 极简）、源徽章按来源着色，信息密度自己调
四端能力矩阵
能力 📱 手机 App ⌚ 手表 🌐 网页 / PWA 🖥️ 桌面客户端
会话列表 · 四态速览 ✅ ✅ 抬腕速览 ✅ ✅ 同网页
远程审批 · Ask 作答 ✅ ✅ 允许 / 拒绝 / 点选 ✅ ✅
发消息 · 图片 ✅ 语音 + 相册 — ✅ 粘贴截图 ✅
模型远程切换 ✅ 水位行下拉 — ✅ ✅
打断 / 停止 / 删除 ✅ ✅ 停止 ✅ 删除带撤销 ✅
任务清单 + 完成汇报 ✅ 通知 ✅ 轻震直达 ✅ ✅
上下文水位 / 定时任务 ✅ ✅ ctx 百分比 ✅ ✅
转录时间线 ✅ 全量 ✅ 压缩版 ✅ 全量 ✅
多源聚合（默认关） ✅ — 跟随手机 ✅ ✅
历史会话恢复 / 续聊 ✅ — ✅ ✅

快速开始

第 0 步 · PC 上装插件（两条命令）

claude plugin marketplace add humumu130/cc-deck
claude plugin install cc-deck@cc-deck-plugins

装好重启 Claude Code，在任意会话里执行 /cc-deck：后台启动 relay，终端打出三张二维码（App 下载 / App 直连 / 网页控制台）。插件自带的 hooks 会自动桥接新开的 Claude Code 会话；已运行的会话需重开。数据目录 ~/.cc-deck/data/，与插件升级解耦。

配套命令：/cc-deck-pair 领 6 位云桥配对码（5 分钟内有效、一次性），/cc-deck-stop 停止后台 relay。

场景 A · 同一网络（局域网）

  • 手机 App：Releases 或直链下载页下载 APK 安装，「新增服务器 → 扫码添加」扫 /cc-deck 的 App 直连码，零手输；装好后 App 内即可检查更新
  • 浏览器：桌面浏览器打开时会自动嗅探本机 relay（127.0.0.1:8787），命中即零配置直连；或扫控制台码 / 直接打开 http://<PC-IP>:8787/?token=…
  • 桌面：下载 CC-Deck-Setup-<tag>.exe，启动自动连本机。未签名 exe 首次运行会触发 SmartScreen，选「更多信息 → 仍要运行」

场景 B · 跨网络（外出 / 异地）

  1. PC 保持 relay 运行，执行 /cc-deck-pair 领 6 位配对码（PC 只发出站连接，无需公网 IP）
  2. 手机 App「新增服务器 → 配对码」输码；或任意浏览器打开 https://cc.humumu.online 输码（PWA 可加主屏）
  3. 所在网络拦截 WSS 时，网页端自动降级 HTTP 长轮询保持在线
更多姿势（手动跑 relay / 手表 / 平台说明）
  • 手动跑 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；「向外部 CLI 会话注入按键」依赖 Windows 专属注入器，其他平台外部会话为只读监控 + 审批，托管会话全功能可用

架构

flowchart LR
    subgraph SCR["四块屏幕 · 同一套协议"]
        direction TB
        APP["📱 手机 App（expo-app / Android）"]
        WATCH["⌚ Wear OS 手表（wear-app）"]
        WEB["🌐 网页控制台 / PWA（web-console）"]
        EXE["🖥️ 桌面客户端（Tauri 主推 · Electron 过渡）"]
    end

    CLOUD["☁️ CF 云桥 cc.humumu.online<br/>零知识密文路由 · 默认公共桥 · 可自建"]

    subgraph PC["你的 PC · 任意网络环境（Node ≥ 20）"]
        RELAY["CC Deck Relay（:8787）<br/>事件总线 · seq 断线补发 · 事件落盘<br/>审批门控 · 任务汇报 · 定时任务 · /api/notify"]
        EXT["Claude Code 外部会话<br/>你自己开的 CLI ×N"]
        HOSTED["Claude Code 托管会话<br/>Agent SDK query() 拉起"]
        RELAY <-->|"hooks · 六类事件上报 · 审批挂起 · 按键注入"| EXT
        RELAY <-->|"stdio 流式"| HOSTED
    end

    APP -->|"同 WiFi 直连 ws://ip:8787 + token（可扫码）"| RELAY
    WEB -->|"浏览器打开 relay 控制台"| RELAY
    EXE -->|"默认自动连本机 relay"| RELAY
    WATCH -->|"WS 直连（LAN）· 云桥透传（外出）"| RELAY
    WATCH <-.->|"蓝牙 RFCOMM 中继 · 零配置免联网"| APP

    RELAY ==>|"仅出站 WSS · tweetnacl 密文信封"| CLOUD
    APP ==>|"仅出站 WSS · 6 位配对码交换公钥"| CLOUD
    WEB ==>|"E2E · WS 被拦自动降级 HTTP 长轮询"| CLOUD
    EXE ==>|"E2E"| CLOUD

    CI["⚙️ GitHub Actions · 打 tag 自动出 APK + 桌面安装包挂 Release"]
    CI -.-> APP
    CI -.-> EXE
  • 细箭头 →：局域网 / 本机通道，token 鉴权，仅限可信局域网
  • 粗箭头 ⇒：云桥端到端密文通道——桥只按公钥派生的设备 id 路由，无法解密、不落盘
  • 详细模块图 / 数据流时序 / 持久化机制见 docs/architecture.md

安全模型

  • LAN token 是共享秘密：拿到 token 即可完全控制你的会话。token 首启随机生成，请经安全渠道传递；换发删 data/token 重启或设 CCR_TOKEN
  • 局域网直连无 TLS：token 出现在 URL / WebSocket 参数中，仅限可信局域网；跨公网走云桥
  • 云通道端到端加密：手机与 relay 各持 tweetnacl box 密钥，桥上流转的全是密文信封 {n,c}
  • 更新链路完整性：App 下载更新包先校验结构完整性（防截断包进安装器），版本以 GitHub Releases 为源，镜像仅作分发
  • 默认公共桥由作者运营（带连接数 / 设备数 / 帧率限流）：能防窃听，但桥运营方理论上可观测元数据。介意者按进阶4 条命令自建

进阶

通知注入（/api/notify）

把任意脚本 / 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":"发布包已就绪，等你确认"}'
环境变量（relay）
变量 默认 说明
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

版本号单一事实源：根目录 VERSION 文件。发版只改它，再跑 node scripts/version.mjs --write 同步到四个落点（web-console CONSOLE_VERSION、expo-app app.json 与 build.gradle、desktop-tauri package.json）；--check 由 git pre-commit 钩子强制校验，不同步的提交直接拦截。

node scripts/version.mjs           # 查看各落点当前值
node scripts/version.mjs --write   # 发版：把 VERSION 写入全部落点
node scripts/version.mjs --check   # 校验（pre-commit 自动跑）

仓库布局：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/（架构文档）。

Roadmap

  • 手表 Tiles（不开 App 直接看状态）
  • 更多手表平台：OPPO ColorOS Watch 适配进行中
  • 多手机 / 多设备同时在线
  • LAN 直连 WSS / TLS 部署加固
  • 会话恢复扩展到更多桌面场景（当前支持 macOS Terminal / Windows cmd）

License

MIT © humumu130

Yorumlar (0)

Sonuc bulunamadi