cortico-world-humanize 0.1.0 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.2.1
+
+- 新增开关「用「活人感 provider」」（在活人感的基本设置里，默认开）。Coopanion 的模型扩展没有停用开关，所以放在这里：关掉后 provider 原样转发、什么都不做，桌宠改回先调用 `humanize_feel`。不用卸载 provider 也能停用它。
+- World 页新增「活人感 provider」状态灯和两个徽章，一眼看出 provider 有没有生效：
+  - **已生效**（绿）：写明包着哪个端点；「provider 注入」记着这次启动后把心事塞进请求的次数。
+  - **待刷新**：装好了，还差把活人感关掉再打开一次。
+  - **待重启**：装了但还没加载，重启 Coopanion 才生效。
+  - **版本旧**：装的 provider 和这一版活人感对不上，要升级。
+  - **没包住**：当前端点的类型 provider 包不了。
+  - **已关闭**：装着，但上面的开关关了。
+  - **没装**：provider 是可选的，没装也能用。
+- 没生效时，配置页顶部也写一句原因和该怎么做。
+
+## 0.2.0
+
+- 搭配「活人感 provider」0.2.0：装上 provider 重启就进入 provider 模式，不用再到「模型」页新建、切换端点。
+- 还在用 0.1.0 时手动新建的「活人感」端点的，World 页会提示可以切回原来的端点；只有这种情况，卸载 provider 前才需要先切回去。
+- 和 provider 之间的桥升到第 3 版：要和 `cortico-provider-humanize` 0.2.0 一起用。版本对不上时退回「先感受再开口」，不出错。
+
 ## 0.1.0
 
 第一个公开版本。

package/README.md

@@ -11,7 +11,7 @@
 
 ## 安装
 
-1. Coopanion 的「扩展」页搜 `cortico-world-humanize` 或「活人感」，安装。
+1. Coopanion 的「扩展」页搜「活人感」，安装 `cortico-world-humanize`。推荐把 `cortico-provider-humanize` 也装上（可选，装上就生效，不用设置）。
 2. 重启 Coopanion。
 3. World 页打开「活人感」。
 
@@ -35,7 +35,7 @@
 
 | 方式 | 什么时候 | 效果 |
 |---|---|---|
-| **provider 模式** | 装了活人感 provider，并把当前端点切到它包着的那个 | provider 在主模型请求发出前等心事，塞进请求再发。一轮就带着心事开口，最推荐 |
+| **provider 模式** | 装了活人感 provider（装上就自动包住你现在用的端点），且基本设置里「用「活人感 provider」」开着（默认开） | provider 在主模型请求发出前等心事，塞进请求再发。一轮就带着心事开口，最推荐 |
 | 先感受再开口（默认） | 没用 provider | 桌宠先调用 `humanize_feel`，工具等副 API 想好再交回去。每次都赶得上，但主模型多一轮 |
 | 抢时间 | 没用 provider，且关掉「先感受再开口」 | 心事作为事件推进去，桌宠已经开口就作废 |
 
@@ -58,7 +58,8 @@
 - **配置**：基本设置、副 API、QQ 扩展、其他聊天来源
 - **提示词**：预设库（情境、情绪、小动作、不想听到的说法）、环境提示词、口吻样本、最近 20 轮记录
 - **数据**：清空最近记录和计数
-- 导航栏：副 API 和系统前缀两个状态灯，以及几个计数
+- 导航栏：副 API、系统前缀、活人感 provider 三个状态灯（悬停看详情），以及几个计数
+- **provider 生没生效**：看「provider」徽章。「已生效」就是在用；「待刷新」「待重启」「版本旧」「没包住」会在配置页顶部写明怎么办。「provider 注入」是这次启动后心事塞进请求的次数，对桌宠说句话它就加一
 
 ## 系统前缀要刷新的时候
 
@@ -85,8 +86,9 @@ Coopanion 重启后沿用旧的系统前缀。换了模式或者活人感更新
 
 ## 停用和卸载
 
+- **只停用 provider**：基本设置里关掉「用「活人感 provider」」，再把活人感关开一次。provider 原样转发，活人感改回「先感受再开口」。Coopanion 的模型扩展本身没有停用开关，所以放在这里。
 - **暂时不用**：World 页关掉「活人感」。Coopanion 会立刻重建系统前缀，环境说明和 `humanize_feel` 工具一起拿掉。
