@zhin.js/plugin-reminder 1.0.5 → 1.0.7

package/README.md

@@ -54,9 +54,9 @@ remind cancel <任务 ID>
 
 延迟是 1 秒至一年；周期是 60 秒至一年；内容是 1–500 字符。时间必须在未来一年内。指令权限经过框架 PermissionHost；插件没有额外权限旁路或取消其他发送者任务的管理员接口。
 
-`create` 创建一次性个人提醒，不依赖 AI。缺少时间或正文时逐项补问，随后用纯文字显示绝对日期、IANA 时区、正文和完整原会话；只有明确回复 `确认` 才保存。后续回答不加命令前缀；输入 `取消` 或 `cancel` 退出后再发新命令。每步有时限且整个流程最多三分钟，输错不会无限续期。超时、取消或热重载结束旧流程，均不创建任务。确认时已过期的时间不会自动顺延。
+`create` 创建一次性个人提醒，不依赖 AI。缺少时间或正文时逐项补问，随后用纯文字显示绝对日期、IANA 时区、正文和完整原会话；只有按本次流程语言明确回复 `确认`（中文）或 `confirm`（英文）才保存。后续回答不加命令前缀；中文流程只接受 `取消`，英文流程只接受 `cancel`。流程开始后固定语言，切换个人偏好只影响新操作。每步有时限且整个流程最多三分钟，输错不会无限续期。超时、取消或热重载结束旧流程，均不创建任务。确认时已过期的时间不会自动顺延。
 
