[xiaoland]

各实现此前将可复用领域能力与应用配置、启动和 UI 混在一起，外部程序难以独立消费。本 PR 确立跨语言 Core/App 合同：Core 是可独立消费的 SDK/lib，App 拥有运行环境、装配和交互，Extension 保留具体业务；不预设统一平台适配层或 DI 容器。

范围与下一步

新增 Core/App Product TDD，定义独立消费、依赖方向、显式实例与资源生命周期、兼容演进及可观察的验收条件；更新 topology、合同索引和导航。只含本任务的 4 个文件，不携带原 Hub 工作树其他任务的修改。发布项目：无软件包版本变化。

跨仓跟踪：https://github.com/InKCre/docs/issues/50。对应 Python、TypeScript、Swift 实现由跟踪项关联；未来 Rust/Kotlin 等按同一合同声明自己的能力范围。

用户已完成验收判断并授权合并。本 PR 已按正常门禁合入 main，共享最终引用为 17fc19e7230187a7a989815e7b8303bbb380f478。正式自部署由指定 InKCre Dogfood 聊天承接。

验证

• 4 份文档代码围栏、41 个本地链接及 git diff --check 通过。
• 合同与三端实现结果已对照；实现证据由对应 PR 拥有。
• 本实施聊天未执行本地 E2E。指定 Dogfood owner 已完成真实跨 Peer 与应用旅程验收，正式回执见 统一可观测性基建与 Web 观测工作区 #52。

风险、回滚与交付

风险在于把责任图误读成统一目录/包结构，或把独立消费误读成所有语言能力、平台完全相同；文档明确两者均不要求。回滚可整体撤销本 PR 的 4 文件改动，并协调已采用此合同的消费者。

仅修改共享设计文档；没有数据库迁移、凭据、软件包发布或生产部署操作。既有文档 PR 工作流可自行验证/预览。源提交先推送，Python/TypeScript 再分别提交子模块引用；合并后仍须核对最终引用。

依赖

直接父 PR：无，基于当前 main。
同仓子 PR：#53，现已合并；跨仓消费者见跟踪项。

后续统一可观测性

直接子 PR：https://github.com/InKCre/docs/pull/53（基于本 PR 的 Core/App 边界，已合并）。先合并本 PR，再将子 PR 重排到最新 main；跨仓交付由 #52 跟踪。

2026-11-05 合并交付已完成。Hub 四层按 #51 → #53 → #56 → #57 合入 main，最终 17fc19e 与已通过 Dogfood 的 5c5c254 整树一致，最终文档站正式发布成功。对应运行 42005096027。