PacificStudio/openase
GitHub: PacificStudio/openase
OpenASE 是一个工单驱动的自动化软件工程平台,利用AI智能体将工单转化为可运行代码,解决软件开发中的任务自动化问题。
Stars: 248 | Forks: 22
OpenASE
工单驱动的自动化软件工程
OpenASE 是一个一体化平台,将工单转化为可运行的代码——AI 智能体自动领取工单、在您的机器上执行工作流,并交付结果,同时提供完整的可追溯性。
## 🖼️ 产品截图
内嵌的 Web UI 涵盖了工单编排、AI 辅助规划、技能编写和实时项目跟踪。
Live execution
Monitor real project work as tickets move across backlog, todo, in-progress, and review.
Ticket board Manage backlog and execution flow with a kanban-style ticket view.
|
Project AI Break work into tickets and inspect workspace context directly beside the board.
|
Skill editor Edit built-in or custom skills that drive repeatable automation workflows.
|
## 🤔 OpenASE 是什么?
OpenASE 是一个**单一的 Go 二进制文件**,将 API 服务器、工作流编排器和内嵌的 Web UI 集成在一起。它遵循**工单驱动**的模式:每一项工作都是一个工单,每个工单都有一个工作流,AI 智能体根据状态触发器自动拾取并执行工单。
```
You create a ticket → Orchestrator detects pickup status
→ Agent claims the ticket → Executes workflow on a Machine
→ Activity stream records every step → Ticket completes
```
**运行时无需 Node.js** —— SvelteKit 前端通过 `go:embed` 编译并嵌入到 Go 二进制文件中。
## 🧭 OpenASE 为何存在
AI 编码智能体功能强大——但前提是人类保持控制。OpenASE 围绕两种互补的人机交互模式构建:
### 异步 AI —— 工单智能体
当需求明确且已有**约束文档**(一种限制智能体行为的硬边界文档)就位时,**工单智能体**会自主执行整个任务。它遵循工作流的指示,更新工单状态,并完成工作——人类无需进行监督。两种常见模式:
- **全栈编码员** —— 单个智能体处理整个生命周期(`待办 → 进行中 → 待审查 → 合并 → 完成`)。
- **混合接力** —— 多个专业智能体协作(`设计 → 后端 → 前端 → 测试 → 待审查 → 合并 → 完成`),每个负责一个阶段。
### 同步 AI —— 项目 AI
当需求模糊或您希望在确定工单前进行探索时,可以与控制面板侧边栏中的同步助手 **Project AI** 开始对话。每个标签页运行在独立的隔离工作区中;标签页相互独立、可并行运行且易于管理。Project AI 可以读取工单/工作流/技能、编辑约束文档和技能、操作 git,并触发智能体运行。当您导航时,它会自动在**工作流 / 技能 / 工单 / 机器**聚焦模式之间切换。
### 技能 —— 扩展智能体的能力
技能是可复用的指令文档,赋予智能体额外的能力。每个工作流会自动绑定一个内置的**工单技能**,以便智能体知道如何驱动状态流转。您可以绑定更多内置技能,在技能编辑器中编写自定义技能,或从您的代码库导入。绑定的技能在运行时会被注入到 CLI 智能体的技能目录中(`.codex/skills/`、`.claude/skills/`、`.gemini/skills/`)。
### 组织与项目管理
OpenASE 开箱即用地支持**多组织**管理。每个组织包含自己的项目、工单、工作流、技能、机器和提供者。跨组织团队协作功能正在**开发中**。
### ⚠️ 安全须知
为最大化工作流的无人值守执行,OpenASE **默认使用宽松的标志**启动 CLI 智能体(对 Claude Code 是 `--dangerously-skip-permissions`,对 Codex 是 `--yolo`)。智能体可以在主机上读取、写入和执行任意命令,无需逐项确认。您可以在**提供者设置**中按提供者切换到标准交互模式。
- 仅在您信任智能体访问范围的机器上运行 OpenASE。
- **本项目并非为面向公众的部署而设计** —— 它的目标是本地开发、私有网络和受信任的环境。
- 浏览器访问始终需要授权门控。全新安装使用**本地引导链接**;联网部署应迁移到 **HTTPS + OIDC**(参见 [OIDC 与 RBAC 指南](docs/en/human-auth-oidc-rbac.md))。
## ✨ 主要特性
📋 工单驱动编排
看板与列表视图
父子与依赖关系跟踪
自定义状态与优先级
仓库作用域绑定
|
Claude Code / Codex / Gemini CLI
实时流式输出 (SSE)
智能体生命周期管理
并发执行控制
|
⚡ 工作流引擎
Markdown 约束文档
技能绑定与生命周期钩子
定时 Cron 作业
内置角色模板
|
🖥️ 机器管理
本地 / 直接连接 / 反向连接
WebSocket 执行 + SSH 引导
健康探测与资源指标
连接性诊断
|
🔐 认证与安全
OIDC 浏览器登录 (Auth0, Entra ID)
智能体平台令牌认证
组织与项目 RBAC
GitHub 凭证管理
|
📡 可观测性
实时活动事件流
智能体运行步骤跟踪
GitHub Webhook 接收
项目更新线程
|
## 🚀 从零到运行
### 快速通道:一键安装程序
适用于全新的 Linux 或 macOS 机器:
```
curl -fsSL https://raw.githubusercontent.com/pacificstudio/openase/main/scripts/install.sh | sh
```
要固定特定版本:
```
curl -fsSL https://raw.githubusercontent.com/pacificstudio/openase/main/scripts/install.sh | sh -s -- --version
```
### 从源码构建
```
git clone https://github.com/PacificStudio/openase.git
cd openase
make build-web # build frontend + Go binary
./bin/openase setup # interactive first-run setup
./bin/openase all-in-one --config ~/.openase/config.yaml
```
在全新的云虚拟机上,请为前端构建预留足够的内存。实际上,`make build-web` 在至少有 8 GB 内存的机器上运行要可靠得多,或者在 4 GB 的 droplet 上先添加 swap 后运行。
之后,控制面板可在 `http://127.0.0.1:19836` 访问。
有关先决条件安装(Go、Node、PostgreSQL、智能体 CLI)、完整设置演练、运行模式(托管用户服务、分离进程、仅环境变量)和验证步骤,请参见[源码构建与启动指南](docs/en/source-build-and-run.md)。
### 下一步?
## 📊 路线图
| 优先级 | 项目 | 描述 |
|--------|------|------|
| 🟡 中 | **远程运行时操作** | 围绕仅 WebSocket 的远程运行时平面,扩展部署自动化、仪表板和运维工具 |
| 🟡 中 | **Windows 支持** | WSL2 之外的原生服务管理和 shell 脚本支持 |
| 🟡 中 | **通知渠道** | Webhook、Telegram、Slack 和企业微信通知推送 |
| 🟡 中 | **iOS 和 Android 应用** | 移动端控制面板,用于在移动中监控和管理项目 |
| 🟡 中 | **桌面一体化应用** | 捆绑完整 OpenASE 体验的独立桌面应用程序 |
| 🟡 中 | **Kubernetes 运行时** | 在 Kubernetes 集群上运行智能体工作负载以实现弹性伸缩 |
| 🟢 未来 | **多组织协作** | 跨组织项目共享与权限管理 |
| 🟢 未来 | **插件生态系统** | 第三方插件支持,用于自定义工具和集成 |
| 🟢 稳定 | **指标仪表板** | 智能体性能指标、工单吞吐量分析 |
## 🖥️ 控制面板
| 模块 | 能力 |
|------|------|
| **[工单](docs/guide/en/tickets.md)** | 看板视图、列表视图、筛选、评论、依赖关系、仓库作用域 |
| **[智能体](docs/guide/en/agents.md)** | 注册、实时运行监控、暂停/恢复/退役生命周期 |
| **[机器](docs/guide/en/machines.md)** | SSH/本地/云注册、健康探测、资源指标 |
| **[工作流](docs/guide/en/workflows.md)** | 约束文档编辑、状态绑定、技能绑定、版本历史、影响分析 |
| **[技能](docs/guide/en/skills.md)** | 内置与自定义技能管理、工作流绑定 |
| **[定时作业](docs/guide/en/scheduled-jobs.md)** | 基于 Cron 的工单创建、手动触发、启用/禁用 |
| **[活动](docs/guide/en/activity.md)** | 实时事件流、类型筛选、关键词搜索 |
| **[更新](docs/guide/en/updates.md)** | 团队进度线程、评论、修订历史 |
| **[设置](docs/guide/en/settings.md)** | 状态、仓库、通知、安全、已归档工单 |
## 🏗️ 架构
| 原则 | 描述 |
|------|------|
| **全 Go 单体应用** | API 服务器、编排器、设置流程和内嵌 UI 集成在一个二进制文件中 |
| **二进制文件优先** | Web UI 通过 `go:embed` 嵌入——运行时无需 Node.js |
| **工单驱动** | 工单、工作流、状态和活动是核心操作模型 |
| **多智能体** | 基于适配器支持 Claude Code、Codex 和 Gemini CLI |
| **Git 支持** | 工作流约束文档和技能在运行时感知代码库 |
```
flowchart LR
U[User / Scheduled Job] --> T[Ticket]
T --> O[Orchestrator]
O -->|status trigger| A[Agent]
A --> W[Workflow + Harness]
W --> S[Skills]
A -->|executes on| M[Machine]
M --> R[Results]
R --> E[Activity Stream]
E --> UI[Web Control Plane]
```
有关仓库布局、构建命令和质量门禁,请参见[开发指南](docs/en/development.md)。
## 📖 文档
| 文档 | 英文 | 中文 |
|------|------|------|
| **用户指南** | [英文](docs/guide/en/index.md) | [中文](docs/guide/zh/index.md) |
| 入门指南 | [英文](docs/guide/en/startup.md) | [中文](docs/guide/zh/startup.md) |
| 模块架构 | [英文](docs/guide/en/architecture.md) | [中文](docs/guide/zh/architecture.md) |
| 常见问题 | [英文](docs/guide/en/faq.md) | [中文](docs/guide/zh/faq.md) |
| **源码构建与启动** | [英文](docs/en/source-build-and-run.md) | [中文](docs/zh/source-build-and-run.md) |
| 配置参考 | [英文](docs/en/configuration.md) | — |
| CLI 参考 | [英文](docs/en/cli-reference.md) | — |
| 开发指南 | [英文](docs/en/development.md) | — |
| IAM 双模式契约 | [英文](docs/en/iam-dual-mode-contract.md) | [中文](docs/zh/iam-dual-mode-contract.md) |
| WebSocket 运行时契约 | [英文](docs/en/websocket-runtime-contract.md) | [中文](docs/zh/websocket-runtime-contract.md) |
| OIDC 与 RBAC | [英文](docs/en/human-auth-oidc-rbac.md) | [中文](docs/zh/human-auth-oidc-rbac.md) |
| 可观测性 | [英文](docs/en/observability-checklist.md) | [中文](docs/zh/observability-checklist.md) |
| 远程运行时 v1 部署 | [英文](docs/en/remote-websocket-rollout.md) | [中文](docs/zh/remote-websocket-rollout.md) |
| Gemini CLI 适配 | [英文](docs/en/gemini-cli-adaptation-guide.md) | [中文](docs/zh/gemini-cli-adaptation-guide.md) |
| Claude Code 流协议 | [英文](docs/en/claude-code-stream-protocol.md) | [中文](docs/zh/claude-code-stream-protocol.md) |
## 📄 许可证
参见 [LICENSE](LICENSE)。
## 友情链接
[linux.do](https://linux.do/latest)
OpenASE
创建工单。剩下的交给智能体。
标签:AI代理, EVTX分析, Go语言, Linux 内核安全, PostgreSQL, SOC Prime, TCP SYN 扫描, Web UI, 代码生成, 任务管理, 可追溯性, 工作流自动化, 工程自动化, 开发工具, 快速开发, 日志审计, 智能代理, 测试用例, 渗透测试工具, 票据驱动开发, 程序破解, 自动化软件工程, 软件开发平台, 项目管理