Ginno 是一款本地优先的开源桌面 AI 工作台。把一个项目目录挂进会话,Agent 就能在你授权的范围内读取资料、修改文件、运行测试或操作浏览器。对话、工具执行记录和产物都可以在同一个工作台里查看。
从一次任务到可复用流程
| 你要做的事 | Ginno 怎么帮你 |
|---|---|
| 定位仓库里的构建失败 | 让 Agent 读日志、查源码、运行相关检查,再核对工具输出和修改。 |
| 根据项目笔记回答问题 | 接入 Obsidian Vault,检索相关笔记并附来源,方便回看原文。 |
| 重复执行一套检查或汇总 | 在 Workflow Studio 编排步骤、分支和人工确认,给流程定义做版本管理,并查看每次运行的进度。 |
| 并行处理多项工作 | 把能独立验收的任务交给子代理。配置 A2A 对端后,也能用远端节点执行会话或承接子任务。 |
例如,排查一次构建失败时,可以让 Agent 在会话里检查日志和代码。步骤稳定后,把读取日志、生成报告和人工确认放进工作流。下次运行沿用同一套流程,执行到人工节点时会暂停,等待你作决定。
运行架构与取舍
- 本地工作台。 Tauri 管理窗口和进程,Next.js 提供界面,Python sidecar 提供 API、事件流和执行能力。桌面端与运行时随安装包发布。
- 文件式会话。 会话使用追加式 JSONL 日志持久化,记忆和配置也以文件保存,便于备份与迁移。长会话会按策略清理较旧的工具输出或压缩上下文,用量面板可查看上下文预算。
- 可复用的流程定义。 Workflow Studio 将版本化的流程定义编译成 LangGraph 状态图。固定检查可用确定性步骤,开放式任务交给 Agent,审批节点按需暂停和恢复。
- 远端执行按节点配置。 Linux 服务器可部署无界面的
ginno node,按需作为 A2A 执行节点。节点的信任配置、可用能力和执行目录共同约束任务范围。远端执行的网络、凭据和运行环境由部署者管理。
数据在哪里
桌面版无需 Ginno 云账号。会话、记忆和配置保存在本机 Ginno 数据目录,工作产物写入所选目录。模型服务由你配置。选用远程模型时,请求所需的上下文会发送给对应提供方。调用外部 MCP、网页服务或远端 A2A 节点时,对应服务也会收到完成该操作所需的数据。
安装与版本
桌面安装包面向 Apple Silicon Mac。Linux 可部署运行时和无界面节点。Ginno 采用 MIT 许可证,目前处于 1.0 之前的迭代阶段。本文以 v0.4.1 的发布记录为基线。