61 lines
4.0 KiB
Markdown
61 lines
4.0 KiB
Markdown
# Agent Workbench
|
|
|
|
面向 AI 项目协作的 skill、局域网看板与会话桥接。一个总控协调多个工作包，一个独立沟通会话供人类询问进度、接收汇报和决定方案。
|
|
|
|
看板分为 **总览、任务、集群、沟通、决策** 五页。前端基于随仓库维护的 React、TypeScript、Vite、Tailwind 和官方 shadcn/ui 模板，固定配色与组件规范，AI 在已有模板上组合功能。
|
|
|
|
协调服务使用 Python 标准库和本地 SQLite，保存任务、消息、事件与会话映射。AI 可以留在已登录的本机运行；服务与监控部署在获准集群，不需要向集群复制模型凭据。沟通页绑定真实会话，消息排队和历史镜像使用受支持的宿主接口。
|
|
|
|
## 准备和启动
|
|
|
|
需要 Python 3.9+、Node.js 22+，以及支持相关命令的 Codex。先核实环境与授权，再构建前端：
|
|
|
|
```sh
|
|
cd assets/dashboard
|
|
npm ci
|
|
npm run build
|
|
cd ../..
|
|
python3 -m unittest discover -s tests -v
|
|
```
|
|
|
|
在获准 Linux 服务账号下初始化任务自有运行目录（默认示例仅监听本机）：
|
|
|
|
```sh
|
|
python3 scripts/setup.py --repo "$PWD" \
|
|
--runtime "$HOME/.local/state/agent-workbench" \
|
|
--bind 127.0.0.1 --port 8796 --hostname localhost
|
|
python3 -m agent_control.server --config "$HOME/.local/state/agent-workbench/config.json"
|
|
```
|
|
|
|
初始化创建私有配置和随机访问令牌；程序只打印令牌文件路径。浏览器登录时使用该令牌，勿把它放进 URL 或提交到 Git。局域网部署时显式选择已核实的内网 IPv4 和域名；不自动更改网络、防火墙或公网入口。
|
|
|
|
可选 `--install-user-service --start` 仅安装当前账号自己的 `agent-workbench.service`。不会使用 sudo；用户服务退出登录后是否持续运行取决于主机已有配置。运行数据库应在本地盘，不能放在 NFS。
|
|
|
|
## 安装 skill 与连接会话
|
|
|
|
```sh
|
|
python3 scripts/install_skill.py --source "$PWD"
|
|
```
|
|
|
|
然后在 agent 中使用 `$project-agent-control`。skill 会先核对项目规则、已有会话和权限，默认将当前会话映射到网页，再按需求拆分工作包。只有用户要求专门沟通入口时才创建或复用独立会话。创建 ChatGPT 项目/用户可见会话需要宿主提供相应工具或正常 UI；本仓库不会伪造创建结果。
|
|
|
|
将 `examples/bridge.example.json` 复制到仓库外，填入真实会话、执行目录与服务连接。初始化并绑定看板会话后，运行：
|
|
|
|
```sh
|
|
python3 scripts/bridge_service.py --config /path/to/private/bridge.json
|
|
```
|
|
|
|
本机桥接进程管理worker与mirror，连接中断后有界重连；结果未知的执行保持待核查，不自动重跑。也可分别运行同目录的worker.py和mirror.py。桌面会话使用 `desktop_queue` 模式通过 `codex queue` 向原会话提交消息，并读取同一 thread 的最终结果；不要使用另一个 CLI 进程强行 resume 已由桌面持有的会话。镜像仅同步允许的可见正文。真正的双向接入须现场验证，支持的命令随 Codex 版本而异。
|
|
|
|
状态中“登记会话”“桥接在线”“模型回复”“业务验证通过”是不同事实。认证缺失、队列超时、权限不足和未知指标会明确显示，不产生模拟成功。
|
|
|
|
## 扩展与验证
|
|
|
|
- [Skill 工作规范](SKILL.md)：总控、并行边界、汇报、决策与恢复。
|
|
- [运行接入](references/operations.md)：配置、API、桥接和消息恢复。
|
|
- [固定设计系统](references/design-system.md)：模板、页面职责、颜色和组件规则。
|
|
|
|
默认指标只采集本机可读信息。远程主机、NFS 和调度器通过站点私有配置显式启用；没有配置、缺工具或无权限时显示未知。扩展采集器使用固定命令和白名单，不接受网页任意命令。
|
|
|
|
本仓库不包含任何实际集群地址、客户案例、私有业务代码或聊天历史。公开仓库不会自动公开你的局域网运行实例。前端上游授权与组件来源见模板内的第三方说明。
|