@zhin.js/plugin-group-suite 1.1.6 → 1.1.8

package/README.md

@@ -1,29 +1,30 @@
 # @zhin.js/plugin-group-suite
 
-Plugin Runtime 群运营能力包，提供签到积分、消息统计、关键词回复与群问答。所有能力
-由 `commands/`、`middlewares/` 和 `skills/` 约定目录发现，不注册 legacy Plugin 回调。
+Plugin Runtime 群运营套件，提供签到积分、消息统计、群问答、持久词库与群成员欢迎。
+能力按统一的 commands、middlewares、handlers、schedules 和 skills 目录发现。
 
-## 安装与拓扑
+## 安装与配置
 
 ```bash
-pnpm add @zhin.js/plugin-group-suite
+pnpm exec zhin install @zhin.js/plugin-group-suite
 ```
 
-父插件在 `package.json#zhin.plugins` 中声明子插件：
+安装会将实例挂在父插件的 `package.json#zhin.plugins`。手工挂载：
 
 ```json
-{
-  "package": "@zhin.js/plugin-group-suite",
-  "instanceKey": "group-suite"
-}
+{ "package": "@zhin.js/plugin-group-suite", "instanceKey": "group-suite" }
 ```
 
-配置位于该实例的层级节点：
+应用 Host 必须共享同一物理实例的 `@zhin.js/command`、`@zhin.js/middleware`、
+`@zhin.js/handler`、`@zhin.js/schedule-feature`、`@zhin.js/tool` 与 `@zhin.js/skill`
+Feature provider，并装配 Schedule Host。正常 CLI 负责 Host 装配；手写测试 Host 也需要显式安装这些资源。
 
 ```yaml
 plugins:
   group-suite:
-    keywordReply: false
+    keywordReply: true
+    ephemeralKeywords: false
+    welcomeMessage: "" # 默认关闭；可设为 欢迎 {name} ({id})
     basePointsMin: 10
     basePointsMax: 30
     streakBonus: 5
@@ -35,26 +36,50 @@ plugins:
     teachPageSize: 10
 ```
 
-完整约束以 [`schema.json`](./schema.json) 为 SSOT。数据优先写入 Runtime
-`DatabaseHost`；未配置数据库时使用插件实例私有的内存存储，适合测试。
+约束以 [schema.json](./schema.json) 为准。启用关键词回复时默认要求 Database Host 的原子
+状态服务；没有该服务会启动失败并提示原因。演示环境可显式设置 `ephemeralKeywords: true`，
+此时词库只活在当前插件实例，插件重载或进程重启后会丢失。
+即使 `keywordReply: false`，词库管理仍要求持久状态服务（除非显式启用临时词库）；默认无数据库
+时这些命令会回复配置要求，不会返回伪造的空词库或宣称写入成功。
 
-数据库、关键词、教学冷却和消息统计缓冲统一封装为 owner-scoped
-`GroupSuiteRuntime`。commands/middlewares 只通过 Capability Context 解析该资源；因此同一
-进程中的多个实例、HMR 新旧 generation 不会共享可变状态。
+持久词库通过公开 `databaseHostToken.state.forConversation()` 存储，每次管理命令在原子
+更新完成后才返回成功。一个群最多 200 条，关键词 1–200 字符，回复 1–2000 字符。
+整个词库的 JSON 编码必须小于 64 KiB（UTF-8 字节，包含键、回复与 JSON 标点）；条数上限与
+字节上限同时约束，长回复可能先达到字节上限。更新超限会拒绝并保留旧词库，临时词库使用同样限制。
+在同一数据库和相同实例身份下，指令热更新、插件重载和进程重启保留词库。
 
-## 能力
+签到、教学和统计优先写入 Database Host；没有数据库时使用实例私有内存模型，不能视为持久存储。
+统计只在入站累加内存缓冲，每 10 秒由正式 Schedule Host 批量写入；主动查询也会刷新缓冲。
+它是 best-effort 计数，并非持久 outbox：停止、插件重载或崩溃时尚未落库的批次可能丢失。
+退休 generation 的清理不额外写数据库，也不绕过代级准入。
 
