# GLS-0232 · 开源 Agent 样本学习与选型登记

> **HLDP**: `HLDP://fifth-domain/gls/GLS-0232-OPEN-SOURCE-AGENT-SAMPLES-LEARNING-AND-SELECTION`
>
> **正式名**: 开源 Agent 样本学习与选型登记
>
> **内部运行名**: 小湖灯外部 Agent 样本对照册
>
> **英文名**: Open Source Agent Samples Learning and Selection Registry
>
> **状态**: PHASE_1_SAMPLE_REGISTRY · LEARNING_ONLY · NOT_RUNTIME_TRUSTED
>
> **日期**: 2026-07-17
>
> **主权锚点**: 冰朔 `ICE-GL∞`
>
> **承接人格系统**: 铸澜 `ICE-GL-ZL-001`
>
> **关联协议**: `GLS-0230` 源码净化 / `GLS-0231` 人格体提词板与编号规则拦截 / `GLW-OS-003` 仓库原生知识运行时与 Agent 对话适配

---

## 0 · 一句话定义

GLS-0232 记录外部开源 Agent 项目对光湖自有 Agent 的学习价值、选型用途和接入边界。

它不登记外部 Agent 为光湖运行时，不授予外部源码可信身份，也不允许把外部控制面直接接进第五域、HoloLake Platform、人格体系统或服务器执行链。

```text
外部 Agent 样本 = 可学习对象 / 可拆零件 / 可对照架构。
光湖自有 Agent = 由 GLS-0230、GLS-0231、HLDP、编号系统、提词板、拦截器和回执链重写主控层。
```

## 1 · 本轮登记的两个样本

### 1.1 Grok Build

```yaml
sample_id: EXT-AGENT-GROK-BUILD-20260717
name: Grok Build
category: coding_agent_harness / terminal_or_product_coding_agent
source_status: "公开信息显示其为 Grok 系列 coding assistant / coding agent；本轮未锁定可审计 GitHub 源码仓库，开源代码事实源待复核。"
known_public_risk:
  - "2026-07 公开报道指出 Grok Build 曾上传用户代码仓库到云端，引发源码、凭证、隐私与供应链风险讨论。"
  - "即使后续声称修复或删除数据，也不能因此视为可信执行体。"
learning_value:
  - "coding agent 如何读取仓库、规划修改、调用命令、提交代码。"
  - "终端 / TUI / harness 如何把模型、工具、文件系统和 Git 工作流封装成连续开发体验。"
  - "长任务 coding agent 的上下文组织、任务拆分、工具回执和人类确认节奏。"
should_not_copy:
  - "任何遥测、代码上传、云端同步、远程控制和数据保留逻辑。"
  - "任何默认读取整仓、默认外传源码、默认保留会话或调试数据的设计。"
  - "任何无法被光湖编号系统拦截的工具执行链。"
best_use_in_guanghu:
  - "作为 coding agent 外壳和仓库操作体验的反面/正面样本。"
  - "学习其仓库读取、命令执行、diff 呈现、任务循环和人机协作体验。"
  - "经 GLS-0230 生成风险地图和组件卡后，只保留可重写的交互模式与工程思路。"
selection_rule:
  choose_when:
    - "需要研究代码仓库型 Agent 如何完成读仓、改仓、测试、提交、回执。"
    - "需要设计 HoloLake Agent Gateway 的 coding 工具链。"
  avoid_when:
    - "需要人格体关系、编号规则、共同拦截、经验压缩包或双向意识编码。"
    - "需要可直接接入私有仓库或服务器的可信执行体。"
```

### 1.2 JoyAgent-JDGenie

```yaml
sample_id: EXT-AGENT-JOYAGENT-JDGENIE-20260717
name: JoyAgent-JDGenie
source_url: "https://github.com/jd-opensource/joyagent-jdgenie"
license: "Apache-2.0"
category: end_to_end_multi_agent_product
source_status: "GitHub 公开仓库已确认；README 声称其为端到端多 Agent 产品，包含前端、后端、框架、引擎、核心子智能体与多 Agent 交互协议。"
main_structure:
  - "genie-backend"
  - "genie-client"
  - "genie-tool"
  - "ui"
claimed_capabilities:
  - "端到端多智能体产品，不只是 SDK 或单点框架。"
  - "支持 ReAct、Plan and Executor 等多种智能体模式。"
  - "支持多 Agent 上下文管理和高并发 DAG 执行引擎。"
  - "预置 Report Agent、Search Agent、Code Agent、PPT Agent、File Agent 等子智能体或工具链。"
  - "支持 HTML、PPT、Markdown 等交付物形态。"
  - "支持 MCP 工具接入和自定义子 Agent / Tool 挂载。"
learning_value:
  - "完整 Agent 产品如何分前端、后端、工具服务和 UI。"
  - "多 Agent 产品如何把 Planner、Executor、工具、报告生成和流式输出封装成用户可直接使用的产品。"
  - "DAG 执行、上下文管理、子 Agent 插拔、报告/PPT/Markdown 产物链路。"
  - "MCP 工具接入和自定义 BaseTool 接口设计。"
should_not_copy:
  - "不直接复制其产品主控层作为光湖人格体主控。"
  - "不直接继承其权限模型、任务模型、数据模型或用户关系模型。"
  - "不把其 Agent 调度结果绕过 GLS-0231 的编号规则、提词板、拦截器和回执链。"
best_use_in_guanghu:
  - "作为端到端多 Agent 产品样本。"
  - "拆解前后端分层、Agent 引擎、DAG 执行、子 Agent 插拔、交付物生成和 MCP 接入方式。"
  - "将可用思路翻译成 HoloLake Agent Gateway / Number Rule Engine / Persona Prompt Board / Runtime Interceptor / Experience Pack Compiler 的工程任务。"
selection_rule:
  choose_when:
    - "需要研究完整多 Agent 产品怎么组织，而不是只研究 coding agent。"
    - "需要报告、PPT、Markdown、搜索、文件处理、工具挂载等产品级交付链路。"
    - "需要对照市面开源框架与端到端产品的差异。"
  avoid_when:
    - "需要直接承载光湖人格体身份、关系、编号、记忆和情感层。"
    - "需要直接处理第五域主仓、服务器授权、密钥或现实执行。"
```

