先安装插件
首次启动进入「应用中心 → 插件市场」，从官方市场安装「译文」或「随手记」。应用不再内置插件；随手记无需配置模型。
配置模型
打开侧栏最下方的「设置」，进入「模型服务」。可以选择 API Key / Token 预设、自定义 OpenAI-compatible 服务，或点击 Continue with ChatGPT 在系统浏览器授权。
授权后还需要从该账号的可用目录选择模型并添加到宿主列表。麻辣烫不内置免费的模拟模型，实际调用由你的模型服务或订阅提供，费用与额度以该服务为准。
细节见 模型与账号。
完成一次翻译
- 安装成功后打开侧栏的「译文」。
- 选择已配置模型，填写原文与目标语言。
- 开始翻译，查看流式结果；需要时取消任务。
- 从历史中查看已保存的结果。
模型为空或账号失效时先回设置处理。切换模型配置会同步到插件；删除最后一个模型后，生成入口会停用。
体验随手记
进入「应用中心 → 插件市场」，安装官方「随手记」。插件使用宿主 KV 保存笔记，不需要模型。
安装后点击打开，写下笔记并保存，再切换页面或重启检查持久化效果。插件卸载会保留 KV 与历史，重新安装相同 ID 的插件可以继续读取。
外观与页面状态
在「设置 → 外观」选择浅色、深色或跟随系统。偏好保存在本机，插件与原生标题栏共同切换。
0.4.2 起移除侧栏外观快捷按钮，统一在设置页切换主题。
0.4.1 提供默认、GitHub 和自定义配色。分别调整浅色 / 深色的强调色、背景与前景，即时预览后点击「保存配色」；取消或离开设置恢复已保存配色，「恢复默认」也需保存。文字对比度不足时提示调整。原生标题栏只跟随明暗模式，插件和弹出层继承内容区配色。
插件是否保留切页草稿由它的 keepAlive 声明决定。译文和新版随手记已开启，但刷新、退出和更新仍会销毁页面内存；需长期保留的数据必须主动保存。
将窗口置顶（0.4.0 起）
点击标题栏浏览器入口左侧的置顶图标，让当前原生窗口保持在普通窗口上方。选中时图标填充高亮、提示改为“取消置顶”；再次点击恢复。
置顶按窗口独立生效，隐藏后再打开、后端重连会保留；关闭并销毁窗口或退出应用后重置。它不控制浏览器窗口，也不让窗口跨桌面显示。旧版需先通过完整 DMG 升级。
在浏览器使用（0.3.0 起）
0.3.0 的标题栏最右侧新增“在浏览器中打开”。点击后可在本机浏览器中使用完整插件界面，同时保留原生窗口。模型、插件、KV 和主题共用同一后端；未保存的表单与草稿不会复制。
刷新可继续使用当前授权；重启或更新应用后需重新点击标题栏。应用菜单和托盘菜单可“断开浏览器连接”，立即撤销当前实例所有浏览器会话。地址与端口本身不授予 API 访问权限。
浏览器可使用原生文件选择、剪贴板和更新界面；直接访问钥匙串、屏幕捕获等高权限能力仍被拒绝。从旧版升级须使用完整 DMG；见安装与版本边界。
下一步
插件安装管理 说明不同来源与数据保留规则；常见问题 帮助处理登录、网络与安装失败。
从旧版升级到 0.4.1
0.4.1 统一公共组件和明暗主题，保留图标侧栏；设置采用分组布局，模型选择支持搜索，应用中心采用紧凑列表与卸载确认。旧 SDK 0.2 及更早插件需更新到 SDK 0.3 后重新构建安装，KV 和历史保留，见插件指南。
凭证改为明文文件，不迁移旧 ChatGPT 钥匙串登录。升级后重新登录、删除旧的未连接订阅模型，再从新账号目录添加，普通 API Key 和历史保留。原生运行时改变，需要完整 DMG；见安装说明。
升级到 0.4.3
项目已迁入 semicoder-dev 组织，应用更新源与默认官方插件源同步切换。旧版使用完整 DMG 安装新版；已有市场来源需按安装页手动替换，不自动迁移旧地址。
从 0.4.1 或更早版本升级
升级前在旧版卸载手动安装的插件，再用完整 DMG 替换应用。新宿主不迁移旧安装记录，保留模型、凭证、KV 和历史；翻译和随手记从市场重新安装。详情见升级说明。