上手指南

从下载到第一次对话

照着做一遍大概三分钟。中间会碰到两个 macOS 的小坎（没签名、要登录），都写在下面了。

1 · 安装

先在 下载页 拿到跟你的芯片对应的安装包。

macOS 已打包
  1. 1
    打开 .dmg

    把里面的「小草」拖进 Applications（应用程序）。想免安装也可以用 zip，解压后直接双击。

  2. 2
    第一次要点「右键 → 打开」

    目前是 ad-hoc 签名（没买 Apple 开发者账号），直接双击会被系统提示「来自身份不明的开发者」。这时在访达里右键点小草图标 → 打开，弹窗里选「打开」，之后就能正常双击了。

    这不是中毒，是没签名的正常表现。点过一次「打开」之后，macOS 会记住这个决定。
  3. 3
    在菜单栏里找到绿色小苗

    小草不占 Dock，常驻右上角菜单栏。左键唤出面板，右键可以退出（设置页里也有「退出小草」）。

Windows 已打包 · 64 位
  1. 1
    运行 .exe 安装器

    在 下载页拿 Windows · 64 位安装包，双击安装；安装路径可以改。装完桌面右下角托盘里会出现绿色小苗，任务栏同时有小草的窗口入口。

  2. 2
    想要本地 AI 大脑，先装 Codex CLI

    Windows 版的本地 Agent 需要 Node 与 Codex CLI（npm install -g @openai/codex）装好并登录；不装也能用云端能力来源。也可以用环境变量 SMALL_GRASS_CODEX_BIN 指向 codex 可执行文件。

  3. 3
    托盘里找绿色小苗

    左键唤出小草，右键可以隐藏或退出。截屏翻译的快捷键在 Windows 上是 Ctrl + Shift + 2。

2 · 登录（一次性授权码）

小草要求登录后才能说话——本地 Agent 也一样。账号既是身份，也是小草出生时间的唯一来源。

流程
  1. 1桌面端点「通过浏览器登录」，拿到一个形如 ABCD-2345 的授权码（10 分钟有效）
  2. 2浏览器打开授权页，登录或注册（注册需要邀请码）
  3. 3点「确认授权」，回到小草——它会自动完成登录
几个约定
登录凭证存哪系统钥匙串（Electron safeStorage）
断网宽限72 小时
同时在线设备最多 3 台，超出吊销最旧的
注册所需邮箱 + 8 位以上密码 + 邀请码

密码用 scrypt 存，永远不明文。忘记密码目前只能联系管理员处理。

想在网页上先看一眼账号？

官网登录页 和桌面端是同一套账号，登录后在控制台能看到小草年龄、Token 用量、登录过的设备，也能导出或注销。

3 · 指定资料库目录

打开设置页 ⚙，选一个属于你自己的小草资料库根目录。这个目录里应该有这四个文件：

文件里面装的什么
项目档案.md你手上项目的长期背景，小草写报告时会回来翻
项目状态.json每个项目当前进行到哪一步
变更日志.md按时间记的变更流水
事件库.json核验通过的工作事实，周报与年报的数据来源

这个目录不要放在 iCloud / OneDrive / Git 同步目录里：资料库是个人数据，同步出去就等于共享了你的工作记忆。

4 · 授权三档：让它动到哪一步

默认是只读。档位不是换个文案，是真的落到 Codex 沙箱参数和 Claude 的权限模式上。

请求批准

每次都先问你

只读也已够用：看文件、看网页、截图。要动手时弹给你确认。

自动批准

只在工作区内动手

读写、建删文件都不再打断你，但活动范围锁在工作区目录以内。

完全访问

放开沙箱

能跑命令、能改工作区外的文件。开启前想清楚，随时可以降回来。

网页交互（点击、输入）一律按写操作管控——哪怕你已经选了自动批准。

5 · 日常怎么用

⌘⇧2

截屏问小草

唤起全屏框选浮层，框一块外文界面，翻译 / 保存 / 复制随你。走本地 Agent 识别，图片不出本机（需要系统「屏幕录制」权限）。

对话

多会话，各记各的

左侧导航可以新建 / 切换 / 删除会话。会话之间互相隔离，但小草记得之前说过的话。

开始专注

75 分钟提醒一次

点了「开始专注」，到点会来一句健康关怀。别指望它替你休息，它是个小闹钟。

性格

不满意它的语气？直接说

「说话别那么正经」这种话它会当真，拟一份新性格草稿给你确认。旧性格留着最多 10 份，随时能翻回去。

排障

启动报错 spawn Unknown system error -86（EBADARCH）
node_modules 里的 Electron 二进制和本机架构不符——常见原因是把 arm64 机器的 node_modules 整个拷到了 Intel 机器（Rosetta 只能反向）。在仓库里执行：
uname -m
rm -rf node_modules package-lock.json
npm install
提示已损坏 / 无法打开
如果下载的是 0.2.1 或更早版本，请重新下载 0.2.2 或更新版本：旧版存在签名缺失或失效的问题。新版采用 ad-hoc 签名，尚未经过 Apple 公证，因此仍可能提示无法验证开发者。确认从官网下载后，可在「系统设置 → 隐私与安全性」查看是否提供「仍要打开」。若仍显示「已损坏」，请反馈版本、芯片类型和完整提示，不要关闭系统安全保护。
截屏翻译没反应
需要给系统「屏幕录制」权限：系统设置 → 隐私与安全性 → 屏幕录制，把小草勾上。另外 Apple 芯片 + 本地 Agent 的读图效果还待更多实机验证。
Cloud（云端模型）显示「需登录后可用」
确实要登录。登录后在能力来源里选云端模型即可；本地 Agent 同样要求登录，但用的是你本机算力，不消耗云端额度。
今天的额度用完了
免费期服务端按 UTC+8 切日限额，用完当天不再转发，界面会明确提示。切到本地 Agent 不计额度。
想给另一台电脑装一份
用你自己的账号从仓库克隆代码到非同步目录（推荐 ~/Developer/小草），然后双击 启动小草.command。记得别把资料库目录放进同步盘——每个人的工作记忆都留在自己的电脑上。

还有别的问题？

指南没覆盖到的话，直接打开小草问它——它就在你菜单栏里。

去下载 登录 / 注册