ActionDock

把脚本、插件、仓库分发、AI 调用和运行治理放进同一运行体系的工具平台。同一份脚本定义，可以同时被人、REST API、CLI 和 Agent 使用。

ActionDock 是什么

ActionDock 做的核心事情是：

1. 你写一段脚本（Groovy 或 Python）
2. 给它定义输入输出的格式（JSON Schema）
3. 发布成不可变的快照版本
4. 然后通过管理台、REST API、CLI、定时任务、Webhook、AI Agent 等多种入口执行它

整个过程有完整的生命周期管理（草稿 → 发布 → 归档）、依赖声明（脚本依赖、插件依赖、AI 依赖）、版本快照和执行审计轨迹。

核心特性

• 统一脚本抽象 — 脚本不是一段源码，而是带 Schema、发布快照、依赖、日志和执行入口的脚本资产
• 多入口复用 — 管理台、REST API、CLI、Agent 共用同一脚本
• 仓库化协作 — 脚本、插件、AI 能力包可从仓库发现、安装、更新
• 项目知识解析 — 项目仓库可通过 repository resolve --repository-id 返回 ACTIONDOCK.md 原文，供后续检索
• 意图化资产发现 — 脚本、插件、仓库、知识源、Webhook、定时任务和 Playbook 的 list 命令支持 --intent <regex>，先收窄候选，未命中时自动回退全量列表
• Webhook仓库资产 — Webhook可连同配置模板和脚本依赖一起发布、安装
• AI 原生集成 — 脚本可暴露给 Agent，AI 辅助生成、诊断、Review
• 治理能力完整 — 内置配置值、共享状态、访问令牌、执行记录、定时任务、备份恢复
• 插件扩展 — 基于 PF4J，编写 Java 插件打包成 JAR 上传安装

核心数据流架构

创建/编辑脚本 (DRAFT)
       ↓ 校验
       ↓ 发布
已发布快照 (PUBLISHED, 不可变)
       ↓
┌──────────────────────────────────────────┐
│              执行入口                      │
│  ┌─────┐ ┌──────┐ ┌────┐ ┌──────┐ ┌──────┐ │
│  │ UI  │ │ REST │ │CLI │ │定时  │ │Webhook│ │
│  │运行 │ │ API  │ │运行│ │触发  │ │触发 │ │
│  └─────┘ └──────┘ └────┘ └──────┘ └──────┘ │
└──────────────────────────────────────────┘
       ↓
   脚本运行时
  ┌──────────────────────┐
  │ scripts.invoke()     │ ← 调用其他脚本
  │ plugins.invoke()     │ ← 调用插件 Action
  │ state.get/put/cas()  │ ← 读写共享状态
  │ log.info/warn/error()│ ← 输出执行日志
  │ config.get()         │ ← 读取配置值
  └──────────────────────┘
       ↓
   ExecutionRecord (执行记录，全链路审计)

快速开始

系统要求

JDK 21+ | Maven 3.9+（源码构建） | Node.js 18+（CLI） | Python 3.x（Python 脚本）

安装

# CLI 一键安装（推荐）
npm install -g actiondock
actiondock server

# 或从源码构建
git clone https://github.com/team4u/actiondock.git
cd action-dock
mvn -pl actiondock-app-spring -am -DskipTests spring-boot:run

验证

启动后访问 http://localhost:5177/admin/app/scripts

完整安装方式和第一个脚本教程请阅读 快速开始。

开发指引

后端开发

# 启动后端服务
mvn -pl actiondock-app-spring -am spring-boot:run

# 编译检查
mvn -pl actiondock-app-spring -am -DskipTests compile

# 运行测试
mvn test

前端开发

cd actiondock-admin-ui
npm ci
npm run dev       # 开发模式
npx tsc --noEmit  # 类型检查
npm run build     # 构建

文档

| 文档 | 说明 | |------|------| | 让脚本真正可复用 | 项目理念与核心能力介绍 | | 仓库与分发 | 能力仓库、项目仓库、ACTIONDOCK.md 知识入口 | | 项目知识库 | 项目知识从痛点到设计的完整链路 | | 任务手册 (Playbook) | 战术手册定位、与 Skill 的本质区别与 Agent 消费指南 | | 用户手册 | 完整文档入口 |

技术栈

• 后端：Java 21 · Spring Boot 3.3 · Groovy 4.0 · Python 3
• 前端：React 18 · Ant Design 5 · Monaco Editor
• 插件：PF4J 3.13
• CLI：Node.js (oclif)
• 存储：JPA / H2
• AI：OpenAI · Anthropic · Gemini · DashScope · Ollama

License

MIT