Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions assets/seed/MANIFEST.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"bundle_version": "2026-10-04.1",
"bundle_version": "2026-10-09.1",
"description": "Versioned default ACECode global Skill, expert, and managed hook seed bundle reconciled at startup.",
"skills": [
{
Expand Down Expand Up @@ -42,13 +42,13 @@
"name": "acecode-tui-usage",
"source_id": "acecode:acecode-tui-usage@2026-07-20",
"relative_path": "acecode/acecode-tui-usage",
"skill_md_sha256": "8dc11abf0224872ffa3d98f6d218aac623e5b3bbd383639673fd9cc45f488468"
"skill_md_sha256": "cbe94d9b1ec3b445a19ffdc422e4a328438edacdb245daa77520bf8f5f806149"
},
{
"name": "acecode-desktop-usage",
"source_id": "acecode:acecode-desktop-usage@2026-10-04",
"relative_path": "acecode/acecode-desktop-usage",
"skill_md_sha256": "e67f13bd466c274840be46ab48bcffb8b4c06e61012010ab6cb2ae5670a64485"
"skill_md_sha256": "96cc03b4bca81be8db23629f3c4723e73b5ec435e618645281e060c6dacaf0fd"
},
{
"name": "vision-image-reader",
Expand Down
2 changes: 1 addition & 1 deletion assets/seed/seed.version
Original file line number Diff line number Diff line change
@@ -1 +1 @@
2026-10-04.1
2026-10-09.1
58 changes: 42 additions & 16 deletions assets/seed/skills/acecode/acecode-desktop-usage/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,26 @@
---
name: acecode-desktop-usage
description: "说明 ACECode Desktop 原生桌面应用的用法,包括工作区、任务、会话、输入框、权限、可选 Git worktree、搜索、文件与差异面板、设置、技能、MCP、定时任务、通知、更新和故障排查。当用户询问 Windows、macOS 或 Linux 图形界面的操作方法时使用。不要用终端 TUI 的命令代替 Desktop 界面操作。"
description: "说明 ACECode Desktop 和共享 Web 界面的操作,包括任务、文件、模型、权限、记忆、蜂群、定时任务、消息通道、虚拟办公室、快捷键和更新排错。用户询问图形界面操作时使用;区分原生桌面能力与直接 Web 的限制,不用 TUI 专属命令代替界面操作。"
---

# ACECode Desktop 使用指南

说明 ACECode 原生桌面应用的操作方法。以当前 Desktop 界面中实际可见的控件和行为为准,
不要照搬终端 TUI 的命令或快捷键,因为两个界面的功能范围并不完全相同。

内容核对日期:2026-10-09。涉及记忆、侧边聊天、蜂群、定时任务、消息通道、虚拟办公室、
快捷键、Responses、HTML 预览或更新时,按需读取 [功能操作说明](references/features.md)。
仓库中的离线帮助手册入口为 `docs/help/index.html`,正文源为 `docs/help-source/`。

## 按当前界面回答

- 将 `acecode-desktop.exe`、`acecode-desktop` 和 `ACECode.app` 视为由原生外壳、
React 界面和托管 daemon 组成的 ACECode Desktop。
- 先给出最短的界面操作步骤,再补充相关选项。
- 明确区分工作区、任务/会话、Git worktree 和定时任务。
- 不要声称新建任务会自动创建目录或 Git worktree。
- 不要在 Desktop 中推荐仅 TUI 支持的 `/model`、`/mode`、`/resume`、
`/memory` 或 `/theme`。应改用模型选择器、权限选择器、侧边栏、搜索或设置页。
- 不要在 Desktop 中推荐仅 TUI 支持的 `/model`、`/mode`、`/resume` 或 `/theme`。
应改用模型选择器、权限选择器、侧边栏、搜索或设置页。`/memory` 已支持 Desktop/Web。
- 如果可以读取当前仓库,并且问题涉及容易变化的细节,应检查:
- `web/src/`:界面控件和快捷键
- `web/src/lib/settingsNavigation.js`:设置页分类
Expand Down Expand Up @@ -73,6 +77,8 @@ Git 仓库,再查看任务中显示的错误。
- 在原生 Desktop 中使用添加按钮附加图片、文件或目录。
- 将文件拖入输入框也可以添加附件。
- 当前任务需要网页信息时,可加入已连接浏览器的上下文。
- 文件引用标签可以与文字一起选择、复制、剪切、删除和撤销;拖入后可以继续输入。
`/goal` 或加号菜单选项转换为底部标签时会短暂反馈,不会自动提交任务。

如果用户实际使用的是浏览器中的 Web UI,而不是原生 Desktop,应说明浏览器版支持的附件
类型可能少于原生应用。
Expand All @@ -81,15 +87,18 @@ Git 仓库,再查看任务中显示的错误。

Desktop 支持以下三条特殊消息命令:

- `/turn <插话内容>`:在下一个模型边界调整当前主任务的方向。
- `/btw <问题>`:发起一次与主任务分离的旁问。
- `/turn <指导内容>`:中断当前回合并立即提交新的指导。
- `/btw <问题>`:打开与主任务分离的侧边聊天浮窗,可继续追问。
- `/side <问题>`:`/btw` 的别名。

需要改变当前工作方向时使用 `/turn`。只是临时问一个不应影响、取消或替换主任务的问题时,
使用 `/btw` 或 `/side`。

任务执行期间发送普通消息时,该消息可能进入队列。不要把普通排队消息描述成与 `/turn`
完全等价。
任务执行期间发送普通消息时,该消息可能进入队列。排队卡片的 **插话** 在下一模型边界补充
当前回合;`/turn` 使用中断后立即提交指导的路径。普通排队、插话和 `/turn` 要分别说明。

侧边聊天可使用受限的文件读取、搜索和 LSP 工具,不能写文件、执行 Shell、调用 MCP 或派生
子代理。浮窗中的停止只停止旁问;最小化停止生成并保留当前会话的临时记录,切换主会话会清空。

## 选择权限

Expand All @@ -113,6 +122,7 @@ Desktop 内置命令菜单只提供一组聚焦的命令:
- `/goal`:管理长期目标。
- `/plan`:进入计划模式。
- `/lsp`:查看语言服务器集成。
- `/memory`:查看和管理全局、工作区记忆,或对当前会话开关记忆。
- `/rc` 或 `/remote-control`:管理远程控制。
- `/turn`、`/btw` 和 `/side`:控制当前任务或发起旁问。

Expand All @@ -138,6 +148,10 @@ Desktop 内置命令菜单只提供一组聚焦的命令:

已归档会话位于 **设置 > 已归档会话**。

置顶按钮在任务行悬停或获得键盘焦点时出现。长列表按需展开,还可收起。
已归档会话支持搜索、工作区筛选和组内时间排序;分组顺序跟随侧边栏。
全选只选中当前筛选结果,批量恢复或删除失败的记录会保留供重试。

会话右键菜单包含置顶/取消置顶、重命名、复制标题、复制 ID 和归档。消息右键菜单可以复制
内容,或使用 **从这里分叉** 创建新任务。

Expand All @@ -162,6 +176,10 @@ Desktop 内置命令菜单只提供一组聚焦的命令:
文件和目录右键菜单可以复制路径或将其加入对话上下文。工具结果右键菜单可以复制当前可见
输出或完整输出。折叠内容中缺少所需诊断信息时,优先复制完整输出。

文件路径面包屑可逐级进入目录。支持原生 Agent 浏览器时,HTML/HTM 文件预览工具栏的
浏览器图标会用 `file://` 打开磁盘上的文件;有未保存修改时先处理保存、不保存或取消。
长会话先显示最近内容,向上滚到历史边界会加载更早记录;底部悬浮箭头返回最新消息并恢复跟随。

通过对话流中现有的状态信息和工具卡片跟踪进度。不要另行虚构一个重复的固定进度面板。

## 打开设置
Expand All @@ -170,11 +188,14 @@ Desktop 内置命令菜单只提供一组聚焦的命令:

- **常规**:应用行为和通知。
- **外观**:主题和显示偏好。
- **快捷键**:按操作名称或组合键搜索快捷键。
- **配置**、**个性化**:ACECode 行为和个性化说明。
- **虚拟办公室**:Windows/macOS 桌面端的办公室显示开关,默认关闭。
- **使用情况**:使用量信息。
- **技能**:管理全局和工作区技能。
- **MCP 服务器**:管理 MCP 配置和状态。
- **连接器**:管理已连接服务。
- **消息通道**:连接和管理 QQ、微信、飞书、钉钉、Telegram、Discord、LINE。
- **模型**:配置提供商和模型。
- **工具**:配置工具。
- **钩子**:配置钩子。
Expand All @@ -193,9 +214,9 @@ Desktop 内置命令菜单只提供一组聚焦的命令:
- 新增或修改文件后刷新技能发现。
- 为技能编写准确的描述,使 ACECode 能在正确的请求中选中它。

内置 seed 技能只会在 ACECode 首次创建 `~/.acecode` 用户目录时安装。应用升级不会覆盖
现有技能,也不会自动把后来新增的 seed 技能补装到已有用户目录。现有用户需要显式复制
或安装新技能。
启动新版 ACECode 时,会按内置资源版本补装缺失技能、更新仍与上次安装内容一致的内置技能。
用户修改过的技能会保留;存在同名自定义目录时也不会直接覆盖。升级后仍看到旧说明时,先刷新
技能发现并核对实际加载路径和本地修改,不要删除整个技能目录或用户数据。

## 管理 MCP 服务器和连接器

Expand All @@ -214,6 +235,9 @@ Desktop 内置命令菜单只提供一组聚焦的命令:

打开定时任务页面,或从快捷菜单选择 **定时任务**。

**智能添加定时任务**会打开带 `scheduled-task` 技能的未发送草稿。补齐时间和天数后提交,
由内置创建工具询问执行权限;只有返回创建成功后才算已保存。也可选择 **手动添加**。

按需配置:

- 模板或自定义提示词;
Expand All @@ -224,8 +248,10 @@ Desktop 内置命令菜单只提供一组聚焦的命令:
- 单次、间隔或定时触发方式;
- 界面提供的有效时间范围。

Desktop 定时任务的权限选择少于普通任务,通常只提供默认审批或完全访问。保存后可以启用、
Desktop 定时任务只提供默认权限或完全访问,新建表单默认完全访问,保存前核对允许的操作。
保存后可以启用、
停用定时任务,并查看运行记录。除非调度设置明确要求立即运行,否则不要声称保存定时任务后会马上执行。
daemon 需在到期时运行,离线错过不补跑;停用只影响后续计划,停止当前执行需进入关联任务。

## 使用通知、托盘和更新

Expand All @@ -235,8 +261,9 @@ Desktop 可以在任务完成、请求权限或提出问题时发送系统通知
启用“关闭到托盘”后,关闭窗口可能只是把 ACECode 隐藏到系统托盘。需要彻底退出时,使用
托盘菜单、快捷菜单中的 **退出**,或操作系统提供的明确退出操作。

使用 **检查更新** 或 **关于** 检查新版本。更新流程可以下载、应用并重启应用。应用更新前,
先保存或提交工作区中的重要改动。
使用 **检查更新** 或 **关于** 检查新版本。发现更新后,入口位于侧边栏底部、问题反馈左侧,
下载中显示进度。下载和安装准备阶段可取消,开始替换程序后不可取消;慢速下载没有固定的
30 秒总时限。更新前先保存工作。MSIX 安装由商店管理更新;不据此宣称产品已在商店上架。

## 使用诊断快捷键

Expand All @@ -248,10 +275,9 @@ Desktop 可以在任务完成、请求权限或提出问题时发送系统通知

## 遵守当前 Desktop 边界

- Desktop daemon 会话目前没有与 TUI 完全一致的持久记忆支持,不要承诺 `/memory`
可以在 Desktop 中使用。
- Desktop/Web、TUI 和 headless 共用全局与工作区记忆;自动摘要默认关闭,需显式开启。
- Desktop 和 TUI 的命令注册表本来就不同。
- 不使用工作区的任务是有效的,但无法访问工作区文件。
- 不使用工作区的任务是有效的,不会自动提供某个项目的文件树和 Git 上下文;仍可显式引用允许访问的路径。
- `@目录/` 只提供目录路径上下文,不代表递归上传。
- 一个托管 daemon 服务应用中的多个工作区,不要按“每个工作区一个 daemon”排查。
- Worktree 和定时任务都是显式选择,在出现复选框的地方默认关闭。
Expand Down
Loading
Loading