@aalis/plugin-commands 0.14.0 → 0.15.0

package/dist/help.js

@@ -1,73 +1,116 @@
 // ============================================================
 // help.ts — 指令帮助的渲染（纯函数，便于单测）
 //
-// 两段式：概览回答「有哪些能用」，详情回答「这条怎么用」。哪些指令看得见由注册表按调用者的等级定。
+// 两段式：概览回答「有哪些能用」，详情回答「这条怎么用」。哪些指令看得见由注册表按调用者的等级定。一条回复要用的说明与
+// 版式文字整份交给 localize 渲染一次（按调用者所在会话的语言），渲染之后再取摘要、拼成整条回复，回复是这种语言的字符串。
 //
-// 输出是各平台通用的纯文本：QQ 与终端原样显示，WebUI 按 Markdown 渲染。所以只用两边读起来都对的写法——
-// 一行一条的 `- ` 列表（取值缩进两格成子列表），段落之间空一行；不用加粗、反引号与代码围栏，也不用空格对列
-// （比例字体下对不齐）。占位写成 `<名字>`，不带冒号：`<名字:类型>` 在 Markdown 里会被当成自动链接。
+// 输出是各平台通用的纯文本：QQ 与终端原样显示，WebUI 的时间线里只认段落与列表，其余写法照原文显示。所以只用一行一条的
+// `- ` 列表（取值缩进两格成子列表），段落之间空一行；不用加粗、反引号与代码围栏，也不用空格对列（比例字体下对不齐）。
+// 占位写成 `<名字>`，不带类型。
 // ============================================================
-/** 第一句的结束：句号、分号、问号、叹号或换行 */
-const SENTENCE_END = /[。；！？\n]/;
-/** 摘要的上限（按字计）：第一句过长时截断，免得一行撑满 */
-const BRIEF_MAX = 24;
-/** 摘要：约定描述的第一句就是摘要；第一句过长时截断，省略号紧跟文字 */
+import { t } from './texts.js';
+/** 句子边界按 Unicode 的通用规则，与读者的语言无关 */
+const SENTENCES = new Intl.Segmenter('und', { granularity: 'sentence' });
+const GRAPHEMES = new Intl.Segmenter('und', { granularity: 'grapheme' });
+/** 句子切分不在分号处断句，分号另算句末（换行处它已断句） */
+const CLAUSE_END = /[;；]/;
+/**
+ * 占两列的字：中日韩文字（按 Script_Extensions 认，长音符 ー 与中点 ・ 这类各文字共用的符号在内）、中日韩标点、竖排与兼容
+ * 形式、全角形式；Script_Extensions 也带上的拉丁区中点 ·、修饰符与组合符，谚文的中声与终声，半角片假名与半角谚文占一列
+ */
+const WIDE = /^(?![\u00A0-\u036F\u1160-\u11FF\uFF61-\uFFDC])[\p{scx=Han}\p{scx=Hira}\p{scx=Kana}\p{scx=Hang}\p{scx=Bopo}\u3000-\u303F\uFE30-\uFE4F\uFF01-\uFF60\uFFE0-\uFFE6]/u;
+/** 按 emoji 显示的字素同样占两列：默认按 emoji 显示的，以及带 VS16（U+FE0F）或键帽（U+20E3）的文本字符 */
+const EMOJI = /\p{Emoji_Presentation}|\uFE0F|\u20E3/u;
+/** 摘要的上限（按显示宽度计）：第一句过长时截断，免得一行撑满 */
+const BRIEF_COLUMNS = 48;
+/**
+ * 摘要：约定描述的第一句就是摘要，句末标点不留；第一句超过 48 列时截断，去掉截断处尾部的标点（闭括号与后引号除外）与空白，
+ * 省略号紧跟文字
+ */
 export function brief(description) {
-    const text = description.trim();
-    const end = text.search(SENTENCE_END);
-    const first = [...(end < 0 ? text : text.slice(0, end)).trimEnd()];
-    if (first.length <= BRIEF_MAX)
-        return first.join('');
-    return `${first
-        .slice(0, BRIEF_MAX)
-        .join('')
-        .replace(/[\s，,、：:·/\-—（(]+$/, '')}…`;
+    const [sentence] = SENTENCES.segment(description.trim());
+    const first = (sentence?.segment ?? '').split(CLAUSE_END)[0].replace(/[\s\p{Sentence_Terminal}]+$/u, '');
+    let width = 0;
+    let kept = '';
+    for (const { segment } of GRAPHEMES.segment(first)) {
+        width += WIDE.test(segment) || EMOJI.test(segment) ? 2 : 1;
+        if (width > BRIEF_COLUMNS)
+            return `${kept.replace(/(?:(?![\p{Pe}\p{Pf}])[\s\p{P}])+$/u, '')}…`;
+        kept += segment;
+    }
+    return first;
 }
 const spelled = (name, prefix) => `${prefix}${name.replace(/\./g, ' ')}`;
