[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-95108":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":11,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":14,"stars30d":14,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":15,"rankGlobal":9,"rankLanguage":9,"license":16,"archived":17,"fork":17,"defaultBranch":18,"hasWiki":17,"hasPages":17,"topics":19,"createdAt":9,"pushedAt":9,"updatedAt":27,"readmeContent":28,"aiSummary":29,"trendingCount":14,"starSnapshotCount":14,"syncStatus":30,"lastSyncTime":31,"discoverSource":32},95108,"DSHA","qiannianhuanxiang\u002FDSHA","qiannianhuanxiang","DeepSeek Harness 安卓启动器：内置 proot+Ubuntu，免 ROOT 免 Termux 一键运行 deepseek-harness，多源测速\u002F分步安装\u002FWebUI 预览\u002F设备 Shell 桥接",null,"Java",101,11,3,0,43.24,"MIT License",false,"main",[20,21,22,23,24,25,26],"android","deepseek","launcher","llm","proot","shizuku","webui","2026-08-24 04:01:23","# DSHA\n\n> 下一个 AI \u002F 开发者请先读 **[AGENTS.md](AGENTS.md)**，不要先全库扫描。\n\n**DeepSeek Harness 安卓启动器** —— 在手机上跑 deepseek-harness 的一体化方案，无需 Termux、无需 ROOT。\n\n内置 proot + Ubuntu rootfs，一键（或分步）安装 deepseek-harness，内嵌 WebView 直接使用 Web UI。\n\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](LICENSE)\n\n## ✨ 功能\n\n| 功能 | 说明 |\n|---|---|\n| **装完即用** | 内置 Ubuntu 24.04 + Node 24 + dsh（默认 rc.8），首启解压即可用 |\n| **ADB 无线通道** | 免 Shizuku 直连设备：配对一次永久授权，看门狗自动重连、开机自启、永不掉线 |\n| **设备 Shell 引导** | 内置插件让 agent 主动用 `\u002Froot\u002Fdsh-bin\u002Fadb-shell` 操作手机（查应用\u002F启动应用\u002F抓日志…） |\n| **自动备份体系** | 每 N 次启动\u002F升级自动备份到 Download\u002FDSHA，重解压数据保护，卸载重装不丢 |\n| **自愈能力** | busy 超时释放 \u002F Web 自动重试 \u002F 崩溃恢复提示 \u002F 内置插件防消失 \u002F 检测 dsh 新版自动适配 |\n| **多源加速** | npm\u002Frootfs\u002FNode 全部走国内镜像（npmmirror\u002F清华\u002F华为云…），多级回退 |\n| **插件市场** | 过滤非插件\u002F仅兼容筛选\u002F排序优化，内置插件可管理 |\n| **免 ROOT 文件共享** | 集成 MT 管理器官方文件提供器，直接浏览\u002F编辑 App 私有数据 |\n| **WebUI 移动端适配** | 单栏\u002F抽屉\u002F汉堡\u002F全屏设置，移动端开箱即用 |\n\n## 🚀 快速上手\n\n1. 安装 APK（仅 arm64 \u002F Android 8.0+；GitHub Actions 产物已内置完整 Linux 环境）\n2. 首次启动解压内置环境（数分钟，只需一次）\n3. 「配置」页填入 DeepSeek API key（可选勾选「启用 ADB 设备通道」）\n4. 「启动」页启动 Web UI，自动打开预览\n\n## 🔧 构建\n\n公开仓库用 GitHub Actions 免费构建（**不需要电脑、不需要 Termux**）：\n\n1. 推送到 `main`（或在 Actions 页点 Run workflow）\n2. 流水线分两段：\n   - `ubuntu-24.04-arm`：原生 arm64 chroot 预装 Ubuntu + Node + dsh rc.8\n   - `ubuntu-latest`：把离线包打进 APK\n3. 在 Actions 的 Artifacts 下载 `dsha-debug-apk`\n\n本地：\n\n```sh\n.\u002Fbuild.sh   # 需要 Gradle 8.5 + Android SDK + JDK 17\n```\n\n## 🧱 技术架构\n\n- **UI**：原生 Android（Java）+ Material3 + BottomNavigationView\n- **执行层**：Termux 官方 `proot` 二进制（`\u002Fsystem\u002Fbin\u002Flinker64` 启动，绕过 Android 10+ W^X）\n- **rootfs**：Ubuntu base 24.04 arm64（约 30MB，多镜像下载）\n- **运行时**：Node.js 24 + pnpm + dsh（默认 rc.8，npm 镜像安装，失败即明确报错不克隆）\n- **设备通道**：ADB 无线（TLS 直连）+ Shizuku 桥双通道；WRITE_SECURE_SETTINGS 开机自启\n- **文件共享**：MT 管理器 `MTDataFilesProvider` 编程注入\n\n## ⚠️ 注意\n\n- 仅支持 arm64-v8a 设备，Android 8.0+\n- 环境存储在 App 私有空间，卸载即清除（可先用「备份配置」）\n- 设备 Shell 能力需要「启用 ADB」并首次配对（输 6 位码），之后自动维护\n- QQ交流群960636357🐧\n\n## 📱 ADB 无线配对教程（设备 Shell 能力）\n\nDSHA 内置 ADB 无线通道（免 Shizuku），配对一次后永久授权，看门狗自动维护不掉线。\n\n### 首次配对（约 1 分钟）\n\n1. **App 配置页** → 勾选「启用 ADB 设备通道」→ 点「保存配置」\n2. 手机系统：**设置 → 开发者选项 → 无线调试** → 打开\n3. 点「**使用配对码配对设备**」→ **不要切回 App**，直接在通知栏操作：\n   - 下拉通知 → 找到 DSHA 的「输码配对」卡片\n   - 点「输码配对」→ 在通知栏直接输入屏幕上的 **6 位码**\n   - ⚠️ 配对码切回 App 即销毁，**记下来也没用**，必须在通知栏里输入\n4. 配对成功通知会显示 ✅，自动获得 `uid=2000(shell)` 设备权限\n\n### 配对之后（自动维护，无需再操作）\n\n| 场景 | 自动行为 |\n|---|---|\n| App 重启 | 启动体检自愈，自动恢复连接 |\n| 手机重启 | BootReceiver 自动拉起 + 看门狗重连（已授权 WRITE_SECURE_SETTINGS 时自动开无线调试） |\n| 无线调试被系统关闭 | 看门狗自动重开（有权限）或通知提醒 |\n| 端口变化 | mDNS 自动发现新端口，无需重新配对 |\n| 掉线 | 30 秒看门狗周期自动重连 |\n\n### 验证配对成功\n\n配置页状态应显示：\n```\n● ADB 运行中（已连接，uid=2000 shell）\n```\n\n或在 App 终端执行：\n```bash\n\u002Froot\u002Fdsh-bin\u002Fadb-shell id\n# 输出 uid=2000(shell) gid=2000(shell) 即成功\n```\n\n### 让 AI 助手使用 ADB\n\n配对后，**新开一个对话**，AI 助手会自动获得「设备操作能力」引导（标准\u002F极简模式均支持），你可以直接问：\n\n- 「我手机现在前台是什么应用？」\n- 「打开微信」\n- 「帮我看看手机上的通知」\n\nAI 会通过 `\u002Froot\u002Fdsh-bin\u002Fadb-shell` 操作你的手机（uid=2000，非 root，破坏性操作会先征得同意）。\n\n### 常见问题\n\n| 问题 | 解决 |\n|---|---|\n| 提示\"未连接\" | 确认无线调试已开启；配对的 6 位码 2 分钟过期，重新配对 |\n| 配对失败 | 重新点「使用配对码配对设备」生成新码再输 |\n| 需要重新授权 | 系统安全设置可能清除授权，重开无线调试重新配对一次 |\n| 换手机\u002F重置 | 重新走首次配对流程即可 |\n\n## 💬 交流 & 插件推荐\n\n**🐧 QQ 交流群：960636357**\n\n- **进群玩最新测试版**：正式版发布前，群里第一时间体验新功能\u002F修复，直接反馈 bug 给开发者\n- **插件推荐**：群里不定期分享好用的 dsh 插件（技能包\u002F主题\u002F工具增强），不知道怎么装插件也可以进群问\n- 遇到问题（安装失败\u002FADB 配对\u002F插件异常）优先进群，附上日志更快解决\n\n> 提示：插件安装路径 `dsh plugin --profile web add \u003C插件名>`，或 App「插件市场」直接搜。\n","DSHA 是一款面向安卓设备的 DeepSeek Harness 一体化启动器，无需 ROOT 和 Termux 即可运行 LLM 工具链。项目基于 proot 构建轻量 Ubuntu 24.04 ARM64 环境，预装 Node.js 24 与 deepseek-harness（rc.8），支持一键解压启动、多源镜像加速安装、WebUI 移动端自适应预览，以及通过 ADB 无线通道实现免 Shizuku 的设备 Shell 操作能力（uid=2000）。内置自动备份、崩溃自愈、插件管理与 MT 管理器文件共享集成，适用于移动端本地 LLM 推理、AI 助手开发调试及轻量级 AI 应用实验场景。",2,"2026-08-21 02:30:11","CREATED_QUERY"]