Changelog

SpotAsk 的所有重要变更都记录在本文件中。

本文件的格式基于 Keep a Changelog， 并且本项目遵循 语义化版本 规范。

Unreleased

0.3.4 - 2026-11-04

划词提示词独立悬浮窗口、提问窗口磨砂玻璃背景、外观与服务渠道设置体验优化

新增

• 设置 > 外观 > 背景可在现在的不透明底色和磨砂之间切换提问窗口。磨砂会透出后面的桌面；输入框和消息气泡仍是实色，切换后立即生效。
• 划词提示词左键打开独立悬浮窗口，右键仍在主窗口对话中提问。悬浮窗口支持置顶、复制，以及追加到当前对话。窗口在前台时，复制、重试、置顶、缩放和设置沿用主窗口的同一套快捷键。
• 划词助手设置可以把提示词的左右键对调。默认仍是左键打开悬浮窗口，右键在主窗口提问。

变更

• 划词提示词悬浮窗口改用系统磨砂玻璃，不再使用实心卡片底，并且可以拖动边缘调整大小。
• 悬浮窗口顶部的模型名可以点开模型菜单，并用所选模型重新回答。模型名居中，左侧显示应用图标，和主窗口一致。
• 划词提示词悬浮窗口保留圆角细描边，和主窗口一样，不再露出方形角。
• 在悬浮窗口里切换模型不再把窗口关掉。

修复

• 主窗口的实心底色会跟随应用主题。切换浅色和深色时窗口立即重绘，不再停留在上一次主题的底色上。
• 主窗口提问失败后，再把悬浮窗口的回答追加到对话，重试不会再发不出去。已导入的问答会保留；导入之后原请求才失败，也不会把这次导入当成失败重试的对象。
• 设置 > 外观页面在内容超出窗口高度时支持滚动浏览。
• 设置 > 服务渠道在切换多个服务渠道时正确载入当前渠道的配置草稿，避免不同渠道互相干扰。

0.3.3 - 2026-10-28

全新数学公式渲染、自定义阅读字体、OpenAI Decisions 决策路由

新增

• 设置 > 外观 > 阅读支持选择本机安装的字体作为阅读字体，下拉列表提供实时搜索与字形预览。
• 设置 > 外部提问决策路由新增支持 OpenAI Decisions 引擎，可独立配置地址、模型与密钥。

变更

• 重构数学公式渲染流水线：行内公式紧凑混排，块级公式居中展示并支持窄窗平滑横向滚动，右上角新增一键复制 LaTeX 按钮（可选带 $$ 分隔符）。
• 服务渠道的默认模型与占位提示对齐最新旗舰版本（如 OpenAI gpt-6-luna、Anthropic claude-sonnet-5-5 等）。

修复

• 清空全部本地数据仅清除当前应用的偏好与数据，避免影响其他安装版本的配置。

0.3.2 - 2026-10-21

修复旧配置迁移与数学公式显示

修复

• 包含 \boldsymbol 的数学公式现在正确渲染为粗斜体，不再整段消失；无法解析的公式会回退显示原始 LaTeX，畸形公式也不再导致应用崩溃。
• 沙盒数据迁移现在先于任何设置加载执行，待迁移的旧服务商目录不会再被合成的默认目录抢先覆盖而跳过。目录以意外类型存储时会被报告并保留，不再被静默覆盖；旧偏好文件无法读取时迁移将失败，不记录完成标记，也不丢弃仍待迁移的目录。

0.3.1 - 2026-10-19

服务商生效模型概览与快速模板、全新快捷键搜索与冲突检测、划词助手实时预览操作台与二级折叠、三卡片主题选择器

新增

