Clawd Mobile v0.11.0

Clawd Mobile v0.11.0 🦀📱

Clawd 现在能装进你的口袋了。这一版带来完整的 Android 伴侣 App，并为桌面端补齐了 Windows / macOS / Linux 的多平台构建。

✨ 本次亮点

• 📱 Android 客户端 — 原生 App，通过局域网 / 远程中继实时同步你的 AI 编码 Agent 状态，手机上的小螃蟹会跟着 Agent 一起思考、工作、等你审批、庆祝完成。
• 🔔 浮窗审批 — 权限请求直接在手机浮窗上滑动 Allow / Deny，不用打开 App。
• 🖥️ 全平台桌面构建 — macOS (Intel + Apple Silicon)、Windows (x64 + ARM64)、Linux (AppImage)。
• 🎨 全新 README — 首页换上安卓端四种会话状态的实机截图（思考中 / 工作中 / 待审批 / 已完成）。

📦 下载

平台	文件
Android（签名正式版）	Clawd-on-Mobile-0.11.0-release-signed.apk
macOS (Apple Silicon)	Clawd-on-Mobile-0.11.0-arm64-mac.zip
macOS (Intel)	Clawd-on-Mobile-0.11.0-x64-mac.zip
Windows (x64)	Clawd-on-Mobile-0.11.0-win-x64-portable.zip
Windows (ARM64)	Clawd-on-Mobile-0.11.0-win-arm64-portable.zip
Linux	Clawd-on-Mobile-0.11.0-x86_64.AppImage

🙏 致谢

本项目是基于 @rullerzhou-afk（鹿鹿）的 Clawd on Desk 的社区衍生版。衷心感谢原作者创造了这只可爱的桌面小螃蟹并将它开源，也感谢每一位为 Clawd 生态贡献代码、文档、Bug 反馈和创意的开发者——是你们让它变得更好。同时感谢 Anthropic 创造了 Claude。

Clawd 角色版权归 Anthropic 所有。本项目为非官方粉丝作品，与 Anthropic 无关联。

⭐ 如果你喜欢这个项目，欢迎给我们一个 Star!

🎉 Clawd on Mobile v0.10.0

Clawd on Mobile v0.10.0

🎉 重大版本更新 — 新增浮窗审批、远程中继、应用内语言切换，安全性与测试覆盖率大幅提升

---

📦 下载

文件	说明
app-release.apk	Android 8.0+ (API 26+)，arm64-v8a

---

✨ 新功能

🐾 浮窗审批气泡

• 悬浮窗上直接审批权限请求，无需打开 App
• 提示态：小药丸显示"审批（点击展开）"
• 展开态：工具名、摘要、左右滑动拒绝/允许、倒计时进度条
• FIFO 队列管理，多个审批请求排队处理
• 通知与浮窗审批双向同步（approvalCompletedFlow）
• 支持 suggestionIndex（如"始终允许此工具"）

🌐 远程中继（Relay）

• 通过远程 VPS 中继连接 PC 端，支持非局域网环境
• ConnectionStrategy 策略模式：LAN 直连与 Relay 中继完全解耦
• SessionMerger 合并 LAN + Relay 双连接的会话为统一视图
• RelaySettings UI：配置 Relay 地址、Token、状态检查
• Relay 客户端网络切换即时重连
• Peer 连接状态监控（PC 在线/离线）

🌍 应用内语言切换

• 支持中/英文实时切换，无需重启 App
• 三语言 strings.xml 完全同步（values/values-en/values-zh）

⚙️ 桌宠设置增强

• 悬浮窗大小滑块 — 实时预览，启动时自动恢复
• 可配置睡眠超时 — 30s / 1min / 5min / 不睡眠
• 点击穿透开关 — 透明区域触摸穿透到下层应用
• 连接状态卡片合并 — 扫码/手动输入合并为一个界面

---

🔒 安全改进

改进	说明
签名密码移除	gradle.properties 中的明文密码移除，改用环境变量注入
ProGuard 日志清理	release 构建移除 Log.d/Log.v/Log.i，防止敏感信息泄露
网络明文禁止	network_security_config.xml 全局 cleartextTrafficPermitted=false
加密存储	EncryptedSharedPreferences (AES-256-GCM) 保护 Token、证书指纹
TOFU 证书固定	首次 LAN 连接记录证书指纹，后续严格比对

---

🛡️ 鲁棒性改进

