# 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+附录为准）