-- **卸载**：用了 provider 的话，**先在「模型」页把当前端点切回原来那个**，再在「扩展」页卸掉两个包，然后重启。不切回去就卸 provider，桌宠会说不了话。
+- **卸载**：在「扩展」页卸掉两个包，然后重启。只有一种情况要先做一步：你用 0.1.0 时在「模型」页新建过「活人感」端点，而且当前端点还是它，那要**先把当前端点切回原来那个**，不然卸掉 provider 后桌宠会说不了话。
 - **清干净**：想连数据一起去掉，删掉上面「数据和隐私」里列的两个文件夹和配置段即可。
 
 ## 开发
@@ -109,4 +111,4 @@ MIT
 
 **Humanize** is a Cortico World for the Coopanion desktop pet. When someone talks to the pet, it reads the situation, the person's mood and the pet's own persona and memory files, and hands the pet a short inner thought before it answers. It also watches the pet's recent lines for stock AI sentence patterns ("not X but Y", parroting the other person's words back, either-or questions, aphorisms, and similar) and reminds the pet to say it another way when one shows up. It only targets sentence patterns: catchphrases, tone and length are left to the character.
 
-Install it from Coopanion's Extensions page, restart, and turn it on in the World page. It works best together with [cortico-provider-humanize](https://github.com/abbabanana/cortico-provider-humanize), which puts the inner thought straight into the main model's request. Prompts, presets and detection are Chinese only for now. Licensed under MIT.
+Install it from Coopanion's Extensions page, restart, and turn it on in the World page. It works best together with [cortico-provider-humanize](https://github.com/abbabanana/cortico-provider-humanize), which puts the inner thought straight into the main model's request; install it and restart, there is nothing to configure. Prompts, presets and detection are Chinese only for now. Licensed under MIT.

package/describe.json

