storyforge/CHANGELOG.md

StoryForge Changelog

这个文件用于给 Gitea 仓库保留阶段性版本更新记录，方便直接查看每一轮里程碑，不用只依赖零散 commit。

2026-03-30

主 Agent 治理与运行闭环

• 完成主 Agent 治理底座第一版，补齐系统策略、用户策略、管理员覆盖、历史版本与回滚。
• 主 Agent 悬浮窗口已经接通运行创建、执行确认、进度追踪、结果查看、历史筛选和异常重试。
• 业务页支持把上下文直接交给主 Agent，执行完成后会把结果和下一步动作回写到对应页面。

Web 工作台信息架构

• 首页改成旧 UI 风格下的 先动作、后概览 结构，保留当前项目视角和 1 主 2 次 今日动作。
• 非首页页面做了一轮可用性清理，重页面改成 tab / 分层结构，薄页面补齐首屏任务感。
• 管理员配置台和用户侧页面边界进一步清晰，避免系统治理内容挤进普通工作流。

移动端原生适配

• Web V4 已补成移动端原生风工作台：移动头部、底部导航、项目切换带、底部面板式 OneLiner。
• 找对标 / 生产中心 / Agent / 我的策略 / 我的项目 / 跟踪账号 / 复盘 / 额度 / 设置 都增加了移动端任务卡和紧凑摘要。
• 移动端抽屉、底部 sheet、项目切换、主 Agent 面板、结果提示等交互做了一轮真实收口。

真实能力对齐

• 清理了前端里一批“后端暂未接入”的旧占位文案，改成真实空状态和真实下一步。
• OneLiner 动作注册表 / 平台 Agent / 租户额度 / 复盘 已按 live collector 实际能力展示，不再误导成“还没接”。
• 额度 和 复盘 页面首屏已改成围绕 live 数据的任务页，直接展示风险、主要消耗、高频结论和下一步动作。
• 跟踪已读 / 批量跟踪同步 / 单账号跟踪同步 / 高分作品分析 / 平台技能验收 已改成“真实调用优先”，避免旧 capability 口径把已接好的接口误判成未接入。
• OneLiner 会话 / 运行详情 / 治理控制面 / integrations / live-recorder 这些固定接口也已经切成 live-first，请求失败才降级，不再先被陈旧 capability 表拦住。
• 任务恢复链会优先真实调用 /v2/explore/jobs/{job_id}/retry，只有接口真的不存在时才回退到手动恢复模板。
• 找对标 / 跟踪账号 里一批已经失效的 “当前平台待接入” 按钮禁用与入口分支已删除，当前 active 平台都直接走真实路由，失败时再给真实反馈。
• 工作台前端已经清掉浏览器 alert 弹窗，缺对象、权限不足、刷新失败和加载失败都会回到站内反馈，不再把用户从当前流程里打断出去。
• OneLiner 会话 / 主 Agent 运行 / 动作执行器 / 跟踪同步 / 高分分析 / 平台技能验收 这批真接口也已经去掉“当前实例未提供”的旧降级口径，统一按 live 结果说话。
• 新增一条前端回归护栏：静态声明出来的 data-action 必须有明确处理逻辑，避免后续再出现“点了没反应，最后落到动作待接入”的隐性缺口。
• 后端契约测试新增 live-first 路由覆盖，直接校验 分析高分作品 / 批量跟踪同步 / 单账号跟踪同步 / 跟踪游标 这些当前前端已完全依赖的接口。
• 后端契约测试继续向治理与运维面扩展，新增 OneLiner 动作注册表 / 平台 Agent / 平台技能验收与回滚 / tenant quota & usage / admin ops 扫描与修复计划 的 live 路由覆盖。
• 修掉了平台 Agent 在“项目尚未绑定 assistant”时的真实外键问题：现在空项目也能先保存 OneLiner / 平台 Agent 配置，再逐步补齐执行 Agent，不会因为空 assistant_id 直接失败。
• 主 Agent 治理测试的清库逻辑也收紧了，回归时不再因为外键残留跳过删除，避免后续新增治理测试后出现假红灯。

NAS 联调与回归

