docs(site): 0.25 changelog (#1014)

Author: quanru

apps/site/docs/en/api.mdx

@@ -13,6 +13,7 @@ Each Agent in Midscene has its own constructor.
 These Agents share some common constructor parameters:
 
 - `generateReport: boolean`: If true, a report file will be generated. (Default: true)
+- `reportFileName: string`: The name of the report file. (Default: generated by midscene)
 - `autoPrintReportMsg: boolean`: If true, report messages will be printed. (Default: true)
 - `cacheId: string | undefined`: If provided, this cacheId will be used to save or match the cache. (Default: undefined, means cache feature is disabled)
 - `actionContext: string`: Some background knowledge that should be sent to the AI model when calling `agent.aiAction()`, like 'close the cookie consent dialog first if it exists' (Default: undefined)

apps/site/docs/en/changelog.mdx

@@ -2,6 +2,37 @@
 
 > For the complete changelog, please refer to: [Midscene Releases](https://github.com/web-infra-dev/midscene/releases)
 
+## v0.25 - 🚀 Support Using Images as AI Prompt Input
+
+### 🎯 Core Function Enhancement
+- New worker runtime support, support running in worker environment
+- Support using images as AI prompt input, see [Prompting with images](./api.mdx#prompting-with-images)
+- Image processing upgrade, using Photon & Sharp for efficient image cropping
+
+### 🌐 Web Integration Optimization
+- Get XPath by coordinates, improve cache reproducibility
+- Cache file moves plan module to the front, improving readability
+- Chrome Recorder supports exporting all events to markdown documents
+- agent supports specifying HTML report name, see [reportFileName](./api.mdx)
+
+### 📱 Android Automation Enhancement
+- Long press gesture support
+- Pull-to-refresh support
+
+### 🐞 Bug Fixes
+- Use global config to handle environment variables, avoid issues caused by multiple packaging
+- Manually construct error information when error object serialization fails
+- Fix playwright report type dependency declaration order issue
+- Fix MCP packaging issue
+
+### 📚 Documentation AI-Friendly
+- [LLMs.txt](./llm-txt.mdx) is now available in both Chinese and English, making it easier for AI to understand
+- Each document now has a copy-to-markdown button, making it easier to feed to AI
+
+### 🤖 Other Function Enhancement
+- Chrome Recorder supports aiScroll function
+- Refactor aiAssert to be consistent with aiBoolean
+
 ## v0.24 - 🤖 MCP for Android Automation
 
 ### 🚀 MCP for Android Automation

apps/site/docs/zh/api.mdx

@@ -13,6 +13,7 @@ Midscene 中每个 Agent 都有自己的构造函数。
 这些 Agent 有一些相同的构造参数：
 
 - `generateReport: boolean`: 如果为 true，则生成报告文件。默认值为 true。
+- `reportFileName: string`: 报告文件的名称，默认值由 midscene 内部生成。
 - `autoPrintReportMsg: boolean`: 如果为 true，则打印报告消息。默认值为 true。
 - `cacheId: string | undefined`: 如果配置，则使用此 cacheId 保存或匹配缓存。默认值为 undefined，也就是不启用缓存。
 - `actionContext: string`: 调用 `agent.aiAction()` 时，发送给 AI 模型的背景知识，比如 '有 cookie 对话框时先关闭它'，默认值为空。

apps/site/docs/zh/changelog.mdx

@@ -2,6 +2,37 @@
 
 > 完整更新日志请参考：[Midscene Releases](https://github.com/web-infra-dev/midscene/releases)
 
+## v0.25 - 🚀 支持使用图像作为 AI prompt 输入
+
+### 🎯 核心功能增强
+- 新增运行环境，支持运行在 Worker 环境
+- 支持使用图像作为 AI prompt 输入，详见 [使用图片作为提示词](./api.mdx#%E4%BD%BF%E7%94%A8%E5%9B%BE%E7%89%87%E4%BD%9C%E4%B8%BA%E6%8F%90%E7%A4%BA%E8%AF%8D)
+- 图像处理升级，采用 Photon & Sharp 进行高效图片裁剪
+
+### 🌐 Web 集成优化
+- 通过坐标获取 XPath，提高缓存可复现性
+- 缓存文件将 plan 模块提到最前面，增加可读性
+- Chrome Recorder 支持导出所有事件到 markdown 文档
+- agent 支持指定 HTML 报告名称，详见 [reportFileName](./api.mdx)
+
+### 📱 Android 自动化增强
+- 长按手势支持
+- 下拉刷新支持
+
+### 🐞 问题修复
+  - 使用全局配置处理环境变量，避免因多打包导致环境无法覆盖的问题
+  - 当错误对象序列化失败时，手动构造错误信息
+  - 修复 playwright 报告类型依赖声明顺序问题
+  - 修复 MCP 打包问题
+
+### 📚 文档 AI 友好
+- [LLMs.txt](./llm-txt.mdx) 区分中文与英文，方便 AI 理解
+- 每篇文档顶部新增按钮，支持复制为 markdown，方便喂给 AI 使用
+
+### 🤖 其它功能增强
+- Chrome Recorder 支持 aiScroll 功能
+- 重构 aiAssert 使其与 aiBoolean 实现一致
+
 ## v0.24 - 🤖 Android 自动化支持 MCP 调用
 
 ### 🚀 Android 自动化支持 MCP 调用