Merge pull request #3 from VitaDynamics/feat/codex-research

feat: add OpenAI Codex repository and research notes

Author: DylanLIiii

README.md

@@ -13,7 +13,7 @@
 
 | 类别 | 描述 | 数量 |
 |------|------|------|
-| [Agent](./repos/agent/) | 独立的 AI Agent 应用和实现 | 2 |
+| [Agent](./repos/agent/) | 独立的 AI Agent 应用和实现 | 3 |
 | [Agent-harness](./repos/agent-harness/) | Agent 框架和编排工具 | 8 |
 | [Agent Evaluation](./repos/agent-evaluation/) | Agent 测试和评估框架 | 3 |
 | [Agent Training](./repos/agent-training/) | Agent 训练和微调资源 | 0 |
@@ -26,25 +26,24 @@
 
 | 类别 | 描述 | 文档数 |
 |------|------|--------|
-| [Agent Harness](./docs/learns/harness/) | Agent 框架和编排工具模式 | 21 |
+| [Agent Harness](./docs/learns/harness/) | Agent 框架和编排工具模式 | 23 |
 | [Agent Evaluation](./docs/learns/evaluation/) | Agent 测试和评估模式 | 2 |
 | [Agent Training](./docs/learns/training/) | Agent 训练和微调方法 | 0 |
 
 #### Harness 主题
 
 | 主题 | 描述 | 文档数 |
 |------|------|--------|
-| [流式处理](./docs/learns/harness/streaming/) | 异步流式、WebSocket 模式 | 6 |
+| [流式处理](./docs/learns/harness/streaming/) | 异步流式、WebSocket 模式 | 7 |
 | [错误处理](./docs/learns/harness/error-handling/) | 结构化错误、重试策略 | 1 |
-| [上下文管理](./docs/learns/harness/context-management/) | 会话历史、上下文转换 | 3 |
+| [上下文管理](./docs/learns/harness/context-management/) | 会话历史、上下文转换 | 4 |
 | [类型安全](./docs/learns/harness/type-safety/) | 类型安全的消息层次结构 | 1 |
 | [中间件](./docs/learns/harness/middleware/) | 回调和可扩展性系统 | 1 |
 | [并发](./docs/learns/harness/concurrency/) | 状态快照 and 并发模式 | 1 |
-| [架构](./docs/learns/harness/architecture/) | 框架架构分析 | 2 |
+| [架构](./docs/learns/harness/architecture/) | 框架架构分析 | 3 |
 | [抽象层](./docs/learns/harness/abstractions/) | LLM 抽象层比较 | 3 |
 | [WebSocket](./docs/learns/harness/websocket/) | OpenAI WebSocket 比较 | 1 |
 | [机器人技术](./docs/learns/harness/robotics/) | 机器人运动控制 | 2 |
-| [评估](./docs/learns/evaluation/) | Agent 性能测试和安全评估 | 2 |
 
 ### 最佳实践
 
@@ -86,10 +85,10 @@
 ## 统计信息
 
 ```
-仓库：13（Agent: 2, Agent-harness: 8, Evaluation: 3, Training: 0）
-文档：23 个学习笔记 + 3 个最佳实践文档
+仓库：14（Agent: 3, Agent-harness: 8, Evaluation: 3, Training: 0）
+文档：25 个学习笔记 + 3 个最佳实践文档
 主题：11
-最后更新：2026-03-02
+最后更新：2026-03-04
 ```
 
 ---

docs/learns/README.md

@@ -6,19 +6,19 @@
 
 ## 按类别分类
 
-### [Agent Harness](./harness/)（20 篇）
+### [Agent Harness](./harness/)（23 篇）
 
 Agent 框架和编排工具的模式分析。
 
 | 主题 | 描述 | 文档数 |
 |------|------|--------|
-| [流式处理](./harness/streaming/) | 异步流式、WebSocket 模式和实时通信 | 5 |
+| [流式处理](./harness/streaming/) | 异步流式、WebSocket 模式和实时通信 | 6 |
 | [错误处理](./harness/error-handling/) | 结构化错误、重试策略和弹性模式 | 1 |
