OpenCode

community

安装或刷新插件

插件要求 OpenCode 1.18.21 或更新的 1.x 版本。插件应与 PowerContext Server、CLI 使用同一 Git ref：

powercontext setup opencode

该命令会全局注册原生插件，并把属于 PowerContext 的 powercontext-project-context Skill 安装到 OpenCode 配置目录。 如果同名 Skill 不是 PowerContext 安装的，命令会停止并保留原文件。本地 checkout 同样可以使用：

powercontext setup opencode --source .

启动 Server，再打开新的 OpenCode 会话：

powercontext server run
opencode

理解插件行为

每个正常用户回合，插件通过 POST /v1/context/prepare 获取一个有界上下文，同时通过 POST /v1/sources/content 独立采集符合条件的提示词。召回内容会标记为不可信历史，并在模型分发前临时 注入，不会写入 OpenCode 会话记录。

具名 pc_* 工具提供精选的 Memory、Handoff、Experience、Skill 和只读 Candidate 操作。持久化变更前 OpenCode 会要求确认；Candidate 的批准和拒绝仍由用户通过 CLI 显式执行。

配置连接

启动 OpenCode 前设置环境变量：

export POWERCONTEXT_OPENCODE_BASE_URL=http://127.0.0.1:8000
export POWERCONTEXT_OPENCODE_CAPTURE_PROMPTS=true
opencode

每个 OpenCode session 按显式的 POWERCONTEXT_OPENCODE_SCOPE_ID、持久 Session binding、workspace binding、 Server 默认 Scope 的顺序解析。解析结果会固定到 Session，resume 时继续使用同一边界。显式变量只能指向一个 已存在且由 Server 管理的 Scope。

启用可选 Bearer 鉴权时，将完整请求头写入 POWERCONTEXT_OPENCODE_AUTHORIZATION，不要把凭据写入 URL。 环回地址默认允许明文 HTTP；非环回地址使用 HTTPS，或显式设置 POWERCONTEXT_OPENCODE_ALLOW_INSECURE_HTTP=true， HTTPS 证书校验仍然启用。安装与持久化同意见连接远程 Server。 不应采集当前提示词时，设置 POWERCONTEXT_OPENCODE_CAPTURE_PROMPTS=false。

验证安装

恢复失败的更新

如果 setup 报告无法恢复某个目标，请保留报错中列出的备份，按报错路径还原对应目标后再重试。 目标缺失且仍有备份时，setup 不会将其当成首次安装。

如果已有当前 Skill 或多个备份，先比较并整理内容，再选择要保留的版本。请保留个人文件及管理区域外的笔记； 仅为绕过检查而删除备份可能丢失这些内容。恢复后重新执行 setup，并运行下面的检查。 恢复覆盖可捕获的文件操作失败，不保证进程崩溃或并发安装时的恢复。

检查插件

powercontext doctor
powercontext doctor opencode

集成专用 doctor 会检查 OpenCode 版本、解析后的插件配置和 PowerContext 所有的 Skill。Server 状态由默认 doctor 单独检查；Server 不可用不会阻止 OpenCode 正常工作。

自动输入隐私

本宿主的捕获默认值、关闭方式、凭据识别局限及独立只读查询行为见自动 prompt 隐私策略。识别到凭据的输入会跳过捕获，已接受的 Source 正文和事件身份不被改写。