koishi-plugin-chatluna-affinity 0.1.2 → 0.1.3

package/lib/index.d.ts

@@ -69,7 +69,7 @@ export interface Config {
     variableName: string;
     items: string[];
   };
-  groupList: {
+  groupInfo: {
     enabled: boolean;
     variableName: string;
     includeMemberCount: boolean;

package/lib/index.js

@@ -516,7 +516,7 @@ function apply(ctx, config) {
     return lines.join('\n');
   };
 
-  const createGroupListProvider = (config) => async (_, __, configurable) => {
+  const createGroupInfoProvider = (config) => async (_, __, configurable) => {
     const session = configurable?.session;
     if (!session) return '暂无群信息。';
     if (!session.guildId) return '';
@@ -582,6 +582,18 @@ function apply(ctx, config) {
     }).flat();
   };
 
+  const resolveRandomDefaults = (randomConfig = {}) => {
+    const candidateMin = Number(randomConfig.min);
+    const candidateMax = Number(randomConfig.max);
+    const hasMin = Number.isFinite(candidateMin);
+    const hasMax = Number.isFinite(candidateMax);
+    const fallbackMin = hasMin ? candidateMin : hasMax ? candidateMax : 0;
+    const fallbackMax = hasMax ? candidateMax : hasMin ? candidateMin : 100;
+    const lower = Math.min(fallbackMin, fallbackMax);
+    const upper = Math.max(fallbackMin, fallbackMax);
+    return { min: lower, max: upper };
+  };
+
   const stripAtPrefix = (value) => {
     const text = String(value ?? '').trim();
     if (!text) return '';
@@ -775,9 +787,16 @@ function apply(ctx, config) {
     return { userId: fallback, nickname: fallback };
   };
 
-  const createRandomProvider = () => async (args) => {
+  const createRandomProvider = (randomConfig) => async (args) => {
     const values = parseRandomArguments(args ?? []);
-    if (!values.length) return '';
+    if (!values.length) {
+      const defaults = resolveRandomDefaults(randomConfig);
+      if (!Number.isFinite(defaults.min) || !Number.isFinite(defaults.max)) return '';
+      if (defaults.min === defaults.max) return String(Math.round(defaults.min));
+      const span = defaults.max - defaults.min;
+      const result = defaults.min + Math.round(Math.random() * span);
+      return String(result);
+    }
 
     if (values.length === 2 && typeof values[0] === 'number' && typeof values[1] === 'number') {
       const min = Math.min(values[0], values[1]);
@@ -901,15 +920,15 @@ function apply(ctx, config) {
     if (randomConfig.enabled !== false) {
       const variableName = String(randomConfig.variableName || 'random').trim();
       if (variableName) {
-        ctx.chatluna.promptRenderer.registerFunctionProvider(variableName, createRandomProvider());
+        ctx.chatluna.promptRenderer.registerFunctionProvider(variableName, createRandomProvider(randomConfig));
       }
     }
 
-    const groupListConfig = config.groupList || config.otherVariables?.groupList || {};
-    if (groupListConfig.enabled) {
-      const variableName = String(groupListConfig.variableName || 'groupList').trim();
+    const groupInfoConfig = config.groupInfo || config.otherVariables?.groupInfo || {};
+    if (groupInfoConfig.enabled) {
+      const variableName = String(groupInfoConfig.variableName || 'groupInfo').trim();
       if (variableName) {
-        ctx.chatluna.promptRenderer.registerFunctionProvider(variableName, createGroupListProvider(groupListConfig));
+        ctx.chatluna.promptRenderer.registerFunctionProvider(variableName, createGroupInfoProvider(groupInfoConfig));
       }
     }
 
@@ -1380,6 +1399,20 @@ function apply(ctx, config) {
       if (removed) return `已解除 ${platform}/${normalizedUserId} 的自动黑名单。`;
       return `${platform}/${normalizedUserId} 不在自动黑名单中。`;
     });
+
+  ctx.command('affinity.groupList', '显示机器人已加入的群聊', { authority: 2 })
+    .alias('群聊列表')
+    .action(async ({ session }) => {
+      if (!session) return '无法获取会话信息。';
+      if (session.platform !== 'onebot') return '该指令仅支持 OneBot/NapCat 平台。';
+      const list = await fetchGroupList(session);
+      if (!list || !list.length) return '暂无群聊数据。';
+      const groupInfoConfig = config.groupInfo || config.otherVariables?.groupInfo || {};
+      return normalizeGroupList(list, {
+        includeMemberCount: groupInfoConfig.includeMemberCount !== false,
+        includeCreateTime: groupInfoConfig.includeCreateTime !== false
+      });
+    });
 }
 
 module.exports = { apply, Config, inject, name };

package/lib/schema.js

@@ -7,10 +7,11 @@ const inject = {
   optional: ['puppeteer']
 };
 
-const createVariableEntry = (defaultName, description) =>
+const createVariableEntry = (defaultName, description, extra = {}) =>
   Schema.object({
     enabled: Schema.boolean().default(true).description('是否启用该变量'),
-    variableName: Schema.string().default(defaultName).description('变量名称')
+    variableName: Schema.string().default(defaultName).description('变量名称'),
+    ...extra
   })
     .description(description)
     .collapse();
@@ -208,21 +209,24 @@ const OtherVariablesSchema = Schema.object({
   })
     .description('机器人信息变量')
     .collapse(),
-  groupList: Schema.object({
-    enabled: Schema.boolean().default(false).description('是否启用群列表变量'),
-    variableName: Schema.string().default('groupList').description('变量名称'),
+  groupInfo: Schema.object({
+    enabled: Schema.boolean().default(false).description('是否启用群信息变量'),
+    variableName: Schema.string().default('groupInfo').description('变量名称'),
     includeMemberCount: Schema.boolean().default(true).description('是否包含成员数量'),
     includeCreateTime: Schema.boolean().default(true).description('是否包含创建时间')
   })
-    .description('群列表变量')
+    .description('群信息变量')
     .collapse(),
-  random: createVariableEntry('random', '随机数变量')
+  random: createVariableEntry('random', '随机数变量', {
+    min: Schema.number().default(0).description('默认随机数下限'),
+    max: Schema.number().default(100).description('默认随机数上限')
+  })
 })
   .default({
     userInfo: { enabled: true, variableName: 'userInfo', items: [...defaultMemberInfoItems] },
     botInfo: { enabled: true, variableName: 'botInfo', items: [...defaultMemberInfoItems] },
-    groupList: { enabled: false, variableName: 'groupList', includeMemberCount: true, includeCreateTime: true },
-    random: { enabled: true, variableName: 'random' }
+    groupInfo: { enabled: false, variableName: 'groupInfo', includeMemberCount: true, includeCreateTime: true },
+    random: { enabled: true, variableName: 'random', min: 0, max: 100 }
   })
   .description('其他变量');
 
@@ -254,7 +258,7 @@ const OneBotToolsSchema = Schema.object({
   enablePokeTool: Schema.boolean().default(false).description('注册 ChatLuna 工具：戳一戳'),
   pokeToolName: Schema.string().default('poke_user').description('ChatLuna 工具名称：戳一戳'),
   enableSetSelfProfileTool: Schema.boolean().default(false).description('注册 ChatLuna 工具：修改自身账户信息'),
-  setSelfProfileToolName: Schema.string().default('set_self_profile').description('ChatLuna 工具名称：修改自身账户信息'),
+  setSelfProfileToolName: Schema.string().default('set_self_profile').description('ChatLuna 工具名称：修改自身账户信息（支持昵称/签名/性别）'),
   enableDeleteMessageTool: Schema.boolean().default(false).description('注册 ChatLuna 工具：撤回消息'),
   deleteMessageToolName: Schema.string().default('delete_msg').description('ChatLuna 工具名称：撤回消息')
 }).description('其他工具');

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-chatluna-affinity",
   "description": "为 ChatLuna Character 提供 {好感度}、{关系}、{日程} 等变量并提供对应的工具调用和低好感自动拉黑功能。",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [

package/readme.md

@@ -1,123 +0,0 @@
-# koishi-plugin-chatluna-affinity
-
-在 ChatLuna 中按用户维度维护“好感度”与“关系”状态，并提供可操作的工具与变量。
-
-## 亮点一览
-
-- `affinity()` 变量：随时取得用户与机器人的好感度。初次使用会自动初始化并写入数据库。
-- `relationship()` 变量：返回友好度对应的称谓，支持自定义关系区间与备注。
-- 初始好感度：可在自定义范围内随机生成，避免所有用户同值起步。
-- 安全守卫：当好感度低于自定义阈值时，记录到插件黑名单并全局拦截后续消息。
-- 双层好感度：短期情绪值负责即时反馈，长期关系值维护整体基调，互相制衡并支持半衰期、趋势动量调节。
-- 控制台名单：自动拉黑后会同步到配置表，方便复核与手动维护。
-- 自动分析：收到私聊、@、引用或命中 bot 昵称时，调用指定模型分析对话并调整好感度。
-- 调整工具：
-  - `adjust_affinity` 将好感度设为指定数值，并同步关系区间。
-  - `adjust_relationship` 将关系切换为自定义称谓，同时把好感度调至对应区间的下限。
-  - `adjust_blacklist` 管理自动拉黑名单，可快速拉黑或解除指定用户。
-- 特殊关系：可为指定用户记录“初始好感度 + 自定义称谓”，工具操作会实时写回配置。
-- 短期拉黑：短期好感跌破阈值时，可自动临时屏蔽用户若干小时并附带一次性好感惩罚。
-
-## 双层好感度概览
-
-- **短期好感（ShortTerm）**：代表最近互动的情绪波动。支持指数衰减（半衰期）、最小/最大回归幅度，确保情绪会逐步回归中性。
-- **长期好感（LongTerm）**：描述关系的稳定基调。可在短期持续高涨/低迷时触发上调或下调，并对短期波动进行缓冲。
-- **趋势动量（Momentum）**：记录近期增减的平均趋势，在满足阈值时会放大或抑制长期调节。
-- 通过 `decayConfig` / `crossInfluenceConfig` / `momentumConfig` 三组配置，即可调节半衰期、阈值、窗口长度、步长、回拉比例等关键参数，快速适配不同角色与人设节奏。
-
-## 主要配置
-
-| 字段 | 说明 |
-| --- | --- |
-| `variableName` | 好感度变量名称，默认 `affinity` |
-| `min` / `max` | 好感度最小值 / 最大值 |
-| `initialRandomMin` / `initialRandomMax` | 初始好感度随机区间（含边界，默认 20~40，取整数） |
-| `maxIncreasePerMessage` | 单次允许增加的最大幅度（提示词变量 `{{maxIncreasePerMessage}}`） |
-| `maxDecreasePerMessage` | 单次允许减少的最大幅度（提示词变量 `{{maxDecreasePerMessage}}`） |
-| `decayConfig` | 短期衰减设置：`halfLifeMinutes` 半衰期（分钟）、`minReturnPerUpdate` / `maxReturnPerUpdate` 单次回归幅度 |
-| `crossInfluenceConfig` | 短期→长期联动：`promoteThreshold` / `demoteThreshold` 阈值、`evaluationWindow` 连续消息数、`longTermStep` 步长、`shortTermPullback` 回拉比例 |
-| `momentumConfig` | 趋势动量：`windowSize` 滑动窗口、`smoothing` 平滑系数、`maxInfluence` 对长期调节的最大附加值 |
-| `model` | 用于分析的 ChatLuna 模型 |
-| `analysisPrompt` | 主提示词模板，支持 `{{currentAffinity}}` 等占位符 |
-| `personaSource` | 可选人设预设来源（`none` / `chatluna` / `custom`） |
-| `personaChatlunaPreset` | 当来源为 `chatluna` 时注入的预设名称 |
-| `personaCustomPreset` | 当来源为 `custom` 时注入的自定义文本 |
-| `triggerNicknames` | 触发分析的 bot 昵称列表（默认含 ChatLuna 配置的昵称/@ 名） |
-| `useLastAffinity` | 开启后变量能立即返回上一次结果（无需等待分析完成） |
-| `historyMessageCount` | 提供给模型的历史消息条数（从数据库或 group-analysis 插件取得） |
-| `enableAutoBlacklist` | 启用后，好感度低于阈值会写入黑名单并阻断消息 |
-| `blacklistThreshold` | 自动拉黑触发值（小于该值即触发） |
-| `blacklistLogInterception` | 拦截消息时是否输出日志 |
-| `shortTermBlacklist` | 短期拉黑设置：`enabled` 开关；`threshold` 触发阈值；`durationHours` 持续时长；`penalty` 触发时额外扣减的好感 |
-| `autoBlacklist` | 自动拉黑记录列表（自动维护，可在控制台查看与编辑） |
-| `relationships` | 特殊关系配置：`userId`、`initialAffinity`、`relation`、`note` |
-| `relationshipAffinityLevels` | 区间 → 称谓映射，默认提供“陌生人/友好/亲近/挚友” |
-| `registerAffinityTool` / `registerRelationshipTool` / `registerBlacklistTool` | 是否注册对应 ChatLuna 工具 |
-| `enablePokeTool` / `pokeToolName` | 注册 OneBot “戳一戳” 工具（默认 `poke_user`，需要 OneBot/NapCat 支持） |
-| `enableSetSelfProfileTool` / `setSelfProfileToolName` | 注册 OneBot “修改自身账户信息” 工具（默认 `set_self_profile`，需要 OneBot/NapCat 支持） |
-| `rankDefaultLimit` | 指令默认展示的排行榜人数 |
-| `rankRenderAsImage` | 指令默认是否渲染排行榜为图片（图片模式需 `koishi-plugin-puppeteer`） |
-| `blacklistDefaultLimit` | `affinity.blacklist` 默认展示的黑名单条目数 |
-| `blacklistRenderAsImage` | 黑名单指令默认是否渲染为图片 |
-| `random` | 其他变量配置（启用开关 + 变量名称） |
-| `debugLogging` | 输出调试日志，便于观察模型解析与好感度计算细节 |
-
-## 其他变量
-
-- `random`：随机选项或范围变量，支持列表、区间（`1-10`）或混合写法
-- 可配置 `enabled` 与 `variableName`
-
-## 指令
-
-- `affinity.rank [limit] [platform] [image|text]`：查看好感度排行，可指定人数、平台，并选择文本或图片输出（图片模式需 `koishi-plugin-puppeteer`）。
-- `affinity.inspect [userId] [platform]`：查看指定用户的长期/短期好感、动量与衰减详情，方便调参与排查。
-- `affinity.blacklist [limit] [platform] [image|text]`：查看自动拉黑列表，支持筛选平台与图片输出。
-- `affinity.block <userId> [platform] [-n <note>]`：手动将用户加入自动黑名单，可附带备注。
-- `affinity.unblock <userId> [platform]`：解除自动黑名单。
-
-## 工具调用
-
-启用 `registerAffinityTool` 或 `registerRelationshipTool` 后，ChatLuna 代理可直接调用。
-
-- `enablePokeTool`：在 OneBot 平台注册 `poke_user` 工具，可在群聊或私聊中执行戳一戳。
-- `enableSetSelfProfileTool`：在 OneBot 平台注册 `set_self_profile` 工具，可修改机器人昵称/签名/性别（谨慎启用）。
-
-若 `relation` 不在区间表中，会按全局初始值创建一条“自定义关系”条目，后续可在面板中继续编辑。
-
-## 数据存储
-
-插件会在数据库里创建表 `chatluna_affinity_records`，字段包含：
-
-- `platform` / `userId` / `selfId`
-- `affinityInited`（是否完成初始化）
-- `affinity`（综合值）、`shortTermAffinity`、`longTermAffinity`
-- `momentum`
-- `updatedAt`、`shortTermUpdatedAt`、`longTermUpdatedAt`、`momentumUpdatedAt`
-- `relation`、`relationUpdatedAt`
-- `nickname`
-
-旧版本仅存储单一好感度的记录会在首次读取时自动拆分为 9:1 的长期 / 短期结构，无需额外迁移脚本。
-
-## 调试
-
-开启 `debugLogging` 后，控制台会输出：
-
-- 触发判定：昵称集合、@ 命中、引用命中
-- 模型返回的 `delta`、缓冲后 `bufferedDelta` 与衰减信息
-- 好感度更新时会额外输出短期/长期值、动量、阈值触发情况
-- 配合 `affinity.inspect` 指令，可快速对照数据库与实时衰减后的状态
-
-方便快速定位触发条件和模型配置问题。
-
-## 常见问题
-
-1. **没有触发分析？**
-   - 确认 `enableAnalysis` 为 `true`，且消息满足私聊 / @ / 引用 / 昵称命中任一条件。
-2. **工具调用失败？**
-   - 确认配置里开启了对应工具开关；日志会提示是否缺失用户 ID 或关系名称。
-3. **如何清理数据？**
-   - 直接删除数据库中 `chatluna_affinity_records` 数据，或指定用户重新初始化即可。
-
-## 许可协议
-
-MIT License © 2024 chatluna-affinity contributors