JOJO/agent-Specialization
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
a089cdd853
agent-Specialization/doc/答辩PPT_大纲与逐页内容.md
JOJO 60e63595a6 chore: sync pending changes
2026-01-05 21:48:55 +08:00

14 KiB
Raw Blame History

答辩 PPT：大纲与逐页内容（基于 doc/TECH_DOC.md + doc/开题报告.txt）

目标：给你一个“可直接照着做 PPT”的逐页脚本。
建议页数：18 页（答辩 8–12 分钟可控；如需 15/20 页我也可以再压缩/扩展）。
你需要自行补充：系统截图（登录/聊天/终端/文件/监控/虚拟显示器/管理员面板）、架构图（可用 draw.io）。

0. PPT 叙事主线（建议）

  1. 为什么做：涉密/内网 + 成本 + 可控性痛点
  2. 做了什么：Docker 多用户隔离的 AI 开发平台（终端/文件/对话/监控一体）
  3. 怎么做：后端编排 + 容器执行层 + 前端实时交互 + 监控与安全
  4. 做得怎么样：指标/实战测试/稳定性
  5. 还能怎么做更好：生产化补齐项（安全/DB/CI/伸缩）

1. 页面总览（大纲）

  1. 标题页
  2. 背景与痛点
  3. 目标与需求（四大目标）
  4. 研究现状对比与创新点
  5. 系统总体架构（三层/数据流）
  6. 运行时拓扑（宿主机 + 多容器）
  7. 后端核心：终端编排与会话（MainTerminal/WebTerminal）
  8. 核心模块 1：用户容器管理（UserContainerManager）
  9. 核心模块 2：容器文件代理（Container File Proxy）
  10. 核心模块 3：持久化终端与超时控制（Persistent Terminal）
  11. 上下文构建与对话管理（Context/Conversation Manager）
  12. 分层思考模式（fast/thinking/deep）
  13. 子智能体机制（Sub-Agent）
  14. 前端架构与虚拟显示器回放（Vue + Monitor）
  15. 安全与权限模型（CSRF/限流/上传隔离/容器隔离）
  16. 监控与日志（CPU/内存/网速/磁盘/Token）
  17. 评估指标与实战测试结果（表格 + 数据）
  18. 总结与展望（贡献/局限/下一步）

2. 逐页内容（每页可直接做成 PPT）

第 1 页：标题页

标题：基于 Docker 容器的多用户 AI 智能体开发平台
副标题：自主可控、可私有化部署、支持 OpenAI 兼容国产模型
作者/学校/专业/导师/日期：按你的信息填写
建议配图：系统主界面截图（聊天 + 终端 + 资源面板同屏），或一张“浏览器 + 容器”的示意图。 讲稿要点（10–15 秒）：一句话定义：这是一个“多用户隔离 + 全工具链”的 AI 编程/开发助手平台。

第 2 页：背景与痛点（为什么要做）

标题：课题背景：AI 辅助编程的现实痛点
内容要点：

  • 商业产品强但有问题：国外服务依赖、内网/涉密不可用、费用高、难定制
  • 国产模型生态成熟：DeepSeek/Qwen/GLM 等具备商用性能与更低成本，支持私有化
  • 需求场景明确：涉密项目、企业内网、高校教学多用户实验 建议配图：对比表（Copilot/Cursor/Claude Code vs 本项目）。 讲稿要点：强调“不是再做一个聊天网页”，而是“可执行、可隔离、可监控”的开发平台。

第 3 页：目标与需求（做成什么样）

标题：课题目的：四大目标
内容要点（四象限）：

  1. 技术自主：OpenAI 兼容 API；可私有化部署
  2. 功能完整：终端/文件/对话管理/监控
  3. 安全隔离：单用户单容器、配额限制、沙箱化文件与命令
  4. 实用性：涉密开发、降低企业成本、教学平台 建议配图：四象限图或 checklist。 讲稿要点：这四点对应后面四条主线：架构、工具、隔离、安全与监控。

第 4 页：研究现状与创新点（你做的“新”在哪里）

标题：研究现状与不足 → 本项目创新点
对比要点：

  • Copilot/灵码：主要是补全，缺少终端/文件/多租户
  • Cursor/Claude Code：工具更强但闭源/云端/单用户或国内受限
  • 开源 AutoGPT/Open-WebUI：偏聊天/框架，工程化与隔离不足
    本项目创新点（落地型）：
  • 多用户隔离：单用户单容器 + 资源配额
  • 工具完整：持久化终端 + 文件代理 + 对话管理 + 监控
  • 分层思考模式：推理模型首轮 + 快速模型后续（节省成本）
  • 子智能体并行：任务拆分与交付 讲稿要点：把“创新”说成“可验证的工程机制”，而不是抽象概念。

