# @agentworkforce/sage 中文文档

规范地址：https://npmcn.com/package/%40agentworkforce/sage/

版本：1\.5\.41
npm 元数据更新时间：2026-05-14T21:45:59.570Z
中文译文更新时间：2026-11-09T21:06:30.136Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agentworkforce/sage
原文对照：https://npmcn.com/package/%40agentworkforce/sage/?lang=original
项目主页：https://github.com/AgentWorkforce/sage#readme
源码仓库：https://github.com/AgentWorkforce/sage

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.6 MB，756 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：30 个
- 首次发布：2026-04-09T20:58:13.572Z
- 最新版本发布：2026-05-14T21:45:59.439Z
- 近 30 天下载量：1730（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：90（近 12 个月 90 个）

## 中文简介

研究,澄清,计划。 将分散的对话转化为可执行开发工作流程的AI代理.

## 安装

```sh
npm install @agentworkforce/sage
```

也可以使用：`pnpm add @agentworkforce/sage`、`yarn add @agentworkforce/sage`、`bun add @agentworkforce/sage`

## README

# 贤人

研究,澄清,计划。 将分散的对话转化为可执行开发工作流程的AI代理.

圣贤是 **计划** 阶段 [佩德罗](https://pdero.com/) (计划,代表,执行,审查,央视). 它观察团队对话、跨越整合的研究、提出澄清问题并制订结构化计划,成为接力工作流程定义.

## 如何运作

你个 `@sage` 在 Slack (V2 中的WhatsApp 和 Telegram) 中。 贤曰:

1.  **研究** 搜索网络和您的 GitHub 重置上下文
2.  **澄清** ——在跳出解决方案前提出探查问题
3.  **记得** ——通过Supermemory进行的对话持续记忆
4.  **计划** (V3)——将一切合成可执行中继工作流程

## 建筑

### V1 (当前)

单代理Slack Webhook服务器,具有网页搜索和GitHub集成功能.

```
Slack Events API → Hono server → Sage agent (Sonnet 4.6) → Slack response
                                    ├── OpenRouter (web search)
                                    ├── GitHub (via Nango)
                                    └── Supermemory (persistent memory)
```

### 五. 2级

多平台(Slack + WhatsApp + Telegram),由多剂组通过车盖下 `@agent-relay/gateway`。 。 。 .

### 五.3

全面规划管线. 规划代理 (Opus 4.6) 将上下文合成结构化的计划并生成可执行接力工作流程定义.

## 设置

### 先决条件

-   节点.js 20+
-   [代理转发](https://github.com/AgentWorkforce/relay) 已安装 CLI
-   Slack 应用程序( Events API, 不是 Socket 模式)
-   GitHub 整合的南戈账户
-   OpenRouter API 密钥
-   超模 API 密钥

### 1\. 安装依赖关系

```bash
npm install
```

### 2\. 配置环境

```bash
cp .env.example .env
```

填写:

| 变量 | 来源 | 目的 |
| --- | --- | --- |
| `OPENROUTER_API_KEY` | [开口/钥匙](https://openrouter.ai/keys) | Sonnet 4.6+网络搜索 |
| `SUPERMEMORY_API_KEY` | [超级记忆.ai](https://supermemory.ai/) | 持续记忆 |
| `SLACK_BOT_TOKEN` | Slack app – OAuth 和权限 | 瓶子身份( xoxb- ) |
| `SLACK_SIGNING_SECRET` | Slack app – 基本信息 | Webhook 校验 |
| `NANGO_SECRET_KEY` | [app.nango.dev (英语)](https://app.nango.dev/) — 设置 | Nango API 访问权 |
| `NANGO_GITHUB_CONNECTION_ID` | app.nango.dev – 连接 | 您的 GitHub 连接 |
| `SAGE_WORKSPACE_ID` | 您选择( 如“ 默认 ” ) | 内存命名空间 |
| `PORT` | 可选( 默认: 3000) | 服务器端口 |

### 3\. 创建 Slack 应用程序

1.  转到 [api.slack.com/应用程序](https://api.slack.com/apps) 从零开始创建新 App
2.  **OAuth 权限( C)** - 瓶子范围:
    -   `app_mentions:read`
    -   `chat:write`
    -   `channels:history`
    -   `channels:read`
3.  安装到工作区 — 复制 Bot Token
4.  **基本情况** - 复制签名秘密
5.  **事件订阅** 启用 + 订阅机器人事件 : `app_mention`
6.  将请求 URL 设定为您的公共 URL + `/api/webhooks/slack`

### 4\. 在当地运行

```bash
npm run dev          # Starts Hono server on :3000
ngrok http 3000      # Expose webhook URL for Slack
```

将 ngrok URL 粘入 Slack 事件订阅为请求 URL :

```
https://your-ngrok-id.ngrok.io/api/webhooks/slack
```

### 5\. 运用

提及 `@sage` 在任何Slack通道中:

-   "Node.js最好的队列库是什么?" ^ 网页搜索+综合
-   (原始内容存档于2013-10-12)
-   "我想加入实时通知" ——在规划前澄清问题
-   回到同一个线 稍后 圣人记得背景

## 以工作流程构建

Sage通过接力工作流程来构建. 从零开始重建:

```bash
bash workflows/run-v1.sh      # Build V1 (~80 min)
bash workflows/run-v2.sh      # Build V2 (~130 min)
bash workflows/run-v3.sh      # Build V3 (~125 min)
bash workflows/run-all.sh     # Build everything (~5.5 hours)
```

见 [工作流程/波浪计划](https://npmcn.com/package/%40agentworkforce/sage/workflows/wave-plan.md) 完全执行计划.

## 项目结构

```
src/
├── server.ts              # Hono HTTP server — webhook entry point
├── slack.ts               # Slack signature verification + event parsing
├── openrouter.ts          # OpenRouter client (Sonnet 4.6 + web search)
├── memory.ts              # Supermemory persistence layer
├── prompt.ts              # Sage system prompt / persona
├── nango.ts               # Nango client wrapper
└── integrations/
    ├── types.ts            # Shared integration types
    └── github.ts           # GitHub search, file read, PR diff via Nango
```

## PDERO 的一部分

| 阶段 | 探员 | 作用 |
| --- | --- | --- |
| **计划** | **贤人** (这个回放) | 研究、澄清、计划 |
| 代表+执行 | [梨树](https://github.com/AgentWorkforce/pear) | 代理管弦乐图形界面 |
| 审查 | [MSD 软件](https://github.com/AgentWorkforce/msd) + 键 [轨迹](https://github.com/AgentWorkforce/trajectories) | 守则审查+决定记录 |
| 观察 | [夜视](https://github.com/AgentWorkforce/nightcto) | AI CTO 通讯 |
| 通讯 | [代理中继](https://github.com/AgentWorkforce/relay) | 代理通讯 |

## 常见问题

### @agentworkforce/sage 是什么？

研究,澄清,计划。 将分散的对话转化为可执行开发工作流程的AI代理\.

### 如何安装 @agentworkforce/sage？

在项目目录运行 npm install @agentworkforce/sage，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 sage-vfs，可以用 npx sage-vfs 直接运行。

### @agentworkforce/sage 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @agentworkforce/sage 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @agentworkforce/sage 可以商用吗？

@agentworkforce/sage 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @agentworkforce/sage 的下载量有多少？

根据 npm 官方下载统计，@agentworkforce/sage 在 2026/10/05 – 2026/11/03 这 30 天内被下载 1,730 次，日均约 58 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @agentworkforce/sage 还在维护吗？

最新版本 1\.5\.41 发布于 2026/05/15（5 个月前）；至今共发布 90 个版本，其中过去 12 个月发布了 90 个；首次发布于 2026/04/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。