03-13 → 04-05：从基础审计到左右分栏工作台¶

背景¶

Agent Portal 的工作台经历了从「纵向堆叠」到「7:3 左右分栏」的完整演进。这个过程中，Dad 持续推动交互方向：Bot 作为入口、详情轻量化、任务列表与流程图联动。

审计结论：项目已有研究阶段（提问→文献→假设→POC→结论→报告）、任务、产出物、时间线的主框架，但数据同步机制不完善，UI 展示不稳定。

Dad 决策：产出物应自动同步到 UI，不能手动维护。

自动同步上线： - bot 实现工作区扫描 → AP_artifacts upsert - 首次同步导入 117 个产出物，第二次全部 skipped（dedup 正常） - 关键环境变量：WORKSPACE_ROOT 必须指向正确根目录

部署修正：Dad 指出部署到了韩国测试机，应部署到 project.dora.restry.cn（本机 4.194.153.244）。

Dad 需求：md 文件能不能直接在当前页面用弹窗打开，并且支持编辑？

bot 重新定位：Agent Portal 不只是展示工具，而是研究管理工作台。

落地：新增 MarkdownModal、ContextMemorySection，点击 SOUL.md 等文件可弹窗查看。详情页结构调整为：研究阶段→上下文&记忆→任务→笔记→时间线。

Dad 决策：子页面不要用面板展示，特别是手机上不好看，直接用新页面。

黑屏事故：Codex 重构后详情页全部黑屏。根因是 ArrowLeft 使用但未 import。修复后 v3.4 所有页面恢复。

Dad 需求：把"项目同步"做成 skill，一小时运行一次，运行记录显示在任务列表里。

实现： 1. 创建 sync skill + script 2. 系统 crontab 每小时执行 3. Portal 为每个项目创建"项目同步"任务

Dry run 发现 3 个项目说明需更新、14 个新产出物。正式执行后任务列表可见同步任务。

产出物 404：artifact URL 存的是 file:// 本地路径，前端 fallback 到 <a href>。修复：统一走 doc API。
上下文消失：WORKSPACE_ROOT 错误指向 .../projects，实际文件在 .../workspace-research/。修正后恢复 6 个上下文 + 9 个记忆文件。
CONTEXT.md 集成：Dad 要求了解"模型实际加载了哪些内容"，在 README 按钮下方增加 CONTEXT.md 入口。

Dad 核心决策：不要把项目列表做主入口，应把机器人作为入口，点击后再展开详情。Desktop 用弹窗，Mobile 用页面。

现状分析：ProjectDetailPage 约 600+ 行、4 个 Tab，为独立页面设计，不适合轻量展开交互。

PortalBot 首轮改动引入黑屏：researcher 对比确认 HEAD 正常，PortalBot 改动导致黑屏。回滚后重新派任务。

Dad 要求：researcher 负责监督、验证、交付结果，不要只转述。

日报： - Dad：不要单独页面，挂到 bot 详情下面 - 展示方式改为 timeline，字体不要太大 - API：/api/daily-reports

Changelog： - Dad：变更日志应由采集任务驱动，不能只靠 commit message - PROJECT_REGISTRY 的 githubRepo 从硬编码迁移到数据库 metadata.githubRepo

交互问题暴露：点击 bot 卡片时，"展开详情"和"进入聊天"容易混淆，为后续 React Flow 节点交互模型提供了改进动机。

Dad 否定：效果很差，左侧画布不能拖拽。要求 researcher 自己上手。

结果：大幅改善，流程图清晰可见。

时间	决策者	决策
03-13	Dad	产出物必须自动同步
03-13	Dad	Markdown 文档必须在页面内弹窗打开
03-14	Dad	详情页改为独立页面，不用面板
03-14	Dad	同步任务运行记录显示在任务列表
03-21	Dad	Bot 作为 Portal 主入口，不是项目列表
03-21	Dad	详情展示适配端形态（Desktop modal / Mobile page）
03-23	Dad	researcher 角色固化为 PM + 测试员
04-05	Dad	工作台改为 7:3 左右分栏