CHANGELOG

公开接口变更记录

只记录真实发生的接口变更。当前无任何 Deprecation/Sunset 计划—— 出现时将附确定的停止日期与迁移路径。

v1 兼容策略

v1 内允许新增可选字段、端点说明和兼容能力；
删除字段、改变字段含义、改变稳定 ID 或改变默认排序属于破坏性变更——将新开 v2；
稳定 ID（obs_/price_/ev_/pfv_ 前缀）一经发布不复用。

Agent 接口公开可用（GA）：REST / MCP / Skill / RSS 上线

2026-09-20

接口	状态	说明
网页	已上线	站点与全部入口页（/agent/ /method/ /changelog/）随 release rl_31c918e04d 发布
REST API	已上线	GET /api/v1/*（changes/prices/items/{id}/evidence/{id}/weekly/status）生产可用；四入口 online verify 通过，datasetVersion 与站点一致
MCP	已上线	POST /api/mcp（Streamable HTTP，五工具 maas_get_*）生产可用；Claude Code 新会话真实调用验收通过（含无结果语义）
Skill	已上线	Skill 包 1.0.0（/maas-skill/install.sh）生产可用；公网真实安装验收通过（manifest 校验、引用地址一致）
RSS	已上线	/feed.xml（≤100 条）与 /feed/weekly.xml（≤30 期）生产可用；真实订阅器验收通过（pubDate 精度语义、ETag/304）

本条目不包含破坏性变更。

公开接口初始状态（v1）

随首次生产部署确定

接口	状态	说明
网页	已上线	站点、条目/证据/价格详情页与 /agent/ /method/ /changelog/ 入口
RSS	待部署	/feed.xml（≤100 条有效变化）与 /feed/weekly.xml（≤30 期正式周报）本地构建与解析验证通过；生产 URL 与缓存响应头随 Task 06 部署
Skill	待部署	Skill 包 1.0.0 可下载安装；数据查询依赖 REST 生产路由，随 Task 06 生效
MCP	待部署	POST /api/mcp 本地实现完成，Claude Code 2.1.259 验证通过；生产路由随 Task 06 生效
REST API	待部署	REST API v1（OpenAPI 见 /openapi-v1.json）本地实现与测试完成；生产 /api/v1/* 随 Task 06 生效

本条目不包含破坏性变更。