• 设置 > 服务顶部新增生效模型概览卡片，直观呈现当前默认模型、所属服务商与连接状态徽标，并提供主流服务商一键快速配置模板与独立模型管理弹窗。
• 设置 > 快捷键迎来全新重构，支持输入动作与按键实时搜索过滤、拟物化键盘键帽显示、按心智模型分类分组，以及应用内和系统快捷键冲突实时内联告警。
• 设置 > 划词助手新增 1:1 可交互实时预览操作台卡片，支持直接拖拽动作按钮重排序，并可将低频动作收纳至二级折叠菜单（“更多”下拉菜单）中，保持悬浮操作条轻巧利落。
• 设置 > 外部提问在“添加渠道”下拉菜单中提供主流 AI 服务预设模板库（ChatGPT、Claude、Perplexity、DeepSeek、Kimi、Google、Grok、GitHub）一键添加，并将智能路由重构为自上而下的顺序语法规则卡片与显式应用内兜底卡片。
• 设置 > 外观采用跟随系统、浅色、深色 3 张直观卡片式主题选择器，设置 > 通用将数据重置等敏感操作移入专属“危险区域”，配备两阶段确认防误触机制。
• 内置提示词与自定义提示词实现统一管理与排序交互，并新增“恢复默认预设”功能，可随时重置或找回被修改的初始系统预设。

变更

• 智能路由规则、外部提问渠道与提示词列表的上下移动排序按钮调整为垂直堆叠，减少横向空间占用并保持更紧凑的操作手感。

修复

• 修复划词浮动条未正确接收自定义配置的问题，确保悬浮窗完整呈现用户在操作台中定制的一级动作与二级折叠动作。
• 消除设置项标签行与通用快捷键行中的投机性布局重复测算，并杜绝快捷键录制器的冗余视图重建，彻底消除设置页滚动卡顿与尺寸抖动。

0.3.0 - 2026-10-11

外部提问智能路由、内联确认与快速换渠道、长对话阅读体验优化

新增

• 设置 > 外部提问新增 智能路由，可在未手动指定目标时通过 System One 决策模型（默认预填 TypeSafe 官方地址与 jev-1.13.0，支持切换兼容服务）自动推荐提问去向。
• 输入框上方新增内联确认卡片，展示推荐去向与置信度，支持按 Return 直接发送、按 Tab 或方向键切换渠道、按 Esc 取消；开启高于置信度阈值自动发送时，「在 SpotAsk 内」直接作答，外部渠道提供 0.8 秒路由去向提示（期间可按 Return 立即发送或按 Esc 取消）。
• 每个外部提问渠道都可在「路由说明」中配置渠道用途、适用场景与「始终先确认」开关，设置页提供「测试路由」实时预览推荐去向、置信度、放行方式与判断用时。
• 主窗口标题栏新增当前对话自动路由开关（默认快捷键 ⌘⇧R），可按次临时暂停路由并在新建对话时自动恢复，支持在设置 > 外部提问中选择是否显示该按钮。

变更

• 内置外部提问渠道现支持与自定义渠道一致的编辑与删除操作，渠道编辑弹窗升级为双卡片布局并提供 20 个本地化图标选项。
• 「启用外部提问」独立为顶部开关卡片，应用内作答去向在路由设置与确认卡片中统一命名为「在 SpotAsk 内」。
• 智能路由设置组会打开外部提问指南的智能路由一节，该节也可以直接打开设置 > 外部提问。

修复

• 决策请求在转发正文前拦截跨 origin 重定向，除本机 loopback 调试外必须使用 HTTPS。
• 待执行路由结果绑定可撤销的发送快照，包含外部渠道的链接、URI 或命令模板；编辑、取消、附件或预设变化、切换对话及路由开关或渠道配置变化，不会用旧推荐发送新草稿或改后的目标。旧推荐静默失效，不弹出显性提示。
• 路由测试区分配置、HTTP、网络、超时和返回错误并只显示脱敏提示，前置条件失败不再显示误导用时；凭据读取失败时保留旧密钥优先标记，迁移写入失败时保留有效旧凭据，自定义空模型明确拒绝，候选 criteria 编码固定顺序。
• 回答流式生成过程中点击展开或收起完整问题、完整回答与深度思考区域时立即响应，无需等待生成结束。
• 多轮对话后上下滚动时，正在阅读的内容不再突然跳位。
• 通用 OpenAI 兼容模型与 DeepSeek 模型选择「关闭」思考时发送兼容网关的参数，避免被 New API 一类网关拒绝并确保思考真正停止。

