Skip to content

Releases

WorkBuddy v3.13.3

Choose a tag to compare

@Hy-ou Hy-ou released this 11 Nov 12:46

WorkBuddy 3.13.3

DSH 布局改为两种选择:

  1. 标准布局(默认):和以前一样,保留 DSH 顶栏、App 底部 6 Tab 与系统状态栏;
  2. 沉浸全屏:点 DSH 顶栏的「全屏使用」后进入,隐藏顶栏/底部导航/系统状态栏,
    页面顶到 y=0,顶部居中浮动「退出全屏」返回标准布局。

改动

  • AppShell:dshImmersive 默认 false,删除「切到 DSH 引擎就强制全屏」的逻辑;
    切换引擎时回到标准布局,全屏只在本次会话内由用户主动进入。
  • DshScreen:顶栏的「全屏使用」按钮保持不变;沉浸时显示「退出全屏」浮层;
    返回键优先退出全屏,再交给 App。
  • 不再出现「一进 DSH 就被强制全屏、找不到底部导航」的情况。

版本与验证

  • 版本 3.13.3 / versionCode 32
  • 58 项单元测试通过,lintDebug 0 error
  • 已在 Redmi 25019PNF3C(Android 17)安装 3.13.3 验证:默认标准布局(DSH 顶栏 + 底部 6 Tab +
    系统状态栏),点顶栏全屏图标 → 沉浸全屏(顶栏/底部导航/系统栏隐藏,顶部「退出全屏」),
    点「退出全屏」恢复标准布局。

安装

adb install -r WorkBuddy-3.13.3.apk
  • 正式包:WorkBuddy-3.13.3.apk(116.8 MB,debug 签名)
  • 调试包:WorkBuddy-3.13.3-debug.apk(127.9 MB)
  • SHA-256 见 SHA256SUMS

WorkBuddy v3.13.2

Choose a tag to compare

@Hy-ou Hy-ou released this 10 Nov 15:15

WorkBuddy 3.13.2

修复「虚拟屏启动应用不生效」:点「启动」后目标没有出现在虚拟屏,App 却提示成功。

根因

  1. 真机上已有同 App 的任务:am start --display <id> 对单实例/已有任务的应用只会把
    旧任务带到前台,实际留在 display 0;旧代码只看 am start 的退出码,误报成功。
  2. 部分 App 会自己回到真机:微信等应用在启动后由自己的进程拉起登录页/主界面,
    这些内部 Intent 不带 launchDisplayId,系统把它们放回 display 0。虚拟屏对此无能为力。

修复

  • 启动前先 am force-stop <pkg>,确保在虚拟屏上创建新任务(不再复用真机旧任务);
  • 启动后等待 2 秒,读 dumpsys activity activities,按 Display #N 段落核对目标包
    实际落在哪块屏;
  • 只有任务真正在虚拟屏上才返回成功;落在真机/找不到任务时返回明确错误,
    并在「在虚拟屏启动应用」卡片下方常驻显示,同时弹一次 Toast;
  • UI 增加说明:启动会结束该 App 在真机上的实例;微信等拒绝副屏的 App 会提示不支持。

验证(Redmi K90 Ultra / M332BF,Android 17,KernelSU + Shizuku root)

通过 DSH 宿主桥 POST /vdisplay(与 Agent 工具同一条路径)实测:

// status
{"state":"on","display":{"id":12,"width":720,"height":1280,"density":320},"ok":true}

// 启动设置
{"ok":true,"message":"已在虚拟屏启动 com.android.settings"}

// 启动微信
{"ok":false,"error":"系统把 com.tencent.mm 放到了真机(display 0),没有落在虚拟屏(display 12)。微信等带登录/单实例重定向的 App 会拒绝副屏;换支持副屏的 App,或改用真机工具。"}
  • 58 项单元测试通过,lintDebug 0 error。
  • 支持副屏的 App(设置、KernelSU、Chrome 等)可以正常启动到虚拟屏;
    微信这类会把界面拉回真机的 App 现在会明确报错,不再假成功。

安装

adb install -r WorkBuddy-3.13.2.apk
  • 正式包:WorkBuddy-3.13.2.apk(116.8 MB,debug 签名)
  • 调试包:WorkBuddy-3.13.2-debug.apk(128.0 MB)
  • SHA-256 见 SHA256SUMS

