@zhin.js/plugin-ledger 1.0.1 → 1.0.3

package/README.md

@@ -73,6 +73,24 @@ ledger:
 
 发送 `记账日报 开启` 订阅。插件每分钟检查一次，按 `timezone` 到达 `reportTime` 后给订阅者私信当天的合计和分类明细，每人每天最多一次；当天没有记账时默认不发送。在群里开启时会先私信一条确认，私信失败则不开启并提示先私聊 Bot。在 `reportTime` 之后开启的，从第二天开始发送。投递失败只记录日志，当天不重试。
 
+## Agent 工具与技能
+
+启用 `@zhin.js/tool` 与 `@zhin.js/skill` Feature 后，本插件提供 `ledger` 技能与以下工具（按当前发送者隔离，群聊遵守同样的金额隐私策略）：
+
+| 工具 | 权限/属性 | 说明 |
+| --- | --- | --- |
+| `ledger_add` | `requiresApproval: 'always'` | 记录一笔个人支出（`category`、`amount`、可选 `note`） |
+| `ledger_summary` | `readOnly: true` | 查看 `today` / `week` / `month` 的消费汇总（`summary`）或分类统计（`categories`） |
+| `ledger_list` | `readOnly: true` | 查看指定时间段内的账单明细与编号（`#seq`） |
+| `ledger_delete` | `requiresApproval: 'always'` | 按编号 `seq` 删除当前发送者自己的账目 |
+
+## Console 页面与 RPC
+
+启用 `@zhin.js/page` Feature 后，插件暴露声明式页面 `pages/index/index.ts` 与 Console RPC：
+
+- `status`（`ledger:read`）：返回日报订阅人数、订阅状态摘要（`ownerKey`、`reportLocale`、`lastReportDate`）与运行配置，不暴露个人消费明细或金额。
+- `run-daily-reports`（`ledger:write`）：立即触发一次当日日报检查与投递。
+
 ## 开发
 
 ```bash
@@ -82,3 +100,9 @@ pnpm --filter @zhin.js/plugin-ledger test
 ```
 
 测试使用 `@zhin.js/testing` 的 `FakePlugin` 与 `FakeClock`，覆盖金额与输入解析、用户隔离、群聊隐私、删除权限、时区下的日/周/月边界和日报调度。
+
+## 语言
+
+指令反馈跟随当前发送者语言；英文环境的时间范围为 `today / week / month / all`，日报操作为 `on / off / status`，中文环境仍使用对应中文输入。命令路径与已有别名保持不变，提示中的调用头由当前 Endpoint 的实际前缀及插件命名空间生成。
+
+每日日报在开启时固定语言，之后修改个人偏好不改变已开启日报。旧数据库的日报仍按中文发送，启动时仅增补声明的可空语言列。语言不改变配置时区、人民币金额格式或群聊金额隐私。

package/commands/ledger-add/index.js

