cortico-world-humanize 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # 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 模式，不用再到「模型」页新建、切换端点。

package/README.md

@@ -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,6 +86,7 @@ Coopanion 重启后沿用旧的系统前缀。换了模式或者活人感更新
 
 ## 停用和卸载
 
+- **只停用 provider**：基本设置里关掉「用「活人感 provider」」，再把活人感关开一次。provider 原样转发，活人感改回「先感受再开口」。Coopanion 的模型扩展本身没有停用开关，所以放在这里。
 - **暂时不用**：World 页关掉「活人感」。Coopanion 会立刻重建系统前缀，环境说明和 `humanize_feel` 工具一起拿掉。
 - **卸载**：在「扩展」页卸掉两个包，然后重启。只有一种情况要先做一步：你用 0.1.0 时在「模型」页新建过「活人感」端点，而且当前端点还是它，那要**先把当前端点切回原来那个**，不然卸掉 provider 后桌宠会说不了话。
 - **清干净**：想连数据一起去掉，删掉上面「数据和隐私」里列的两个文件夹和配置段即可。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cortico-world-humanize",
-  "version": "0.2.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,7 +23,7 @@
     "locales": {
       "zh": {
         "displayName": "活人感",
-        "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**要知道的**\n\n- 你每说一句话，会多调用一次副 API（默认 DeepSeek，约 1–2 秒，花费很少）。\n- 默认读桌宠、控制台、QQ 私聊和 @桌宠的消息。QQ 群里别人的话会经过副 API 影响心事，介意的话可以在配置里关掉。\n- 只支持中文，目前只在 Windows + DeepSeek 上测过。\n- 不想用了：World 页关掉即可。卸载：扩展页卸掉，重启。"
+        "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",

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,

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

@@ -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;
@@ -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,6 +862,8 @@ export class HumanizeWorld implements World {
     if (this.cfg.voice && voice.outdated && voice.edited) {
       notes.push('人设改过了，但口吻样本是按旧人设写的（你改过它，所以没有自动重写）：想按新人设重写，勾一下下面的「重写口吻样本」。');
     }
+    const provider = this.providerStatus();
+    if (provider.note) notes.push(provider.note);
     if (this.prefixState.legacyEndpoint()) {
       notes.push(`当前端点「${this.prefixState.activeEndpoint()}」是旧版的「活人感」端点。现在不用它了：装着活人感 provider 时，你原来的端点会自动带上活人感。建议在「模型」页切回原来的端点；以后要卸载 provider，也一定要先切回去，不然桌宠会说不了话。`);
     }
@@ -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' },