不打包任何运行时,用 892 KB 做一个能真正开出云沙箱的鸿蒙客户端

一、写在前面

开源地址:https://atomgit.com/OpenHarmonyPCDeveloper/ohos_E2B

欢迎在PC社区平台申请新建项目:https://atomgit.com/OpenHarmonyPCDeveloper

本文导读

  • 要解决的问题:E2B 官方只有 Python/JS SDK 和 CLI,没有任何桌面 GUI。要在鸿蒙上做一个图形化客户端,等于从零设计产品形态。
  • 你会读到的技术细节:编排 API 与沙箱内 envd 的双端点分离封装、ARRAY_BUFFER 流式命令输出、AssetStoreKit 密钥存储(含旧数据迁移)、以及一个不用合法凭据也能验证网络链路的 401 反向验证法。
  • 本文的实测数据:真机创建一台 x86_64 云沙箱、终端跑出 Python 3.11.6 与 uname 输出、文件浏览读到 /home/user、10 张真机截图、HAP 892 KB。
  • 适合谁读:做云客户端、想用最小包体(不打包任何运行时)实现完整云端功能的开发者。

这篇文章记录的是把 E2B 这套面向 AI Agent 的云端沙箱平台,做成一个鸿蒙 PC 原生客户端的过程。最终落地的应用叫 沙箱控制台,包名 MXPD.MXPD.e2b。

前两期一个讲本地剪贴板、一个讲本地有限元求解器,都是「单机应用」。这一次不一样:业务逻辑全在云端,鸿蒙这边要做的是一个合格的瘦客户端——网络层、流式命令、文件浏览、密钥安全存储,这些才是重点。

先给结论:

客户端移植完成,在鸿蒙 PC 上真实创建并操作了一台 x86_64 Linux 云端沙箱:终端执行命令、浏览文件、查看资源指标全部跑通。

验证环境是真实设备:

项值
设备型号HUAWEI MateBook Pro S(MOR-M1)
系统版本HarmonyOS 7.0.0.111(SP15C00E101R9P2)
API 版本26
设备形态2in1
构建工具DevEco Studio 内置 hvigor 6.26.4
SDKHarmonyOS SDK 26.0.0.105

二、项目背景

