install modes / upgrade paths

安装形态与升级路径 Install modes and upgrade paths

Psyche 不同安装方式的自动更新能力本来就不同。把这件事说清楚，能减少很多试用摩擦和“为什么我明明装了却没升级”的误解。 Psyche does not behave the same under every install mode. Making that explicit reduces a lot of friction and confusion around upgrades.

安装包 `psyche-ai`，源码仓库 `oasyce_psyche`，官网 `psyche.oasyce.com`。 Package `psyche-ai`, source repo `oasyce_psyche`, website `psyche.oasyce.com`.
3 安装形态 install modes npm / git worktree / local path npm / git worktree / local path
7 适配器 adapters OpenClaw / MCP / Vercel AI / LangChain / HTTP / Claude Agent SDK / Oasyce SDK OpenClaw / MCP / Vercel AI / LangChain / HTTP / Claude Agent SDK / Oasyce SDK
1 自动应用更新 auto-applies updates 默认只对 npm install 生效 default only for npm installs
OpenClaw 安装 OpenClaw install 看 live agent 场景怎么接 see how to wire it into a live agent MCP 安装 MCP install 看任意宿主怎么发现它 see how any host discovers it 性能数据 benchmarks 确认更新策略不引入慢路径 verify the update logic stays cheap

三种安装形态Three install modes

形态Mode 适合谁Best for 升级行为Upgrade behavior
npm project 普通安装用户ordinary package consumers 会检查更新，并在安全时尝试自动应用。Checks for updates and can auto-apply them when safe.
git worktree 开发者和本地改源码的人developers working in source 不会偷偷改你的仓库，只会给出明确手动命令。Never silently mutates your repo; only gives explicit manual commands.
local path 像 OpenClaw 本地插件这样的接法local-path integrations like a local OpenClaw plugin 不会自动更新，必须手动拉取 / build / reload。Will not auto-update; requires manual pull / build / reload.

推荐指令Recommended commands

psyche upgrade --check
psyche upgrade
npm view psyche-ai version

七个适配器Seven adapters

适配器Adapter 导入路径Import 适合场景Best for
OpenClaw psyche-ai/openclaw 本地 live agent 循环local live agent loops
MCP psyche-ai/mcp Claude Desktop / Cursor / Windsurf 等 MCP 宿主Claude Desktop / Cursor / Windsurf and MCP hosts
Vercel AI psyche-ai/vercel-ai Vercel AI SDK middlewareVercel AI SDK middleware
LangChain psyche-ai/langchain LangChain.js 工具链LangChain.js tool chain
HTTP psyche-ai/http 任意 HTTP 框架（Express / Fastify 等）any HTTP framework (Express / Fastify etc.)
Claude Agent SDK psyche-ai/claude-sdk Claude Agent SDK — Hook 注入情感上下文 + Thronglets trace 导出Claude Agent SDK — Hook-based emotional injection + Thronglets trace export
Oasyce SDK psyche-ai/oasyce Oasyce 生态原生集成 — 链上身份 + Sigil 绑定Oasyce ecosystem native integration — on-chain identity + Sigil binding

OpenClaw 本地路径特别说明Special note for local-path OpenClaw installs

为什么不自动改Why it will not auto-mutate

本地路径安装常常承载正在开发的源码。自动覆盖会把工作树和构建产物搞乱。A local-path install often points at actively edited source. Auto-overwriting it risks corrupting the worktree and build artifacts.

正确动作Correct action

拉最新代码，重新 build，重启 gateway，让宿主重新加载新的 `dist/`。Pull the latest code, rebuild, and restart the gateway so the host reloads the new `dist/`.

怎么确认How to verify

用 `openclaw plugins inspect psyche-ai` 看实际加载路径和版本。Use `openclaw plugins inspect psyche-ai` to inspect the real loaded path and version.