改进	说明
loadConfig 根源保护	PrefsStore.loadConfig() 整体 try-catch，防止 EncryptedSharedPreferences 损坏时崩溃
安全调用替代 !!	WsConnectionService.onCreate 消除 NPE 风险
指数退避 + 断路器	1s-30s 抖动退避，10 次后断路，60s 自动恢复
Watchdog 心跳	90s 超时检测静默死连接
WorkManager 审批	后台审批通过 WorkManager 执行，避免 BroadcastReceiver ANR

---

🌐 国际化完善

• 27 个新增字符串资源，三语言完全同步
• RelaySettings 12 处硬编码中文 → stringResource()
• ApprovalBubbleView 8 处硬编码中文 → context.getString()
• WsConnectionService 7 处 relay 状态 → getString(R.string.xxx)
• SettingsScreen "远程中继" → stringResource(R.string.settings_relay)

---

🧪 测试提升

指标	数值
总测试数	548 个（全部通过）
新增测试	103 个
新增测试文件	5 个（SessionMerger、ConnectionLog、TimedConsumeSet、ConnectionStrategy、MessageHandler）
删除无效测试	3 个（占位常量检查）

新增测试覆盖

• SessionMergerTest — 15 个测试：双连接会话合并、注册/注销、Flow 发射
• ConnectionLogTest — 15 个测试：环形缓冲区、并发安全、格式验证
• TimedConsumeSetTest — 28 个测试：TTL 过期、并发消费、边界条件
• ConnectionStrategyTest — 16 个测试：LAN/Relay URL 构建、认证头、异常处理
• MessageHandlerTest — 26 个测试：消息分发、状态更新、Flow 发射

---

🐛 Bug 修复

• 修复悬浮窗拖拽漂移和点击穿透问题
• 修复 Oneshot 状态恢复时错误显示 Working 状态
• 修复 LAN 扫码连接失败问题
• 修复 Error 动画阻塞和 SVG 映射不一致
• 修复 Relay 客户端网络切换不通知问题
• 修复 README CI badge 链接指向错误仓库

---

📊 统计

指标	数值
Android 提交数	65+
代码行数变化	+12,576 / -6,979
测试总数	548
评估置信度	95%
加权质量评分	77/100（初始 71，+6）

---

📝 升级说明

1. 下载 app-release.apk
2. 覆盖安装（数据会保留）
3. 如使用 Relay 功能，在设置页配置 Relay 地址和 Token
4. 重新连接桌面端

---

🙏 致谢

• 原作者 @rullerzhou-afk（鹿鹿）
• 桌面端贡献者：@zxypro1、@sLingli、@cod3hulk、@lxgxhsy、@rebootcrab-blip、@ustin-star

---

🔗 链接

• Android README
• 上游项目

🎉 Clawd on Mobile v0.9.0

📱 Android

新功能

• 🌐 应用内中英文语言切换
• 😴 宠物睡眠超时可配置
• 👆 宠物点击穿透开关
• 📐 宠物大小调节提示
• 🎨 全角色 SVG/APNG 素材（3 个角色）

安全加固 (P0)

• WakeLock 超时保护 + goAsync 安全处理
• 线程安全加固 + allowBackup 禁用
• WebView 安全标志 + EncryptedPrefs + SSE TLS 分级

质量提升 (P1/P2)

• 单例化、去重、验证、清理
• 统一 HTTP 层 + Auth Header + 证书固定
• 事件驱动架构 + 模板抽取 + 缓存上限
• SessionsScreen 902 行拆分为 6 个文件
• PermissionDialog + FloatingPetService 拆分
• SafeExecutor 分级异常处理
• oneshot 动画精确检测 + PrefsStore 统一

修复

• oneshot 恢复不应在任务完成后恢复 Working 状态
• 审批面板 UI 改进 — Allow/Deny 始终可见

测试

• ✅ 197 项测试全量覆盖

🖥️ Desktop (PC)

修复

• WebSocket 升级冲突 — HTTP handler 拦截 WS upgrades
• WebSocket ProtocolException — 移除协议级 ping（OkHttp 兼容）
• QR 码显示问题 — 多项修复
• F12 开发者工具可在设置窗口中启用

重构

• 项目重命名：Clawd on Desk → Clawd on Mobile
• SubagentStop bug 修复

测试

• ✅ 508 项新增测试，共 3637 项

---

📱 Android

✨ New Features