详见 docs/virtual-display.md。

WorkBuddy v3.13.0

Choose a tag to compare

@Hy-ou Hy-ou released this 09 Nov 17:15

WorkBuddy 3.13.0

修改说明

新增:安卓虚拟屏(Agent 后台操作,不影响真机)

Agent 现在可以在一块不对应物理屏幕的 Android 显示里运行 App,你继续用真机屏幕,两边互不干扰。

  • 原理:系统级 overlay display(开发者选项「模拟辅助显示」同一机制),
    settings put global overlay_display_devices "720x1280/320" 创建;
    通过 Shizuku(uid 2000)执行:
    • am start --display <id> -n <pkg>/<activity> 启动 App 到虚拟屏;
    • input -d <id> tap/swipe/text/keyevent 注入触摸/文字(不抢真机焦点);
    • screencap -d <id> -p 截图(PNG → 应用缓存 vdisplay/latest.png)。
  • 关闭即还原:创建前记录你原本的 overlay_display_devices 值,关闭时原样恢复,
    不污染开发者选项;displayId 优先从 DisplayManager 读取,个别 ROM 不暴露时用截图反查兜底。
  • 控制台:「设置 → 虚拟屏」
    • 开启/关闭,三种预设分辨率(720×1280 / 1080×1920 / 1280×800);
    • 实时画面(1.5 秒自动刷新,可关):点画面 = 在虚拟屏对应坐标点一下,
      可以用来扫码登录、点确认;
    • 文字注入(ASCII 直输;中文走剪贴板粘贴)、返回/桌面键;
    • 搜索并一键启动任意桌面 App 到虚拟屏;
    • Shizuku 授权入口与状态提示。
  • DSH 内核:插件新增 wb_vdisplay(status/start/stop/apps/launch)、
    wb_vscreen(截图路径)、wb_vinput(tap/swipe/key/text);宿主桥新增 POST /vdisplay;
    环境手册新增「虚拟屏」一节:何时用(用户说「别动我手机」)、坐标基准、结束要 stop、
    单实例应用提醒、不碰支付类操作。
  • 原生助手:新增 vdisplay / vlaunch / vscreen / vtap / vswipe / vtype / vkey
    工具(不依赖无障碍,只要求 Shizuku)。

前置条件与限制

  • 需要 Android 10+ 且 Shizuku 已安装并授权;缺一不可,页面和工具都会给出可读提示。
  • 单实例应用(微信等)启动到虚拟屏后,真机上的同一 App 窗口会被移走——这是 Android 多显示器的
    任务语义,不是缺陷;需要两边同时用请选支持多窗口的应用。
  • 银行/支付/部分视频 App 有 FLAG_SECURE,screencap 只能拿到黑图;不要用虚拟屏做支付、转账。
  • 真机熄屏后 overlay 显示可能停止合成,截图会黑/失败;长任务建议保持充电、不清理后台。
  • 虚拟屏与真机共用同一套应用数据(同账号),操作是真实的,不可逆动作必须先确认。
  • 卸载 App 时若虚拟屏仍开着,系统设置会保留;可在开发者选项关闭,或
    settings delete global overlay_display_devices。

完整说明:docs/virtual-display.md

版本与验证

  • versionCode 29 / versionName 3.13.0,与 3.12.0 同签名,可直接覆盖安装。
  • 构建验证::app:assembleRelease / :app:assembleDebug 通过;testDebugUnitTest 58 项通过;
    lintDebug 0 error;插件自检 7 个工具 + 1 段环境手册通过。
  • 已在 Redmi 25019PNF3C(Android 17 / arm64)安装并启动验证:App 正常进入总览/设置/虚拟屏控制台;该机已安装 Shizuku,但测试时未启动/授权,虚拟屏的实机创建/截图/注入未实测。建议安装后重点验证:
    1. 授权 Shizuku → 开启 720×1280 虚拟屏 → 画面出现;
    2. 启动一个 App → 真机屏幕不受影响 → 在画面里点按;
    3. 对 DSH 说「用虚拟屏打开 XX」→ 观察 wb_vdisplay / wb_vscreen / wb_vinput 调用;
    4. 点「关闭虚拟屏」→ settings get global overlay_display_devices 恢复原值。