-| [上下文管理](./harness/context-management/) | 会话历史、上下文转换和内存模式 | 3 |
+| [上下文管理](./harness/context-management/) | 会话历史、上下文转换和内存模式 | 4 |
 | [类型安全](./harness/type-safety/) | 类型安全的消息层次结构和序列化模式 | 1 |
 | [中间件](./harness/middleware/) | 回调和可扩展性系统 | 1 |
 | [并发](./harness/concurrency/) | 状态快照和并发模式 | 1 |
-| [架构](./harness/architecture/) | 框架架构分析和设计模式 | 2 |
+| [架构](./harness/architecture/) | 框架架构分析和设计模式 | 3 |
 | [抽象层](./harness/abstractions/) | LLM 抽象层比较和 SDK 模式 | 3 |
 | [WebSocket](./harness/websocket/) | WebSocket 协议比较 | 1 |
 | [机器人技术](./harness/robotics/) | 机器人运动控制和 Embodied AI 模式 | 2 |
@@ -27,7 +27,7 @@ Agent 框架和编排工具的模式分析。
 
 ---
 
-### [Agent Evaluation](./evaluation/)（1 篇）
+### [Agent Evaluation](./evaluation/)（2 篇）
 
 Agent 评估和测试框架的模式分析。
 
@@ -73,11 +73,25 @@ Agent 训练和微调相关的学习笔记。
 | P0 | [机器人情绪系统设计](./harness/robotics/emotion-system-design.md) | Harness | 机器人情绪 |
 | P0 | [AgentScope 实时语音](./harness/streaming/realtime-voice-agentscope.md) | Harness | 实时交互 |
 | P1 | [Bloom: Seed-driven 行为评估](./evaluation/seed-driven-evaluation/bloom-behavioral-evaluation.md) | Evaluation | 安全评估 |
+| P1 | [Opik Bloom 集成](./evaluation/opik-bloom-integration.md) | Evaluation | 评估集成 |
 | P1 | [结构化错误与重试](./harness/error-handling/structured-errors-retry.md) | Harness | 生产健壮性 |
 | P1 | [流式工具组装](./harness/streaming/streaming-tool-assembly.md) | Harness | 流式处理 |
+| P1 | [Codex LLM 抽象层](./harness/architecture/codex-llm-abstraction.md) | Harness | 架构设计 |
+| P1 | [Codex 流式处理](./harness/streaming/codex-streaming.md) | Harness | 流式架构 |
+| P1 | [Codex 上下文管理](./harness/context-management/codex-context-management.md) | Harness | 上下文管理 |
 | P2 | [上下文管理双模式](./harness/context-management/context-management-dual-mode.md) | Harness | 状态管理 |
+| P2 | [上下文转换比较](./harness/context-management/context-transformation-comparison.md) | Harness | 上下文转换 |
+| P2 | [会话历史管理](./harness/context-management/session-history-management.md) | Harness | 会话管理 |
 | P2 | [中间件/回调系统](./harness/middleware/middleware-callback-system.md) | Harness | 可扩展性 |
 | P2 | [状态快照并发](./harness/concurrency/state-snapshot-concurrency.md) | Harness | 并发 |
+| P2 | [Kimi CLI 架构](./harness/architecture/kimi-cli-architecture.md) | Harness | 架构设计 |
+| P2 | [Republic Anchor 机制](./harness/architecture/republic-anchor-mechanism.md) | Harness | 上下文切片 |
+| P2 | [流式比较](./harness/streaming/streaming-comparison.md) | Harness | 流式对比 |
+| P2 | [WebSocket 流式支持](./harness/streaming/websocket-streaming-support.md) | Harness | WebSocket |
+| P2 | [OpenAI WebSocket 比较](./harness/websocket/openai-websocket-comparison.md) | Harness | WebSocket |
+| P2 | [LLM 抽象比较](./harness/abstractions/llm-abstraction-comparison.md) | Harness | 抽象设计 |
+| P2 | [LLM 调用返回封装](./harness/abstractions/llm-call-return-encapsulation.md) | Harness | SDK 模式 |
+| P2 | [LLM 框架比较](./harness/abstractions/llm-framework-comparison.md) | Harness | 框架对比 |
 
 ---
 
