技术可行性分析

本章对 K3s Runtime 模块涉及的各项关键技术进行可行性评估，帮助决策者理解每项能力的实现难度、技术成熟度和风险。

1. 评估维度说明

每项能力从以下四个维度评估：

2. 核心能力评估

2.1 容器化隔离执行

技术依据：K3s 是 CNCF 认证的轻量 K8s 发行版，支持 Deployment、Service、Pod、ConfigMap、Secret 等核心资源。当前实现利用 K8s 的 Deployment + Service 资源作为执行单元（SessionWorker 模式），Pod 长驻运行通过 8081 端口接收消息，namespace（命名空间）和安全上下文实现隔离。

关键代码：workload_worker.rs（Deployment + Service 渲染）、apply.rs（资源创建与回滚）

2.2 多轮对话连续性

技术依据：通过两层机制实现：（1）Backend 持久化对话历史和 RunRecord；（2）Worker 在关键步骤通过协议把 checkpoint 发送给 Backend，由 Backend 统一写入数据库，下一轮再通过 run-context.json 与 checkpoint_get 恢复。

关键代码：volumes.rs（session_state_volume）、service.rs（sync_session_state）

2.3 文件挂载与宿主目录访问

技术依据：K8s 原生支持 hostPath 卷类型，K3s 完全兼容。当前实现定义了四种卷（workspace、session-state、package、mount-grant），通过 volumes.rs 统一管理布局。

2.4 外部数据库访问

技术依据：当前方案不是让 Pod 直接连接数据库，而是由 Backend 统一访问数据库，Worker 通过协议发送 backend_query / backend_command / checkpoint_get / checkpoint_put。这样数据库凭据不进入容器，协议边界更稳定。

关键代码：service_bindings.rs

2.5 Agent 包分发

技术依据：Agent 包文件通过 ConfigMap 以 data 字段挂载为容器内文件。K8s ConfigMap 是经过生产验证的配置分发机制。

关键代码：package_bundle.rs

3. 演进能力评估

3.1 交互式会话（SessionWorker）

技术分析：

已将执行模型从一次性 Job 升级为 Deployment + Service（长驻服务），容器内 agentcore 启动后主动建立 WebSocket 连接到 Backend，通过单条持久连接双向传输消息和事件。

graph TB
    subgraph IMPL["已实现的 SessionWorker 组件"]
        DEP["Deployment + Service<br/>workload_worker.rs"]
        EVT["WebSocket 双向事件通道<br/>WorkerEventChannel"]
        HB["心跳检测 + 就绪探针<br/>readinessProbe / livenessProbe"]
        GS["优雅关闭 + TERM 信号处理<br/>worker-draining.log"]
        IDLE["空闲回收策略<br/>WorkerIdlePolicy"]
    end

3.2 预热镜像与镜像缓存

技术分析：开发者编写 Dockerfile 预装依赖，CI/CD 构建后推送到 Registry。RuntimeProfile 指定镜像地址，K3s 节点通过 imagePullPolicy: IfNotPresent 缓存已拉取的镜像层。

3.3 本地工具桥接

技术分析：

需要建立 Container → Backend → Helper 的反向调用链路：

1. agentcore 通过 HTTP 调用 Backend 的“工具代理“端点
2. Backend 通过已建立的 WebSocket 连接转发给 Helper
3. Helper 在本地执行工具并返回结果

安全约束：白名单工具列表、参数校验、执行超时、结果大小限制。

3.4 多节点扩展（远程部署场景，非当前重点）

注意：当前系统设计为本地部署（用户本机 = 宿主机），以下多节点分析为未来扩展预留。

技术分析：

当前 hostPath 卷依赖本地单节点，天然适合本地部署模式。若未来需要远程多节点扩展：

代码中 VolumeBackend 枚举已为此预留扩展点。

4. 综合评估矩阵

graph TB
    subgraph Q1["✅ 优先实现（高价值 + 低复杂度）"]
        A1["容器隔离执行"]
        A2["多轮连续性"]
        A3["文件挂载"]
    end

    subgraph Q2["📋 值得投入（高价值 + 高复杂度）"]
        B1["交互式会话 SessionWorker"]
        B2["本地工具桥"]
    end

    subgraph Q3["⏳ 按需实现（低价值 + 低复杂度）"]
        C1["Backend 统一数据访问"]
        C2["预热镜像"]
    end

    subgraph Q4["⚠️ 谨慎评估（低价值 + 高复杂度）"]
        D1["多节点扩展"]
    end

    style Q1 fill:#d4edda,stroke:#28a745
    style Q2 fill:#fff3cd,stroke:#ffc107
    style Q3 fill:#e2e3e5,stroke:#6c757d
    style Q4 fill:#f8d7da,stroke:#dc3545

5. 实施路线建议

短期（已实现或即将完成）

• ✅ 容器化隔离执行
• ✅ 多轮对话连续性
• ✅ 文件挂载与外部目录访问
• ✅ Backend 统一数据库访问
• ✅ Agent 包 ConfigMap 分发

中期

• 预热镜像支持
• 镜像层缓存优化
• QueueConsumer 事件通道（为高并发场景准备）

长期

• 本地工具桥接
• 远程部署模式与多节点存储迁移

附录：技术选型参考