From c400c1af444383b6b34a411ca8aa0abd3aca3e43 Mon Sep 17 00:00:00 2001
From: kris <krisoso.com@gmail.com>
Date: Mon, 30 Mar 2026 17:26:27 +0800
Subject: [PATCH] docs: add changelog for gitea release tracking

---
 CHANGELOG.md | 40 ++++++++++++++++++++++++++++++++++++++++
 README.md    |  1 +
 2 files changed, 41 insertions(+)
 create mode 100644 CHANGELOG.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..eba63d7
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,40 @@
+# 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 数据的任务页，直接展示风险、主要消耗、高频结论和下一步动作。
+
+### NAS 联调与回归
+
+- NAS 局域网联调链保持可用：
+  - Web: `http://192.168.31.188:19192/`
+  - Collector: `http://192.168.31.188:19193/healthz`
+- 当前基线通过：
+  - 前端测试 `59/59`
+  - `bash scripts/check_repo_baseline.sh`
+  - `bash scripts/smoke_fnos_storyforge_lan.sh`
+
diff --git a/README.md b/README.md
index 9927dca..75a6273 100644
--- a/README.md
+++ b/README.md
@@ -5,6 +5,7 @@ StoryForge 现在拆成独立项目目录，和 `AI-glasses` 分开维护。
 仓库边界和维护约束见：[StoryForge 仓库边界说明](./docs/STORYFORGE_REPO_BOUNDARY_2026-03-26.md)。
 拆分治理方案见：[StoryForge / AI Glasses 拆分评估方案](./docs/STORYFORGE_SPLIT_ASSESSMENT_2026-03-26.md)。
 当前项目状态见：[StoryForge 当前项目状态](./docs/CURRENT_PROJECT_STATE_2026-03-26.md)。
+阶段性版本更新记录见：[StoryForge Changelog](./CHANGELOG.md)。
 `AI-glasses` 独立代码仓库已单独维护在 [krisolo/ai-glasses](https://git.hyzq.site/krisolo/ai-glasses)。
 
 ## 目录