@blackbelt-technology/pi-harmic-messages (原始内容存档于2019-03-21)

(原始内容存档于2026-10-28). ReTIRED (2026-10-28). 解开这个包裹.

pi remove npm:@blackbelt-technology/pi-anthropic-messages
rm -f /tmp/pi-am.log   # versions ≤ 0.3.4 wrote every prompt here

现场测试显示工具重命名对克洛德订阅账单没有任何影响. 只有两行Pi的内置 docs 提示区块物质( “ pi 本身 ”, "皮包"). pi -agent -dashboard 现在用它来处理这个 克劳德 订阅比较 切换(默认关闭,在 anthropic 提供者行, 适用于主会话和流线剂 (单位:千美元)pi- agent- dashboard 键盘 f59e34aa3) (中文(简体) ). 此包中的工具重命名也会导致工具被去掉中聊天时产生400个. 将每个请求的有效载荷记录到世界可读的版本 /tmp/pi-am.log· ; 0.3.5 清除了伐木,是最后释放. 调查结果: docs/reports/2026-10-28-bridge-necessity-report.md。 。 。 .

与 pi 说话时的协议级桥 克劳德模型 人类信息端点——直接Anthropic(OAuth或API键), 9号路透社 cc/claude-*配有克洛德后端的Pi-model-proxy,或任何其他 代号: Claude 代码味的交通通过 人类信息消息API.

它会做什么

Claude Code的上行端点 接受完全三种花样中的工具:

1. Claude 核心代码工具 以警名命名—— Read, (中文(简体) ), Write, (中文(简体) ), Edit, (中文(简体) ), Bash, (中文(简体) ), Grep, (中文(简体) ), Glob, (中文(简体) ), AskUserQuestion, (中文(简体) ), Agent, (中文(简体) ), WebFetch, (中文(简体) ), WebSearch,, , , , , , , ,
2. MCP工具,即任何名字以 mcp__<server>__。 。 。 .
3. 原生工具 (单位:千美元)computer_use, (中文(简体) ), text_editor_20241022(......) (中文(简体) ).

pi-coding-agent 在小写名下注册其内置工具 (单位:千美元)read, (中文(简体) ), bash, (中文(简体) ), edit, (中文(简体) ), write, (中文(简体) ), grep)和扩展注册自定义 pi 工具在名称下 ask_user, (中文(简体) ), web_search, (中文(简体) ), fetch_content, (中文(简体) ), subagent没有一个符合克劳德密码的允许名单 没有干预,他们要么被剥去 或结束点芒果 他们有一个 _ide 后缀。 模特儿又回到幻觉中 bash_ide 而每个工具呼叫都失败了.

此扩展干涉协议层 :