E2B(https://github.com/e2b-dev/E2B)是一个开源的 AI 沙箱基础设施:给每个 AI Agent 分配一台几秒内启动、用完即弃的云端虚拟机,Agent 在里面执行代码、读写文件、跑命令,不用担心把宿主环境搞坏。

它的技术形态决定了「客户端要做什么」:

  • 编排 API:https://api.e2b.app,X-API-Key 鉴权,REST 风格,管沙箱的创建/查询/删除、模板、快照;
  • 沙箱内服务:每个沙箱里跑一个 envd 守护进程(端口 49983),负责执行命令、读文件、传文件;
  • SDK:官方给的是 Python / JS SDK,本质是对上述两套 HTTP 接口的封装;
  • 没有桌面客户端:官方形态是 CLI + SDK,跑在终端和代码里。

所以这次移植的定位很清楚:

不是把某个桌面 GUI 搬过来,而是从零做一个鸿蒙 PC 上的图形化沙箱控制台,把 E2B 官方 SDK 暴露的能力用 ArkUI 表达出来。

最终工程是 22 个 ArkTS 文件、5862 行,产物 HAP 892 KB——注意这个数字,比前两期都小,因为没有随包任何 native 产物,纯 ArkTS + 系统 API。


三、总体变化概览

harmony-client/
└── entry/src/main/
    ├── module.json5                仅申请 INTERNET 权限
    └── ets/
        ├── entryability/            UIAbility 入口
        ├── pages/Index.ets          主壳与导航(259 行)
        ├── api/
        │   ├── E2bApi.ets           E2B 编排 API(/v2/sandboxes 等)
        │   ├── EnvdApi.ets          沙箱内 envd 客户端(端口 49983)
        │   ├── ConnectClient.ets    命令执行与流式输出
        │   └── HttpClient.ets       统一 HTTP 封装
        ├── store/SettingsStore.ets  密钥与设置持久化(275 行)
        ├── model/Models.ets         数据模型(270 行)
        ├── view/
        │   ├── ConsolePage.ets      控制台(261 行)
        │   ├── TerminalView.ets     终端
        │   ├── FileBrowser.ets      文件浏览(643 行,最大)
        │   ├── LogsView.ets         日志(253 行)
        │   ├── SandboxDetailPage.ets 沙箱详情(513 行)
        │   ├── CreateSandboxDialog.ets 创建沙箱(310 行)
        │   ├── SnapshotsPage.ets    快照
        │   ├── TemplatesPage.ets    模板
        │   ├── SettingsPage.ets     设置(361 行)
        │   ├── WelcomePage.ets      引导页
        │   ├── Dialogs.ets          弹窗(326 行)
        │   └── widgets.ets          基础组件(342 行)
        └── utils/                   格式化与 JSON 工具

技术栈映射:

E2B 官方形态沙箱控制台(鸿蒙)
Python / JS SDKArkTS 手写 HTTP 客户端
e2b sandbox connect CLI终端视图 + 命令执行
CLI 文件传输文件浏览面板
环境变量 E2B_API_KEYAssetStoreKit 安全存储
终端 stdout 流HTTP 分段读取 → 增量渲染
—ArkUI 原生四区导航

依赖面极小:整个应用只申请了一个权限 ohos.permission.INTERNET,没有任何第三方包(oh-package.json5 里只有测试框架)。


四、原始项目直接跑鸿蒙会遇到什么问题

4.1 没有现成的 GUI 可以「移植」

这是和前两期最大的区别。ClipNest 有 Ditto 的产品形态可对齐,澜析工程有 ElmerGUI 的界面结构可参考。而 E2B 根本没有桌面 GUI——它只有 SDK 和 CLI。

所以这次不是「适配界面」,而是先做产品设计:哪些能力值得图形化?信息怎么组织?这在技术上不难,难在取舍。

4.2 官方 SDK 不能直接用

E2B 官方 SDK 是 Python/JS 的,依赖 Node 运行时或者 Python 解释器。鸿蒙上要么带一个 HNP 运行时(体积代价巨大),要么用 ArkTS 自行实现 HTTP 客户端。

选择了后者。代价是要自己处理鉴权头、分页、错误码、流式读取;好处是 892 KB 的包体和零 native 依赖。

4.3 命令输出是流式的,不是一次性返回

e2b CLI 执行命令时,输出是边跑边吐的。HTTP 层面的对应做法是流式读取响应体。ArkTS 的 http 模块支持 HttpDataType.ARRAY_BUFFER 接收,需要自己做增量解码和渲染。

4.4 API 密钥必须安全存储

E2B_API_KEY 是一把能开出云主机的钥匙,泄露等于账单失控。鸿蒙提供了 AssetStoreKit 专门存敏感数据,不能图省事塞进普通 Preferences。

4.5 沙箱是个「双端点」系统

这是最容易踩的设计坑:E2B 有两套 API。

  • 编排 API(api.e2b.app):管沙箱生命周期,用 X-API-Key;
  • envd(沙箱内 :49983):管沙箱内部操作,走沙箱自己的域名。

两个端点、两套鉴权、两种错误语义,客户端必须分开封装。


五、鸿蒙适配核心路径

5.1 第一步:把两套 API 分开封装

编排 API 独立成一个类,鉴权和分页都在里面收敛:

// E2B 编排 API 客户端(https://api.e2b.app,鉴权:X-API-Key 请求头)
const url = `${E2bApi.baseUrl()}/v2/sandboxes?${params.join('&')}`;
const resp: HttpResponse = await Http.request(
    http.RequestMethod.GET, url, E2bApi.headers());
const result = new SandboxListResult();
const arr = JsonUtil.parseArray(resp.body);
const total = resp.headerValue('X-Total-Running');   // 直接读响应头拿运行数

X-Total-Running 这个响应头是个细节:沙箱总数不用再发一次请求,直接从分页响应里读出来。

envd 客户端则完全独立:

// envd 客户端:与沙箱内部 envd 服务(端口 49983)通信
export class EnvdApi {
  static readonly ENVD_PORT: number = 49983;
  ...
  const sandboxDomain = domain !== '' ? domain : SettingsStore.sandboxDomain();

把「管沙箱」和「用沙箱」分开,是这次架构上最重要的一条。

5.2 第二步:流式命令执行

命令执行走 ConnectClient,用 ARRAY_BUFFER 接收而不是 STRING:

const options: http.HttpRequestOptions = {
  method: http.RequestMethod.POST,
  ...
  expectDataType: http.HttpDataType.ARRAY_BUFFER,
};

配一个 RunChunk 结构做增量投递,界面侧边收边渲染,长命令不会卡住 UI。

5.3 第三步:密钥进 AssetStoreKit

SettingsStore 里把「敏感」和「普通」两类数据彻底分开:

/**
 * 设置存储:敏感密钥使用 AssetStoreKit,其余设置使用持久化 preferences
 */
const options: preferences.Options = { name: 'clouddeck_settings' };
SettingsStore.prefs = preferences.getPreferencesSync(context, options);

// Migrate keys written by early builds out of the ordinary preferences file.

最后那行注释说明作者还做了迁移逻辑——早期版本把密钥写进了普通 preferences,后来改到 AssetStoreKit,老数据要搬过去并清掉。这种兼容代码在真实项目里很常见,也说明这块是想清楚了的。

实测验证:设备上的偏好文件里最终只留了一条非敏感配置:

<preferences version="1.0">
  <bool key="legalAccepted" value="true"/>
</preferences>

密钥本身不在明文配置文件里,这就是 AssetStoreKit 在起作用。

5.4 第四步:权限门禁与引导页

应用未配置密钥时,四个导航项(沙箱 / 模板 / 快照 / 设置)全部回落到引导页,不让用户进入一个空壳界面:

在这里插入图片描述

界面文案写得很直白:

在鸿蒙设备上创建、连接并管理云端开发环境。开始之前,请填写服务 API 密钥。
密钥仅保存在本机,用于连接你配置的云端服务。

底部状态栏常驻一行 ● 未配置密钥,右侧有「配置」快捷入口。

5.5 第五步:同意门禁

「开始使用」按钮在用户勾选隐私政策和用户协议之前是禁用的:

在这里插入图片描述

这个设计是有实际约束的——云服务客户端必须做用户协议确认,否则过不了应用市场审核。


六、问题困难解决

6.1 困难一:怎么证明网络链路真的通了

界面画出来很容易,难的是证明「它真的在跟 E2B 云端说话」,而不是画了个假的加载动画。

我在拿到可用密钥之前,先用了一个反向验证:输入一个格式合法但无效的密钥,看应用能不能把服务端的错误码翻译出来。

输入:e2b_invalid_key_for_probe_0000
点击:开始使用

结果是:

在这里插入图片描述

验证失败: API 密钥无效或已过期 (401)

这条 401 是整个移植过程里最有价值的一次验证。它一次性证明了四件事:

  1. 应用真的发出了 HTTPS 请求;
  2. 网络权限(ohos.permission.INTERNET)配置正确;
  3. 请求打到了正确的端点(api.e2b.app),而不是某个占位地址;
  4. 错误处理链路是通的——HTTP 状态码被正确映射成了可读的中文提示,而不是抛一个裸异常或者静默失败。

这条经验建议所有云端客户端移植都先做一遍:不需要合法凭据,也能验证整条网络链路。

6.2 困难二:先分清「编排失败」和「沙箱内失败」

E2B 的双端点结构很容易把错误处理写乱。同一个「命令执行失败」,可能来自三个完全不同的层次:

层次端点典型错误用户该怎么处理
鉴权/编排api.e2b.app401 密钥无效换密钥
沙箱状态api.e2b.app404 沙箱已销毁重建沙箱
沙箱内执行envd:49983命令退出码非 0看命令输出

代码上做的区分是:E2bApi 和 EnvdApi 各自维护自己的 ApiError,界面层按来源给不同的提示。上面那个 401 就是 E2bApi 抛出来的。

6.3 困难三:ARM64 主机连 x86_64 沙箱

这一点很容易被忽略,但实际用起来体感很强。

鸿蒙 PC 是 aarch64,而 E2B 默认模板起的是 x86_64 的 Linux 沙箱。客户端在真机上跑命令行,得到的是这样的输出:

$ uname -a
Linux e2b.local 6.1.189+ #1 SMP PREEMPT_DYNAMIC Mon Nov 2 21:08:28 UTC 2026 x86_64 GNU/Linux

宿主是 ARM64,沙箱是 x86_64。这意味着客户端不能对沙箱里的架构做任何假设——所有和架构相关的操作(编译、跑二进制)都必须交给云端,客户端只负责传输。

这也是「瘦客户端」这个定位的正确性所在:把架构差异完全隔离在网络边界之外。

6.4 困难四:大文件传输不能一次性读进内存

FileBrowser.ets 是全部文件里最大的一个(643 行),不是没原因的——文件列表、目录切换、上传下载、预览都要处理。传输部分刻意走了 ARRAY_BUFFER 通道而不是 STRING,避免大文件把 ArkTS 堆打爆。

6.5 困难五:包体控制的取舍

前两期的 HAP 分别是 752 KB(ClipNest)和 19 MB(澜析工程)。这次移植只有 892 KB,代价是全靠手写 API 客户端。

如果把 E2B 官方的 Node SDK 打成 HNP 塞进来,包体会直接上到几百 MB,启动还要拉起 Node 运行时。在「瘦客户端」这个定位下,手写 HTTP 是唯一合理的选择——而且 E2B 的 REST 接口本身就足够简单,封装的成本可控。


七、构建与运行方式

7.1 环境

  • DevEco Studio(内置 hvigor + SDK)
  • HarmonyOS SDK API 26(本机 26.0.0.105)
  • 无需任何 native 工具链,也不需要额外的运行时

7.2 构建

cd harmony-client
ohpm install
hvigorw assembleHap --mode module -p product=default -p buildMode=debug

产物:

entry-default-unsigned.hap   892 KB
entry-default-signed.hap     938 KB

纯 ArkTS,构建约 4 秒。

7.3 签名与安装

同样的规则:仓库不保存签名材料。用 scripts/sign_hap.sh(环境变量方式)或 DevEco 自动签名。

调试 profile 绑定设备 UDID,换设备后需要重新自动签名,否则会报:

code:9568423
error: Failed to install the HAP because the device is unauthorized

装好后:

hdc shell aa start -b MXPD.MXPD.e2b -a EntryAbility

7.4 首次使用

  1. 启动后进入引导页;
  2. 填入 E2B 的 API Key(在 https://e2b.dev 控制台的 Configure → API keys 生成,只在创建时显示一次);
  3. 勾选隐私政策与用户协议;
  4. 点「开始使用」,校验通过后底部状态栏变成 ● 云端服务已连接,进入沙箱列表。

密钥只存在本机(AssetStoreKit),不会上传到除 E2B 官方端点之外的任何地方。


八、适配成果

8.1 沙箱列表

配置好密钥后进入沙箱页:

在这里插入图片描述

  • 顶部:当前共 0 个运行中的沙箱,右侧「刷新」「创建沙箱」
  • 筛选:全部 / 运行中 / 已暂停
  • 右上角标注:每 10 秒自动刷新
  • 空态引导:点击右上角「创建沙箱」,从模板启动你的第一个云端沙箱

创建成功后,列表会变成带实时倒计时的卡片:

在这里插入图片描述

卡片上一眼能看到:模板名 base、状态「运行中」、规格 2 vCPU · 512 MB 内存 · 23670 MB 磁盘、envd 0.10.2、沙箱 ID 短码,以及剩余时长倒计时。

8.2 创建沙箱

在这里插入图片描述

对话框只有三个要素,做得很克制:

  • 模板(ID 或别名):填 base 即可用官方基础镜像
  • 存活时长:默认 5 分钟
  • 超时后自动暂停:开关

「存活时长 + 超时自动暂停」这两个选项是 E2B 的核心产品语义——沙箱是用完即弃的,默认就该自己死掉,而不是靠用户记得去关。

8.3 沙箱详情

在这里插入图片描述

详情页分四个 Tab:概览 / 终端 / 文件 / 日志,顶部固定一排操作:续期、暂停、快照、终止。

概览页把沙箱的全部关键信息摊开:

字段实测值
沙箱 IDi1dlplv5uxh0cbbwicmib
模板base
状态运行中
envd 版本0.10.2
配置2 vCPU · 512 MB 内存 · 23670 MB 磁盘
启动时间2026-11-17 15:48:27
到期时间2026-11-17 15:53:27
剩余时长4 分 59 秒

下方是每 5 秒刷新的实时资源指标:

  • CPU(2 核):1.9%
  • 内存:55.8 MB / 473.1 MB
  • 磁盘:1.5 GB / 21.5 GB

底部还有一条产品提示:「沙箱到期后会自动停止。可以在『续期』中延长时间,或创建快照持久化当前状态。」

8.4 终端:真的在云端跑了命令

在这里插入图片描述

这是整篇文章最关键的一张截图。在鸿蒙 PC 的客户端里输入:

uname -a; python3 --version; echo hello-from-harmonyos-pc

沙箱真实返回:

Linux e2b.local 6.1.189+ #1 SMP PREEMPT_DYNAMIC Mon Nov 2 21:08:28 UTC 2026 x86_64 GNU/Linux
Python 3.11.6
hello-from-harmonyos-pc

底部状态:命令执行完毕,退出码 0。

终端界面还提供了七个快捷命令芯片:ls -la、系统信息、Python、Node、磁盘、内存、网络,省得每次都手打。

这一张图同时证明了三件事:编排 API 通了(沙箱建起来了)、envd 通了(命令进去了)、流式输出通了(结果回来了)。

8.5 文件浏览

在这里插入图片描述

文件 Tab 直接读的是沙箱里的真实目录:

  • 面包屑:根目录 > home > user,右侧显示绝对路径 /home/user
  • 工具栏:刷新、上传文件、新建文件夹、新建文件
  • 文件列表:.bash_logout(220 B)、.bashrc(3.4 KB)、.profile(807 B),带修改时间和编辑/删除操作

这些是 base 镜像 ubuntu 用户的默认 dotfile,说明目录确实是沙箱里的真实文件系统,不是模拟数据。

8.6 模板与快照

在这里插入图片描述

模板页显示「暂无模板 / 你的团队还没有自定义模板,可在服务管理后台或使用 SDK 构建」。

这个空态是准确的——base 是 E2B 的内置别名,不算团队自定义模板。界面没有伪造数据来填满列表,这点值得肯定。

8.7 工程量

指标数值
ArkTS 源文件22 个
代码行数5862 行
最大单文件FileBrowser.ets 643 行
界面组件12 个(含终端、文件浏览、日志、快照、模板)
第三方依赖0
权限数量1(INTERNET)
HAP 体积892 KB(unsigned)/ 938 KB(signed)

8.8 与前两期的对比

ClipNest澜析工程沙箱控制台
类型本地工具本地计算云客户端
ArkTS 行数478234175862
随包原生产物017 MB0
HAP 体积752 KB19 MB892 KB
核心难点权限与自写入回环进程模型双端点 API 封装

九、功能验证结果

9.1 已在真机验证

功能结果验证方式
构建与签名链✅892 KB HAP 正常产出
安装与启动✅hdc install 成功,进程稳定运行
四区导航渲染✅沙箱/模板/快照/设置正常显示与切换
未配置密钥门禁✅四个页面均回落到引导页,不进入空壳
同意协议门禁✅未勾选时按钮禁用,勾选后可点击
密钥校验(失败路径)✅无效密钥 → 401 → 「API 密钥无效或已过期」
密钥校验(成功路径)✅有效密钥 → 状态栏变「云端服务已连接」
密钥安全存储✅偏好文件仅存 legalAccepted,密钥不在明文配置里
沙箱列表✅空态与运行中两种状态均正确渲染
创建沙箱✅base 模板创建成功,拿到 ID i1dlplv5uxh0cbbwicmib
沙箱详情✅规格/时间/envd 版本全部正确回显
实时资源指标✅CPU 1.9%、内存 55.8/473.1 MB、磁盘 1.5/21.5 GB
终端命令执行✅uname -a / python3 --version / echo 全部返回,退出码 0
文件浏览✅读取 /home/user,dotfile 与大小正确
模板页空态✅正确显示「暂无模板」
自动刷新✅沙箱列表 10 秒、资源指标 5 秒

9.2 代码已实现,本次未验证

功能说明
日志 Tab本次未切到日志页取样(终端输出已单独验证)
快照创建与恢复需要额外操作,未执行
文件上传 / 下载界面入口在,未实测传输
沙箱暂停 / 续期按钮在,未逐个点
自定义模板账号下没有自定义模板,空态已截图
多沙箱并发本次只起了一台

9.3 已知限制

限制说明
需要自备 API Key无密钥只能到引导页
依赖公网内网环境需要自行配置 sandboxDomain
宿主与沙箱架构不同鸿蒙 PC 是 aarch64,默认沙箱是 x86_64
调试 profile 绑 UDID换设备需重新自动签名

十、上架复盘:审核不通过怎么办

移植跑通只是第一关。上架审核看的是另一套东西:用户会不会把这款应用误认为上游官方版,或者误认为换皮抄袭。名称、图标、截图、描述、权限、实际行为,只要有一项对不上,就可能被驳回。

10.1 名称和图标:开源许可不等于品牌许可

这是最容易踩的坑。很多人觉得“这是开源软件,保留原名和原图标很正常”,但 MIT/Apache/GPL 给的是版权许可,不是商标许可。审核看到“应用名和上游一样、图标是上游 Logo 换色、截图里还有上游品牌”,就会按“冒用/抄袭”处理。典型的三连击是:应用名直接沿用上游、图标只把颜色换一下、截图里还带着上游 Logo——即使代码全部重写,也会被判定为冒用。

我们的处理原则:

  • 应用名改成独立品牌,包名不带上游商标;
  • 图标重画,不复用、不改色、不截取上游 Logo;
  • 截图、启动图、关于页不出现上游 Logo,只保留文字致谢;
  • 关于页写明“基于 E2B 移植,非官方发行”,并保留上游 LICENSE/NOTICE;
  • 如果被质疑,提交《品牌与素材来源说明》:改名前后对照、图标设计稿、上游许可证、代码差异、真机录屏。

10.2 被判定“抄袭/雷同”时,交什么证据

只回“这是开源软件”通常没用。按这个顺序给材料:

  1. 上游仓库地址和 LICENSE 原文;
  2. 本仓库与上游的差异清单(UI 重写、平台层、构建脚本);
  3. 品牌变更记录(旧名→新名、旧图标→新图标);
  4. 功能差异说明(哪些是鸿蒙特有、哪些上游没有);
  5. 真机录屏,证明不是套壳。

如果确实沿用了上游 UI,先改再申诉;审核一般不看“开源所以可以一样”的解释。

10.3 这个项目的高频驳回点

  • 云端服务:审核机没有你的账号,必须提供可用的测试账号/配额和一条最短验证路径(登录→创建沙箱→终端→文件)。
  • API Key:截图和描述里不能出现密钥;隐私政策写清密钥存 AssetStore、数据发往哪个域名。
  • 品牌:不要用 E2B 的 Logo/名称做应用名;“沙箱控制台”是独立品牌,关于页注明非官方。

10.4 驳回后的处理顺序

先分类,再动手。审核意见通常落在六类:名称/图标/品牌、隐私与权限、功能与描述不符、技术(签名/包名/架构/体积/崩溃)、内容合规、资质(软著/授权书/备案)。

  • 一次只改一类,别在同一个版本里混改;
  • 回复时逐条对应:版本号 + 审核意见 + 改了什么 + 怎么验证;
  • 测试账号/令牌在复审前重置,写进审核备注;
  • 截图必须来自当前版本真机,不能用设计稿;
  • 换正式证书后重新打包,不要用调试签名送审;
  • 被拒后先回一条“已收到,逐条说明”,再提新包,避免被判定骚扰;
  • 上架材料提前备齐:软著/授权书、隐私政策公网 URL、测试账号、真机截图、开源许可证与 NOTICE。

回复可以按这个模板:

您好,针对第 X 条“……”:我们已在版本 A.B.C 中修改:1)……;2)……。验证路径:……。相关材料见附件/链接。

一句话:上架不是“把包传上去”,而是把“这不是官方版、也不是换皮”这件事,用名称、图标、截图、代码和材料同时证明一遍。

十一、结语

前两期都在跟「本地能力」较劲——剪贴板权限、进程沙箱。这次移植换了个方向:证明鸿蒙 PC 也能做一个合格的云端开发工具客户端,而且能真的把云端资源用起来。

四点体会:

  1. 没有 GUI 的项目,移植的其实是产品设计。E2B 只有 SDK 和 CLI,客户端要自己决定信息架构。四区导航(沙箱/模板/快照/设置)是按云端资源生命周期分的,这个决定比写多少行代码更影响体验。

  2. 双端点系统必须先分清楚再动手。编排 API 和 envd 是两套鉴权、两种错误语义。前期不分开,后期错误处理一定会糊成一团。

  3. 验证网络链路不需要合法凭据。一个无效密钥换来的 401,比十张界面截图都更能证明「它真的在跟云端说话」。这个反向验证的成本极低,建议所有云客户端移植都先做这一步。

  4. 架构差异要隔离在网络边界之外。宿主 aarch64、沙箱 x86_64,客户端不需要关心,也不应该关心——这正是瘦客户端存在的意义。

892 KB 的包体也算一个有意思的结论:在鸿蒙上做一个云客户端,不需要塞进任何运行时。手写 HTTP 客户端的成本,远低于打包一个 Node 或 Python 环境。

从「引导页」到「在云端跑出 Python 版本号」,这个客户端算是真正立住了。


一句话:892 KB 装下一个云控制台:在鸿蒙上做云客户端,真的不需要打包任何运行时。

相关链接

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