WorkBuddy v3.11.3

Choose a tag to compare

@Hy-ou Hy-ou released this 08 Nov 14:28

WorkBuddy 3.11.3

修改说明

修复:锁屏后内置网关「停止工作」(进程还在但不应答 / 过夜后进程消失)

现象

  • 锁屏一段时间再回来:通知还在、libwb2api.so 也还在,但锁屏期间网关的定时任务
    (签到 / 保活 / 余额刷新)一条都没跑,/healthz 直接超时;
  • 锁屏过夜更严重:通知消失、进程没了,只能重开 App;
  • 偶发「通知写着网关运行中、实际端口无人应答」。

根因(四层叠加)

  1. HyperOS 的 GreezeManager 锁屏即冻结整个 UID(reason=screen_off,切后台 reason=tobg)。
    它日志里打印了 HasForegroundService 仍判 freeze_able —— 前台服务在这套 ROM 上不是豁免条件。
    冻结按 UID 生效,Go 网关与宿主同 cgroup 一起停摆,wb:gateway wakelock 被置 DISABLED。
  2. 全程没有 wakelock:前台服务只防回收、不防 CPU 休眠,屏幕一灭 Go 的定时器就停。
  3. dataSync 前台服务在 Android 15+ 有 6 小时 / 24 小时后台配额,跑满后 Service.onTimeout()
    默认实现直接抛异常杀进程(锁屏过夜必现)。
  4. 没有恢复路径:onDestroy 无条件杀网关,START_STICKY 重建后不重拉网关,无看门狗、无回前台自检。

修复

  • 前台服务类型 dataSync → specialUse(android.app.PROPERTY_SPECIAL_USE_FGS_SUBTYPE=local_api_gateway),
    新增 WAKE_LOCK、FOREGROUND_SERVICE_SPECIAL_USE 权限;
  • GatewayService:服务存活期持 PARTIAL_WAKE_LOCK(看门狗 30s 幂等续持)、重写 onTimeout()、
    30s 看门狗 ensureRunning()、onTaskRemoved 不跟着停、onDestroy 只在用户主动停止时才杀网关;
  • LocalGatewayManager:ensureRunning() 幂等重拉、stopByUser() / consumeStopRequest()
    区分用户停止与系统回收、watchExit() 进程退出立刻置 Failed(杜绝假活);
  • AppViewModel + MainActivity:ON_RESUME 自检,解锁回前台自动恢复并重挂顺延端口;
  • 设置页「运行体检」新增 锁屏冻结(HyperOS) 引导:一键跳「省电策略」/「自启动管理」。

HyperOS / MIUI 额外设置(应用无法自行豁免)

设置 → 应用设置 → 应用管理 → WorkBuddy → 省电策略 = 无限制;允许自启动;
最近任务里给应用上锁。不设的话系统仍会在锁屏 / 切后台后冻结 UID。

验证(Redmi M332BF / Android 17 / HyperOS)

  • dumpsys activity services → types=0x40000000(specialUse)、isForeground=true;
  • dumpsys power → PARTIAL_WAKE_LOCK 'wb:gateway' 已持有;
  • 关屏 8 分钟:未加白名单时 cgroup.freeze=1、/healthz 超时、wakelock 变 DISABLED(复现);
  • 解锁:cgroup.freeze=0、/healthz 立即 200、wakelock 自动恢复(自愈)。

详细复现与验证命令见 docs/troubleshooting.md 第 12 节。

版本

  • versionCode 27 / versionName 3.11.3

WorkBuddy v3.11.2

Choose a tag to compare

@Hy-ou Hy-ou released this 05 Nov 16:57

WorkBuddy 3.11.2

修改说明

问题:面板导出的账号 JSON 在手机端导入失败

在 Web 面板用「导出」或「批量导出」拿到 JSON 后,到 App「添加账号 → 导入 JSON」选择该文件:

  • 单账号导出(一个对象)直接报错:

    导入失败:invalid json: json: cannot unmarshal object into Go value of type []panel.cockpitAccount
    
  • 批量导出(对象数组)虽然返回成功,但结果是「成功 0 个,跳过 N 个」,
    错误条目为 missing required fields (id=)。

