LLMWiki Agent Bridge

llmwiki-agent-bridge 是 LLMWiki 工具链中可选的源扇出与运行时合成层。它作为本地 HTTP 服务运行，从一个或多个 llmwiki-serve Knowledge Sources 收集证据，并返回一个包含引用、可选图上下文和追踪步骤的规范化答案工件。它既可以仅为首次冒烟测试运行“仅证据”模式，也可以调用配置好的运行时适配器生成合成答案。默认适配器面向 OpenAI 兼容的 chat completions。

在以下情况下使用它：

• 客户端希望只使用一个端点，而不必自行管理源扇出、提示词、运行时调用、引用和追踪信息整理。

• 你正在将 Hermes、DeepAgents 或通用本地运行时连接到 LLMWiki 证据。

• llmwiki-chat 或其他 UI 需要由本地 Knowledge Sources 支持的 Agent Bridge A2A 或 MCP 端点。

如果你的代理或脚本可以直接调用 llmwiki-serve 并自行管理答案合成，则无需使用它。

快速开始 | 选择路径 | 演示 | 运行时配置 | 消息契约 | OpenAPI | 集成 | 示例 | 文档门户 | 参与贡献 | 安全 | 支持 | 更新日志

公开预览说明：npm 安装适用于 llmwiki-agent-bridge@latest；对于本地开发和发布检查，仍支持源码检出。

如需可视化的首次运行演练，请参阅文档演示。它展示了工具链边界：上游工作流创建兼容的 Markdown/wiki 文件，llmwiki-serve 将它们以只读方式作为 Knowledge Sources 暴露出来，而可选的桥接层可以一起查询所选的服务源。

它不是仅限 Hermes 的桥接层。Hermes 只是 generic 和 deepagents 之外的受支持运行时配置之一；所有配置都使用相同的消息契约，并返回相同的 llmwiki_agent_result 工件结构。运行时配置标识运行时家族；运行时适配器决定桥接层如何调用它。

它是面向 LLM Wiki 风格 Markdown 知识文件夹和代理可读上下文的独立社区工具。它不是 Andrej Karpathy 或兼容性示例中提到的任何上游生产者的官方项目。

选择路径

只要你的客户端可以直接调用 llmwiki-serve，就从直接路径开始。当你需要扇出、运行时合成，或需要在一个本地服务之后获得单一规范化结果时，再加入桥接层。

直接客户端模板位于 集成。桥接层请求和工件契约记录在 docs/message-send-contract.md 中，并生成为 docs/openapi.json。

Related MCP server: A2ABench

快速开始

要求：

• Node.js >=22.12

• npm >=10

• 一个或多个正在运行的 llmwiki-serve Knowledge Source 端点

• 可选：用于合成的运行时。打包运行目前默认使用 OpenAI 兼容的 /v1/chat/completions 适配器。

• 从检出启动示例源时，需要 uv 和 Python 3.11 或更高版本

本快速入门在终端 1 中启动一个源服务器检出。在终端 2 中，常规本地运行请使用已发布的桥接包；如果你想运行仓库检查、查看打包示例或开发桥接层，请使用桥接层源码检出。

终端 1：源服务器

克隆并启动示例 llmwiki-serve Knowledge Source。让该进程持续运行：

git clone https://github.com/knowledge-bridge-labs/llmwiki-serve.git
cd llmwiki-serve
uv sync --extra dev
uv run llmwiki-serve serve ./examples/sample-wiki --host 127.0.0.1 --port 8765

终端 2：桥接层

在任意终端中，验证终端 1 正在提供示例源：

curl -s http://127.0.0.1:8765/manifest

启动已发布的公开预览包：

npx llmwiki-agent-bridge@latest

如果改为进行源码检出开发，请在包含 llmwiki-serve 检出的同一父工作区中打开终端 2，克隆桥接层，安装依赖项，运行本地检查，然后启动检出 CLI：

git clone https://github.com/knowledge-bridge-labs/llmwiki-agent-bridge.git
cd llmwiki-agent-bridge
npm ci
npm run check
node ./bin/llmwiki-agent-bridge.mjs

当桥接层开始监听时，CLI 会写入一个 JSON ready 事件：

{
  "event": "ready",
  "url": "http://127.0.0.1:8788",
  "sourcePolicy": "private-http"
}

