# 更新日志 / Changelog

本文档记录 **Grok Desktop** 各版本用户可见的改动。  
安装包见：[Releases](https://github.com/xiaokaige1130-maker/grok-desktop/releases)

> 平台：Windows x64 · macOS x64（DMG / ZIP）· Linux x64（deb）  
> 后端：本机官方 `grok` CLI（ACP），非网页套壳

---

## [未发布 / next]

| 改动 | 说明 |
|---

## [0.8.11] — 2026-07-24

**主题：三工作模式 · 记忆管理 · 消息复制/转发/记忆 · macOS 托盘图标**

| 改动 | 说明 |
|------|------|
| **任务 / 计划 / 目标** | 输入区工作模式：任务直接执行；计划先方案再动手；目标跨轮推进 |
| **记忆管理** | 常用/经验记忆的查看、编辑、分类、筛选、删除与上下文开关 |
| **消息三按钮** | 复制全文 · 转发为新任务分支 · 收入记忆 |
| **macOS 托盘** | 菜单栏改用 Template 透明线稿，去掉黑底大块图标 |

Release：https://github.com/xiaokaige1130-maker/grok-desktop/releases/tag/v0.8.11

---

---|------|
| **可靠性** | Finder / Dock 启动时统一命令 PATH；隐藏不可恢复的内部子代理会话；更新检查 10 秒超时 |

---

## [0.8.9] — 2026-07-24

**主题：记忆管理 · 消息复制全文**

| 改动 | 说明 |
|------|------|
| **记忆管理** | 常用记忆与经验记忆支持查看、新增、编辑、分类、筛选和删除，并可控制是否参与助手上下文 |
| **复制全文** | 每条用户与助手消息气泡新增复制按钮；长消息折叠时仍复制完整原文 |
| **新任务分支** | 消息气泡新增分享图标，可带最近上下文创建独立任务并继续运行，原任务不受影响 |
| **双语界面** | 记忆管理和消息复制操作补齐中英文文案 |

---

## [0.8.8] — 2026-07-22

**主题：Bootstrap UI · 全局浮层 · 官方 CLI 三工作模式（任务 / 计划 / 目标）**

### UI 组件与弹出层

| 改动 | 说明 |
|------|------|
| **Bootstrap 5.3** | 引入 `bootstrap` 依赖；CSS/JS 接入 renderer；打包包含 `node_modules/bootstrap/dist` |
| **计划抽屉** | 执行计划改为 Bootstrap **Offcanvas**（遮罩 / Esc / 关闭）；`scroll:true` 不锁 body；z-index 置顶 |
| **全局滚动条** | 主题化细滚动条覆盖会话列表、对话流、设置、代码块等全部区域 |
| **浮层不占布局** | 斜杠菜单、搜索结果、模型/强度下拉、Goal 条改为绝对/固定浮层，打开时不挤主布局 |

### 工作模式（对齐官方 Grok CLI）

| 模式 | 说明 |
|------|------|
| **任务 (Normal)** | 默认：直接执行与改代码 |
| **计划 (Plan)** | `/plan`：先方案（plan.md）再动手；打开计划抽屉 |
| **目标 (/goal)** | 跨轮目标；输入框**无需**手写 `/goal`，发送时底层自动包装；气泡显示用户原文 |

Composer：附加文件 `@` → 圆形 **`+`**；模式芯片在左侧（任务灰 / 计划琥珀 / 目标紫）。

### 安装包

| 文件 | 平台 |
|------|------|
| `Grok-Desktop-0.8.8-Windows-Portable-x64.exe` | Windows 绿色版 |
| `Grok-Desktop-0.8.8-Windows-Setup-x64.exe` | Windows 安装版 |

### 说明

- 仍依赖本机官方 **Grok CLI**。
- 本版以 Windows 打包为主；macOS / Linux 共用代码。

---

## [0.8.7] — 2026-07-21

**主题：Windows 原生桌面体验 · 托盘/通知/窗口记忆 · 顶栏工具栏统一**

Release：https://github.com/xiaokaige1130-maker/grok-desktop/releases/tag/v0.8.7

### Windows 桌面壳

| 改动 | 说明 |
|------|------|
| **系统托盘** | 常驻托盘；右键：显示窗口 / 新建会话 / 设置 / 退出；tooltip 显示运行中数量 |
| **关闭 → 托盘** | 点 × 默认不退出（Win/Linux）；托盘退出、菜单退出或 **Ctrl+Q** 才真正退出 |
| **首次托盘提示** | 第一次藏到托盘时系统通知 + 应用内 toast，避免误以为闪退 |
| **最小化到托盘** | 设置可选（需先开启关闭到托盘） |
| **开机自启** | 设置可选，同步 OS login item |
| **完成后通知** | 窗口失焦 / 托盘 / 后台会话都会通知；**点击通知回到对应会话** |
| **任务栏** | 运行中不确定进度条；后台完成时闪烁任务栏 |
| **窗口记忆** | 记住大小、位置、最大化状态 |
| **应用菜单** | 文件 / 编辑 / 查看 / 帮助（新建、设置、检查更新、打开 Releases） |
| **快捷键** | `Ctrl+N` 新建 · `Ctrl+,` 设置 · `Ctrl+P` 计划 · `Ctrl+W` 关标签 · `Ctrl+Tab` 切换 · `Ctrl+1…9` · `Ctrl+Q` 退出 |
| **单实例** | 再次启动会唤起已有窗口 |
| **深色系统主题** | `nativeTheme` 与应用内深色 UI 更一致 |

### 顶栏 UI

| 改动 | 说明 |
|------|------|
| **统一工具栏** | **计划 · 导出 · 重命名 · 删除** 同一高度/圆角/图标/hover |
| **去掉重复计划** | 状态条上的第二个「计划」已删除，只保留右上角 |
| **计划状态** | 打开时高亮；有条目时显示数字角标 |

### 安装包

| 文件 | 平台 |
|------|------|
| `Grok-Desktop-0.8.7-Windows-Portable-x64.exe` | Windows 绿色版 |
| `Grok-Desktop-0.8.7-Windows-Setup-x64.exe` | Windows 安装版（`npm run dist:win:setup`） |

### 说明

- 仍依赖本机官方 **Grok CLI** 登录与额度。
- 未签名构建可能被 SmartScreen 拦截（社区包常见）。
- macOS / Linux 共用代码；本版以 Windows 体验为主，**macOS 0.8.5 能力保留**（hiddenInset、Dock PATH、打包脚本）。

---

## [0.8.6] — 2026-07-22

**主题：可发布产品打磨 — 顶栏 · i18n · 斜杠 · 输入区去堆叠**

| 改动 | 说明 |
|------|------|
| **输入区去堆叠** | 去掉「正在干什么」activity 条；工作模式改为推理强度旁小钮，点击弹出目标/任务/计划三选一 |
| **顶栏会话操作** | 计划 / 导出 / 重命名 / 删除 + 状态归入同一 `session-toolbar`；统一 `sa-btn` |
| **设置与二级页 i18n** | 记忆 / Skills / 插件页与设置子面板文案走 zh/en |
| **斜杠菜单** | 分组 + 桌面/Skill 徽章；纯 UI 路由不发假 agent 提示 |
| **斜杠 IPC** | activate/open（含 soft）经 `commandsForRenderer` |
| **会话时间 / 时长** | Mac 风格时间；运行中计时 |
| **macOS 观感** | 系统字体、侧栏毛玻璃 |
| **自动化** | Skills / Goal / Loop / Hooks 导览与状态条 |
| **粘性滚动** | 对话流默认贴底 |
| **环境健康 / 工具输出** | 设置环境页；工具卡折叠预览 |
| **校验** | `npm run check:ui` + `npm run smoke` |

---

## [0.8.5] — 2026-07-21

**主题：macOS 支持 · 窗口拖拽 · Dock 启动 PATH · 系统菜单**

Release：https://github.com/xiaokaige1130-maker/grok-desktop/releases/tag/v0.8.5

### macOS

| 改动 | 说明 |
|------|------|
| **打包** | `npm run dist:mac` → DMG + ZIP（x64） |
| **标题栏** | `hiddenInset` + 红绿灯位置；顶部拖拽条 / 品牌区 / 顶栏可拖窗口 |
| **系统菜单** | 应用菜单含编辑（Cmd+C/V/A/Z）、查看、窗口 |
| **Dock** | 点击 Dock 图标恢复/前置窗口；About 面板版本号 |
| **CLI 查找** | GUI 从 Dock 启动时 PATH 很短；探测 `~/.grok/bin/grok`、`~/.local/bin`、Homebrew，并给子进程补全 PATH |

### 其它

- `preload` 暴露 `platform`，界面按 `platform-darwin` 适配边距与 ⌘ 快捷键展示  
- 侧栏品牌图标略缩小，适配红绿灯留白  
- 安装包：`Grok-Desktop-0.8.5-macOS-x64.dmg` / `.zip`

---


## [0.8.4] — 2026-07-20

**主题：会话管理做强 · 右键菜单 · 本地归档/置顶 · Skills/插件设置去重**

Release：https://github.com/xiaokaige1130-maker/grok-desktop/releases/tag/v0.8.4

### 会话右键菜单（侧栏「最近会话」上右键）

| 菜单项 | 说明 |
|--------|------|
| **打开** | 进入该会话 |
| **置顶 / 取消置顶** | 会话出现在侧栏顶部「📌 置顶」分组 |
| **重命名** | 修改会话标题 |
| **导出 Markdown** | 调用官方 `grok export`，弹出另存为 |
| **复制会话 ID** | 复制完整会话 UUID（方便反馈、排查） |
| **复制标题** | 复制当前标题文案 |
| **复制工作目录** | 复制会话关联的 cwd（无目录时禁用） |
| **在文件夹中显示** | 用系统文件管理器打开该会话在 `~/.grok/sessions/` 下的目录 |
| **归档 / 取消归档** | **仅桌面端分组**，不删除 CLI 会话数据；归档出现在底部「📦 归档」 |
| **删除** | 确认后删除会话（并清理本地置顶/归档记录） |

### 侧栏分组

- **置顶** 分组：已置顶会话  
- **按项目** 分组：原有逻辑（工作目录）  
- **归档** 分组：默认折叠；展开状态会记住  

### 设置 · Skills / 插件

- 设置内改为 **摘要列表 +「打开 Skills / 插件 →」**，完整管理放在侧栏独立页  
- 减少设置页与侧栏功能重复  
- Skills 摘要最多展示部分条目，并提示去侧栏看全部  
- 插件仍支持在设置里 **快速安装**（名称 / owner/repo / git URL）

### 安装包

| 文件 | 平台 |
|------|------|
| `Grok-Desktop-0.8.4-Windows-Setup-x64.exe` | Windows 安装版 |
| `Grok-Desktop-0.8.4-Windows-Portable-x64.exe` | Windows 绿色版 |
| `grok-desktop_0.8.4_amd64.deb` | Linux deb |

### 说明

- **归档不是官方 CLI 命令**：数据仍在 `~/.grok/`，只是桌面列表里挪到「归档」组。  
- 置顶 / 归档列表保存在本机桌面配置：`~/.config/linux-grok-desktop/settings.json`（Windows 对应用户配置目录下的 `linux-grok-desktop` / 应用配置）。

---

## [0.8.3] — 2026-07-20

**主题：对话气泡分色 · 用户与助手一眼可辨**

Release：https://github.com/xiaokaige1130-maker/grok-desktop/releases/tag/v0.8.3

### 对话布局

| 角色 | 样式 |
|------|------|
| **你（用户）** | 靠右 · 紫色系圆角气泡 |
| **助手** | 靠左 · 深色卡片气泡 |
| **换人说话** | 上下间距加大，避免糊成一片 |
| **排队消息** | 仍在右侧 · 琥珀色描边（与普通用户消息区分） |
| **思考过程** | 左侧细竖线样式，不与正文气泡混淆 |

- **没有**「你 / 我」文字标签（按产品选择不做）  
- 工具卡、权限卡、Diff 卡仍占满对话列宽  

### 安装包

- Windows Setup / Portable  
- Linux `grok-desktop_0.8.3_amd64.deb`

---

## [0.8.2] — 2026-07-17

**主题：关于页开发者信息 · 消息链接可点击**

Release：https://github.com/xiaokaige1130-maker/grok-desktop/releases/tag/v0.8.2

### 设置 → 环境（关于）

- **开发者卡片**  
  - 项目名：Grok Desktop  
  - GitHub：`@xiaokaige1130-maker`  
  - **反馈问题** → 仓库 Issues  
  - **项目仓库** → `xiaokaige1130-maker/grok-desktop`  
  - **版本发布** → Releases  
  - **赞助作者**：入口已预留，**默认隐藏**（开通 GitHub Sponsors 后再显示）  
- 感谢文案支持中英界面语言切换  

### 对话超链接

- 消息中的 `http://` / `https://` 自动识别为**可点击蓝色下划线链接**  
- 点击后用**系统默认浏览器**打开（不在 Electron 内嵌打开）  
- 流式输出结束后再链接化，避免流式过程卡顿  
- 历史消息加载同样支持  

### 安装包

- Windows Setup / Portable  
- Linux deb  

---

## [0.8.1] — 2026-07-17

**主题：Windows 工程与安装体验巩固（中间版本）**

- 笔记本侧 Windows 工作目录与打包链路完善  
- 与 0.8.0 功能对齐的 Windows 构建验证  

---

## [0.8.0] — 2026-07-17 前后

**主题：产品化设置 · 计划按钮 · 权限三档 · 中英 i18n**

### 计划面板

- 「计划」按钮移到**顶栏**（打开会话后始终可见，不再藏在状态条里）  
- 有计划时显示**数量角标**与 **done/total** 进度  
- 快捷键 **`P`** 打开/关闭计划面板  
- 计划面板加宽，条目状态更清晰  

### 权限 / 访问模式（设置 → 权限）

| 模式 | 含义 |
|------|------|
| **审批模式** | 写文件 / 跑命令前需确认 |
| **智能模式**（推荐） | 常规工具自动放行，高风险仍提示 |
| **完全访问** | 工具默认自动批准；可选 YOLO 更激进 |

- 状态条显示当前访问模式徽章  

### 中英界面

- 新增 `renderer/i18n.js`  
- **设置 → 常规 → 界面语言**：中文 / English，即时生效  

### 其它

- 设置页分区与快捷键说明整理  
- 多会话、Diff、搜索、壁纸、通知、更新检查等延续 0.7.x  

### 安装包

- 正式双端：Windows Setup/Portable + Linux deb/AppImage 目标  

---

## [0.7.0] — 更早

**主题：首次引导 · 完成后通知 · 检查更新**

| 能力 | 说明 |
|------|------|
| **首次环境引导** | 启动检测 CLI 是否安装、是否像已登录；可重新检测 / 进入应用 |
| **完成后通知** | 后台会话跑完系统通知（可关；当前会话不打扰） |
| **检查更新** | 启动时查 GitHub Release；有新版本顶栏提示；设置可关 / 手动检查 |
| **快捷键说明** | 设置 → 常规：Enter 排队、引导、N、Ctrl+Tab、`/` 等 |
| **环境诊断** | 设置 → 环境：CLI / 登录状态检测 |

---

## [0.6.x] 及更早（摘要）

- Electron 对接官方 `grok agent`（ACP）  
- 中文界面、会话列表、多会话并行  
- 插话：**Enter = 排队**，**引导 = 打断并发送**  
- 侧栏运行中转圈 / 完成后绿点  
- 文件 Diff、全文搜索、计划条目展示  
- Skills / 插件 / MCP / 记忆入口  
- 聊天壁纸（渐变 + 航天主题 + 自选图 + 压暗）  
- electron-builder：Linux deb / AppImage；后续扩展 Windows  

---

## 功能演进对照（方便对外介绍）

| 能力 | 大致版本 |
|------|----------|
| 多会话 + 排队引导 + Diff + 搜索 | 0.6 |
| 首次引导、完成通知、检查更新 | 0.7 |
| 顶栏计划、权限三档、中英 i18n | 0.8.0 |
| 关于开发者、消息超链 | 0.8.2 |
| 左右气泡分色 | 0.8.3 |
| 会话右键全家桶、归档/置顶、设置去重 | **0.8.4（当前）** |

---

## 路线图备忘（未做，供后续）

- 设置项更多「即时保存」（少点一次保存）  
- 归档/置顶同步到更多设备（若需要账号层，另议）  
- macOS 打包  
- README / 商店截图与 0.8.3+ 气泡 UI 对齐  
- GitHub Sponsors 开通后显示「赞助作者」按钮  
- Skills 内嵌编辑器增强  

---

*维护：与 [README.md](./README.md) 配套。发版时请同步改版本号徽章与 Release 附件列表。*