feat: harden boss local v1 runtime

README.md

@@ -6,7 +6,7 @@ Boss 是一个面向多设备开发协作的 agent control plane。
 
 ## 当前状态
 
-当前仓库已经完成第一轮产品设计文档：
+当前仓库已经包含产品设计文档与一版可直接跑起来的本地控制台：
 
 - [文档总览](./docs/README.md)
 - [竞品对比](./docs/competitor-comparison.md)
@@ -16,13 +16,14 @@ Boss 是一个面向多设备开发协作的 agent control plane。
 - [消息协议与状态机](./docs/message-protocol-and-state-machine.md)
 - [实施路线图](./docs/implementation-roadmap.md)
 
-并且已经补入首版可运行原型：
+当前原型能力：
 
 - Fastify API
 - 文件持久化状态存储
 - SSE 实时事件流
 - Web 控制台
 - `boss-worker` 模拟执行器
+- `boss-worker` 外部命令执行模式，可接本地 Codex / Claude / 自定义脚本
 - `npm run smoke` 自动跑端到端验证
 - `Dockerfile` + `compose.yaml` 支持容器启动
 
@@ -34,15 +35,6 @@ Boss 是一个面向多设备开发协作的 agent control plane。
 - 工具层：MCP
 - 调度：持久队列或工作流引擎
 
-## 下一步
-
-建议直接开始：
-
-1. 建立 Web 控制台和后端骨架
-2. 实现 `boss-worker` 注册与心跳
-3. 打通会话、任务树和子任务分发
-4. 接入审批和中途重规划
-
 ## 本地运行
 
 ```bash
@@ -62,6 +54,12 @@ http://127.0.0.1:43210
 npm run dev
 ```
 
+如果你想把数据写到独立文件，避免和默认 demo 数据混用：
+
+```bash
+BOSS_DATA_FILE=.boss-data/local-dev.json npm run dev
+```
+
 如果你要手工启动 worker：
 
 ```bash
@@ -70,6 +68,46 @@ npm run worker -- --name win-b --os windows --capability terminal --capability t
 npm run worker -- --name mac-a --os macos --capability terminal --capability test --capability browser
 ```
 
+如果你要接真实本地执行器，而不是模拟执行：
+
+```bash
+npm run worker -- \
+  --name mac-codex \
+  --os macos \
+  --capability terminal \
+  --capability test \
+  --mode command \
+  --workspace /path/to/project \
+  --executor ./scripts/codex_executor.sh
+```
+
+也可以接 Claude Code 或任意你自己的脚本，只要命令能从环境变量里读取任务上下文：
+
+- `BOSS_TASK_TITLE`
+- `BOSS_TASK_DESCRIPTION`
+- `BOSS_TASK_KIND`
+- `BOSS_TASK_JSON`
+- `BOSS_WORKSPACE`
+- `BOSS_WORKER_NAME`
+
+仓库里已经自带两个可直接改造的适配脚本：
+
+- `./scripts/codex_executor.sh`
+- `./scripts/claude_executor.sh`
+
+例如：
+
+```bash
+npm run worker -- \
+  --name win-claude \
+  --os windows \
+  --capability terminal \
+  --capability browser \
+  --mode command \
+  --workspace /path/to/project \
+  --executor ./scripts/claude_executor.sh
+```
+
 一键本地 demo：
 
 ```bash
@@ -100,6 +138,8 @@ docker compose up --build
 - 创建项目会话并持续对话
 - 自动生成任务树并调度到不同 worker
 - worker 心跳、掉线回收、任务重排
+- worker 真实外部命令执行，支持本地命令适配
 - 审批、暂停、恢复、取消、重排
 - SSE 实时事件流和 Web 控制台
+- 会话归档与恢复
 - 一键 demo 启动