# sgClaw

sgClaw 项目仓库。

## 当前工程形态

- `src/`：Rust 侧最小 Agent 实现，包含 pipe 协议、握手、`BrowserPipeTool`、规则规划器、DeepSeek provider、最小 Agent runtime。
- `tests/`：协议、握手、工具、规划器、runtime 与 JSON Line 联调测试。
- `resources/rules.json`：本地安全策略白名单。
- `docs/`：产品主线文档（架构、实现、交付、接口）与归档入口。
- `frontend/archive/sgClaw验证-已归档/`：历史本地验证页面与脚本（归档，仅做参考）。

## 常用命令

```bash
cargo test
cargo test --test planner_test -q
cargo test --test agent_runtime_test -q
node --test tools/browser_smoke/fake_deepseek_server.test.mjs
node tools/browser_smoke/run_deepseek_browser_smoke.mjs
cargo run
bash frontend/archive/sgClaw验证-已归档/serve.sh
```

## 浏览器侧 DeepSeek smoke

在已经可用的 SuperRPA 浏览器构建目录上，可以通过下面的组合验证浏览器侧 `sgclaw` 是否真的走了 ZeroClaw/DeepSeek compat runtime，而不是回退到本地 planner：

```bash
python3 /home/zyl/projects/superRpa/src/chrome/browser/superrpa/sgclaw/build_sgclaw.py \
  --manifest-path /home/zyl/projects/sgClaw/claw/.worktrees/zeroclaw-core-refactor/Cargo.toml \
  --out /home/zyl/projects/superRpa/src/out/KylinRelease/sgclaw

node tools/browser_smoke/run_deepseek_browser_smoke.mjs
```

该 wrapper 会：
- 启动本地 fake DeepSeek 服务
- 注入 `DEEPSEEK_API_KEY` / `DEEPSEEK_BASE_URL` / `DEEPSEEK_MODEL`
- 调用现有 `/home/zyl/projects/superRpa/src/chrome/browser/superrpa/sgclaw/sgclaw_chat_smoke.mjs`
- 在 smoke 通过后，再额外确认 fake 服务确实收到了百度和知乎两组 provider 请求