@@ -1,16 +1,18 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { resolveLocale } from 'zhin.js/i18n';
+import { messages as t } from "../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { ledgerCaller, replyLedger } from "../../lib/identity.js";
 import { ledgerServiceToken } from "../../lib/runtime.js";
 export default defineCommand({
-    description: '记一笔消费：记 <类别> <金额> [备注]',
+    description: '记一笔消费：记 <类别> <金额> [备注]', descriptionI18n: { en: "Record an expense with a category, amount and optional note" },
     alias: ['记'],
     params: {
-        entry: { type: 'text', min: 1, max: 200, description: '类别 金额 [备注]，例如：午饭 18.5 和同事' },
+        entry: { type: 'text', min: 1, max: 200, description: '类别 金额 [备注]，例如：午饭 18.5 和同事', descriptionI18n: { en: "Category, amount and optional note, such as Lunch 18.5 With colleagues" } },
     },
-    async execute({ input, params, use }) {
+    async execute({ input, params, use, locale, formatCommand }) {
         return replyLedger(async () => {
-            const caller = ledgerCaller(input);
+            const caller = ledgerCaller(input, locale);
             return use(ledgerServiceToken).addEntry(caller, params.entry);
         });
     },

package/commands/ledger-add/index.ts

@@ -1,16 +1,18 @@
+import { resolveLocale } from 'zhin.js/i18n';
+import { messages as t } from '../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { ledgerCaller, replyLedger } from '../../src/identity.js';
 import { ledgerServiceToken } from '../../src/runtime.js';
 
 export default defineCommand({
-  description: '记一笔消费：记 <类别> <金额> [备注]',
+  description: '记一笔消费：记 <类别> <金额> [备注]', descriptionI18n: { en: "Record an expense with a category, amount and optional note" },
   alias: ['记'],
   params: {
-    entry: { type: 'text', min: 1, max: 200, description: '类别 金额 [备注]，例如：午饭 18.5 和同事' },
+    entry: { type: 'text', min: 1, max: 200, description: '类别 金额 [备注]，例如：午饭 18.5 和同事', descriptionI18n: { en: "Category, amount and optional note, such as Lunch 18.5 With colleagues" } },
   },
-  async execute({ input, params, use }) {
+  async execute({ input, params, use, locale, formatCommand }) {
     return replyLedger(async () => {
-      const caller = ledgerCaller(input);
+      const caller = ledgerCaller(input, locale);
       return use(ledgerServiceToken).addEntry(caller, params.entry);
     });
   },

package/commands/ledger-delete/index.js

@@ -1,16 +1,18 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { resolveLocale } from 'zhin.js/i18n';
+import { messages as t } from "../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { ledgerCaller, replyLedger } from "../../lib/identity.js";
 import { ledgerServiceToken } from "../../lib/runtime.js";
 export default defineCommand({
-    description: '删除自己的一笔记账：删账 <编号>',
+    description: '删除自己的一笔记账：删账 <编号>', descriptionI18n: { en: "Delete one of your expense records" },
     alias: ['删账'],
     params: {
-        id: { type: 'integer', min: 1, description: '账目编号（记账回复或「账单」中的 #编号）' },
+        id: { type: 'integer', min: 1, description: '账目编号（记账回复或「账单」中的 #编号）', descriptionI18n: { en: "Record ID from the expense list" } },
     },
-    async execute({ input, params, use }) {
+    async execute({ input, params, use, locale, formatCommand }) {
         return replyLedger(async () => {
-            const caller = ledgerCaller(input);
+            const caller = ledgerCaller(input, locale);
             return use(ledgerServiceToken).deleteEntry(caller, params.id);
         });
     },

package/commands/ledger-delete/index.ts

@@ -1,16 +1,18 @@
+import { resolveLocale } from 'zhin.js/i18n';
+import { messages as t } from '../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { ledgerCaller, replyLedger } from '../../src/identity.js';
 import { ledgerServiceToken } from '../../src/runtime.js';
 
 export default defineCommand({
-  description: '删除自己的一笔记账：删账 <编号>',
+  description: '删除自己的一笔记账：删账 <编号>', descriptionI18n: { en: "Delete one of your expense records" },
   alias: ['删账'],
   params: {
-    id: { type: 'integer', min: 1, description: '账目编号（记账回复或「账单」中的 #编号）' },
+    id: { type: 'integer', min: 1, description: '账目编号（记账回复或「账单」中的 #编号）', descriptionI18n: { en: "Record ID from the expense list" } },
   },
-  async execute({ input, params, use }) {
+  async execute({ input, params, use, locale, formatCommand }) {
     return replyLedger(async () => {
-      const caller = ledgerCaller(input);
+      const caller = ledgerCaller(input, locale);
       return use(ledgerServiceToken).deleteEntry(caller, params.id);
     });
   },

package/commands/ledger-list/index.js

@@ -1,20 +1,22 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { resolveLocale } from 'zhin.js/i18n';
+import { messages as t } from "../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { ledgerCaller, replyLedger } from "../../lib/identity.js";
 import { parsePeriodWord } from "../../lib/period.js";
 import { ledgerServiceToken } from "../../lib/runtime.js";
 export default defineCommand({
-    description: '列出账目及编号（最新 20 笔）：账单 [今日|本周|本月|全部]，默认本月',
+    description: '列出账目及编号（最新 20 笔）：账单 [今日|本周|本月|全部]，默认本月', descriptionI18n: { en: "List the latest 20 expense records with IDs; defaults to the current month" },
     alias: ['账单'],
     params: {
-        period: { type: 'word', optional: true, description: '今日、本周、本月或全部' },
+        period: { type: 'word', optional: true, description: '今日、本周、本月或全部', descriptionI18n: { en: "Today, this week, this month, or all time" } },
     },
-    async execute({ input, params, use }) {
+    async execute({ input, params, use, locale, formatCommand }) {
         return replyLedger(async () => {
-            const caller = ledgerCaller(input);
-            const period = parsePeriodWord(params.period, 'month');
+            const caller = ledgerCaller(input, locale);
+            const period = parsePeriodWord(params.period, 'month', locale);
             if (!period)
-                return '时间范围只能是：今日、本周、本月、全部';
+                return t(locale, 'periodInput');
             return use(ledgerServiceToken).listEntries(caller, period);
         });
     },

package/commands/ledger-list/index.ts

@@ -1,19 +1,21 @@
+import { resolveLocale } from 'zhin.js/i18n';
+import { messages as t } from '../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { ledgerCaller, replyLedger } from '../../src/identity.js';
 import { parsePeriodWord } from '../../src/period.js';
 import { ledgerServiceToken } from '../../src/runtime.js';
 
 export default defineCommand({
-  description: '列出账目及编号（最新 20 笔）：账单 [今日|本周|本月|全部]，默认本月',
+  description: '列出账目及编号（最新 20 笔）：账单 [今日|本周|本月|全部]，默认本月', descriptionI18n: { en: "List the latest 20 expense records with IDs; defaults to the current month" },
   alias: ['账单'],
   params: {
-    period: { type: 'word', optional: true, description: '今日、本周、本月或全部' },
+    period: { type: 'word', optional: true, description: '今日、本周、本月或全部', descriptionI18n: { en: "Today, this week, this month, or all time" } },
   },
-  async execute({ input, params, use }) {
+  async execute({ input, params, use, locale, formatCommand }) {
     return replyLedger(async () => {
-      const caller = ledgerCaller(input);
-      const period = parsePeriodWord(params.period, 'month');
-      if (!period) return '时间范围只能是：今日、本周、本月、全部';
+      const caller = ledgerCaller(input, locale);
+      const period = parsePeriodWord(params.period, 'month', locale);
+      if (!period) return t(locale, 'periodInput');
       return use(ledgerServiceToken).listEntries(caller, period);
     });
   },

package/commands/ledger-month/index.js

@@ -1,13 +1,15 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { resolveLocale } from 'zhin.js/i18n';
+import { messages as t } from "../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { ledgerCaller, replyLedger } from "../../lib/identity.js";
 import { ledgerServiceToken } from "../../lib/runtime.js";
 export default defineCommand({
-    description: '查看本月消费合计与分类明细',
+    description: '查看本月消费合计与分类明细', descriptionI18n: { en: "View this month's spending totals and categories" },
     alias: ['本月消费'],
-    async execute({ input, use }) {
+    async execute({ input, use, locale, formatCommand }) {
         return replyLedger(async () => {
-            const caller = ledgerCaller(input);
+            const caller = ledgerCaller(input, locale);
             return use(ledgerServiceToken).periodSummary(caller, 'month');
         });
     },

package/commands/ledger-month/index.ts

@@ -1,13 +1,15 @@
+import { resolveLocale } from 'zhin.js/i18n';
+import { messages as t } from '../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { ledgerCaller, replyLedger } from '../../src/identity.js';
 import { ledgerServiceToken } from '../../src/runtime.js';
 
 export default defineCommand({
-  description: '查看本月消费合计与分类明细',
+  description: '查看本月消费合计与分类明细', descriptionI18n: { en: "View this month's spending totals and categories" },
   alias: ['本月消费'],
-  async execute({ input, use }) {
+  async execute({ input, use, locale, formatCommand }) {
     return replyLedger(async () => {
-      const caller = ledgerCaller(input);
+      const caller = ledgerCaller(input, locale);
       return use(ledgerServiceToken).periodSummary(caller, 'month');
     });
   },

package/commands/ledger-report/index.js

@@ -1,23 +1,23 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { resolveLocale } from 'zhin.js/i18n';
+import { messages as t } from "../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { ledgerCaller, replyLedger } from "../../lib/identity.js";
 import { ledgerServiceToken } from "../../lib/runtime.js";
-const ACTIONS = {
-    开启: 'on',
-    关闭: 'off',
-    状态: 'status',
-};
 export default defineCommand({
-    description: '订阅或取消每日私信记账日报：记账日报 [开启|关闭|状态]',
+    description: '订阅或取消每日私信记账日报：记账日报 [开启|关闭|状态]', descriptionI18n: { en: "Manage the daily expense report sent by private message" },
     alias: ['记账日报'],
     params: {
-        action: { type: 'word', optional: true, choices: ['开启', '关闭', '状态'], description: '开启、关闭或状态（默认状态）' },
+        action: { type: 'word', optional: true, description: '开启、关闭或状态（默认状态）', descriptionI18n: { en: "on, off, or status (default: status)" } },
     },
-    async execute({ input, params, use }) {
+    async execute({ input, params, use, locale, formatCommand }) {
         return replyLedger(async () => {
-            const caller = ledgerCaller(input);
-            const action = ACTIONS[params.action ?? '状态'] ?? 'status';
-            return use(ledgerServiceToken).dailyReport(caller, action);
+            const caller = ledgerCaller(input, locale);
+            const actions = resolveLocale(locale) === 'en' ? { on: 'on', off: 'off', status: 'status' } : { 开启: 'on', 关闭: 'off', 状态: 'status' };
+            const action = params.action === undefined ? 'status' : actions[params.action];
+            if (!action)
+                return t(locale, 'actionInput');
+            return use(ledgerServiceToken).dailyReport(caller, action, formatCommand('ledger-report'));
         });
     },
 });

package/commands/ledger-report/index.ts

@@ -1,25 +1,23 @@
+import { resolveLocale } from 'zhin.js/i18n';
+import { messages as t } from '../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { ledgerCaller, replyLedger } from '../../src/identity.js';
 import { ledgerServiceToken } from '../../src/runtime.js';
 import type { DailyReportAction } from '../../src/service.js';
 
-const ACTIONS: Readonly<Record<string, DailyReportAction>> = {
-  开启: 'on',
-  关闭: 'off',
-  状态: 'status',
-};
-
 export default defineCommand({
-  description: '订阅或取消每日私信记账日报：记账日报 [开启|关闭|状态]',
+  description: '订阅或取消每日私信记账日报：记账日报 [开启|关闭|状态]', descriptionI18n: { en: "Manage the daily expense report sent by private message" },
   alias: ['记账日报'],
   params: {
-    action: { type: 'word', optional: true, choices: ['开启', '关闭', '状态'], description: '开启、关闭或状态（默认状态）' },
+    action: { type: 'word', optional: true, description: '开启、关闭或状态（默认状态）', descriptionI18n: { en: "on, off, or status (default: status)" } },
   },
-  async execute({ input, params, use }) {
+  async execute({ input, params, use, locale, formatCommand }) {
     return replyLedger(async () => {
-      const caller = ledgerCaller(input);
-      const action = ACTIONS[params.action ?? '状态'] ?? 'status';
-      return use(ledgerServiceToken).dailyReport(caller, action);
+      const caller = ledgerCaller(input, locale);
+      const actions: Readonly<Record<string, DailyReportAction>> = resolveLocale(locale) === 'en' ? { on: 'on', off: 'off', status: 'status' } : { 开启: 'on', 关闭: 'off', 状态: 'status' };
+      const action = params.action === undefined ? 'status' : actions[params.action];
+      if (!action) return t(locale, 'actionInput');
+      return use(ledgerServiceToken).dailyReport(caller, action, formatCommand('ledger-report'));
     });
   },
 });

package/commands/ledger-stats/index.js

@@ -1,20 +1,22 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { resolveLocale } from 'zhin.js/i18n';
+import { messages as t } from "../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { ledgerCaller, replyLedger } from "../../lib/identity.js";
 import { parsePeriodWord } from "../../lib/period.js";
 import { ledgerServiceToken } from "../../lib/runtime.js";
 export default defineCommand({
-    description: '按类别统计合计、笔数、平均、最大与占比：分类统计 [今日|本周|本月|全部]，默认本月',
+    description: '按类别统计合计、笔数、平均、最大与占比：分类统计 [今日|本周|本月|全部]，默认本月', descriptionI18n: { en: "Category totals, counts, averages, maxima and proportions; defaults to the current month" },
     alias: ['分类统计'],
     params: {
-        period: { type: 'word', optional: true, description: '今日、本周、本月或全部' },
+        period: { type: 'word', optional: true, description: '今日、本周、本月或全部', descriptionI18n: { en: "Today, this week, this month, or all time" } },
     },
-    async execute({ input, params, use }) {
+    async execute({ input, params, use, locale, formatCommand }) {
         return replyLedger(async () => {
-            const caller = ledgerCaller(input);
-            const period = parsePeriodWord(params.period, 'month');
+            const caller = ledgerCaller(input, locale);
+            const period = parsePeriodWord(params.period, 'month', locale);
             if (!period)
-                return '时间范围只能是：今日、本周、本月、全部';
+                return t(locale, 'periodInput');
             return use(ledgerServiceToken).categoryStatistics(caller, period);
         });
     },

package/commands/ledger-stats/index.ts

@@ -1,19 +1,21 @@
+import { resolveLocale } from 'zhin.js/i18n';
+import { messages as t } from '../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { ledgerCaller, replyLedger } from '../../src/identity.js';
 import { parsePeriodWord } from '../../src/period.js';
 import { ledgerServiceToken } from '../../src/runtime.js';
 
 export default defineCommand({
-  description: '按类别统计合计、笔数、平均、最大与占比：分类统计 [今日|本周|本月|全部]，默认本月',
+  description: '按类别统计合计、笔数、平均、最大与占比：分类统计 [今日|本周|本月|全部]，默认本月', descriptionI18n: { en: "Category totals, counts, averages, maxima and proportions; defaults to the current month" },
   alias: ['分类统计'],
   params: {
-    period: { type: 'word', optional: true, description: '今日、本周、本月或全部' },
+    period: { type: 'word', optional: true, description: '今日、本周、本月或全部', descriptionI18n: { en: "Today, this week, this month, or all time" } },
   },
-  async execute({ input, params, use }) {
+  async execute({ input, params, use, locale, formatCommand }) {
     return replyLedger(async () => {
-      const caller = ledgerCaller(input);
-      const period = parsePeriodWord(params.period, 'month');
-      if (!period) return '时间范围只能是：今日、本周、本月、全部';
+      const caller = ledgerCaller(input, locale);
+      const period = parsePeriodWord(params.period, 'month', locale);
+      if (!period) return t(locale, 'periodInput');
       return use(ledgerServiceToken).categoryStatistics(caller, period);
     });
   },

package/commands/ledger-today/index.js

@@ -1,13 +1,15 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { resolveLocale } from 'zhin.js/i18n';
+import { messages as t } from "../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { ledgerCaller, replyLedger } from "../../lib/identity.js";
 import { ledgerServiceToken } from "../../lib/runtime.js";
 export default defineCommand({
-    description: '查看今日消费合计与分类明细',
+    description: '查看今日消费合计与分类明细', descriptionI18n: { en: "View today's spending totals and categories" },
     alias: ['今日消费'],
-    async execute({ input, use }) {
+    async execute({ input, use, locale, formatCommand }) {
         return replyLedger(async () => {
-            const caller = ledgerCaller(input);
+            const caller = ledgerCaller(input, locale);
             return use(ledgerServiceToken).periodSummary(caller, 'today');
         });
     },

package/commands/ledger-today/index.ts

@@ -1,13 +1,15 @@
+import { resolveLocale } from 'zhin.js/i18n';
+import { messages as t } from '../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { ledgerCaller, replyLedger } from '../../src/identity.js';
 import { ledgerServiceToken } from '../../src/runtime.js';
 
 export default defineCommand({
-  description: '查看今日消费合计与分类明细',
+  description: '查看今日消费合计与分类明细', descriptionI18n: { en: "View today's spending totals and categories" },
   alias: ['今日消费'],
-  async execute({ input, use }) {
+  async execute({ input, use, locale, formatCommand }) {
     return replyLedger(async () => {
-      const caller = ledgerCaller(input);
+      const caller = ledgerCaller(input, locale);
       return use(ledgerServiceToken).periodSummary(caller, 'today');
     });
   },

package/commands/ledger-week/index.js

@@ -1,13 +1,15 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { resolveLocale } from 'zhin.js/i18n';
+import { messages as t } from "../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { ledgerCaller, replyLedger } from "../../lib/identity.js";
 import { ledgerServiceToken } from "../../lib/runtime.js";
 export default defineCommand({
-    description: '查看本周（周一至周日）消费合计与分类明细',
+    description: '查看本周（周一至周日）消费合计与分类明细', descriptionI18n: { en: "View this week's spending totals and categories (Monday through Sunday)" },
     alias: ['本周消费'],
-    async execute({ input, use }) {
+    async execute({ input, use, locale, formatCommand }) {
         return replyLedger(async () => {
-            const caller = ledgerCaller(input);
+            const caller = ledgerCaller(input, locale);
             return use(ledgerServiceToken).periodSummary(caller, 'week');
         });
     },

package/commands/ledger-week/index.ts

@@ -1,13 +1,15 @@
+import { resolveLocale } from 'zhin.js/i18n';
+import { messages as t } from '../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { ledgerCaller, replyLedger } from '../../src/identity.js';
 import { ledgerServiceToken } from '../../src/runtime.js';
 
 export default defineCommand({
-  description: '查看本周（周一至周日）消费合计与分类明细',
+  description: '查看本周（周一至周日）消费合计与分类明细', descriptionI18n: { en: "View this week's spending totals and categories (Monday through Sunday)" },
   alias: ['本周消费'],
-  async execute({ input, use }) {
+  async execute({ input, use, locale, formatCommand }) {
     return replyLedger(async () => {
-      const caller = ledgerCaller(input);
+      const caller = ledgerCaller(input, locale);
       return use(ledgerServiceToken).periodSummary(caller, 'week');
     });
   },

package/lib/config.d.ts

@@ -5,11 +5,17 @@ export declare const ledgerConfig: Schema<Schema.InputRecord<{
     timezone: Schema<string, string> & Schema.Present;
     reportTime: Schema<string, string> & Schema.Present;
     reportWhenEmpty: Schema<boolean, boolean> & Schema.Present;
-}>, {
-    timezone: string;
-    reportTime: string;
-    reportWhenEmpty: boolean;
-} & {}>;
+}>, Schema.RecordTypes<{
+    timezone: Schema<string, string> & Schema.Present;
+    reportTime: Schema<string, string> & Schema.Present;
+    reportWhenEmpty: Schema<boolean, boolean> & Schema.Present;
+}>> & {
+    readonly output?: Schema.RecordTypes<{
+        timezone: Schema<string, string> & Schema.Present;
+        reportTime: Schema<string, string> & Schema.Present;
+        reportWhenEmpty: Schema<boolean, boolean> & Schema.Present;
+    }> | undefined;
+};
 export type LedgerConfig = Schema.Output<typeof ledgerConfig>;
 export interface ResolvedLedgerConfig {
     readonly timezone: string;

package/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAChD,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAE3C,eAAO,MAAM,YAAY;;;;;;;;OAIvB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,YAAY,CAAC,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAaD,kGAAkG;AAClG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,GAAG,oBAAoB,CAOnG"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAChD,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAE3C,eAAO,MAAM,YAAY;;;;;;;;;;;;;;CAIvB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,YAAY,CAAC,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAaD,kGAAkG;AAClG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,GAAG,oBAAoB,CAOnG"}

package/lib/config.js

@@ -2,9 +2,9 @@ import { Schema } from 'zhin.js';
 export const DEFAULT_TIMEZONE = 'Asia/Shanghai';
 export const DEFAULT_REPORT_TIME = '22:00';
 export const ledgerConfig = Schema.object({
-    timezone: Schema.string().default(DEFAULT_TIMEZONE).description('计算今日、本周（周一开始）、本月与日报日期所用的 IANA 时区').effect('reload'),
-    reportTime: Schema.string().default(DEFAULT_REPORT_TIME).description('记账日报的发送时间（HH:MM，按 timezone）；只发给用「记账日报 开启」订阅的用户').effect('reload'),
-    reportWhenEmpty: Schema.boolean().default(false).description('当天没有记账时是否仍发送日报').effect('reload'),
+    timezone: Schema.string().default(DEFAULT_TIMEZONE).description('计算今日、本周（周一开始）、本月与日报日期所用的 IANA 时区').i18n({ "en": { "description": "IANA timezone used to calculate today, this week (starting Monday), this month and daily-report dates." } }).effect('reload'),
+    reportTime: Schema.string().default(DEFAULT_REPORT_TIME).description('记账日报的发送时间（HH:MM，按 timezone）；只发给用「记账日报 开启」订阅的用户').i18n({ "en": { "description": "Daily ledger report time (HH:MM in timezone); sent only to users who explicitly subscribed to daily reports." } }).effect('reload'),
+    reportWhenEmpty: Schema.boolean().default(false).description('当天没有记账时是否仍发送日报').i18n({ "en": { "description": "Send a daily report even when no transactions were recorded that day." } }).effect('reload'),
 });
 const REPORT_TIME_PATTERN = /^(?:[01]\d|2[0-3]):[0-5]\d$/u;
 function assertTimezone(timezone) {

package/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAChD,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAE3C,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,WAAW,CAAC,kCAAkC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACpH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,WAAW,CAAC,gDAAgD,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACvI,eAAe,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;CAChG,CAAC,CAAC;AAUH,MAAM,mBAAmB,GAAG,8BAA8B,CAAC;AAE3D,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,CAAC;QACH,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,QAAQ,CAAC,IAAI,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,uBAAuB,CAAC,CAAC;QACxH,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,SAAS,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,mBAAmB,CAAC,MAAyC;IAC3E,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,IAAI,gBAAgB,CAAC;IACtD,MAAM,UAAU,GAAG,MAAM,EAAE,UAAU,IAAI,mBAAmB,CAAC;IAC7D,MAAM,eAAe,GAAG,MAAM,EAAE,eAAe,IAAI,KAAK,CAAC;IACzD,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzB,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,2BAA2B,UAAU,EAAE,CAAC,CAAC;IACxG,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;AACnD,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAChD,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAE3C,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,WAAW,CAAC,kCAAkC,CAAC,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,EAAC,aAAa,EAAE,wGAAwG,EAAC,EAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC5P,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,WAAW,CAAC,gDAAgD,CAAC,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,EAAC,aAAa,EAAE,8GAA8G,EAAC,EAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACrR,eAAe,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,EAAC,aAAa,EAAE,uEAAuE,EAAC,EAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;CACvM,CAAC,CAAC;AAUH,MAAM,mBAAmB,GAAG,8BAA8B,CAAC;AAE3D,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,CAAC;QACH,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,QAAQ,CAAC,IAAI,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,uBAAuB,CAAC,CAAC;QACxH,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,SAAS,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,mBAAmB,CAAC,MAAyC;IAC3E,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,IAAI,gBAAgB,CAAC;IACtD,MAAM,UAAU,GAAG,MAAM,EAAE,UAAU,IAAI,mBAAmB,CAAC;IAC7D,MAAM,eAAe,GAAG,MAAM,EAAE,eAAe,IAAI,KAAK,CAAC;IACzD,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzB,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,2BAA2B,UAAU,EAAE,CAAC,CAAC;IACxG,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;AACnD,CAAC"}

package/lib/console.d.ts

@@ -0,0 +1,4 @@
+import { type PluginConsoleRpc } from 'zhin.js';
+import type { LedgerService } from './service.js';
+export declare function createLedgerConsoleRpc(service?: LedgerService): PluginConsoleRpc;
+//# sourceMappingURL=console.d.ts.map

package/lib/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../src/console.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EAEtB,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAalD,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,gBAAgB,CA0BhF"}

package/lib/console.js

@@ -0,0 +1,39 @@
+import { definePluginConsoleRpc, PluginConsoleRpcError, } from 'zhin.js';
+import { ledgerServiceToken } from './runtime.js';
+function resolveService(provided, call) {
+    if (provided)
+        return provided;
+    const runtimeWithUse = call.runtime;
+    const fromRuntime = runtimeWithUse?.use?.(ledgerServiceToken);
+    if (fromRuntime)
+        return fromRuntime;
+    throw new PluginConsoleRpcError('unavailable', '记账服务尚未就绪');
+}
+export function createLedgerConsoleRpc(service) {
+    const rpc = definePluginConsoleRpc({
+        status: {
+            page: 'index',
+            requiredPermissions: ['ledger:read'],
+            async handler(_input, call) {
+                return resolveService(service, call).getConsoleSnapshot();
+            },
+        },
+        actions: {
+            'run-daily-reports': {
+                page: 'index',
+                requiredPermissions: ['ledger:write'],
+                async handler(_input, call) {
+                    const sent = await resolveService(service, call).runDailyReports();
+                    return { sent };
+                },
+            },
+        },
+    });
+    const methods = rpc.methods;
+    const originalGet = methods.get.bind(methods);
+    const originalHas = methods.has.bind(methods);
+    methods.get = (key) => originalGet(key === 'runDailyReports' ? 'run-daily-reports' : key);
+    methods.has = (key) => originalHas(key === 'runDailyReports' ? 'run-daily-reports' : key);
+    return rpc;
+}
+//# sourceMappingURL=console.js.map

package/lib/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../src/console.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GAGtB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,SAAS,cAAc,CACrB,QAAmC,EACnC,IAA0B;IAE1B,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,cAAc,GAAG,IAAI,CAAC,OAAoF,CAAC;IACjH,MAAM,WAAW,GAAG,cAAc,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,CAAC;IAC9D,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,MAAM,IAAI,qBAAqB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAuB;IAC5D,MAAM,GAAG,GAAG,sBAAsB,CAAC;QACjC,MAAM,EAAE;YACN,IAAI,EAAE,OAAO;YACb,mBAAmB,EAAE,CAAC,aAAa,CAAC;YACpC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI;gBACxB,OAAO,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,kBAAkB,EAAE,CAAC;YAC5D,CAAC;SACF;QACD,OAAO,EAAE;YACP,mBAAmB,EAAE;gBACnB,IAAI,EAAE,OAAO;gBACb,mBAAmB,EAAE,CAAC,cAAc,CAAC;gBACrC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI;oBACxB,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;oBACnE,OAAO,EAAE,IAAI,EAAE,CAAC;gBAClB,CAAC;aACF;SACF;KACF,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,GAAG,CAAC,OAAsE,CAAC;IAC3F,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,KAAK,iBAAiB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClG,OAAO,CAAC,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,KAAK,iBAAiB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClG,OAAO,GAAG,CAAC;AACb,CAAC"}

package/lib/entry-input.d.ts

@@ -1,6 +1,7 @@
+import { type Locale } from 'zhin.js/i18n';
 export declare const MAX_CATEGORY_LENGTH = 20;
 export declare const MAX_NOTE_LENGTH = 100;
-export declare const ADD_USAGE = "\u683C\u5F0F\uFF1A\u8BB0 <\u7C7B\u522B> <\u91D1\u989D> [\u5907\u6CE8]\uFF0C\u4F8B\u5982\uFF1A\u8BB0 \u5348\u996D 18.5 \u548C\u540C\u4E8B";
+export declare const ADD_USAGE: string;
 export interface ParsedEntryInput {
     readonly category: string;
     readonly amountCents: number;
@@ -14,5 +15,5 @@ export type EntryInputResult = {
     readonly reason: string;
 };
 /** Parses the text after `记`: category, amount, then an optional free-form note. */
-export declare function parseEntryInput(text: string): EntryInputResult;
+export declare function parseEntryInput(text: string, locale?: Locale): EntryInputResult;
 //# sourceMappingURL=entry-input.d.ts.map

package/lib/entry-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entry-input.d.ts","sourceRoot":"","sources":["../src/entry-input.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,eAAO,MAAM,SAAS,6IAAyC,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAMpD,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAgB9D"}
+{"version":3,"file":"entry-input.d.ts","sourceRoot":"","sources":["../src/entry-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAI1D,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,eAAO,MAAM,SAAS,QAAsB,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAMpD,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAiB/E"}