Symphony

Symphony Codex IPC/MCP 与 Skills

独立仓库：QuanuX/symphony-codex-ipc-mpc-and-skills。实现的协议为 MCP（Model Context Protocol）；历史迁移记录保留了之前的仓库拼写。运行时版本：0.1.0-alpha.1。

一个 C++26 MCP 桥接工具、Codex 技能/插件，以及可复用的客户端适配器，用于直接管理指定的 Symphony 安装。发布者：QuanuX，quanux.org。

这是单独维护的集成，并非 Symphony 模块。它无需检出 Symphony 源代码即可构建，并连接到明确指定、独立安装的 qxctl。迁移溯源记录了原始来源和历史测试证据。

桥接工具会发现所选 qxctl 的实际命令注册表，公开准确的命令说明，执行读取操作，并预览/应用已配置的管理操作。它保留 qxctl 作为 Symphony 的操作接口，并遵循原生所有者的身份、权限、回执、版本和恢复规则。它不会新增向量或强制工作负载依赖。用户模块和组合仍保持开放。

这是本地 Alpha 候选版本，并非经 OpenAI 批准的目录发布版本。当前兼容性明确锁定于 MCP 2025-11-25 协议。请参阅验证、主机兼容性和公开提交要求。

构建并连接

要求：macOS 或 Linux；支持 C++26 草案模式（-std=c++2c）的编译器、CMake 3.30+，以及用于配置/测试的 Python 3.11+。Linux 还需要 OpenSSL 3 开发文件。nlohmann/json 3.12.0 已随附，并包含其许可证。构建期间不会下载依赖项。

git clone https://github.com/QuanuX/symphony-codex-ipc-mcp-and-skills.git
cd symphony-codex-ipc-mcp-and-skills
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j 4
ctest --test-dir build --output-on-failure
cmake --install build --prefix "$PWD"

将二进制文件构建到 bin/ 后，使用 codex plugin marketplace add "$PWD" 注册此检出版本随附的 marketplace。在 Codex Plugins 中，打开 Personal → QuanuX — Symphony Codex IPC/MPC and Skills，安装 Symphony，然后使用其设置技能选择你的 qxctl。该仓库包含源代码；仅克隆仓库不会提供平台可执行文件。现有已安装的演示包仍是锁定的副本，不会因本次仓库迁移而被替换。

明确选择一个支持注册表的 qxctl 安装，以及一个现有工作目录（用于仓库检查命令时，请使用 Symphony 仓库）：

python3 scripts/configure_connection.py \
  --qxctl /absolute/installation/bin/qxctl \
  --working-directory /absolute/Symphony \
  --output /absolute/private/connection.json

python3 scripts/configure_clients.py --client codex \
  --binary /absolute/plugin/bin/symphony-mcp \
  --config /absolute/private/connection.json

第二条命令会输出客户端配置片段；请检查并将其添加到目标主机配置中。其他 MCP 客户端可使用 --client claude、antigravity 或 generic。这些命令既不会安装到主机，也不会覆盖现有配置。完整插件安装则会从主机文档指定的插件数据目录读取连接配置文件；请参阅主机配置。

配置文件默认仅启用读取操作。创建配置文件时，添加 --enable EXACT_COMMAND_ID，即可开放委托给 Agent 的特定非读取操作。连接配置文件说明了锁定、环境变量转发、限制和替换。原生权限仍然适用。对于没有 commands manifest --json 的较旧 qxctl，系统会明确拒绝；适配器绝不会自动升级它。

Agent 接口

工具	用途
symphony_connection	可执行文件／注册表绑定、桥接限制和已启用的能力；不推断服务健康状况
symphony_discover	在实际安装的注册表中分页搜索
symphony_describe	精确的命令语法、标志、可变性、权限、所有者协议和恢复方式
symphony_read	直接执行已注册的只读操作
symphony_prepare	为已启用的非只读操作预览参数；预览有效期为 5 分钟，与会话绑定且仅限单次使用
symphony_apply	执行该预览一次，同时保留原生权限并谨慎处理不确定性