-| 路径 | 说明 |
+## 使用与权限
+
+未配置命名空间时直接使用表内指令名；如果实例设 `commandNamespace: suite`，使用
+`suite checkin` 等形式。实际前缀由 Endpoint 决定。
+
+| 指令/能力 | 说明 |
 |---|---|
 | `checkin` / `mypoints` / `rank` | 签到、积分与排行 |
 | `stats` / `stats-week` / `stats-rank` / `mystats` | 消息统计 |
-| `teach` / `teach-regex` / `teach-list` / `forget` | 群问答管理 |
-| `keyword-add` / `keyword-list` / `keyword-remove` | 关键词回复管理 |
-| `middlewares/*` | 入站统计、关键词和问答匹配 |
-| `skills/<name>/tools/<tool>/index.ts` | Skill 激活后披露签到查询、排行、消息统计和群公告 Tool |
+| `stats-card` | 当日统计 HTML 图卡；没有渲染服务时走统一文本降级 |
+| `teach` / `teach-regex` / `teach-list` / `forget` | 群问答与管理 |
+| `keyword-add <keyword> <reply...>` / `keyword-list` / `keyword-remove <keyword>` | 当前群词库 |
+| `welcomeMessage` | 当前群增加成员时欢迎，默认关闭，只在设置非空文本后发送 |
+| `skills/<name>/tools/<tool>/index.ts` | Skill 激活后披露签到查询、排行、统计和群公告 Tool |
+
+关键词与问答修改命令要求群主、管理员、master 或 trusted；普通成员不能修改。查询命令仍按其
+各自公开 permit 执行。Tool 保持既有审批策略，命令角色判断不能替代 Tool 审批或平台权限。
+欢迎通过 `outboundMessageToken` 走统一发送链路，投递失败/未知会报错，不盲目重试。
+`stats-card` 是 HTML 图片/文本展示，不是平台原生 `card` 载荷。
 
-本 major 不包含 Adapter side-event 欢迎/撤回、AI 群日报或 HTML 报表。这些旧能力
-需要独立的事件与渲染 Feature，已从 schema 移除，避免出现“可配置但不生效”的字段。
+所有新数据按插件实例与完整会话隔离：平台、Endpoint 身份、群/频道/私聊类型与 ID，以及父会话、
+线程信息共同参与键。相同群号的两个 Bot 不共享词库、签到、教学或统计。群专用 Tool 只接受 IM
+群上下文，并通过当前 AdapterIndex 精确解析 Endpoint，无法确定唯一来源时拒绝执行。当前群的查询保留当前线程，只查该完整会话，不聚合其他线程。
+显式查询另一群时使用该群根会话，不将当前群的线程 ID 带到另一群。
+
+旧记录只有裸群号或全局范围，无法安全判断属于哪个 Bot。新实现不会自动读入或建立兼容别名；
+需要保留旧记录时，维护者必须根据实际 Bot/会话身份进行明确的人工迁移。
 
 ## 验证
 