• 🌐 In-app Chinese/English language switcher
• 😴 Configurable sleep timeout in pet settings
• 👆 Click-through toggle in pet settings
• 📐 Pet size hint in settings UI
• 🎨 SVG/APNG assets for all 3 characters

🔒 Security Hardening (P0)

• WakeLock timeout + goAsync safety
• Thread safety + allowBackup disabled
• WebView security flags + EncryptedPrefs + SSE TLS tiering

🛠️ Quality Improvements (P1/P2)

• Singleton pattern, dedup, validation, cleanup
• Unified HTTP layer + Auth Header + certificate pinning
• Event-driven architecture + template extraction + cache limits
• SessionsScreen 902 lines → 6 files
• PermissionDialog + FloatingPetService decomposition
• SafeExecutor tiered exception handling
• oneshot animation precise detection + PrefsStore unification

🐛 Fixes

• oneshot restore should not bring back Working when task is done
• Approval panel UI — Allow/Deny always visible

✅ Tests

• 197 tests, full coverage

---

🖥️ Desktop (PC)

🐛 Fixes

• WebSocket upgrade conflict — HTTP handler intercepting WS upgrades
• WebSocket ProtocolException — remove protocol-level ping (OkHttp compat)
• QR code display — multiple fixes
• F12 dev tools enabled in settings window

♻️ Refactor

• Project renamed: Clawd on Desk → Clawd on Mobile
• SubagentStop bug fix

✅ Tests

• 508 new tests, 3637 total

v0.1.18

🦀 Clawd Mobile v0.1.18

安卓移动端 + 桌面端联动更新。

📱 Android

通知系统重构

• 审批通知与 Elicitation 通知分离，互不干扰
• StatusNotifier 支持 per-session badge 追踪，精确触发完成/失败通知
• 通知 ID 采用确定性哈希，避免 PendingIntent 冲突

审批体验优化

• 通知栏点击可恢复被自动关闭的审批请求
• 支持从通知 Intent 直接还原完整请求数据，Activity 重建不丢失

桌宠状态机

• consumedDoneSessions 确保 Attention 动画只触发一次
• 睡眠序列完整对齐 PC 端（yawning → collapsing → sleeping → waking）
• 60 秒 idle 超时自动进入睡眠，与 PC 端 MOUSE_SLEEP_TIMEOUT 一致

连接与安全

• EncryptedSharedPreferences（AES-256-GCM）加密存储，自动从明文迁移
• OkHttpClient 全局共享单例，连接池复用
• proguard 补充 Tink/安全库混淆规则

构建

• 补全 values-zh 翻译缺失（修复 138 个 lint MissingTranslation 错误）
• lint 配置优化，忽略 UnsafeImplicitIntentLaunch（Receiver 已设置 exported=false）

🖥️ Server

Badge 逻辑修复

• oneshot hookState（attention / error / notification）优先于 sessionState idle 判断
• 修复当 session 状态折叠为 idle 但 hookState 为 attention 时，badge 错误显示为 idle 而非 done 的问题

空安全

• session !== null 改为 session != null，覆盖 Map.get() 返回 undefined 的场景

🍎 Desktop

• dock 图标更新为高清透明背景螃蟹脸
• 清理一次性 extract-dock-icon 脚本

📦 下载

平台	文件
Android	clawd-mobile-0.1.18.apk
Windows	Clawd-on-Desk-Setup-0.8.1-x64.exe / arm64.exe
macOS	Clawd-on-Desk-0.8.1-x64.dmg / arm64.dmg
Linux	Clawd-on-Desk-0.8.1-x86_64.AppImage / amd64.deb

Clawd Mobile v0.1.2

Clawd Mobile — Android 伴侣应用

通过局域网连接 Clawd 桌面端，远程监控 Claude Code 会话状态，随时审批权限请求。

✨ 功能

• 实时会话监控 — 查看所有 Claude Code 会话的状态（工作中/思考中/空闲/休眠等）
• 远程审批 — 当 Claude Code 需要工具权限时，手机端弹出通知，一键允许/拒绝
• QR 扫码配对 — 扫描桌面端生成的二维码自动连接
• 前台服务 — 后台持续运行，断线自动重连
• 状态通知 — 会话状态变化时推送通知，支持点击跳转

📱 系统要求

• Android 8.0+ (API 26)
• arm64-v8a 架构
• 与桌面端在同一局域网

📦 安装

下载 app-release.apk，在手机上直接安装。

🔗 配套桌面端

需要配合 Clawd on Desk 桌面端使用。