``html

<对应代码路径:

一、整体架构

继承层次

• :
  • Kodex这方面，QwenPawAgent → CodingModeMixin → ToolGuardMixin → ReActAgent → AgentBase.
  • *User Pain Point:* “为何每一次调用都要走安全检查？我只想快速执行，” —— 正是 ToolGuard & CodingMode 两个 Mixin 的使命。
  • 至于*设计理念，* 使用 Python MRO 建立“洋葱中间件”。让主要方法 `_acting` 被多重拦截而不破坏原有循环。
  • 至于*替代方案。* 若采用组合或装饰器，则需显式转发每个方法，失去透明度与灵活性。

  模块文件一览

  初始化流程

  文件/目录	作用
  react_agent.py	主要 agent 类 – 初始化 ‑ 工具注册 ‑ 技能加载 ‑ system prompt 建立 ‑ ReAct 循环重写
  coding_mode_mixin.py	编码模式 mixin – 注入编码提示词 ‑ 注册 LSP / AST 工具
  tool_guard_mixin.py	安全守卫 mixin – 拦截所有 tool 调用 ‑ 审批流程
  command_handler.py	程序命令处理器 – `/compact`。 `/new`,`/clear`…
  model_factory.py	模型工厂 – 创建模型实例 + Formatter
  – AGENTS.md/SOUL.md/PREPROFILE.md 加载并拼接 system prompt.	"模板+占位符"方式，让非技术使用者也能轻松调优人格与行为准则。"，*User Pain Point:* “我想改名字或语气，却得改代码。” - PromptBuilder 把这些文本抽象出来只需编辑 Markdown 文件即可。按理说，🛠️ *实现方式:* `PromptBuilder._process_memory_section` 自动替换 `<-- memory:start -->...` 标记为实际记忆内容。

---