docs: redefine sgclaw as hardened zeroclaw runtime

docs/L4-工程实现与部署拓扑层.md

@@ -44,7 +44,7 @@ claw/
     └── archive/
 ```
 
-工程上应把 `third_party/zeroclaw` 理解为“已 vendored 的兼容依赖”，而不是单独维护的兄弟项目。
+工程上应把 `third_party/zeroclaw` 理解为“已 vendored 的能力核心”，而不是单独维护的兄弟项目，也不是只用于兼容的附属依赖。
 
 ---
 
@@ -83,10 +83,15 @@ claw/
 
 职责：
 
-- 决定 fallback 或 compat 执行。
-- 把统一工具契约映射到浏览器协议。
+- 当前决定 fallback 或 compat 执行。
+- 把受保护的浏览器工具契约映射到浏览器协议。
 - 在 ZeroClaw turn 事件与宿主日志之间做桥接。
 
+说明：
+
+- `src/agent/runtime.rs` 与 `src/agent/planner.rs` 属于过渡性轻量路径，不应再被写成长期产品主线。
+- 主线目标应是“sgClaw security layer + zeroclaw core runtime”，而不是长期保留 browser-only compat 分叉。
+
 ### 2.4 安全与配置
 
 - [`src/security/mac_policy.rs`](/home/zyl/projects/sgClaw/claw/src/security/mac_policy.rs)
@@ -96,7 +101,7 @@ claw/
 职责：
 
 - 维护运行时安全边界。
-- 从环境变量读取 provider 配置。
+- 读取 provider / skills 等运行时配置，并逐步向 zeroclaw-first 配置模型收敛。
 
 ---
 
@@ -130,7 +135,7 @@ sgClaw 不是独立交互式 CLI 产品，正常运行前提是：
 
 ### 3.3 模型配置
 
-启用 ZeroClaw compat runtime 的关键环境变量：
+当前启用 ZeroClaw compat runtime 的关键环境变量：
 
 ```bash
 DEEPSEEK_API_KEY=...
@@ -138,7 +143,31 @@ DEEPSEEK_BASE_URL=...
 DEEPSEEK_MODEL=...
 ```
 
-若这些变量不存在或不完整，系统会退回 planner fallback。
+若这些变量不存在或不完整，系统会退回 planner fallback。这个行为是当前实现状态，不是长期架构推荐。
+
+### 3.4 浏览器配置文件
+
+当宿主以 `--config-path=<workspace_root>/sgclaw_config.json` 拉起 `sgclaw` 时，`sgclaw` 会自己读取该 JSON 文件，而不是要求宿主额外复制 skills。
+
+当前支持的关键字段：
+
+```json
+{
+  "apiKey": "sk-...",
+  "baseUrl": "https://api.deepseek.com",
+  "model": "deepseek-chat",
+  "skillsDir": "skill_lib"
+}
+```
+
+说明：
+
+- `skillsDir` 可省略。
+- 若省略，则默认使用 `<workspace_root>/.sgclaw-zeroclaw-workspace/skills`。
+- 若为相对路径，则相对于 `sgclaw_config.json` 所在目录解析。
+- 若指向某个 skill repo 根目录，且其下存在 `skills/` 子目录，运行时会自动落到该 `skills/` 目录。
+- 因此 SuperRPA 侧只需要负责传递 `--config-path`，skill 查找策略由 `sgclaw` 自己控制。
+- 长期看，这个文件应表达 zeroclaw-first 的 runtime/profile/tool policy 配置，而不仅是 provider shim。
 
 ---
 
@@ -165,7 +194,7 @@ DEEPSEEK_MODEL=...
 cargo test
 ```
 
-这组测试表达了一个重要工程事实：当前系统的稳定核心是协议、runtime 选择和 compat 适配，而不是旧版前端验证页。
+这组测试表达了一个重要工程事实：当前系统的稳定核心是协议、安全边界、runtime 选择和 zeroclaw 接入，而不是旧版前端验证页。
 
 ---
 
@@ -220,4 +249,4 @@ sgclaw binary
 L4 层面的核心结论只有两点：
 
 1. 本仓库已经从“带演示页的杂糅目录”收敛为“Rust Runtime + 协议文档 + 测试”的内核仓库。
-2. ZeroClaw 重构后的工程重点，是保证 compat runtime、fallback runtime、浏览器协议三者在同一 contract 上工作。
+2. ZeroClaw 重构后的工程重点，是把工程形态从“browser-first compat”收口为“zeroclaw-first runtime + sgClaw security envelope”，同时保持浏览器协议稳定。