对于基于运行时的答案合成，请使用与本地运行时匹配的运行时配置重启桥接层。这个通用示例适用于任何实现 OpenAI 兼容 chat completions 的运行时。

macOS/Linux：

LLMWIKI_AGENT_BRIDGE_BASE_URL=http://127.0.0.1:8642/v1 \
LLMWIKI_AGENT_BRIDGE_MODEL=local-model \
LLMWIKI_AGENT_BRIDGE_RUNTIME_PROFILE=generic \
npx llmwiki-agent-bridge@latest

Windows PowerShell：

$env:LLMWIKI_AGENT_BRIDGE_BASE_URL = 'http://127.0.0.1:8642/v1'
$env:LLMWIKI_AGENT_BRIDGE_MODEL = 'local-model'
$env:LLMWIKI_AGENT_BRIDGE_RUNTIME_PROFILE = 'generic'
npx llmwiki-agent-bridge@latest

从源码检出中，请使用 node ./bin/llmwiki-agent-bridge.mjs 或 node .\bin\llmwiki-agent-bridge.mjs 代替最后的 npx 命令。

对于 Hermes 或兼容 OpenAI 风格的运行时，请保持相同的命令形式，并更改 LLMWIKI_AGENT_BRIDGE_RUNTIME_PROFILE 及模型名称：

DeepAgents 直接提供商集成应以 ACP 为优先。官方 DeepAgents 文档将 deepagents-acp 描述为 ACP stdio CLI/编程 API。本包在 runtimeAdapter=deepagents-acp 之后附带一个可选的实时 ACP 子进程适配器。默认仍然是 chat completions；ACP 适配器为每个桥接运行时请求启动一个 deepagents-acp stdio 进程，在权限提示失败时使用 ACP cancelled 将其关闭，并将桥接请求超时应用于子进程清理。

保持桥接层运行。以下命令也是桥接层检出命令；如果终端 2 被桥接进程占用，请打开另一个提示符，并先运行 cd llmwiki-agent-bridge。

检查本地接口：

curl -s http://127.0.0.1:8788/health
curl -s http://127.0.0.1:8788/.well-known/agent-card.json
curl -s http://127.0.0.1:8788/settings.json

首次运行时，打开 http://127.0.0.1:8788/settings 并按照引导设置操作：

1. 当你需要合成时，连接运行时。设置运行时配置、基础 URL 和模型。页面通过 PUT /settings/config.json 保存这些字段。

2. 注册 Knowledge Sources。在 http://127.0.0.1:8765 添加示例源，将其标记为就绪并选中，然后通过 GET/PUT /settings/sources.json 保存。

3. 验证桥接层。运行设置页面中的验证，该验证使用已注册的源发送 POST /message:send，并显示返回的答案工件、引用、图和追踪步骤。/message:send 默认为 delegated-runtime，因此此设置页面检查预期配置的运行时是可达的。对于无运行时冒烟测试，请使用下面的仅证据示例请求。

运行时凭据、网络、认证、CORS、超时和源策略控制位于 diagnostics/advanced 下。大多数本地 OSS 用户只需上述三个设置步骤。

对于仅从包启动的无运行时冒烟测试，请发送一个内联的仅证据请求：

curl -s http://127.0.0.1:8788/message:send \
  -H 'content-type: application/json' \
  -d '{"data":{"query":"release readiness","mode":"evidence-only","knowledgeSources":[{"id":"sample-wiki","name":"Sample Wiki","protocol":"llmwiki-http","status":"ready","url":"http://127.0.0.1:8765","selected":true}]}}'

从 llmwiki-agent-bridge 源码检出中，你可以发送捆绑的等效请求，使 --data @examples/message-send.local.json 路径解析到本仓库：

curl -s http://127.0.0.1:8788/message:send \
  -H 'content-type: application/json' \
  --data @examples/message-send.local.json

捆绑的 examples/message-send.local.json 指向 http://127.0.0.1:8765，并将 mode 设置为 evidence-only。如果你的 llmwiki-serve 或桥接进程使用不同的端口，请将该文件复制到临时路径，更新源 URL，然后将其发送到你启动的桥接 URL。

MCP 风格的客户端可以在 /mcp 上通过 initialize、notifications/initialized 和 ping 完成基本生命周期，然后列出桥接工具。当你希望桥接层生成完整的、有依据的答案时，请使用 llmwiki_agent_run；当你的宿主代理希望逐步检查源时，请使用只读源工具：

