HarmonyOS Agent Environment Notes

一台 HarmonyOS PC 上的 agent 运行环境观测笔记：特殊权限、文件系统、工具链、ELF 签名、沙箱限制与可复用排错方案。 由 DSH / Claude Code / Kimi Code / DevEco Code 在真实设备上共同沉淀，脱敏整理后公开。

这套笔记回答什么问题

• 为什么 /tmp 是只读的？
• 为什么硬链接在 HarmonyOS 上全局不可用？
• 为什么预编译 .node 无法 dlopen，而本机编译的可以？
• 为什么没有 /bin/bash、没有 glibc？
• 现代 Linux 软件在鸿蒙上哪些能用、哪些不能用？
• Agent（DSH/CC/Kimi/DevEco）在这台机器上要避开哪些坑？

目录

harmonyos-agent-environment-notes/
├── README.md
├── knowledge/          # 日常可查的工具链/路由/技能/经验速查
├── artifacts/          # 深度审计、排错记录、可复用 patch
└── cc-memory/          # Claude Code 记忆中的兼容性要点

主要内容索引

平台硬约束速查

• knowledge/03-machine-toolchain.md
  • 包管理、Node 版本分工、bash 路径、clang/rust、代理、AtomGit
• knowledge/06-working-rules.md
  • 平台硬约束 8 条速记
• cc-memory/harmonyos-software-compatibility.md
  • 有源码就能编译、musl-only、hmdfs 安全限制

深度审计

• artifacts/dsh-deep-machine-audit-2026-08-19.md
  • 2026-08-19 DSH 实测复核：修正 el2 文件系统类型、OHOS_SDK 默认未导出、XDG 路径、HNP Node 24 崩溃条件、旧公开仓库滞后等
• artifacts/openharmony-environment-deep-review.md
  • 三层 MAC 沙箱：SELinux + seccomp + 文件系统
  • 文件系统地图：erofs / f2fs / hmdfs / sharefs
• artifacts/harmonyos-platform-audit.md
  • 内核架构、syscall 封杀清单、ELF 签名验证链
• artifacts/deepseek-harness-issues.md
  • DSH 在鸿蒙上的完整安装排错记录

可复用方案

• artifacts/harmonyos-dsh-source-build-guide.md
  • 源码 build 复活：补签 .node、lightningcss-wasm
• artifacts/*.patch — 已跑通的源码/修复补丁
• artifacts/dsh-cc-tui-harmonyos-audit.md — dsh-cc-tui 鸿蒙适配审计

其他

• knowledge/01-mcp-servers.md — MCP Server 清单
• knowledge/02-model-routing.md — 模型路由/Provider
• knowledge/04-skills-plugins.md — 技能/插件互通
• knowledge/05-project-experience.md — 项目经验
• knowledge/07-cc-tui-tunables.md — dsh-cc-tui 配置项
• knowledge/08-deveco-capabilities.md — DevEco Code 能力

路径占位符

文中使用占位符避免暴露具体用户名和机器路径：

占位符	含义
$HOME	用户主目录，如 /storage/Users/<用户名>
$EL2_BASE	应用数据分区 el2 base，如 /data/storage/el2/base
$HNP_ROOT	系统域包管理根，如 /data/service/hnp
$TMPDIR	可写临时目录，本机默认 $HOME/tmp

脱敏说明

本仓库只包含配置方式、命令、路径占位符、经验总结。不包含：

• API key / token / 密码原值
• 会话记录 / 聊天 outbox
• 日志、备份、session 快照

如你复现时发现路径不适用，请按实际设备路径替换占位符。

License

MIT