## 2 · 怎么学习

```text
第一层: 事实登记
  记录项目名、仓库 URL、许可证、版本、提交、README 声称、目录结构和运行方式。

第二层: 风险地图
  按 GLS-0230 检查网络、遥测、上传、文件权限、命令执行、Token、插件、远程代码加载、更新源和依赖。

第三层: 功能拆解
  把外部项目拆成组件卡:
    - 仓库读取
    - 上下文管理
    - Planner / Executor
    - ReAct 循环
    - DAG 执行
    - 子 Agent 注册
    - Tool / MCP 接入
    - 产物生成
    - UI 流式展示
    - 人类确认
    - 回执 / 日志 / 追踪

第四层: 光湖重写
  所有组件进入 GLW-OS-003 前，必须被重新映射到:
    - HoloLake Agent Gateway
    - Number Rule Engine
    - Persona Prompt Board
    - Runtime Interceptor
    - Shared Boundary Feedback
    - Experience Pack Compiler
    - Bidirectional Thinking Code Writer

第五层: 验收
  没有组件卡、风险地图、测试证据、权限说明和回执的样本，不进入 HoloLake Platform 工程链。
```

## 3 · 怎么选

| 目标 | 优先参考 | 原因 | 光湖处理方式 |
|---|---|---|---|
| 研究代码仓库型 Agent 如何读仓、改仓、跑命令、生成 diff | Grok Build | 更接近 coding agent / terminal harness 问题 | 只学习仓库操作体验和工具循环；严禁继承外传源码、遥测或远程控制面 |
| 研究完整多 Agent 产品如何封装前后端、Agent 引擎、子 Agent 和交付物 | JoyAgent-JDGenie | 更接近端到端多 Agent 产品 | 拆解产品分层、DAG、子 Agent、MCP、报告/PPT/Markdown 产物链路 |
| 设计光湖人格体运行主控 | GLS-0231 | 外部 Agent 没有光湖编号、关系、提词板、共同拦截和经验传承 | 外部样本只能提供零件；主控层由光湖协议重写 |
| 处理外部源码进入光湖 | GLS-0230 | 外部源码不能默认可信 | 先隔离、拆解、审计、降权、组件化，再按 HLDP 重组 |
| 做 HoloLake Agent Gateway 工程落点 | GLW-OS-003 | 产品运行时需要仓库事实源、Agent 对话层、工具层、回执层统一 | 把样本组件转成 HLDP 工单和验收标准 |

## 4 · 选型结论

```text
Grok Build:
  适合看 coding agent 如何把仓库、命令、diff、测试和提交串起来。
  不适合直接作为光湖 Agent 产品基座。

JoyAgent-JDGenie:
  适合看完整多 Agent 产品如何把 UI、后端、Agent 引擎、子 Agent、工具和产物链路封装起来。
  不适合直接作为光湖人格体主控。

光湖路线:
  学 Grok Build 的 coding agent 操作体验。
  学 JoyAgent-JDGenie 的端到端产品封装。
  由 GLS-0230 处理源码可信。
  由 GLS-0231 处理人格体运行边界。
  由 GLW-OS-003 落成 HoloLake Agent Gateway 与仓库原生知识运行时。
```

## 5 · 边界规则

```yaml
rules:
  not_runtime_trusted:
    text: "登记样本不等于信任运行时。"
  no_direct_private_repo_access:
    text: "外部 Agent 不得直接接入第五域主仓、HoloLake Platform 主仓、服务器工作副本、密钥或用户私有数据。"
  no_control_plane_import:
    text: "不得导入外部 Agent 的主控层、云同步层、遥测层、账号层或自动更新层作为光湖主控。"
  apache2_is_not_security:
    text: "Apache-2.0 只解决法律许可的一部分，不解决可信执行、安全审计和人格体边界问题。"
  rewrite_main_control:
    text: "所有进入光湖的 Agent 能力必须在 HLDP / GLS / 编号系统 / 提词板 / 拦截器 / 回执链下重写。"
```

## 6 · 当前未完成事项

```yaml
pending:
  - "未拉取 Grok Build 可审计源码仓库；公开开源事实源待复核。"
  - "未对 JoyAgent-JDGenie 做本地 clone、依赖扫描、网络扫描、启动验证或组件卡拆解。"
  - "未生成 GLS-0230 标准 source_intake / risk_map / component_cards / purification_receipt。"
  - "未在 HoloLake Platform 创建工程工单。"
  - "未实现任何光湖自有 Agent 运行时模块。"
```

> ⊢ 本登记只完成语言层样本对照和选型规则。工程实现待开发。