根因:导出格式与导入解析器不一致

面板导出的 JSON 与 auths/workbuddy-*.json 同构,是嵌套形:

{
  "auth": {
    "accessToken": "…",
    "refreshToken": "…",
    "expiresAt": 1753600000,
    "domain": "www.codebuddy.cn",
    "realm": "cn"
  },
  "account": {
    "uid": "…",
    "enterpriseId": "",
    "nickname": "…"
  },
  "device_token": "…"
}

而网关的 POST /panel/api/import/cockpit 之前只接受 cockpit tools 的扁平数组:

[{"uid":"…","access_token":"…","refresh_token":"…","expires_at":1753600000000}]

嵌套对象被 json.Unmarshal 直接拒绝(400);嵌套数组则被扁平结构忽略成空字段,
于是全部条目因缺少 uid/access_token/refresh_token 被跳过。

修复

  • 网关 internal/panel/import.go 新增 parseImportAccounts,同时兼容:
    1. cockpit tools 扁平数组;
    2. 面板单账号导出对象;
    3. 面板批量导出对象数组。
      嵌套形统一折算成导入用的扁平结构:expiresAt 秒→毫秒,realm / enterpriseId /
      device_token 保留。
  • 导入循环改为显式 realm 优先(面板导出文件带 realm),并把 enterprise_id /
    device_token 一并写入 auth 文件。
  • 重新交叉编译内置 libwb2api.so(arm64-v8a / x86_64);App 版本 3.11.2 / versionCode 26。
  • App 导入页提示更新为「支持 cockpit tools 账号数组,也支持本面板导出的凭证 JSON(单个或批量)」。

验证

  • 面板单账号导出文件 → 网关导入 imported=1, skipped=0。
  • 面板批量导出文件(2 条)→ 网关导入 imported=2, skipped=0。
  • 原 cockpit tools 扁平数组仍可导入(回归)。
  • 真机内置网关(arm64-v8a)实测:单账号/批量嵌套文件均导入成功,测试账号已清理。
  • go test ./... 全绿;Android testDebugUnitTest 通过。

安装

覆盖安装即可(与 3.11.1 同签名,保留数据)。

如果手机 App 连接的是远程服务器而非内置网关,需要同时把该服务器上的
workbuddy2api 升级到包含本次导入兼容修复的版本。

WorkBuddy v3.11.1

Choose a tag to compare

@Hy-ou Hy-ou released this 05 Nov 16:23

WorkBuddy 3.11.1

修改说明

问题:DSH 对话每次带 @ 文件引用说明时都被上游内容防火墙拦一次

手机端「日志 → 运行日志」会出现:

WARN: [server] content blocked: outbound body dumped to data/content-blocks/content-block-20261105-154954-….json
(101602 bytes, realm=cn model=deepseek-v4.1-flash upstream_request_id=…)
content-blocked (likely fingerprint false positive) -> degraded prompt retry

网关在同一请求里换降级提示词重试,所以客户端表面正常;代价是每次多一次上游往返,
且降级状态期间 system 提示词被替换成三句中性文本,DSH 的工具约定/项目规范丢失。

根因:DSH 的 @ 路径引用提示词段命中上游黑名单

从手机 App 私有目录 files/gateway/data/content-blocks/ 取出三份被拦落盘体
(11-05 05:27 / 15:36 / 15:49),用面板仓库的 cmd/fingerprint-probe -body-file … -bisect
直连上游二分,33 次探针收敛到 1 条 407 B 最小触发子串:

Tokens prefixed with @ are paths the user explicitly referenced. Relative paths resolve from the
workspace root; absolute paths identify files or directories on the host. A trailing slash marks a
directory: list it when its contents matter. Anything else is a file: use the read tool when its
contents are needed, and do not claim to have inspected it before reading. @"..." quotes a path
containing spaces.

上游按整段逐字匹配,而这段是 DSH 每次渲染 system prompt 都会带的 @ 引用说明,
所以对话一开就撞,和账号、模型、用户内容无关。

