DSHBox v1.5.0

v1.5.0（versionCode 9）— AI 浏览器助手、系统文件共享区与 DSH 界面交互升级

感谢你使用 DSHBox！如果使用中遇到问题或有改进建议，欢迎通过 Issues 反馈——你的反馈会让它变得更好。

新增

Browser 模块

• 独立的内置浏览器：新增全屏 Browser 工作区，提供前进、后退、刷新、地址输入、页面内查找、页面缩放、多页面管理和外部应用打开等常用能力。搜索引擎可选必应、谷歌、百度，默认必应；紧凑工具栏与可滚动菜单为网页保留更多显示空间。
• DSH 网页助手工具：新增 browser-use 适配插件与沙箱 CLI，向 DSH 开放 24 项工具，支持观察网页、读取内容、定位元素、点击、输入、滚动、导航及条件等待。新用户默认装配，可在 Cordis 面板独立开关；网页助手与操作手机原生应用的 Pilot 分工独立，由 DSH 选择调用。
• 网页窗口与事件：支持管理网页打开的子页，将新窗口、网页对话框及下载事件与操作关联；自动弹窗受授权约束，已打开的子页可继续读取和操作。
• 元素与区域反馈：顶部增加选取入口，可切换元素或区域模式；框选后添加评论，将页面信息、所选内容与截图提交给已绑定的 DSH 会话，便于 AI 看图分析、理解页面和继续操作。提供投递状态反馈。
• 沙箱本地网页预览：支持通过 CLI 为沙箱内 HTML 等文件启动本地静态服务，也可登记已有开发服务，在 Browser 内打开预览；选区反馈可携带对应项目上下文，用于「制作网页—查看效果—框选评论—交给 AI 修改」的工作流程。
• 页面观察与调试：提供 DOM、控制台、脚本求值和设备模拟等调试入口；在相应能力可用时，可通过网页辅助功能树（AX）补充观察和操作。支持有界滚动采集及结构化内容提取，返回采集范围与截断信息。
• 网络抓取与处理：支持请求/响应、状态码、耗时、请求头、响应头、正文查看及 HAR 导出；可在单独授权下使用请求拦截、修改和重放，并记录、查看和导出 WebSocket 帧。正文与帧载荷按各自开关控制。
• 截图与后台执行：支持前台与后台网页截图；普通后台截图失败时，在已开启高级调试的条件下串行尝试 CDP 后备，未开启时返回明确提示。后台打开网页和上传准备不主动把整个 Browser 页面拉到前台。
• 文件上传与下载：提供下载任务及列表管理，可保存到手机、分享到其他应用或删除浏览器副本；上传支持由 AI 申请项目文件，显示目标站点和文件信息，经用户批准后交给网页文件控件。后台准备、用户批准与网页实际接收分别处理。
• 任务与控制权管理：新增持久任务记录，可查看、编辑、删除及向 AI 发送续接摘要；用户接管 AI 操作前增加确认，AI 控制关闭时可发起控制权申请，由用户审批。
• 常用记录与设置：提供持久历史记录、收藏夹、收藏切换、记录管理及浏览数据清理；支持移动、桌面、宽屏显示模式和可设置的闲置关闭时间。Browser 界面跟随应用的主题与六语选择。
• 界面与模块切换：历史、收藏、下载和设置使用统一管理面板，菜单内部滚动，适应横屏及小窗口；提供 AI 活动提示，点击 AI 标记可快速返回 DSH。
• 会话与产物管理：有效 AI 操作维持会话，隐藏后按设定的闲置时间关闭；截图、选区、上传副本及网络产物集中管理，纳入过期及缓存清理，用户下载和已导出文件按各自规则保留。
• 操作结果反馈：工具返回页面状态与执行结果，区分明确失败和结果不确定；对过期页面引用、已变化节点及迟到回调作校验，为连续操作提供依据，避免直接重复可能已生效的动作。

其他模块

