diff --git a/docs/changelog.md b/docs/changelog.md
index 9309297..61b9bcd 100644
--- a/docs/changelog.md
+++ b/docs/changelog.md
@@ -2,7 +2,29 @@
 
 > 坐看云卷云舒，静听花开花落
 
-## [1.0.0] - 2026-05-07
+## [1.0.0] - 2026-05-08
+
+### 发布说明
+第一个稳定发布版本。云枢·Agent 作为可独立运行的 Agent 系统，支持通过 LLM + 工具注册表 + 外挂 Agent 定义实现自然语言驱动的天气查询。
+
+### 功能
+- 三层分离架构：Agent Skill（行为）↔ 普通 Skill（知识）↔ Tool（确定性执行）
+- 外挂 Agent 定义：`.md` 文件即 Agent，YAML frontmatter + Markdown body
+- 4 个内置工具：`http-get`、`skill`、`read-file`、`geocode`
+- Session 会话管理：`~/.config/yunshu/session.json` 持久化对话历史
+- 交互模式 + 单次查询双模式运行
+- `onboard` 交互式初始化向导
+- 双路径搜索：项目目录优先，`~/.config/yunshu/` 后备
+- 旧配置自动迁移：`~/.config/weather-cli/` → `~/.config/yunshu/`
+- LLM 配置：支持配置文件 + 环境变量双重配置，兼容 OpenAI Chat Completion API
+
+### 技术栈
+- 语言：Go 1.21
+- 依赖：仅 `gopkg.in/yaml.v3`
+- 默认 LLM：豆包（火山引擎）`doubao-seed-2-0-pro-260215`
+- 数据源：MSN 天气非公开 API（`assets.msn.cn`）
+
+## [1.0.0-rc.1] - 2026-05-07
 
 ### 重大变更
 - **项目更名**：weather-cia → **云枢·Agent**（英文名 YunShu / yunshu）