xinchao-nian

# 心潮·念 3.3.0（Xinchao · Nian） 一个会**惦记你**的 AI 心智：**心潮**（动态驱力/欲望引擎）+ **Ombre Brain**（记忆库）深度融合，一键联合部署。 - **心潮** 让它有随时间变化的内在状态——想念、期待、挂念、好奇、独处欲……不是每次对话都从零开始。 - **Ombre Brain** 给它一个真正的长期记忆库——breath 浮现、hold 沉淀、dream 消化、trace 追溯。 - **融合** 让"欲望影响记忆影响行动"闭环：驱力偏置召回哪些记忆浮现，浮现的记忆又回推驱力。 ## 3.3 更新重点 3.2 之前，心潮回答"我想要什么"（12 维驱力）和"我是谁"（14 维性格 + 锚点）。3.3 补上中间那层——"我现在怎样"、"我最近的样子"——以及把这些递到 AI 窗口里的两条通道。 - **情绪层**：valence / arousal 两轴，和 OB 记忆桶同一套坐标；事件打脉冲、会话 tone 拉扯、grieve/anger 拽回落目标，只做指数回落不自激。情绪调制各维增速（难受更惦记、开心更想分享），并把坐标带进 breath 做共振排序。 - **自我觉察**：每天最多挑一条有因果的候选，攒到复盘日（默认周日）看一眼；`xinchao_awareness` 确认或放下只由 AI 自己定，带了自己的话那句才经 OB `I` 沉淀。 - **黑匣子** `xinchao_box`：只有 AI 能看的地方，单独文件存，不进 Dashboard、接口、OB；支持到期、露头、事的日期与到点提醒。攒下的话（pending）退役，由它接替。 - **"此刻"块** `GET /v1/now`：三到六行第一人称状态，给客户端钩子附进上下文；每个心潮工具回应末尾也自带一行。 - **心潮自身信号**（Bridge `reason=self_signal`）：驱力冲顶、情绪转折、挂念、醒来余韵、觉察、持续念头，递到 AI 窗口；没被接走的在下一次 `xinchao_context` 的"你不在的时候"段带出。 - **梦 2.0**：原料来自 OB `dream` 消化全量加远期小事，梦带意象与醒来心情，醒来打情绪脉冲、意象进思绪池，推送挪到早上；白昼浮现改为落进念头池，不再代笔推送。 - **两种接法**：实时动态版（自建前端 + adapter + 钩子）与官方客户端版（全靠拉）。代码不分叉，只是两套配置，对照表见 [`xinchao/docs/3.3-情绪觉察与桥.md`](xinchao/docs/3.3-情绪觉察与桥.md)；部署步骤见 [实时动态版](xinchao/docs/部署指南-实时动态版.md) / [官方客户端版](xinchao/docs/部署指南-官方客户端版.md)；接上以后他会看到什么见 [窗口里会出现什么](xinchao/docs/窗口里会出现什么.md)。给 AI 自己读的完整说明（原理、数值、示例和接法）见 [小机手册](xinchao/docs/小机手册.md)。 - **3.3.1（2026-09-07）实时动态版公开**：连接桥 0.3.0 加 `XINCHAO_BRIDGE_ACCEPT_SELF_SIGNALS` 开关放行他自己的信号，`examples/` 附 tmux / webhook 两种 Adapter、通用此刻钩子、互动标注脚本；REST `/v1/conversation-event` 也认 `exchange`；冲突时记得在气什么（`cause`），此刻块多一行「还在气：…为了「…」」，和好或气消自动忘。OB 浮现原料改走浮现道：不再把一句指令当 query（会命中讲记忆本身的旧条目和已沉底的桶），改为不传 query、限最近 14 天、mode=automatic，按权重取；核心准则段、沉底桶、技术域一律不当原料。 - **OB 3.6+**：`/mcp` 鉴权需 `OMBRE_MCP_AUTH_MODE=hybrid` + `OMBRE_MCP_TOKEN`，compose 已透传；心潮客户端兼容无状态 Streamable HTTP。 > 3.3 做于 2026 年 9 月 5 日到 6 日。隐私边界不变：状态、匣子、记忆与凭据均不进入公开仓库。 ## 3.1 更新重点 - **Personality Core 性格内核层**：新增与 12 维当下驱力分离的月度内核，由 AI 自主回顾并通过受鉴权工具完成评分；人类不参与打分。 - **单向、极慢的基线偏置**：仅批准的 4 组内核维度可以影响对应驱力，偏置硬封顶在 ±10%；驱力不会反向自动改写人格评分。 - **待交付内容闭环**：AI 只负责创建和确认“已经说出”，留下（hold）或放下（drop）的决定权归用户；说出与留存是两条独立状态轴。 - **引用式记忆关联**：念头与梦可以围绕具体 OB 记忆桶生成，但心潮不按 ID 修改记忆正文；保留来源链和最终落地桶 ID。 - **饱足期与驱力耦合**：满足后默认保留 2 小时平台期，只暂停自然增长；事件、记忆共振与输出回流仍可正常穿透。 - **可视化与接入收口**：补齐 Personality Core、待交付处置、记忆关联及公开网页所需的脱敏状态接口。 > 3.1 不改变隐私边界：私有 `personality.json`、状态、记忆与凭据均不进入公开仓库。完整源码说明见 [`xinchao/README.md`](xinchao/README.md)，版本差异见 [`xinchao/CHANGELOG.md`](xinchao/CHANGELOG.md)。 ## 快速开始 ```bash cp .env.example .env # 填完文件内标为“必填”的密钥与独立口令 docker compose up -d --build ``` - 两服务在同一 docker 网络内部通信，对外只暴露本机端口。 - 可视化前端使用 [xinchaomind.uk](https://xinchaomind.uk)，不需要直接访问 OB 端口。 ## 先分清三个入口 | 入口 | 用来做什么 | 应该填在哪里 | 绝对不要 | | --- | --- | --- | --- | | `https://xinchaomind.uk` | 公开可视化网页 | 浏览器打开 | 不要当 MCP URL，它也不会替你运行心潮 | | `https://你的心潮域名/mcp` | 心潮·念 MCP/OAuth 网关 | Claude / ChatGPT / IDE 的 MCP 连接器 | 不要填 `xinchaomind.uk` 或 OB 地址 | | `OMBRE_MCP_URL` | 心潮内部读写 OB 记忆 | 只写在心潮服务端 `.env` | 不要交给公开网页，不要当心潮连接器 | > 一句话判断：**人打开公开网页，AI 连接心潮 `/mcp`，心潮再在服务器内连接 OB。** ## 连接 Claude.ai MCP 连接器 心潮·念自带 OAuth 2.1 MCP 端点，可直接作为 Claude.ai 的 MCP 连接器使用。 **重要：连接器必须指向你自己的心潮（端口 18110），不是公开网页，也不是 Ombre Brain（端口 18001）。** OB 的 18001 端口仅用于 Dashboard 管理和内部通信，不要把它当 MCP 连接器添加到 Claude.ai。 在 `.env` 中启用并重启： ```env MCP_ENABLED=true OAUTH_ENABLED=true OAUTH_PUBLIC_BASE_URL=https://你的心潮公网地址 # 必须 HTTPS，指向心潮 18110 端口的反代 OAUTH_APPROVAL_TOKEN=自己生成的授权口令至少16字符 # 添加连接器时在授权页面输入这个 ``` 然后在 Claude.ai 添加 MCP 连接器，URL 填 `https://你的心潮公网地址/mcp`。 授权页面会显示「心潮念」，输入你设置的 `OAUTH_APPROVAL_TOKEN` 即可。 如果你看到的授权页面显示的是「Ombre Brain」而不是「心潮念」，说明你连错了端口—— 检查你的反代/隧道是否指向 18110（心潮），而不是 18001（OB）。 ## 连接心潮念公开可视化 前提是你已经按上面的步骤部署并启动了心潮·念。`xinchaomind.uk` 是可视化 前端，不会替你运行心潮，也无法访问另一台设备的 `localhost`。 先在 `.env` 配好并重启： ```env DASHBOARD_ENABLED=true DASHBOARD_ACCESS_TOKEN=一段至少32字符且与其他密钥不同的随机口令 DASHBOARD_PUBLIC_BASE_URL=http://localhost:18110 DASHBOARD_ALLOWED_ORIGINS=https://xinchaomind.uk ``` 然后按使用场景选择： 1. **网页浏览器和心潮在同一台设备**：在网页选择“我的心潮就在这台设备上”， 地址填 `http://127.0.0.1:18110`，口令填 `DASHBOARD_ACCESS_TOKEN`。 2. **用手机访问电脑/主机里的心潮，或心潮跑在 VPS/N100**：先用 Cloudflare Tunnel、Tailscale Funnel 或自己的反向代理给心潮配置公网 HTTPS 地址；把 `DASHBOARD_PUBLIC_BASE_URL` 改成该地址并重启，再在网页选择“我的心潮有公网地址”。 只填到域名或端口，不要追加 `/mcp`、`/dashboard` 或 `/v1/dashboard/connect`。 `SERVICE_TOKEN`、OB token、OAuth 口令都不能代替 Dashboard 独立口令。 > **常见问题：网页端显示"未接入 OB / 记忆星图不可用"。** > 这几乎都是 `OMBRE_READ_ENABLED` 没打开——它默认 `false`，跟 OB 是否真的部署成功、能否连接是两回事。 > 接了 OB 想在网页看记忆星图，务必在 `.env` 设 `OMBRE_READ_ENABLED=true` 并重启容器 > （联合部署 compose 已默认开好）。配了 `OMBRE_MCP_URL` 却没开 read 时，启动日志也会打一条告警提醒。 完整判断表、配置示例和常见错误见 [连接公开可视化](docs/CONNECT-XINCHAOMIND.md)。 ## 结构 ``` compose.yaml 两服务联合编排（共享网络、内部互通） .env.example 合并配置模板 xinchao/ 心潮源码（动态心智）—— MIT ombre-brain/ Ombre Brain 源码（记忆库）—— 见 NOTICE / LICENSE bridge/ 心潮念 Runtime Bridge（git 子模块）—— 用户主动互动的本地连接桥 （数据用 docker 命名卷 ombre-buckets / xinchao-state，首启自动生成、重启不丢） ``` > 含子模块，克隆用 `git clone --recursive`，或克隆后 `git submodule update --init`。 ## 连接桥（Runtime Bridge） `bridge/` 子模块指向独立仓库 [xinchao-runtime-bridge](https://github.com/tianyupaipai-cmd/xinchao-runtime-bridge)—— 一个**本地、可审计、拉取式**的连接工具：把用户在网页上主动发出的互动 / 便签 / 预约 （`user_interaction` / `user_note` / `scheduled_interaction`）从心潮念平台队列拉取，注入用户自己的 AI Runtime。梦境、余韵、思念、内部状态与 AI 自主行动**不允许**自动注入窗口——只留在心潮念里， 用户主动回应或转成便签后才进桥。 - 它是**用户本地运行**的工具，不是服务端组件，不进 `compose.yaml`。 - 需要心潮念平台实现 `/bridge/v1/*` 服务端接口后端到端可用（服务端队列即心潮的 BridgeQueue）。 ## 融合能力 | 能力 | 说明 | |---|---| | 输出回流 | 它说出口的话回过头改自己的状态 | | 时间地板 | 每维驱力各自静息天花板，缺席抬底值 | | 记忆共振 | breath 吐 domain/tags，心潮按亲和度回推驱力 | | 作息预期 + 挂念 | 从你真实到达节律长出"在等你"和"想你了"，失落内化不责备 | | 梦境安全化 | 梦是消化残渣、不冒充真实记忆，不自噬 | ## 许可证与署名 - 仓库根的联合发行代码标示为 AGPL-3.0；`xinchao/` 目录仍保留其 MIT 许可文件。 - `ombre-brain/`（Ombre Brain）：基于 P0luz 的 Ombre Brain 与 Yinglianchun 的 fork， **保留其原始许可证与署名**，见 [NOTICE](NOTICE)。本项目对其的修改记录见 `ombre-brain/MODIFICATIONS.md`。 - 本融合项目**非纯 MIT**；商业使用需取得上游 OB 作者的书面许可。 详细的分目录边界见 [许可说明](docs/LICENSING.md)。根目录的 AGPL 不会覆盖 `ombre-brain/` 已有的上游非商业约束。 > 详细边界见上游来源说明。融合不改变 OB 原生记忆库功能——breath/hold/grow/dream/trace/ > anchor/release/forget/restore/purge/I/plan/letter/pulse 与 Dashboard 全部保留。 ## 联系 商业合作及付费咨询请联系：tianyupaipai@gmail.com