Loushang核心概念解析:Method、Session、Tool与模型Provider如何协同工作

原创2026-10-10 15:37:291,726 阅读

Loushang核心概念解析:Method、Session、Tool与模型Provider如何协同工作

Loushang 是一个用 Python 构建的 AI-native agent harness(智能体执行框架),专为 coding 工作流设计:多模型 LLM 编排、有状态会话、工具治理与可追踪交付,支持 GPT、Claude、DeepSeek、Qwen、Kimi、GLM、MiniMax 等 Provider 路由。本文用最少的术语帮你搞懂它的四大核心概念——Method、Session、Tool、Model Provider,以及它们在一次编码任务中是如何协同运转的。

Loushang 未来目标架构图:Method 工作契约、Agent + AI + 已授权工具、Session 持久记录等模块协同示意

图:Loushang 架构中 Method、Agent、AI 与 admitted tools 的协作关系

一、Method:给 AI 定一份"工作契约" 📋

普通 AI 助手靠临场发挥,而 Loushang 的 Method(方法) 是一份面向一类任务的结构化工作契约。它明确规定:

  • 适用条件:什么场景下启用该方法
  • 角色与阶段:agent 应扮演什么角色、当前工作处于哪个阶段
  • 流程与约束:按什么顺序推进、有哪些检查点(gates)
  • 产物与验收:应产出什么 artifact、如何算"完成"

简单说,Method 让 AI 从"聪明地瞎干"变成"按合同交付"。核心类型定义在 types.py,如 MethodDescriptor(方法描述)、MethodStep(方法步骤)、MethodPlan(执行计划)等,配合 registry.py 完成方法的注册与选择。Loushang 的长期目标是让 Method 成为可执行、可改进的资产,而不是一纸静态流程文档。

二、Session:可恢复、可分叉的持久会话 💾

Session(会话) 是一次 coding 交互的持久记录,而不仅是聊天窗口。它保存:

  • 消息与工具调用事件(tool events)
  • 模型用量(usage)与成本
  • 诊断信息与执行上下文

关键在于这些记录可恢复(resume)、可分叉(fork)、可导出(export)——中途断了、上下文炸了,都能从会话状态继续工作。这是 Loushang 与"一问一答"型 AI 的根本区别:会话是运行时事实的账本,而不是易失的对话流。

三、Tool:受策略治理的可执行能力 🔧

Tool(工具) 是提供给 agent 的可执行能力,比如读写文件、执行命令、调用内置 bash。Loushang 的 Tool 设计有两个原则:

  1. 策略治理(governed by policy):工具不是"能发现就能用",而是经过准入(admission)后挂载到具体作用域,权限、审批、沙箱都由策略层统一管控
  2. transcript 中清晰呈现:每次工具调用都会在会话记录中留痕,事后可审计、可回放

执行内核位于 agent_loop.py,Agent Loop 负责"模型输出 → 工具调用 → 结果回灌"的循环。架构图中也强调:Agent 依赖 AI 与已准入工具(admitted tools),工具运行受策略约束,它不额外获得权威。

四、Model Provider:模型目录驱动的 Provider 路由 🌐

Model Provider(模型供应商) 在 Loushang 中是一个组合概念:Provider 身份、endpoint 语义、模型能力、认证、默认值、兼容规则与价格元数据。你不需要硬编码任何一家 API 的细节——一切通过**模型目录(model catalog)**解析:

  • 内置目录:models.json 声明了 GPT、Claude、DeepSeek、Qwen、Kimi、GLM、MiniMax 等可用模型
  • 注册与解析:ModelRegistry 负责模型查找与能力声明
  • 路由机制:ProviderRegistry 中的 ProviderRoute 把请求路由到正确的供应商端点

上层代码只需"我要一个能做 X 的模型",目录层负责回答"该走哪家、怎么认证、多少钱"。这正是多模型 LLM 编排的含义:同一套会话与工具,可在不同 Provider 间切换而不改业务逻辑。

五、四者如何协同?一次编码任务的完整链路 ⚙️

把四个概念串起来,Loushang 的一次编码任务是这样运转的:

  1. Method 选中 —— 根据任务类型选择适用的方法,确定角色、阶段与验收标准
  2. Session 建立 —— 创建持久会话,方法上下文写入记录,随时可恢复
  3. Provider 路由 —— 模型目录解析出目标 Provider 与模型,完成认证并发起调用
  4. Agent Loop 执行 —— 模型产生工具调用,Tool 在策略治理下执行(读文件、改代码、跑命令),结果写回 Session
  5. 验收交付 —— 按 Method 约定的 artifacts 与检查点产出可验证的工作结果

用一句话总结分工:Method 定义"怎么干",Session 记录"干到哪",Tool 提供"怎么执行",Provider 决定"谁来思考"。四者各司其职,构成一套可恢复、可审计、可交付的复杂工作系统。

六、概念速查表

概念 一句话定位 源码/文档入口
Method 结构化工作契约(角色/阶段/流程/验收) src/loushang/method/
Session 可恢复、可分叉的持久执行记录 docs/zh-CN/concepts/README.md
Tool 受策略治理的可执行能力 src/loushang/agent/
Model Provider 模型目录驱动的多供应商路由 src/loushang/ai/

七、想深入?从这里开始 📚

掌握这四个概念,你就理解了 Loushang 的设计哲学:不只是让 agent 更聪明,而是让复杂工作变得可靠、可恢复、可审计、可交付。

登录后查看全文
loushang