keel

Keel

用纯 Go 写桌面界面，不需要 HTML、CSS、JavaScript 或 WebView。界面由 Gio 绘制；Gio 没有的原生能力（权限、截图、合成输入、全局快捷键）在 native/ 下。

type hello struct {
    name   *kit.InputView
    result string
}

func (h *hello) Render(cx *el.Context) el.Element {
    return el.Div().P(24).Gap(12).Child(
        h.name.Render(cx),
        el.Div().Row().Child(kit.Button("打招呼", func() { h.result = "你好，" + h.name.Value() }).Render(cx)),
        el.Text(h.result),
    )
}

window.Open(window.Options{Title: "Hello", Content: el.Root(&hello{name: kit.Input("你的名字")})})
window.Main()

go run ./examples/hello
go run ./examples/multiwindow
go run ./examples/hotkey
go run ./examples/chat -sample=all
go run ./examples/components   # 组件库：侧栏选择、搜索
go test -race ./...

需要 Go 1.26+；macOS 上需要 Xcode Command Line Tools。

模块

另有工具 cmd/keel-mcp：MCP server，让 Agent 对应用做端到端测试（启动、读元素、点击、输入、滚动、截图），见 Agent 端到端测试。

依赖只往下走、同层不互相引用，ui 和 native 互不依赖，由 go test ./... 里的边界测试保证。每个模块目录下有 README。总览见 ui/README.md 和 native/README.md。

文档

完整文档在 docs/：

• 快速开始
• 架构：模块划分、依赖方向、线程规则
• 元素与视图：GPUI 风格的写法
• Markdown：AI 流式输出的渲染
• 窗口与应用 · kit 组件 · 原生能力 · 在浏览器里运行
• 扩展指南：新增组件、原生能力的步骤
• 测试 · Agent 端到端测试 · 常见问题 · 设计决策

授权

Keel 采用 AGPL-3.0 与商业授权双授权。开源项目和个人自用按 AGPL 免费使用；在闭源软件里使用 Keel 需要购买商业授权。详见 LICENSING.md，参与贡献见 CONTRIBUTING.md。