Skip to content

Commit c197706

Browse files
committed
Refresh Chinese README
1 parent 505bbc7 commit c197706

1 file changed

Lines changed: 18 additions & 20 deletions

File tree

README.zh-CN.md

Lines changed: 18 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -4,23 +4,23 @@
44

55
Senclaw 是一个 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 日的最新本地证据(WindowsNode `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
# 配置环境变量
6767
copy .env.example .env
68-
# Linux 上使用:cp .env.example .env
68+
# Linux 使用:cp .env.example .env
6969

7070
# 构建整个 workspace
7171
corepack 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
127127
senclaw start
128128
senclaw stop
129129
```
130130

131-
这个包装器会转发到 `packages/cli` 里的本地 CLI,行为和启动脚本一致
131+
这个包装器会转发到 `packages/cli` 中的本地 CLI,行为与启动脚本一致
132132

133133
## 鉴权
134134

@@ -140,11 +140,11 @@ senclaw stop
140140
corepack 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
150150
SENCLAW_OPENAI_API_KEY=<你的 key>
@@ -161,7 +161,7 @@ SENCLAW_SMOKE_TIMEOUT_MS=60000
161161
corepack 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
172172
corepack 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

Comments
 (0)