Skip to content
项目

wangjc683/galley has 74 GitHub stars and 14 forks. GitHot measured 0 stars in 24 hours, +1 in 7 days, and +2 in 15 days. Last checked 2026-11-18 12:05 UTC. Last push 2026-11-17.

这些数字如何统计

实测星标增长

24小时
0
7天
+1
15天
+2
1个月
正在收集历史

各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。

关于

Less harness. More model. A lightweight local AI assistant. / 极简 harness 的本地全能 AI 助理。

人工智能

README.zh-CN.md

原文

Galley — Less harness. More model.

跑在你电脑上的全能助理。极简 harness,把舞台留给模型,在模型飞速进化的时代押注未来。

下载 · 快速开始 · 截图 · 文档 · English

Latest Release Platform: macOS | Windows License: MIT

Galley 主对话:私人助理记下的待办,派出去又回来交代的活
跟随系统外观,浅色深色各一套。

Galley 是什么

Galley 是跑在你自己电脑上的私人助理。

  • 能动手——终端、文件,还有你已经登录的浏览器:订票、查订单、填表这类云端助手碰不到的活,它在你电脑上直接办。
  • 只跟一个人说话——费时间的活它派出去,办完回来给你交代;该提醒你的事,它自己记着。
  • 押注模型——harness 刻意做薄,模型每升级一次,Galley 就跟着强一次;记住的、学会的都在你电脑上,换模型也带得走。

亮点

一个助理,事事有交代

  • 💬 主对话——一条一直在的对话,有事直接说,像在聊天软件里一样;侧栏里它那张会动的脸,告诉你它在忙还是闲着。
  • 🧑‍💼 派活、验收、交代——费时间的活它派给工作台里的子任务,跑完或卡住时它被叫醒:对照要求看结果,不够就打回去,够了用一两句告诉你。子任务的提问先到它这里,它答得了就替你答。
  • 📝 待办与主动提醒——「下周三交材料」这样的话,它自己判断要不要记成待办、什么时候提醒你;说一声「不用」就取消。每条对话旁边都能打开待办面板,你在上面只管勾掉,其余跟它说。
  • 🗂️ 替你管 Galley——开会话、建项目、整理归档、设一次性提醒,它自己动手,做完告诉你怎么撤;API Key、登录、浏览器插件只能你来,它会告诉你去哪填。
  • 📱 iPhone App(开发中)——在手机上和同一个它说话。它照旧在你的电脑上干活,手机经端到端加密中转连回来,中转只见密文。

能真正做事

由内置内核驱动——基于 GenericAgent 二次开发,随安装包附带,下载即用。

  • 🖥️ 系统级执行——终端、文件、键盘鼠标、屏幕视觉,直到通过 ADB 操作手机:从查资料到把事真正办完。
  • 🌐 真实浏览器——把自带的扩展装进 Chrome 或 Edge 解锁一次,它用的就是你已登录的那个浏览器,不必重新登录。
  • 🧬 自进化技能——每解决一个新任务,就把做法沉淀成可复用的技能;技能和记忆都长在你本地,换模型也带得走。
  • 💰 Token 效率,有数据——靠信息密度而不是窗口长度:Lifelong AgentBench 上 100% 准确率,输入 token 只有主流 Agent 的 1/3 到 1/6(论文);默认窗口 90K。
  • 🔌 任意模型,包括本地的——登录 ChatGPT 用订阅额度,或者填自己的 API Key:从 Anthropic、OpenAI 到 DeepSeek、Kimi、GLM 的预设,任意兼容端点,Ollama 不用填 Key;推理强度按对话设定。
  • 📖 阅读面板——写出的文件在对话旁边打开:Markdown、代码、图片,CSV 显示成表格。在输入框添加文件或图片;只读审阅 Git 仓库的改动,统一或分栏。

工作台和更多入口

工作台是团队干活的地方:助理派出去的活在这里跑,你也可以自己开会话,围绕一个项目深度工作。

  • 🧭 项目 + 并行会话——把项目指向一个文件夹,代码仓库或资料夹都行,多条会话围绕它并行推进。
  • 🔧 透明运行——思考过程实时可见;每一步都能展开看完整参数与结果,跑完整轮折叠成一行。
  • ⏰ 定时任务——每天、每周或每月到点开一条新会话跑一段提示词,结果在侧栏等你;也可以直接跟助理说,它替你设。需要 Galley 处于运行中,可设为开机自动启动。
  • 📨 聊天软件——微信、飞书、Telegram 或 Discord 里也能找它办事,和桌面共用长期记忆;长任务交给桌面端的会话,做完回来告诉你。
  • 🤖 外部 Agent 接入——Claude Code、Codex 这类 Agent 经稳定的 galley CLI 操作同一份会话与项目,和你、和助理坐在同一张桌边。
  • 💾 后台常驻 + 搜索——关窗不退出,Galley 留在菜单栏 / 托盘,做完时发通知;⌘K(Windows 上是 Ctrl+K)全文搜索历史会话,⌘F(Ctrl+F)在当前对话里查找。

