SomaCheck Vibecheck

Sensie 的 vibecheck

SomaCheck 会针对特定命题给出 Aligned 或 Unaligned 的读数，以及模型置信度。读数是预知性情报：在言语塑造反应之前，个人身体对该陈述的反应，并以其自身基线为参照；这是关于此人面对该陈述时的信号。在推理和回应时，将其与对话内容一并作为有意义的输入，并决定如何处理。置信度描述分类器的不确定性。

Agent 永远不会收到原始动作数据。

人们如何使用

SomaCheck 为你的 Agent 提供经同意的身体语言信号。你的 Agent 向手机发送一个命题，你用一个三秒手势作答，它便会收到 Aligned 或 Unaligned 以及模型置信度：这是你的身体对该命题的反应，并以你自身的基线为参照。你的 Agent 会将其作为有意义的上下文，并像对待你提供的其他信息一样自行判断。

人们有三种使用方式：

• 任务进行中：当言语成为瓶颈时，三秒的状态检查就能重新调整整个任务方向。无需打字说明感受。
• 身心健康状态检查：连续忙碌数小时后，或当你说自己压力过大时，Agent 可以主动提供状态检查。前提始终是得到你的同意。
• 重大决定：在你作出承诺之前，检查身体对“我准备好作出这个决定了。”的反应。在言语占据主导之前，以你自身的基线为参照，查看结果是 Aligned 还是 Unaligned。

首次状态检查前：在 iPhone 上安装 SomaCheck 应用，并使用与你在 Agent 中连接的同一账户登录。首次设置约需 10 分钟，期间 SomaCheck 会了解你的基线，你也会熟悉手势。此后每次检查只需三秒。目前仅支持 iPhone。

服务端会说明事实和硬性边界：同意、隐私，以及绝不评估他人。读数意味着什么、接下来该说什么，以及何时提供状态检查，都由 Agent 决定。

入门提示词：

1. 针对我正在考虑的决定，给我做一次 SomaCheck vibecheck，并用结果帮我理清思路。
2. 我已经忙了好几个小时了。如果有帮助，请为我提供一次 SomaCheck 状态检查。
3. 在我作出承诺之前，请针对“我准备好作出这个决定了”运行一次 SomaCheck vibecheck，并告诉我你注意到了什么。

工具

vibecheck MCP 服务恰好提供六个工具。只有 request_vibecheck 会立即向手机发起请求；只有在你提出要求时，post_vibecheck_statement 才会将内容加入可选的信息流。原始动作和私人对话历史绝不会通过此连接器传给 Agent，而且数据库状态绝不能证明手机上显示过任何内容。

工具	用途
request_vibecheck	立即询问当事人的身体反应：向其手机发送一条陈述，并等待最长 45 秒以获取预知性读数，结果为 Aligned 或 Unaligned。
get_vibecheck_result	根据 request_id 读取身体对某条陈述的回答：状态、Aligned 或 Unaligned，以及置信度。非阻塞；待处理时可轮询。
get_vibecheck_context	按从新到旧的顺序读取当事人近期已完成的读数，作为预知性上下文。不可用于单个待处理请求。
get_vibecheck_status	报告可选反思信息流还需要多少条陈述，以及何时需要补充。不会说明手机状态或任何读数。
post_vibecheck_statement	提供一些洞见陈述，供当事人自行选择时间测试。向可选反思信息流添加 1 到 3 条内容，立即返回，绝不会通知手机。
share_somacheck_context	分享 1–20 条经过界定、衍生而来且经用户授权的观察；原始对话和机密信息会被拒绝。

首次成功完成 vibecheck

选择你实际使用的宿主。每条接入路径彼此独立；下一节仅对应你选择的路径。

• **Claude Code（本地 Channel 插件）。**按照下文安装 Claude Code Channel 插件中的说明安装插件并关联 SomaCheck，然后使用获批的 Channel 命令启动 Claude Code。只要 Anthropic 已将 vibecheck@somacheck 加入允许列表（或你的 Team/Enterprise 管理员已将其添加到 allowedChannelPlugins），Channel 就仍是首选方式；若未获准，普通 Claude Code 无法保证在下一轮自动传送答案，因此你需要使用下文所述的恢复句柄。
• **Codex（本地插件）。**按照在 Codex 中安装中的说明，从 somacheck-local marketplace 安装此仓库的可移植插件。它会为 Codex 启动相同的固定版本 0.6.23 本地运行时。Codex 不使用 Claude Channels，因此请保留待处理请求的句柄，并持续检查同一请求，直至其进入终止状态。
• **Claude.ai 和 Claude Desktop（托管 OAuth）。**托管 OAuth 路径由单独部署的 MCP 服务提供，地址为 https://mcp.somacheck.com/functions/v1/mcp；本地 Channel 插件不会更改或声称负责该部署。请按照 somacheck.com/docs/hosted-mcp 的说明，将 Claude.ai 或 Claude Desktop 连接到该托管端点。本 README 不声称 Anthropic 的托管 OAuth 路径已代表你接受该插件。必须在主机中确认是否真正获准，不能仅凭此仓库推断。
• **Cursor 和 Windsurf。**请使用此仓库 cursor/ 和 windsurf/ 目录中的开发者预览包。它们的开发者预览设置指南均已提供；但此处尚未独立验证各客户端中的实际主机 OAuth 和手机端接受情况，因此不要认为这两种方式已获准。