• 出境 (单位:千美元)before_provider_request: 将 pi 工具名改写为 末端接受的东西。 Canonical pi 核心工具(read, (中文(简体) ), write, (中文(简体) ), bash, (中文(简体) ), grep成为他们的克洛德代码资本化(Read, (中文(简体) ), Write, (中文(简体) ), Bash, (中文(简体) ), Grep) (中文(简体) ). 其它的都已经不是了 mcp__*- 前缀或化名为Anthropic-native工具 mcp__pi__<name>。 。 。 . tool_choice.name 和历史 tool_use 块 消息历史得到相同的重写。 系统提示轻快 重写( n)pi → the cli所以克劳德密码的身份指纹不会 旅行在"pi"这个词.
• 入境 (单位:千美元)message_end:翻译模型重命名为工具的调用 在代理发送之前, 恢复到他们原来的 pi 名称, 所以存在 工具注册无需修改。 一个防守 _ide 后缀 脱衣舞可以处理克洛德代码端点操纵反应的个案. 直接以克洛德密码名称注册的工具(例如. Agent, (中文(简体) ), AskUserQuestion) 覆盖端到端:反向映射 包含一个身份条目 Agent_ide 将字条带回注册 Agent 处理者.

工具注册本身从未变异过 – 每个 pi 扩展 继续用原名登记其工具和桥梁 透明地处理翻译.

启动——单一紧门

桥只在这两个控件都用于活动时激活 会议模式:

1. ctx.model.api === "anthropic-messages"
2. /claude/i.test(ctx.model.id ?? "") ——型号代号包含: 大小写不敏感子字符串 claude

// Simplified:
function isClaudeAnthropicMessages(ctx) {
  return ctx.model?.api === "anthropic-messages"
      && /claude/i.test(ctx.model?.id ?? "");
}

当闸门失效时——即会话瞄准一个非克洛德模型在 人类信息(如:. 9Router/glm/glm-5, (中文(简体) ), 9Router/gemini/gemini-3-pro-preview或任意 api 其他 anthropic-messages —— 说 每个钩子处理器都是真的: 无工具 重命名, 无 mcp__pi__ 前缀,没有系统提示重写,没有反向映射, 没有 _ide 脱衣服 工具名流经Pi的注册,没有改变.

这是蓄意的: mcp__pi__ 名称空间和犬壳是 克劳德法典公约. 碰巧发言的非克劳德终点 人类信息格式不关心它们, 桥梁不应该 强制他们.

逃生舱

有两个环境变量 超过门 对于罕见的情况 与意图不符:

两者都需要 api === "anthropic-messages"。对于任何其它的 Api the 桥总是不开放.

对于软件包作者

简本

以自然名称注册工具 :

pi.registerTool({ name: "my_tool", /* … */ });

对于克劳德模型 人类信息会议,桥梁自动 发送 my_tool 接线为 mcp__pi__my_tool 并翻译 模型的回复 my_tool 在派来之前 为了其他一切 提供商(OpenAI、Google、Bedrock、非克洛德人类信息) 名称作为 -is 发送。 不需要配置 .

何时以冠名注册

如果你的工具拥有 确切名称和相容计划 带有 claude 代码工具( 见 Claude 代码工具参考, (中文(简体) ), 其准确资本化程度:

pi.registerTool({
  name: "Agent",          // matches canonical CC Agent tool
  parameters: /* … */     // schema compatible with CC's Agent
});

使Anthropic的地表变得土生土长 渲染(例如克劳德应用中的"代理"卡). 桥的 CC_CANONICAL_NAMES 设置列表中每个被接受的单词名称.

别 如果你的计谋与犬科不同.. 模型会产生幻觉 犬形的参数 和你的处理者 失败。 当有疑问时,请使用天然小写/ snake case 名称并让 页:1 mcp__pi__ 前缀处理它.

没有等同 pi 的工具

克劳德代码 WebSearch, (中文(简体) ), WebFetch, (中文(简体) ), AskUserQuestion, (中文(简体) ), TodoWrite, (中文(简体) ), NotebookEdit, (中文(简体) ), ExitPlanMode, (中文(简体) ), EnterPlanMode, (中文(简体) ), KillShell, (中文(简体) ), Skill, (中文(简体) ), 等无直接的pi等同. 你不需要做任何事情 关于 他们。 如果没有扩展登记这些名称下的工具,该模型 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}这段会话根本就没有它们 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}pi提供功能 等值 mcp__pi__* (单位:千美元)mcp__pi__ask_user, (中文(简体) ), mcp__pi__web_search, (中文(简体) ), mcp__pi__fetch_content,并使用该模型 换成这些.

Schema 适配器( 计划)

问题:名字别名还不够

重命名 web_search → WebSearch 电线上给模型一个 它从训练中认出了警犬的名字, 但模型后来叫 工具为 Claude 代码的预期输入形状而不是Pi's的。 \ N 这个 计划不匹配:

没有计划翻译, 仅名化名会导致模型发送 罐形输入( c){ query: "foo" }{\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}给一个想要派的经理 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080} 形状,它静静地工作,但 模型永远不会发现或使用pi的 较丰富的特征 (多清,复用,域过滤等.

解决方案:每个工具绑定适配器

从犬科化中受益的每个工具都有一个 工具键 与 一种可翻译出 canonical 有线电图和pi的调适器 处理器计划 :

export interface ToolBinding {
  /** Pi's registered tool name. */
  piName: string;

  /** Canonical name visible on the wire / to the model. */
  canonicalName: string;

  /**
   * Schema strategy:
   *   passthrough — pi's schema under the canonical name, zero translation.
   *   canonical   — canonical schema only; adaptInput required.
   *   hybrid      — canonical fields + pi-specific extras exposed.
   */
  schemaStrategy: "passthrough" | "canonical" | "hybrid";

  /** Schema sent to the model. Omitted for passthrough. */
  canonicalSchema?: TSchema;

  /** Reshape model's canonical input → pi handler's expected input. */
  adaptInput?: (wireInput: unknown) => unknown;

  /** Reshape pi's result → canonical result (rarely needed). */
  adaptOutput?: (piResult: unknown) => unknown;
}

这个 混合 战略是富于特色的pi工具的甜点: 揭开模型所训练的犬科领域 加号 特定 pi 额外,所以模型可以使用任意一种形状. 适配器恢复正常 无论模型产生什么结果.

计划的约束

适配器的数据流

  OUTBOUND (before_provider_request)
  ──────────────────────────────────
  1. Find binding by pi tool name
  2. Replace tool.name with binding.canonicalName
  3. If hybrid/canonical: replace tool.input_schema with binding.canonicalSchema
  4. Rewrite historical tool_use blocks in messages (name + input if needed)

  INBOUND (message_end)
  ─────────────────────
  1. Find binding by canonical name on tool_use block
  2. Restore tool_use.name to binding.piName
  3. If adaptInput defined: tool_use.input = binding.adaptInput(tool_use.input)
  4. Pi dispatches to original handler with pi-shaped arguments ✓

适应者实例 : web_search → WebSearch

// Hybrid schema: CC canonical fields + pi extras.
// Model can use either { query, blocked_domains } (CC-trained)
// or { queries, recencyFilter, numResults } (pi-specific).
const webSearchBinding: ToolBinding = {
  piName: "web_search",
  canonicalName: "WebSearch",
  schemaStrategy: "hybrid",
  canonicalSchema: Type.Object({
    query:             Type.Optional(Type.String()),
    allowed_domains:   Type.Optional(Type.Array(Type.String())),
    blocked_domains:   Type.Optional(Type.Array(Type.String())),
    // pi extras:
    queries:           Type.Optional(Type.Array(Type.String())),
    numResults:        Type.Optional(Type.Number()),
    recencyFilter:     Type.Optional(StringEnum(["day","week","month","year"])),
  }),
  adaptInput: (cc: any) => {
    const out: Record<string, unknown> = {};
    // Prefer queries[] over query (pi's richer multi-query)
    if (cc.queries?.length) out.queries = cc.queries;
    else if (cc.query)      out.query = cc.query;
    // Merge CC domain fields → pi's unified domainFilter[]
    const dom: string[] = [];
    if (cc.allowed_domains) dom.push(...cc.allowed_domains);
    if (cc.blocked_domains) dom.push(...cc.blocked_domains.map((d: string) => `-${d}`));
    if (dom.length)         out.domainFilter = dom;
    if (cc.numResults    !== undefined) out.numResults    = cc.numResults;
    if (cc.recencyFilter !== undefined) out.recencyFilter = cc.recencyFilter;
    return out;
  },
};

动态约束性登记

约束力可以两种方式登记:

1. 内建 ——运入 extensions/bindings/ 在此软件包中 建议的延长期限web_search, (中文(简体) ), fetch_content, (中文(简体) ), get_subagent_result) (中文(简体) ).