0.2.7 - 2026-10-08

Gemini 服务、官方地址预填、模型发现更顺手

新增

• 新增 Gemini 接口格式，直接使用 Google Gemini 密钥即可，无需兼容网关。
• 新建服务会预填所选接口格式与类型的官方地址，可随时手动覆盖；文档同步提供各家 API Key 申请入口与接口文档链接。
• 模型发现弹窗改用 macOS 原生三态复选框，与各模型开关双向联动，部分勾选时显示混合状态。

0.2.6 - 2026-10-05

划词助手动作栏实时预览、更新提示更轻量

新增

• 设置 > 划词助手的动作栏支持实时预览，切换显示项即时看到 1:1 渲染效果；预览仅供查看，按钮不可点击。
• 已是最新版本时，检查更新改用轻量应用内提示，不再弹出系统弹窗。

修复

• 从输入框向外部应用提问成功后自动关闭面板（置顶模式同样生效），不再遮挡刚唤起的目标窗口。
• 清空本地数据时会一并清除历史会话缓存；导入备份失败时原子回滚，避免残留半份配置。

0.2.5 - 2026-09-20

设置页直达链接、设置分组指南、文档站流程图

新增

• 支持通过 spotask://settings/<page> 直达指定设置页，未知页面回退到设置窗口。
• 包含较多配置的设置分组提供对应指南链接，跟随界面语言打开中英文页面。
• 文档站为地址类型与划词助手绘制了主题自适应流程图，并提供「在 SpotAsk 中打开设置」直达按钮。
• 回答上的「换个模型重试」支持选择已启用的外部提问目标，带上原问题在对应平台中打开；当前对话、会话模型与草稿保持不变。
• 划词助手新增可选（默认关闭）的剪贴板辅助划词，仅对你指定的应用生效，动作完成后立即恢复原剪贴板。

变更

• 标题栏模型选择器改为居中显示，生成中的加载动画保持与选择器归组。
• 标题栏快捷选择器恢复为只列出模型，外部提问目标移至「换个模型重试」入口。
• 将选中文字加入对话时为每行添加 Markdown > 引用前缀，划词动作图标改为引用气泡。
• 文档站首页流程图改渲染在 Hero 按钮与特性卡片之间（中英文一致）。
• 文档站首页 Hero 仅保留 SpotAsk 字样，去掉 Docs / 文档 次级标题。

修复

• 「打开文档」链接不再被设置窗口滚动条遮挡，在所有设置页对齐一致。
• 运行测试套件不再覆盖你的 macOS 剪贴板。

0.2.4 - 2026-09-16

应用内自动更新、多下载源配置、输入框 @ 筛选

新增

• 检查更新支持直接在应用内下载并安装，可在更新提示中跳过版本，并在「关于」中恢复提醒。
• 支持在「设置 > 关于 > 更新」中配置更新下载源（自动、官方 GitHub、国内加速源），具备自动超时检测与镜像回退。
• 在输入框中键入 @ 可筛选提示词预设与外部提问目标，选择提示词保留草稿，已有内容选择外部提问立即触发。
• 划词动作栏新增专属对话图标，可一键将选中文字填入提问输入框用于追问，可在设置中单独开关。
• 已有对话中的预设弹出菜单一并列出外部提问目标并向上弹出，快捷键挂载待发送标签在发送时触发。

变更

• 选中的提示词或外部提问标签移至输入框左上方并自适应宽度，移除了多余的底部行与残留空白。
• 输入框为空时外部提问按钮与快捷键改为选中待发送目标，再次点击、按 Esc 或清空输入即可取消。

修复

• 输入框已有内容时，按下外部提问快捷键或从菜单点选会立即发送，不再需要额外按一次 Return。