• NAS 局域网联调链保持可用：
  • Web: http://192.168.31.188:19192/
  • Collector: http://192.168.31.188:19193/healthz
• 当前基线通过：
  • 前端测试 63/63
  • 后端单测 35/35
  • bash scripts/check_repo_baseline.sh
  • bash scripts/smoke_fnos_storyforge_lan.sh

版本记录与 CI

• 新增仓库级 CHANGELOG.md，让 Gitea 仓库能直接看到阶段性更新记录。
• 最小回归 workflow 同时落在 .github/workflows/ci.yml 和 .gitea/workflows/ci.yml，GitHub Actions 与 Gitea Actions 都能跑相同的基线、后端单测和 Web 测试。

2026-03-31

主 Agent 配置业务流收口

• 管理员配置台里的系统主 Agent、系统平台策略、管理员覆盖这条配置流补上了前端本地权限兜底，非超级管理员不会再直接撞到后端 403。
• 管理员覆盖目标为空时，前端会明确提示“当前治理目录里还没有可选用户”，不再放出无效保存和回滚动作。
• 管理员侧三类历史回滚弹层都改成了只读空态：没有历史版本时会隐藏提交按钮，也不会再让空 version_id 发起无效回滚请求。

配置流回归护栏

• Web 工作台测试新增了主 Agent 配置流空态保护和权限保护覆盖，重点锁住：
  • 管理员历史回滚空态
  • 管理员治理动作本地权限 guard
  • 管理员覆盖目标为空时的编辑/历史保护
• 当前基线重新验证通过：
  • 前端测试 66/66
  • 后端单测 35/35
  • bash scripts/check_repo_baseline.sh
  • bash scripts/smoke_fnos_storyforge_lan.sh

NAS 联调发布

• 最新 Web 已重新发布到 fnOS NAS：

OneLiner 主配置版本化

• OneLiner 主配置 现在和策略治理层一样，已经支持版本历史、回滚和审计，不再是直接裸改。
• 后端新增了 GET /v2/oneliner/profile/versions、GET /v2/oneliner/profile/audits、POST /v2/oneliner/profile/rollback，并让 GET/PUT /v2/oneliner/profile 直接返回当前版本、历史数量和最近审计。
• 前端 配置 OneLiner 弹层补了当前版本摘要和变更原因，Agent 工作台也新增了 看配置历史 与 历史与回滚 入口。
• 回滚会生成新的版本快照并保留审计链，不会直接覆盖旧记录。

OneLiner 配置流回归

• 新增主配置版本历史和回滚测试，覆盖：
  • 初始化版本种子
  • 连续更新后的历史版本
  • 回滚生成新版本
  • 审计记录包含更新与回滚动作
• 前端工作台测试也新增了 OneLiner 主配置历史 的回滚与审计入口校验。
• 主 Agent 配置业务流的这轮修复已经同步到 Gitea，后续可以直接基于当前分支继续收剩余真实能力细节。

OneLiner 配置版本进入执行链

• 主 Agent 在创建 run、重试 run 和完成 run 时，都会把当前 OneLiner 主配置版本 一起固化进治理快照和结果卡，不再只有治理页知道自己用了哪一版配置。
• 完成态结果现在会带上 execution_card.oneliner_profile_version，前端浮窗、运行卡和结果卡都能统一显示 配置 vN，避免进入执行链后丢失配置来源。
• run 的治理快照也收窄成“当前主配置 + 当前版本”最小运行态，不再把完整版本历史和审计链塞进每次执行记录，避免 agent_runs.governance_json 无限制膨胀。
• Web 回归测试修正了 OneLiner 运行区函数边界，并新增了对执行链配置版本显示的断言；后端治理测试也补上了 run 完成态必须带配置版本的检查。

平台 Agent 配置进入执行链

• 主 Agent 在创建 run、重试 run 时，会把当前平台 Agent 的最小运行快照一起固化进治理快照，包括平台、Agent 名称、承接使命、assistant 名称和 readiness 状态。
• 完成态结果现在会带上 execution_card.platform_agent_profile，前端浮窗、当前运行卡和结果卡都能直接看到“本轮平台 Agent”，执行链不会再丢失平台侧配置来源。
• run 的平台 Agent 快照只保留运行时最小必要字段，不把完整平台 Agent 配置、技能列表和记忆列表塞进执行结果，避免执行记录继续膨胀。
• Web 回归测试新增了对“本轮平台 Agent”结果渲染的断言；后端治理测试也补上了 run 创建态与完成态必须带平台 Agent 快照的检查。

