Npcink Cloud Addon

描述

Npcink Cloud Addon 将本地 WordPress 站点连接到 npcink-cloud

它会存储 Cloud Base URL 和 Cloud API Key,解析 Cloud 签发的密钥,签名运行时请求,探测健康状态,读取 Cloud 权益摘要,并可在管理员明确选择启用后上传仅元数据的插件行为事件。

它不执行 WordPress 写入、不审批提案、不拥有计费事实,也不管理提示词、路由、预设、工作流/任务队列、调度事实或工作流引擎。它的可观测性缓冲区只是用于监控元数据的受限投递缓冲区,不是 Core 审计、提案、执行、计费或工作流事实来源。

对于媒体衍生任务,本地主机代码可以将只读的 npcink-abilities-toolkit/build-media-derivative-cloud-request ability 输出和短 TTL 的源 artifact 描述符传给 addon,用于签名后的 Cloud 派发。addon 要求 Cloud 设置已通过验证,会拒绝携带凭据的 ability payload,并返回包含 final_write_owner=local_wordpress_host 的提案就绪数据。最终审阅、记录、替换、回滚和 WordPress 写入仍保留在本地主机/Core 审批路径中。

For plugin monitoring, the addon may upload operational metadata such as plugin
slug/version, event kind, status, timing, error code, route, proposal id,
ability id, correlation id, and counters. It must not upload prompts,
generated content, article body content, media bytes, raw request or response
payloads, provider credentials, Cloud API secrets, passwords, cookies, nonces,
Authorization headers, database names, table names, or filesystem paths.
Customer-journey monitoring is limited to supported editor steps such as
generation started, succeeded, failed, retried, accepted, saved, or abandoned.
It does not send raw WordPress user or post IDs, email addresses, URLs, DOM
data, or free-form error messages. Uploads are authenticated to the configured
Cloud site, so they may be associated with that site; they are not used for
advertising, individual user scoring, or automatic WordPress content changes.

外部服务

此插件通过 Cloud Base URL 设置连接到站点管理员配置的 Npcink Cloud 服务。

The plugin contacts the configured Cloud service after Portal authorization and connection verification, or when an administrator uses the advanced recovery form with a Cloud Base URL and API key. A local Npcink component may also explicitly use the Cloud runtime client.

Requests may include the configured site identifier, key identifier, request timestamp, nonce, trace identifier, idempotency key, HMAC signature headers, and read-only requests for health, run status, run result, usage statistics, entitlement summaries, observability summaries, and Agent feedback quality summaries. WordPress AI/runtime requests can include the prompt, source text, and task configuration supplied for that operation. Optional metadata-only monitoring is separate and does not include prompt or content data. The stored Cloud API Key secret is used server-side for request signing and is not printed in wp-admin.

对于主机提供的媒体衍生运行时任务,请求还可能包含短 TTL 的源 artifact 描述符,以及来自本地只读 ability 输出的衍生请求参数。Cloud 凭据和签名请求头由 addon 传输层添加,不会复制到 ability payload 中。

For Site Knowledge transport, requests may include public post/page identifiers,
public article/page content and public metadata when delivery is enabled, approved
comment change hints, local delivery consent state, and explicit administrator
delivery intents for Cloud-owned index operations. Drafts, private posts,
password-protected posts, credentials, and raw database fields must not be sent.

The Site Knowledge change bridge health seam returns
site_knowledge_change_bridge_status.v1. Local consumers should surface it as
change_bridge and treat buffer_count as bounded delivery-buffer depth only,
not queue truth, freshness truth, index lifecycle truth, or Cloud diagnostics
truth.

For WordPress AI connector scene runtime, image context evidence, Runtime Runs
detail, artifact preview download, and Agent feedback event transport, requests
may include the bounded scene request, media URL or artifact descriptor, run id,
artifact id, or local operator feedback metadata needed for that specific Cloud
runtime/read endpoint. The addon does not create Core proposals, approve
changes, execute WordPress writes, own retry queues, or own Site Knowledge index
lifecycle.

已配置的 Cloud 服务负责其自身的隐私政策、服务条款、数据保留和账号/密钥签发。由于 Cloud Base URL 由管理员配置,站点管理员只应将此插件连接到已经审阅过服务条款、隐私政策、数据保留政策以及账号/密钥签发流程的 Cloud 服务。

Npcink Cloud 服务信息:

  • 服务条款:https://cloud.npc.ink/terms/en/terms.html
  • 隐私政策:https://cloud.npc.ink/terms/en/privacy.html
  • 数据保留:https://cloud.npc.ink/terms/en/data-retention.html

屏幕截图

