# docs 目录说明

## 产品文档（核心）

- `L0-产品白皮书与能力全景层.md`：能力边界与目标价值。
- `L1-系统架构与安全模型层.md`：架构分层与安全决策。
- `L2-核心模块与接口契约层.md`：模块边界、接口设计与数据结构。
- `L3-数据流与Skill体系层.md`：执行流程、Skill 语义与数据协议。
- `L4-工程实现与部署拓扑层.md`：仓库结构、构建、集成和部署。
- `L5-提示词分布与安全改造方案.md`：提示词治理与风控增强策略。
- `浏览器对接标准.md`：Rust 与 Chromium 对接的协议基线。

当前运行时补充约定：

- `sgclaw` 在主线口径上应理解为“安全加固后的 zeroclaw runtime”，而不是浏览器侧 UI 产品，也不是 browser-only agent。
- 浏览器宿主与 pipe 协议提供的是受保护执行面；浏览器是重要工具与前端载体，但不是整个 runtime 的定义。
- 文档中提到 `planner fallback`、`compat runtime`、`browser_action only` 时，应优先理解为“当前实现状态/过渡态”，而不是长期产品边界。
- `sgclaw` 的浏览器侧配置文件为 `sgclaw_config.json`。
- `sgclaw` 负责解析模型配置与可选的 `skillsDir`。
- `skillsDir` 未设置时，默认回退到 `<workspace_root>/.sgclaw-zeroclaw-workspace/skills`。
- `skillsDir` 已设置时，支持直接指向 skills 目录，也支持指向包含 `skills/` 子目录的 skill repo 根目录。

## 归档文档

### 项目管理与排期（已归档）

以下文档已移入 `archive/项目管理与排期/`，保留历史参考，不作为产品主线阅读入口：

- `archive/项目管理与排期/团队分工.md`
- `archive/项目管理与排期/团队管理标准.md`
- `archive/项目管理与排期/协作时间表.md`
- `archive/项目管理与排期/协作甘特图.md`
- `archive/项目管理与排期/协作时间表_printable.md`
- `archive/项目管理与排期/协作甘特图_printable.md`
- `archive/项目管理与排期/sgclaw_project_team_kickoff.md`
- `archive/项目管理与排期/browser_team_kickoff.md`
- `archive/项目管理与排期/团队管理标准.pdf`

### 领导演示与导出资产

- `archive/领导演示资料/docs-html/`
- `archive/领导演示资料/docs-pdf/`
- `archive/领导演示资料/docs-figures/`
- `archive/领导演示资料/docs-scripts/`
- `archive/领导演示资料/frontend-pages/`
- `archive/领导演示资料/frontend-svgs/`

> 归档原则：产品主线文档与交付实现说明保持在 `docs/` 根目录；管理类资料与演示资料集中归档便于追溯。
