EvanAgent/dsh-harmony/knowledge-base

华为官方知识库（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
• 每周：浏览官方文档目录中与本产品相关的章节，记录变更