Grasses 1.2.2

Grasses 1.2.2

本次更新重新设计阅读结果、图片阅读和设置界面，增强 AI 请求的临时故障恢复，并为单词和短语补充独立中文翻译。

阅读体验

• 结果面板采用更清晰的翻译优先布局，改善翻译、语法分析、加载中和失败状态的呈现。
• 优化段落阅读和句子分析布局，使内容层次、当前进度与异常提示更容易辨认。
• 图片阅读现在更清楚地展示可分析区域、编号目标和分析进度，并改善 AI 尚未配置时的恢复流程。

AI 请求可靠性

• 遇到服务暂时不可用、请求频率限制或临时网络错误时，Grasses 会自动重试，减少偶发中断。
• 流式响应中断后仅在尚未输出内容时重试，避免结果面板出现重复文本。
• 身份验证、配置和无效响应等需要用户处理的错误不会自动重试，错误反馈仍会直接显示。

单词与短语翻译

• 单词和短语分析现在都会提供独立的中文翻译，不再只依赖词义或用法说明。
• 独立翻译会显示在阅读结果中，并包含在复制的结果文本里。
• 再次打开缺少独立翻译的旧版单词或短语历史时，Grasses 会请求补全缺失内容。

设置界面

• 简化设置页面结构，并更明确地展示 AI Provider、API Key 和模型的就绪状态。
• 改善连接测试的进行中、成功和失败反馈，便于确认当前 AI 配置是否可用。

从 1.2.1 升级

1.2.1 用户可以通过菜单栏中的“检查更新...”升级。现有设置、AI API Key、Activation Token 和已保存的阅读历史不会被删除。

系统要求

• macOS 13 或更高版本。
• 配备 Apple 芯片的 Mac；不支持 Intel Mac。

获取帮助

• QQ 群：1075924792
• 邮箱：support@grasses.brainbeats.pro
• 网站：grasses.brainbeats.pro
• 问题反馈：GitHub Issues

请勿在公开反馈中提交 API Key、完整激活码、Activation Token 或包含隐私信息的阅读内容和截图。

Grasses 1.2.1

Grasses 1.2.1

本次更新重点改善选取翻译和阅读历史复用，并增强对 Markdown、LaTeX 公式及学术内容的翻译支持。

选取翻译

• 改善 Zotero 等应用中的选取文本读取，解决手动复制正常但 Grasses 无法取得所选内容的问题。
• 当目标应用没有及时响应复制操作时，Grasses 会等待并自动重试，提高长文本和复杂页面中的读取成功率。
• 选取翻译完成后仍会恢复原有剪贴板内容，不影响之后的粘贴操作。

阅读历史与结果复用

• 开启阅读历史后，再次选取或复制相同内容时，会优先复用最近一次相同阅读类型的结果，减少不必要的 AI 请求和等待时间。
• 如果历史结果完整，Grasses 会直接显示已有结果，不会再次联系 AI Provider，也不会消耗 Pro 体验次数。
• 如果上次分析只有部分完成，Grasses 只会重新请求缺失或失败的部分，并保留已经完成的翻译或语法分析。
• “重新分析”仍会明确绕过已有结果，用于需要重新生成内容的场景。
• 避免相同内容和阅读类型在历史列表中产生重复记录；已有重复项会在后续保存匹配结果时合并。

Markdown、LaTeX 与学术内容

• 支持翻译包含 Markdown 标题、列表、引用、强调、链接、行内代码和代码块的自然语言内容。
• 支持包含 $...$、\(...\) 和 \[...\] 等 LaTeX 公式的文本，包括温度、上下标和论文引用等常见写法。
• 翻译时会保留 Markdown 结构、LaTeX 公式、URL、代码片段和 HTML 标签，只翻译其中的自然语言。
• 改善 URL 后跟正文等混合内容的识别，同时继续阻止将独立源代码误当作普通文本翻译。

从 1.2.0 升级

1.2.0 用户可以通过菜单栏中的“检查更新...”升级。现有设置、AI API Key、Activation Token 和已保存的阅读历史不会被删除。

系统要求

• macOS 13 或更高版本。
• 配备 Apple 芯片的 Mac；不支持 Intel Mac。

获取帮助