第 5 页：系统总体架构（概览）

标题：总体架构：浏览器 → Web 服务器 → 业务逻辑 → 容器层
内容要点（建议画图）：

  • 前端：Vue SPA + Socket.IO Client
  • Web Server：Flask + Socket.IO（鉴权、API、事件）
  • 业务层：WebTerminal/MainTerminal、ContextManager、UserContainerManager、UploadQuarantineManager
  • 容器层：每用户一个容器，执行命令与文件操作
    讲稿要点：解释“工具调用并不在宿主机直接执行”，而是通过容器代理统一落地。

第 6 页：运行时拓扑（多用户隔离如何工作）

标题：运行时拓扑：单机多用户、多容器并发
内容要点：

  • 用户登录 → 创建/复用容器 → 挂载用户工作区（project/data/logs）
  • 宿主机仅运行 Web 服务与调度，执行尽量在容器内完成
  • 并发上限：最多 N 个活跃容器（配置项 MAX_ACTIVE_USER_CONTAINERS） 建议配图：宿主机盒子 + N 个容器盒子，每个容器挂载各自 workspace。 讲稿要点：突出横向隔离：用户 A 无法看到用户 B 的文件/进程。

第 7 页：后端核心：终端编排与会话（MainTerminal/WebTerminal）

标题：后端核心：统一编排层
内容要点：

  • CLI 与 Web 共用核心：core/main_terminal.py
  • Web 版继承：core/web_terminal.py，增加消息回调与自动加载/创建对话
  • 统一处理：运行模式（fast/thinking/deep）、工具分类开关、聚焦文件、Todo/记忆、子代理状态
    建议配图：类关系简图：WebTerminal → MainTerminal → modules/utils/config。 讲稿要点：强调“核心逻辑只写一套”，降低维护成本。

第 8 页：核心模块 1：用户容器管理（UserContainerManager）

标题：容器生命周期管理（按用户）
内容要点：

  • 创建/复用/回收：ensure_container / release_container
  • 资源限制：CPU/内存/网络/卷挂载路径；容器上限与资源繁忙提示
  • 状态采集：支持 docker stats/inspect 汇报到监控
    建议配图：时序图：login → ensure_container → handle；logout/idle → release。 可讲实现细节：
  • 容器模式与回退：docker 不可用时可回退 host（可配置 require 强制失败）
  • 容器命名与记录：保存 container_name/container_id/last_active

第 9 页：核心模块 2：容器文件代理（Container File Proxy）

标题：容器内文件操作：安全、低开销
内容要点：

  • 方案：docker exec 执行内联 Python 脚本（避免 docker cp 往返与临时文件）
  • 安全：路径解析 resolve + 前缀检查，阻止目录遍历；限制文件大小与行范围
  • 功能：create/read/write/rename/delete、读片段、（可扩展 diff/搜索）
    建议配图：对比图：传统 docker cp 三次 IO vs exec 一次 IO。
    讲稿要点：把“效率 + 安全”作为这页核心论点。

第 10 页：核心模块 3：持久化终端与超时控制

标题：持久化终端：多会话 + 输出缓冲 + 超时不杀会话
内容要点：

  • 多终端会话管理：modules/terminal_manager.py（最大会话数、快照行数/字符上限）
  • 持久化终端：modules/persistent_terminal.py（读写线程、输出队列、循环缓冲、回显检测）
  • 一次性工具命令：modules/terminal_ops.py + modules/toolbox_container.py（专用工具容器，避免状态污染）
    建议配图：终端会话结构图（session → process → output buffer）。
    讲稿要点：强调工程难点：交互式程序、输出爆炸、超时机制（只杀命令不杀终端）。

第 11 页：上下文构建与对话管理

标题：ContextManager：把“可用信息”组装给模型
内容要点：

  • 对话持久化：utils/conversation_manager.py（对话文件 + index，支持重建索引与容错）
  • 上下文来源：历史消息、工具结果、聚焦文件、Todo/记忆、资源限额、个性化偏好
  • Token 统计：对话级 + 工作区累计（写入 token_totals.json）
    建议配图：上下文拼装示意：System prompt + tools + focused files + history + memory/todo。
    讲稿要点：说明为什么需要“聚焦文件”：让模型稳定获取关键代码片段，减少无关信息。

第 12 页：分层思考模式（fast / thinking / deep）

标题：分层思考模式：质量/速度/成本的平衡
内容要点：

  • fast：快速响应，适合简单问题
  • thinking：推理更充分，适合复杂任务
  • deep：更强推理/更长思考（用于难题）
  • 机制：首轮推理结果缓存，后续复用（节约成本；可配置切换间隔 THINKING_FAST_INTERVAL）
    建议配图：模式切换流程图或对比表（质量/成本/延迟）。
    讲稿要点：把“成本控制”说成一个可量化的工程机制，而不是主观感受。