0.2.3 - 2026-09-11

设置侧边栏重构、紧凑视觉体验、全局快捷键可清除

变更

• 设置改用紧凑的分组侧边栏，支持中英双语内容搜索与键盘导航，跳转仅定位可见控件。
• 设置界面全面优化视觉体验：间距更紧凑、图标采用渐变底色，页面与服务卡片排版更规整。

修复

• 全局快捷键可在设置中直接清除，不再强制占用系统热键，已有快捷键正常保留。

0.2.2 - 2026-09-10

思考过程计时性能优化、本地化目录扫描修复

修复

• 已结束并收起的思考过程不再持续刷新耗时计时器，降低后台资源消耗。
• 修复思考过程标题刷新时重复扫描本地化语言目录的问题。

0.2.1 - 2026-09-08

划词外部提问、URL Scheme 支持、Homebrew Cask 分发

新增

• 划词动作栏支持展示外部提问目标，提供独立显示开关，动作栏最多容纳八个动作。
• 支持通过 spotask:// URL Scheme 从 Alfred、Raycast、快捷指令或终端唤起与交互。
• 新增 Homebrew Cask 分发方式，支持通过 brew install --cask spotask 安装与更新。

变更

• 全新安装应用时，「问 Grok」快捷操作默认改为关闭。

修复

• 触发外部提问快捷操作后，输入框文字会被正确清空。
• 键盘导航与提交时保留正在拼写的输入法候选词与多行文本。
• 关闭「窗口置顶」后，提问窗口在切换 Space 桌面时不再跳到前台。
• 设置中的开关标签使用整行宽度，较长的文案不再被截断。
• 划词助手设置页在控件超出窗口高度时支持正常滚动。
• 带文字标签的划词动作栏长标题自动截断在 400pt 面板内，完整名称仍可在提示气泡中查看。
• 选区清空、读取失败或关闭划词助手时，动作栏同步消失并释放选区快照。

0.2.0 - 2026-08-19

外部提问体系、自定义外部目标与命令、配置备份升级

新增

• 外部提问：支持在快速提问窗口中将问题一键发送至 ChatGPT、Grok 等外部目标并自动唤起。
• 支持添加自定义外部提问目标：配置网页链接、应用 Scheme 或终端命令（如 omp {query}），自由定制图标与排序。
• 设置中提供外部提问总开关，默认保持开启。
• 外部提问目标与自定义提示词预设全面支持品牌图标展示。
• 配置备份现已包含外部提问目标，并保持与旧版备份的双向兼容。

修复

• 本地重新安装应用后，划词助手会及时提示重新授予辅助功能权限以恢复选区读取。
• 快速提问窗口在长时间无操作后会自动开启新对话，避免旧上下文干扰。

0.1.6 - 2026-08-12

按模型配置思考等级、启动自动检查更新、兼容性自动推断

新增

• 支持按模型配置思考等级（关闭或指定等级），并支持服务商专属请求兼容类型与自定义 JSON 参数。
• 启动时可选自动检查更新，发现新版本时在应用内轻量提醒并支持打开发布页。
• 兼容性配置会根据服务与模型名称智能推断，同时保留手动配置。

修复

• 修复 Markdown 文本选区状态下代码块复制按钮偶尔无法点击的问题。

0.1.5 - 2026-08-11

服务品牌图标、气泡对话布局、公式渲染与多行复制优化

新增

• 模型选择器、对话标题栏与设置中为受支持的服务显示精美品牌图标。
• 新增可选的 IM 气泡对话布局（模型居左、用户居右），可在「外观」设置中开启。
• 支持在回答标题栏切换其他模型并直接重新生成当前回答。
• 复制消息选中内容时完整保留标题、列表、引用、代码块与表格的 Markdown 语法。
• 回答支持渲染 LaTeX 数学公式，可在「外观」设置中按需开关。
• 新增中英双语在线使用文档，可直接从「设置 > 关于」中点击查阅。