@@ -154,4 +168,4 @@ docs/learns/README.md              # 更新统计
 
 ---
 
-*最后更新：2026-03-02*
+*最后更新：2026-03-04*

docs/learns/evaluation/README.md

@@ -20,6 +20,12 @@ Agent Evaluation 涵盖：
 |------|------|--------|
 | [Seed-driven Evaluation](./seed-driven-evaluation/) | 基于 Seed 的自适应行为评估模式 | 1 |
 
+### 其他文档
+
+| 文档 | 描述 | 优先级 |
+|------|------|--------|
+| [Opik Bloom 集成](./opik-bloom-integration.md) | 评估框架与观测平台集成，Bloom 后门检测与 Opik 可观测性结合 | P1 |
+
 ---
 
 ## 建议添加的主题
@@ -64,4 +70,4 @@ mkdir -p docs/learns/evaluation/backdoor-detection
 
 ---
 
-*最后更新：2026-03-02*
+*最后更新：2026-03-04*

docs/learns/harness/README.md

@@ -17,6 +17,7 @@ Agent 框架和编排工具的模式分析。
 | [流式工具组装](./streaming/streaming-tool-assembly.md) | 流式增量工具调用组装 | P1 |
 | [WebSocket 流式支持](./streaming/websocket-streaming-support.md) | WebSocket 流式设计模式 | P2 |
 | [AgentScope 实时语音](./streaming/realtime-voice-agentscope.md) | 统一事件驱动模型、多模型适配、语音聊天室广播机制 | P0 |
+| [Codex 流式处理](./streaming/codex-streaming.md) | WebSocket 实时对话、SSE 回退、增量请求优化 | P1 |
 
 ### [错误处理](./error-handling/)
 
@@ -35,6 +36,7 @@ Agent 框架和编排工具的模式分析。
 | [上下文管理双模式](./context-management/context-management-dual-mode.md) | 审计 vs Token 优化：Tape anchor 切片、历史处理器 | P2 |
 | [上下文转换比较](./context-management/context-transformation-comparison.md) | 上下文压缩和转换模式 | P2 |
 | [会话历史管理](./context-management/session-history-management.md) | 会话持久化和历史管理 | P2 |
+| [Codex 上下文管理](./context-management/codex-context-management.md) | Token 估算、上下文压缩、引用追踪 | P1 |
 
 ### [类型安全](./type-safety/)
 
@@ -68,6 +70,7 @@ Agent 框架和编排工具的模式分析。
 |------|------|--------|
 | [Kimi CLI 架构](./architecture/kimi-cli-architecture.md) | 分层架构：Soul/Wire/UI 分离、D-Mail、Steer 模式 | P2 |
 | [Republic Anchor 机制](./architecture/republic-anchor-mechanism.md) | Tape Anchor 上下文切片实现 | P2 |
+| [Codex LLM 抽象层](./architecture/codex-llm-abstraction.md) | ModelClient/Session 设计、WebSocket 预热、流式回退 | P1 |
 
 ### [抽象层](./abstractions/)
 
@@ -109,6 +112,9 @@ WebSocket 协议比较。
 | P0 | [AgentScope 实时语音](./streaming/realtime-voice-agentscope.md) | 实时交互 |
 | P1 | [结构化错误与重试](./error-handling/structured-errors-retry.md) | 生产健壮性 |
 | P1 | [流式工具组装](./streaming/streaming-tool-assembly.md) | 流式处理 |
+| P1 | [Codex LLM 抽象层](./architecture/codex-llm-abstraction.md) | 架构设计 |
+| P1 | [Codex 流式处理](./streaming/codex-streaming.md) | 流式架构 |
+| P1 | [Codex 上下文管理](./context-management/codex-context-management.md) | 上下文管理 |
 | P2 | [上下文管理双模式](./context-management/context-management-dual-mode.md) | 状态管理 |
 | P2 | [中间件/回调系统](./middleware/middleware-callback-system.md) | 可扩展性 |
 | P2 | [状态快照并发](./concurrency/state-snapshot-concurrency.md) | 并发 |
@@ -126,4 +132,4 @@ WebSocket 协议比较。
 
 ---
 
-*最后更新：2026-03-02*
+*最后更新：2026-03-04*