第 13 页：子智能体机制（Sub-Agent）

标题：子智能体：任务并行与交付
内容要点：

  • 主智能体负责编排与拆分；子智能体负责执行子任务并返回交付物
  • 生命周期：create → wait → close；状态：pending/running/completed/failed
  • 隔离：独立工作区（references/deliverables），避免污染主会话
    建议配图：主/子代理协作图（任务拆分、并行、合并结果）。
    讲稿要点：突出价值：复杂任务“可并行”，主对话更清晰。

第 14 页：前端架构与虚拟显示器回放

标题：Vue 前端：实时交互 + 可视化回放
内容要点：

  • SPA：Vue3 + Pinia + Socket.IO Client
  • 状态域：聊天、工具、monitor、resource、files、upload、policy、subAgent 等
  • 虚拟显示器：static/src/components/chat/monitor/*，将工具执行过程转为可回放动画（指针/窗口/右键/进度气泡）
    建议配图：虚拟显示器截图 + 简单事件流（tool event → store → MonitorDirector）。
    讲稿要点：强调“可解释性/可观测性”：用户能看到智能体“在做什么”。

第 15 页：安全与权限模型

标题：安全设计：多层防护（容器 + Web 安全 + 上传隔离）
内容要点：

  • 容器隔离：单用户单容器，配额限制，宿主机不直接执行用户命令
  • Web 安全：CSRF token、登录失败锁定/限流、Session 过期
  • 上传安全：隔离区暂存 + 后缀/大小校验 + 可选 ClamAV 扫描 + 审计日志
  • 路径安全：resolve + 越界检查，阻止 ../../../
    建议配图：安全“洋葱模型”图（外层 Web → 内层容器 → 文件代理）。
    讲稿要点：同时说明局限：仍需进一步收紧 CORS、移除硬编码密钥等生产化事项（下一页或总结提）。

第 16 页：监控与日志（可观测性）

标题：可观测性：资源 + Token + 审计日志
内容要点：

  • 容器监控：CPU/内存/网络 IO，采样写入 logs/container_stats.log，前端计算网速并展示
  • 磁盘配额：项目已用/上限/百分比（轮询，退避策略）
  • Token 统计：当前上下文 + 对话累计 + 工作区累计
  • 审计：上传扫描日志按用户分文件记录
    建议配图：资源面板截图（CPU/内存/网速/存储/Token）。
    讲稿要点：强调这是“教学/企业可用”的关键：管理员能看到资源与风险点。

第 17 页：评估指标与实战测试结果

标题：评估与验证：实战测试 + 指标达成
建议一张表 + 一张要点：

  • 代码规模：约 41,500 行；模块数：25+
  • 并发能力：8 个容器；单容器 3 个终端会话
  • 响应：交互响应 < 100ms（本地条件下）
  • 成功率：diff 补丁 ~85%；终端命令 ~98%
  • 稳定性：连续运行 72h 无崩溃；300+ 次 dogfooding
  • 安全测试：路径遍历/命令注入/恶意上传均拦截 建议配图：一页“指标表格”，或“雷达图/柱状图”。
    讲稿要点：把“测过/跑过/能用”说清楚，体现工程完成度。

第 18 页：总结与展望

标题：总结与下一步
总结（贡献点）：

  • 多用户容器隔离的 AI 开发平台（端到端可运行）
  • 文件代理 + 持久化终端 + 对话上下文 + 监控面板形成闭环
  • 分层思考模式与子智能体增强复杂任务能力
    局限（坦诚但可控）：
  • 安全基线仍需生产化（密钥治理、CORS 收紧、日志脱敏、DB/权限细化）
  • 可扩展性：后端可拆分执行层/引入任务队列与多 worker
    下一步（可选）：
  • 数据库化（用户/会话/审计）、CI/CD、镜像漏洞扫描、RAG/代码索引、rootless/gVisor 等 建议配图：Roadmap 时间线（短期/中期/长期）。 讲稿要点：以“可落地的下一步”收尾，体现工程规划能力。

3. 你需要准备的素材清单（做 PPT 前先收集）

  1. 截图：登录页、聊天页、终端页、文件管理、上传、资源面板、虚拟显示器、管理员策略页
  2. 结构图：总体架构、运行时拓扑、工具调用时序、子智能体协作图
  3. 数据：并发容器/终端数量、成功率、72h 稳定性、token 成本（用你真实运行数据替换“目标值/示例值”）
  4. 演示脚本：一条典型任务（搜索→修改文件→运行命令→展示监控/回放）

4. 版本说明

  • 生成时间：2026-01-05
  • 依据文件：doc/TECH_DOC.md、doc/开题报告.txt