cortico-world-humanize 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 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 | 桌宠先调用 `humanize_feel`，工具等副 API 想好再交回去。每次都赶得上，但主模型多一轮 |
 | 抢时间 | 没用 provider，且关掉「先感受再开口」 | 心事作为事件推进去，桌宠已经开口就作废 |
 
@@ -86,7 +86,7 @@ Coopanion 重启后沿用旧的系统前缀。换了模式或者活人感更新
 ## 停用和卸载
 
 - **暂时不用**：World 页关掉「活人感」。Coopanion 会立刻重建系统前缀，环境说明和 `humanize_feel` 工具一起拿掉。
-- **卸载**：用了 provider 的话，**先在「模型」页把当前端点切回原来那个**，再在「扩展」页卸掉两个包，然后重启。不切回去就卸 provider，桌宠会说不了话。
+- **卸载**：在「扩展」页卸掉两个包，然后重启。只有一种情况要先做一步：你用 0.1.0 时在「模型」页新建过「活人感」端点，而且当前端点还是它，那要**先把当前端点切回原来那个**，不然卸掉 provider 后桌宠会说不了话。
 - **清干净**：想连数据一起去掉，删掉上面「数据和隐私」里列的两个文件夹和配置段即可。
 
 ## 开发
@@ -109,4 +109,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.0",
   "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**要知道的**\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

@@ -175,7 +175,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/world.ts

@@ -3,7 +3,7 @@
  *
  * - 有人对桌宠说话（桌宠、控制台、适配过的 QQ 扩展、勾上的其他来源）：调副 API 读情境、写一句
  *   内心引导，后面跟上「说话提醒」（桌宠最近真用过的套路句式）。交给桌宠有三条路：
- *   - provider 模式（当前端点是「活人感」provider 包着的那个）：provider 在主模型请求发出前来认领，
+ *   - provider 模式（装了「活人感」provider,它包着当前端点）：provider 在主模型请求发出前来认领，
  *     顺带递来主模型的上下文；心事想好后由它塞进请求。主模型这一轮就带着心事开口。
  *   - 先感受再开口（`wait`,默认）：环境提示词让模型先调用 `humanize_feel`,工具等副 API 的结果
  *     回来，把内心交回给模型，模型读完再说话。
@@ -757,8 +757,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;
@@ -808,8 +808,8 @@ 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，先在「模型」页把端点切回原来的那个，不然桌宠会说不了话。`);
+    if (this.prefixState.legacyEndpoint()) {
+      notes.push(`当前端点「${this.prefixState.activeEndpoint()}」是旧版的「活人感」端点。现在不用它了：装着活人感 provider 时，你原来的端点会自动带上活人感。建议在「模型」页切回原来的端点；以后要卸载 provider，也一定要先切回去，不然桌宠会说不了话。`);
     }
     return notes;
   }