OpenPCC

OpenPCC 是一个开源框架，用于实现可证明隐私的 AI 推理。它受到 Apple 的 Private Cloud Compute 启发，但完全开放、可审计，并且可以在您自己的基础设施上部署。OpenPCC 允许任何人运行公开或自定义的 AI 模型，而无需暴露提示、输出或日志——通过加密流式传输、硬件认证和不可关联的请求来强制实施隐私保护。

OpenPCC 旨在成为 AI 数据隐私领域的一个透明、社区治理的标准。

阅读 OpenPCC 白皮书：https://github.com/openpcc/openpcc/blob/main/whitepaper/openpcc.pdf

托管服务

Confident Security 正在基于 OpenPCC 标准构建一项完全托管的服务，名为 CONFSEC。如需了解更多信息并注册，请访问 https://confident.security。

OpenPCC 客户端

此仓库包含符合 OpenPCC 标准的 Go 客户端代码，以及作为 Python 和 JavaScript 客户端基础的 C 库。此外，还包含若干内存中服务，可用于测试客户端功能。

无感知 HTTP 中继 (OHTTP)

为确保计算服务提供商无法获知用户的个人操作，OpenPCC 使用无感知 HTTP (OHTTP)。预计 OpenPCC 部署将运行一个 OHTTP 网关，并配置客户端使用由第三方运营的 OHTTP 中继来连接到该网关。目前，我们推荐 Oblivious.network 作为唯一可在注册后立即使用的 OHTTP 中继服务。

OpenPCC 计算节点

请参阅 https://github.com/confidentsecurity/confidentcompute，以获取与此仓库配套的相关计算节点实现。

Go 使用示例

本地开发示例请参见 cmd/test-client/main.go。若要连接到生产环境服务，代码可能如下所示：

import (
    "context"
    "fmt"
    "net/http"
    "os"
    "strings"

    "github.com/openpcc/openpcc"
    "github.com/openpcc/openpcc/inttest"
    "github.com/openpcc/openpcc/transparency"
)

func makePCCRequest() error {
    ctx := context.Background()

    identityPolicy := transparency.IdentityPolicy{
		OIDCSubjectRegex: "^https://github.com/confidentsecurity/T/.github/workflows.*",
		OIDCIssuerRegex:  "https://token.actions.githubusercontent.com",
    }

    cfg := openpcc.DefaultConfig()
    cfg.APIURL = "https://app.confident.security"
    cfg.APIKey = os.Getenv("<APIKEY_ENV_VAR_NAME>")
    cfg.TransparencyVerifier = transparency.DefaultVerifierConfig()
    cfg.TransparencyIdentityPolicy = &identityPolicy

    client, err := openpcc.NewFromConfig(ctx, cfg)
    if err != nil {
        return fmt.Errorf("创建 OpenPCC 客户端失败： %w", err)
    }

    // 推理请求采用 OpenAI API 的生成格式
    body := "{\"model\":\"qwen3:1.7b\",\"prompt\":\"为什么天空是蓝色的？\"}"
    req, err := http.NewRequest("POST", "http://confsec.invalid/v1/completions", strings.NewReader(body))
    if err != nil {
        return err
    }
    // 为请求添加标签，以便将其路由到运行指定模型的计算节点
    req.Header.Add("X-Confsec-Node-Tags", "qwen3:1.7b")

    resp, err := client.RoundTrip(req)
    if err != nil {
        return err
    }

    return nil
}

开发

开发命令通过 Go 工具 mage 运行。

您可以直接使用 go.mod 工具安装 go tool mage [cmd] 来运行命令，也可以安装 mage 本身以减少按键次数：go install github.com/magefile/mage@latest。

