# HarnessServer (Content Delivery for Agents)

## 概述

面向 Agent 宿主环境的上下文供给与能力分发组件

HarnessServer 跑在 Agent 宿主环境上，把已编译的 Skill / SOP / Rule 按角色装进 Workspace，并提供 REST 与 MCP 供运行时按需取上下文。独立部署时同一 HTTP 端口提供 REST 和 MCP（Streamable HTTP）。不采集企业知识；管理型记忆默认关闭，且只给授权 Agent。可单独使用本地内容，也可再对接 LarkScout 做同步与检索。

## 能做

- 双侧按需上下文注入：Worker 拉取任务上下文索引，Coordinator 按名取用 SOP
- 按角色 Workspace 预先装配：技能审批（含升级）后自动部署，SOP / Rule 按权限同步就位
- SkillScan 部署前静态扫描：新装默认开启、可关闭，提供 Python AST 危险模式与依赖静态扫描
- 上下文快照与 Content Version 溯源：按 Trace ID 关联的审计事件记录任务可见内容及其版本，实现上下文变更审计
- 按运行时生成上下文文件：CLAUDE.md / AGENTS.md / NODAL.md，未知运行时拒绝生成
- 独立可用与扩展对接：可单机独立提供 REST + MCP 供给，亦可联动 LarkScout 知识库
- 逐 Agent 内容装配：规则可设常驻 / 可选 / 不提示，SOP 可选 / 不提示（不提示的仍可按名取用）；期望与实际对照可查

## 不做

- 不负责原始文档采集与知识加工（上游知识提炼与 Claim 编译由 LarkScout 完成）
- 不提供面向所有 Agent 的共享记忆池（管理型记忆默认关闭，开启后仅对注册表里 memory_access 授权的 Agent 提供，主要使用方是 Coordinator）
- 不接管底层进程沙箱与系统调用（底层容器与操作系统级管控由 NodalOS 承载）
- 不输出平台级总分或 Agent 排名，也不把评估结论或绩效聚合写进 Agent 可见文件

## 覆盖的痛点

- 每个 Workspace 都要手工配 prompt 和工具
- Agent 进入项目后还要摸索几轮才有用
- 新 Agent 上线缺乏标准的入职流程

## 能力

- **双侧按需注入**: Worker 任务开始时拉取索引；Coordinator 按名按需取用处理 SOP，不把 SOP 全文预注入主配置
- **Workspace 预先备好**: 交付/批准完成后，Workspace 里已有主配置、已部署 Skill 和可见上下文索引；SOP 仍按名按需拉取
- **Skill 部署**: 同步 Skill 经确认授权后部署，装卸不需重启 Agent；vendor CLI 长驻会话除外
- **SkillScan 部署前扫描**: 随交付配置新装默认开启、可关闭，在 Skill 部署前做静态扫描，关闭时不生效；不是运行时沙箱，也不替代人审授权
- **上下文文件生成**: 按运行时生成 CLAUDE.md 等主配置，保持字节稳定以复用 Prompt Cache；独立模式下整份写入
- **逐 Agent 内容装配**: 规则可设常驻、可选或不提示，SOP 可设可选或不提示（仍可按名取用）；常驻超限自动降为目录行并告警
- **按角色与配置分发**: 按角色可见性与配置，为各 Agent 下发不同 Skill、SOP 与 Rule
- **外部 Skill 升级重审**: 外部 Skill 升级重跑安装核验，证据变更须重审；标记内置或自有不受影响，审批绑定证据
- **MCP 与 REST 同机提供**: 独立模式默认在同一端口提供 REST 与 MCP（Streamable HTTP）；MCP 不是全部能力的唯一入口
- **任务上下文快照**: 任务开始记录候选 SOP、规则与已部署 Skill 版本；快照为审计元数据而非字节级冻结，Skill 只有部署级记录
- **装配可核对**: 各 Agent 可核对期望与实际生效档位，未达成给出原因；改动留存审计事件
- **内容版本评估**: 新旧两版在同一对评估 Agent 上交替各跑十次，按评分规则出结论；需配置评估 Agent 与测试样例，产生模型成本
- **双时态管理型记忆**: 双时态存储并支持按时间点回溯；默认关闭，仅 memory_access 授权 Agent 可查询
- **可选对接 LarkScout**: 配置 LarkScout 地址与凭证即开启同步检索；可关闭，只服务本地已有内容
- **同机讨论板**: Coordinator 发帖征求受邀 Worker 意见并定决议；默认关闭，需配合 NodalOS，不唤醒 Agent

## 集成

- LarkScout 上游知识同步与检索（配地址与凭证后启用）
- NodalOS Workspace
- Agent 运行时上下文文件

## 指标

- 预先备好 — 主配置与 Skill 先就位
- 按角色 — coordinator / worker 分发
- REST + MCP — 独立模式同端口

## 依据 / 参考

- 产品页：/products/harnessserver
