Files
Nexus/docs/changelog/2026-06-04-functional-development-guide.md
T
Nexus Deploy 0100ab2582 docs: consolidate archive, SSOT guide, and agent entry stubs
Move line-walk/delta/phase2/frontend audits and legacy memory into
docs/archive/, add functional development SSOT, thin AGENTS/CLAUDE stubs,
and regenerate changelog/audit indexes via consolidate_docs.py.
2026-06-04 23:01:03 +08:00

1.8 KiB
Raw Blame History

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:附录 AI,含 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+附录为准)