YunShu/docs/changelog.md

云枢·Agent 版本变更日志

坐看云卷云舒，静听花开花落

[1.0.0] - 2026-05-07

重大变更

• 项目更名：weather-cia → 云枢·Agent（英文名 YunShu / yunshu）
• 配置目录迁移：~/.config/weather-cli/ → ~/.config/yunshu/（自动迁移）
• 二进制名称改为 yunshu

[0.3.0] - 2026-05-07

新增

• geocode 工具：通过 wttr.in 查询城市坐标，支持中文和英文城市名
• skills/geocoding/SKILL.md：地理编码验证规则（同名城市检测、国家核对）
• 架构分离：agent skill 只放行为，普通 skill 只放知识，tool 负责确定性执行

变更

• agents/weather-agent.md 精简为纯行为定义（去掉所有 MSN API 内联细节，改为按需加载 skill）
• 城市定位方式：从静态 cities.json 查表 → 调用 geocode 工具实时查询
• agents/weather-agent.md tools 新增 geocode
• session 文件从项目目录移至 ~/.config/weather-cli/session.json

[0.2.0] - 2026-05-07

新增

• onboard 子命令：交互式初始化向导，引导用户配置 LLM 连接信息
• 全局配置文件 ~/.config/weather-cli/config.yaml，存储 LLM host/model/key
• 双路径搜索机制：项目目录优先，~/.config/weather-cli/ 后备
• 首次运行检测：未配置时提示用户运行 weather-cia onboard

变更

• 项目重命名为 weather-cia
• 配置加载改为：配置文件 → 环境变量（环境变量优先级更高）
• Agent/skill 搜索路径扩展：项目目录 → 全局配置目录
• onboard 自动复制默认 agents/skills/data 到全局配置目录

[0.1.0] - 2026-05-07

新增

• 项目初始化，基于 Go 实现的轻量级 agent 框架
• 核心架构：.md 文件定义 agent 行为，代码只负责加载和执行
• 工具系统：声明式注册（http-get, skill, read-file）
• Session 会话管理：session.json 记录对话历史，支持上下文追问
• 天气情报官 agent（weather-agent.md）：通过 MSN 天气 API 查询实时天气和预报
• MSN 天气 API Skill（msn-weather-api/SKILL.md）：API 知识按需加载
• 内置 42 个中国城市经纬度数据库（data/cities.json）
• 支持单次查询和交互模式两种运行方式
• 默认集成豆包（火山引擎）LLM，通过环境变量可切换

技术细节

• 语言：Go 1.21
• 依赖：仅 gopkg.in/yaml.v3（用于解析 frontmatter）
• API 兼容 OpenAI Chat Completion 格式
• 环境变量：OPENAI_API_KEY（必填）、LLM_ENDPOINT、LLM_MODEL