修复

  • 网关 internal/upstream/sanitize.go 新增该段的不区分大小写正则改写:
    resolve from → resolve against(一个词,语义不变),并在 sanitizeFeatures
    增加 Tokens prefixed with @ 预检标记。
  • internal/upstream/sanitize_test.go 新增 TestHarnessPathRefRewritten 回归用例。
  • 重新交叉编译内置 libwb2api.so(arm64-v8a / x86_64);App 版本 3.11.1 / versionCode 25。

验证

  • 同一落盘体直打上游:修复前 status=400(code 11-128),修复后 status=200。
  • go test ./internal/upstream -count=1 全绿(含 5 条 Harness 指纹回归)。
  • .so 字节校验:新改写串与预检标记存在。
  • 真机安装后对话,运行日志不再出现 content blocked。

安装

覆盖安装即可(与 3.11.0 同签名,保留数据)。

WorkBuddy v3.11.0

Choose a tag to compare

@Hy-ou Hy-ou released this 04 Nov 11:25

WorkBuddy 3.11.0

修改说明

新增:账号页支持从 JSON 文件批量添加账号(与 Web 面板一致)

Web 面板的「添加账号」弹窗一直有两个页签:「浏览器登录」和「导入 JSON」,可上传 cockpit tools
导出的账号数组一次补号;手机端此前只有 OAuth 授权一条路径,换机或批量补号时只能逐个登录。

本版把同一能力搬进 App:

  • 入口:账号页右下角「添加账号」→ 顶部页签「导入 JSON」→「选择 JSON 文件」。
  • 通过系统文件选择器读取 .json,选中后立即上传(与 Web 端一致),不需要先把文件放进 App 目录。
  • 导入完成就地显示「成功 N 个,跳过 N 个(共 N 个)」;被跳过的条目会列出前 3 条原因
    (缺少 uid / access_token / refresh_token、uid 非法等),失败原因与 Web 端一致。
  • 成功后自动刷新账号列表,无需手动下拉。
  • 与 Web 端共用网关接口 POST /panel/api/import/cockpit(multipart 字段 file):
    按 domain 自动区分国内版 / 国际版,导入后顺带签到/注册激活/查额度;同一 uid
    重复导入为覆盖凭证,保留原有额度与冷却状态。

文件格式

[
  {
    "uid": "123456",
    "nickname": "账号备注",
    "access_token": "...",
    "refresh_token": "...",
    "domain": "www.workbuddy.cn",
    "expires_at": 1767225600000
  }
]
  • 必填:uid、access_token、refresh_token;uid 仅允许字母、数字、-、_,最长 64。
  • expires_at 为毫秒时间戳(缺省或 ≤0 时按一年后处理);domain 属于 workbuddy.ai
    家族时按国际版导入,否则按国内版。
  • 文件必须是账号数组([...]),空数组会被网关拒绝。

边界与提示

  • 单文件上限 32 MiB(与网关 ParseMultipartForm 一致),超出时客户端直接提示。
  • 空文件、读取失败、JSON 格式错误均有中文提示,不会卡在“正在导入”。
  • 连接旧版远程网关(没有该接口)时提示「当前服务器不支持 JSON 导入,请升级网关或改用内置网关」。
  • 演示模式下返回模拟导入结果,便于查看界面。

实现与验证

  • 客户端新增 WbApi.postFile()(OkHttp multipart,默认 5 分钟超时)与
    WbRepository.importCockpit(fileName, bytes);结果模型解析 {ok,total,imported,skipped,errors}。
  • 新增单测覆盖 multipart 上传(路径、Bearer、文件名、文件内容)与 400 invalid json 错误透传;
    testDebugUnitTest 全绿,compileDebugKotlin、lintDebug、assembleRelease 通过。
  • 内置 libwb2api.so 已含 POST /panel/api/import/cockpit 与 Web 端「导入 JSON」页面资源,
    无需重新编译 Go 网关。

升级说明

覆盖安装即可(release 与 debug 包同签名)。历史账号、网关配置与会话均保留。

WorkBuddy v3.10.2

Choose a tag to compare

@Hy-ou Hy-ou released this 27 Oct 11:20

WorkBuddy 3.10.2

修改说明

问题:每天第一次对话必然「撞一次墙」,随后一整天提示词被悄悄换掉