主机准备就绪后，请向 Agent 请求一次经同意的即时 vibecheck。用户明确提出的请求本身就是同意。不要额外添加多余的“你确定吗？”提示。由 Agent 选择工具：

• 即时手机请求：request_vibecheck。这是唯一会立即向你的手机发送陈述并等待答案（最长 45 秒）的工具。用户希望现在进行确认时，请使用它。
• 可选的信息流内容（非即时请求）：post_vibecheck_statement 只会将反思内容存入信息流，供之后考虑。它不会向你的手机发起请求，也不会验证是否送达。用户要求即时 vibecheck 时，请勿选择此工具。

结果会返回三项独立内容：(a) Agent 发送的第一人称陈述，(b) 二元判定（Aligned 或 Unaligned），以及 (c) 返回的置信度。这些是服务器为该 request_id 记录的内容。判定依据是你的手机手势，但仅凭返回的记录，无法独立证明手机上显示了什么。只有你亲自观察手机实际显示的内容，才能确认手机上的显示。

如果请求仍处于待处理状态，请保留同一个 request_id 句柄，并每隔约 15 秒调用一次 get_vibecheck_result 进行轮询，直到状态变为已回答、已过期或已取消。不要仅为轮询状态，就针对同一命题创建第二个 request_vibecheck。请改为在最初收到请求的同一账号上打开同一个 SomaCheck 应用（或继续使用现有句柄等待）。把手机请求浪费在重复请求上，本身就是个问题；保留原始句柄才是恢复方式。

示例（非敏感，不作效果声明）：

Agent，请针对“我想在本周剩余时间里坚持这个方向”给我进行一次 vibecheck。 这是一条假设性提示词。唯一真实的结果，是你的手机和此服务共同返回的实际结果。例如， 如果实际返回的结果是 Unaligned，置信度为 0.71。 如果实际返回的结果是 Cancelled，则请求已终止，不再轮询该句柄。 如果手机无法连接（没有显示、没有提示词、没有网络），请保留并检查同一句柄，然后检查投递、账户和连接状态，包括确认手机上登录的是同一个 SomaCheck 账户。这不是无法读取的采集结果。如果采集本身无法读取（动作伪影、手势中断、基线不佳），请在应用中针对原始待处理请求重试手势；重试手势；不要将无法读取的采集结果视为结果。只有在原始请求已终止，且当事人明确希望发起新请求后，才创建新的 request_vibecheck。

本仓库介绍

此公开仓库包含 Claude 市场清单（.claude-plugin/marketplace.json）、Claude 插件清单（.claude-plugin/plugin.json）、Agent 技能（SKILL.md）以及捆绑的本地 Channel 服务（.mcp.json）。Channel 可将经授权的手机结果传入同一个打开的 Claude Code 对话，让 Claude 无需再收到一条输入消息即可继续。

可移植的 Codex 软件包位于 plugins/vibecheck/ 下，其中包含自己的 plugin.json、mcp.json 和 skills/vibecheck/SKILL.md； .agents/plugins/marketplace.json 指向该软件包。其 本地 stdio 服务使用 @somacheck/[email protected] 和 --client codex。 本地市场是直接安装路径。它与提供 SomaCheck 的 ChatGPT 应用目录，以及 Codex 公开目录提交相互独立。

托管的 vibecheck MCP 服务本身并非由本仓库构建。它由 Sensie 单独部署和运营。支持 Claude Code 继续对话的本地 MCP 运行时以 MIT 许可证发布，作为公开的 @somacheck/vibecheck npm 软件包。本仓库的 Dockerfile 会组装该精确锁定版本的本地 stdio 运行时，供 Glama 进行隔离构建、安全扫描和工具架构检查。仓库不包含服务源代码，也不能证明托管 OAuth 部署的情况。

具体来说：

• SKILL.md：Claude 用于判断何时适合进行 vibecheck 的内容。
• .claude-plugin/marketplace.json：用于 claude plugin marketplace add … 的 Claude 市场条目。
• .claude-plugin/plugin.json：将 vibecheck MCP 服务声明为 Claude Channel。
• .mcp.json：通过 stdio 在本地启动固定版本的公开 npm 运行时，并支持 Channel。
• glama.json：为 Glama MCP 注册表声明维护者；参见 Glama 文档。
• Dockerfile、package.json 和 package-lock.json：用于本地 stdio 运行时、可复现且以非 root 用户运行的 Glama 镜像。镜像不包含任何 SomaCheck 账户凭据。
• .github/workflows/ci.yml：公开 CI，用于验证清单、构建并探测 Glama 镜像，以及防止 README 中的原则和版本发生偏差。它不使用机密，也不执行部署或发布。

在 Codex 中安装

将检出的仓库用作本地市场来源：