curl -s http://127.0.0.1:8788/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"1"}}}'

curl -s http://127.0.0.1:8788/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"ping"}'

curl -s http://127.0.0.1:8788/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/list"}'

curl -s http://127.0.0.1:8788/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"llmwiki_agent_run","arguments":{"query":"release readiness"}}}'

curl -s http://127.0.0.1:8788/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"llmwiki_context","arguments":{"sourceId":"sample-wiki","query":"release readiness","limit":5}}}'

curl -s http://127.0.0.1:8788/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":6,"method":"tools/call","params":{"name":"llmwiki_graph_neighbors","arguments":{"sourceId":"sample-wiki","nodeId":"sample-wiki:overview","direction":"out","relation":"supports","limit":20}}}'

省略 knowledgeSources 以使用通过 /settings 注册的源。传递 knowledgeSources: [] 表示“不携带源运行”，仅用于负面测试。人类可读的源列表省略了端点 URL。结构化的 llmwiki_sources.sources 描述符包含源 URL，因此本地工作台可以选择由桥接层管理的源，并将其传回 /message:send。不要将私有本地 URL 复制到公开文档、问题或示例中。

示例请求询问 release readiness。确切的答案措辞可能因运行时而异；稳定的集成目标是已完成的任务加上 llmwiki_agent_result 数据工件字段：

{
  "answer": "Grounded answer text from the configured runtime.",
  "citations": [
    {
      "sourceId": "sample-wiki",
      "pageId": "release-readiness",
      "title": "Release Readiness",
      "score": 0.92
    }
  ],
  "graph": {
    "nodes": [],
    "edges": []
  },
  "steps": [
    {
      "id": "bridge-evidence",
      "label": "Prepare evidence",
      "status": "done"
    },
    {
      "id": "runtime-chat-completions",
      "label": "Call chat completions",
      "status": "done"
    }
  ]
}

有关完整的载荷和本地设置说明，请参阅 示例、运行时配置、消息契约 和 客户端路径。

它的作用

桥接层暴露一个很小的本地 HTTP 接口：

对于每个 POST /message:send 请求，桥接层：

1. 从请求中选择就绪的知识源描述符。

2. 通过 llmwiki-http、MCP 风格 JSON-RPC 或 A2A 风格 HTTP 获取上下文。

3. 打包引用、图上下文、源包元数据和追踪步骤。

4. 在 delegated-runtime 或 hybrid 模式下，将证据包渲染为紧凑 JSON，并调用已配置的 OpenAI 兼容 /v1/chat/completions 端点。

5. 在 evidence-only 模式下，跳过运行时调用，返回桥接层生成的证据摘要。

6. 返回答案文本以及 llmwiki_agent_result 产物。

POST /mcp 暴露两层能力。llmwiki_agent_run 调用与 /message:send 相同的内部运行路径，返回文本内容外加 structuredContent.llmwiki_agent_result。只读源工具 llmwiki_list_sources、llmwiki_context、llmwiki_search、llmwiki_read、llmwiki_graph、llmwiki_graph_neighbors 和 llmwiki_source_bundle 不会调用已配置的运行时；它们让宿主代理先列出源、读取以导览为主的上下文、搜索、打开页面、检查图数据、遍历有界邻域或读取安全的源包元数据，由宿主代理自行决定是需要进一步探索源，还是需要一次完整的回答运行。

对于不启动 HTTP 服务的本地运维检查，可使用 llmwiki-agent-bridge sources --json、llmwiki-agent-bridge ls 或 llmwiki-agent-bridge status --probe。CLI 输出会读取本地设置文件，并可能显示已存储的本地根目录用于诊断。HTTP 注册表响应会将绝对根目录脱敏为安全标签，并在 PUT /settings/sources.json 上拒绝重复的源 ID。

请求可以直接提供 knowledgeSources，也可以省略它们并使用桥接层已注册的知识源。可在 /settings 的步骤 2 中注册源，或调用 PUT /settings/sources.json 并提供 sources 数组。多个就绪且被选中的源可在一次运行中注册并查询。源调用在内部受限，而不会以不受限并行的方式发出。返回的产物会按所选源顺序进行归一化，以便于呈现引用、图数据、源包、追踪步骤、诊断信息以及各源失败信息。