此软件包还提供连接／用量资源和 symphony-admin 提示词。技能通过各自实际的所有者，引导用户完成发现、管理、身份／审计、知识库、提供商／硬件／节点工作流、定量研究和操作恢复。可用性取决于所选安装；命令存在并不能证明引擎已部署、凭据或授权已配置、提供商已连接或服务健康。

传输预览并非原生所有者计划。对于适用的操作，原生预期状态检查和持久化操作 ID 仍然至关重要。输出有大小限制，并保留退出代码／stdout／stderr；它绝不会将进程退出代码 0 等同于语义上的成功。变更期间若发生超时、响应丢失或输出超限，必须先向所有者查询并协调状态，再执行其他操作。

可选的本地 IPC

常规 MCP stdio 传输本身就是本地 IPC。此外，还提供一个显式启动、供同一用户使用的 Unix 套接字前端：

mkdir -m 700 /absolute/private/symphony-ipc
bin/symphony-mcp --config /absolute/private/connection.json \
  --listen /absolute/private/symphony-ipc/bridge.sock

在另一个进程中，将 bin/symphony-mcp --connect-socket /absolute/private/symphony-ipc/bridge.sock 作为主机的 stdio 服务端启动，或者使用 configure_clients.py --connect-socket ... 生成该适配器。

双方都会验证内核 UID；套接字权限为 0600，且位于所属目录中，该目录权限为 0700。桥接不会自动安装服务。它一次服务一个本地会话，空闲超时为 60 秒。这是桥接的传输方式，与 qxctl 现有的 SSIAG/STAV 传输方式相互独立。Windows 命名管道、跨用户委派和托管的 HTTPS MCP 端点是未来计划提供的适配器。请参阅安全和数据处理。

打包与发布

原生 MCP Bundle（.mcpb）发行包为 macOS Intel/Apple Silicon 和 Linux x86-64/ARM64 打包相同的 C++ 运行时。它要求已有私有连接配置文件，启动时不会下载、编译、升级或配置 Symphony。有关要求、精确包检查，以及官方注册表和 GitHub 目录的独立发布步骤，请参阅 MCP Registry 安装与发布。Windows 主机继续使用显式 WSL 适配器。

python3 scripts/package_release.py --binary build/symphony-mcp \
  --output /absolute/output/symphony-alpha-platform.zip

打包器包含源代码、所选二进制文件、技能、适配器和许可证；不包含本地配置文件、构建缓存和私有证据。它会生成归档摘要，且绝不上传。请构建各自独立且经过认证的平台制品。源代码归档不含 --binary，安装前需要先进行构建。

OpenAI 目前要求通过合作伙伴许可名单才能使用其公开的本地 MCP 接入路径。已包含发布者联系信息、原始品牌标识、已发布插件的隐私覆盖范围，以及经发布者批准的条款。发布者提供了演示，OpenAI 草案已于 2026 年 10 月 31 日上传。由于命令行 MCP 不符合资格，OpenAI 正式审核仍受阻。此次独立的 MCP Registry 发行并不代表获得 OpenAI 批准。已配置的 C++ 运行时和适配器的重点证据记录在 Codex 验收中。此软件包或成功测试均不能保证公开发布的日期。

目前有 11 个托管插件候选项通过了平台资格检查：x86-64/ARM64 上的 Ubuntu、Apple Silicon，以及 Windows-to-WSL 2。Windows 客户端使用显式 WSL 适配器。DGX/Spark 硬件以及实际 Agent UI/原生负责人验收仍待完成。原始验证报告仍作为带日期的基准。

清单现已提供打包的 symphony-setup 入门工作流，用于选择现有安装并创建其私有固定版本配置文件。有关已安装客户端的证据和剩余 GUI 检查，请参阅 Codex 验收。NVIDIA DGX/Spark 资格认证是后续里程碑。