仓库目录 · NESTA Developer

NESTA 使用一个工作区承载产品知识、应用、服务、共享包、独立站点与部署配置。目录划分首先表达职责和权威关系，其次才表达构建工具。

NESTA 仓库由权威知识、应用与服务、独立站点、共享包和部署配置组成

顶层结构

NestaApp/
├── knowledge/            # 唯一权威文档库
│   ├── philosophy/       # 产品思想
│   ├── product/          # 产品设计与行为
│   ├── design/           # UI 设计系统
│   ├── develop/          # 开发者手册
│   └── agentic-home-os/  # 跨产品全景基线
├── apps/                 # 面向用户的应用
├── services/             # 服务端与外部能力适配
├── packages/             # 可复用的可执行共享包
├── sites/                # 独立静态网站实现
├── docs/                 # 工程门禁、迁移、发布与内部运维资料
├── deploy/               # 生产编排和发布脚本
└── releases/             # 本地/生产运行时发布历史，不进入 Git

目录职责

目录	主要职责	不承担的职责
`knowledge/`	保存产品、设计与开发者权威内容	不保存网站模板或构建产物
`apps/`	实现面向最终用户的产品体验	不定义服务端密钥和部署状态
`services/`	实现 Gateway、供应商适配和服务端策略	不复制浏览器组件或产品规范
`packages/`	保存跨工程共享的可执行契约	不保存单站点私有样式
`sites/`	把权威 Markdown 转换为独立网站	不回写或复制维护权威正文
`docs/`	保存发布门禁、迁移核对和内部工程资料	不建立第二份产品或 UI 规范
`deploy/`	定义 Caddy、Compose、发布和回滚	不保存密钥或在线发布产物

依赖方向

APP 由 apps/web 组合页面、功能、实体与共享基础设施。
AI Gateway 位于 services/ai-gateway，通过稳定的请求与流式事件契约服务 Web。
静态站点只读消费各自负责的 knowledge/ 类别和共享 Token。
部署层消费构建产物，不反向成为应用或文档的依赖。

生成物边界

dist/、build/、releases/、.venv/、测试结果和部署运行时状态都可以重新生成，不能作为权威来源，也不得直接编辑。需要修复输出时，应修改来源、构建器或发布脚本后重新生成。