Record the parallel-duplication lesson, follow-ups, and startup config usage
Why: boot-config 重复交付事故须按 documentation.md 经验闭环沉淀:根因与 检查动作入经验条目、处置与后续项入过程记录;使用指南启动节仍是纯 CLI 旧文案,需反映已上线配置面(PR#4/PR#12)。 Evidence: 经验条目按 lesson 模板(candidate 状态、事故时间线与完整 SHA 回链);usage §1.3 与已合入实现实测一致(config explain 逐字段来源与 DSN 脱敏、serve --config envs/dev.json 落 data-dev)。 Impact: docs/records/ 新增 lesson-parallel-session-duplication 与 boot-config-followups 两条;docs/guides/usage.md §1.3 重写为四源合并 + 多环境启动说明;无代码影响。 Refs: Agent-System-Backend PR#4(66b4bbf5)与 PR#5(8270acf5,已关闭留 差异清单);本仓 PR#6(配置面设计);Agent-System-Dev PR#12(a58f85e)。
This commit is contained in:
+17
-3
@@ -28,16 +28,30 @@ make test # 全量测试
|
||||
make demo # 一键演示(构建 + mock 模式启动)
|
||||
```
|
||||
|
||||
### 1.3 启动
|
||||
### 1.3 启动与配置(配置文件 / 环境变量 / 命令行)
|
||||
|
||||
```bash
|
||||
agent-system serve [--addr 127.0.0.1:8787] [--data ./data] [--plugins ./plugins] [--mock]
|
||||
agent-system serve [--config envs/dev.json] [--addr 127.0.0.1:8787] [--data ./data] [--plugins ./plugins] [--mock]
|
||||
agent-system config explain [--config envs/prod.json] # 只读诊断:逐字段生效值与来源,DSN 脱敏
|
||||
agent-system version
|
||||
```
|
||||
|
||||
- `--data`:SQLite 数据库与工件对象目录(默认 ./data)。
|
||||
启动参数四源合并,优先级从低到高:**内置默认 → 配置文件(`--config`,显式 JSON,无自动发现)→ 环境变量(`AGENT_SYSTEM_ADDR/DATA/PLUGINS/DSN/ARTIFACTS/AUTH/MOCK`)→ 命令行**;未显式传入的命令行参数不参与覆盖,删除 override 恢复继承。字段:`addr`(监听)、`data`(工作区根目录)、`plugins`、`dsn`(空 = 嵌入式 SQLite 档,非空 = PostgreSQL 档)、`artifacts`、`auth`(auto/on/off)、`mock`;未知键与类型错误在启动时定位报错,不静默失效。
|
||||
|
||||
**多环境启动**——仓库自带隔离示例 `envs/{dev,test,prod}.json`(data 根与 DB 互不重叠):
|
||||
|
||||
```bash
|
||||
agent-system serve --config envs/dev.json # mock 开、./data-dev
|
||||
agent-system serve --config envs/test.json # 127.0.0.1:8788、./data-test
|
||||
agent-system serve --config envs/prod.json # PostgreSQL 档、auth on、独立卷
|
||||
AGENT_SYSTEM_CONFIG=/etc/agent-system.json agent-system serve # 环境变量定位文件
|
||||
```
|
||||
|
||||
- `--config`:显式配置文件(平面 JSON,键同上);单点覆盖仍可用 `--addr`/`--dsn` 等同名参数压过文件。
|
||||
- `--data`:工作区根目录(SQLite 数据库与工件对象目录;默认 ./data)。
|
||||
- `--plugins`:插件目录(声明资产热加载,见 §6)。
|
||||
- `--mock`:演示模式——不调用任何模型,按脚本回放完整交互(首次体验推荐)。
|
||||
- 模型、检索、限流等**运行时设置**在设置页(§2),属业务策略层,不进启动配置文件——设计边界与实例隔离约定见[配置面设计](../proposals/2026-09-30-configuration-surface.md)。
|
||||
|
||||
浏览器打开 `http://127.0.0.1:8787` 即三栏工作台(开发期前端热更新:Dev 仓 `make dev`)。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user