# embedded-agent-workbench

**Repository Path**: jackieling/embedded-agent-workbench

## Basic Information

- **Project Name**: embedded-agent-workbench
- **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-07-30
- **Last Updated**: 2026-07-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent Workbench Monorepo

面向嵌入式 Linux 开发的双机协作系统:远程 Agent 平台(Kimi Code /
OpenCode / Codex)通过 MCP over HTTP 调用 Windows 控制面的四个工具服务器,
由本地编排器 `agent_workbench` 统一驱动"目标 → 构建 → 交付 → 设备验证"
的闭环工作流。

本仓库为 **monorepo**:核心编排器与全部 MCP 工具服务器在此单一仓库中
共同版本化。

## 仓库结构

| 目录 | 说明 |
| --- | --- |
| [`agent-workbench/`](agent-workbench/) | 核心编排器(schema v5 control goal、确认门、证据、报告)+ 平台无关插件包 |
| [`serial-mcp/`](serial-mcp/) | 串口 MCP 服务器(COM、RFC2217),端口 8765 |
| [`telnet-mcp/`](telnet-mcp/) | Telnet 设备通道 MCP 服务器,端口 8766 |
| [`delivery-server-mcp/`](delivery-server-mcp/) | 交付 MCP 服务器(NFS/TFTP 不可变暂存、防火墙自动化),端口 8767 |
| [`powershell-mcp/`](powershell-mcp/) | Windows PowerShell 执行 MCP 服务器(含 SCP 拉取),端口 8769 |
| [`docs/`](docs/) | 顶层架构文档与 MCP 客户端配置示例 |
| [`PROJECT_STATUS.md`](PROJECT_STATUS.md) | 项目当前状态、运维上下文与待办 |

所有工具服务器实现 `workbench.terminal-exec.v1` 契约,并提供 1 GB 配额、
7 天保留期的磁盘会话日志。

## 快速开始

### 1. Windows 控制面:启动工具服务器

```powershell
cd agent-workbench
powershell -ExecutionPolicy Bypass -File .\scripts\Start-ToolServers.ps1 -BindHost "172.25.7.8"
```

脚本幂等启动四个 provider;已监听的端口会跳过。暴露到网络前,请先用
Windows 防火墙将 8765/8766/8767/8769 限制到目标 Agent 主机。

### 2. 远程 Agent 平台:安装插件

```bash
git clone https://github.com/Automorrow/agent-workbench-monorepo.git
cd agent-workbench-monorepo/agent-workbench
bash plugin/scripts/install-agent-plugin.sh \
  --platform <kimi|codex|opencode> \
  --windows-host 172.25.7.8
```

安装器会创建专用 venv 并将 `agent-workbench/` 包装入其中,再合并五个
MCP 配置项与共享 skill。必须基于完整的 `agent-workbench/` 检出运行,
只复制 `plugin/` 目录无法工作。详见
[MCP 客户端配置指南](agent-workbench/docs/mcp-client-configs.md)。

## 测试

```powershell
# 核心编排器(约 550 项)
cd agent-workbench
python -m pip install -e ".[test]"
python -m pytest -q

# 各工具服务器(unittest)
cd serial-mcp;   PYTHONPATH=src python -m unittest discover -s tests -v
cd telnet-mcp;   PYTHONPATH=src python -m unittest discover -s tests -v
cd delivery-server-mcp; PYTHONPATH=src python -m unittest discover -s tests -v
cd powershell-mcp;      PYTHONPATH=src python -m unittest discover -s tests -v
```

## 文档导航

- [顶层架构文档](docs/embedded-agent-workbench.md) — 双机拓扑、插件分发、工作流
- [agent-workbench README](agent-workbench/README.md) — 安全边界、配置、control goal、CLI
- [MCP 客户端配置指南](agent-workbench/docs/mcp-client-configs.md) — 安装与验证
- [PROJECT_STATUS.md](PROJECT_STATUS.md) — 运行状态与常用操作

## 仓库历史

2026-07-28 之前,五个项目为相互独立的 git 仓库;此后合并为本 monorepo,
旧本地历史不再保留。agent-workbench 在合并前的提交历史仍可在存档仓库
[`Automorrow/agent-workbench`](https://github.com/Automorrow/agent-workbench)
中查阅(只读)。