189 lines
13 KiB
Markdown
189 lines
13 KiB
Markdown
# 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
|
||
|
||
### CI / smoke 护栏加固
|
||
|
||
- `scripts/check_repo_baseline.sh` 现在会在校验 Web 资产时显式检查 `storyforge-*.js` 是否真的存在，避免后续打包产物变化后只留下一个“看起来在跑、实际漏掉文件”的空洞通过。
|
||
- `scripts/smoke_fnos_storyforge_lan.sh` 现在对 `StoryForge` 首页、runtime 配置和 `19181` 兼容入口都做固定字符串断言；其中 `19181` 会校验真实兼容业务台文案，而不是只要抓取成功就算通过。
|
||
- 这轮护栏加固保持了现有基线语义不变，只把原来偏宽松的检查收紧成可追踪的真实断言。
|
||
|
||
### 主 Agent 配置与执行结果继续打通
|
||
|
||
- `跟踪账号 -> 立即同步` 现在在同步成功后会自动打开对应 `sync_job_id` 的任务详情，不再停留在一条“已同步”的提示上。
|
||
- 主 Agent 的执行结果卡、OneLiner 助手消息卡，现在都能直接跳转到 `主配置历史` 和 `平台 Agent 配置历史`，把一次执行和当时生效的治理版本真正连起来。
|
||
- `execution_card` 里新增了主配置与平台 Agent 配置的 `version_id`，后续继续做更深的版本对比和追溯时不需要再靠标题文本猜版本。
|
||
|
||
### 平台 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 悬浮窗口，方便顺着同一轮执行继续处理。
|
||
- 前端回归也补上了这两个动作入口和事件处理器，避免后续又退回成只能展示、不能继续操作。
|