Nexus/docs/changelog/2026-06-04-functional-development-guide.md

Changelog: Nexus 功能开发指南（SSOT）

日期: 2026-06-04
类型: 文档
动机: 用户要求编写非常详细的功能文档，供后续开发接续使用；旧 nexus-full-site-features.md 基于 Tailwind 静态页，与当前 Vue 3 SPA 不一致。

变更摘要

1. 新增 docs/project/nexus-functional-development-guide.md 作为功能开发主参考（SSOT），覆盖架构、配置、19 表模型、Redis 数据流、后台任务、全量 API 索引、SyncEngineV2、14 页前端功能、Composables、WebSocket/WebSSH、Agent 协议、安装向导、本地验证/门控/部署及扩展开发 checklist。
2. 新增 docs/project/nexus-functional-development-guide-appendix.md：附录 A–I，含 sync 全端点 Pydantic 字段、Files/Push/Terminal 调用链与 mermaid 时序、schedules/retries 等待补 API、14 页组件映射、Playwright/L4 对照、错误码约定、扩展 checklist。
3. 主文档 §22 增加附录索引；AI-HANDOFF 文档列表已指向 SSOT。

涉及文件

文件	操作
docs/project/nexus-functional-development-guide.md	新增 / 更新
docs/project/nexus-functional-development-guide-appendix.md	新增
docs/changelog/2026-06-04-functional-development-guide.md	更新
docs/project/AI-HANDOFF-2026-06-03.md	更新文档索引

是否需迁移/重启

否（纯文档）。

验证方式

• 人工通读附录 A 与 server/api/sync_v2.py 端点数量一致
• 附录 B 与 useFilesPage.ts composable 导入一致
• 附录 G 与 full-acceptance.spec.mjs 15 用例一致

关联

• 接续 handoff: docs/project/AI-HANDOFF-2026-06-03.md
• 旧功能清单（HTML 时代）: docs/project/nexus-full-site-features.md（保留历史，以 SSOT+附录为准）