• QQ 群：1075924792
• 邮箱：support@grasses.brainbeats.pro
• 网站：grasses.brainbeats.pro
• 问题反馈：GitHub Issues

请勿在公开反馈中提交 API Key、完整激活码、Activation Token 或包含隐私信息的阅读内容和截图。

Grasses 1.2.0

Grasses 1.2.0

本次更新加入本机 Pro 体验和可选的本机阅读历史，并完善首次使用流程、历史数据可靠性与结果面板布局。

Pro 体验

• 每台 Mac 可体验 20 次 Pro 深度阅读，成功使用图片 OCR、句子语法分析或段落逐句分析时才会扣除次数。
• 单词与短语分析、失败或取消的请求、查看缓存结果、模式控件和语法颜色不会消耗体验次数。
• 体验状态只保存在当前 Mac 的 macOS 钥匙串中，不上传到 Brain Beats、License 服务或 AI Provider。
• 体验次数是 Grasses Pro 功能使用次数，不是 AI Token；AI 请求仍使用你自己配置的 API Key。

阅读历史

• 阅读历史默认关闭。首次得到完整结果后，Grasses 会明确询问是否在本机保存历史。
• 开启后只保存原文和已完成的展示结果；截图、API Key、Provider 配置、流式中间状态和错误不会写入历史。
• 查看缓存历史不会联系 AI Provider，也不会消耗 Pro 体验次数。
• 最多自动保留 500 条非收藏记录；收藏记录不会自动清理。关闭历史只停止新增记录，不会删除已有内容。
• 支持搜索、筛选、收藏、复制、重新分析、删除单条结果以及删除全部历史。

可靠性与体验

• 首次使用流程现在可以随时跳过，跳过后不会在下次启动时再次出现。
• 修复排队写入可能在删除后重新创建阅读历史的问题。
• 无法读取损坏或来自未来版本的历史记录时，不再静默删除数据；现在可以重试或单独删除该记录。
• 修复阅读历史刷新、段落句子编号和小屏幕结果面板布局问题。
• 单词释义和例句翻译统一使用中文输出。

隐私

• 阅读内容只会直接发送给你配置的 AI Provider；Brain Beats 不通过中转服务器处理阅读内容。
• 图片 OCR 完全在 Mac 本地执行，截图不会加入阅读历史。
• API Key、Activation Token 和 Pro 体验状态保存在 macOS 钥匙串中。
• 阅读历史仅在你明确同意后保存在 ~/Library/Application Support/Grasses/History，可以随时在隐私设置中删除。

从 1.1.0 升级

1.1.0 用户可以通过菜单栏中的“检查更新...”升级。如果当前网络无法访问旧版使用的 GitHub 更新源，请从 GitHub Releases 手动下载并覆盖安装一次；1.2.0 起应用内更新改用 Grasses 官网更新源。现有设置、AI API Key、Activation Token 和已保存的阅读历史不会被删除。

系统要求

• macOS 13 或更高版本。
• 配备 Apple 芯片的 Mac；不支持 Intel Mac。

获取帮助

• QQ 群：1075924792
• 邮箱：support@grasses.brainbeats.pro
• 网站：grasses.brainbeats.pro
• 问题反馈：GitHub Issues

请勿在公开反馈中提交 API Key、完整激活码、Activation Token 或包含隐私信息的阅读内容和截图。

Grasses 1.1.0

Grasses 1.1.0

本次更新升级了 Grasses Pro 的激活机制，为激活码增加设备名额和本机绑定，在保留永久授权与离线使用体验的同时，降低激活码被传播和滥用的风险。

激活与授权

• 每个 GRS1 激活码最多可激活两台 Mac。
• 同一台 Mac 可以重复激活；抹盘并重新安装 macOS 后，只要硬件身份未变化，就不会占用新的设备名额。
• Activation Token 与当前 Mac 绑定。Grasses 每次启动时都会在本机重新验证 Token，不能将 Token 复制到其他设备使用。
• 首次激活仍需要连接 License 服务；激活成功后可继续离线使用 Grasses Pro。
• 一次购买仍会永久解锁当前及未来版本的 Grasses Pro，不会变为订阅。

从 1.0.0 升级

1.0.0 使用旧版激活机制，需要从 GitHub Release 手动下载并覆盖安装 1.1.0。本次升级不会通过应用内更新自动安装。

