把 SDK 当被测对象:一份规格管住五个入口

简介: Droidline 以 `spec/commands.json` 为唯一契约,统一定义命令名、参数与三语错误文案,自动生成 Python/Node.js/.NET SDK 及 MCP 工具清单,并通过 CI 自动校验一致性。文档≠契约,可机器比对的规格才是真接口规范。

同一个动作,Python SDK 里叫 touch,命令行里也叫 touch,到了 MCP 工具清单里还得叫 touch。功能一致,名字也必须一致。

这件事靠人盯不住。五个入口分给五个人写,文档改一次,五份实现各改各的,漏一份没人知道,直到调用方换入口才发现对不上。

Droidline 的做法可以拆给测试开发看:全部命令和三语错误文案写进仓库根目录的一份 spec/commands.json,Python、Node.js、.NET 三个 SDK 加 MCP 工具清单都由这份文件生成。CI 里跑校验,SDK 方法跟规格不一致直接挂。

这里被测对象变了。以前测的是手机上的 App,现在还得测 SDK 本身。它怎么保持五个入口一致,本身就是一套可验证的工程。

文档不是契约,能被校验的才算
先把概念摆正。spec/commands.json 不是给人读的说明,是给构建流程读的契约。

它定义了命令名、参数、错误文案。三个 SDK 和 MCP 清单从它生成,意味着规格只有一份,实现可以有五份。要保持一致的是生成过程,不是五个写代码的工程师。

实际上的分水岭在这里:写在文档里的规则,违反了大概率没人发现;进了 CI 的规则,违反了一次也合并不进去。很多团队说"我们有接口规范",但规范在 wiki 里,实现在代码仓里,两者之间没有一条自动化的线——那不叫契约,叫约定。

错误文案也进规格,这条容易被当成小事。调用方是按文案做分支的,比如 NOT_FOUND: Could not find text 'Log in' within 10s。文案改一个词,判断分支就断一处。把它写进规格,是承认错误输出属于对外接口,不是可以随手改的日志。

核心在于:能被机器比对的东西才配叫契约。规格文件是输入,生成物是输出,比对可以自动化。文档做不到这一点。

生成器是产线,校验是门禁
五个入口都由同一份规格生成,带来的直接结果是:touch 在五处都叫 touch,文档只维护一份。省掉的不是写代码的时间,是五端接口互相漂移之后的排查时间。

不一致
一致
spec/commands.json
命令 + 参数 + 三语错误文案
生成器
Python SDK
Node.js SDK
.NET SDK
MCP 工具清单
CI 校验
方法与规格比对
构建失败
合并
CI 那一步是整套东西的关键。生成一次保持一致不难,难的是改完之后五端还一致。把比对放进流水线,等于给"规格与实现对齐"写了一条永久回归用例。

测试开发在这条链上的活也随之改变。不用逐个测五个 SDK 的方法实现对不对,那是在测生成器;要测的是生成物和规格对不对齐——方法名、参数签名、错误文案有没有漏、有没有多、有没有改。这是典型的契约测试,只是契约的双方是规格和产线,不是服务和服务。

门禁的价值不在通过的时候,在失败的时候。漂移在合并前被拦住,成本是一次构建失败;漂移流到用户那里,成本是一次线上问题和一轮跨端排查。把拦住的位置往左移,是测试开发能给出的最直接的收益。

连接方向反转,带出的是恢复语义
另一处工程决定在连接方式上。常规方案是 PC 开端口等手机连进来,Droidline 反过来:手机主动外连,PC 一个端口不开。同 Wi-Fi 直连,人在外面走隧道或自建中继,通信端到端加密,中继手里只有密文。

配对决定谁能控这台手机,握手之后每行通信都加密。本质上是把"连通"和"授权"绑到了同一次配对动作上,不再分成"先连上再鉴权"两步。

对测试开发更值得注意的是后半句:断网重连后从断点接着跑,执行中的命令由手机侧缓存应答,不会重跑一遍。

这说的其实是幂等性。自动化里的动作不都能重放——点一次付款和点两次付款不是一个意思,发一条验证码和发两条也不是。恢复时如果重跑已执行的命令,就会造出重复副作用。缓存应答把恢复变成从断点续接,绕开了重放。

于是测试目标也变了。不是测"能不能重连上",是测"重连之后的状态等不等于没断过"。前者是连通性检查,后者才是恢复正确性。要验证的是:已完成的步骤没有重复执行,未完成的步骤接着执行,中断没有留下半截状态。

能力边界决定测什么、不测什么
README 里列了做不到的事:只用无障碍服务和自装键盘,也就是普通 App 能拿到的权限;解不开 PIN 锁,没有强停、清数据的单命令,打不开别的 App 没导出的页面。游戏和自绘界面拿不到元素,只能退回坐标点击加颜色判断。Android 15 起系统把一次性验证码从通知里藏起来,只能知道码到了、去 App 里读。