/message:send 保留旧有的 data.query 约定，同时接受附加对话运行时上下文：data.message 或顶层 A2A message、data.messages、data.threadId、data.sessionId、data.turnId、data.runtimeContext.conversation、A2A 风格 configuration.historyLength 以及 A2A 风格 metadata.threadId/sessionId/turnId。桥接层使用 data.query 当前查询或 A2A 消息文本来进行源检索，然后在证据系统提示之后，将有限大小的用户/助手历史记录纳入每次运行时聊天补全调用。

检索模式路由

客户端可以选择通过 data.retrieval 请求源的检索模式。这个与 data.mode 是分开的：data.mode 和 data.orchestrationMode 控制桥接层编排，而 data.retrieval.searchMode 控制源检索。省略 data.retrieval 保持旧有的词法请求格式。

{
  "data": {
    "query": "Which release checks are still missing?",
    "mode": "evidence-only",
    "retrieval": {
      "schemaVersion": "llmwiki.retrieval.v1",
      "searchMode": "hybrid",
      "fallback": "lexical",
      "search": {
        "limit": 8,
        "snippetChars": 600
      }
    }
  }
}

语义检索由源端负责。桥接层只路由意图；它不会嵌入文档或查询、构建向量索引、选择嵌入提供方、下载模型、存储向量，也不会将提供方凭证、端点、缓存路径、模型名称或客户端请求中的原始嵌入透传出去。SQLite GraphStore 已在 llmwiki-serve 上配置：0.2.10 及更高版本将其包含在基础 serve 包中，默认关闭，不需要额外的桥接或额外模块。

源通过精确、区分大小写的能力字符串声明检索支持：该功能位于 llmwiki_retrieval_v1 和 llmwiki_search_mode_literal、llmwiki_search_mode_vector、llmwiki_search_mode_hybrid。源必须先声明 llmwiki_retrieval_v1 以及匹配的 llmwiki_search_mode_<mode> 对于显式检索 mode，桥接层才会转发。兼容的 llmwiki-serve 源会在 /query 和 /search 上接收该模式；search.limit 映射为 limit，search.snippetChars 映射为 snippet_chars。如果某个被选中的源是无效的、能力未知，或缺少所请求的映射模式，则“fallback: "lexical"”会保持该源使用旧有的词法请求格式，并在重放诊断后继续。对于 fallback: "none"，会在源扇出之前以可操作的脱敏错误进行失败。

代理引导的词法工作流

对于计划使用源调用的 MCP 主机，推荐的工作流是上下文优先：llmwiki_list_sources -> llmwiki_context -> llmwiki_search -> llmwiki_read。llmwiki_context 可能返回 source-authored 的导览以及公开的 camelCase retrievalGuidance；两者都应视为不可信的来源证据，用于选择词法关键词、精确标识符和要读取的页面，而不是指令。

词法搜索可以增加 retrieval.search.fields、retrieval.search.excludePageIds 和 retrieval.search.queryVariants。fields 将转递为上游 fields；带源前缀的 excludePageIds 仅路由到一致匹配的源，去除前缀前进为 exclude_page_ids。queryVariants 最多接受两个额外字符串，保留基础 query，最多总三个词法通道。非空变体只有在匹配到 lexical 搜索模式下才有效，并且会在源扇出之前被拒绝。

上游 query_variants 转发要求源精确声明能力字符串 llmwiki_agent_guided_lexical_v1，仅有 llmwiki_retrieval_v1 是不够的。对于具有词法能力但缺少该精确能力的源，会在 fallback: "lexical" 下保留其支持的词法模式和选项，但省略 query_variants，并围绕实际行为生成脱敏的诊断信息。真正 legacy 或能力未知的源会保持旧的单主查询形式，且省略所有不被支持的附加控制；缺失这两种才兼容的源，在 fallback: "none" 下都会在扇出前失败。