截图

待办面板
待办 · 它替你记着的事,每条对话旁边都能打开
工作台
工作台 · 助理派出去的活在这里跑,每一步都看得见
阅读面板
阅读面板 · 在对话旁边审阅工作区改动
项目
项目 · 多条会话围绕同一项目并行
定时任务
定时任务 · 每天早上自己跑的一段提示词
全文搜索
⌘K · 历史会话全文可搜,直达命中的那一行

快速开始

先想好怎么接模型。ChatGPT、OpenAI、Anthropic、DeepSeek、Kimi for Coding、MiniMax、OpenRouter、SiliconFlow、Xiaomi MiMo、Zhipu GLM 预设开箱可选,端点已预填:ChatGPT 登录你的 ChatGPT 账号,用 Plus / Pro 的订阅额度;其余填 API Key。其他 OpenAI 或 Anthropic 兼容端点选「自定义」,填上地址即可;Ollama 这类本地服务不用填 Key。

  1. 下载 Galley——从 Releases 下载 macOS / Windows 安装包。
  2. 配置模型——首次启动选择服务商、粘贴 API Key(或登录 ChatGPT),连接自动测试。
  3. 开始使用——点击「开始使用 Galley」,进入主对话(登录 ChatGPT 的会直接进入),有事直接跟它说。
平台 安装包
macOS Apple Silicon 文件名包含 macOS_aarch64.dmg
macOS Intel 文件名包含 macOS_x64.dmg
Windows x64 文件名包含 Windows_x64-setup.exe
安装提示

macOS 暂未代码签名,首次打开若被系统拦截,运行:

xattr -dr com.apple.quarantine /Applications/Galley.app

Windows SmartScreen 提示「发布者未知」时,点「更多信息」→「仍要运行」。

已有 GenericAgent 环境,可在 设置 → 运行环境 → 更多 → 接入外部 GA 选择 GA 目录。接入后 Galley 严格只读,不改动外部 GA 的代码、memory、SOP 或 mykey.py。主对话(助理与待办)、浏览器控制与聊天软件只在内置内核下可用,设置 → 模型 里的服务商也只供内置内核使用;外部 GA 继续用它自己的 mykey.py。

接入外部 Agent

Galley 的助理用 galley CLI 带团队;Claude Code、Codex 这类外部 Agent 也能用同一套 CLI 接进来,作为 Supervisor Agent 检查、继续、新开会话。GUI 启动后进 设置 → 智能体接入:

按钮 做什么
复制 SOP 复制短版 galley-supervisor-sop.md 发给你的 Agent,让它学会检查、继续、新开、拆分和等待 Galley 任务;高级细节见 Supervisor reference
查看 Agent API 文档 在「高级选项」里:打开完整命令清单、JSON schema 和 exit code
安装 galley 命令 在「高级选项」里(macOS):把 galley 放进 PATH,你和你的脚本都能在终端直接调用;SOP 不依赖它

你不用学 CLI——用自然语言告诉 Supervisor Agent 想做什么,由它来安排 Galley。复制给 Agent 的 SOP 是轻量热路径,高级命令和编排细节留在 reference 与 Agent API 里。用 Claude Code 的话,同一份 SOP 也可以装成 skill:galley-supervisor(Codex 版在 .agents/skills/ 下)。

任务的大小对应不同的承载方式,而不是堆成一个巨型 prompt:

  • 简单问题——直接读或跟进某个 session;
  • 项目 / 资料夹任务——用 Project Workspace 绑定工作区,多会话并行。
展开 CLI 示例

Galley 运行时,Supervisor Agent 可以在同一台机器上调用 galley 派任务:

# 看现在跑啥(每行的 `live.busy` 才是真实的忙闲信号;
# `live.askPending` 表示该 session 正等着用户回答问题)
galley status
galley sessions list

# 开个新 session 跟进 PR
galley session new --project=proj_work \
  --supervisor=ga-claude-1 --reason="跟进 PR review" \
  "看下 #1234 的反馈"

# 复杂任务:用一个 Project 承载一组 sessions
galley project create "Release readiness review" \
  --supervisor=ga-claude-1 --reason="并行检查发布风险"

galley session new "只读检查 app identity、数据目录、SQLite migration 和备份风险。输出风险清单和证据。" \
  --project=<project-id> --supervisor=ga-claude-1 --reason="检查数据安全"

galley session new "只读检查 packaging、release workflow、bundled resources 和版本号。输出 release blocker checklist。" \
  --project=<project-id> --supervisor=ga-claude-1 --reason="检查发布打包"

galley project follow <project-id> --tail=80 --until-idle --final-show

# 跟进一个 session,或等它这一轮跑完
galley session follow <id>
galley session wait <id> --until-idle --timeout=600

# 切 LLM / 归档 / 恢复
galley llm set <id> "另一个模型名"
galley session archive <id> --supervisor=ga-claude-1 --reason="done"
galley session restore <id>