-/** `- /指令 — 摘要 · n 个子指令`；自动分组没有描述，只报子指令数 */
-function entryLine({ cmd, children }, prefix) {
-    const notes = [cmd.isGroup ? '' : brief(cmd.description), children > 0 ? `${children} 个子指令` : ''].filter(Boolean);
-    return `- ${spelled(cmd.name, prefix)}${notes.length > 0 ? ` — ${notes.join(' · ')}` : ''}`;
+/** 列表里的一条指令要渲染的文字：说明（自动分组没有）与子指令数 */
+const entryTexts = ({ cmd, children }) => ({
+    description: cmd.isGroup ? '' : cmd.description,
+    children: children > 0 ? t('children', { count: children }) : '',
+});
+/** `- /指令 — 摘要 · n 个子指令`：说明渲染之后取摘要 */
+function entryLine(name, texts, prefix) {
+    const notes = [brief(texts.description), texts.children].filter(Boolean);
+    return `- ${spelled(name, prefix)}${notes.length > 0 ? ` — ${notes.join(' · ')}` : ''}`;
 }
 const argText = (arg) => (arg.required ? `<${arg.name}>` : `[${arg.name}]`);
+/** 带说明的一项写成「项：说明」 */
+const described = (item, description) => description ? t('described', { item, description }) : item;
 /** 一个选项一行，取值各占一行缩在下面 */
 function optionLines(option) {
     const flags = new Set([`--${option.name}`, ...option.aliases.map(a => (a.length === 1 ? `-${a}` : `--${a}`))]);
     const placeholder = option.valueName ?? option.name;
     const value = option.type === 'boolean' ? '' : option.valueOptional ? ` [${placeholder}]` : ` <${placeholder}>`;
     return [
-        `- ${[...flags].join(', ')}${value}${option.description ? `：${option.description}` : ''}`,
-        ...(option.choices ?? []).map(c => `  - ${c.value}${c.description ? `：${c.description}` : ''}`),
+        described(`- ${[...flags].join(', ')}${value}`, option.description),
+        ...(option.choices?.() ?? []).map(c => described(`  - ${c.value}`, c.description)),
     ];
 }
+/** 用法里以空格相连的一串：占位词（<子指令>、[选项]）是文字对象，嵌套着交出，与整条回复同一次渲染 */
+const spaced = (words) => words.reduce((head, tail) => t('spaced', { head, tail }));
 /** 一段：标题加一行一条；没有条目时整段不出 */
 const section = (title, lines) => (lines.length > 0 ? [title, ...lines].join('\n') : '');
-export function renderOverview(entries, prefix) {
-    return [
-        `可用指令（${entries.length} 条）：`,
-        ...entries.map(e => entryLine(e, prefix)),
-        '',
-        `详情：${prefix}help 指令名，或在指令后加 -h`,
-    ].join('\n');
+export function renderOverview(entries, prefix, localize) {
+    const texts = localize({
+        title: t('overview', { count: entries.length }),
+        entries: entries.map(entryTexts),
+        hint: t('overviewHint', { prefix }),
+    });
+    const lines = texts.entries.map((e, i) => entryLine(entries[i].cmd.name, e, prefix));
+    return [texts.title, ...lines, '', texts.hint].join('\n');
 }
-/** 详情：标题（带完整描述）、用法、示例、参数、选项、子指令、别名，各段之间空一行 */
-export function renderDetail(cmd, children, prefix) {
+/**
+ * 详情：标题（带完整描述）、用法、示例、参数、选项、子指令、别名，各段之间空一行。给了 error 时（选项写错附上用法）报错在
+ * 最前面
+ */
+export function renderDetail(cmd, children, prefix, localize, error) {
     const head = spelled(cmd.name, prefix);
-    const usage = [
+    const usage = spaced([
         head,
-        children.length > 0 && !cmd.handler ? '<子指令>' : '',
+        ...(children.length > 0 && !cmd.handler ? [t('subcommandSlot')] : []),
         ...cmd.positionalArgs.map(argText),
-        cmd.options.length > 0 ? '[选项]' : '',
-    ];
-    const described = cmd.positionalArgs.filter(a => a.description);
+        ...(cmd.options.length > 0 ? [t('optionsSlot')] : []),
+    ]);
+    const texts = localize({
+        error: error ?? '',
+        description: cmd.isGroup ? '' : cmd.description,
+        usage: t('usage', { usage }),
+        examples: t('examples'),
+        arguments: t('arguments'),
+        argumentLines: cmd.positionalArgs.filter(a => a.description).map(a => described(`- ${argText(a)}`, a.description)),
+        options: t('options'),
+        optionLines: cmd.options.flatMap(optionLines),
+        subcommands: t('subcommands'),
+        children: children.map(entryTexts),
+        aliases: cmd.aliases.length > 0 ? t('aliases', { names: cmd.aliases.map(a => spelled(a, prefix)) }) : '',
+    });
     return [
-        cmd.isGroup || !cmd.description ? head : `${head} — ${cmd.description}`,
-        `用法：${usage.filter(Boolean).join(' ')}`,
-        section('示例：', (cmd.examples ?? []).map(e => `- ${e}`)),
-        section('参数：', described.map(a => `- ${argText(a)}：${a.description}`)),
-        section('选项：', cmd.options.flatMap(optionLines)),
-        section('子指令：', children.map(e => entryLine(e, prefix))),
-        cmd.aliases.length > 0 ? `别名：${cmd.aliases.map(a => spelled(a, prefix)).join('、')}` : '',
+        texts.error,
+        texts.description ? `${head} — ${texts.description}` : head,
+        texts.usage,
+        section(texts.examples, (cmd.examples ?? []).map(e => `- ${e}`)),
+        section(texts.arguments, texts.argumentLines),
+        section(texts.options, texts.optionLines),
+        section(texts.subcommands, texts.children.map((e, i) => entryLine(children[i].cmd.name, e, prefix))),
+        texts.aliases,
     ]
         .filter(Boolean)
         .join('\n\n');

package/dist/help.js.map

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

package/dist/index.d.ts

@@ -1,33 +1,3 @@
-import { type StorageService } from '@aalis/api-storage';
-/** 可清理类型。globalOnly：跨会话数据，只在 /clear all 时清理 */
-export declare const CLEAR_TYPES: ReadonlyArray<{
-    id: string;
-    label: string;
-    globalOnly?: boolean;
-}>;
-/**
- * 附件缓存种类 → `data:/` 目录 + 中文标签。
- * 目录名与 @aalis/plugin-adapter-onebot 的 attachment-cache `KIND_DIR` 对齐
- * （image→images / video→videos / audio→audios / file→files），落盘路径为
- * `data:/{dir}/{safeSessionId}/{hash}.{ext}`。改这里即同步 /clear 覆盖面。
- */
-export declare const ATTACHMENT_KINDS: readonly [{
-    readonly type: "image";
-    readonly dir: "images";
-    readonly label: "图片";
-}, {
-    readonly type: "video";
-    readonly dir: "videos";
-    readonly label: "视频";
-}, {
-    readonly type: "audio";
-    readonly dir: "audios";
-    readonly label: "语音";
-}, {
-    readonly type: "file";
-    readonly dir: "files";
-    readonly label: "文件";
-}];
 declare const _default: import("@aalis/core").PluginDefinition<{
     /**
      * commands 由本插件自己提供，只能声明成 optional：写 required 会把激活闸架在自己的
@@ -36,11 +6,18 @@ declare const _default: import("@aalis/core").PluginDefinition<{
      */
     commands: import("@aalis/core").OptionalUse<import("@aalis/api-commands").CommandService, import("@aalis/api-commands").BoundCommands>;
     gateway: import("@aalis/core").ServiceDescriptor<import("@aalis/api-gateway").GatewayService, import("@aalis/api-gateway").GatewayService>;
-    storage: import("@aalis/core").OptionalUse<StorageService, import("@aalis/api-storage").BoundStorage>;
     memory: import("@aalis/core").OptionalUse<import("@aalis/api-memory").MemoryService, import("@aalis/api-memory").MemoryService>;
+    /** /clear 清消息历史时经它先停下并按住这些会话；缺席时没有在跑的回合要停 */
+    agent: import("@aalis/core").OptionalUse<import("@aalis/api-agent").AgentService, import("@aalis/api-agent").BoundAgent>;
     authority: import("@aalis/core").OptionalUse<import("@aalis/api-authority").AuthorityService, import("@aalis/api-authority").AuthorityService>;
-    /** /status 列已登记的工具数 */
+    /** /status 写已登记的工具数 */
     tools: import("@aalis/core").OptionalUse<import("@aalis/api-tools").ToolService, import("@aalis/api-tools").BoundTools>;
+    /** /status 写插件在跑与出错的个数；缺席时不写这一行 */
+    plugins: import("@aalis/core").OptionalUse<import("@aalis/core").PluginManagerService, import("@aalis/core").PluginManagerService>;
+    /** /clear 的类型按 memory:clear-type 的登记表取；缺席时只认 all */
+    contributions: import("@aalis/core").OptionalUse<import("@aalis/api-contributions").ContributionRegistry, import("@aalis/api-contributions").Contributions>;
+    /** 回复与帮助按这条指令所在会话的语言渲染；缺席时按原文 */
+    i18n: import("@aalis/core").OptionalUse<import("@aalis/api-i18n").I18nService, import("@aalis/api-i18n").I18nService>;
     app: import("@aalis/core").ServiceDescriptor<import("@aalis/core").AppService, import("@aalis/core").AppService>;
     events: import("@aalis/core").ServiceDescriptor<(identity: symbol) => import("@aalis/core").Events, import("@aalis/core").Events>;
     hooks: import("@aalis/core").ServiceDescriptor<import("@aalis/api-hooks").HookRegistry, import("@aalis/api-hooks").Hooks>;
@@ -49,7 +26,6 @@ declare const _default: import("@aalis/core").PluginDefinition<{
     logger: import("@aalis/core").ServiceDescriptor<(identity: symbol) => import("@aalis/core").Logger, import("@aalis/core").Logger>;
     config: import("@aalis/core").ServiceDescriptor<(identity: symbol) => Readonly<Record<string, unknown>>, Readonly<Record<string, unknown>>>;
     provide: import("@aalis/core").ServiceDescriptor<(identity: symbol) => import("@aalis/core").Provide, import("@aalis/core").Provide>;
-    services: import("@aalis/core").ServiceDescriptor<(identity: symbol) => import("@aalis/core").Services, import("@aalis/core").Services>;
 }>;
 export default _default;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAqB,KAAK,cAAc,EAAW,MAAM,oBAAoB,CAAC;AA8CrF,+CAA+C;AAC/C,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,CAY1F,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;EAKnB,CAAC;;IA8BT;;;;OAIG;;;;;;IAMH,uBAAuB;;;;;IAKvB,oBAAoB;;;;;;;AAStB,wBAQG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";IA8DE;;;;OAIG;;;;IAIH,6CAA6C;;;IAG7C,uBAAuB;;IAEvB,mCAAmC;;IAEnC,oDAAoD;;IAEpD,iCAAiC;;;;;IAKjC,oBAAoB;;;;;;AAQtB,wBAQG"}