Npcink AI Client Adapter

描述

Npcink AI Client Adapter 通过聚焦的 REST 适配器,将 OpenClaw 兼容工具等本地 AI 客户端连接到 WordPress 站点。

它适用于使用 Npcink Governance Core 管理可审查 AI 操作,并使用 Npcink Abilities Toolkit 等 WordPress Abilities API provider 提供具体 WordPress 能力的站点。Adapter 为客户端提供一个稳定的 WordPress REST 入口,用于检查就绪状态、读取治理指引、运行已批准的读取能力、创建受治理的提案,并且只在 Core 批准和提交预检之后执行受支持的写入。

默认连接路径使用签名密钥配对,因此 AI 客户端不需要接收 WordPress 应用密码。对于已经有专用 secret 字段或凭据库的客户端,仍可使用 WordPress 应用密码备用路径。

Adapter 有意保持很薄。它不定义能力、不保存批准真相、不运行工作流队列、不充当 MCP server、不管理模型 provider、不保存提示词,也不执行任意最终写入变更。治理仍属于 Npcink Governance Core。能力定义和回调仍属于 Npcink Abilities Toolkit 或其他 WordPress Abilities API provider。

Adapter 在 health、help 和连接清单中暴露机器可读的 client_policy,让兼容客户端可以读取明确的路由、输出、敏感读取和写入流程边界。本地 CLI 也会从输出中隐藏 profile 路径、key id、签名 header、token、password 和 secret。

当前受治理执行支持覆盖 Core 批准之后的明确 Adapter 配置,包括 npcink-abilities-toolkit/trash-postnpcink-abilities-toolkit/create-draftnpcink-abilities-toolkit/update-postnpcink-abilities-toolkit/update-post-blocksnpcink-abilities-toolkit/set-post-termsnpcink-abilities-toolkit/reply-commentnpcink-abilities-toolkit/approve-comment

核心功能:

  • 通过一个 Adapter REST namespace,将 OpenClaw 兼容及类似本地 AI 客户端连接到 WordPress。
  • 在客户端开始工作前检查 Adapter 就绪状态和依赖状态。
  • 暴露机器可读的 client_policy,让客户端理解路由、读取、写入和敏感数据边界。
  • 通过 WordPress Abilities API 路由已批准的 direct-read 请求。
  • 将受治理的写入请求转发到 Npcink Governance Core 提案和提交预检端点。
  • 在 Core 批准之后,为明确列入允许范围的执行配置支持用户触发的 approve-and-execute 路径。
  • 优先为本地客户端使用签名密钥配对,并在合适场景下保留应用密码备用方式。
  • 保持通道、治理、能力、云端和模型 provider 职责分离。

屏幕截图

安装

  1. 安装并启用 npcink-abilities-toolkit
  2. 安装并启用 npcink-governance-core
  3. 安装并启用 Npcink AI Client Adapter。
  4. 打开 Npcink > Adapter,创建本地 AI 客户端交接信息。

常见问题

Adapter 会批准提案吗?

Adapter 为受支持的执行配置提供用户触发的 approve-and-execute 操作,但 Npcink Governance Core 仍是提案存储、批准、提交预检和审计的治理后端。

Adapter 会执行任意能力吗?

不会。Adapter 只会在 Core 批准和提交预检之后执行明确受支持的执行配置。它不是通用能力执行器,也不会绕过 Core 治理。

需要其他 Npcink 插件吗?

需要。Npcink Abilities Toolkit 提供 Adapter 使用的能力定义和回调。Npcink Governance Core 负责受治理的提案、批准、提交预检和审计。

哪些 AI 客户端可以连接?

Adapter 面向 OpenClaw 兼容本地客户端和类似工具,这些工具需要能够调用经过认证的 WordPress REST 端点,并读取 Adapter 的 client_policy

Adapter 会把我的 WordPress 密码发送给 AI 客户端吗?

推荐的签名密钥配对路径避免把 WordPress 应用密码交给客户端。Adapter 只保存已批准的公钥。对于有专用密钥字段或凭据库的客户端,应用密码路径仍作为备用方式保留。

Adapter 会运行 AI 模型或保存提示词吗?

不会。Adapter 是通道层。它不提供模型路由、提示词管理、provider 凭据、工作流队列或托管 AI 执行。

如果依赖缺失会怎样?

Adapter 的 health 和 help 路由可以报告依赖状态。需要 Npcink Governance Core 或 WordPress Abilities API provider 的路由会失败关闭,并返回结构化的缺失依赖错误。

评价

此插件暂无评价。

贡献者及开发者

「Npcink AI Client Adapter」是开源软件。 以下人员对此插件做出了贡献。

贡献者

「Npcink AI Client Adapter」插件已被翻译至 1 种本地化语言。 感谢所有译者为本插件所做的贡献。

帮助将「Npcink AI Client Adapter」翻译成简体中文。

对开发感兴趣吗?

您可以浏览代码,查看SVN仓库,或通过RSS订阅开发日志

更新日志

0.3.2

  • 通过把媒体派生传输保持在 Adapter 之外,并只保留已审查的采纳交接,关闭 release-candidate 边界。
  • 为最终 Adapter 写入路由要求明确的 signed-client execute scope。
  • 恢复 Core capability 转发和默认执行响应兼容性,用于 consumer smoke 覆盖。

0.3.1

  • 将 Adapter 最终执行绑定到 Core 批准和提交预检执行交接。
  • 将签名本地客户端指纹转发到受信任的 Core app-token 请求,并在 Core 上下文不匹配时失败关闭。
  • 在报告依赖就绪之前,验证站点和 signed-client 绑定的 Core 依赖合约语义。

0.3.0

  • 在机器可读合约元数据中添加 Adapter 声明的 Core 和 Abilities Toolkit 兼容性下限。
  • 记录签名本地 AI 客户端 create-draft 提案、approve-and-execute、读回和清理验收通过。

0.2.1

  • 为 health、help 和 connection manifest 响应添加合约快照 smoke 覆盖。
  • 在 Adapter 执行前拒绝请求 core_proxy_execute=true 的批量写入操作。
  • 扩展 core_proxy_executecommit_execution 批处理失败关闭行为的 negative smoke 覆盖。

0.2.0

  • 在 health、help 和 manifest 响应中添加机器可读 Adapter 合约元数据和稳定合约哈希。
  • 添加本地 AI 客户端验收命令,用于非破坏性的 Adapter/Core 边界检查。
  • 使区块主题视觉验收、批量审查反馈和 release package smoke 文档与受治理执行配置边界保持一致。

0.1.1

  • 添加本地 AI 客户端 CLI 辅助命令、输出脱敏和机器可读 client policy。

0.1.0

  • 初始薄 AI 客户端适配器,用于 Npcink Governance Core 和 WordPress Abilities API 路由。