44
55Senclaw 是一个 AI Agent 编排平台,具备持久化存储、API Key 鉴权、Web Console、连接器接入、任务调度以及沙箱化工具执行能力。
66
7- 当前代码库功能已经比较完整,仓库门禁也已在本地恢复为绿色 。截止 2026 年 3 月 12 日,最新一次 Windows 本地验证中, ` build ` 、 ` test ` 、 ` test:integration ` 和 ` verify ` 均已通过 。RabbitMQ 与 Redis Streams 队列驱动已经在仓库内实现,并带有单元测试覆盖和默认 gateway 接线,但基于真实 broker 的发布级验证证据仍待补齐。与此同时,项目也已经记录了真实 OpenAI-compatible provider 的 smoke 结果,因此当前剩余的基础上线工作主要收敛为:在 Node 22 环境复验,以及补齐受保护 Web Console 的验收记录 。
7+ 当前代码库功能已经比较完整,仓库门禁在本地也已恢复为绿色 。截止 2026 年 3 月 16 日,Windows 基线 go-live gate 已完成闭环,包含 Node 22 复验和浏览器级受保护 Web Console 验收 。RabbitMQ 与 Redis Streams 队列驱动已内置实现,并具备单元测试覆盖与默认 gateway 接线,但真实 broker 的发布级证据仍待补齐 。
88
99## 就绪度快照
1010
11- 截至 2026 年 3 月 12 日的最新本地证据 (Windows, Node ` v20.11.0 ` ,因此会出现 engine warning ):
11+ 最新本地证据记录于 2026 年 3 月 16 日 (Windows 基线使用便携式 Node ` v22.22.1 ` 复验 ):
1212
1313- ` pnpm run build ` :通过
14- - ` pnpm run test ` :通过(` 36 ` 个测试文件,` 225 ` 个测试)
15- - ` pnpm run test:integration ` :通过(` 6 ` 个测试文件,` 20 ` 个测试)
14+ - ` pnpm run test ` :通过(` 46 ` 个测试文件,` 267 ` 个测试)
15+ - ` pnpm run test:integration ` :通过(` 6 ` 个测试文件,` 20 ` 个测试),另有一个 opt-in live-broker suite( ` 1 ` 个文件,未配置 broker 环境时 ` 4 ` 个跳过)
1616- ` pnpm run verify ` :通过
1717
1818当前支持的开发平台:
1919
2020- Windows
2121- Linux
2222
23- 当前阻塞项和各子系统状态详见 [ PRODUCTION_READINESS.md] ( ./PRODUCTION_READINESS.md ) 。
23+ 当前阻塞项与各子系统状态请查看 [ PRODUCTION_READINESS.md] ( ./PRODUCTION_READINESS.md ) 。
2424
2525## 仓库结构
2626
@@ -51,7 +51,7 @@ Packages:
5151- 可用于 ` SENCLAW_DB_URL ` 的 SQLite 文件系统访问权限
5252- 可选:Rust 工具链,用于原生沙箱验证(` native/sandbox-runner ` )
5353
54- 当前这台机器使用的是 Node ` v20.11.0 ` ,所以命令虽然能跑通,但会出现 engine warning。要进行受支持的本地验证和 CI 验证,请使用 Node 22+。
54+ 这台机器当前默认安装仍是 Node ` v20.11.0 ` ,所以直接运行命令时会有 engine warning;若要按支持矩阵执行本地与 CI 验证,应使用 Node 22+。项目的支持运行时门禁已经通过便携式 Node ` v22.22.1 ` 在本地完成复验 。
5555
5656## 快速开始
5757
@@ -65,7 +65,7 @@ corepack pnpm install
6565
6666# 配置环境变量
6767copy .env.example .env
68- # Linux 上使用 :cp .env.example .env
68+ # Linux 使用 :cp .env.example .env
6969
7070# 构建整个 workspace
7171corepack pnpm run build
@@ -116,19 +116,19 @@ scripts\stop-senclaw.cmd
116116- gateway 地址
117117- 运行日志目录
118118
119- Web Console 头部右上角提供 ` EN / 中文 ` 语言切换按钮。所选语言会持久化,并分别作用于:
119+ Web Console 头部包含 ` EN / 中文 ` 语言切换按钮。所选语言会持久化,并分别作用于:
120120
121- - 当前浏览器里的 Web Console 文案
121+ - 当前浏览器中的 Web Console 文案
122122- 下一次启动脚本运行时的终端输出文案(通过 ` .tmp/live-run/runtime-settings.json ` )
123123
124- 如果你已经在仓库根目录的 Windows ` cmd ` 里 ,也可以直接使用更短的命令:
124+ 如果你已经在仓库根目录的 Windows ` cmd ` 中 ,也可以直接使用更短的命令:
125125
126126``` bat
127127senclaw start
128128senclaw stop
129129```
130130
131- 这个包装器会转发到 ` packages/cli ` 里的本地 CLI,行为和启动脚本一致 。
131+ 这个包装器会转发到 ` packages/cli ` 中的本地 CLI,行为与启动脚本一致 。
132132
133133## 鉴权
134134
@@ -140,11 +140,11 @@ senclaw stop
140140corepack pnpm run auth:bootstrap-admin
141141```
142142
143- Web Console 当前支持轻量级 API Key session。使用 agents、runs 或 task 提交等受保护页面前,需要先在页面头部粘贴 Bearer token。
143+ Web Console 当前支持轻量级 API Key session。在使用 agents、runs 或 task 提交等受保护页面前,需要先在页面头部粘贴 Bearer token。
144144
145145## 真实 Provider Smoke 测试
146146
147- Senclaw 提供了一条不把密钥写入仓库的 OpenAI-compatible provider smoke 路径。先在本地设置以下环境变量:
147+ Senclaw 提供了一条不会把密钥写入仓库的 OpenAI-compatible provider smoke 路径。先在本地设置以下环境变量:
148148
149149``` bash
150150SENCLAW_OPENAI_API_KEY=< 你的 key>
@@ -161,7 +161,7 @@ SENCLAW_SMOKE_TIMEOUT_MS=60000
161161corepack pnpm run test:provider-smoke
162162```
163163
164- 这个脚本会走真实的 gateway 和 agent runtime 流程,创建一个临时的 ` provider: openai ` agent,提交任务,等待执行完成,并打印 assistant 回复或可诊断的 provider 错误。2026 年 3 月 12 日,这条 smoke 路径已经在 Volcengine Ark OpenAI-compatible endpoint 上用 ` doubao-seed-2.0-pro ` 验证过 ,返回结果为 ` OK ` 。
164+ 该脚本会走真实的 gateway 和 agent runtime 流程,创建一个临时的 ` provider: openai ` agent,提交任务,等待执行完成,并输出 assistant 响应或可诊断的 provider 错误。2026 年 3 月 12 日,这条 smoke 路径已在 Volcengine Ark OpenAI-compatible endpoint 上使用 ` doubao-seed-2.0-pro ` 完成验证 ,返回结果为 ` OK ` 。
165165
166166## 验证命令
167167
@@ -172,7 +172,7 @@ corepack pnpm run test:integration
172172corepack pnpm run verify
173173```
174174
175- 当前对外发布声明应以这四条命令全部通过为前提。当前剩余的基础上线收尾工作,是在 Node 22 上重新跑一遍,以及补齐受保护 Web Console 的验收记录 。
175+ 当前所有发布声明都应以这四条命令全部通过为前提。Windows 基线签收已经完成,剩余发布工作只限于可选的 broker-backed queue 验证和 Linux 原生沙箱验证 。
176176
177177## 关键文档
178178
@@ -184,12 +184,10 @@ corepack pnpm run verify
184184
185185## 当前缺口
186186
187- 项目从“本地全绿 ”到“可以正式宣称部署就绪 ”之间,还剩这些事项 :
187+ 当前从“本地已绿 ”到“完全可对外宣称为生产就绪 ”之间,剩余的是 :
188188
189- - 在受支持的 Node 22 环境中重跑一遍 readiness matrix
190- - 记录一次开启鉴权后的 Web Console 验收
191- - 如果要对外宣称 broker-backed queue 已具备发布级支持,则需要补齐 RabbitMQ 和 Redis 的真实 broker 验证
192- - 如果要对外宣称 level 4 native enforcement,则需要补齐 Windows 和 Linux 上基于证据的 Rust 沙箱验证
189+ - 在宣称 broker-backed queue 达到发布级支持前,补齐 RabbitMQ 与 Redis 的真实 broker 验证
190+ - 如果要在所有支持平台上宣称 level 4 native enforcement,补齐 Linux 上基于证据的 Rust 原生沙箱验证
193191
194192## 仓库地址
195193
0 commit comments