边界 性质 对测试设计的含义
解不开 PIN、无强停清数据 权限路线的硬上限 不要写依赖这类操作的用例,写了必然失败
游戏、自绘界面无元素 界面无可访问结构 这类页面只能验坐标与颜色,断言强度要降
Android 15 验证码隐藏 系统策略变化 改成"码已到达 + 去应用内读取"两段验证
服务端与 SDK 测试跑在模拟器 证据来源的披露 模拟器结论不能直接当真机结论用
核心在于:这些不是待修的缺陷,是路线的天然上限。测试设计得先知道边界在哪,才知道哪里该断言、哪里断言不了、哪里该换验证方式。不知道边界的后果是两类浪费——写一批注定失败的用例,再报一批不该报的缺陷。

版本还在 0.1,作者写明服务端和 SDK 的测试目前对着模拟器跑,跨品牌真机验证还在进行。这句话是证据强度的自我披露。测试报告里该有的东西——证据从哪来、覆盖范围到哪、结论能推到多远——在这里都写出来了。拿模拟器的通过率当真机结论,是评测里最常见的越界。

测试对象在往上游走
把这款工具的两处设计放一起看,会发现测的东西在往上游移动。

一处是规格。五个入口的一致性不是靠逐个测方法测出来的,是靠比对生成物和契约测出来的。被测对象从行为变成了产线。

一处是证据。跨品牌真机还没验证完就写进 Status 页,这是把证据边界显式化。以前测完只给结论,现在还得说明结论建立在什么证据上。

AI 接入让这个变化更明显。droidline mcp 起来之后,Claude、Cursor 可以直接看屏点按钮,--read-only 把工具收窄到只看不动。调用方多了一类——模型按工具清单生成调用。工具名、参数、用途描述都得机器可读、规格明确,这恰好是单源规格的用武之地。模型读到的清单和 SDK 用的是同一份定义,才不会出现"清单里说能点,实际点不动"。

实际上分工没变:生成器负责让五个入口长得一样,规格负责定义什么是对的,人负责判断规格对不对、证据够不够。产线能自动产出,判断不能一起外包。

你们那边多端 SDK 或接口定义,是几份手工维护的?改一个命令名,要动几处,靠什么保证没漏?

本文部分内容参考了霍格沃兹测试开发学社整理的相关技术资料,主要涉及软件测试、自动化测试、测试开发及 AI 测试等内容,侧重测试实践、工具应用与工程经验整理。

相关文章
|
6天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
7570 19
|
6天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
2477 11
|
1天前
|
人工智能 安全 应用服务中间件
NGINX 爆出两处高危漏洞 可导致未经身份验证的远程代码执行
NGINX曝出两个高危漏洞(CVE-2026-123633和CVE-2026-123007),CVSS 9.2分,均属HTTP/2内存安全缺陷,无需认证即可远程执行代码。影响自2015年起的多个版本,静态站点亦受威胁。修复版本为开源版1.30.7/1.31.9。(239字)
1209 0
NGINX 爆出两处高危漏洞 可导致未经身份验证的远程代码执行
|
4天前
|
传感器 安全 区块链
Windows 电脑运行安卓应用教程:开源工具 ApkStart 双击 APK 即装、独立窗口运行
ApkStart 是一款开源Windows工具,让安卓APP像原生软件一样运行:双击APK即安装、生成真实图标、独立窗口启动、开始菜单可搜索。无需传统模拟器,内置QEMU运行时,支持数据互通、ARM兼容与命令行操作。(239字)
|
9天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
9天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
21天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
10517 59
|
4天前
|
人工智能 弹性计算 开发工具
零成本玩各大模型!DeepSeek Harness dsh-our-free-model 插件,13 个厂商模型直接用
总结一下:装这个插件,你不用注册、不用绑卡、不用填一个 Key,就能在 DeepSeek Harness 里用上 DeepSeek V4.1 Flash、Kimi K3 这一批前沿模型,而且是白嫖的、还不限量。三步搞定:下载插件,复制包含 `package.json` 的插件目录路径,在「添加插件」里粘贴路径安装并重启。无论是在阿里云 ECS 上通过命令行部署的 Web 版,还是本地的 Electron 桌面端,都能顺利跑通,快速搭建一套零成本的免费模型使用环境。
1119 1
|
7天前
|
Linux API iOS开发
【DSH】DeepSeek Harness新手保姆教程(下载+安装+配置+使用,2026最新实测)
DeepSeek Harness(dsh)是DeepSeek AI开源的智能体框架,秉持“一切皆插件”理念,支持读文件、改代码、跑命令、处理表格、联网搜索等操作。免费开源,兼容Windows/macOS/Linux,提供桌面端与网页端,可灵活安装插件扩展能力。

热门文章

最新文章