# 智能化部署 Agent 当前进度总结

更新时间:2026-04-08

## 1. 当前总体状态

当前阶段已完成从"需求方案"到"技术架构"再到"接口定义"和"demo 后端骨架"的文档化收敛,整体处于:

**方案已成型、文档体系已建立、技术路线已基本明确、代码尚未开始实现**

当前产出重点仍然是文档设计,不是代码开发。

---

## 2. 已完成的文档产出

当前目录已形成以下核心文档:

1. `智能化部署agent.md`
   用于描述项目目标、场景、总体方案、风险、安全和实施路线。

2. `智能化部署agent-技术架构设计说明书.md`
   用于描述系统架构、模块分层、数据模型、接口建议、安全设计和实施约束。

3. `智能化部署agent-demo接口定义说明.md`
   用于描述 demo 阶段的接口协议、统一响应格式、状态枚举、Agent 接口、软件 A demo 接口、身份 demo 接口、审批 demo 接口。

4. `智能化部署agent-demo后端项目骨架设计.md`
   用于描述 demo 后端的推荐技术栈、项目结构、模块职责、数据库表建议、代码落点和开发顺序。

5. `智能化部署agent-技术架构设计说明书.backup-20260408-141109.md`
   为技术架构说明书备份文件。

---

## 3. 已完成的主要工作

### 3.1 方案文档已重写

已解决原始文档存在的编码和可读性问题,并重写为结构化方案文档,覆盖:

1. 项目目标。
2. 产品定位。
3. 核心需求拆解。
4. 风险分析。
5. 开源对标。
6. MVP 范围。
7. 实施路线。

### 3.2 技术架构说明书已形成

已形成较完整的技术架构设计说明书,覆盖:

1. 总体架构分层。
2. 核心模块职责。
3. 云端与本地部署架构。
4. 软件 A 集成设计。
5. 数据模型。
6. 接口设计建议。
7. 关键流程设计。
8. 安全设计。
9. 非功能设计。

### 3.3 已确认前提已写入架构文档

以下前提已被整理并写入技术架构设计说明书:

1. MVP 阶段先开发 demo 版软件 A,不直接对接真实软件 A。
2. 软件 A 的操作者透传和权限能力在 demo 阶段由 demo 实现承接。
3. 本地 Agent 部署环境为 Windows 和 Linux 混合环境。
4. 试点应用部署方式统一。
5. 审批系统和身份系统在现网可能已有接口,但当前阶段无法直接接入,需开发 demo 版闭环。
6. 模型接入方式支持自定义 `base_url` 和 `api_key`。

### 3.4 接口文档已形成

demo 接口定义文档已覆盖:

1. Agent 对外任务接口。
2. 云端与本地 Agent 交互接口。
3. 软件 A demo 接口。
4. 身份 demo 接口。
5. 审批 demo 接口。
6. 内部对象结构。
7. 典型时序。

### 3.5 文档规范已统一

已统一以下文档规范:

1. 时间字段格式统一为 `yyyy-MM-dd HH:mm:ss.SSS`
2. 默认时区统一为 `Asia/Shanghai`
3. JSON 字段统一采用 `snake_case`
4. 字段命名规则统一为:
   `*_id`、`*_status`、`*_type`、`*_at`、`*_ms`、`*_count`

### 3.6 demo 后端骨架设计已完成

已完成 demo 后端项目骨架设计,明确:

1. 推荐采用单体后端服务 + 模块化分层。
2. 推荐技术栈为 Python + FastAPI + LangGraph。
3. 后端目录结构和模块边界。
4. 核心 service 划分。
5. 数据库表建议。
6. 本地 Agent 骨架建议。
7. 开发顺序建议。

---

## 4. 当前已明确的核心技术结论

### 4.1 架构方向

当前建议的总体方向是:

**软件 A 做执行底座,Agent 做智能编排层,本地 Agent 做受控执行器**

### 4.2 MVP 路线

当前 MVP 路线已经收敛为:

1. 自然语言发起任务。
2. Agent 解析意图并做结构化任务生成。
3. 策略层做风险判断。
4. 调用软件 A demo 执行部署或控制动作。
5. 调用本地 Agent 做验证。
6. 汇总结果,生成报告和审计。

### 4.3 技术选型方向

当前建议方向:

1. 编排框架优先 LangGraph。
2. demo 后端优先 Python + FastAPI。
3. 用户端本地 Agent 采用受控执行模式。
4. 所有外部系统统一通过 adapter 接入。

### 4.4 用户端 Python 运行方式建议

当前讨论结论是:

1. 用户端不应依赖客户现场预装 Python。
2. 本地 Agent 应做成"自带运行时"的便携包。
3. Windows 可采用 embeddable Python 或等价便携运行方式。
4. Linux 可采用自包含运行目录或可执行打包方式。

该结论已明确,但尚未系统性回写到所有设计文档。

### 4.5 数据库选择建议

当前讨论结论是:

1. 正式路线可以采用 PostgreSQL。
2. 如果以 demo 快速落地和减少安装成本为优先,可以先用 SQLite。
3. 后续试点或正式化阶段再切换 PostgreSQL。

该结论属于当前建议,尚未完整回写到骨架设计文档中。

### 4.6 开源和商用许可判断

当前讨论结论是:

1. Python、FastAPI、LangGraph、Pydantic、SQLAlchemy、PostgreSQL 等组件,整体上适合免费使用和商用。
2. Redis 的许可证情况相对复杂,不建议在文档中简单视为"低风险宽松开源"。
3. 如果确实需要 Redis 类组件,后续应评估 Valkey 或在 demo 阶段先不强依赖缓存中间件。

该结论属于当前建议,尚未完整回写到骨架设计文档中。

---

## 5. 当前尚未开始的部分

目前尚未开始以下工作:

1. demo 后端初始化代码。
2. 本地 Agent 初始化代码。
3. 数据库建表脚本。
4. OpenAPI 文档生成。
5. 软件 A demo 服务实现。
6. 身份 demo 服务实现。
7. 审批 demo 服务实现。
8. 验证插件实现。
9. 部署脚本和运行脚本。
10. 测试用例与联调脚本。

---

## 6. 当前存在的待落地事项

虽然整体文档体系已比较完整,但仍有几项内容尚未真正落到可运行层面:

1. 是否正式确认 demo 阶段使用 SQLite 还是 PostgreSQL。
2. 是否正式确认 Redis 在 demo 阶段保留、替换还是去掉。
3. 是否正式确认用户端 Agent 的交付格式:
   Windows zip 包、Linux tar.gz 包,或单文件可执行包。
4. 是否继续补数据库 DDL 文档。
5. 是否继续补 OpenAPI 草案。
6. 是否直接开始生成 demo 后端代码骨架。

---

## 7. 建议的下一步

按当前进度,建议后续按以下顺序推进:

### 路线 A:继续补文档后再开发

1. 补数据库 DDL 设计。
2. 补 OpenAPI 草案。
3. 将 SQLite / PostgreSQL、Redis / Valkey、用户端 Python 便携运行方案正式回写到文档。

适合:

1. 先把设计收口到可以评审。
2. 由多人协作开发前需要统一边界。

### 路线 B:直接进入 demo 代码骨架

1. 生成 FastAPI 后端项目初始化代码。
2. 生成核心目录结构和空实现。
3. 先打通 `POST /api/agent/tasks`、确认任务、查询任务三条主接口。
4. 再补软件 A demo adapter、身份 demo adapter、审批 demo adapter。

适合:

1. 尽快进入实现阶段。
2. 通过代码反推细节问题。

当前更推荐:

**先补最小 DDL 和 OpenAPI 草案,然后直接进入 demo 后端代码骨架。**

---

## 8. 当前一句话结论

目前不是"还在想法阶段",而是已经完成了:

**方案文档 -> 技术架构 -> 接口定义 -> 后端骨架**

下一步已经可以从"写文档"切换到"写 demo 代码"。