-自然时间仅支持有限中文语法：如 `10分钟后`、`一天后`（固定 24 小时）、`今天18:30`、`明天九点`、`后天九点半`、`明天下午三点半`；也支持带 offset 的 ISO 时间。裸写 `九点`、日历周期和夏令时重复／不存在时刻不会猜测。按钮、Markdown 和图片均非必需；非聊天 CLI 没有真实发送者和交互能力时不能创建。完整操作与边界见[无需 AI 的提醒指南](https://zhin.js.org/solutions/reminders)。
+自然时间按当前语言选择有限语法：中文如 `10分钟后`、`一天后`（固定 24 小时）、`今天18:30`、`明天九点`、`后天九点半`、`明天下午三点半`；英文如 `in 10 minutes`、`in 2 hours`、`today at 18:30`、`tomorrow at 09:00`、`day after tomorrow at 09:30`。英文只接受整数时长和 24 小时制时刻；两种语言均接受带 offset 的 ISO 时间，不交叉接受另一语言的自然表达。裸写 `九点`、日历周期和夏令时重复／不存在时刻不会猜测。按钮、Markdown 和图片均非必需；非聊天 CLI 没有真实发送者和交互能力时不能创建。完整操作与边界见[无需 AI 的提醒指南](https://zhin.js.org/solutions/reminders)。
 
 ## 执行与恢复
 
@@ -114,3 +114,9 @@ schedules/poll/index.ts   # 正式 Schedule Feature 入口
 ### 事务化任务存储
 
 提醒与管理员 RSS 的任务、认领、操作回执和文章明细使用独立数据表，在一个事务中提交；原 CAS JSON 只用于首次迁移。支持 SQLite、MySQL、PostgreSQL，升级须完整重启，不能与旧版本进程混写。`unknown` 投递仍不会自动重试。迁移和字段说明见[结构化存储](../../../docs/operations/structured-storage.md)。
+
+## Language / 语言
+
+聊天回复使用当前发送者的语言。提醒创建时保存语言：聊天任务使用创建者当时的语言，Console 管理员任务使用项目语言。后续切换个人、项目或 Console 语言不修改既有任务的通知语言；数据库重启和热重载也保留它。管理员列表、错误和操作回执按当前 Console 请求语言展示，不影响 CAS 版本或请求去重。旧任务没有语言字段时按原中文行为读取。
+
+English flows accept `confirm` and `cancel`, and finite expressions such as `in 10 minutes` or `tomorrow at 09:00`. Timezone remains a separate IANA setting; no locale-based timezone inference or DST guessing is performed. Command hints use the actual endpoint prefix and plugin namespace resolved by the dispatcher. Notifications keep the language captured when the task was created.

package/commands/remind/after/index.js

@@ -1,16 +1,17 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { reminderMessages as t } from "../../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { reminderServiceToken } from "../../../lib/runtime.js";
 import { reminderActor, replyReminder } from "../../../lib/caller.js";
 import { MAX_DELAY_SECONDS } from "../../../lib/service.js";
 export default defineCommand({
-    description: '创建一次性延迟提醒',
-    params: { seconds: { type: 'integer', min: 1, max: MAX_DELAY_SECONDS, description: '延迟秒数' }, text: { type: 'text', min: 1, max: 500, description: '提醒内容' } },
-    async execute({ input, params, use }) {
+    description: '创建一次性延迟提醒', descriptionI18n: { en: "Create a one-time reminder after a delay" },
+    params: { seconds: { type: 'integer', min: 1, max: MAX_DELAY_SECONDS, description: '延迟秒数', descriptionI18n: { en: "Delay in seconds" } }, text: { type: 'text', min: 1, max: 500, description: '提醒内容', descriptionI18n: { en: "Reminder text" } } },
+    async execute({ input, params, use, locale }) {
         return replyReminder(async () => {
             const service = use(reminderServiceToken);
-            const task = await service.add(reminderActor(input), params.text, Date.now() + params.seconds * 1000, null);
-            return `已创建提醒\n${service.describe(task)}`;
+            const task = await service.add(reminderActor(input, locale), params.text, Date.now() + params.seconds * 1000, null);
+            return `${t(locale, 'created')}\n${service.describe(task, locale)}`;
         });
     },
 });

package/commands/remind/after/index.ts

@@ -1,16 +1,17 @@
+import { reminderMessages as t } from '../../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { reminderServiceToken } from '../../../src/runtime.js';
 import { reminderActor, replyReminder } from '../../../src/caller.js';
 import { MAX_DELAY_SECONDS } from '../../../src/service.js';
 
 export default defineCommand({
-  description: '创建一次性延迟提醒',
-  params: { seconds: { type: 'integer', min: 1, max: MAX_DELAY_SECONDS, description: '延迟秒数' }, text: { type: 'text', min: 1, max: 500, description: '提醒内容' } },
-  async execute({ input, params, use }) {
+  description: '创建一次性延迟提醒', descriptionI18n: { en: "Create a one-time reminder after a delay" },
+  params: { seconds: { type: 'integer', min: 1, max: MAX_DELAY_SECONDS, description: '延迟秒数', descriptionI18n: { en: "Delay in seconds" } }, text: { type: 'text', min: 1, max: 500, description: '提醒内容', descriptionI18n: { en: "Reminder text" } } },
+  async execute({ input, params, use, locale }) {
     return replyReminder(async () => {
       const service = use(reminderServiceToken);
-      const task = await service.add(reminderActor(input), params.text, Date.now() + params.seconds * 1000, null);
-      return `已创建提醒\n${service.describe(task)}`;
+      const task = await service.add(reminderActor(input, locale), params.text, Date.now() + params.seconds * 1000, null);
+      return `${t(locale, 'created')}\n${service.describe(task, locale)}`;
     });
   },
 });

package/commands/remind/at/index.js

@@ -1,22 +1,23 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { reminderMessages as t } from "../../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { reminderServiceToken } from "../../../lib/runtime.js";
 import { reminderActor, replyReminder } from "../../../lib/caller.js";
 import { parseReminderInstant } from "../../../lib/service.js";
 export default defineCommand({
-    description: '创建绝对时间提醒',
-    params: { time: { type: 'string', description: '包含 Z 或 ±hh:mm 的 ISO 时间', validate: (value) => { try {
+    description: '创建绝对时间提醒', descriptionI18n: { en: "Create a reminder at an absolute time" },
+    params: { time: { type: 'string', description: '包含 Z 或 ±hh:mm 的 ISO 时间', descriptionI18n: { en: "ISO timestamp with Z or an explicit ±hh:mm offset" }, validate: (value) => { try {
                 parseReminderInstant(String(value));
                 return true;
             }
             catch {
-                return '绝对时间须为有效的 ISO 时间并包含时区 offset';
-            } } }, text: { type: 'text', min: 1, max: 500, description: '提醒内容' } },
-    async execute({ input, params, use }) {
+                return false;
+            } } }, text: { type: 'text', min: 1, max: 500, description: '提醒内容', descriptionI18n: { en: "Reminder text" } } },
+    async execute({ input, params, use, locale }) {
         return replyReminder(async () => {
             const service = use(reminderServiceToken);
-            const task = await service.add(reminderActor(input), params.text, parseReminderInstant(params.time), null);
-            return `已创建提醒\n${service.describe(task)}`;
+            const task = await service.add(reminderActor(input, locale), params.text, parseReminderInstant(params.time, locale), null);
+            return `${t(locale, 'created')}\n${service.describe(task, locale)}`;
         });
     },
 });

package/commands/remind/at/index.ts

@@ -1,16 +1,17 @@
+import { reminderMessages as t } from '../../../src/i18n.js';
 import { defineCommand, type CommandParameterValue } from 'zhin.js/command';
 import { reminderServiceToken } from '../../../src/runtime.js';
 import { reminderActor, replyReminder } from '../../../src/caller.js';
 import { parseReminderInstant } from '../../../src/service.js';
 
 export default defineCommand({
-  description: '创建绝对时间提醒',
-  params: { time: { type: 'string', description: '包含 Z 或 ±hh:mm 的 ISO 时间', validate: (value: CommandParameterValue) => { try { parseReminderInstant(String(value)); return true; } catch { return '绝对时间须为有效的 ISO 时间并包含时区 offset'; } } }, text: { type: 'text', min: 1, max: 500, description: '提醒内容' } },
-  async execute({ input, params, use }) {
+  description: '创建绝对时间提醒', descriptionI18n: { en: "Create a reminder at an absolute time" },
+  params: { time: { type: 'string', description: '包含 Z 或 ±hh:mm 的 ISO 时间', descriptionI18n: { en: "ISO timestamp with Z or an explicit ±hh:mm offset" }, validate: (value: CommandParameterValue) => { try { parseReminderInstant(String(value)); return true; } catch { return false; } } }, text: { type: 'text', min: 1, max: 500, description: '提醒内容', descriptionI18n: { en: "Reminder text" } } },
+  async execute({ input, params, use, locale }) {
     return replyReminder(async () => {
       const service = use(reminderServiceToken);
-      const task = await service.add(reminderActor(input), params.text, parseReminderInstant(params.time), null);
-      return `已创建提醒\n${service.describe(task)}`;
+      const task = await service.add(reminderActor(input, locale), params.text, parseReminderInstant(params.time, locale), null);
+      return `${t(locale, 'created')}\n${service.describe(task, locale)}`;
     });
   },
 });

package/commands/remind/cancel/index.js

@@ -1,11 +1,12 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { reminderMessages as t } from "../../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { reminderServiceToken } from "../../../lib/runtime.js";
 import { reminderActor, replyReminder } from "../../../lib/caller.js";
 export default defineCommand({
-    description: '取消本人在当前会话的提醒',
-    params: { id: { type: 'string', description: 'remind list 中的任务 ID' } },
-    async execute({ input, params, use }) {
-        return replyReminder(async () => await use(reminderServiceToken).cancel(reminderActor(input), params.id) ? '已取消提醒；已经开始的投递无法撤销' : '未找到你在此会话的提醒');
+    description: '取消本人在当前会话的提醒', descriptionI18n: { en: "Cancel your reminder in this conversation" },
+    params: { id: { type: 'string', description: 'remind list 中的任务 ID', descriptionI18n: { en: "Task ID from the reminder list" } } },
+    async execute({ input, params, use, locale }) {
+        return replyReminder(async () => await use(reminderServiceToken).cancel(reminderActor(input, locale), params.id) ? t(locale, 'cancelled') : t(locale, 'notFound'));
     },
 });

package/commands/remind/cancel/index.ts

@@ -1,11 +1,12 @@
+import { reminderMessages as t } from '../../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { reminderServiceToken } from '../../../src/runtime.js';
 import { reminderActor, replyReminder } from '../../../src/caller.js';
 
 export default defineCommand({
-  description: '取消本人在当前会话的提醒',
-  params: { id: { type: 'string', description: 'remind list 中的任务 ID' } },
-  async execute({ input, params, use }) {
-    return replyReminder(async () => await use(reminderServiceToken).cancel(reminderActor(input), params.id) ? '已取消提醒；已经开始的投递无法撤销' : '未找到你在此会话的提醒');
+  description: '取消本人在当前会话的提醒', descriptionI18n: { en: "Cancel your reminder in this conversation" },
+  params: { id: { type: 'string', description: 'remind list 中的任务 ID', descriptionI18n: { en: "Task ID from the reminder list" } } },
+  async execute({ input, params, use, locale }) {
+    return replyReminder(async () => await use(reminderServiceToken).cancel(reminderActor(input, locale), params.id) ? t(locale, 'cancelled') : t(locale, 'notFound'));
   },
 });

package/commands/remind/create/index.js

@@ -2,11 +2,11 @@
 import { defineCommand } from 'zhin.js/command';
 import { createPersonalReminder } from "../../../lib/create-reminder.js";
 const params = {
-    when: { type: 'string', optional: true, max: 200, description: '提醒时间，例如 10分钟后、明天上午九点；含空格须加引号' },
-    text: { type: 'text', optional: true, max: 500, description: '个人提醒正文；缺省时会逐步补问' },
+    when: { type: 'string', optional: true, max: 200, description: '提醒时间，例如 10分钟后、明天上午九点；含空格须加引号', descriptionI18n: { en: "Reminder time, such as in 10 minutes or tomorrow at 09:00; quote expressions containing spaces" } },
+    text: { type: 'text', optional: true, max: 500, description: '个人提醒正文；缺省时会逐步补问', descriptionI18n: { en: "Personal reminder text; missing fields are requested step by step" } },
 };
 export default defineCommand({
-    description: '逐步补全时间和正文，明确确认后创建一次性个人提醒',
+    description: '逐步补全时间和正文，明确确认后创建一次性个人提醒', descriptionI18n: { en: "Complete the time and text, then explicitly confirm a one-time personal reminder" },
     params,
     execute: context => createPersonalReminder(context, context.params),
 });

package/commands/remind/create/index.ts

@@ -3,12 +3,12 @@ import type { ReminderConfig } from '../../../src/config.js';
 import { createPersonalReminder } from '../../../src/create-reminder.js';
 
 const params = {
-  when: { type: 'string', optional: true, max: 200, description: '提醒时间，例如 10分钟后、明天上午九点；含空格须加引号' },
-  text: { type: 'text', optional: true, max: 500, description: '个人提醒正文；缺省时会逐步补问' },
+  when: { type: 'string', optional: true, max: 200, description: '提醒时间，例如 10分钟后、明天上午九点；含空格须加引号', descriptionI18n: { en: "Reminder time, such as in 10 minutes or tomorrow at 09:00; quote expressions containing spaces" } },
+  text: { type: 'text', optional: true, max: 500, description: '个人提醒正文；缺省时会逐步补问', descriptionI18n: { en: "Personal reminder text; missing fields are requested step by step" } },
 } as const;
 
 export default defineCommand<ReminderConfig, string | undefined, CommandMessage, typeof params>({
-  description: '逐步补全时间和正文，明确确认后创建一次性个人提醒',
+  description: '逐步补全时间和正文，明确确认后创建一次性个人提醒', descriptionI18n: { en: "Complete the time and text, then explicitly confirm a one-time personal reminder" },
   params,
   execute: context => createPersonalReminder(context, context.params),
 });

package/commands/remind/every/index.js

@@ -1,16 +1,17 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { reminderMessages as t } from "../../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { reminderServiceToken } from "../../../lib/runtime.js";
 import { reminderActor, replyReminder } from "../../../lib/caller.js";
 import { MAX_DELAY_SECONDS } from "../../../lib/service.js";
 export default defineCommand({
-    description: '创建固定周期提醒',
-    params: { seconds: { type: 'integer', min: 60, max: MAX_DELAY_SECONDS, description: '周期秒数（至少 60）' }, text: { type: 'text', min: 1, max: 500, description: '提醒内容' } },
-    async execute({ input, params, use }) {
+    description: '创建固定周期提醒', descriptionI18n: { en: "Create a recurring reminder with a fixed interval" },
+    params: { seconds: { type: 'integer', min: 60, max: MAX_DELAY_SECONDS, description: '周期秒数（至少 60）', descriptionI18n: { en: "Interval in seconds (at least 60)" } }, text: { type: 'text', min: 1, max: 500, description: '提醒内容', descriptionI18n: { en: "Reminder text" } } },
+    async execute({ input, params, use, locale }) {
         return replyReminder(async () => {
             const service = use(reminderServiceToken);
-            const task = await service.add(reminderActor(input), params.text, Date.now() + params.seconds * 1000, params.seconds * 1000);
-            return `已创建周期提醒\n${service.describe(task)}`;
+            const task = await service.add(reminderActor(input, locale), params.text, Date.now() + params.seconds * 1000, params.seconds * 1000);
+            return `${t(locale, 'createdPeriodic')}\n${service.describe(task, locale)}`;
         });
     },
 });

package/commands/remind/every/index.ts

@@ -1,16 +1,17 @@
+import { reminderMessages as t } from '../../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { reminderServiceToken } from '../../../src/runtime.js';
 import { reminderActor, replyReminder } from '../../../src/caller.js';
 import { MAX_DELAY_SECONDS } from '../../../src/service.js';
 
 export default defineCommand({
-  description: '创建固定周期提醒',
-  params: { seconds: { type: 'integer', min: 60, max: MAX_DELAY_SECONDS, description: '周期秒数（至少 60）' }, text: { type: 'text', min: 1, max: 500, description: '提醒内容' } },
-  async execute({ input, params, use }) {
+  description: '创建固定周期提醒', descriptionI18n: { en: "Create a recurring reminder with a fixed interval" },
+  params: { seconds: { type: 'integer', min: 60, max: MAX_DELAY_SECONDS, description: '周期秒数（至少 60）', descriptionI18n: { en: "Interval in seconds (at least 60)" } }, text: { type: 'text', min: 1, max: 500, description: '提醒内容', descriptionI18n: { en: "Reminder text" } } },
+  async execute({ input, params, use, locale }) {
     return replyReminder(async () => {
       const service = use(reminderServiceToken);
-      const task = await service.add(reminderActor(input), params.text, Date.now() + params.seconds * 1000, params.seconds * 1000);
-      return `已创建周期提醒\n${service.describe(task)}`;
+      const task = await service.add(reminderActor(input, locale), params.text, Date.now() + params.seconds * 1000, params.seconds * 1000);
+      return `${t(locale, 'createdPeriodic')}\n${service.describe(task, locale)}`;
     });
   },
 });

package/commands/remind/list/index.js

@@ -1,14 +1,15 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { reminderMessages as t } from "../../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { reminderServiceToken } from "../../../lib/runtime.js";
 import { reminderActor, replyReminder } from "../../../lib/caller.js";
 export default defineCommand({
-    description: '查看本人在当前会话的提醒',
-    async execute({ input, use }) {
+    description: '查看本人在当前会话的提醒', descriptionI18n: { en: "List your reminders in this conversation" },
+    async execute({ input, use, locale }) {
         return replyReminder(async () => {
             const service = use(reminderServiceToken);
-            const tasks = await service.list(reminderActor(input));
-            return tasks.length ? tasks.map(task => service.describe(task)).join('\n\n') : '你在此会话没有提醒任务';
+            const tasks = await service.list(reminderActor(input, locale));
+            return tasks.length ? tasks.map(task => service.describe(task, locale)).join('\n\n') : t(locale, 'empty');
         });
     },
 });

package/commands/remind/list/index.ts

@@ -1,14 +1,15 @@
+import { reminderMessages as t } from '../../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { reminderServiceToken } from '../../../src/runtime.js';
 import { reminderActor, replyReminder } from '../../../src/caller.js';
 
 export default defineCommand({
-  description: '查看本人在当前会话的提醒',
-  async execute({ input, use }) {
+  description: '查看本人在当前会话的提醒', descriptionI18n: { en: "List your reminders in this conversation" },
+  async execute({ input, use, locale }) {
     return replyReminder(async () => {
       const service = use(reminderServiceToken);
-      const tasks = await service.list(reminderActor(input));
-      return tasks.length ? tasks.map(task => service.describe(task)).join('\n\n') : '你在此会话没有提醒任务';
+      const tasks = await service.list(reminderActor(input, locale));
+      return tasks.length ? tasks.map(task => service.describe(task, locale)).join('\n\n') : t(locale, 'empty');
     });
   },
 });

package/lib/admin-i18n.d.ts

@@ -0,0 +1,155 @@
+import { type Locale } from 'zhin.js/i18n';
+import { PluginTaskError } from 'zhin.js/plugin-runtime';
+declare const catalog: {
+    readonly invalidTarget: {
+        readonly "zh-CN": "请提供完整有效的目标账号、会话、父容器和线程";
+        readonly en: "Provide a complete valid account, conversation, parent container and thread.";
+    };
+    readonly requestReused: {
+        readonly "zh-CN": "同一请求 ID 已用于其他内容";
+        readonly en: "This request ID was already used for different content.";
+    };
+    readonly invalidAction: {
+        readonly "zh-CN": "任务 ID 或操作无效";
+        readonly en: "Invalid task ID or action.";
+    };
+    readonly updateParameters: {
+        readonly "zh-CN": "仅编辑操作接受参数";
+        readonly en: "Only the update action accepts parameters.";
+    };
+    readonly finished: {
+        readonly "zh-CN": "任务已结束，不能再次取消";
+        readonly en: "This task has ended and cannot be cancelled again.";
+    };
+    readonly invalidMutation: {
+        readonly "zh-CN": "操作须包含 UUID requestId 和读取到的 expectedRevision";
+        readonly en: "The operation requires a UUID requestId and the expectedRevision read from the task list.";
+    };
+    readonly replayConflict: {
+        readonly "zh-CN": "同一操作请求 ID 已用于其他内容，禁止重放";
+        readonly en: "This operation request ID was used for different content and cannot be replayed.";
+    };
+    readonly delivering: {
+        readonly "zh-CN": "投递中或未确认；不会自动重试";
+        readonly en: "Delivery is in progress or unconfirmed; no automatic retry.";
+    };
+    readonly quota: {
+        readonly "zh-CN": "管理员提醒池已达上限，请先取消任务；聊天个人提醒使用独立配额";
+        readonly en: "The administrator reminder quota is full. Cancel a task first; chat reminders have a separate quota.";
+    };
+    readonly notFound: {
+        readonly "zh-CN": "未找到当前实例的管理员任务；聊天任务不在此入口管理";
+        readonly en: "No administrator task was found in this instance. Chat tasks are managed separately.";
+    };
+    readonly pauseState: {
+        readonly "zh-CN": "仅待执行任务可以暂停；未确认投递不能暂停或恢复";
+        readonly en: "Only scheduled tasks can be paused. Unconfirmed deliveries cannot be paused or resumed.";
+    };
+    readonly resumeState: {
+        readonly "zh-CN": "仅已暂停任务可以恢复；未确认投递不能恢复或重试";
+        readonly en: "Only paused tasks can be resumed. Unconfirmed deliveries cannot be resumed or retried.";
+    };
+    readonly expired: {
+        readonly "zh-CN": "一次性任务时间已过，请先编辑为未来时间再恢复";
+        readonly en: "This one-time reminder is past due. Set a future time before resuming.";
+    };
+    readonly updateState: {
+        readonly "zh-CN": "编辑前请先暂停任务；未确认投递不能编辑";
+        readonly en: "Pause the task before editing. Unconfirmed deliveries cannot be edited.";
+    };
+    readonly stopped: {
+        readonly "zh-CN": "管理员提醒服务属于已停止的插件实例";
+        readonly en: "This administrator reminder service belongs to a stopped plugin instance.";
+    };
+    readonly retired: {
+        readonly "zh-CN": "管理员提醒服务属于未发布或已退役的 generation";
+        readonly en: "This administrator reminder service belongs to an unpublished or retired generation.";
+    };
+    readonly invalidParameters: {
+        readonly "zh-CN": "参数须包含 1–500 字提醒内容、带 offset 的 ISO 时间及可选的 60 秒至一年整数周期";
+        readonly en: "Provide 1–500 characters of reminder text, an ISO time with an explicit offset, and optionally an integer interval from 60 seconds to one year.";
+    };
+    readonly invalidInstant: {
+        readonly "zh-CN": "提醒时间须为有效且带 Z 或 ±hh:mm 的 ISO 时间";
+        readonly en: "Use a valid ISO reminder time with Z or an explicit ±hh:mm offset.";
+    };
+    readonly future: {
+        readonly "zh-CN": "提醒时间须在未来一年内";
+        readonly en: "The reminder must be scheduled within the next year.";
+    };
+    readonly revision: {
+        readonly "zh-CN": "任务列表已变化，请刷新后重新确认操作";
+        readonly en: "The task list changed. Refresh it and confirm the operation again.";
+    };
+    readonly capacity: {
+        readonly "zh-CN": "管理员提醒池状态达到 32 条或 60 KiB 上限，请先取消并整理任务";
+        readonly en: "Administrator reminders reached the 32-task or 60 KiB limit. Cancel and clean up tasks first.";
+    };
+    readonly corrupt: {
+        readonly "zh-CN": "管理员提醒持久状态格式无效，已停止投递";
+        readonly en: "Administrator reminder storage is invalid. Delivery has stopped.";
+    };
+    readonly waiting: {
+        readonly "zh-CN": "等待执行";
+        readonly en: "Waiting to run";
+    };
+    readonly paused: {
+        readonly "zh-CN": "管理员暂停";
+        readonly en: "Paused by an administrator";
+    };
+    readonly resumedSkipping: {
+        readonly "zh-CN": "已恢复，并跳过错过的周期轮次";
+        readonly en: "Resumed; missed intervals were skipped";
+    };
+    readonly resumed: {
+        readonly "zh-CN": "管理员恢复";
+        readonly en: "Resumed by an administrator";
+    };
+    readonly edited: {
+        readonly "zh-CN": "已编辑，保持暂停；请确认后恢复";
+        readonly en: "Updated and still paused. Confirm before resuming.";
+    };
+    readonly cancelled: {
+        readonly "zh-CN": "管理员取消；已经开始的投递无法撤回";
+        readonly en: "Cancelled by an administrator. A delivery already in progress cannot be recalled.";
+    };
+    readonly skipped: {
+        readonly "zh-CN": "已跳过错过的周期轮次";
+        readonly en: "Missed intervals were skipped";
+    };
+    readonly unknown: {
+        readonly "zh-CN": "平台未确认投递，请核实目标会话后取消并另建任务；不会自动重试";
+        readonly en: "The platform did not confirm delivery. Check the target conversation, then cancel and create another task; no automatic retry.";
+    };
+    readonly delivered: {
+        readonly "zh-CN": "已确认投递";
+        readonly en: "Delivery confirmed";
+    };
+    readonly rejected: {
+        readonly "zh-CN": "平台明确未投递或拒绝；任务已停止";
+        readonly en: "The platform confirmed no delivery or rejected it. The task has stopped.";
+    };
+    readonly stateNote: {
+        readonly "zh-CN": "{detail}；状态仅表示调度事实，不代表平台连接或投递健康";
+        readonly en: "{detail}; state records scheduling facts, not platform connection or delivery health.";
+    };
+};
+export declare const adminText: (locale: Locale | undefined, key: "invalidTarget" | "requestReused" | "invalidAction" | "updateParameters" | "finished" | "invalidMutation" | "replayConflict" | "delivering" | "quota" | "notFound" | "pauseState" | "resumeState" | "expired" | "updateState" | "stopped" | "retired" | "invalidParameters" | "invalidInstant" | "future" | "revision" | "capacity" | "corrupt" | "waiting" | "paused" | "resumedSkipping" | "resumed" | "edited" | "cancelled" | "skipped" | "unknown" | "delivered" | "rejected" | "stateNote", values?: import("zhin.js").MessageValues) => string;
+export type AdminTextKey = keyof typeof catalog;
+export declare function isAdminTextKey(value: unknown): value is AdminTextKey;
+/** Persist a stable presentation key; preserve legacy text for older readers. */
+export declare function taskDetail(detailKey: AdminTextKey): {
+    detailKey: "invalidTarget" | "requestReused" | "invalidAction" | "updateParameters" | "finished" | "invalidMutation" | "replayConflict" | "delivering" | "quota" | "notFound" | "pauseState" | "resumeState" | "expired" | "updateState" | "stopped" | "retired" | "invalidParameters" | "invalidInstant" | "future" | "revision" | "capacity" | "corrupt" | "waiting" | "paused" | "resumedSkipping" | "resumed" | "edited" | "cancelled" | "skipped" | "unknown" | "delivered" | "rejected" | "stateNote";
+    detail: string;
+};
+export declare function formatTaskDetail(task: {
+    detail: string;
+    detailKey?: AdminTextKey;
+}, locale?: Locale): string;
+export declare class LocalizedTaskError extends PluginTaskError {
+    readonly messageKey: AdminTextKey;
+    constructor(code: ConstructorParameters<typeof PluginTaskError>[0], messageKey: AdminTextKey);
+    localize(locale?: Locale): PluginTaskError;
+}
+export {};
+//# sourceMappingURL=admin-i18n.d.ts.map

package/lib/admin-i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-i18n.d.ts","sourceRoot":"","sources":["../src/admin-i18n.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,QAAA,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqIH,CAAC;AACX,eAAO,MAAM,SAAS,yjBAA0B,CAAC;AACjD,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,OAAO,CAAC;AAChD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAAuE;AAE5I,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,SAAS,EAAE,YAAY;;;EAAkE;AACpH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,YAAY,CAAA;CAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5G;AAED,qBAAa,kBAAmB,SAAQ,eAAe;IACrD,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;gBACtB,IAAI,EAAE,qBAAqB,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,YAAY;IAG5F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe;CAC3C"}

package/lib/admin-i18n.js

@@ -0,0 +1,152 @@
+import { createMessages } from 'zhin.js/i18n';
+import { PluginTaskError } from 'zhin.js/plugin-runtime';
+const catalog = {
+    "invalidTarget": {
+        "zh-CN": "请提供完整有效的目标账号、会话、父容器和线程",
+        "en": "Provide a complete valid account, conversation, parent container and thread."
+    },
+    "requestReused": {
+        "zh-CN": "同一请求 ID 已用于其他内容",
+        "en": "This request ID was already used for different content."
+    },
+    "invalidAction": {
+        "zh-CN": "任务 ID 或操作无效",
+        "en": "Invalid task ID or action."
+    },
+    "updateParameters": {
+        "zh-CN": "仅编辑操作接受参数",
+        "en": "Only the update action accepts parameters."
+    },
+    "finished": {
+        "zh-CN": "任务已结束，不能再次取消",
+        "en": "This task has ended and cannot be cancelled again."
+    },
+    "invalidMutation": {
+        "zh-CN": "操作须包含 UUID requestId 和读取到的 expectedRevision",
+        "en": "The operation requires a UUID requestId and the expectedRevision read from the task list."
+    },
+    "replayConflict": {
+        "zh-CN": "同一操作请求 ID 已用于其他内容，禁止重放",
+        "en": "This operation request ID was used for different content and cannot be replayed."
+    },
+    "delivering": {
+        "zh-CN": "投递中或未确认；不会自动重试",
+        "en": "Delivery is in progress or unconfirmed; no automatic retry."
+    },
+    "quota": {
+        "zh-CN": "管理员提醒池已达上限，请先取消任务；聊天个人提醒使用独立配额",
+        "en": "The administrator reminder quota is full. Cancel a task first; chat reminders have a separate quota."
+    },
+    "notFound": {
+        "zh-CN": "未找到当前实例的管理员任务；聊天任务不在此入口管理",
+        "en": "No administrator task was found in this instance. Chat tasks are managed separately."
+    },
+    "pauseState": {
+        "zh-CN": "仅待执行任务可以暂停；未确认投递不能暂停或恢复",
+        "en": "Only scheduled tasks can be paused. Unconfirmed deliveries cannot be paused or resumed."
+    },
+    "resumeState": {
+        "zh-CN": "仅已暂停任务可以恢复；未确认投递不能恢复或重试",
+        "en": "Only paused tasks can be resumed. Unconfirmed deliveries cannot be resumed or retried."
+    },
+    "expired": {
+        "zh-CN": "一次性任务时间已过，请先编辑为未来时间再恢复",
+        "en": "This one-time reminder is past due. Set a future time before resuming."
+    },
+    "updateState": {
+        "zh-CN": "编辑前请先暂停任务；未确认投递不能编辑",
+        "en": "Pause the task before editing. Unconfirmed deliveries cannot be edited."
+    },
+    "stopped": {
+        "zh-CN": "管理员提醒服务属于已停止的插件实例",
+        "en": "This administrator reminder service belongs to a stopped plugin instance."
+    },
+    "retired": {
+        "zh-CN": "管理员提醒服务属于未发布或已退役的 generation",
+        "en": "This administrator reminder service belongs to an unpublished or retired generation."
+    },
+    "invalidParameters": {
+        "zh-CN": "参数须包含 1–500 字提醒内容、带 offset 的 ISO 时间及可选的 60 秒至一年整数周期",
+        "en": "Provide 1–500 characters of reminder text, an ISO time with an explicit offset, and optionally an integer interval from 60 seconds to one year."
+    },
+    "invalidInstant": {
+        "zh-CN": "提醒时间须为有效且带 Z 或 ±hh:mm 的 ISO 时间",
+        "en": "Use a valid ISO reminder time with Z or an explicit ±hh:mm offset."
+    },
+    "future": {
+        "zh-CN": "提醒时间须在未来一年内",
+        "en": "The reminder must be scheduled within the next year."
+    },
+    "revision": {
+        "zh-CN": "任务列表已变化，请刷新后重新确认操作",
+        "en": "The task list changed. Refresh it and confirm the operation again."
+    },
+    "capacity": {
+        "zh-CN": "管理员提醒池状态达到 32 条或 60 KiB 上限，请先取消并整理任务",
+        "en": "Administrator reminders reached the 32-task or 60 KiB limit. Cancel and clean up tasks first."
+    },
+    "corrupt": {
+        "zh-CN": "管理员提醒持久状态格式无效，已停止投递",
+        "en": "Administrator reminder storage is invalid. Delivery has stopped."
+    },
+    "waiting": {
+        "zh-CN": "等待执行",
+        "en": "Waiting to run"
+    },
+    "paused": {
+        "zh-CN": "管理员暂停",
+        "en": "Paused by an administrator"
+    },
+    "resumedSkipping": {
+        "zh-CN": "已恢复，并跳过错过的周期轮次",
+        "en": "Resumed; missed intervals were skipped"
+    },
+    "resumed": {
+        "zh-CN": "管理员恢复",
+        "en": "Resumed by an administrator"
+    },
+    "edited": {
+        "zh-CN": "已编辑，保持暂停；请确认后恢复",
+        "en": "Updated and still paused. Confirm before resuming."
+    },
+    "cancelled": {
+        "zh-CN": "管理员取消；已经开始的投递无法撤回",
+        "en": "Cancelled by an administrator. A delivery already in progress cannot be recalled."
+    },
+    "skipped": {
+        "zh-CN": "已跳过错过的周期轮次",
+        "en": "Missed intervals were skipped"
+    },
+    "unknown": {
+        "zh-CN": "平台未确认投递，请核实目标会话后取消并另建任务；不会自动重试",
+        "en": "The platform did not confirm delivery. Check the target conversation, then cancel and create another task; no automatic retry."
+    },
+    "delivered": {
+        "zh-CN": "已确认投递",
+        "en": "Delivery confirmed"
+    },
+    "rejected": {
+        "zh-CN": "平台明确未投递或拒绝；任务已停止",
+        "en": "The platform confirmed no delivery or rejected it. The task has stopped."
+    },
+    "stateNote": {
+        "zh-CN": "{detail}；状态仅表示调度事实，不代表平台连接或投递健康",
+        "en": "{detail}; state records scheduling facts, not platform connection or delivery health."
+    }
+};
+export const adminText = createMessages(catalog);
+export function isAdminTextKey(value) { return typeof value === 'string' && Object.hasOwn(catalog, value); }
+/** Persist a stable presentation key; preserve legacy text for older readers. */
+export function taskDetail(detailKey) { return { detailKey, detail: adminText('zh-CN', detailKey) }; }
+export function formatTaskDetail(task, locale) {
+    return task.detailKey ? adminText(locale, task.detailKey) : task.detail;
+}
+export class LocalizedTaskError extends PluginTaskError {
+    messageKey;
+    constructor(code, messageKey) {
+        super(code, adminText('zh-CN', messageKey));
+        this.messageKey = messageKey;
+    }
+    localize(locale) { return new PluginTaskError(this.code, adminText(locale, this.messageKey)); }
+}
+//# sourceMappingURL=admin-i18n.js.map

package/lib/admin-i18n.js.map

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