变更

• 划词助手自动触发会自动跳过空选区与仅含空白字符的文本。
• 已生成的回答中代码块改为自动换行，拖拽文本选择可顺畅穿过代码区域。

修复

• 消息文本现已支持平滑跨多行连续选择与复制。
• 跨越多个 Markdown 块选中文本时高亮背景保持连续，不再显示为割裂片段。
• 焦点移出窗口后，可随时按下 ⌘+L 快速重新聚焦至输入框。
• 设置侧边栏项目获取焦点时支持使用上下方向键顺畅切换各功能页。
• 优化长思考内容生成时的渲染性能，展开思考过程更加丝滑。
• 普通鼠标点击或已取消的文本选区不再意外唤起划词助手。

0.1.4 - 2026-08-07

首个公开版本：快速提问、划词助手、多模型接入与思考过程展示

新增

• 快速切换模型：标题栏可为当前对话直接选择任意服务的模型，新对话自动恢复默认模型。
• 临时附件：支持粘贴截图、拖入图片或文本代码文件，图片作为视觉输入，文本作为上下文附加。
• 附件上下文跟随对话：后续追问与重新生成均保留此前的截图与文件附件。
• 模型选择器支持实时搜索、按服务分组、键盘导航与「使用默认模型」快捷项。
• 跨应用划词助手：在任意 macOS 应用中选中文字即可一键翻译、解释、总结、润色或运行自定义提示词。
• 选中文字旁显示快捷操作栏，默认附带清晰的文字标签。
• 划词助手支持一键直接执行模式与自动触发检测。
• 划词自动触发支持应用黑白名单过滤，并提供可搜索的应用选择器。
• 支持接入 Anthropic 原生 API 与模型列表发现，与 OpenAI 兼容服务并列。
• 支持 HTTP 与 SOCKS5 网络代理，支持填入认证凭据并提供连通性测试。
• 支持自定义唤起快速提问窗口的全局快捷键。
• 完整展示模型深度思考过程与耗时统计，支持配置默认展开。
• 每条回答底部提供便捷操作栏，支持一键复制与换模型重新生成。
• 界面语言支持 English、简体中文、Español、Deutsch、日本語、Français、Português、Русский 8 种语言。
• 支持完整应用配置导入导出与诊断日志导出，配合轻量应用内提示条反馈结果。

变更

• 「总结」划词快捷操作改用辨识度更高的专属图标。
• 关闭划词助手时自动折叠相关配置项，仅在开启功能时按需申请辅助功能权限。
• 对话角色采用直观图标标注，助手显示模型名称，用户消息显示「你」。
• 流式回答更新仅作用于当前活跃消息，不再全量重绘整个对话列表。
• 对话仅保留活跃部分即时渲染，更早的历史消息按需延迟加载提升性能。
• 流式回答以增量 Markdown 块渲染，生成完毕后封存尾部而无需重构整个渲染树。
• 优化窗口滚动更新逻辑，用户主动滚动时禁用尺寸变化锚定以防视角跳动。

修复

• 流式回答在生成中保持段落、软换行、列表与代码块格式的完整性。
• 在当前窗口流式生成的长回答在完成后保持展开状态，后续追加提问不会被异常折叠。
• 对话与思考过程的高频滚动指令合并处理，消除逐 token 滚动造成的卡顿。
• 输入框达到最大高度后跳过不必要的文本测量，降低输入延迟。
• 修复部分系统构建下划词助手读取选区失效的问题，授予辅助功能权限后稳定读取。
• 修复使用文本标记进行的选择区域无法被划词助手正确解析的缺陷。
• 关闭提问窗口后可靠保留输入草稿，同时恢复面板淡入淡出动效。
• 修复深色模式下应用图标偶发出现白色边缘的问题。
• 服务配置卡片支持稳定平滑地展开与收起。
• 修正思考过程展开行为：开启时思考中展开并在输出最终回答时收起，关闭时始终折叠。