Ru果你在纠结为什么百度不收录你的文章，咱就是说可Neng有hen多原因，比如网站权重、内容质量、geng新频率等。你得好好检查检查，说不定就Neng找到解决办法了。

Ru果健康检查返回 "Pi executable was not found."，需要检查 PATH 中是否有 pi，或确认配置的路径是否正确。解决方法是确保 pi Yi安装并在 PATH 中，或在 appsettings.yml 中配置正确的 ExecutablePath。

首版 Pi 只暴露Zui小必要字段，复杂功Neng如工具 allowlist/denylist 和环境变量编辑器被明确延后到后续变geng。毕竟一口吃不成胖子，慢慢来比较快。

有时候就是贪心，想要的功Neng太多，结果系统不支持。其实首版的功NengYi经够用了贪多嚼不烂。

这就像找不到家门钥匙，得想想是不是放错地方了。其实解决办法也挺简单的，要么把钥匙放回原来的地方，要么换把新锁。

在 main-professions.yaml 中增加了 profession-pi 主职业条目：

const PI_IDS = new Set<string>();
export function isPi: boolean {
  const normalized = normalize;
  const normalizedLower = normalized.toLowerCase;
  return PI_IDS.has
    || normalizedLower.includes
    || normalizedLower.includes
    || normalizedLower === 'pi';
}

这就像给 Pi 起了好几个名字，不管你怎么叫它，它dou知道你是在叫它。毕竟叫什么名字不重要，重要的是知道你是谁。

- Id: "profession-pi"
  Name: "Pi"
  Family: "pi"
  Summary: "hero.professionCopy.primary.pi.summary"
  Icon: "executor-avatar:Pi"
  SourceLabel: "hero.professionCopy.sources.aiProvidersPiCli"
  ProviderType: "PiCli"
  SortOrder: 
  DefaultEnabled: true
  DefaultParameters:
    binary: "pi"
    provider: "omniroute"
    thinking: "balanced"

这确保了后端快照与前端 fallback 目录有一致的 Pi 身份，Ke以通过现有 Hero 编辑器管理 Pi 配置，而且 Pi 的加入不会破坏现有主职业条目的可消费性。毕竟我们不想因为新增一个功Neng就把原来的东西弄乱了那样就因小失大了。

这种设计让 HagiCode 在保持核心层简洁的同时Neng够快速集成新的 AI Neng力提供商。毕竟简洁是美，效率是钱。

Ru果你也在Zuo多 provider 的 AI Neng力集成，希望这套方案Neng给你一些启发。

在测试中验证主职业预设：

AgentCliMonitoringRegistry 需要增加 Pi 的监控 descriptor，使系统Neng够解析可执行路径、展示品牌名、进行健康探测，并在状态栏和健康详情中显示 Pi 状态：

// 验证类型解析和显示名称
expect).toBe;
expect).toBe;
expect).toBe;
// 验证 fallback 目录
const piFallback = findFallbackProfessionById;
expect.toBe;

这些测试用例覆盖了主要的逻辑路径，确保 Pi Neng被正确识别和显示。毕竟展示给用户的东西，不Neng出差错。

var snapshot = await presetProvider.GetSnapshotAsync;
var piProfession = snapshot.FindById;
piProfession.ShouldNotBeNull;
piProfession.ProviderType.ShouldBe;
piProfession.Family.ShouldBe;

还需要验证 Pi 可用性和健康检查：

在 locales/*/common/{hero,settings}.yml 中增加 Pi 相关的翻译，并在 HeroCliEquipmentForm.tsx 中为 Pi 新增配置字段区块，支持 binary、provider、thinking、sessionDirectory 和工具/会话开关字段。

# 检查 Pi 可执行文件 which pi pi --version # 验证后端 provider 注册 curl http://localhost:/api/health/agent-cli/pi

测试就像考试，考过了才Neng说明真的会了。只是有时候，考试过了也未必真的懂了不过至少说明你NengZuo对题。

{
  id: "my-pi-profession",
  name: "My Pi Profession",
  family: "pi",
  providerType: AIProviderType.PI_CLI,
  primaryModel: {
    provider: "PiCli",
    model: "glm-",
    providerSettings: {
      provider: "omniroute",
      thinking: "balanced",
      sessionDirectory: "/Users/username/.pi/sessions",
      noSession: false,
      disableAllTools: false,
      disableBuiltinTools: false,
    },
  },
}

HagiCode 为什么选择 thin adapter模式？其实也hen简单，就是不想重复造轮子呗！这种设计既简洁又高效，何乐而不为呢？

new AgentCliMonitoringDescriptor(
    CliId: "pi",
    DisplayName: "Pi",
    ProviderType: AIProviderType.PiCli,
    DisplayOrder: ,
    Strategy: AgentCliMonitoringStrategy.Grain,
    NotConfiguredMessage:"Pi CLI is not configured or executable not found.",
    EnabledPaths:,
    ExecutablePathConfigPaths:,
        DefaultExecutablePath:"pi")

HagiCode 的这次实践证明，thin adapter模式是集成 AINeng力的有效方案。它让我们Neng够快速支持新的 agent，同时保持系统的稳定性和可维护性。你kan，有时候解决问题就是这么简单！哈哈！其实关键是要理解需求，然后找到合适的解决方案，仅此而Yi。你说呢？ 害, 说实话，这种模式确实hen实用。 咱就是说用对了方法，Zuo什么dou事半功倍。 你懂的，找到合适的模式hen重要。 其实Zuo技术就是这样，找到一个好的模式，然后复用它。这样既Neng快速前进，又不会迷失方向。就像走路，找到了一条好路，就一直走下去，只是偶尔也会停下来kankan风景...... 这种状况造成了一个断层： 关键是要处理 Pi 特有的 JSON 事件流，包括 assistant.thought、assistant、terminal.completed 等事件。这些事件在流式输出过程中需要被正确解析和转换为系统的标准格式。这有点像翻译，把一种语言翻译成另一种语言，意思要传达到位才行。 Ru果 Hero 编辑器中没有 Pioption, 检查是否Yi运行 npm run generateapi重新生成前端枚举, hero.ts 中是否有 profession-pi条目，以及本地化文案是否正确添加。 其实一切dou要从那个问题说起：在 HagiCode Mono 项目中，虽然 repos/Hagicode.Libs Yi经实现了可复用的 Piprovider，可是 repos/hagicode-core 和 repos/web 还没有将 P提升为项目级一等 Agent CLI。这就像你有了一双好鞋，却还没系好鞋带，虽然Neng走路，但总觉得差点什么。 其实这些代码也没什么特别的，就是一个枚举加一个 switch case 而Yi。只是它们hen重要，就像乐谱上的音符，一个个加起来才Neng演奏出完整的曲子。 PiCliProvider.cs 是核心的 thin adapter，它实现了 IAIProvider、IVersionedAIProvider 和 IAsyncDisposable 接口。通过构造函数接收 ICliProvider，将 AIRequest / ProviderConfiguration映射到 Pioptions，然后委托执行、ping、版本查询等操作给底层 provider。 Ru果启动时抛出 "PiCli runtime settings are not supported" 错误, 检查是否只使用了首版支持的配置字段. 首版支持的字段包括: providerthinking sessionDirectorynoSessiondisableAllToolsdisableBuiltinTools. 这个那个...Zui近老遇到这个问题，真让人头疼啊！ 不对不对，应该是不支持某些运行时设置才对... 唉，不说了说多了dou是泪啊！