鸿蒙 PC:沙箱控制台(ohos_E2B)云端开发环境客户端移植全记录
不打包任何运行时,用 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 |
| SDK | HarmonyOS 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 SDK | ArkTS 手写 HTTP 客户端 |
e2b sandbox connect CLI | 终端视图 + 命令执行 |
| CLI 文件传输 | 文件浏览面板 |
环境变量 E2B_API_KEY | AssetStoreKit 安全存储 |
| 终端 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 是整个移植过程里最有价值的一次验证。它一次性证明了四件事:
- 应用真的发出了 HTTPS 请求;
- 网络权限(
ohos.permission.INTERNET)配置正确; - 请求打到了正确的端点(
api.e2b.app),而不是某个占位地址; - 错误处理链路是通的——HTTP 状态码被正确映射成了可读的中文提示,而不是抛一个裸异常或者静默失败。
这条经验建议所有云端客户端移植都先做一遍:不需要合法凭据,也能验证整条网络链路。
6.2 困难二:先分清「编排失败」和「沙箱内失败」
E2B 的双端点结构很容易把错误处理写乱。同一个「命令执行失败」,可能来自三个完全不同的层次:
| 层次 | 端点 | 典型错误 | 用户该怎么处理 |
|---|---|---|---|
| 鉴权/编排 | api.e2b.app | 401 密钥无效 | 换密钥 |
| 沙箱状态 | api.e2b.app | 404 沙箱已销毁 | 重建沙箱 |
| 沙箱内执行 | 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 首次使用
- 启动后进入引导页;
- 填入 E2B 的 API Key(在 https://e2b.dev 控制台的
Configure → API keys生成,只在创建时显示一次); - 勾选隐私政策与用户协议;
- 点「开始使用」,校验通过后底部状态栏变成
● 云端服务已连接,进入沙箱列表。
密钥只存在本机(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:概览 / 终端 / 文件 / 日志,顶部固定一排操作:续期、暂停、快照、终止。
概览页把沙箱的全部关键信息摊开:
| 字段 | 实测值 |
|---|---|
| 沙箱 ID | i1dlplv5uxh0cbbwicmib |
| 模板 | 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 行数 | 4782 | 3417 | 5862 |
| 随包原生产物 | 0 | 17 MB | 0 |
| HAP 体积 | 752 KB | 19 MB | 892 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 被判定“抄袭/雷同”时,交什么证据
只回“这是开源软件”通常没用。按这个顺序给材料:
- 上游仓库地址和 LICENSE 原文;
- 本仓库与上游的差异清单(UI 重写、平台层、构建脚本);
- 品牌变更记录(旧名→新名、旧图标→新图标);
- 功能差异说明(哪些是鸿蒙特有、哪些上游没有);
- 真机录屏,证明不是套壳。
如果确实沿用了上游 UI,先改再申诉;审核一般不看“开源所以可以一样”的解释。
10.3 这个项目的高频驳回点
- 云端服务:审核机没有你的账号,必须提供可用的测试账号/配额和一条最短验证路径(登录→创建沙箱→终端→文件)。
- API Key:截图和描述里不能出现密钥;隐私政策写清密钥存 AssetStore、数据发往哪个域名。
- 品牌:不要用 E2B 的 Logo/名称做应用名;“沙箱控制台”是独立品牌,关于页注明非官方。
10.4 驳回后的处理顺序
先分类,再动手。审核意见通常落在六类:名称/图标/品牌、隐私与权限、功能与描述不符、技术(签名/包名/架构/体积/崩溃)、内容合规、资质(软著/授权书/备案)。
- 一次只改一类,别在同一个版本里混改;
- 回复时逐条对应:版本号 + 审核意见 + 改了什么 + 怎么验证;
- 测试账号/令牌在复审前重置,写进审核备注;
- 截图必须来自当前版本真机,不能用设计稿;
- 换正式证书后重新打包,不要用调试签名送审;
- 被拒后先回一条“已收到,逐条说明”,再提新包,避免被判定骚扰;
- 上架材料提前备齐:软著/授权书、隐私政策公网 URL、测试账号、真机截图、开源许可证与 NOTICE。
回复可以按这个模板:
您好,针对第 X 条“……”:我们已在版本 A.B.C 中修改:1)……;2)……。验证路径:……。相关材料见附件/链接。
一句话:上架不是“把包传上去”,而是把“这不是官方版、也不是换皮”这件事,用名称、图标、截图、代码和材料同时证明一遍。
十一、结语
前两期都在跟「本地能力」较劲——剪贴板权限、进程沙箱。这次移植换了个方向:证明鸿蒙 PC 也能做一个合格的云端开发工具客户端,而且能真的把云端资源用起来。
四点体会:
-
没有 GUI 的项目,移植的其实是产品设计。E2B 只有 SDK 和 CLI,客户端要自己决定信息架构。四区导航(沙箱/模板/快照/设置)是按云端资源生命周期分的,这个决定比写多少行代码更影响体验。
-
双端点系统必须先分清楚再动手。编排 API 和 envd 是两套鉴权、两种错误语义。前期不分开,后期错误处理一定会糊成一团。
-
验证网络链路不需要合法凭据。一个无效密钥换来的 401,比十张界面截图都更能证明「它真的在跟云端说话」。这个反向验证的成本极低,建议所有云客户端移植都先做这一步。
-
架构差异要隔离在网络边界之外。宿主 aarch64、沙箱 x86_64,客户端不需要关心,也不应该关心——这正是瘦客户端存在的意义。
892 KB 的包体也算一个有意思的结论:在鸿蒙上做一个云客户端,不需要塞进任何运行时。手写 HTTP 客户端的成本,远低于打包一个 Node 或 Python 环境。
从「引导页」到「在云端跑出 Python 版本号」,这个客户端算是真正立住了。
一句话:892 KB 装下一个云控制台:在鸿蒙上做云客户端,真的不需要打包任何运行时。
相关链接
- 适配仓库:https://atomgit.com/OpenHarmonyPCDeveloper/ohos_E2B
- 上游项目 E2B:https://github.com/e2b-dev/E2B
- E2B 控制台:https://e2b.dev
- OpenHarmony PC 开发者社区:https://atomgit.com/OpenHarmonyPCDeveloper
更多推荐



所有评论(0)