✦ AI 驱动 · Spec 驱动开发

Sage

基于 Claude Code 的原生桌面开发平台,把 AI 编码能力封装成 结构化、可审批、可追溯的工程化工作流,并提供公网中继让 AI 触达企业微信 / 钉钉 / 飞书。

进入管控后台 → 查看部署指南
在线客户端
客户端 Token
24h Webhook 请求
服务运行时长
Core Capabilities

核心能力

从需求到交付的完整 AI 工程化闭环

📋

Spec 驱动工作流

Requirements → Design → Tasks → Execute,每一步可审批、可编辑、可带反馈重生成。大功能拆成小任务逐步落地,杜绝 AI 一次性失控。

结构化开发
💬

对话式编程

直接和 Claude Code 聊天:工具调用审批、图片粘贴、Markdown 渲染、富文本复制。定时任务也能通过自然语言对话维护。

Chat Mode

定时任务

用一句话创建定时任务("每天 9 点检查代码质量"),到点自动运行并把结果保存为对话,支持自然语言修改调度与指令。

Scheduler
📡

渠道接入(Relay)

通过本服务把企业微信 / 钉钉 / 飞书的回调透传到本地客户端,AI 实时响应外部消息并回复,无需公网 IP。

本服务
🔄

Loop 自主迭代

设定目标后让 AI 自主"执行 → 评估 → 改进"循环迭代,支持命令 / LLM 双评估策略、人工检查点与超时控制。

Autonomous
📚

项目 Wiki / Steering

自动生成项目 Wiki 文档;Steering 文档(产品/技术栈/结构)自动注入每次生成,避免重复解释项目背景。

Context
Workflow

Spec 工作流

把"一句话需求"变成"可执行的任务清单",全程人在回路

1

描述需求

新建 Spec,用自然语言描述你想做什么。

2

生成需求文档

AI 生成 requirements.md(用户故事 + 验收标准),你审批或修改。

3

生成设计文档

生成 design.md(架构、接口、风险评估),你审批或修改。

4

拆分任务

生成 tasks.md(拆分成小任务),你审批或修改。

5

一键执行

按任务顺序逐个落地,进度可视化,失败可单任务重试。

Security

双 Token 安全模型

连接凭证与回调凭证职责分离,最小化泄露影响面

sgr_ Client Token

客户端 WebSocket 连接凭证,同时可登录管控后台管理自己。只存在于客户端本地,不对外暴露。泄露后仅 admin 可重置。

whk_ Webhook Token

对外配置给渠道的回调 URL 凭证。即使泄露也只能投递回调,无法建立连接或登录后台。客户端可自行在后台重置,旧回调地址立即失效。

adm_ Master Admin Token

部署者持有,可颁发 / 启停 / 删除所有客户端、重置 Client Token、查看全局统计与所有日志。

🔐 其他防护

未知 token 探测记入隔离日志;调试日志按 token 单独存放、可开关;所有凭证 128 位熵强随机生成;多客户端按 token 天然隔离。

Architecture

架构:本地无公网 IP 也能接外部回调

客户端主动外连(出站连接,任何网络环境都能建立),中继把 webhook 透传下去

📱 企业微信 / 钉钉 / 飞书
POST https://relay/<webhookToken>/<渠道路径>
🛰 sage-relay(本服务 · 公网)
多客户端隔离 · 管控后台 · 日志聚合
WebSocket 长连接(客户端主动外连 + 自动重连 + 心跳)
💻 Sage 客户端 A(本地)
💻 Sage 客户端 B(本地)
💻 Sage 客户端 C(本地)
客户端处理消息 → AI 响应 → 响应原样回传给外部平台
Deploy

快速部署

单文件 Node.js 服务,仅依赖 ws,支持一键脚本 / 手动 / Docker

🚀 一键安装(推荐)

# 传到服务器后执行
sudo bash install.sh relay.example.com
# 自动装 Node + systemd
# + Caddy HTTPS 证书

🐳 Docker

docker build -t sage-relay .
docker run -d --restart always \
  -p 8080:8080 \
  -e ADMIN_TOKEN=*** \
  -v relay-data:/app/data \
  sage-relay

🛠 手动运行

npm install
PORT=8080 \
ADMIN_TOKEN=*** \
node server.js

开始使用

登录管控后台颁发客户端 Token,或在 Sage 客户端设置中连接本中继

管控后台 → 健康检查