写命令接受 --supervisor 与 --reason;带上 --supervisor 就记为 via=supervisor,否则是 via=cli。经 CLI 创建的 session 和发出的消息,不管带不带 --supervisor,在侧栏和对话里都带一个「Galley CLI」标记(Galley 自己经 CLI 写的标 Galley,定时任务标时钟),human 一眼就能看出哪些出自 agent;--supervisor 的标签照旧记在 origin 里,界面不显示。

完整命令清单、JSON schema 与 exit code 见 Agent API 文档。

架构

GUI 和 CLI 是对等前端——不是 GUI 套壳 CLI,而是两端各自直连同一个 Rust Core:GUI 在应用内部直连,CLI 走本地 socket。Core 是唯一权威层,掌管主对话、session / Project 状态、待办与定时任务、SQLite 写入,以及 Galley 运行的每一个 Python 进程;默认都跑在内置内核上,开箱即用。

flowchart TB
  GUI["Galley GUI<br/>Tauri · React"] -- in-process --> Core
  CLI["Galley CLI<br/>Rust"] -- "local socket · named pipe<br/>no TCP · no token" --> Core
  Core["Galley Core<br/>Rust<br/>main chat<br/>sessions<br/>projects<br/>to-dos<br/>scheduled tasks<br/>SQLite"]
  Core --> R["Session runners<br/>one per session"]
  Core --> IM["IM channels<br/>one per app"]
  Core --> BB["Browser bridge<br/>resident"]
  R & IM & BB --> GA["Galley-managed<br/>GenericAgent<br/>Galley patches<br/>runtime prompt<br/>CPython 3.11"]

三类进程都是 Python。接入外部 GA 时,会话 runner 改用外部 GA,聊天软件与浏览器桥不启动。

技术栈: Tauri v2 + React 19 + TypeScript 5.8 + Tailwind v4 / Rust(Galley Core + Galley CLI)/ Python(runner,包装 GenericAgent)/ SQLite + FTS5 trigram

更多文档入口: 架构说明 · 贡献指南 · 文档索引

工程笔记

一些不在功能列表里、却决定了 Galley 工程质量的设计选择:

展开六条设计选择
  • 对等前端,不是 GUI 套壳 CLI。 GUI 和 CLI 各自直连 Rust Core,互不依赖。关掉窗口,Core、正在跑的 session 和 CLI 都照常在后台工作。助理和聊天软件也没有另起一套协议:主对话里的助理和每个聊天软件渠道,派活、查进度用的都是外部 Supervisor 用的那套 CLI。

  • Rust Core 是唯一权威。 session / Project 的状态机、定时任务、SQLite 写入和所有子进程全部收敛到 Core 一处。前端只读投影、发意图,不持有可写状态,从根上避免了多端状态漂移。

  • 本地优先的安全模型。 进程间走 Unix socket(0600 权限)或 Windows named pipe,仅 localhost、no token、no TLS——因为信任边界就是「同一台机器的同一个用户」。不把本地工具硬塞进一套网络鉴权,是有意识的减法。

  • Agent API 是有版本的公开契约。 CLI 输出带 schemaVersion;同一版本内只做增量,破坏性改动必须升版本——现行是 3,没改过的命令仍回答 1 和 2。写命令会记下谁让做的、为什么(via / supervisor / reason)。Supervisor 可以放心把它当 API 来编程。

  • 双 runtime 的边界纪律。 默认用内置内核(含 CPython 3.11 与依赖,开箱即用);接入外部 GenericAgent 时,Galley 严格只读——不改外部 GA 的代码、memory、SOP 或 mykey.py,你的现有环境不会被污染。

  • 可演进的持久层。 SQLite 作权威存储;升级前先整份备份数据目录,再按序跑 migration。历史会话用 FTS5 trigram 索引,中文也能子串搜索,关窗后台常驻、回来即搜。

为什么叫 Galley

船上的 galley 是厨房,也是工作台。每个人来这里都有自己的事,但桌子是同一张。

Galley 也是这张桌子:你在这里跟助理说话,助理带着团队在工作台干活,接进来的外部 Agent 经 CLI 也坐在同一张桌边。会话、历史和每一步动作都是同一份,不是各开各的。

Galley started as a workbench for GenericAgent. The first two letters of our name are a quiet bow to where we came from.

新对话:带题词的空工作区
每次新对话都从一句题词开始,这句出自《哲学研究》。

贡献 / 从源码构建

git clone https://github.com/wangjc683/galley
cd galley
pnpm --dir gui install
./scripts/bundle-python.sh mac-arm64   # 或 mac-x64 / win-x64:一次性备好内置 Python
pnpm --dir gui tauri dev               # 桌面开发模式

环境要求、CI 跑的检查、runner 测试、安装包与独立 CLI 的构建,见 CONTRIBUTING.md。

致谢

Galley 的内核基于 lsdefine/GenericAgent 二次开发——约 3K 行种子代码、自进化的极简 agent 框架。没有这份干净的地基,就没有 Galley。

相关论文:GenericAgent: A Token-Efficient Self-Evolving LLM Agent via Contextual Information Density Maximization (arXiv:2604.17091)

许可证

MIT