• 新手安装引导页：新增欢迎、Debian 安装、Node.js 安装、WebView 检测及完成提示组成的分步引导。安装页支持多镜像源探测与选择、阶段进度、失败重试，并按实际安装状态处理前置依赖与未完成安装；中途退出或安装尚未完成时，可继续补齐缺失层。
• 引导内的 WebView 版本探测提示：展示当前 WebView 提供方、版本和 Chromium 主版本；版本偏低或检测失败时给出兼容性提示、升级建议及检测信息复制入口，帮助定位白屏、页面加载异常等问题。特性支持提示按版本推断，精确检测仍可进入诊断页。
• 系统文件共享区：授权后在手机公共存储创建或沿用 DSHBox 专用文件夹，并映射到沙箱共享区。文件管理、DSH、终端及其他有权限的应用访问的是同一份本地文件，便于手机、沙箱和电脑之间互传内容。
  • 可选择其他系统公共目录加入共享区，以独立名称挂载；文件管理和附件选择器均提供共享区入口。
  • 挂载条目可一键进入「取消挂载」并确认；取消只移除挂载关系，不删除系统目录或其中的文件。新挂载按提示重启相关运行会话后生效。
  • 挂载前检查权限、实际可写性及路径范围，对重复或重叠目录作校验；列表展示、目录选择与沙箱绑定使用一致的挂载信息。
  • DSHBox 专用共享文件夹及用户挂载的源目录不属于应用私有数据，卸载或重装 App 不会自动删除其中的文件；重装后需重新授予访问权限，额外挂载关系需重新配置。用户主动删除或清空文件仍按对应操作生效。
• 外部文件接收：支持其他应用「分享到」或「用其他应用打开」后导入 DSHBox，并选择保存目录；兼容多文件与纯文字接收，重名自动改名，连续分享按批次处理，减少重复导入或覆盖原文件。
• 文件直接分享至外部 App：文件行菜单新增独立的「分享」入口，调起系统分享面板选择接收应用；与原有「导出」分开，减少复制到外部应用的步骤。
• 首页系统状态卡：新增 CPU、温度、内存和存储信息，标明 CPU 与温度数据来源，并对不同机型的可读取能力作适配。

修复

• DSH 附件多文件上传：修复系统选择器多选返回后附件全部丢失、单选却正常的问题，收集并去重系统返回的多文件结果；尊重网页的单选/多选要求，取消选择时正确结束本次上传请求。
• 首次安装插件虚假开关：修复「手机页面适配」「手机助手」等自有插件显示开启却未实际装配到 DSH 的问题；在 DSH 就绪后触发装配，串行处理安装与更新。装配失败保留用户开关意图，后续就绪时可补装；升级保留用户明确关闭的设置。
• Pilot 主题跟随：修复 Pilot 页面与审批卡片未及时跟随 App「系统/浅色/深色」设置的问题，统一主题配置来源，避免必须重启才能同步。
• DSH 启动状态：修复首页 DSH 卡片点击「启动」后仍显示「已停止」的问题，补齐「启动中」状态并限制重复启动，设置页同步相同状态口径。
• DSH 返回键断点：通过移动适配插件补齐 DSH 内部层级与设备返回键之间的衔接，支持逐级收起设置、侧栏及相关面板；DSH 根页面返回进入前的 App 页签，文件页等根页面按各自层级退出。
• 键盘与页面稳定性：抑制非用户手势引发的输入框自动聚焦，减少切会话、打开菜单后的键盘异常弹起及页面位移；保留用户主动输入，修复「+」菜单重复点击无法正确收起及切页焦点残留。
• 运行环境完整性判断：修复旧安装判定仅凭部分目录存在就认定环境可用的问题，校验运行配置与各层实际状态，避免中断或缺层环境被误判为已安装。
• 沙箱启动兼容性：修复了部分厂商内核（如三星 One UI 7/8）禁止 proot 执行宿主机系统二进制、导致沙箱无法启动的问题：把 proot 内的 guest 入口从被内核以 EPERM 拒绝执行的宿主 /system/bin/sh 改为 rootfs 自带的 /usr/bin/bash 和 node，绕开该限制，正常设备行为不变。

优化

