# one-sim-clean **Repository Path**: violent_sniper/one-sim-clean ## Basic Information - **Project Name**: one-sim-clean - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-16 - **Last Updated**: 2026-11-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # One-Sim 本仓是 One-Sim 的公共底座与系统集成仓,保存共享服务、Python 包、浏览器模块、统一启动/部署与测试工具,以及跨系统设计和版本锁定清单。 外层 `one-sim/` 是非 Git 工作区,四个 Git 仓平级: ```text one-sim/ # 工作区容器,无 .git ├── one-sim/ # 本仓,含自己的 .git │ ├── src/ # one_sim_auth / one_sim_data / one_sim_records │ ├── modules/ # 跨系统共享前端 │ ├── lobby/ # 房间服务 │ ├── scripts/、tests/、docs/ │ └── workspace.repos.yaml ├── ai-planning/ # 独立决策与训练仓 ├── wargame/ # 独立仿真执行仓 ├── data_lake/ # 独立契约与资产仓 ├── config/ # 已有本机数据根绑定 ├── runtime/、output/ # 已有运行态与输出 └── devtools/ # 本机开发工具,独立管理 ``` ## 获取工作区 三个业务仓与本仓平级,不作为子模块嵌入。先将本仓克隆到工作区的 `one-sim/` 子目录,再从外层执行: 首次获取(或补齐缺失仓库): ```powershell pwsh one-sim/scripts/bootstrap-workspace.ps1 -Init ``` 校验当前工作区是否与锁定版本一致: ```powershell pwsh one-sim/scripts/bootstrap-workspace.ps1 ``` 锁定清单见 [`workspace.repos.yaml`](workspace.repos.yaml)。其中 `workspace_root: ..` 从本仓定位外层工作区,仓库路径均相对此工作区。更新独立仓版本后,按发布流程同步 `revision`。`-Init` 还从本仓模板生成外层 Docker 构建忽略规则,已有自定义文件会被保护。 | 仓库目录 | 职责 | 远程仓库 | 锁定分支 | | --- | --- | --- | --- | | `ai-planning/` | 任务规划、智能体和训练 | `https://gitee.com/AI_DNA/ai-planning.git` | `main` | | `data_lake/` | 跨模块结构、规则、想定与资产契约 | `https://gitee.com/violent_sniper/data-lake.git` | `master` | | `wargame/` | 仿真执行、观察与裁决 | `https://gitee.com/violent_sniper/unity_wargame.git` | `master` | 根仓不复制上述仓库的 Git 历史或文件内容。`data_lake/` 是唯一规范磁盘拼写;`data-lake` 仅保留为 CodeGraph 领域标签与历史拼写,运行时解析仍兼容旧拼写,但工作区不再创建该别名目录。 ## 文档 正式设计文档在 [docs/README.md](docs/README.md): - [`../ai-planning/docs/`](../ai-planning/docs/README.md):AI Planning 的模块设计。 - [`../wargame/docs/`](../wargame/docs/README.md):Wargame 的模块设计。 - `docs/design-overview/index.html`:两个系统共用的离线设计门户。 从外层使用统一入口: ```powershell & ./wargame/.venv/Scripts/python.exe ./one-sim/tests/run.py --list pwsh ./one-sim/scripts/start-design-center.ps1 ``` ```bash bash one-sim/scripts/dev.sh start all docker compose -f one-sim/docker-compose.yml config ``` 在本仓内部仍可运行 `python tests/run.py` 和 `bash scripts/dev.sh`。源码定位统一使用 `one_sim_data.workspace`,区分工作区根、集成仓根与数据根;已有外置数据绑定继续由 `one_sim_data.layout` 管理。 ## 不进入根仓的本机内容 运行输出、虚拟环境、本机配置和大体积 CAD/媒体资产由 `.gitignore` 排除。它们不是代码同步的权威来源,按各自部署或资产流程获取。 `src/one_sim_auth`、`src/one_sim_data`、`src/one_sim_records` 属于本仓。外层已有运行态、历史材料、本机工具及各业务仓 storage/output/runtime 原位保留;正式数据根不会因源码布局变化而重新建立或切换。