2. 动态 - 任何扩展可在运行时通过下列方式登记约束: 共享 globalThis 登记册,支持两个安装顺序 假设情况:

// In any extension's onLoad / session_start:
const registry = (globalThis as any).__piAnthropicBindings__;
if (registry) {
  registry.register({
    piName: "my_tool",
    canonicalName: "MyCanonical",
    schemaStrategy: "passthrough",
  });
}

桥上暴露了登记册 globalThis.__piAnthropicBindings__ 在负载时间。 如果桥没有安装,财产就不存在了 编辑 if (registry) 警卫是没有的——零接合.

对于 命令独立安装 (桥梁载重于其他 扩展),双方使用对称的放出和收听模式:

• 每个要注册有约束力电话的扩展名 declareToolBinding() 在负载时间。 这都释放了束缚 立即订阅未来 request_bindings 事情是这样 如果桥再装入的话,可以重新装入.
• 大桥订户 register_binding 事件和发射 request_bindings 已经运行的扩展重播.
• 结果:无论负载顺序如何,所有绑定物都趋同.

优先发言 resolveOutboundName (带有适配器)

适配器安装后,出站名称分辨率将获得新的 最高优先级:

  1. binding registry (new)     ← adapter-equipped, schema translation
  2. CC_CANONICAL_NAMES          exact-case passthrough (name only)
  3. already mcp__*              passthrough
  4. NATIVE_ALIASES (legacy)     name-only alias
  5. FLAT_TO_MCP                 companion aliases
  6. PI_TO_CC_CANONICAL          core tool capitalization
  7. default                     mcp__pi__<name>

测试战略