网关日志里能看到这条 WARN(手机上看不到,只在 App 私有目录的日志里):

WARN: [upstream] chat_stream acct=…: upstream 400 content_blocked
body={"code":11-128,"msg":"Illegal API invocation from an unapproved channel",…}
content-blocked (likely fingerprint false positive) -> degraded prompt retry

客户端不会报错(网关在同一个请求里换了提示词重试,返回 200),但代价藏在水面下:

  1. 每次白撞一次上游往返(首字节多等几秒);
  2. 网关进入「降级」状态并持续到次日 00:00,这期间所有 passthrough 请求的 system 提示词
    都被替换成三句中性文本——DSH 的工具约定、项目规范、文件策略整套丢失,助手行为明显变差;
  3. 手机上的网关通常随 App 常驻、不会重启,所以一次误报会锁死一整天,界面上没有任何提示。

根因:不是账号问题,是 DSH 自己的提示词里有上游黑名单字面量

上游内容防火墙是逐字精确匹配(不是语义审核)。本次用新加的二分探针在同账号上 100% 复现,
把「哪一句被拦」收敛到两处,都在内置 DSH 的一手 system prompt 里:

# 触发子串 长度 来源
1 You are an AI agent running on DeepSeek Harness 47 B DSH 身份开场白(harness:identity)
2 You are interacting with the user via the DeepSeek Harness Web GUI … that means this GUI. 221 B DSH 网页端定向段(app:web-surface)

决定性验证:真实渲染的 system prompt(7656 B)→ 400;只去掉第 1 处 → 仍 400;两处都去掉 → 200。
与用户内容、工具声明无关,因此「换账号」和「重试」都不解决问题。

修复

  • 出站改写:网关在请求出站前把这两处各改一个词(powered by→running on、through→via、
    they mean→that means),语义不变、harness 名字保留;上游不再命中,首次请求即 200,不再触发降级。
  • 大小写与引用场景:上游对这族指纹不区分大小写,所以改写用不区分大小写的匹配,
    agent 把提示词原文抄进工具参数/代码/文件时同样会被处理。
  • 取证落盘:万一将来出现新的指纹,网关会把被拦的那份请求体落到 App 私有目录
    data/content-blocks/(单份 8 MiB 上限、保留最近 20 份),配合面板仓库的
    cmd/fingerprint-probe -body-file <文件> -bisect 即可离线定位具体字符串,不用再靠猜。
  • 构建脚本:android/build_gateway.ps1 支持 -SourceRoot(本仓库不含 Go 源码,旧脚本在这里跑不起来),
    并把 Go 源码的提交号打进构建日志,出问题能直接对上网关版本。

验证

  • 真实渲染 system prompt 直打上游:修复前 400 / code 11-128 → 修复后 200;
    关掉脱敏(-sanitize=false)对照仍 400,排除上游抖动。
  • 内置 libwb2api.so(arm64-v8a / x86_64)字节校验:两枚指纹的改写串存在,旧包不存在。
  • 面板仓库 go test ./... 全绿,含 4 条指纹回归用例与 4 条取证落盘用例。

影响面

只在文本命中这两处指纹时改写(system / developer / user / assistant / tool_calls / reasoning_content 全覆盖),
其余请求逐字节不变;custom 提示词模式本身就会替换客户端 system,不受影响。

安装

adb install -r WorkBuddy-3.10.2.apk

debug 包与 release 包同签名,可互相覆盖安装,无需先卸载。

校验

sha256sum -c SHA256SUMS

兼容性

  • 最低 Android 7.0(API 24);本轮验证设备 Xiaomi M332BF(Android 15,arm64-v8a)
  • DSH 内核仅支持 arm64-v8a;x86_64 设备可用网关与原生助手

WorkBuddy v3.10.1

Choose a tag to compare

@Hy-ou Hy-ou released this 25 Oct 09:03

WorkBuddy 3.10.1

修改说明

问题:对话页「添加文件」点了没反应

App 内 DSH 控制台对话页,点输入框左下角「+」→ 菜单里的「文件」后,系统文件选择器完全没有出现:
页面不报错、不弹 toast、也没有任何网络请求。

链路上先厘清一件事

