# maintenance 与 oh/ — 资产清单与应用索引

这两个目录都是**轻目录**：不存放代码，只存放清单与索引。

## maintenance — 服务器资产清单

当前仅一份主机清单：

```
maintenance/
└── hosts/
    └── sl-workers.txt    # tjaicc-sl-01 ~ 04（每行一个主机名）
```

无自动化代码。与 `instandhalterin/ubuntu/rhosts/`、`site-deploy/config/hosts.env`
中的主机信息保持一致；新增/下线机器时三处同步。

## oh/ — 鸿蒙应用索引（软链）

本目录只放**相对软链**指向 canonical 鸿蒙工程（`../repos/...`，搬移整个工作空间
后链接仍有效），不复制代码。目的：一眼看清"有哪些鸿蒙项目、canonical 在哪个
namespace"。

| 软链 | 目标 | runtime | bundleName | 模块数 |
|---|---|---|---|---|
| `oh/obs` | `repos/appleinsky/obs` | OpenHarmony SDK 23 | `com.example.harmonyos_environment` | 1（entry） |
| `oh/immersiveworkspace` | `repos/nanoka/immersiveworkspace` | OpenHarmony SDK 15 | `com.example.immersiveworkspace` | 7 |
| `oh/openharmony-app` | `repos/yaogal/openharmony-app` | **HarmonyOS** NEXT 5.0.0(12) | （缺 `AppScope/app.json5`） | 1（entry） |

要点：

- **obs**：华为云 OBS 客户端，最成熟的鸿蒙工程（文件管理 + 传输 + PDF 预览 +
  媒体查看，含 hypium 测试）。签名材料在 `build-profile.json5` 明文引用——上生产
  前需轮换口令并从 git 移除。
- **immersiveworkspace**：多模块平板工作台（会议 / agent / 文档 / 文件中心 /
  OBS 助手），124 个 `.ets`。
- **openharmony-app**：billing 移动端，命名有歧义——实际是商业 HarmonyOS NEXT 而
  非 OpenHarmony；认证硬编码 Keycloak 且跑不通，待迁移 Casdoor + PKCE（见
  [](60)）。建议改名 `harmonyos-billing`。
- **重复 fork 不链**：`repos/105/obs` 与 `repos/105/immersiveworkspace` 视为镜像，
  保留原样、未来在 GitLab 侧归档；canonical 见上表。
- 空壳仓库（`appleinsky/filterpress`、`appleinsky/openclaw`）只有默认 README，
  不建链。

三仓均用 **hvigor + DevEco Studio**（或命令行 hvigorw）构建：

```bash
cd oh/<project>
ohpm install
./hvigorw assembleHap     # 输出在 entry/build/default/outputs/
```

详细的 bundleName / remote / fork 关系见 `oh/README.md`（事实来源）。