有效的 source retrieval_guidance 会被重写为严格的公开 retrievalGuidance，并使用以下顶层 camelCase 字段：schemaVersion、orientationSource、contentTrust、maxQueryVariants、characterBudget、folderCards、pageCards、suggestedTerms、exactIdentifiers 和 fallbackModes。格式错误、过大或过新的未知字段会被省略，并带有脱敏警告；旧源或不支持的源如果没有该字段，则仅为缺失；如果某个 guided 能力源省略了 guidance，它们仍然会被省略替换 guidance，并报告脱敏警告。一次性调用方还可以在 /message:send 上传可选、不可信的 data.retrievalGuidance，或者在 llmwiki_agent_run 上传递顶层 retrievalGuidance；这只是位于 retrieval 之外的默默不显示、非指令性的来源证据。一次运行的仍只收集一次证据，并不暗示运行时工具循环。

安全请求审计日志

设置 LLMWIKI_AGENT_BRIDGE_AUDIT_LOG=1 或传入 auditLog: true，就可以通过现有 logger（默认 stdout）为每个桥接审计请求输出一行 JSON。审计路径包括 /message:send、/mcp、/settings、/settings.json、/settings/config.json、/settings/sources.json、/.well-known/agent-card.json 和 /health。

审计事件是刻意的白名单。它们可能包含路由模式、状态、持续时间、请求/追踪 ID、编排模式、是否调用运行时、源和产物计数、会话计数/布尔字段以及脱敏标志。它们不包括原始 prompt、答案、请求或响应体、查询字符串、源 URL、运行时基础 URL、模型名称、API keys、bearer tokens、本地路径、线程/会话 ID 或会话消息内容。

默认 I/O 调试日志

桥接层还会默认向 .runtime-logs/llmwiki-agent-bridge-io.jsonl 输出一条默认开启的 JSONL I/O 调试流。这些事件使用 llmwiki.agent_bridge.io 记录，供本地排查 /message:send 请求、源、运行时和最终产物流程时使用。

I/O 日志可能会在脱敏后包含 prompt、源请求/响应体、运行时调用、运行时答案以及桥接层最终产物。它们始终会重写诸如 Authorization 和 credential-like 请求头、API key、bearer token、源/运行时 URL、URL 签发参数以及明显的本地绝对路径。该日志流与安全审计日志是故意分离的。

设置 LLMWIKI_AGENT_BRIDGE_IO_LOG=off 或持久化 "ioLog": false 可关闭 I/O 日志。设置 LLMWIKI_AGENT_BRIDGE_IO_LOG=logger 或 stdout 会改为通过进程 logger 输出 JSONL。LLMWIKI_AGENT_BRIDGE_IO_LOG_PATH 用于指定文件路径。

flowchart LR
  client["client or chat workbench"]
  bridge["llmwiki-agent-bridge"]
  sources["selected Knowledge Sources"]
  runtime["OpenAI-compatible runtime"]
  artifact["answer artifact<br/>citations, graph, trace"]

  client --> bridge
  bridge --> sources
  sources --> bridge
  bridge --> runtime
  runtime --> bridge
  bridge --> artifact

支持的知识源协议：

生成的 OpenAPI 契约在 docs/openapi.json 归档。它覆盖桥接层的本地 HTTP 接口，并将 llmwiki_agent_result 产物形态定义为公开预览兼容契约，而不是被认证为 A2A 一致性。该包包含 @a2a-js/sdk@0.3.14 进行 A2A 发现兼容性检查，同时保持现有 /message:send 路由稳定。

运行时配置文件

配置文件是基于同一桥接契约的保守配置预设。 它们会更改运行时身份元数据、默认模型命名以及面向操作员的配置；但不会更改 LLMWiki 证据格式。 紧凑 JSON 是当前运行时提示证据的编码格式。广泛的生产默认批准是一个证据声明，受所跟踪的运行时提示批准端到端（e2e）测试的门禁约束，而不是配置文件切换。

旧的 HERMES_* 和 HERMES_A2A_BRIDGE_* 环境变量别名仍然可用于迁移。新的部署应优先使用 LLMWIKI_AGENT_BRIDGE_* 变量。

更多详情：docs/runtime-profiles.md。

包的公开入口

llmwiki-agent-bridge 随附一个 Node 包，包含以下公开入口点：

公共预览包可通过 llmwiki-agent-bridge@latest 获取。无需全局安装即可运行：

npx llmwiki-agent-bridge@latest

或者安装该包并运行 CLI：

npm install --global llmwiki-agent-bridge@latest
llmwiki-agent-bridge

源码检出仍然是受支持的开发路径：

npm ci
npm run check
node ./bin/llmwiki-agent-bridge.mjs