DSH 网页没有独立的「添加附件」按钮。附件入口只有两条:「+」菜单里的「文件」(回形针图标),
以及把文件/图片直接拖进页面。点菜单项时,前端依次执行
ctx.filePicker.open() → input[type=file].click(),之后必须由宿主的
WebChromeClient.onShowFileChooser 拉起一个系统选择器 Activity。前两步在前端,后两步在宿主。

根因

宿主侧 onShowFileChooser 只有一条路径 params.createIntent(),任何一步不成立都走到
catch { return false }:

  • params 为空;
  • 该 Intent 在定制 ROM 上不可启动;
  • ROM 裁掉了对应的 DocumentsUI;
  • launcher 在 Activity 未 RESUMED 时抛异常。

而 WebView 收到 false 是静默放弃——不弹窗,也不打任何日志。于是前端看起来就是
「按钮坏了」,排查时也没有线索。同链路还有两个隐藏缺陷:选择结果只读 data.data
(多选时系统只填 clipData,等于「选多个 = 什么都没选」);上一次没归还的 ValueCallback
会让后续选择器永远不弹。

真机验证

Xiaomi M332BF(Android 15,WebView Chromium 149)实测通过:

  1. 「+」→「文件」弹出系统文件选择器;
  2. 选中 wb-attach-test.txt 后,输入框上方出现附件卡片(名称 + TXT 20B + 移除按钮);
  3. logcat 全链路打通:[wb] file input click → onShowFileChooser mode=... →
    launch ... -> true → picker result code=-1 uris=1;
  4. 另用 debug 包的 WebView 远程调试(CDP DOM.setFileInputFiles)绕过原生选择器直接给
    input 塞文件,卡片同样出现 —— 证明前端入队/上传没问题,此前「选完没反应」确实只卡在原生
    把 URI 交回 WebView 这一段。

修复(ui/dsh/DshScreen.kt)

  • 选择 Intent 兜底链:params.createIntent() → ACTION_OPEN_DOCUMENT →
    ACTION_GET_CONTENT,带 EXTRA_ALLOW_MULTIPLE / EXTRA_MIME_TYPES /
    FLAG_GRANT_READ_URI_PERMISSION,逐条 try,直到某一条真正启动成功。
  • 结果收集:collectPickedUris() 先读 clipData 全部项、再读 data.data 去重,多选可用。
  • 不再挂起 callback:新请求先释放上一个,页面销毁时用 DisposableEffect 归还。
  • FILE_PROBE_JS:把 React 用 hidden 属性渲染的 file input 从 display:none 改成
    1px 不可见块(个别 ROM 的 Blink 会忽略对 display:none 输入框的程序化 click()),
    并在每次点击时输出 [wb] file input click ...。
  • 全链日志:新标签 WbDshFile(宿主回调入参、每条 Intent 的启动结果、选择结果条数)。

安装

adb install -r WorkBuddy-3.10.1.apk

验收清单

  1. 对话页点「+」→「文件」→ 弹出系统选择器;
  2. 选 1 个文件 → 输入框上方出现文件卡片,上传完成后可直接发送;
  3. 选多个文件 → 卡片按选择顺序全部出现(这条在旧版会全部丢失);
  4. 取消选择 → 不报错,可再次点开选择器;
  5. 抓 adb logcat -s WbDshFile WbDshWeb 应能看到
    [wb] file input click ... → onShowFileChooser mode=... → launch ... -> true →
    picker result code=-1 uris=N。

排查

若仍不弹窗,按 logcat 组合定位(详见 docs/troubleshooting.md 第 10 节):

logcat 结论
无 [wb] file input click 前端没点到 input(DSH UI 层,非宿主问题)
有 click,无 onShowFileChooser WebView 没回调
有 onShowFileChooser + launch ... -> false 设备没有可启动的选择器 Activity
有 picker result ... uris=N 宿主侧已通,问题回到前端或上传准入

校验

见附件 SHA256SUMS。

WorkBuddy v3.10.0

Choose a tag to compare

@Hy-ou Hy-ou released this 21 Oct 13:14

WorkBuddy 3.10.0

修改说明

问题:Android 端 Agent 频繁调用 bash 等工具报错