@@ -29,8 +29,8 @@
     {
       "type": "humanize.notice",
       "description": {
-        "zh": "请桌宠转告对方的提醒：换了模式或扩展更新后，系统前缀需要刷新；切到 provider 端点后，卸载前要先切回原端点。每种变化一次。",
-        "en": "A reminder the pet passes on: the system prefix needs a refresh after a mode change or an update; with the provider endpoint active, switch back before uninstalling it. Once per change."
+        "zh": "请桌宠转告对方的提醒：换了模式或扩展更新后，系统前缀需要刷新；还在用旧版「活人感」端点时，卸载 provider 前要先切回原端点。每种变化一次。",
+        "en": "A reminder the pet passes on: the system prefix needs a refresh after a mode change or an update; on a legacy Humanize endpoint, switch back before uninstalling the provider. Once per change."
       },
       "trigger": "flush"
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cortico-world-humanize",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "type": "module",
   "description": "Cortico World for Coopanion: before the pet answers, reads the situation, mood and the pet's own memory and hands it a short inner thought, and reminds it when it slips into stock AI sentence patterns",
   "author": "abbabanana",
@@ -23,11 +23,11 @@
     "locales": {
       "zh": {
         "displayName": "活人感",
-        "description": "桌宠开口前，先读一下情境、心情和它自己的记忆，递给它一句「此刻心里的想法」；它要是用了「不是……而是……」、先复述你的话这类 AI 固定句式，下次就提醒它换个说法。口癖、语气、长短都不碰。搭配「活人感 provider」效果最好。"
+        "description": "让桌宠开口前先「想一想」，说话更像个人，少一点 AI 腔。单独装就能用，搭配「活人感 provider」更快。\n\n**它做什么**\n\n- 你对桌宠说话时，先读一下情境、你的心情和桌宠自己的记忆，递给它一句「此刻心里的想法」，再让它开口。\n- 桌宠要是用了「不是……而是……」、先复述你的话这类 AI 固定句式，下次就提醒它换个说法。口癖、语气、长短都不碰。\n\n**两个扩展怎么配合**\n\n- **活人感**（就是本扩展，必装）：负责想心事、查句式。单独装就能用。\n- **活人感 provider**（可选，推荐）：把心事直接放进发给模型的请求里。不装的话，桌宠每次要先调一次工具读心事再开口，多跑一轮，稍慢一点。\n- 只装 provider、不装本扩展，没有任何作用。\n\n**怎么用**\n\n1. 在扩展页装上本扩展，推荐把「活人感 provider」一起装上。\n2. 重启 Coopanion。\n3. 到 World 页打开「活人感」。\n\n主模型用的是 DeepSeek 的话，什么都不用填。用别家的话，在活人感的「配置 → 副 API」里填地址、模型和 Key。\n\n如果活人感已经开着、之后才装 provider，World 页会提示「系统前缀需要刷新」：把活人感关掉再打开一次就好，聊天记录会保留。\n\n**怎么看 provider 生没生效**：World 页「活人感」的「provider」徽章显示「已生效」就是在用；「provider 注入」是心事塞进请求的次数，对桌宠说句话就会加一。没生效时，配置页顶部会写明原因和该怎么做。\n\n**想停用 provider**：不用卸载，在活人感「配置 → 基本设置」里关掉「用「活人感 provider」」，再把活人感关掉打开一次。\n\n**要知道的**\n\n- 你每说一句话，会多调用一次副 API（默认 DeepSeek，约 1–2 秒，花费很少）。\n- 默认读桌宠、控制台、QQ 私聊和 @桌宠的消息。QQ 群里别人的话会经过副 API 影响心事，介意的话可以在配置里关掉。\n- 只支持中文，目前只在 Windows + DeepSeek 上测过。\n- 不想用了：World 页关掉即可。卸载：扩展页卸掉，重启。"
       },
       "en": {
         "displayName": "Humanize",
-        "description": "Before the pet answers, reads the situation, mood and the pet's own memory and hands it a short inner thought; when it slips into stock AI sentence patterns (\"not X but Y\", parroting your words back), it is reminded to say it another way next time. Catchphrases, tone and length are left alone. Works best with the Humanize provider."
+        "description": "Lets the pet think for a moment before it speaks, so it sounds more like a person and less like an AI. Works on its own; faster with the Humanize provider.\n\n**What it does**\n\n- When you talk to the pet, it reads the situation, your mood and the pet's own memory, and hands the pet a short inner thought before it answers.\n- When the pet slips into stock AI sentence patterns (\"not X but Y\", parroting your words back), it is reminded to say it another way next time. Catchphrases, tone and length are left alone.\n\n**How the two extensions fit together**\n\n- **Humanize** (this one, required): writes the inner thought and checks sentence patterns. Works on its own.\n- **Humanize provider** (optional, recommended): puts the thought straight into the request sent to the model. Without it, the pet first calls a tool to read the thought, which costs one extra round.\n- The provider alone does nothing.\n\n**Getting started**\n\n1. Install this extension on the Extensions page, ideally together with the Humanize provider.\n2. Restart Coopanion.\n3. Turn on Humanize on the World page.\n\nIf your main model is DeepSeek, there is nothing to fill in. Otherwise enter the address, model and key under Config → Side API.\n\n**Good to know**\n\n- Each message you send adds one side-API call (DeepSeek by default, about 1–2 seconds, very cheap).\n- Prompts, presets and pattern checks are Chinese only. Tested on Windows with DeepSeek only.\n- To stop: turn it off on the World page. To uninstall: remove it on the Extensions page and restart."
       }
     },
     "tags": ["companion", "internal-state", "qq", "im", "high-cost", "injection-risk", "experimental"],

package/src/bridge.ts

@@ -1,10 +1,13 @@
 /**
- * World 与「活人感」provider 之间的桥：两个包装在同一个进程里，靠 globalThis 上一个约定好的
- * Symbol 碰头，谁也不 import 谁。World 启动时挂上，停用时摘掉；provider 找不到桥就原样转发。
+ * World 与「活人感」provider 之间的桥：两个包装在同一个进程里，靠 globalThis 上约定好的
+ * Symbol 碰头，谁也不 import 谁。
+ * - BRIDGE_KEY:World 启动时挂上，停用时摘掉；provider 找不到就原样转发。
+ * - PROVIDER_KEY:provider 加载时挂上，说明它包住了哪些端点模块；World 据此判断走不走 provider 模式。
  * 改这里的形状要同时改 cortico-provider-humanize/src/bridge.ts,并把 version 加一。
  */
 export const BRIDGE_KEY = Symbol.for('cortico-humanize.bridge');
-export const BRIDGE_VERSION = 2;
+export const PROVIDER_KEY = Symbol.for('cortico-humanize.provider');
+export const BRIDGE_VERSION = 3;
 
 /** 主模型这次请求里看到的东西，provider 原样转述（已截短）。 */
 export interface MainContext {
@@ -28,6 +31,13 @@ export interface HumanizeBridge {
   touch(): void;
 }
 
+/** provider 挂的牌子。 */
+export interface ProviderMarker {
+  version: typeof BRIDGE_VERSION;
+  /** 这种端点模块（端点配置里的 kind）是不是被活人感包着。 */
+  wraps(kind: string): boolean;
+}
+
 export function installBridge(bridge: HumanizeBridge): void {
   (globalThis as Record<symbol, unknown>)[BRIDGE_KEY] = bridge;
 }
@@ -36,3 +46,9 @@ export function removeBridge(bridge: HumanizeBridge): void {
   const g = globalThis as Record<symbol, unknown>;
   if (g[BRIDGE_KEY] === bridge) delete g[BRIDGE_KEY];
 }
+
+/** 装着的、版本对得上的 provider;没有给 null。 */
+export function providerMarker(): ProviderMarker | null {
+  const m = (globalThis as Record<symbol, unknown>)[PROVIDER_KEY] as ProviderMarker | undefined;
+  return m && m.version === BRIDGE_VERSION && typeof m.wraps === 'function' ? m : null;
+}

package/src/config.ts

@@ -17,6 +17,11 @@ export interface HumanizeConfigSection {
    * 关掉则是抢时间模式：引导回来时桌宠还没开口才用得上。
    */
   wait: boolean;
+  /**
+   * 用「活人感」provider 把心事直接塞进主模型请求。provider 扩展本身没有开关（Coopanion 不支持
+   * 停用 provider 扩展），开关放在这里：关掉后 provider 原样转发，桌宠改回先调用 humanize_feel。
+   */
+  useProvider: boolean;
   /** 摸头、戳、换装这类小动作也带一句轻预设（不调副 API）。 */
   light: boolean;
   /** 小动作带轻预设的概率，0–1；动作频繁时别每次都带。 */
@@ -62,6 +67,7 @@ export const HUMANIZE_DEFAULTS: HumanizeConfigSection = {
   enabled: false,
   guide: true,
   wait: true,
+  useProvider: true,
   light: true,
   lightChance: 0.5,
   contextTurns: 6,
@@ -144,6 +150,10 @@ export function configGroups(keyStatus: string, notes: string[] = [], seen: Seen
             description: '开着：桌宠收到你的话先等副 API 想好心情再回答，每次都用得上，但回应慢一秒左右。关掉：抢时间，桌宠开口太快时这一轮的引导就作废。改完在下一次会话开始时完全生效。',
             'x-hot': true,
           },
+          [`${K}.useProvider`]: {
+            type: 'boolean', title: '用「活人感 provider」', 'x-hot': true,
+            description: '装了「活人感 provider」才有用（没装时开着也没关系）。开着：心事直接跟着你的话发给模型，桌宠一轮就开口。关掉：provider 原样转发、什么都不做，桌宠改回先调用 humanize_feel。Coopanion 的模型扩展没有停用开关，所以开关放在这里。改完把活人感关掉再打开一次才完全生效。',
+          },
           [`${K}.light`]: {
             type: 'boolean', title: '小动作也带轻预设',
             description: '被戳、被摸、被拎起、换装时，从预设库抽一句心情给它。', 'x-hot': true,
@@ -175,7 +185,7 @@ export function configGroups(keyStatus: string, notes: string[] = [], seen: Seen
           },
           [`${K}.notify`]: {
             type: 'boolean', title: '前缀需要刷新时让桌宠提醒我', 'x-hot': true,
-            description: '换了模式（比如切到 provider 端点、开关「先感受再开口」），或者活人感更新了说明之后，桌宠会用气泡说一次。每种变化只提醒一次。',
+            description: '换了模式（比如装上或卸掉 provider、开关「先感受再开口」），或者活人感更新了说明之后，桌宠会用气泡说一次。每种变化只提醒一次。',
           },
           [`${K}.autoRefresh`]: {
             type: 'boolean', title: '前缀需要刷新时自动刷新', 'x-hot': true,

package/src/definition.ts

@@ -35,8 +35,8 @@ export const HUMANIZE: WorldDefinition<HumanizeConfigSection> = {
     }, {
       type: NOTICE_EVENT,
       description: {
-        zh: '请桌宠转告对方的提醒：换了模式或扩展更新后，系统前缀需要刷新；切到 provider 端点后，卸载前要先切回原端点。每种变化一次。',
-        en: 'A reminder the pet passes on: the system prefix needs a refresh after a mode change or an update; with the provider endpoint active, switch back before uninstalling it. Once per change.',
+        zh: '请桌宠转告对方的提醒：换了模式或扩展更新后，系统前缀需要刷新；还在用旧版「活人感」端点时，卸载 provider 前要先切回原端点。每种变化一次。',
+        en: 'A reminder the pet passes on: the system prefix needs a refresh after a mode change or an update; on a legacy Humanize endpoint, switch back before uninstalling the provider. Once per change.',
       },
       trigger: 'flush',
     }],

package/src/prefix-state.ts

@@ -4,12 +4,14 @@
  * 改了环境说明之后，前缀会旧一阵。这里记下最近一次拼前缀时的模式和环境说明的指纹（落盘，
  * 重启也在），和此刻该有的比一比，不一样就提醒人去 World 页关开一次。
  *
- * provider 模式按当前端点的配置判断（部署 config.json 的 activeProvider → 那个端点的 kind），
- * 不看「最近有没有转发过请求」：重启后第一次拼前缀时 provider 还没转发过，看时间会误判。
+ * provider 模式按当前端点的配置判断（部署 config.json 的 activeProvider → 那个端点的 kind,
+ * 再问 provider 挂的牌子包没包这种 kind），不看「最近有没有转发过请求」：重启后第一次拼前缀时
+ * provider 还没转发过，看时间会误判。
  */
 import { createHash } from 'node:crypto';
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
+import { providerMarker } from './bridge.ts';
 
 export type Mode = 'provider' | 'tool' | 'push';
 
@@ -19,7 +21,8 @@ export const MODE_LABEL: Record<Mode, string> = {
   push: '抢时间模式（心事作为事件推送）',
 };
 
-const PROVIDER_KIND = 'humanize';
+/** 0.1.0 时要手动新建的那种端点。 */
+const LEGACY_KIND = 'humanize';
 
 interface Saved {
   prefix?: { mode: Mode; sig: string };
@@ -73,9 +76,21 @@ export class PrefixState {
     return typeof name === 'string' ? name : '';
   }
 
-  /** 当前端点是不是「活人感」provider 包着的那种。 */
+  /** 当前端点的模块（kind）；读不到给空串。 */
+  activeKind(): string {
+    const kind = this.endpoint.read()?.kind;
+    return typeof kind === 'string' ? kind : '';
+  }
+
+  /** 当前端点有没有被「活人感」provider 包着：装了 provider,且它包住了这种端点。 */
   providerConfigured(): boolean {
-    return this.endpoint.read()?.kind === PROVIDER_KIND;
+    const kind = this.activeKind();
+    return !!kind && !!providerMarker()?.wraps(kind);
+  }
+
+  /** 当前端点是不是 0.1.0 时手动新建的那种（卸 provider 前要先切回原端点）。 */
+  legacyEndpoint(): boolean {
+    return this.activeKind() === LEGACY_KIND;
   }
 
   /** 拼前缀时记下当时的模式和指纹。 */

package/src/provider-status.ts

@@ -0,0 +1,47 @@
+/**
+ * 「活人感 provider」此刻是什么状态，给 World 页的状态灯用。
+ *
+ * provider 加载后会在 globalThis 挂牌子（见 bridge.ts）。没挂牌子时分不清是「没装」「装了还没重启」
+ * 还是「装的是对不上的旧版」，所以再去扩展目录看一眼装没装、装的哪一版。
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const PACKAGE = 'cortico-provider-humanize';
+/** 这一版 World 要求的 provider 最低版本（桥第 3 版）。 */
+export const PROVIDER_MIN = '0.2.0';
+const CACHE_MS = 5_000;
+
+const OWN_DIR = fileURLToPath(new URL('..', import.meta.url));
+
+let cache: { at: number; botDir: string; version: string | null } | null = null;
+
+/** 扩展目录里装着的 provider 版本；没装（或找不到）给 null。 */
+export function installedProviderVersion(botDir: string): string | null {
+  if (cache && cache.botDir === botDir && Date.now() - cache.at < CACHE_MS) return cache.version;
+  const candidates = [
+    // Coopanion:<data>/home/<部署> 和 <data>/extensions/node_modules
+    join(dirname(dirname(botDir)), 'extensions', 'node_modules', PACKAGE, 'package.json'),
+    // 和本包装在同一个 node_modules 里
+    join(OWN_DIR, '..', PACKAGE, 'package.json'),
+  ];
+  let version: string | null = null;
+  for (const file of candidates) {
+    try {
+      if (!existsSync(file)) continue;
+      const v = (JSON.parse(readFileSync(file, 'utf8')) as { version?: unknown }).version;
+      if (typeof v === 'string') { version = v; break; }
+    } catch { /* 读不了就当没找到 */ }
+  }
+  cache = { at: Date.now(), botDir, version };
+  return version;
+}
+
+/** a < b(只比主、次、修订号）。 */
+export function older(a: string, b: string): boolean {
+  const parse = (v: string) => v.split(/[.+-]/).slice(0, 3).map((n) => Number.parseInt(n, 10) || 0);
+  const [x, y] = [parse(a), parse(b)];
+  for (let i = 0; i < 3; i++) if (x[i] !== y[i]) return x[i] < y[i];
+  return false;
+}

package/src/world.ts

@@ -3,7 +3,7 @@
  *
  * - 有人对桌宠说话（桌宠、控制台、适配过的 QQ 扩展、勾上的其他来源）：调副 API 读情境、写一句
  *   内心引导，后面跟上「说话提醒」（桌宠最近真用过的套路句式）。交给桌宠有三条路：
- *   - provider 模式（当前端点是「活人感」provider 包着的那个）：provider 在主模型请求发出前来认领，
+ *   - provider 模式（装了「活人感」provider,它包着当前端点）：provider 在主模型请求发出前来认领，
  *     顺带递来主模型的上下文；心事想好后由它塞进请求。主模型这一轮就带着心事开口。
  *   - 先感受再开口（`wait`,默认）：环境提示词让模型先调用 `humanize_feel`,工具等副 API 的结果
  *     回来，把内心交回给模型，模型读完再说话。
@@ -23,7 +23,8 @@ import type {
 } from 'cortico/core/types.ts';
 import { nowIso } from 'cortico/core/util.ts';
 import { analyze, type Line, type Reading } from './analyzer.ts';
-import { BRIDGE_VERSION, installBridge, removeBridge, type HumanizeBridge, type MainContext } from './bridge.ts';
+import { BRIDGE_VERSION, installBridge, providerMarker, removeBridge, type HumanizeBridge, type MainContext } from './bridge.ts';
+import { PROVIDER_MIN, installedProviderVersion, older } from './provider-status.ts';
 import { HUMANIZE_ID, KEY_SECRET, configGroups, type HumanizeConfigSection } from './config.ts';
 import { FALLBACK_EMOTION, PresetStore, emotionsOf, type Presets, type Scene } from './presets.ts';
 import { PersonaStore } from './persona.ts';
@@ -179,7 +180,8 @@ export class HumanizeWorld implements World {
   private readonly bridge: HumanizeBridge = {
     version: BRIDGE_VERSION,
     sync: () => this.tick(),
-    claim: (cursors, main) => this.claim(cursors, main),
+    // 关了「用活人感 provider」:不交心事，provider 原样转发
+    claim: (cursors, main) => (this.useProvider() ? this.claim(cursors, main) : null),
     touch: () => { this.providerAt = Date.now(); },
   };
   /** 最近一次想好的内心，工具来晚了也能交回去。 */
@@ -192,7 +194,9 @@ export class HumanizeWorld implements World {
   private lastUserAt: number | null = null;
   private readonly recentLines: string[] = [];
   private readonly log: LogEntry[] = [];
-  private readonly stats = { api: 0, preset: 0, late: 0, light: 0, apiMs: 0, waited: 0 };
+  private readonly stats = { api: 0, preset: 0, late: 0, light: 0, apiMs: 0, waited: 0, injected: 0 };
+  /** provider 最近一次把心事塞进请求的时刻（时:分:秒）。 */
+  private lastInjectedAt = '';
   private keyNote = '';
   private readonly presets: PresetStore;
   private readonly persona: PersonaStore;
@@ -227,10 +231,16 @@ export class HumanizeWorld implements World {
    * 先看当前端点的配置（拼前缀时 provider 可能还没转发过），读不到再看它最近有没有报到。
    */
   private providerLive(): boolean {
+    if (!this.useProvider()) return false;
     return this.prefixState.providerConfigured()
       || (this.providerAt !== null && Date.now() - this.providerAt < PROVIDER_LIVE_MS);
   }
 
+  /** 配置里的「用活人感 provider」;旧配置没有这一项时算开着。 */
+  private useProvider(): boolean {
+    return this.cfg.useProvider !== false;
+  }
+
   private mode(): Mode {
     return this.providerLive() ? 'provider' : this.cfg.wait ? 'tool' : 'push';
   }
@@ -479,6 +489,8 @@ export class HumanizeWorld implements World {
     return thinking.promise.then((feeling) => {
       if (!feeling) return null;
       this.stats.waited++;
+      this.stats.injected++;
+      this.lastInjectedAt = nowIso(this.opts.timezone).slice(11, 19);
       this.count(feeling);
       this.record({ trigger: feeling.via, outcome: feeling.outcome, text: feeling.body, ms: feeling.ms, error: feeling.error, how: `经 provider 注入，主模型晚发了 ${Date.now() - started}ms` });
       return feeling.body;
@@ -757,8 +769,8 @@ export class HumanizeWorld implements World {
     const what = stale.from !== stale.to
       ? `换成了${MODE_LABEL[stale.to]}`
       : '更新了给桌宠的说明';
-    const uninstall = stale.to === 'provider'
-      ? '另外记一下：以后要卸载「活人感 provider」的话，先在「模型」页把端点切回原来那个，不然我会说不了话。'
+    const uninstall = stale.to === 'provider' && this.prefixState.legacyEndpoint()
+      ? '另外记一下：现在用的是旧版的「活人感」端点，以后要卸载「活人感 provider」的话，先在「模型」页把端点切回原来那个，不然我会说不了话。'
       : '';
     if (this.cfg.autoRefresh) {
       if (this.phase !== 'idle' || !this.prefixState.firstTime(`refresh:${key}`)) return;
@@ -780,6 +792,48 @@ export class HumanizeWorld implements World {
     }
   }
 
+  /**
+   * 「活人感 provider」生没生效，给 World 页看：状态灯（悬停看详情）、徽章上的一两个字，
+   * 以及没生效时放在配置页顶部的一句说明。
+   */
+  private providerStatus(): { lamp: WorldLamp; badge: string; note?: string } {
+    const label = '活人感 provider';
+    const endpoint = this.prefixState.activeEndpoint() || '（未选）';
+    const kind = this.prefixState.activeKind();
+    if (providerMarker()) {
+      if (!this.useProvider()) {
+        const stale = this.staleness();
+        const hint = stale && stale.from === 'provider'
+          ? '已在配置里关掉，还差一步：把活人感关掉再打开一次'
+          : '已装好，但在配置里关掉了：provider 原样转发，桌宠先调用 humanize_feel 再开口。想用就打开「用「活人感 provider」」。';
+        return { lamp: { label, state: 'offline', hint }, badge: '已关闭' };
+      }
+      if (!this.prefixState.providerConfigured()) {
+        const why = `活人感 provider 已装好，但没包住当前端点「${endpoint}」${kind ? `（类型 ${kind}）` : ''}，这个端点不会带上活人感，桌宠照旧先调用 humanize_feel。`;
+        return { lamp: { label, state: 'error', hint: why }, badge: '没包住', note: why };
+      }
+      const stale = this.staleness();
+      if (stale && stale.to === 'provider' && stale.from !== 'provider') {
+        return { lamp: { label, state: 'loading', hint: '已装好，还差一步：把活人感关掉再打开一次' }, badge: '待刷新' };
+      }
+      const n = this.stats.injected;
+      const hint = n
+        ? `已生效：包着端点「${endpoint}」。这次启动已注入 ${n} 次，最近一次 ${this.lastInjectedAt}。`
+        : `已生效：包着端点「${endpoint}」。对桌宠说句话，「provider 注入」就会加一。`;
+      return { lamp: { label, state: 'online', hint }, badge: '已生效' };
+    }
+    const version = installedProviderVersion(this.opts.botDir);
+    if (!version) {
+      return { lamp: { label, state: 'offline', hint: '没装（可选）：装上「活人感 provider」并重启，桌宠每次能少跑一轮。' }, badge: '没装' };
+    }
+    if (older(version, PROVIDER_MIN)) {
+      const why = `装着的活人感 provider 是 ${version}，太旧了，和这一版活人感对不上，现在不起作用（不会出错，只是桌宠每次多跑一轮）。到「扩展」页把它升到最新版，然后重启 Coopanion。`;
+      return { lamp: { label, state: 'error', hint: why }, badge: '版本旧', note: why };
+    }
+    const why = `活人感 provider ${version} 已安装，但还没加载：重启一次 Coopanion 才生效。`;
+    return { lamp: { label, state: 'error', hint: why }, badge: '待重启', note: why };
+  }
+
   /** 请桌宠用一两句话转告对方。和 Coopanion 自己告诉桌宠设置变了是同一个路子。 */
   private async notice(text: string): Promise<void> {
     const host = this.host;
@@ -808,8 +862,10 @@ export class HumanizeWorld implements World {
     if (this.cfg.voice && voice.outdated && voice.edited) {
       notes.push('人设改过了，但口吻样本是按旧人设写的（你改过它，所以没有自动重写）：想按新人设重写，勾一下下面的「重写口吻样本」。');
     }
-    if (this.prefixState.providerConfigured()) {
-      notes.push(`当前端点「${this.prefixState.activeEndpoint()}」由活人感 provider 包着。以后要卸载 provider，先在「模型」页把端点切回原来的那个，不然桌宠会说不了话。`);
+    const provider = this.providerStatus();
+    if (provider.note) notes.push(provider.note);
+    if (this.prefixState.legacyEndpoint()) {
+      notes.push(`当前端点「${this.prefixState.activeEndpoint()}」是旧版的「活人感」端点。现在不用它了：装着活人感 provider 时，你原来的端点会自动带上活人感。建议在「模型」页切回原来的端点；以后要卸载 provider，也一定要先切回去，不然桌宠会说不了话。`);
     }
     return notes;
   }
@@ -871,7 +927,8 @@ export class HumanizeWorld implements World {
       stat: () => `${this.log.length} 条`,
       clear: () => {
         this.log.length = 0;
-        Object.assign(this.stats, { api: 0, preset: 0, late: 0, light: 0, apiMs: 0, waited: 0 });
+        Object.assign(this.stats, { api: 0, preset: 0, late: 0, light: 0, apiMs: 0, waited: 0, injected: 0 });
+        this.lastInjectedAt = '';
         this.writeLog();
         return '已清空';
       },
@@ -881,11 +938,14 @@ export class HumanizeWorld implements World {
     const prefixLamp: WorldLamp = stale
       ? { label: '系统前缀', state: this.cfg.autoRefresh ? 'loading' : 'error', hint: this.cfg.autoRefresh ? '等桌宠空闲后自动刷新' : '需要刷新：把活人感关掉再打开一次' }
       : { label: '系统前缀', state: 'online', hint: `最新（${MODE_LABEL[this.mode()]}）` };
+    const provider = this.providerStatus();
     return {
       label: '活人感',
-      lamps: [lamp, prefixLamp],
+      lamps: [lamp, prefixLamp, provider.lamp],
       badges: [
         { label: '前缀', value: stale ? '需要刷新' : '最新', tone: stale ? 'off' : 'on' },
+        { label: 'provider', value: provider.badge, tone: provider.lamp.state === 'online' ? 'on' : provider.lamp.state === 'offline' ? 'plain' : 'off' },
+        { label: 'provider 注入', value: this.stats.injected, tone: this.stats.injected ? 'on' : 'plain' },
         { label: '副 API 引导', value: this.stats.api, tone: 'on' },
         { label: '预设兜底', value: this.stats.preset, tone: 'plain' },
         { label: '等内心再开口', value: this.stats.waited, tone: 'plain' },