chore: align release docs and repository hygiene

This commit is contained in:
2026-07-22 01:25:10 +08:00
parent b1ce837845
commit 0daea4def9
29 changed files with 44 additions and 13481 deletions

View File

@@ -1,6 +1,6 @@
# 森林AI MVP 最终验证与视觉审计
审计日期2026-07-21
审计日期2026-07-22
## 结论
@@ -19,10 +19,13 @@
| 1440×1024 | `project-ai-controlled.png` | 会话列表、受控创建入口和“不会自动生成正式对象”说明可见 |
| 1440×1024 | `project-inbox-confirmed.png` | 收集内容、分析建议、选择项、确认结果和不可重复写入状态可见 |
| 390×844 | `login-react-acro-mobile.png` | 单栏布局,无水平裁切;首屏下方内容可纵向滚动 |
| 390×844 | `project-react-acro-mobile.png` | 默认关闭导航后主内容可访问标题正常横排、URL 位于视口内,指标以 2×2 排列 |
| 390×844 | `project-navigation-mobile.png` | 项目抽屉、遮罩与关闭路径可见 |
| 1024×768 | `channel-navigation-tablet-1024.png` | 频道侧栏默认收起,可从项目轨道右侧打开抽屉 |
| 390×844 | `project-react-acro-mobile.png` | 默认关闭导航后主内容可访问;标题和项目标识位于视口内,指标以 2×2 排列 |
| 390×844 | `workbench-mobile-search.png` | 移动端保留可打开、可关闭的全局搜索入口 |
| 390×844 | `project-navigation-mobile.png` | 13 个项目可在独立区域滚动,新建项目入口保持可见 |
| 390×844 | `channel-navigation-mobile.png` | 频道抽屉、最近会话与关闭路径可见 |
| 390×844 | `project-inbox-confirmed-mobile.png` | Inbox 列表和详情按单列重排,无横向溢出 |
| 1440×1024 | `project-inbox-empty-capture-analysis.png` | 空 Inbox 从真实收集表单进入刷新与分析流程 |
视觉脚本在桌面切换到移动视口后,会等待项目轨道与频道侧栏真正进入隐藏状态再采集项目主内容,避免把 160ms 收起动画的中间帧误当成最终证据。
@@ -35,7 +38,7 @@
- 项目页取消常驻右侧检查器,布局边界变为项目轨道、频道侧栏和主内容三段连续结构;项目强调色集中在横幅和小型标记。
- 任务页从静态示例卡片改为后端工作区数据驱动的标签、计数和空状态。
- 390px 项目页不再是桌面布局左侧切片;主内容默认可见,项目与频道分别通过顶部按钮打开抽屉。
- 390px 项目概览标题保持正常横排,项目 URL 保持在容器内并可在必要时省略,四项指标使用 2×2 网格并保持标签、数值和说明横向可读。
- 390px 项目概览标题保持正常横排,持久化项目标识保持在容器内,四项指标使用 2×2 网格并保持标签、数值和说明横向可读。
- Inbox 和 AI 页面明确保留“分析/受控会话 → 用户确认 → 正式对象”的边界,不把 AI 输出表现为已经自动执行。
## 核心交互与安全边界
@@ -46,7 +49,9 @@
- 项目/任务/笔记关键词搜索;较慢的旧响应不能覆盖较新的结果。
- 被授权的外部任务或笔记只打开受限预览,不加载或切换到无所有权的项目工作区;未知结果类型不伪造项目导航。
- 项目设置更新包含写入中状态、成功刷新和中文失败提示。
- 项目设置失败时保留原编辑草稿;截图 `project-mutation-failure-draft-retained.png` 记录该状态。
- Inbox 分析只读取服务端保存的建议;确认只发送勾选的建议 identity。网络结果不确定时冻结选择并复用原请求安全重试确定性 400、409 冲突和写入后刷新失败分别处理。
- 自定义链接频道明确显示只读“暂未开放”,计划任务只展示服务端持久化元数据且不提供伪开关或固定成功结果。
- AI 会话创建只发送标题和项目上下文;同项目乱序 GET、跨项目延迟 POST 和项目切换后的加载失败不会污染当前项目状态。
- 探索数据源、自定义频道/外链、升级支付、窗口停靠和自主 Agent 等范围外能力不呈现为可成功执行的控件。
@@ -54,7 +59,7 @@
## 剩余限制
- PostgreSQL 测试带 `integration` build tag未带 tag 时不会编译。当前 `DATABASE_DSN``DATABASE_URL` 均未配置,因此本轮未运行 tagged live check在隔离测试库配置其一后,运行 `go test -tags=integration ./internal/models -run TestPostgresPing -v`缺少两个变量时测试会失败,而不是跳过
- PostgreSQL 行为测试带 `integration` build tag未带 tag 时不会编译进普通测试。只有设置隔离数据库专用的 `TEST_DATABASE_URL` 后,运行完整套件 `go test -count=1 -tags=integration ./...`缺少变量时 tagged 测试会明确失败,且不会回退读取 `DATABASE_URL`
- 当前环境未安装 Docker CLI未执行 Compose 启动、数据库初始化或容器内端到端检查。
- Web 构建成功,但主 JavaScript chunk 约 663 kB、主 CSS chunk 约 592 kBVite 报告大于 500 kB 的体积警告;这是性能优化项,不阻塞 MVP 正确性验收。
- 桌面壳构建成功Windows 链接器输出了导入库创建信息并被 Rust 记录为一条 linker warning没有构建错误。