真机上 DSH 内核的 Agent 一跑命令就失败,且反复重试同一个错误。根因三条,都在宿主侧:

  1. Android 没有 bash。 @deepseek-ai/dsh-bash-local 执行的是 spawn("bash", "-c", …),
    系统里只有 /system/bin/sh(mksh)+ toybox;而 bash-sandbox/pwsh-sandbox 在托管补丁里本来就禁用,
    于是「唯一的 shell 工具」正好是跑不起来的那个。
  2. 即使有二进制也 exec 不了。 untrusted_app 不能 exec app_data_file,内核树又落在
    /storage/emulated/0(FUSE,noexec),必须走 nativeLibraryDir 启动器 + /system/bin/linker64。
  3. 模型不知道边界。 内核 system prompt 里没有任何「这台手机有什么」的事实
    (所有文件访问、PATH、工具链、Shizuku、npm),模型只能按 Linux 桌面习惯猜,猜错即报错。

方案:内置 DSH 插件 @workbuddy/dsh-mobile(不是 Agent 预设)

预设只能在已有插件里挑组合,既造不出 shell 通道,也无法把随环境变化的运行时事实写进提示词;
插件是 DSH 里唯一能同时注册「工具」与「提示词段」的位置。

工具 作用
wb_sh /system/bin/sh -c,返回 exitCode/stdout/stderr/timedOut;48 KB 输出上限 + spill 落盘
wb_env 环境体检:可用/不可用命令、PATH、工具链与 npm CLI 清单、共享存储可写性、桥/Shizuku 状态
wb_shizuku 以 uid 2000 执行(pm / input / screencap / settings / dumpsys),经宿主回环桥转发
wb_notify 系统通知(长任务结束提醒)

外加系统提示词段 workbuddy:android-environment(order 1050):工作区与绝对路径约定、
「所有文件访问」已授予、POSIX-only 语法与 toybox/GNU 差异、npm/pnpm 位置、工具链安装位置、
Shizuku 提权边界、以及「报错先读 stderr、禁止原样重试」。

同时做的兜底

  • home/bin 增加 bash/sh 链接 → libwbnode_shim.so,shim.c 把它们落到 /system/bin/sh,
    并解析 #!/bin/bash、#!/bin/sh shebang —— 官方 bash 工具因此也能跑(POSIX 语法)。
    顺带删掉 shebang 分支里那条会以无参方式 exec 解释器的兜底调用。
  • 宿主桥新增 POST /shell(Shizuku;未授权返回 409 + 原因),POST /health 返回 Shizuku 状态。

工程细节

  • 插件源码 android/dsh/assets/dsh-plugins/wb-mobile/(零依赖 ESM,只 import node:),
    构建时经 sourceSets.main.assets.srcDir("../dsh/assets") 并入 APK。
  • 运行时由 dsh/MobilePlugin.kt 复制到
    dshhome/profiles/web/node_modules/@workbuddy/dsh-mobile 并登记到 InstalledPlugins,
    cordis.patch.yml 的 insert 行(id wb-mobile)随之写入。
    必须放 profile:DSH loader 用 profile 作 baseUrl 解析包名,放内核树会 ERR_MODULE_NOT_FOUND。
  • 离线自检:node android/dsh/tests/wb-mobile.selftest.mjs
    (校验 4 个工具的 JSON Schema、渲染与失败路径;已用内核自带的 assertSupportedJsonSchema 交叉验证)。

安装

adb install -r WorkBuddy-3.10.0.apk

升级后请重启内核(设置 → 助手引擎,或杀掉 DSH 进程后重进「助手」页):
插件的加载发生在内核启动时,PATH 与 home/bin 链接同理。

真机验收清单

  1. 让 Agent 运行 wb_env → 返回体检报告(工作区可写、/system/bin/sh、命令清单);
  2. 让 Agent 用 wb_sh 执行 ls /sdcard/Download → 目录列表,不再是 ENOENT;
  3. 让 Agent 用 bash 工具执行 echo hi → 也应成功(启动器映射到 mksh);
  4. 未授权 Shizuku 时用 wb_shizuku 执行 pm list packages → 明确提示未授权且不重试;
  5. 授权后同一条命令 → 包名列表。

校验

见附件 SHA256SUMS。