koishi-plugin-dify-ai 0.1.15 → 0.1.16
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/lib/config.d.ts +3 -0
- package/lib/index.d.ts +1 -1
- package/lib/index.js +64 -3
- package/lib/locales/en-US.d.ts +1 -0
- package/lib/locales/zh-CN.d.ts +1 -0
- package/lib/trigger/engine.d.ts +4 -0
- package/lib/types.d.ts +10 -3
- package/package.json +1 -1
package/lib/config.d.ts
CHANGED
package/lib/index.d.ts
CHANGED
|
@@ -6,5 +6,5 @@ export declare const inject: {
|
|
|
6
6
|
};
|
|
7
7
|
export { Config };
|
|
8
8
|
/** 控制台插件配置页顶部说明:JSON 对象变量的占位符速查 */
|
|
9
|
-
export declare const usage = "\n## JSON \u5BF9\u8C61\u53D8\u91CF\u7684\u5360\u4F4D\u7B26\n\n\u300CJSON \u5BF9\u8C61\u300D\u5206\u652F\u7684\u6A21\u677F\u5185\u53EF\u7528\u4EE5\u4E0B\u5360\u4F4D\u7B26\uFF08\u6574\u4E2A\u5BF9\u8C61\u6CE8\u5165\u5B57\u6BB5\u540D\u5BF9\u5E94\u7684\u5355\u4E00\u53D8\u91CF\uFF09\uFF1A\n\n| \u5360\u4F4D\u7B26 | \u7C7B\u578B | \u8BF4\u660E |\n| --- | --- | --- |\n| `{{userId}}` `{{botId}}` `{{guildId}}` `{{channelId}}` `{{platform}}` | \u5B57\u7B26\u4E32 | \u4F1A\u8BDD\u8EAB\u4EFD |\n| `{{messageId}}` `{{username}}` `{{timestamp}}` | \u5B57\u7B26\u4E32 | \u6D88\u606F\u6807\u8BC6\u4E0E\u4F5C\u8005 |\n| `{{content}}` | \u5B57\u7B26\u4E32 | \u6D88\u606F\u539F\u8C8C |\n| `{{quoteContent}}` `{{quoteAuthorId}}` | \u5B57\u7B26\u4E32 | \u88AB\u5F15\u7528\u6D88\u606F\uFF08\u5F15\u7528\u6BB5 / \u4F5C\u8005\uFF09 |\n| `{{triggerType}}` `{{ruleName}}` `{{triggerTime}}` | \u5B57\u7B26\u4E32 | \u89E6\u53D1\u5143\u4FE1\u606F |\n| `{{history}}` / `{{history:N}}` | \u5B57\u7B26\u4E32 | \u5386\u53F2\u6D88\u606F\u6587\u672C\uFF0CN \u6307\u5B9A\u6761\u6570\uFF08\u7F3A\u7701\u7528\u5168\u5C40\u914D\u7F6E\uFF09 |\n| `{{isDirect}}` | \u5E03\u5C14 | \u662F\u5426\u79C1\u804A |\n\n- \u503C\u6070\u597D\u4E3A\u4E00\u4E2A\u5360\u4F4D\u7B26\uFF08\u5982 `\"is_private\": \"{{isDirect}}\"`\uFF09\u65F6\u4FDD\u7559\u539F\u751F\u7C7B\u578B\n- \u5360\u4F4D\u7B26\u6DF7\u5165\u5176\u4ED6\u6587\u5B57\uFF08\u5982 `\"\u4F60\u597D {{username}}\"`\uFF09\u6309\u5B57\u7B26\u4E32\u62FC\u63A5\uFF0C\u5F15\u53F7\u6362\u884C\u81EA\u52A8\u8F6C\u4E49\n- \u672A\u77E5\u53D8\u91CF\u5F97\u7A7A\u4E32\n";
|
|
9
|
+
export declare const usage = "\n## JSON \u5BF9\u8C61\u53D8\u91CF\u7684\u5360\u4F4D\u7B26\n\n\u300CJSON \u5BF9\u8C61\u300D\u5206\u652F\u7684\u6A21\u677F\u5185\u53EF\u7528\u4EE5\u4E0B\u5360\u4F4D\u7B26\uFF08\u6574\u4E2A\u5BF9\u8C61\u6CE8\u5165\u5B57\u6BB5\u540D\u5BF9\u5E94\u7684\u5355\u4E00\u53D8\u91CF\uFF09\uFF1A\n\n| \u5360\u4F4D\u7B26 | \u7C7B\u578B | \u8BF4\u660E |\n| --- | --- | --- |\n| `{{userId}}` `{{botId}}` `{{botName}}` `{{guildId}}` `{{channelId}}` `{{platform}}` | \u5B57\u7B26\u4E32 | \u4F1A\u8BDD\u8EAB\u4EFD |\n| `{{messageId}}` `{{username}}` `{{timestamp}}` | \u5B57\u7B26\u4E32 | \u6D88\u606F\u6807\u8BC6\u4E0E\u4F5C\u8005 |\n| `{{content}}` | \u5B57\u7B26\u4E32 | \u6D88\u606F\u539F\u8C8C |\n| `{{quoteContent}}` `{{quoteAuthorId}}` | \u5B57\u7B26\u4E32 | \u88AB\u5F15\u7528\u6D88\u606F\uFF08\u5F15\u7528\u6BB5 / \u4F5C\u8005\uFF09 |\n| `{{triggerType}}` `{{ruleName}}` `{{triggerTime}}` | \u5B57\u7B26\u4E32 | \u89E6\u53D1\u5143\u4FE1\u606F |\n| `{{history}}` / `{{history:N}}` | \u5B57\u7B26\u4E32 | \u5386\u53F2\u6D88\u606F\u6587\u672C\uFF0CN \u6307\u5B9A\u6761\u6570\uFF08\u7F3A\u7701\u7528\u5168\u5C40\u914D\u7F6E\uFF09 |\n| `{{isDirect}}` | \u5E03\u5C14 | \u662F\u5426\u79C1\u804A |\n\n- \u503C\u6070\u597D\u4E3A\u4E00\u4E2A\u5360\u4F4D\u7B26\uFF08\u5982 `\"is_private\": \"{{isDirect}}\"`\uFF09\u65F6\u4FDD\u7559\u539F\u751F\u7C7B\u578B\n- \u5360\u4F4D\u7B26\u6DF7\u5165\u5176\u4ED6\u6587\u5B57\uFF08\u5982 `\"\u4F60\u597D {{username}}\"`\uFF09\u6309\u5B57\u7B26\u4E32\u62FC\u63A5\uFF0C\u5F15\u53F7\u6362\u884C\u81EA\u52A8\u8F6C\u4E49\n- \u672A\u77E5\u53D8\u91CF\u5F97\u7A7A\u4E32\n";
|
|
10
10
|
export declare function apply(ctx: Context, config: Config): void;
|
package/lib/index.js
CHANGED
|
@@ -36,7 +36,8 @@ var zh_CN_default = {
|
|
|
36
36
|
"conv-reset": "已重置 {0} 条会话绑定。"
|
|
37
37
|
},
|
|
38
38
|
errors: {
|
|
39
|
-
"request-failed": "Dify 请求失败:{0}"
|
|
39
|
+
"request-failed": "Dify 请求失败:{0}",
|
|
40
|
+
"command-args-mismatch": "参数数量不符:需要 {0} 个,收到 {1} 个;不带参数则按默认取值。"
|
|
40
41
|
}
|
|
41
42
|
}
|
|
42
43
|
};
|
|
@@ -49,7 +50,8 @@ var en_US_default = {
|
|
|
49
50
|
"conv-reset": "Reset {0} conversation binding(s)."
|
|
50
51
|
},
|
|
51
52
|
errors: {
|
|
52
|
-
"request-failed": "Dify request failed: {0}"
|
|
53
|
+
"request-failed": "Dify request failed: {0}",
|
|
54
|
+
"command-args-mismatch": "Argument count mismatch: expected {0}, got {1}; omit arguments to use defaults."
|
|
53
55
|
}
|
|
54
56
|
}
|
|
55
57
|
};
|
|
@@ -97,6 +99,10 @@ var conditionSchema = import_koishi.Schema.union([
|
|
|
97
99
|
type: import_koishi.Schema.const("quote-user").required(),
|
|
98
100
|
userIds: import_koishi.Schema.string().role("textarea").required().description("用户 ID,每行一个")
|
|
99
101
|
}).default({ type: "quote-user", userIds: "" }).description("引用指定用户"),
|
|
102
|
+
import_koishi.Schema.object({
|
|
103
|
+
type: import_koishi.Schema.const("command").required(),
|
|
104
|
+
command: import_koishi.Schema.string().required().description("指令名")
|
|
105
|
+
}).default({ type: "command", command: "" }).description("指令"),
|
|
100
106
|
import_koishi.Schema.object({
|
|
101
107
|
type: renamedType("cron", "schedule").required(),
|
|
102
108
|
cron: import_koishi.Schema.string().default("").description("Cron 表达式"),
|
|
@@ -112,6 +118,7 @@ var sessionKeySchema = import_koishi.Schema.union([
|
|
|
112
118
|
import_koishi.Schema.const("none").description("无"),
|
|
113
119
|
import_koishi.Schema.const("userId").description("用户 ID"),
|
|
114
120
|
import_koishi.Schema.const("botId").description("Bot ID"),
|
|
121
|
+
import_koishi.Schema.const("botName").description("Bot 昵称"),
|
|
115
122
|
import_koishi.Schema.const("guildId").description("群聊 ID"),
|
|
116
123
|
import_koishi.Schema.const("channelId").description("频道 ID"),
|
|
117
124
|
import_koishi.Schema.const("platform").description("平台"),
|
|
@@ -280,6 +287,11 @@ function toCondition(entry) {
|
|
|
280
287
|
case "at-bot":
|
|
281
288
|
case "quote-bot":
|
|
282
289
|
return { type: entry.type };
|
|
290
|
+
case "command": {
|
|
291
|
+
const command = entry.command?.trim();
|
|
292
|
+
if (!command) return null;
|
|
293
|
+
return { type: "command", command };
|
|
294
|
+
}
|
|
283
295
|
case "cron": {
|
|
284
296
|
const cron = entry.cron?.trim();
|
|
285
297
|
const intervalMinutes = Number(entry.intervalMinutes);
|
|
@@ -1212,9 +1224,50 @@ var TriggerEngine = class {
|
|
|
1212
1224
|
this.pool.record(session, entry);
|
|
1213
1225
|
});
|
|
1214
1226
|
registerPoolEvents(this.ctx, this.pool);
|
|
1227
|
+
this.registerCommands();
|
|
1215
1228
|
this.scheduler.sync(this.rules);
|
|
1216
1229
|
this.ctx.logger.info("已加载 %d 条启用规则", this.rules.length);
|
|
1217
1230
|
}
|
|
1231
|
+
/** 把规则内的指令条件注册为顶层 koishi 指令(同名只注册首个,指令触发是显式意图不参与冷却) */
|
|
1232
|
+
registerCommands() {
|
|
1233
|
+
const registered = /* @__PURE__ */ new Set();
|
|
1234
|
+
for (const rule of this.rules) {
|
|
1235
|
+
for (const condition of rule.conditions) {
|
|
1236
|
+
if (condition.type !== "command") continue;
|
|
1237
|
+
if (registered.has(condition.command)) {
|
|
1238
|
+
this.ctx.logger.warn("指令 %s 已被注册,跳过后续规则", condition.command);
|
|
1239
|
+
continue;
|
|
1240
|
+
}
|
|
1241
|
+
registered.add(condition.command);
|
|
1242
|
+
this.ctx.command(condition.command).action(({ session, args }) => {
|
|
1243
|
+
if (session) void this.fireCommand(rule, session, args ?? []);
|
|
1244
|
+
});
|
|
1245
|
+
}
|
|
1246
|
+
}
|
|
1247
|
+
}
|
|
1248
|
+
/** 指令触发:位置参数按序覆盖单值变量映射,数量不符报错(本地化),无参按默认取值 */
|
|
1249
|
+
async fireCommand(rule, session, args) {
|
|
1250
|
+
if (!matchScope(rule.scope, session)) return;
|
|
1251
|
+
if (args.length > 0) {
|
|
1252
|
+
const bindings = rule.variables.filter((binding) => binding.source.type !== "json");
|
|
1253
|
+
if (args.length !== bindings.length) {
|
|
1254
|
+
await session.send(session.text("dify-ai.errors.command-args-mismatch", [bindings.length, args.length])).catch(() => {
|
|
1255
|
+
});
|
|
1256
|
+
return;
|
|
1257
|
+
}
|
|
1258
|
+
}
|
|
1259
|
+
const argsText = args.join(" ");
|
|
1260
|
+
this.run({
|
|
1261
|
+
session,
|
|
1262
|
+
...sessionIdentityOf(session),
|
|
1263
|
+
triggerType: "command",
|
|
1264
|
+
rule,
|
|
1265
|
+
// 无参时空串由请求器占位兜底
|
|
1266
|
+
queryText: argsText,
|
|
1267
|
+
contentText: argsText,
|
|
1268
|
+
commandArgs: args.length ? args : void 0
|
|
1269
|
+
});
|
|
1270
|
+
}
|
|
1218
1271
|
handleMessage(session, next) {
|
|
1219
1272
|
if (this.ctx.bots[session.uid] || !session.channelId) return next();
|
|
1220
1273
|
const channelKey = channelKeyOf(session.platform, session.channelId);
|
|
@@ -1577,6 +1630,8 @@ function resolveSessionField(key, fireCtx, now) {
|
|
|
1577
1630
|
return fireCtx.userId ?? session?.userId ?? "";
|
|
1578
1631
|
case "botId":
|
|
1579
1632
|
return fireCtx.selfId ?? session?.selfId ?? "";
|
|
1633
|
+
case "botName":
|
|
1634
|
+
return session?.bot?.user?.name || session?.bot?.user?.nick || fireCtx.selfId;
|
|
1580
1635
|
case "guildId":
|
|
1581
1636
|
return fireCtx.guildId ?? "";
|
|
1582
1637
|
case "channelId":
|
|
@@ -1687,6 +1742,12 @@ function resolveVariables(rule, fireCtx, history) {
|
|
|
1687
1742
|
const value = resolveSource(binding.source, fireCtx, history, now);
|
|
1688
1743
|
if (value !== void 0) inputs[binding.field] = value;
|
|
1689
1744
|
}
|
|
1745
|
+
if (fireCtx.commandArgs) {
|
|
1746
|
+
const bindings = rule.variables.filter((binding) => binding.source.type !== "json");
|
|
1747
|
+
fireCtx.commandArgs.forEach((arg, index) => {
|
|
1748
|
+
inputs[bindings[index].field] = arg;
|
|
1749
|
+
});
|
|
1750
|
+
}
|
|
1690
1751
|
return inputs;
|
|
1691
1752
|
}
|
|
1692
1753
|
__name(resolveVariables, "resolveVariables");
|
|
@@ -2128,7 +2189,7 @@ var usage = `
|
|
|
2128
2189
|
|
|
2129
2190
|
| 占位符 | 类型 | 说明 |
|
|
2130
2191
|
| --- | --- | --- |
|
|
2131
|
-
| \`{{userId}}\` \`{{botId}}\` \`{{guildId}}\` \`{{channelId}}\` \`{{platform}}\` | 字符串 | 会话身份 |
|
|
2192
|
+
| \`{{userId}}\` \`{{botId}}\` \`{{botName}}\` \`{{guildId}}\` \`{{channelId}}\` \`{{platform}}\` | 字符串 | 会话身份 |
|
|
2132
2193
|
| \`{{messageId}}\` \`{{username}}\` \`{{timestamp}}\` | 字符串 | 消息标识与作者 |
|
|
2133
2194
|
| \`{{content}}\` | 字符串 | 消息原貌 |
|
|
2134
2195
|
| \`{{quoteContent}}\` \`{{quoteAuthorId}}\` | 字符串 | 被引用消息(引用段 / 作者) |
|
package/lib/locales/en-US.d.ts
CHANGED
package/lib/locales/zh-CN.d.ts
CHANGED
package/lib/trigger/engine.d.ts
CHANGED
|
@@ -16,6 +16,10 @@ export declare class TriggerEngine {
|
|
|
16
16
|
private cooldown;
|
|
17
17
|
constructor(ctx: Context, runner: RequestRunner, history: MessageHistory, rules: DifyRule[], cooldown: CooldownSetting | null);
|
|
18
18
|
start(): void;
|
|
19
|
+
/** 把规则内的指令条件注册为顶层 koishi 指令(同名只注册首个,指令触发是显式意图不参与冷却) */
|
|
20
|
+
private registerCommands;
|
|
21
|
+
/** 指令触发:位置参数按序覆盖单值变量映射,数量不符报错(本地化),无参按默认取值 */
|
|
22
|
+
private fireCommand;
|
|
19
23
|
private handleMessage;
|
|
20
24
|
private matchRule;
|
|
21
25
|
/** 异步执行一次请求;错误由请求器与这里的兜底记录 */
|
package/lib/types.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import type { Session } from 'koishi';
|
|
2
2
|
/** 消息驱动的触发原因(merged = 冷却期内多条触发消息合并为一次触发) */
|
|
3
|
-
export type MessageTriggerType = 'keyword-prefix' | 'keyword-contains' | 'at-bot' | 'at-user' | 'quote-bot' | 'quote-user' | 'merged';
|
|
3
|
+
export type MessageTriggerType = 'keyword-prefix' | 'keyword-contains' | 'at-bot' | 'at-user' | 'quote-bot' | 'quote-user' | 'merged' | 'command';
|
|
4
4
|
/** 非消息驱动的触发原因(triggerType 值 0.1.12 起 schedule→cron、density→frequency) */
|
|
5
5
|
export type ProactiveTriggerType = 'cron' | 'frequency';
|
|
6
6
|
export type TriggerType = MessageTriggerType | ProactiveTriggerType;
|
|
@@ -24,6 +24,11 @@ export interface AtBotCondition {
|
|
|
24
24
|
export interface QuoteBotCondition {
|
|
25
25
|
type: 'quote-bot';
|
|
26
26
|
}
|
|
27
|
+
/** 指令触发:指令名注册为顶层 koishi 指令,位置参数按序覆盖单值变量映射 */
|
|
28
|
+
export interface CommandCondition {
|
|
29
|
+
type: 'command';
|
|
30
|
+
command: string;
|
|
31
|
+
}
|
|
27
32
|
/** 定时触发(cron):cron(服务器本地时区)与固定间隔分钟数二选一 */
|
|
28
33
|
export interface ScheduleCondition {
|
|
29
34
|
type: 'cron';
|
|
@@ -40,7 +45,7 @@ export interface DensityCondition {
|
|
|
40
45
|
* 触发条件(判别联合)。规则内多个条件为「或」关系:任一命中即触发。
|
|
41
46
|
* 由 normalizeConfig 保证加载形态合法,消费方无需再兜底必填字段。
|
|
42
47
|
*/
|
|
43
|
-
export type TriggerCondition = KeywordCondition | UserCondition | AtBotCondition | QuoteBotCondition | ScheduleCondition | DensityCondition;
|
|
48
|
+
export type TriggerCondition = KeywordCondition | UserCondition | AtBotCondition | QuoteBotCondition | CommandCondition | ScheduleCondition | DensityCondition;
|
|
44
49
|
/** 触发作用域:留空的维度不做限制 */
|
|
45
50
|
export interface TriggerScope {
|
|
46
51
|
platforms?: string[];
|
|
@@ -53,7 +58,7 @@ export interface TriggerScope {
|
|
|
53
58
|
isDirect?: boolean;
|
|
54
59
|
}
|
|
55
60
|
/** 变量来源:从会话上下文取值 */
|
|
56
|
-
export type SessionField = 'userId' | 'botId' | 'guildId' | 'channelId' | 'platform' | 'messageId' | 'content' | 'quoteContent' | 'quoteAuthorId' | 'username' | 'timestamp' | 'isDirect';
|
|
61
|
+
export type SessionField = 'userId' | 'botId' | 'botName' | 'guildId' | 'channelId' | 'platform' | 'messageId' | 'content' | 'quoteContent' | 'quoteAuthorId' | 'username' | 'timestamp' | 'isDirect';
|
|
57
62
|
/** 变量来源:触发元信息 */
|
|
58
63
|
export type MetaField = 'triggerType' | 'ruleName' | 'triggerTime';
|
|
59
64
|
export type VariableSource = {
|
|
@@ -121,4 +126,6 @@ export interface FireContext {
|
|
|
121
126
|
imageUrls?: string[];
|
|
122
127
|
/** 无 session 的主动触发(定时/密度到期)从消息池透传的私聊标记:会话绑定与 isDirect 变量用 */
|
|
123
128
|
isDirect?: boolean;
|
|
129
|
+
/** 指令触发的位置参数:按序覆盖单值变量映射的值(JSON 分支不占位) */
|
|
130
|
+
commandArgs?: string[];
|
|
124
131
|
}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "koishi-plugin-dify-ai",
|
|
3
3
|
"description": "Invoke Dify apps (chatflow / workflow / completion) in Koishi with triggers and conversation bindings",
|
|
4
|
-
"version": "0.1.
|
|
4
|
+
"version": "0.1.16",
|
|
5
5
|
"author": "PinkElysia",
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"homepage": "https://github.com/PinkElysiaDev/dify-ai-plugin-for-Koishi#readme",
|