启动 1.1.0 后，旧版 Activation Token 会显示为无效。请在“设置 -> 通用 -> License”中重新输入原来的完整 GRS1 激活码。重新激活成功后，当前 Mac 将登记为一个设备名额；应用设置和已保存的 AI API Key 不受影响。

从 1.1.0 开始，Grasses 使用 MAJOR.MINOR.PATCH 三段版本号判断更新，后续版本可以继续通过应用内“检查更新...”获取。

隐私

• Grasses 不读取或收集 Apple ID、Grasses 账号、邮箱或邮箱验证码。
• 激活时只上传由 Mac 硬件标识在本机派生的应用范围哈希设备指纹，不上传原始硬件标识。
• License 服务为每个激活码最多保存两个设备指纹，以及对应的首次和最近激活时间。
• Activation Token 仍仅保存在本机 macOS 钥匙串中。

系统要求

• macOS 13 或更高版本。
• 配备 Apple 芯片的 Mac；不支持 Intel Mac。

获取帮助

• QQ 群：1075924792
• 邮箱：support@grasses.brainbeats.pro
• 网站：grasses.brainbeats.pro
• 问题反馈：GitHub Issues

请勿在公开反馈中提交 API Key、完整激活码、Activation Token 或包含隐私信息的阅读内容和截图。

Grasses 1.0.0

Grasses 1.0.0

Grasses 的首个公开版本现已发布。它是一款常驻 macOS 菜单栏的英文阅读助手，帮助你在当前应用中完成取词、翻译、语法分析和图片文字识别，无需反复切换窗口。

主要功能

• 通过全局快捷键读取其他应用中选中的文本或剪贴板文本。
• 自动区分单词、短语、句子和段落，并呈现适合当前内容的分析结果。
• 提供单词原形、音标、常见词形、词性、释义、例句和系统发音。
• 为句子和段落提供翻译，并支持重新分析与复制结果。
• 支持 SiliconFlow、DeepSeek、智谱、Kimi、Mimo 和通义千问等 AI 服务。
• API Key 安全存储在 macOS 钥匙串中，可在菜单栏快速切换已经配置的 AI 服务。
• 支持自定义全局快捷键、界面外观、启动设置和语法颜色。
• 内置 Sparkle 更新功能，后续版本可以在应用内检查更新。

免费版与 Grasses Pro

免费版包括：

• 选中文本和剪贴板文本阅读。
• 单词与短语的 AI 分析和系统发音。
• 句子与段落翻译。
• AI 服务配置、复制结果、重新分析和基础应用设置。

Grasses Pro 额外解锁：

• 读取剪贴板图片或屏幕选区，并使用 macOS Vision 在本地识别文字。
• 句子语法分析，以及主语、谓语、宾语、补语和修饰语等成分着色。
• 段落逐句深入分析。
• 手动切换阅读模式。
• 自定义语法成分颜色。

购买 Grasses Pro

购买后，在“设置 → 通用 → License”中粘贴完整的 GRS1 激活码即可完成激活。激活不需要注册 Grasses 账号，也不需要邮箱或邮箱验证码。一次购买可永久解锁当前及未来版本的 Grasses Pro。

系统要求

• macOS 13 或更高版本。
• 配备 Apple 芯片的 Mac；不支持 Intel Mac。
• 使用 AI 分析和翻译功能时，需要自行准备受支持服务的 API Key。Grasses Pro 不包含第三方 AI 服务费用。
• “读取所选文本”需要辅助功能权限；“读取图片”需要屏幕录制权限。Grasses 只在你主动执行相应操作时使用这些权限。

隐私

• 图片文字识别完全在 Mac 本地完成。
• 只有你选择分析的文字会直接发送给你配置的 AI 服务，Grasses 不通过中转服务器处理阅读内容。
• API Key 和签名后的 Activation Token 保存在 macOS 钥匙串中。
• Grasses 不创建阅读历史或图片历史。

获取帮助

• QQ 群：1075924792
• 邮箱：support@grasses.brainbeats.pro
• 网站：grasses.brainbeats.pro
• 问题反馈：GitHub Issues

请勿在公开反馈中提交 API Key、完整激活码、Activation Token 或包含隐私信息的阅读内容和截图。