mage 将打印出可用命令列表（命令源代码位于 /magefiles/*）。

在开发过程中，可使用 mage runMemServices 运行所有内存中的 OpenPCC 服务，然后使用 mage runClient 向系统发送测试请求。

OpenPCC 快速上手指南

OpenPCC 是一个开源框架，旨在实现可证明的私有 AI 推理。它通过加密流传输、硬件认证和不可链接的请求，确保在运行开放或自定义 AI 模型时，提示词（Prompts）、输出结果及日志不会被泄露。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统: Linux, macOS 或 Windows (WSL2 推荐)。
• Go 语言环境: 需安装 Go 1.21 或更高版本。
• 依赖工具:
  • mage: 用于运行开发和构建命令。
  • git: 用于克隆代码库。

注意：目前 README 未提供中国专属镜像源。国内开发者若遇到网络问题，建议配置 Go 代理（如 GOPROXY=https://goproxy.cn,direct）以加速依赖下载。

安装步骤

1. 克隆项目代码

git clone https://github.com/openpcc/openpcc.git
cd openpcc

2. 安装 Mage 构建工具

您可以选择临时使用 go tool 运行，或者永久安装 mage 以简化命令输入。

选项 A：临时运行（无需安装） 后续命令前加 go tool mage 即可。

选项 B：永久安装（推荐）

go install github.com/magefile/mage@latest

确保 $GOPATH/bin 已添加到您的系统环境变量 PATH 中。

3. 验证安装

运行以下命令查看可用的开发指令列表：

mage -l

基本使用

OpenPCC 提供了内存服务用于本地开发和测试。以下是启动服务并发送测试请求的最简流程。

1. 启动本地内存服务

在项目根目录下运行以下命令，启动所有必要的内存中 OpenPCC 服务（包括 OHTTP 网关模拟等）：

mage runMemServices

保持该终端窗口运行，不要关闭。

2. 发送测试请求

打开一个新的终端窗口，进入同一项目目录，运行客户端测试命令：

mage runClient

如果配置正确，您将看到客户端成功通过本地服务完成了一次隐私保护的推理请求交互。

3. 代码集成示例 (Go)

若需在项目中集成 OpenPCC 客户端，请参考以下核心代码逻辑。此示例展示了如何配置透明性策略（Transparency Policy）并发起加密请求。

import (
    "context"
    "fmt"
    "net/http"
    "os"
    "strings"

    "github.com/openpcc/openpcc"
    "github.com/openpcc/openpcc/inttest"
    "github.com/openpcc/openpcc/transparency"
)

func makePCCRequest() error {
    ctx := context.Background()

    // 配置身份策略，用于验证计算节点的透明度
    identityPolicy := transparency.IdentityPolicy{
		OIDCSubjectRegex: "^https://github.com/confidentsecurity/T/.github/workflows.*",
		OIDCIssuerRegex:  "https://token.actions.githubusercontent.com",
    }

    cfg := openpcc.DefaultConfig()
    // 生产环境替换为实际服务地址
    cfg.APIURL = "https://app.confident.security"
    cfg.APIKey = os.Getenv("<APIKEY_ENV_VAR_NAME>")
    cfg.TransparencyVerifier = transparency.DefaultVerifierConfig()
    cfg.TransparencyIdentityPolicy = &identityPolicy

    client, err := openpcc.NewFromConfig(ctx, cfg)
    if err != nil {
        return fmt.Errorf("failed to create openpcc client: %w", err)
    }

    // 构造推理请求 (兼容 OpenAI API 格式)
    body := "{\"model\":\"qwen3:1.7b\",\"prompt\":\"why is the sky blue?\"}"
    
    req, err := http.NewRequest("POST", "http://confsec.invalid/v1/completions", strings.NewReader(body))
    if err != nil {
        return err
    }
    
    // 添加标签以路由到运行特定模型的计算节点
    req.Header.Add("X-Confsec-Node-Tags", "qwen3:1.7b")

    // 执行加密往返请求
    resp, err := client.RoundTrip(req)
    if err != nil {
        return err
    }

    // 处理 resp...
    return nil
}

提示：生产环境中，OpenPCC 依赖第三方的 OHTTP Relay（如 Oblivious.network）来中继流量，以确保计算提供商无法获知用户真实 IP 和行为关联。本地开发时，runMemServices 已模拟了相关组件。