# Harness 开发

# 概述

Harness 开发是面向 AIP 智能体平台的企业级 AI 应用开发能力,提供标准化的智能体编排、工具集成与大模型接入。本章节面向使用 Harness 进行业务开发的工程师,覆盖从工程导入、模块开发、权限配置到部署发布的完整链路。

# 目录

# 核心模块

Harness 是一个多模块 Maven 工程(Java 21 / Spring Boot 3),按职责拆分为若干子模块。

模块 说明
alinesno-infra-harness-copilot 智能体引擎(ReAct 推理-执行循环、工具注册/路由、SSE 事件推送、HITL 交互)
alinesno-infra-harness-toolkit 注解式工具框架(@CopilotTool 扫描、注册中心、执行器)
alinesno-infra-harness-sandbox 沙箱管理(代码沙箱隔离执行、文件读写、安全管控)
alinesno-infra-harness-skill Agent 技能与专家套件管理(技能加载、Prompt 注入)
alinesno-infra-harness-llm 大模型对接层(多模型适配、流式推送、Token 计量)
alinesno-infra-harness-mcp MCP 协议工具服务器(内置工具、业务工具组件注册)
alinesno-infra-harness-point 积分消费管理(模型调用计费、额度管控)
alinesno-infra-harness-facade 公共接口与引用(DTO、通用枚举、常量)
alinesno-infra-harness-domain 领域服务(通用业务逻辑、数据持久化)
alinesno-infra-harness-adapter 适配层(外部服务适配、网关鉴权拦截)
alinesno-infra-harness-knowledge 知识库管理与全文检索(基于 MeiliSearch)
alinesno-infra-harness-connector 外部系统连接器(SSH / DB / HTTP / 邮箱等)
alinesno-infra-harness-scheduler 定时任务调度(Quartz)
alinesno-infra-harness-business 业务逻辑层(业务开发者主工作区:FC 工具 tools/、@ 定位 locator/)
alinesno-infra-harness-boot 启动服务(Spring Boot 入口、全局配置)
alinesno-infra-harness-ui 前端管理界面(Vue3 + Element Plus)

# 目录结构

alinesno-infra-harness/
├── alinesno-infra-harness-facade       # 公共接口
├── alinesno-infra-harness-domain       # 领域服务
├── alinesno-infra-harness-adapter      # 适配层
├── alinesno-infra-harness-point        # 积分管理
├── alinesno-infra-harness-llm          # 大模型对接
├── alinesno-infra-harness-sandbox      # 沙箱管理
├── alinesno-infra-harness-skill        # 技能管理
├── alinesno-infra-harness-knowledge    # 知识库管理与全文检索
├── alinesno-infra-harness-mcp          # MCP 工具服务器
├── alinesno-infra-harness-toolkit      # 注解式工具框架
├── alinesno-infra-harness-scheduler    # 定时任务调度
├── alinesno-infra-harness-copilot      # 智能体引擎
├── alinesno-infra-harness-business     # 业务逻辑层
├── alinesno-infra-harness-connector    # 外部系统连接器
├── alinesno-infra-harness-boot         # 启动服务
├── alinesno-infra-harness-ui           # 前端界面
├── deploy                              # Docker Compose / Kubernetes 部署清单
├── document                            # 功能列表与设计文档
├── jenkins                             # 持续集成流水线
└── pom.xml                             # 根 POM
Last Updated: 9/25/2026, 7:10:09 AM