wangjc683/galley
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
原文
跑在你电脑上的全能助理。极简 harness,把舞台留给模型,在模型飞速进化的时代押注未来。
跟随系统外观,浅色深色各一套。
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 经稳定的
galleyCLI 操作同一份会话与项目,和你、和助理坐在同一张桌边。 - 💾 后台常驻 + 搜索——关窗不退出,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。
- 下载 Galley——从 Releases 下载 macOS / Windows 安装包。
- 配置模型——首次启动选择服务商、粘贴 API Key(或登录 ChatGPT),连接自动测试。
- 开始使用——点击「开始使用 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。





