快速开始

先确认版本

官网按 0.2.17（2026-09-12）的桌面工作区交付更新。近期能力主要在 macOS Apple Silicon 本地试用；本地签名构建未公证，不代表同版本已在 GitHub 发布。最终包的斜杠触发和物理 Tab 写回仍有待复测项。

打开 Harocue 发布记录，以具体版本的说明和附件为准。一键安装脚本和 npm 包安装的是已发布版本，可能不包含官网展示的全部新能力。

平台	选择方式
macOS Apple Silicon	查看 Release 是否提供所需桌面包；仅有 CLI 压缩包不等于带有桌面应用。近期本地试用构建未公证
Windows	已有 Release 分发入口包括 CLI 压缩包与 GUI 安装包，具体取决于该版本附件；本轮新桌面能力未做 Windows 实机验收
Linux	保留 CLI 和源码支持，本轮未做实机验收；Wayland 不支持全局键盘钩子

需要从源码体验时，按仓库说明中的构建与权限指南操作，不要假定旧下载包等同于当前桌面版本。

新版桌面首次使用

1. 打开应用，可选“先体验助理”，不必立即录制。默认已有“我的生活与工作”个人空间。
2. 在“设置 → 连接”选择云端兼容接口或本地 Ollama，保存连接并测试可用性。云端模型需要你自己的连接凭据，并可能产生服务商费用。
3. 需要观察桌面时，明确开启本机记录。macOS 按引导授予辅助功能和输入监控权限；可选屏幕文字补充另需屏幕录制权限。
4. 开启所需桌面帮助：输入停顿时试用 Cue；明确提问请在问题末尾输入 /，例如“我本周还有哪些待确认的事/”。根据当前有效提示按 Tab 采纳，继续输入或清空可取消。
5. 在“记忆”核对来源与推断，在“回顾”按日、周、月生成待审草稿。需要隔离事项时再建立独立空间。

记录与桌面帮助独立控制。暂停记录不会自动关闭 Cue 和明确问答。 若想同时停止，请关闭桌面帮助。新版文件查询默认全机可访问位置，可在设置中改为指定文件夹或关闭。详见隐私边界。

MCP 可选接入

不使用外部 Agent 时，无需配置 MCP。工程名与 npm 包已经迁移到 Harocue / @harocue/mcp。

下面是支持 mcpServers 配置的宿主示例。使用 npm 入口需要 Node.js 18+；首次运行会下载已发布的原生 CLI。

macOS / Linux

{
  "mcpServers": {
    "harocue": {
      "command": "npx",
      "args": ["-y", "@harocue/mcp"]
    }
  }
}

Windows

{
  "mcpServers": {
    "harocue": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@harocue/mcp"]
    }
  }
}

保存后重载宿主的 MCP，检查 Harocue 是否连接成功。不同 Agent 的配置位置与格式以其说明为准。

MCP 只读工具可读取本地数据库；触发生成、控制记录等工具另需同意采集和运行中的采集服务，部分版本在已授权时可自动启动后台服务。桌面新记忆与兼容 MCP 的覆盖范围可能不同。

更多配置见 MCP 包说明。反馈安装问题时说明系统、安装版本和目标应用，勿粘贴 API Key 或私人屏幕内容。