安装

  1. 将此目录放入 wp-content/plugins/npcink-cloud-addon
  2. 启用 Npcink Cloud Addon
  3. Open Npcink AI > Cloud Addon, or Settings > Npcink Cloud Addon when the addon is installed standalone.
  4. Choose Connect with Npcink Cloud and authorize this site in the Portal.
  5. If Portal authorization is unavailable, expand advanced recovery and enter the Cloud Base URL and API key, then choose Save and Verify.

常见问题

这个插件会创建 Cloud API Key 吗?

不会。密钥由 Npcink Cloud 签发。

我需要 Npcink Cloud 账号吗?

Yes. A site administrator needs a Npcink Cloud account and Portal authorization. The advanced recovery form accepts a Cloud Base URL and API key when Portal authorization is unavailable.

这个插件会显示 Cloud secret 吗?

不会。secret 仅用于服务器端签名,不会显示在设置页面上。

插件什么时候会联系 Npcink Cloud?

当管理员保存并验证 Cloud 设置、本地 Npcink 组件明确使用 Cloud 运行时客户端、刷新权益或状态摘要,或启用并刷新可选监控时,插件会联系已配置的 Cloud 服务。

监控默认启用吗?

不会。监控需要管理员明确选择启用,并且 Cloud 设置必须已通过验证。

监控可以发送哪些数据?

监控只发送运行元数据,例如插件 slug/版本、事件类型、状态、耗时、错误代码、路由、提案 ID、ability ID、关联 ID、计数器和延迟。

For supported editor journeys, this may show that generation started,
succeeded, failed, was retried or accepted, and whether an accepted result was
saved or abandoned. Monitoring uploads are associated with the configured
Cloud site, but do not include raw WordPress user or post IDs.

监控会上传提示词、内容或原始 payload 吗?

不会。仅元数据监控的设计目标是不上传提示词、生成内容、文章正文内容、媒体字节、原始请求或响应 payload、提供商凭据、Cloud API secret、密码、cookie、nonce、Authorization 请求头、数据库名、数据表名或文件系统路径。

How is monitoring data used?

Monitoring data is used to diagnose failures, measure reliability, and improve
Npcink features. It is not used for advertising, individual user scoring,
automatic approval, or automatic WordPress content changes. Monitoring is off
by default and an administrator can turn it off at any time.

媒体衍生任务可以向 Cloud 发送媒体数据吗?

只有在本地主机代码明确调用媒体衍生传输时才会发送。在这种情况下,请求可能包含短 TTL 的源 artifact 描述符,以及来自本地只读 ability 输出的受限衍生参数。Cloud 凭据和签名请求头由 addon 传输层添加,不会复制到 ability payload 中。

这个插件会把 Cloud 建议写入 WordPress 吗?

不会。最终 WordPress 写入必须经过本地 Core 的提案、预检、审批和应用路径。

在哪里查看 Cloud 服务条款和隐私信息?

服务条款:https://cloud.npc.ink/terms/en/terms.html

隐私政策:https://cloud.npc.ink/terms/en/privacy.html

数据保留:https://cloud.npc.ink/terms/en/data-retention.html

评价

此插件暂无评价。

贡献者及开发者

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

贡献者

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

帮助将「Npcink Cloud Addon」翻译成简体中文。

对开发感兴趣吗?

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

更新日志

0.1.8

  • Add opt-in, privacy-safe editor journey events for generation, recovery, acceptance, and save outcomes.
  • Clarify exactly what monitoring sends, how site-associated metadata is used, and which sensitive data is never collected.
  • Tighten monitoring-consent gates for editor quality evidence and prevent duplicate extensions on imported AI images.

0.1.7

  • Replace the public concrete runtime client seam with bounded scenario-specific connector facades.
  • Improve connection, Site Knowledge, and read-only runtime result feedback while preserving local WordPress write ownership.
  • Refresh WordPress AI localization compatibility and the verified release package.

0.1.6

  • Keep a valid Cloud connection credential when the site binds without an available active-site slot.
  • Show a bounded “Connected, activation required” state and direct administrators to Cloud for activation.

0.1.5

Show actionable Cloud authorization exchange errors, including active-site capacity and expired authorization recovery, instead of reporting every rejected exchange as a missing connection key.

0.1.4

Point the Cloud Portal authorization entry and Open Cloud actions at /portal after the Portal workspace merge, and refresh the public onboarding checklist.

0.1.3

Simplify the admin overview and Site Knowledge quota display, align localized quota copy, harden Cloud authorization redirects, and refresh release assets.

0.1.2

Refine bounded Site Knowledge Cloud transport, WordPress AI connector request-log compatibility, Cloud runtime contract reuse documentation, and Plugin Check release validation.

0.1.1

更新 Cloud 连接状态操作、权益摘要缓存、WordPress AI 连接器集成、zh_CN 字符串和发布打包检查。

0.1.0

初始独立连接器骨架。