• 首页整体布局：由分散入口卡片改为「控制 / Pilot / Cordis」三页签，可切换和滑动访问；控制页集中展示沙箱、DSH 与系统状态，Pilot 与 Cordis 融入统一首页，细分子页按需全屏展示。设置入口迁移到首页右上角，底部导航调整为首页、文件、DSH、终端和 Browser。
• DSH 全屏与悬浮快捷操作：DSH 页面全屏显示，减少顶部和底部导航占用；悬浮球升级为常驻快捷入口，新增点击展开的快捷条，可刷新页面或快速切换到首页、文件、终端和 Browser，保留拖动，并支持长按按当前状态刷新或重试。
• DSH 附件传输通道：对话输入框工具行新增附件图标直达入口，点击唤起原生底部来源面板，集中提供拍照、录像、相册、手机文件、音频、工作区文件和共享区文件七类来源。来源面板与移动适配插件解耦，并统一目录选择、权限申请、取消与回填流程。
• mobile-adapt 适配：完善输入框、菜单、返回键和附件入口的移动端衔接，减少自动聚焦、层级断点及页面不稳定带来的干扰；对 DSH 的适配继续由插件与运行期接线承担，不修改上游 DSH 源码。
• Pilot 命名与页面风格：原 DshPilot 首页入口统一为 Pilot；优化根页标题、子页顶栏、留白及深浅色背景，减少与首页容器之间的色差、重复边距和切换跳动。
• 文件管理交互：顶部搜索、根目录切换与「+」入口重新布局；常用导入、新建、拍摄、解压及导出操作集中到底部面板，统一目录选择器、刷新提示、图标和菜单样式。

残留问题

1. 插件市场兼容问题：本版本暂不推送相关修复。上游 DSH 的下一个正式 RC 版本尚未发布，Alpha 版本变更频繁、稳定性不足，且涉及较多插件相关调整。为确保稳定性，插件适配将在 DSH 下一个 RC 版本发布后同步更新。
2. DSH Alpha 升级与回退兼容性：出于稳定性考虑，本版本未随包搭载最新 Alpha。现有测试中，用户可自行通过设置中的 DSH 模块在线更新入口升级体验，可正常使用；但 Alpha 与稳定 RC 之间存在兼容性问题，回退到稳定 RC 后可能出现对话数据相关故障。后续 DSHBox 将统一跟进并随包提供最新稳定 RC 版本。

能力边界：网页助手作用于内置 Browser；手机原生 App 操作仍由 Pilot 承担。高级调试及网络修改使用各自开关和授权。复杂跨页面任务恢复、长时流式响应、复杂媒体与部分内核/站点兼容场景仍待完善，不作为本版已全面覆盖的能力。

验证：全量 JVM 测试记录为 1768 项通过、55 项跳过，Browser 插件 Linux 测试 161 项通过、4 项跳过；Release 构建、签名及关键包内资产核对通过。设备验证覆盖本轮限定的基础网页操作、截图、选区图文投递、新窗口授权、文件传输与管理、新装工具调用及关闭开关后的覆盖安装保留。

三个安装包说明

包	作用
dshbox-v1.5.0-release.apk	App 初始安装包（约 112.5 MiB），大部分内核可兼容，直接安装使用即可
dshbox-v1.5.0-fix-release.apk	App 部分厂商内核兼容修复包（约 112.5 MiB），修复部分厂商内核禁止 proot 执行宿主机系统二进制、导致沙箱无法启动的问题

为了减少已经正常使用老用户的更新次数，所以修复包本次不推送新版本。
自 v1.4.0 版本起，以下两部分均可在 App 设置页通过在线导入运行环境获得，不必单独下载。

包	作用
dshapp-runtime-debian-arm64-0.1.0.zip	运行环境整包，在设置页「离线导入运行环境包」
0.2.0-rc.2.tar.zst	官方 DSH 离线更新包，在设置页「更新 DSH（离线）」导入

---

WebView 版本较低时，内置 DSH 发生页面白屏、工作区加载异常等问题：
本版本已经在首次安装引导中增加 WebView 版本探测与兼容提示：

1. 如果 DSH 页面白屏，但从首页使用系统浏览器可以正常打开，应优先检查系统 WebView 版本。
2. 首次安装引导会显示 WebView 提供方、版本与 Chromium 主版本；设置页诊断功能也可查看相关信息。
3. 可通过 Google Play 更新 Android System WebView；无法使用 Google Play 时，可咨询 AI，选择适合设备系统版本与架构的 WebView 版本及升级方式。

如果你觉得 DSHBox 有用，欢迎在仓库首页点亮一个 Star！支持一下！