集成路径

当代理能够安全地从 llmwiki-serve 自身检索上下文时，直接客户端集成是最好的首选。当客户端希望由一个本地服务来收集证据、调用运行时并返回规范化结果时，桥接集成更合适。

• 客户端路径指南

• 集成概览

• Codex 技能示例

• Claude Code 命令示例

• Copilot 指令示例

若要让代理直接使用，请运行 llmwiki-serve，设置 LLMWIKI_SERVE_URL，并调整 integrations/ 中的模板。这些示例首先调用 /query，然后调用 /search、/read/{page_id}、/graph 或 /mcp 以进行更精细的检查。

export LLMWIKI_SERVE_URL=http://127.0.0.1:8765

当工作流还需要源扇出、运行时汇总和一个规范化的答案工件时，请使用 llmwiki-agent-bridge。

配置

大多数本地运行只需要运行时基础 URL、模型、配置文件和可选的桥接 Bearer 令牌。除非你在测试显式的适配器集成，否则请让 runtimeAdapter 保持默认值：

源策略、CORS、绑定主机与迁移别名的详细信息记录在 运行时配置文件 和 客户端路径 中。

该实现为向后兼容保留了 Hermes 默认值。对于新的 OSS 安装，除非你要连接 Hermes 或 DeepAgents，否则请显式设置 LLMWIKI_AGENT_BRIDGE_RUNTIME_PROFILE=generic，并设置该运行时期望的模型名称。

在未设置 LLMWIKI_AGENT_BRIDGE_BEARER_TOKEN 的情况下，不要将桥接暴露在公共或共享接口上。非回环绑定需要显式选择加入，公共且未认证的绑定仅是开发专用的逃生通道。

/settings 页面是基于同一配置的引导式首次运行 UI。第 1 步通过 PUT /settings/config.json 连接运行时并保存配置文件、基础 URL 和模型。第 2 步通过 GET/PUT /settings/sources.json 保存可复用的 Knowledge Source 描述符。第 3 步从页面发送 POST /message:send 并展示返回的工件，从而验证桥接。运行时凭据、高级网络、认证、CORS、超时和源策略字段仍可在 diagnostics/advanced 下使用；对实时运行时字段的更改会应用到正在运行的进程。绑定的 host 和 port 会为下次启动保存，保存响应会在 restartRequired 下列出它们。

编程式 API

import { startAgentBridge } from 'llmwiki-agent-bridge'

const { server, url } = await startAgentBridge({
  port: 0,
  baseUrl: 'http://127.0.0.1:8642/v1',
  model: 'local-model',
  runtimeProfile: 'generic',
})

console.log(url)
server.close()

迁移期间仍可使用旧的 createHermesA2aBridge 和 startHermesA2aBridge 导出。

仓库结构

发布状态

llmwiki-agent-bridge 目前处于公开预览阶段。npm 包已发布，并支持基于包的 npx llmwiki-agent-bridge@latest 或 npm install --global llmwiki-agent-bridge@latest 命令用于本地使用。源代码检出仍受支持，可用于开发、仓库验证和发布检查。

仓库、Issue、CI 徽章、包和托管文档 URL 均有意指向 Knowledge Bridge Labs 组织。托管的 Release Status & Compatibility 矩阵记录了当前可用的包和运行时路径。

在准备、发布或标记下一个公开预览版本之前，请参阅 docs/release.md。

开发

npm run lint
npm run contracts:check
npm test
npm run pack:dry-run
npm run audit

npm run check 会运行 lint、生成契约漂移检查、测试和试打包。

工具链

社区

在提交 pull request 之前，请阅读 CONTRIBUTING.md，保持更改聚焦于桥接契约，并包含验证结果。

请使用 GitHub Issues 提交可复现的 Bug、聚焦的功能请求、运行时或协议兼容性说明以及文档缺口。请保持示例公开且经过脱敏；不要包含凭据、Bearer 令牌、私有端点 URL、原始敏感 wiki 内容或私有运行时日志。

• Bug 报告

• 运行时或协议兼容性

• 功能请求

• 文档问题

• 安全策略

• 支持指南

• 行为准则

对于漏洞，请遵循 SECURITY.md，而不要打开包含详细信息的公开 Issue。

许可证

Apache-2.0。参见 LICENSE。