开发指南

SSS-RUN 是一个面向 AI Agent 的企业运行时平台（Enterprise Agent Runtime），用于高效编写 UI 所需接口，覆盖 HTTP、WebSocket 等常见接入方式，支持多数据源管理与 API 编程。内置 AI 平台层，将全部能力自动暴露为 AI 可调用的 Tool，任意 LLM 可通过 OpenAI 兼容协议或 MCP 调用。

• 不是 ChatGPT，不是 Dify，是企业 AI 的执行层
• 单 EXE 零安装，默认 SQLite，支持国产数据库（达梦/人大金仓/南大通用/OpenGauss）
• AI 层零侵入，关闭后退回普通 API 平台

核心概念

概念	说明
接口	HTTP API 接口，通过编写 JS/Go 脚本处理请求并返回数据
函数	可复用的代码片段，支持 JS(Goja) 和 Go(Yaegi) 双引擎
页面	Vue SFC 动态编译页面，可快速构建管理界面
定时任务	基于 Cron 表达式的定时执行脚本
数据源	多数据库连接管理，支持 10 种数据库驱动
WebSocket	实时双向通信，支持房间、广播、状态存储、定时器、并发锁
AI Tool	接口/函数自动注册为 AI 可调用 Tool，支持 OpenAI/MCP 投影
Agent Runtime	ReAct 循环 + Tool Calling + 三层记忆 + RAG 知识库
WASM 插件	Ed25519 签名验证的插件沙箱，支持热重载和分类管理

快速开始

1. 下载

从 Releases 页面下载对应平台的可执行文件。

2. 运行

# 直接运行（交互模式）
./sss-run run

# 或直接执行
./sss-run

3. 访问

启动后打开浏览器访问 http://localhost:9301，使用配置文件中设置的用户名和密码登录。

运行方式

方式一：本地二进制

下载对应平台的可执行文件，直接运行即可：

# Linux / macOS
chmod +x sss-run
./sss-run run

# Windows
sss-run.exe run

方式二：Docker 容器

# 拉取镜像
docker pull sss-run:latest

# 运行容器
docker run -d \
  --name sss-run \
  -p 9301:9301 \
  -p 9302:9302 \
  -v ./data:/app/data \
  sss-run:latest

方式三：从源码构建

# 前端
cd web && npm ci && npm run build

# 后端
cd server && go build -ldflags="-s -w" -o sss-run .

目录结构

sss_run/
├── web/                    # 前端源码（Vue 3 + Vite）
├── server/                 # 后端源码（Go）
│   ├── config.yaml         # 配置文件
│   ├── go_mod/             # Yaegi 第三方模块
│   └── internal/
│       ├── ai/             # AI 平台层（Tool Registry/Agent/Runtime/RAG/Memory/Marketplace）
│       ├── controller/     # HTTP 控制器
│       ├── engine/         # 脚本引擎（Go + JS 双引擎）
│       ├── module/         # 功能模块（25+ 内置模块）
│       ├── mcp/            # MCP 协议支持
│       ├── plugin/         # WASM 插件运行时
│       └── store/          # 数据库存储层（10 种数据库）
├── press/                  # VitePress 文档站
├── Dockerfile              # 多阶段 Docker 构建
└── Makefile                # 构建/开发/发布命令

首次配置

首次运行前，可在 config.yaml 中修改以下配置：

• server.port — 服务端口，默认 9301
• sss.userName — 登录用户名
• sss.userPwd — 登录密码
• database.default — 默认数据库驱动，默认 sqlite

详细配置说明请参考 配置 页面。

AI 平台层

SSS-RUN 内置完整的 AI 平台层，位于 internal/ai/ 目录，零侵入设计——删掉该目录后平台退回普通 API 平台照常运行。

核心组件

组件	说明
Tool Registry	统一工具元数据注册表，自动扫描接口/函数注册为 Tool
LLM Gateway	多模型路由 + OpenAI 兼容端点 + Tool Calling 循环
Agent Runtime	ReAct 循环（Observe→Think→Act），支持 4 个预置 Agent 模板
Memory	三层记忆：短期（LRU）/ 工作（Session）/ 长期（SQLite 向量）
RAG	SQLite BLOB 存 embedding，纯 Go 余弦相似度检索
Marketplace	WASM 插件市场，Ed25519 签名验证，分类管理

支持的 LLM

OpenAI / Claude / DeepSeek / Qwen / Gemini / Ollama / ZhipuAI / Moonshot / MiniMax 及任何 OpenAI 兼容端点。

接入方式

• OpenAI 兼容协议 — /v1/chat/completions 带 tools
• MCP 协议 — stdio + SSE 传输，自动从 Registry 生成 Tool
• Dify / n8n / Cursor / Claude Desktop — 零改造接入

详见 AI 平台层 和 AI 接入示例。