NAS 联调发布

• 最新 Web 已重新发布到 fnOS NAS：
  • Web: http://192.168.31.188:19192/
  • Collector: http://192.168.31.188:19193/healthz
• 当前基线重新验证通过：
  • 前端测试 67/67
  • 后端单测 36/36

2026-04-04

平台 Agent 配置历史与回滚

• 平台 Agent 配置 现在和 OneLiner 主配置 一样，已经支持版本历史、回滚和审计，不再只是直接编辑当前值。
• 后端新增了：
  • GET /v2/platform-agents/{platform}/profile/versions
  • GET /v2/platform-agents/{platform}/profile/audits
  • POST /v2/platform-agents/{platform}/profile/rollback
• PUT /v2/platform-agents/{platform}/profile 现在支持记录变更原因，并在保存时自动生成新的版本快照。
• 前端 平台 Agent 配置 弹层新增当前版本摘要和变更原因，平台 Agent 面板 / 详情 也都新增了 看配置历史 入口。

平台 Agent 配置进入执行回写

• 主 Agent 在创建 run、重试 run、完成 run 时，都会把当前平台 Agent 配置版本号一起带入执行链。
• 平台 Agent 的 recent_execution 现在会显示本轮使用的 平台 Agent vN，方便直接判断最近一次执行到底用了哪版平台配置。
• run 完成态结果里的 execution_card.platform_agent_profile 也会携带平台 Agent 版本号、标题和摘要，悬浮主 Agent 结果卡能直接回看这轮平台配置来源。

回归护栏

• 后端治理测试新增了平台 Agent 配置版本链路覆盖：初始化版本、连续更新、回滚生成新版本、审计记录，以及执行完成后的 recent_execution.platform_agent_profile_version_no 回写。
• 前端工作台测试新增了平台 Agent 配置历史入口、历史接口、回滚接口和结果卡版本显示的校验，避免后续再把这条链断开。
  • bash scripts/check_repo_baseline.sh
  • bash scripts/smoke_fnos_storyforge_lan.sh

2026-04-04

平台 Agent 执行回写闭环

• 平台 Agent 配置现在不只是“被主 Agent 带进执行链”，还会在主 Agent 完成态后反向记录最近一次执行信息。
• platform_agent_profiles 新增最近执行回写字段，保存：
  • 最近 run id
  • run 状态
  • 最近使用时间
  • 意图 key
  • 使用的 OneLiner 配置版本号
  • 执行摘要
  • 来源页面
• GET /v2/platform-agents 现在会返回 recent_execution，平台 Agent 总览卡和详情弹层都会直接显示“最近执行”和“配置 vN”，方便追溯平台配置最近是怎么被主 Agent 用起来的。
• 这条回写链已经覆盖到主 Agent 完成态读取路径，避免只在治理层能看到版本，执行面却看不到最近一次真实使用记录。

回归护栏

• 后端新增平台 Agent live 路由回写测试，确认：
  • 创建并确认一条主 Agent run 之后
  • GET /v2/platform-agents 能返回 recent_execution
  • 最近执行会带上 run id、intent 和 oneliner_profile_version_no
• 前端工作台测试新增平台 Agent 最近执行渲染断言，锁住总览卡和详情弹层里的“最近执行”展示。

平台 Agent 最近执行继续处理

• 平台 Agent 总览卡和详情弹层里的“最近执行”现在都带上了直接动作，不再只是只读摘要。
• 新增“查看执行结果”，会直接打开对应主 Agent run 的结果卡。
• 新增“回到主 Agent 查看”，会切到对应 run 的上下文并打开主 Agent 悬浮窗口，方便顺着同一轮执行继续处理。
• 前端回归也补上了这两个动作入口和事件处理器，避免后续又退回成只能展示、不能继续操作。