# 华为官方知识库（DSH Harmony 开发基线）

> 建立：2026-08-23。维护规则：开发中一切平台能力问题先查本库；本库没有的，查官方文档站；官方文档不明确或存在歧义的，记录到 open-questions.md 并请产品负责人判断，不得自行猜测。

## 事实源优先级（从高到低）

1. 本地 SDK d.ts（~/Library/OpenHarmony/Sdk/26.0.0/ets/api/）——随工程 targetSdk 版本走的权威 API 面，见 local-sdk-api-map.md
2. 官方文档站（developer.huawei.com/consumer/cn/doc/）——注意：站点为 SPA，curl 抓不到正文，需浏览器阅读；入口目录见 huawei-docs-catalog.md
3. 社区文章/论坛——仅供参考，必须以 1、2 复核

## 本库结构

| 文件 | 内容 | 更新方式 |
|---|---|---|
| huawei-docs-catalog.md | 官方文档 URL 目录（按产品模块映射，标注验证状态） | 人工 + 开发过程中补充 |
| local-sdk-api-map.md | 本地 SDK 权威 API 清单与关键结论（如子进程限制） | SDK 升级后重查 |
| ecosystem-tracker.md | DSH 生态竞品跟踪快照 | 脚本 + 人工 |
| fetch-ecosystem.sh | 生态数据刷新脚本（GitHub star / npm 下载量） | 随时执行：bash fetch-ecosystem.sh |
| open-questions.md | 官方要求不明确、需要用户判断的问题清单 | 发现即记录 |
| build-recipe.md | CLI 构建配方（hvigor 环境变量、签名流程） | 构建链变更时 |
| emulator-notes.md | 模拟器启动约束（账号鉴权）与 MCP 工具可用性映射 | 模拟器/工具链变更时 |
| cases.md | 问题案例库（根因、修复、通用教训） | 发现即记录 |

## 更新纪律

- 每次开发会话开始：跑一次 fetch-ecosystem.sh，看 dsh 官方是否发新版（协议契约相关）
- 每次 DevEco/SDK 升级：重查 local-sdk-api-map.md 中的 API 是否有 breaking change
- 每周：浏览官方文档目录中与本产品相关的章节，记录变更