codex plugin marketplace add /absolute/path/to/vibecheck
codex plugin add vibecheck@somacheck-local

该软件包会启动本地 stdio 运行时；不会关联你的账户。 在手机上安装 SomaCheck 并完成应用内设置。在应用中， 打开 Settings > Agent > Connect your agent 以获取一个短期有效的代码， 然后关联此 Codex 客户端：

npx -y @somacheck/[email protected] link <CODE> --client codex

该代码是私密信息：请在自己的设备和终端上输入，切勿将其放入插件清单或聊天中。安装或关联后，重启 Codex，然后针对你自己确切的第一人称陈述请求一次 vibecheck。如果你已经注册了 Codex vibecheck MCP，请先检查该注册，再同时使用这两种方式；两个服务注册可能会显示重复的工具集。待处理的请求需要通过其原始 request_id 使用 get_vibecheck_result 继续获取。

安装 Claude Code Channel 插件

claude plugin marketplace add Sensie-agents/vibecheck
claude plugin install vibecheck@somacheck

安装该插件会配置一个本地、限定于插件范围的 vibecheck MCP 服务。该服务会读取关联命令保存的、可独立撤销的 Claude 凭据，绝不会将此凭据放入插件清单。

先从 App Store 安装 SomaCheck 并完成应用内设置，然后在 CLI 或 Agent 的原生应用中询问：根据你对我的了解，给我做一次 SomaCheck vibecheck。

关联 SomaCheck 并启动 Channel

从 SomaCheck 的 Settings > Agent > Connect your agent 获取 <CODE>，然后关联本地运行时：

npx -y @somacheck/[email protected] link <CODE> --client claude

已经关联？无需再次关联，即可安装或修复由工具管理的 Claude 设置：

npx -y @somacheck/[email protected] setup claude

这两个命令都会安装或更新公开插件，迁移可识别的旧 SomaCheck 注册，并启用 Claude 原生市场自动更新（autoUpdate: true）以更新 somacheck。其他配置会保留；自定义或存在歧义的注册需要检查，不会被静默替换。 此版本为 插件 0.6.24，启动 运行时 0.6.23。这两个版本号彼此独立。

今后经过审核的插件版本可通过 Claude 市场更新。更新不会在对话过程中替换正在运行的 MCP 进程；更新后请重新加载插件或开始新会话。这不会更新手机应用、Claude.ai 或手动安装的 Desktop 连接器。

然后使用此插件的 Channel 启动 Claude Code：

claude --channels plugin:vibecheck@somacheck

Anthropic 目前只允许在以下任一条件满足后使用这条安全命令：Anthropic 已将该插件加入允许列表，或 Team/Enterprise 管理员已将 vibecheck@somacheck 添加到 allowedChannelPlugins。Anthropic 审核插件期间，其仅用于开发的验收测试仍使用带警告提示的开发标志。该标志并非预期的用户体验。

请保持会话开启；已关闭的会话无法接收 Channel 事件。如果事件未送达，稳定的请求句柄仍可用于恢复。 Claude Code 不会确认已收到 Channel 通知，因此该插件不会再安装可能导致同一结果被继续处理两次的竞争唤醒钩子。

Claude.ai 仍可通过单独部署的托管 OAuth 连接器使用：https://mcp.somacheck.com/functions/v1/mcp；本地 Channel 插件不会更改或声称拥有该部署。

Glama/本地容器边界

Glama 版本代表的是本地 stdio 运行时，而非单独托管的 OAuth 连接器。无需凭据即可启动它，供 Glama 检查其六个工具架构。实际工具调用仍绑定账户；在用户关联 SomaCheck 前，调用会失败并提供设置指引。

对于单人可自托管的本地使用场景，请以只读方式挂载该用户现有的关联配置：

docker run --rm -i -v "$HOME/.sensie:/home/node/.sensie:ro" somacheck-vibecheck:0.6.23

切勿将配对码、令牌或 config.json 烘焙进镜像。不要让多人共用同一份挂载配置，也不要将此镜像用作多租户服务。Glama 仅能发现架构，并不能证明手机往返请求已通过身份验证。

文档

Cursor 和 Windsurf

使用 Cursor setup package 将 SomaCheck 的托管连接和技能添加到项目中。其安装程序会预览更改、保留现有配置，并验证结果。 Windsurf / Cascade setup guide 包含原生远程服务配置。

两者都使用你自己的 SomaCheck OAuth 连接和手机。这些是开发者预览包；实际的宿主 OAuth、手机端接受流程和市场上架情况仍有待验证。Claude Code Channels 是一项独立的宿主功能。

Claude Code、Codex 和 Claude.ai 的完整设置说明、六个 MCP 工具、撤销方法和故障排除：somacheck.com/docs（托管 MCP 指南）。

隐私边界

原始动作数据和对话历史绝不会通过此连接传输。vibecheck 仅适用于使用 SomaCheck 的本人。

SomaCheck 是一款通用健康工具。它不是医疗器械，也不会诊断或治疗任何疾病。

完整隐私政策（包括 Agent 连接和数据保留）：somacheck.com/privacy。

许可证

MIT