NESTA 开发者手册
从协作框架、仓库结构、技术架构、部署机制与运维边界理解 NESTA 工程。
这套文档帮助维护者、工程师和协作 Agent 快速建立对 NESTA 工程的共同认识。它只描述稳定、可公开阅读的工程事实，不包含密钥、生产账号、服务器地址或运行时状态。
从哪里开始
- 团队协作框架：先掌握团队成员与 AI 工具共同遵循的变更闭环。
- 仓库目录：确认内容、代码、站点和部署配置分别承担什么职责。
- 技术架构：理解 Web、AI Gateway、流式协议与静态文档站如何协作。
- 部署机制：理解变更怎样经过检查、构建、同步和切换。
- 运维基础：理解健康检查、缓存、回滚和禁止索引等共同边界。
权威来源
| 对象 | 权威来源 | 说明 |
|---|---|---|
| 产品行为 | knowledge/product/ |
定义模块、流程、权限与产品边界 |
| 产品思想 | knowledge/philosophy/ |
解释 Home Agent 的产品方向与原则 |
| UI 规则 | knowledge/design/ |
定义视觉、组件、交互与无障碍约束 |
| 开发者文档 | knowledge/develop/ |
定义稳定的工程结构、架构与运行原则 |
| 可执行视觉值 | packages/design-tokens/ |
由 APP 和静态站点共同消费 |
| 发布门禁与内部操作 | docs/ |
保存具体检查清单、迁移和内部发布资料 |
网站只是这些来源的只读呈现。构建器可以转换、索引和发布内容，但不得反向修改 Markdown。
当前边界
V1 聚焦协作框架、目录、架构、部署和运维基础。环境安装教程、编码规范、ADR、API 参考与故障案例将在确有维护需求时扩展，不在本版预先建立空栏目。