每个绑定适配器都是纯函数(wireInput → piInput测试 在隔离中——没有接线,没有钩子,没有嘲笑:

test("blocked_domains → negative domainFilter entries", () => {
  expect(webSearchBinding.adaptInput({
    query: "foo", blocked_domains: ["reddit.com", "x.com"]
  })).toEqual({
    query: "foo", domainFilter: ["-reddit.com", "-x.com"]
  });
});

test("queries[] preferred over query", () => {
  expect(webSearchBinding.adaptInput({
    query: "A", queries: ["B", "C"]
  })).toEqual({ queries: ["B", "C"] });
});

卡通式漂移

Anthropic可能会随着时间推移更新工具计划. 缓解:

• 保留 canonicalSchema 最小 - 只有地图字段我们实际上 翻译。 更小的地块 = 更小的漂移地表.
• 将 Claude 代码文件版本插入每个装订的评论中 .
• 混合战略是部分自愈——未知的犬种地 流经适配器未动(pi handler忽略了它们).

MCP 命名公约

MCP命名空间公约是 mcp__<server>__<tool> 地点 __ (双下划线)是分块划分符。 工具名称部分 - 第二次之后的任何东西 __ ——可自由包含单下划线:

mcp__pi__web_search               ✓  server=pi, tool=web_search
mcp__pi__get_subagent_result      ✓  server=pi, tool=get_subagent_result
mcp__exa__get_code_context        ✓  server=exa, tool=get_code_context

即使Claude代码的终点 附加它 _ide 后缀, 分隔符 __ 保存着 :

mcp__pi__web_search_ide           server=pi, tool=web_search_ide

该桥的倒图取景基于地图( 不) split("__")- 依据, 因此,工具机构的单一下划线永远不会与段相混淆 断取者. 这个 _ide 操纵是由一个后缀处理的 重试.

配置

大多数用户不需要任何配置. 默认的船是明智的 值 :

• CC_CANONICAL_NAMES - 确切的克洛德代码的术语 穿过没有改变.
• PI_TO_CC_CANONICAL 小写核心工具 资本化(read → Read, (中文(简体) ), write → Write, (中文(简体) ), bash → Bash, (中文(简体) ), grep → Grep) (中文(简体) ).
• FLAT_TO_MCP 著名的第三方伙伴, 反重力论.
• NATIVE_ALIASES —— 说 默认空输入 core-tools.ts 若为 您想要将一个 pi 工具化为其 Anthropic 本地当量(例如) . ask_user → AskUserQuestion) (中文(简体) ). 只有在你核实后才能启用 计划是相容的 输入.

环境变量

安装( 本地)

pi install -l /home/botond/pi-packages/pi-anthropic-messages

或者来自 GitHub (SSH):

pi install [email protected]:BlackBeltTechnology/pi-anthropic-messages.git

建议的挂板扩展

pi-agent-dashboard 装入船体的船体 包括这座桥(Claude-model) 人类信息提供者, @tintinweb/pi-subagents (代理卡UI), pi-flows (花仪表板), pi-web-access (网络工具),以及 pi-agent-browser (浏览器自动化).

仪表板的首次发射向导提示安装 软件包标签显示一个具有活安装/活性状态的推荐区域; 和横幅显示任何缺失 所需经费 进入直到它解决. 看仪表板 packages/shared/src/recommended-extensions.ts 显示为权威列表.

典型安装 :

# Required bridge (this package)
pi install [email protected]:BlackBeltTechnology/pi-anthropic-messages.git

# Strongly suggested
pi install npm:@tintinweb/pi-subagents
pi install [email protected]:BlackBeltTechnology/pi-flows.git
pi install npm:pi-web-access

# Optional
pi install npm:pi-agent-browser

与其他软件包的关系

• @earendil-works/pi-ai - 临爱的Anthropic供应商已经 将工具名称化( c)toClaudeCodeName当它检测到一个 证书我们的桥梁与这种行为是同理的: OAuth会话 pi-ai 重写 read → Read 在我们看到 有效载荷,我们的精确匹配检查 CC_CANONICAL_NAMES 发现 Read,我们通过它没有改变。 非奥特克劳德 人类信息会议(9个路透社) sk-* 键,pi-model-代用键, OAuth-订阅代理等),pi-ai无所事事,我们的桥也无所事事 做卡通化。 没有双重重命名,没有冲突.
• @benvargas/pi-claude-code-use - 被本套件取代,用于 此回转. 此套件有超组行为( 添加) mcp__ 自定义工具的前缀; Claude 模型检测上的门; 不 过滤工具).
• pi-flows ——其子剂侧工具前缀 (单位:千美元)extensions/flow-engine/tool-prefix.ts, (中文(简体) ), mcp__flows__) 手柄 正在处理 SDK 会话; 此软件包处理主会话 载荷。 两者相辅相成.
• pi-agent-dashboard ——按规定拉出这道桥来 建议任何Claude-model人类信息提供者的扩展 设置.

释放

释放通过 release-cut 技能和取消通过 release-revoke双脚走过飞行前 变换GELOG 校正 版本起伏 标记和推力 npm publish 发生在 GitHub 动作上.github/workflows/release.yml) (中文(简体) ). 发布工作流程也可以由 workflow_dispatch 从Actions UI中输入一个版本输入,该版本对跑者执行出击-承诺-tag-push.

导出 API

对于需要权威清单而不重复的消费者:

import {
  CC_CANONICAL_NAMES,
  PI_TO_CC_CANONICAL,
  NATIVE_ALIASES,
  FLAT_TO_MCP,
  DEFAULT_MCP_PREFIX,
  resolveOutboundName,
  transformPayload,
  buildReverseMap,
  lookupReverse,
  renameToolCallsInPlace,
  isClaudeAnthropicMessages,
} from "@blackbelt-technology/pi-anthropic-messages";