@@ -62,3 +87,9 @@ plugins:
 pnpm --filter @zhin.js/plugin-group-suite build
 pnpm --filter @zhin.js/plugin-group-suite test
 ```
+
+集成验收使用公开 `@zhin.js/plugin-test-kit`、真实 Native Runtime/CommandIndex/PermissionHost、
+合成端点、真实 PluginScheduleHost 和 SQLite 状态 CAS，覆盖两个实例、端点隔离、权限拒绝、
+无数据库错误、热更新、配置失败回滚及新进程重启后的持久词库。HTML 渲染使用 stub，另测文本
+降级；统计/签到/教学模型在此 fixture 为内存端口。它不代表真实平台登录、欢迎投递、截图质量或
+生产数据库端到端验收；实机操作需要单独授权。

package/commands/forget/index.js

@@ -3,6 +3,7 @@ import { defineCommand } from 'zhin.js/command';
 import { teachForget } from "../../lib/teach-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
+    permit: ['group()', 'role(owner,admin,master,trusted)'],
     description: '忘记问答（删除问答对）',
     execute({ input, args, owner, use }) {
         return teachForget(input ?? {}, args.join(' '), resolveGroupSuiteRuntime({ owner, use }));

package/commands/forget/index.ts

@@ -5,6 +5,7 @@ import { teachForget } from '../../src/teach-lib.js';
 import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
+  permit: ['group()', 'role(owner,admin,master,trusted)'],
   description: '忘记问答（删除问答对）',
   execute({ input, args, owner, use }) {
     return teachForget(input ?? {}, args.join(' '), resolveGroupSuiteRuntime({ owner, use }));

package/commands/keyword-add/[keyword]/index.js

@@ -1,16 +1,19 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineCommand } from 'zhin.js/command';
-import { addKeyword } from "../../../lib/keyword-store.js";
-import { resolveGroupSuiteRuntime } from "../../../lib/runtime-state.js";
+import { keywordsForCommand } from "../../../lib/keywords.js";
 export default defineCommand({
-    description: '添加关键词自动回复',
+    permit: ['group()', 'role(owner,admin,master,trusted)'],
+    description: '添加当前群关键词自动回复',
     params: { keyword: { type: 'string' } },
-    execute({ params, args, owner, use }) {
-        const keyword = String(params.keyword ?? '');
-        const reply = args.join(' ').trim();
+    async execute(context) {
+        const keyword = String(context.params.keyword ?? '');
+        const reply = context.args.join(' ').trim();
         if (!keyword || !reply)
             return '请提供关键词和回复内容';
-        addKeyword(keyword, reply, resolveGroupSuiteRuntime({ owner, use }).keywords);
+        const repository = keywordsForCommand(context.input, context);
+        if (typeof repository === 'string')
+            return repository;
+        await repository.update(store => { store.set(keyword, reply); });
         return `已添加关键词「${keyword}」→「${reply}」`;
     },
 });

package/commands/keyword-add/[keyword]/index.ts

@@ -1,16 +1,19 @@
 import { defineCommand } from 'zhin.js/command';
-import { addKeyword } from '../../../src/keyword-store.js';
+import type { Message } from '@zhin.js/core/runtime';
 import type { GroupSuiteConfig } from '../../../src/config.js';
-import { resolveGroupSuiteRuntime } from '../../../src/runtime-state.js';
+import { keywordsForCommand } from '../../../src/keywords.js';
 
-export default defineCommand<GroupSuiteConfig>({
-  description: '添加关键词自动回复',
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  permit: ['group()', 'role(owner,admin,master,trusted)'],
+  description: '添加当前群关键词自动回复',
   params: { keyword: { type: 'string' } },
-  execute({ params, args, owner, use }) {
-    const keyword = String(params.keyword ?? '');
-    const reply = args.join(' ').trim();
+  async execute(context) {
+    const keyword = String(context.params.keyword ?? '');
+    const reply = context.args.join(' ').trim();
     if (!keyword || !reply) return '请提供关键词和回复内容';
-    addKeyword(keyword, reply, resolveGroupSuiteRuntime({ owner, use }).keywords);
+    const repository = keywordsForCommand(context.input, context);
+    if (typeof repository === 'string') return repository;
+    await repository.update(store => { store.set(keyword, reply); });
     return `已添加关键词「${keyword}」→「${reply}」`;
   },
 });

package/commands/keyword-list/index.js

@@ -1,11 +1,14 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineCommand } from 'zhin.js/command';
-import { listKeywords } from "../../lib/keyword-store.js";
-import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
+import { keywordsForCommand } from "../../lib/keywords.js";
 export default defineCommand({
-    description: '查看所有关键词回复对',
-    execute({ owner, use }) {
-        const entries = listKeywords(resolveGroupSuiteRuntime({ owner, use }).keywords);
+    permit: ['group()'],
+    description: '查看当前群关键词回复对',
+    async execute(context) {
+        const repository = keywordsForCommand(context.input, context);
+        if (typeof repository === 'string')
+            return repository;
+        const entries = await repository.read();
         if (entries.length === 0)
             return '当前没有设置任何关键词';
         const lines = entries.map(([k, v], i) => `${i + 1}. 「${k}」→「${v}」`);

package/commands/keyword-list/index.ts

@@ -1,12 +1,15 @@
 import { defineCommand } from 'zhin.js/command';
-import { listKeywords } from '../../src/keyword-store.js';
+import type { Message } from '@zhin.js/core/runtime';
 import type { GroupSuiteConfig } from '../../src/config.js';
-import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
+import { keywordsForCommand } from '../../src/keywords.js';
 
-export default defineCommand<GroupSuiteConfig>({
-  description: '查看所有关键词回复对',
-  execute({ owner, use }) {
-    const entries = listKeywords(resolveGroupSuiteRuntime({ owner, use }).keywords);
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  permit: ['group()'],
+  description: '查看当前群关键词回复对',
+  async execute(context) {
+    const repository = keywordsForCommand(context.input, context);
+    if (typeof repository === 'string') return repository;
+    const entries = await repository.read();
     if (entries.length === 0) return '当前没有设置任何关键词';
     const lines = entries.map(([k, v], i) => `${i + 1}. 「${k}」→「${v}」`);
     return `关键词列表（共 ${entries.length} 条）：\n${lines.join('\n')}`;

package/commands/keyword-remove/[keyword]/index.js

@@ -1,16 +1,20 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineCommand } from 'zhin.js/command';
-import { removeKeyword } from "../../../lib/keyword-store.js";
-import { resolveGroupSuiteRuntime } from "../../../lib/runtime-state.js";
+import { keywordsForCommand } from "../../../lib/keywords.js";
 export default defineCommand({
-    description: '删除关键词自动回复',
+    permit: ['group()', 'role(owner,admin,master,trusted)'],
+    description: '删除当前群关键词自动回复',
     params: { keyword: { type: 'string' } },
-    execute({ params, owner, use }) {
-        const keyword = String(params.keyword ?? '');
+    async execute(context) {
+        const keyword = String(context.params.keyword ?? '');
         if (!keyword)
             return '请提供要删除的关键词';
-        if (!removeKeyword(keyword, resolveGroupSuiteRuntime({ owner, use }).keywords))
+        const repository = keywordsForCommand(context.input, context);
+        if (typeof repository === 'string')
+            return repository;
+        if (!(await repository.read()).some(([entry]) => entry === keyword))
             return `关键词「${keyword}」不存在`;
+        await repository.update(store => { store.delete(keyword); });
         return `已删除关键词「${keyword}」`;
     },
 });

package/commands/keyword-remove/[keyword]/index.ts

@@ -1,15 +1,19 @@
 import { defineCommand } from 'zhin.js/command';
-import { removeKeyword } from '../../../src/keyword-store.js';
+import type { Message } from '@zhin.js/core/runtime';
 import type { GroupSuiteConfig } from '../../../src/config.js';
-import { resolveGroupSuiteRuntime } from '../../../src/runtime-state.js';
+import { keywordsForCommand } from '../../../src/keywords.js';
 
-export default defineCommand<GroupSuiteConfig>({
-  description: '删除关键词自动回复',
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  permit: ['group()', 'role(owner,admin,master,trusted)'],
+  description: '删除当前群关键词自动回复',
   params: { keyword: { type: 'string' } },
-  execute({ params, owner, use }) {
-    const keyword = String(params.keyword ?? '');
+  async execute(context) {
+    const keyword = String(context.params.keyword ?? '');
     if (!keyword) return '请提供要删除的关键词';
-    if (!removeKeyword(keyword, resolveGroupSuiteRuntime({ owner, use }).keywords)) return `关键词「${keyword}」不存在`;
+    const repository = keywordsForCommand(context.input, context);
+    if (typeof repository === 'string') return repository;
+    if (!(await repository.read()).some(([entry]) => entry === keyword)) return `关键词「${keyword}」不存在`;
+    await repository.update(store => { store.delete(keyword); });
     return `已删除关键词「${keyword}」`;
   },
 });

package/commands/stats-card/index.js

@@ -0,0 +1,23 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineCommand } from 'zhin.js/command';
+import { segment } from 'zhin.js';
+import { resolveGroupSuiteConfig } from "../../lib/config.js";
+import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
+import { flushStatsBuffer, queryStats, resolveGroupId } from "../../lib/stats-lib.js";
+import { buildStatsRankReportData } from "../../lib/stats-data.js";
+import { buildStatsRankHtml, STATS_REPORT_CANVAS } from "../../lib/stats-card.js";
+import { todayStr, resolveSender } from "../../lib/shared-runtime.js";
+export default defineCommand({
+    description: '查看今日群消息统计卡片（不支持图片时显示文本）',
+    permit: ['group()'],
+    async execute(context) {
+        if (!context.input)
+            throw new Error('Group statistics require an incoming message');
+        const runtime = resolveGroupSuiteRuntime(context);
+        await flushStatsBuffer(runtime);
+        const stats = await queryStats(resolveGroupId(context.input), todayStr(), runtime);
+        const data = buildStatsRankReportData(stats, '今日本群消息统计', resolveGroupSuiteConfig(context.config).rankSize, resolveSender(context.input).id);
+        return segment.html({ html: await buildStatsRankHtml(data), width: 540,
+            backgroundColor: STATS_REPORT_CANVAS, fileName: 'group-stats.png' });
+    },
+});

package/commands/stats-card/index.ts

@@ -0,0 +1,24 @@
+import { defineCommand } from 'zhin.js/command';
+import { segment } from 'zhin.js';
+import type { Message, SendContent } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../../src/config.js';
+import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
+import { flushStatsBuffer, queryStats, resolveGroupId } from '../../src/stats-lib.js';
+import { buildStatsRankReportData } from '../../src/stats-data.js';
+import { buildStatsRankHtml, STATS_REPORT_CANVAS } from '../../src/stats-card.js';
+import { todayStr, resolveSender } from '../../src/shared-runtime.js';
+
+export default defineCommand<GroupSuiteConfig, SendContent, Message>({
+  description: '查看今日群消息统计卡片（不支持图片时显示文本）',
+  permit: ['group()'],
+  async execute(context) {
+    if (!context.input) throw new Error('Group statistics require an incoming message');
+    const runtime = resolveGroupSuiteRuntime(context);
+    await flushStatsBuffer(runtime);
+    const stats = await queryStats(resolveGroupId(context.input), todayStr(), runtime);
+    const data = buildStatsRankReportData(stats, '今日本群消息统计',
+      resolveGroupSuiteConfig(context.config).rankSize, resolveSender(context.input).id);
+    return segment.html({ html: await buildStatsRankHtml(data), width: 540,
+      backgroundColor: STATS_REPORT_CANVAS, fileName: 'group-stats.png' });
+  },
+});

package/commands/teach/index.js

@@ -4,6 +4,7 @@ import { resolveGroupSuiteConfig } from "../../lib/config.js";
 import { teachAdd } from "../../lib/teach-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
+    permit: ['group()', 'role(owner,admin,master,trusted)'],
     description: '教我问答（teach 问题 回答 或 问题|答案）',
     execute({ config, input, args, owner, use }) {
         return teachAdd(input ?? {}, resolveGroupSuiteConfig(config), args.join(' '), false, resolveGroupSuiteRuntime({ owner, use }));

package/commands/teach/index.ts

@@ -5,6 +5,7 @@ import { teachAdd } from '../../src/teach-lib.js';
 import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
+  permit: ['group()', 'role(owner,admin,master,trusted)'],
   description: '教我问答（teach 问题 回答 或 问题|答案）',
   execute({ config, input, args, owner, use }) {
     return teachAdd(input ?? {}, resolveGroupSuiteConfig(config), args.join(' '), false, resolveGroupSuiteRuntime({ owner, use }));

package/commands/teach-regex/index.js

@@ -4,6 +4,7 @@ import { resolveGroupSuiteConfig } from "../../lib/config.js";
 import { teachAdd } from "../../lib/teach-lib.js";
 import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
 export default defineCommand({
+    permit: ['group()', 'role(owner,admin,master,trusted)'],
     description: '教我正则问答',
     execute({ config, input, args, owner, use }) {
         return teachAdd(input ?? {}, resolveGroupSuiteConfig(config), args.join(' '), true, resolveGroupSuiteRuntime({ owner, use }));

package/commands/teach-regex/index.ts

@@ -5,6 +5,7 @@ import { teachAdd } from '../../src/teach-lib.js';
 import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
 
 export default defineCommand<GroupSuiteConfig, string, Message>({
+  permit: ['group()', 'role(owner,admin,master,trusted)'],
   description: '教我正则问答',
   execute({ config, input, args, owner, use }) {
     return teachAdd(input ?? {}, resolveGroupSuiteConfig(config), args.join(' '), true, resolveGroupSuiteRuntime({ owner, use }));

package/handlers/welcome/index.js

@@ -0,0 +1,25 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineHandler } from 'zhin.js/handler';
+import { outboundMessageToken } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig } from "../../lib/config.js";
+/** Canonical notice input only; no SDK-specific callbacks or direct platform sends. */
+export default defineHandler({
+    event: 'notice.receive',
+    async handle({ payload: notice }) {
+        const text = resolveGroupSuiteConfig(this.config).welcomeMessage;
+        if (!text || notice.name !== 'notice.group.member_increase'
+            || notice.conversation?.kind !== 'group' || !notice.target?.id)
+            return;
+        const content = text.replaceAll('{name}', notice.target.name ?? notice.target.id)
+            .replaceAll('{id}', notice.target.id);
+        const result = await this.use(outboundMessageToken).send({
+            requester: this.owner,
+            conversation: notice.conversation,
+            content: { type: 'text', data: { text: content } },
+        });
+        if (result.status !== 'sent') {
+            // Unknown delivery must remain visible, and must never trigger an automatic duplicate send.
+            throw new Error(`Group welcome delivery ${result.status}`);
+        }
+    },
+});

package/handlers/welcome/index.ts

@@ -0,0 +1,24 @@
+import { defineHandler } from 'zhin.js/handler';
+import { outboundMessageToken } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../../src/config.js';
+
+/** Canonical notice input only; no SDK-specific callbacks or direct platform sends. */
+export default defineHandler({
+  event: 'notice.receive',
+  async handle({ payload: notice }) {
+    const text = resolveGroupSuiteConfig(this.config as Partial<GroupSuiteConfig>).welcomeMessage;
+    if (!text || notice.name !== 'notice.group.member_increase'
+      || notice.conversation?.kind !== 'group' || !notice.target?.id) return;
+    const content = text.replaceAll('{name}', notice.target.name ?? notice.target.id)
+      .replaceAll('{id}', notice.target.id);
+    const result = await this.use(outboundMessageToken).send({
+      requester: this.owner,
+      conversation: notice.conversation,
+      content: { type: 'text', data: { text: content } },
+    });
+    if (result.status !== 'sent') {
+      // Unknown delivery must remain visible, and must never trigger an automatic duplicate send.
+      throw new Error(`Group welcome delivery ${result.status}`);
+    }
+  },
+});

package/lib/checkin-lib.d.ts

@@ -1,27 +1,7 @@
+import type { ConversationInput } from './conversation-scope.js';
 import type { GroupSuiteConfig } from './config.js';
 import type { GroupSuiteRuntime } from './runtime-state.js';
-export declare function doCheckin(input: {
-    sender?: {
-        readonly id: string;
-        readonly name?: string;
-    };
-    target?: string;
-    metadata?: Readonly<Record<string, unknown>>;
-}, cfg: GroupSuiteConfig, runtime: GroupSuiteRuntime): Promise<string>;
-export declare function myPoints(input: {
-    sender?: {
-        readonly id: string;
-        readonly name?: string;
-    };
-    target?: string;
-    metadata?: Readonly<Record<string, unknown>>;
-}, runtime: GroupSuiteRuntime): Promise<string>;
-export declare function pointsRank(input: {
-    sender?: {
-        readonly id: string;
-        readonly name?: string;
-    };
-    target?: string;
-    metadata?: Readonly<Record<string, unknown>>;
-}, cfg: GroupSuiteConfig, runtime: GroupSuiteRuntime): Promise<string>;
+export declare function doCheckin(input: ConversationInput, cfg: GroupSuiteConfig, runtime: GroupSuiteRuntime): Promise<string>;
+export declare function myPoints(input: ConversationInput, runtime: GroupSuiteRuntime): Promise<string>;
+export declare function pointsRank(input: ConversationInput, cfg: GroupSuiteConfig, runtime: GroupSuiteRuntime): Promise<string>;
 //# sourceMappingURL=checkin-lib.d.ts.map

package/lib/checkin-lib.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkin-lib.d.ts","sourceRoot":"","sources":["../src/checkin-lib.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAUpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAuD5D,wBAAsB,SAAS,CAC7B,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,EAClI,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CA2CjB;AAED,wBAAsB,QAAQ,CAC5B,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,EAClI,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAED,wBAAsB,UAAU,CAC9B,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,EAClI,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAsBjB"}
+{"version":3,"file":"checkin-lib.d.ts","sourceRoot":"","sources":["../src/checkin-lib.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAUpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAuD5D,wBAAsB,SAAS,CAC7B,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CA2CjB;AAED,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAED,wBAAsB,UAAU,CAC9B,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAqBjB"}

package/lib/checkin-lib.js

@@ -112,9 +112,7 @@ export async function pointsRank(input, cfg, runtime) {
     if (!M)
         return '签到数据库尚未就绪';
     const { type: ctxType, id: ctxId } = resolveContextKey(input);
-    const all = (await M.select().where(ctxType === 'global'
-        ? { context_type: 'global' }
-        : { context_type: ctxType, context_id: ctxId }));
+    const all = (await M.select().where({ context_type: ctxType, context_id: ctxId }));
     if (all.length === 0)
         return '还没有人签到过哦～';
     const sorted = all.sort((a, b) => Number(b.points || 0) - Number(a.points || 0));
@@ -124,7 +122,8 @@ export async function pointsRank(input, cfg, runtime) {
         const prefix = i < 3 ? medals[i] : `${i + 1}.`;
         return `${prefix} ${u.user_name || u.user_id} — ${u.points}分 (${u.total_checkins}天)`;
     });
-    const title = ctxType === 'group' ? '本群积分排行' : '全局积分排行';
+    const title = ctxType === 'group' ? '本群积分排行'
+        : ctxType === 'channel' ? '本频道积分排行' : '当前私聊积分排行';
     const { id: userId } = resolveSender(input);
     const myRank = sorted.findIndex((u) => u.user_id === userId);
     const footer = myRank >= 0 ? `\n你的排名: 第${myRank + 1}名` : '';

package/lib/checkin-lib.js.map

@@ -1 +1 @@
-{"version":3,"file":"checkin-lib.js","sourceRoot":"","sources":["../src/checkin-lib.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"checkin-lib.js","sourceRoot":"","sources":["../src/checkin-lib.ts"],"names":[],"mappings":"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"}

package/lib/config.d.ts

@@ -1,5 +1,9 @@
 export interface GroupSuiteConfig {
     keywordReply: boolean;
+    /** Explicitly volatile keywords for demos without a persistent Database Host. */
+    ephemeralKeywords: boolean;
+    /** Empty disables group member welcomes. {name} and {id} are literal placeholders. */
+    welcomeMessage: string;
     basePointsMin: number;
     basePointsMax: number;
     streakBonus: number;

package/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,0BAA0B,EAAE,gBAWxC,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,SAAS,GACzC,gBAAgB,CAKlB"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,iFAAiF;IACjF,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sFAAsF;IACtF,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,0BAA0B,EAAE,gBAaxC,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,SAAS,GACzC,gBAAgB,CAKlB"}

package/lib/config.js

@@ -1,5 +1,7 @@
 export const DEFAULT_GROUP_SUITE_CONFIG = {
     keywordReply: false,
+    ephemeralKeywords: false,
+    welcomeMessage: '',
     basePointsMin: 10,
     basePointsMax: 30,
     streakBonus: 5,

package/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,0BAA0B,GAAqB;IAC1D,YAAY,EAAE,KAAK;IACnB,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,EAAE;IACb,QAAQ,EAAE,EAAE;IACZ,gBAAgB,EAAE,GAAG;IACrB,eAAe,EAAE,IAAI;IACrB,eAAe,EAAE,IAAI;IACrB,aAAa,EAAE,EAAE;CAClB,CAAC;AAEF,MAAM,UAAU,uBAAuB,CACrC,GAA0C;IAE1C,OAAO;QACL,GAAG,0BAA0B;QAC7B,GAAG,GAAG;KACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,MAAM,0BAA0B,GAAqB;IAC1D,YAAY,EAAE,KAAK;IACnB,iBAAiB,EAAE,KAAK;IACxB,cAAc,EAAE,EAAE;IAClB,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,EAAE;IACb,QAAQ,EAAE,EAAE;IACZ,gBAAgB,EAAE,GAAG;IACrB,eAAe,EAAE,IAAI;IACrB,eAAe,EAAE,IAAI;IACrB,aAAa,EAAE,EAAE;CAClB,CAAC;AAEF,MAAM,UAAU,uBAAuB,CACrC,GAA0C;IAE1C,OAAO;QACL,GAAG,0BAA0B;QAC7B,GAAG,GAAG;KACP,CAAC;AACJ,CAAC"}

package/lib/conversation-scope.d.ts

@@ -0,0 +1,21 @@
+import { type DeliveryTarget } from 'zhin.js';
+import { adapterFeatureId } from 'zhin.js/adapter';
+import type { ToolInvocationOrigin } from '@zhin.js/tool';
+export interface ConversationInput {
+    readonly conversation?: DeliveryTarget;
+    readonly sender?: Readonly<{
+        id: string;
+        name?: string;
+    }>;
+    readonly content?: unknown;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/** Versioned, unambiguous identity; historical bare group ids are deliberately not read. */
+export declare function conversationKey(target: DeliveryTarget): string;
+export declare function requireConversation(input: ConversationInput): DeliveryTarget;
+/** Tool origins contain an endpoint selector, not a canonical endpoint capability id. */
+export declare function toolGroupConversation(context: {
+    readonly origin: ToolInvocationOrigin;
+    project<T>(feature: typeof adapterFeatureId): T;
+}, groupId?: string): DeliveryTarget;
+//# sourceMappingURL=conversation-scope.d.ts.map

package/lib/conversation-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-scope.d.ts","sourceRoot":"","sources":["../src/conversation-scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAqB,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,cAAc,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAK9D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,cAAc,CAG5E;AAED,yFAAyF;AACzF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,gBAAgB,GAAG,CAAC,CAAC;CACjD,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,CAgBnC"}

package/lib/conversation-scope.js

@@ -0,0 +1,33 @@
+import { createDeliveryTarget } from 'zhin.js';
+import { adapterFeatureId } from 'zhin.js/adapter';
+/** Versioned, unambiguous identity; historical bare group ids are deliberately not read. */
+export function conversationKey(target) {
+    const canonical = createDeliveryTarget({ conversation: target });
+    return JSON.stringify(['conversation-v1', canonical.endpoint.adapter, canonical.endpoint.id,
+        canonical.kind, canonical.id, canonical.parent?.kind ?? null, canonical.parent?.id ?? null,
+        canonical.threadId ?? null]);
+}
+export function requireConversation(input) {
+    if (!input.conversation)
+        throw new Error('Group Suite requires a canonical conversation');
+    return createDeliveryTarget({ conversation: input.conversation });
+}
+/** Tool origins contain an endpoint selector, not a canonical endpoint capability id. */
+export function toolGroupConversation(context, groupId) {
+    if (context.origin.kind !== 'im' || context.origin.scope !== 'group') {
+        throw new Error('Group Suite query tools require a group IM origin');
+    }
+    const origin = context.origin;
+    const index = context.project(adapterFeatureId);
+    const matches = index.describe().filter(endpoint => (String(endpoint.id) === origin.endpoint || endpoint.name === origin.endpoint)
+        && index.clientAdapter(endpoint.id) === origin.platform);
+    if (matches.length !== 1)
+        throw new Error('Group Suite tool endpoint is missing or ambiguous');
+    return createDeliveryTarget({ conversation: {
+            endpoint: { id: String(matches[0].id), adapter: origin.platform },
+            kind: 'group', id: groupId ?? origin.sceneId,
+            ...(origin.threadId !== undefined && (groupId === undefined || groupId === origin.sceneId)
+                ? { threadId: origin.threadId } : {}),
+        } });
+}
+//# sourceMappingURL=conversation-scope.js.map