Repository navigation
Releases
WorkBuddy v3.13.3
WorkBuddy 3.13.3
DSH 布局改为两种选择:
- 标准布局(默认):和以前一样,保留 DSH 顶栏、App 底部 6 Tab 与系统状态栏;
- 沉浸全屏:点 DSH 顶栏的「全屏使用」后进入,隐藏顶栏/底部导航/系统状态栏,
页面顶到 y=0,顶部居中浮动「退出全屏」返回标准布局。
改动
AppShell:dshImmersive默认false,删除「切到 DSH 引擎就强制全屏」的逻辑;
切换引擎时回到标准布局,全屏只在本次会话内由用户主动进入。DshScreen:顶栏的「全屏使用」按钮保持不变;沉浸时显示「退出全屏」浮层;
返回键优先退出全屏,再交给 App。- 不再出现「一进 DSH 就被强制全屏、找不到底部导航」的情况。
版本与验证
- 版本 3.13.3 / versionCode 32
- 58 项单元测试通过,
lintDebug0 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
WorkBuddy 3.13.2
修复「虚拟屏启动应用不生效」:点「启动」后目标没有出现在虚拟屏,App 却提示成功。
根因
- 真机上已有同 App 的任务:
am start --display <id>对单实例/已有任务的应用只会把
旧任务带到前台,实际留在 display 0;旧代码只看am start的退出码,误报成功。 - 部分 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 项单元测试通过,
lintDebug0 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
WorkBuddy v3.13.0
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。
版本与验证
versionCode 29/versionName 3.13.0,与 3.12.0 同签名,可直接覆盖安装。- 构建验证:
:app:assembleRelease/:app:assembleDebug通过;testDebugUnitTest58 项通过;
lintDebug0 error;插件自检 7 个工具 + 1 段环境手册通过。 - 已在 Redmi 25019PNF3C(Android 17 / arm64)安装并启动验证:App 正常进入总览/设置/虚拟屏控制台;该机已安装 Shizuku,但测试时未启动/授权,虚拟屏的实机创建/截图/注入未实测。建议安装后重点验证:
- 授权 Shizuku → 开启 720×1280 虚拟屏 → 画面出现;
- 启动一个 App → 真机屏幕不受影响 → 在画面里点按;
- 对 DSH 说「用虚拟屏打开 XX」→ 观察
wb_vdisplay/wb_vscreen/wb_vinput调用; - 点「关闭虚拟屏」→
settings get global overlay_display_devices恢复原值。
WorkBuddy v3.11.3
WorkBuddy 3.11.3
修改说明
修复:锁屏后内置网关「停止工作」(进程还在但不应答 / 过夜后进程消失)
现象
- 锁屏一段时间再回来:通知还在、
libwb2api.so也还在,但锁屏期间网关的定时任务
(签到 / 保活 / 余额刷新)一条都没跑,/healthz直接超时; - 锁屏过夜更严重:通知消失、进程没了,只能重开 App;
- 偶发「通知写着网关运行中、实际端口无人应答」。
根因(四层叠加)
- HyperOS 的 GreezeManager 锁屏即冻结整个 UID(
reason=screen_off,切后台reason=tobg)。
它日志里打印了HasForegroundService仍判freeze_able—— 前台服务在这套 ROM 上不是豁免条件。
冻结按 UID 生效,Go 网关与宿主同 cgroup 一起停摆,wb:gatewaywakelock 被置DISABLED。 - 全程没有 wakelock:前台服务只防回收、不防 CPU 休眠,屏幕一灭 Go 的定时器就停。
dataSync前台服务在 Android 15+ 有 6 小时 / 24 小时后台配额,跑满后Service.onTimeout()
默认实现直接抛异常杀进程(锁屏过夜必现)。- 没有恢复路径:
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
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,同时兼容:- cockpit tools 扁平数组;
- 面板单账号导出对象;
- 面板批量导出对象数组。
嵌套形统一折算成导入用的扁平结构: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 ./...全绿;AndroidtestDebugUnitTest通过。
安装
覆盖安装即可(与 3.11.1 同签名,保留数据)。
如果手机 App 连接的是远程服务器而非内置网关,需要同时把该服务器上的
workbuddy2api升级到包含本次导入兼容修复的版本。
WorkBuddy v3.11.1
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
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
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),但代价藏在水面下:
- 每次白撞一次上游往返(首字节多等几秒);
- 网关进入「降级」状态并持续到次日 00:00,这期间所有 passthrough 请求的 system 提示词
都被替换成三句中性文本——DSH 的工具约定、项目规范、文件策略整套丢失,助手行为明显变差; - 手机上的网关通常随 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.apkdebug 包与 release 包同签名,可互相覆盖安装,无需先卸载。
校验
sha256sum -c SHA256SUMS兼容性
- 最低 Android 7.0(API 24);本轮验证设备 Xiaomi M332BF(Android 15,arm64-v8a)
- DSH 内核仅支持 arm64-v8a;x86_64 设备可用网关与原生助手
WorkBuddy v3.10.1
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)实测通过:
- 「+」→「文件」弹出系统文件选择器;
- 选中
wb-attach-test.txt后,输入框上方出现附件卡片(名称 +TXT 20B+ 移除按钮); - logcat 全链路打通:
[wb] file input click→onShowFileChooser mode=...→
launch ... -> true→picker result code=-1 uris=1; - 另用 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 个文件 → 输入框上方出现文件卡片,上传完成后可直接发送;
- 选多个文件 → 卡片按选择顺序全部出现(这条在旧版会全部丢失);
- 取消选择 → 不报错,可再次点开选择器;
- 抓
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
WorkBuddy 3.10.0
修改说明
问题:Android 端 Agent 频繁调用 bash 等工具报错
真机上 DSH 内核的 Agent 一跑命令就失败,且反复重试同一个错误。根因三条,都在宿主侧:
- Android 没有 bash。
@deepseek-ai/dsh-bash-local执行的是spawn("bash", "-c", …),
系统里只有/system/bin/sh(mksh)+ toybox;而bash-sandbox/pwsh-sandbox在托管补丁里本来就禁用,
于是「唯一的 shell 工具」正好是跑不起来的那个。 - 即使有二进制也 exec 不了。
untrusted_app不能 execapp_data_file,内核树又落在
/storage/emulated/0(FUSE,noexec),必须走nativeLibraryDir启动器 +/system/bin/linker64。 - 模型不知道边界。 内核 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/shshebang —— 官方 bash 工具因此也能跑(POSIX 语法)。
顺带删掉 shebang 分支里那条会以无参方式 exec 解释器的兜底调用。- 宿主桥新增
POST /shell(Shizuku;未授权返回 409 + 原因),POST /health返回 Shizuku 状态。
工程细节
- 插件源码
android/dsh/assets/dsh-plugins/wb-mobile/(零依赖 ESM,只 importnode:),
构建时经sourceSets.main.assets.srcDir("../dsh/assets")并入 APK。 - 运行时由
dsh/MobilePlugin.kt复制到
dshhome/profiles/web/node_modules/@workbuddy/dsh-mobile并登记到InstalledPlugins,
cordis.patch.yml的 insert 行(idwb-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 链接同理。
真机验收清单
- 让 Agent 运行
wb_env→ 返回体检报告(工作区可写、/system/bin/sh、命令清单); - 让 Agent 用
wb_sh执行ls /sdcard/Download→ 目录列表,不再是 ENOENT; - 让 Agent 用 bash 工具执行
echo hi→ 也应成功(启动器映射到 mksh); - 未授权 Shizuku 时用
wb_shizuku执行pm list packages→ 明确提示未授权且不重试; - 授权后同一条命令 → 包名列表。
校验
见附件 SHA256SUMS。