在鸿蒙上跑 ZCode：一次彻底的「去哈克化」硬核移植

各位鸿蒙玩家和 AI 编程爱好者，给大家推荐一款刚刚出炉的开源作品——ZCode for HarmonyOS。它把智谱 ZCode 桌面应用程序完整搬到了鸿蒙系统，并且在结构、隐私、可定制性上都做了大刀阔斧的改造。

一、它是什么？

ZCode 是智谱 AI 推出的桌面编程应用程序，内置大模型能力，支持编码任务、自动化、插件市场、文件分析、跨文件编辑等主流 AI 编程助手功能。原版只提供 Linux arm64 glibc 的 deb 包，对鸿蒙用户基本上是查无此人。ZCode for HarmonyOS 填补了这个空白，把完整的 ZCode 体验带到了 HarmonyOS PC 上。

二、为什么要折腾这个版本？

其他 ZCode 桌面端为了在鸿蒙系统上跑通，引入了一大堆「补丁」：hnp（甲级战犯）、子进程 hack、回连 hishell、websocket 转发……这些虽然在鸿蒙上能跑，但你一关闭hishell不就完了吗。

所以这个项目的核心哲学是：用最直接最不绕弯子的方式跑 ZCode。

✅ 完全无 hnp：不需要鸿蒙的兼容垫片
✅ 完全无子进程 hack：基本照搬 electron 示例
✅ 完全无回连：避免脐带关系
✅ 完全无 websocket 中转：你知道吗websocket只能http1.1，尽量不要用

三、相比上游，它做了哪些事？

项目结构大幅优化

移植版的目录划分、模块依赖、构建脚本全部重新整理，可读性和可维护性远超上游。这意味着二次开发、定制自己功能门槛更低。

支持全盘访问

和腾讯、阿里一样大方地申请了全盘访问权限。这意味着你不必为了跑一个 IDE 而被沙箱反复限制——查文件、看代码、跨项目引用，操作体验和桌面端一致。

⚠️ 作者也友情提醒：开了全盘访问意味着开 YOLO（最大权限）模式，重要文件最好移到云空间或别的 app 沙箱里。

CLI 可自由定制

glm 那个目录可以完整复制到 /data/storage/el2/base/files/glm，你想改 CLI 逻辑、加插件、调提示词，全部自己说了算。这是真正属于开发者的工具，不是被框死的玩具。

一系列「鸿蒙特性修复」

替换 node:sqlite → node_modules/node-sqlite → sqlite.node
自带 pty.node 和去 C++ 化的 sshcrypto.node
node:sea polyfill
进程标题 mock
关闭崩溃修复：直接 exit_group 避免产生大量 faultlog
清除所有遥测调用

这些改动让 ZCode 在鸿蒙上既稳定又干净。

四、目前还有哪些已知小坑？

作者也诚实列出了已知问题，方便踩坑预警：

tools/bfs/bfs: error: bfs_ctx_dedup(): Bad file descriptor：BFS 在 stat stderr 的 fd 时拿到的是 socketpair，鸿蒙返回 EBADF 而非 Linux 的正常返回。
覆盖安装会失败 9568269：原因还在诊断。
侧边栏「新建任务 / 查看文件 / 更多」在某些设备上不显示，原因是 media(hover: none) 的媒体查询。

对于一款刚出炉的开源移植来说，这些都属于早期版本正常范围，作者的态度也是「先发出来，大家一起修」。

五、谁适合用？

🛠️ 鸿蒙原生开发者：可以在本机直接用 AI 写鸿蒙代码，不用反复切环境
🔒 任何受不了牢HiShell、牢vscode、牢codearts和牢deveco的开发者：无回连、无遥测、无云端同步
🧪 折腾爱好者：CLI 可改、模块可拆，全盘可玩
🚀 AI 编程尝鲜者：想要完全本地化的 AI 开发体验

六、怎么装？

HAP 包发布地址：

https://share.weiyun.com/hr0GWBG8

首先你要有一副有ACL权限的证书，并且应用ID一定要是 com.huawei.codearts.agent（不能是其他值）

拿到证书就能签名安装了

⚠️ 免责声明：作者明确声明这并非 Z.AI / bigmodel.cn 官方支持的项目，官方下载请去 https://zcode.z.ai/cn （只是下载了不能运行罢了）

七、小结

如果你正在用鸿蒙设备写代码、想要 AI 加持又不想把你的 agent 配置文件或 key 复制到十几台局域网机器上，这款应用值得你花30分钟下载体验。

---

项目地址：https://atomgit.com/z-ai/ZCode

鸿蒙生态又多了一款能打的 AI 工具，期待作者（也就是我）后续把它打磨得更好用。