@zhin.js/plugin-ledger 1.0.0 → 1.0.2

package/src/i18n.ts

@@ -0,0 +1,200 @@
+import { createMessages } from 'zhin.js/i18n';
+
+export const messages = createMessages({
+  "actor": {
+    "zh-CN": "记账需要在真实会话中由具体用户发送",
+    "en": "Ledger commands require a real user in a conversation."
+  },
+  "usage": {
+    "zh-CN": "格式：<类别> <金额> [备注]，例如：午饭 18.5 和同事",
+    "en": "Format: <category> <amount> [note], for example: Lunch 18.5 With colleagues"
+  },
+  "order": {
+    "zh-CN": "类别要写在金额前面。{usage}",
+    "en": "Put the category before the amount. {usage}"
+  },
+  "amountError": {
+    "zh-CN": "{reason}。{usage}",
+    "en": "{reason} {usage}"
+  },
+  "categoryNumber": {
+    "zh-CN": "类别不能是数字。{usage}",
+    "en": "The category cannot be a number. {usage}"
+  },
+  "categoryLimit": {
+    "zh-CN": "类别最多 {max} 个字",
+    "en": "Category limit: {max} characters."
+  },
+  "noteLimit": {
+    "zh-CN": "备注最多 {max} 个字",
+    "en": "Note limit: {max} characters."
+  },
+  "negative": {
+    "zh-CN": "金额不能为负数",
+    "en": "Amount cannot be negative."
+  },
+  "amountFormat": {
+    "zh-CN": "金额格式不正确，请写成 18 或 18.50（最多两位小数）",
+    "en": "Use an amount such as 18 or 18.50, with at most two decimal places."
+  },
+  "zero": {
+    "zh-CN": "金额必须大于 0",
+    "en": "Amount must be greater than zero."
+  },
+  "amountMax": {
+    "zh-CN": "单笔金额不能超过 ¥1000000.00",
+    "en": "A single entry cannot exceed ¥1000000.00."
+  },
+  "period.today": {
+    "zh-CN": "今日",
+    "en": "Today"
+  },
+  "period.week": {
+    "zh-CN": "本周",
+    "en": "This week"
+  },
+  "period.month": {
+    "zh-CN": "本月",
+    "en": "This month"
+  },
+  "period.all": {
+    "zh-CN": "全部",
+    "en": "All time"
+  },
+  "allRecords": {
+    "zh-CN": "全部记录",
+    "en": "All records"
+  },
+  "periodInput": {
+    "zh-CN": "时间范围只能是：今日、本周、本月、全部",
+    "en": "Choose a period: today, week, month, all."
+  },
+  "actionInput": {
+    "zh-CN": "操作只能是：开启、关闭、状态",
+    "en": "Choose an action: on, off, status."
+  },
+  "added": {
+    "zh-CN": "✅ 已记账 #{seq} · {category} {amount}{note}",
+    "en": "✅ Recorded #{seq} · {category} {amount}{note}"
+  },
+  "notFound": {
+    "zh-CN": "没有找到你的账目 #{seq}（只能删除自己的记账，请查看账单编号）",
+    "en": "Your entry #{seq} was not found. You can only delete your own entries; check the entry list for its ID."
+  },
+  "deleted": {
+    "zh-CN": "🗑️ 已删除 #{seq} · {category} {amount}",
+    "en": "🗑️ Deleted #{seq} · {category} {amount}"
+  },
+  "spending": {
+    "zh-CN": "{period}消费",
+    "en": "{period} spending"
+  },
+  "statistics": {
+    "zh-CN": "分类统计",
+    "en": "Category statistics"
+  },
+  "entryList": {
+    "zh-CN": "{period}账单",
+    "en": "{period} entries"
+  },
+  "privateSent": {
+    "zh-CN": "🔒 {title}已私信发送给你",
+    "en": "🔒 {title} was sent to you privately."
+  },
+  "privateFallback": {
+    "zh-CN": "{text}\n（群聊中金额已隐藏，私聊我可查看完整金额）",
+    "en": "{text}\n(Amounts are hidden in public chats. Message me privately to view them.)"
+  },
+  "reportEnabled": {
+    "zh-CN": "记账日报已开启：每天 {time}（{timezone}）私信发送当天消费",
+    "en": "Daily reports are enabled: today’s spending is sent privately at {time} ({timezone})."
+  },
+  "reportDisabled": {
+    "zh-CN": "记账日报未开启。",
+    "en": "Daily reports are disabled."
+  },
+  "reportOff": {
+    "zh-CN": "已关闭记账日报",
+    "en": "Daily reports disabled."
+  },
+  "noPrivate": {
+    "zh-CN": "当前环境不支持主动私信，无法开启记账日报",
+    "en": "This environment cannot send proactive private messages; daily reports cannot be enabled."
+  },
+  "reportOn": {
+    "zh-CN": "已开启记账日报：每天 {time}（{timezone}）私信发送当天消费。",
+    "en": "Daily reports enabled: today’s spending is sent privately at {time} ({timezone})."
+  },
+  "cannotPrivate": {
+    "zh-CN": "无法私信你，请先私聊我后再开启记账日报。",
+    "en": "I could not message you privately. Message me privately before enabling daily reports."
+  },
+  "reportOnPrivate": {
+    "zh-CN": "🔒 已开启记账日报，确认消息已私信发送给你",
+    "en": "🔒 Daily reports enabled; confirmation was sent to you privately."
+  },
+  "report": {
+    "zh-CN": "🌙 记账日报\n{text}",
+    "en": "🌙 Daily expense report\n{text}"
+  },
+  "commandHint": {
+    "zh-CN": "发送「{command}」。",
+    "en": "Send \"{command}\"."
+  },
+  "emptySummary": {
+    "zh-CN": "📒 {period}还没有记账（{range}）",
+    "en": "📒 {period}: no expenses recorded ({range})."
+  },
+  "summaryHeader": {
+    "zh-CN": "📒 {period}消费（{range}）",
+    "en": "📒 {period} spending ({range})"
+  },
+  "total": {
+    "zh-CN": "合计 {amount} · {count} 笔",
+    "en": "Total {amount} · {count} entries"
+  },
+  "categoryFull": {
+    "zh-CN": "· {category} {amount}（{count} 笔，{share}%）",
+    "en": "· {category} {amount} ({count} entries, {share}%)"
+  },
+  "categoryMasked": {
+    "zh-CN": "· {category} {amount}（{count} 笔）",
+    "en": "· {category} {amount} ({count} entries)"
+  },
+  "emptyStats": {
+    "zh-CN": "📊 {period}没有可统计的记账（{range}）",
+    "en": "📊 {period}: no entries to analyze ({range})."
+  },
+  "statsHeader": {
+    "zh-CN": "📊 分类统计 · {period}（{range}）",
+    "en": "📊 Category statistics · {period} ({range})"
+  },
+  "statsFull": {
+    "zh-CN": "· {category}：合计 {amount}，{count} 笔，平均 {average}，最大 {max}，占比 {share}%",
+    "en": "· {category}: total {amount}, {count} entries, average {average}, largest {max}, share {share}%"
+  },
+  "statsMasked": {
+    "zh-CN": "· {category}：{count} 笔，金额已隐藏",
+    "en": "· {category}: {count} entries, amounts hidden"
+  },
+  "categoryCount": {
+    "zh-CN": "共 {count} 个类别",
+    "en": "{count} categories"
+  },
+  "categoryCountTotal": {
+    "zh-CN": "共 {count} 个类别 · 合计 {amount}",
+    "en": "{count} categories · total {amount}"
+  },
+  "emptyList": {
+    "zh-CN": "🧾 {period}没有账目（{range}）",
+    "en": "🧾 {period}: no entries ({range})."
+  },
+  "listHeader": {
+    "zh-CN": "🧾 {period}账单（{range}）",
+    "en": "🧾 {period} entries ({range})"
+  },
+  "more": {
+    "zh-CN": "……另有 {count} 笔未显示",
+    "en": "… {count} more entries not shown"
+  }
+});

package/src/identity.ts

@@ -1,3 +1,5 @@
+import { resolveLocale, type Locale } from 'zhin.js/i18n';
+import { messages as t } from './i18n.js';
 import { createDeliveryTarget, type DeliveryTarget } from 'zhin.js';
 import type { CommandMessage } from 'zhin.js/command';
 
@@ -5,6 +7,7 @@ import type { CommandMessage } from 'zhin.js/command';
 export interface LedgerCaller {
   /** Stable per-user key: adapter + endpoint (bot account) + sender id. */
   readonly ownerKey: string;
+  readonly locale?: Locale;
   readonly senderId: string;
   /** The conversation the command came from. */
   readonly conversation: DeliveryTarget;
@@ -21,9 +24,9 @@ export function ledgerOwnerKey(adapter: string, endpointId: string, senderId: st
 }
 
 /** Builds the caller from a command message; commands without a real sender are refused. */
-export function ledgerCaller(input: CommandMessage | undefined): LedgerCaller {
+export function ledgerCaller(input: CommandMessage | undefined, locale: Locale = resolveLocale(input?.locale)): LedgerCaller {
   const senderId = input?.sender?.id;
-  if (!input || !senderId) throw new LedgerInputError('记账需要在真实会话中由具体用户发送');
+  if (!input || !senderId) throw new LedgerInputError(t(locale, 'actor'));
   const conversation = createDeliveryTarget(input);
   const endpoint = conversation.endpoint;
   const isPrivate = conversation.kind === 'private';
@@ -33,6 +36,7 @@ export function ledgerCaller(input: CommandMessage | undefined): LedgerCaller {
   return {
     ownerKey: ledgerOwnerKey(endpoint.adapter, endpoint.id, senderId),
     senderId,
+    locale,
     conversation,
     privateTarget,
     isPrivate,

package/src/index.ts

@@ -26,4 +26,4 @@ export {
 } from './report-format.js';
 export { ledgerServiceToken } from './runtime.js';
 export { LedgerService, type DailyReportAction, type LedgerServiceOptions } from './service.js';
-export { defineLedgerTables, LedgerStore, ENTRY_TABLE, USER_TABLE, type LedgerEntry, type LedgerUserRecord } from './store.js';
+export { defineLedgerTables, LedgerStore, ENTRY_TABLE, USER_TABLE, PRIVATE_TARGET_TABLE, type LedgerEntry, type LedgerUserRecord } from './store.js';

package/src/money.ts

@@ -1,3 +1,5 @@
+import { resolveLocale, type Locale } from 'zhin.js/i18n';
+import { messages as t } from './i18n.js';
 /**
  * Amounts are stored as integer cents (分) and parsed from text without floating point,
  * so 0.1 + 0.2 style rounding errors cannot enter the ledger.
@@ -28,17 +30,17 @@ function invalid(reason: string): AmountParseResult {
 }
 
 /** Parses `18`, `18.5`, `18.50`, `¥18.5` or `18.5元` into cents; rejects negatives, zero, exponents and more than two decimals. */
-export function parseAmountToCents(raw: string): AmountParseResult {
+export function parseAmountToCents(raw: string, locale?: Locale): AmountParseResult {
   const normalized = toHalfWidth(raw.trim());
   const withoutCurrency = normalized.replace(CURRENCY_PREFIX, '').replace(CURRENCY_SUFFIX, '').trim();
-  if (withoutCurrency.startsWith('-')) return invalid('金额不能为负数');
+  if (withoutCurrency.startsWith('-')) return invalid(t(locale, 'negative'));
   const match = AMOUNT_PATTERN.exec(withoutCurrency);
-  if (!match) return invalid('金额格式不正确，请写成 18 或 18.50（最多两位小数）');
+  if (!match) return invalid(t(locale, 'amountFormat'));
   const wholeYuan = Number(match[1]);
   const fractionDigits = (match[2] ?? '').padEnd(2, '0');
   const cents = wholeYuan * 100 + Number(fractionDigits);
-  if (cents === 0) return invalid('金额必须大于 0');
-  if (cents > MAX_ENTRY_CENTS) return invalid('单笔金额不能超过 ¥1000000.00');
+  if (cents === 0) return invalid(t(locale, 'zero'));
+  if (cents > MAX_ENTRY_CENTS) return invalid(t(locale, 'amountMax'));
   return { ok: true, cents };
 }
 

package/src/period.ts

@@ -1,3 +1,5 @@
+import { resolveLocale, type Locale } from 'zhin.js/i18n';
+import { messages as t } from './i18n.js';
 /**
  * Calendar periods evaluated in the configured IANA timezone. Entries are compared by their
  * local calendar date (YYYY-MM-DD), so daylight-saving shifts never move an entry into another day.
@@ -7,21 +9,13 @@ export type LedgerPeriod = 'today' | 'week' | 'month' | 'all';
 
 const DAY_MS = 86_400_000;
 
-const PERIOD_LABELS: Readonly<Record<LedgerPeriod, string>> = {
-  today: '今日',
-  week: '本周',
-  month: '本月',
-  all: '全部',
-};
-
-export function periodLabel(period: LedgerPeriod): string {
-  return PERIOD_LABELS[period];
-}
+export function periodLabel(period: LedgerPeriod, locale?: Locale): string { return t(locale, `period.${period}`); }
 
 /** Maps a user-typed period word to a period; undefined when the word is not recognised. */
-export function parsePeriodWord(word: string | undefined, fallback: LedgerPeriod): LedgerPeriod | undefined {
+export function parsePeriodWord(word: string | undefined, fallback: LedgerPeriod, locale?: Locale): LedgerPeriod | undefined {
   if (word === undefined || word.trim() === '') return fallback;
   const normalized = word.trim();
+  if (resolveLocale(locale) === 'en') return ['today', 'week', 'month', 'all'].includes(normalized.toLowerCase()) ? normalized.toLowerCase() as LedgerPeriod : undefined;
   if (normalized === '今日' || normalized === '今天') return 'today';
   if (normalized === '本周' || normalized === '这周') return 'week';
   if (normalized === '本月' || normalized === '这个月') return 'month';
@@ -89,7 +83,7 @@ export function isInPeriod(entryMs: number, nowMs: number, period: LedgerPeriod,
 }
 
 /** Human-readable range for a period header, e.g. `2026-10-19 ~ 2026-10-25`. */
-export function describePeriodRange(nowMs: number, period: LedgerPeriod, timeZone: string): string {
+export function describePeriodRange(nowMs: number, period: LedgerPeriod, timeZone: string, locale?: Locale): string {
   const today = localDateKey(nowMs, timeZone);
   if (period === 'today') return today;
   if (period === 'month') return today.slice(0, 7);
@@ -97,5 +91,5 @@ export function describePeriodRange(nowMs: number, period: LedgerPeriod, timeZon
     const start = weekStartKey(today);
     return `${start} ~ ${weekEndKey(start)}`;
   }
-  return '全部记录';
+  return t(locale, 'allRecords');
 }

package/src/report-format.ts

@@ -1,3 +1,5 @@
+import { resolveLocale, type Locale } from 'zhin.js/i18n';
+import { messages as t } from './i18n.js';
 import { formatCents, MASKED_AMOUNT } from './money.js';
 import { describePeriodRange, localDateKey, periodLabel, type LedgerPeriod } from './period.js';
 import type { LedgerEntry } from './store.js';
@@ -39,12 +41,12 @@ export function totalsByCategory(entries: readonly LedgerEntry[]): CategoryTotal
   return totals;
 }
 
-export function summarize(entries: readonly LedgerEntry[], period: LedgerPeriod, nowMs: number, timeZone: string): PeriodSummary {
+export function summarize(entries: readonly LedgerEntry[], period: LedgerPeriod, nowMs: number, timeZone: string, locale?: Locale): PeriodSummary {
   let totalCents = 0;
   for (const entry of entries) totalCents += entry.amountCents;
   return {
     period,
-    range: describePeriodRange(nowMs, period, timeZone),
+    range: describePeriodRange(nowMs, period, timeZone, locale),
     totalCents,
     count: entries.length,
     categories: totalsByCategory(entries),
@@ -58,56 +60,56 @@ function sharePercent(partCents: number, totalCents: number): string {
   return `${Math.floor(tenths / 10)}.${tenths % 10}`;
 }
 
-export function formatPeriodSummary(summary: PeriodSummary): LedgerReply {
-  const label = periodLabel(summary.period);
+export function formatPeriodSummary(summary: PeriodSummary, locale?: Locale): LedgerReply {
+  const label = periodLabel(summary.period, locale);
   if (summary.count === 0) {
-    const empty = `📒 ${label}还没有记账（${summary.range}）`;
+    const empty = t(locale, 'emptySummary', { period: label, range: summary.range });
     return { full: empty, masked: empty };
   }
-  const header = `📒 ${label}消费（${summary.range}）`;
-  const fullLines = [header, `合计 ${formatCents(summary.totalCents)} · ${summary.count} 笔`];
-  const maskedLines = [header, `合计 ${MASKED_AMOUNT} · ${summary.count} 笔`];
+  const header = t(locale, 'summaryHeader', { period: label, range: summary.range });
+  const fullLines = [header, t(locale, 'total', { amount: formatCents(summary.totalCents), count: summary.count })];
+  const maskedLines = [header, t(locale, 'total', { amount: MASKED_AMOUNT, count: summary.count })];
   for (const category of summary.categories) {
     const share = sharePercent(category.totalCents, summary.totalCents);
-    fullLines.push(`· ${category.category} ${formatCents(category.totalCents)}（${category.count} 笔，${share}%）`);
-    maskedLines.push(`· ${category.category} ${MASKED_AMOUNT}（${category.count} 笔）`);
+    fullLines.push(t(locale, 'categoryFull', { category: category.category, amount: formatCents(category.totalCents), count: category.count, share }));
+    maskedLines.push(t(locale, 'categoryMasked', { category: category.category, amount: MASKED_AMOUNT, count: category.count }));
   }
   return { full: fullLines.join('\n'), masked: maskedLines.join('\n') };
 }
 
-export function formatCategoryStatistics(summary: PeriodSummary): LedgerReply {
-  const label = periodLabel(summary.period);
+export function formatCategoryStatistics(summary: PeriodSummary, locale?: Locale): LedgerReply {
+  const label = periodLabel(summary.period, locale);
   if (summary.count === 0) {
-    const empty = `📊 ${label}没有可统计的记账（${summary.range}）`;
+    const empty = t(locale, 'emptyStats', { period: label, range: summary.range });
     return { full: empty, masked: empty };
   }
-  const header = `📊 分类统计 · ${label}（${summary.range}）`;
+  const header = t(locale, 'statsHeader', { period: label, range: summary.range });
   const fullLines = [header];
   const maskedLines = [header];
   for (const category of summary.categories) {
     const averageCents = Math.round(category.totalCents / category.count);
     const share = sharePercent(category.totalCents, summary.totalCents);
-    fullLines.push(`· ${category.category}：合计 ${formatCents(category.totalCents)}，${category.count} 笔，平均 ${formatCents(averageCents)}，最大 ${formatCents(category.largestCents)}，占比 ${share}%`);
-    maskedLines.push(`· ${category.category}：${category.count} 笔，金额已隐藏`);
+    fullLines.push(t(locale, 'statsFull', { category: category.category, amount: formatCents(category.totalCents), count: category.count, average: formatCents(averageCents), max: formatCents(category.largestCents), share }));
+    maskedLines.push(t(locale, 'statsMasked', { category: category.category, count: category.count }));
   }
-  fullLines.push(`共 ${summary.categories.length} 个类别 · 合计 ${formatCents(summary.totalCents)}`);
-  maskedLines.push(`共 ${summary.categories.length} 个类别`);
+  fullLines.push(t(locale, 'categoryCountTotal', { count: summary.categories.length, amount: formatCents(summary.totalCents) }));
+  maskedLines.push(t(locale, 'categoryCount', { count: summary.categories.length }));
   return { full: fullLines.join('\n'), masked: maskedLines.join('\n') };
 }
 
 export const MAX_LISTED_ENTRIES = 20;
 
 /** Newest first, with `#id` so users can find what to delete. */
-export function formatEntryList(entries: readonly LedgerEntry[], period: LedgerPeriod, nowMs: number, timeZone: string): LedgerReply {
-  const label = periodLabel(period);
-  const range = describePeriodRange(nowMs, period, timeZone);
+export function formatEntryList(entries: readonly LedgerEntry[], period: LedgerPeriod, nowMs: number, timeZone: string, locale?: Locale): LedgerReply {
+  const label = periodLabel(period, locale);
+  const range = describePeriodRange(nowMs, period, timeZone, locale);
   if (entries.length === 0) {
-    const empty = `🧾 ${label}没有账目（${range}）`;
+    const empty = t(locale, 'emptyList', { period: label, range });
     return { full: empty, masked: empty };
   }
   const newestFirst = [...entries].sort((left, right) => right.createdAt - left.createdAt || right.seq - left.seq);
   const shown = newestFirst.slice(0, MAX_LISTED_ENTRIES);
-  const header = `🧾 ${label}账单（${range}）`;
+  const header = t(locale, 'listHeader', { period: label, range });
   const fullLines = [header];
   const maskedLines = [header];
   for (const entry of shown) {
@@ -117,7 +119,7 @@ export function formatEntryList(entries: readonly LedgerEntry[], period: LedgerP
     maskedLines.push(`#${entry.seq} ${date} ${entry.category} ${MASKED_AMOUNT}`);
   }
   if (newestFirst.length > shown.length) {
-    const more = `……另有 ${newestFirst.length - shown.length} 笔未显示`;
+    const more = t(locale, 'more', { count: newestFirst.length - shown.length });
     fullLines.push(more);
     maskedLines.push(more);
   }

package/src/service.ts

@@ -1,4 +1,6 @@
-import { getLogger, type OutboundHost, type PluginDatabaseHost } from 'zhin.js';
+import { resolveLocale, type Locale } from 'zhin.js/i18n';
+import { messages as t } from './i18n.js';
+import { getLogger, type DeliveryTarget, type OutboundHost, type PluginDatabaseHost } from 'zhin.js';
 import type { ResolvedLedgerConfig } from './config.js';
 import { parseEntryInput } from './entry-input.js';
 import type { LedgerCaller } from './identity.js';
@@ -36,6 +38,8 @@ export class LedgerService {
   readonly #now: () => number;
   /** Serialises writes per user so two quick `记` commands never share an `#id`. */
   readonly #userQueues = new Map<string, Promise<unknown>>();
+  /** Private targets already saved this process, to skip redundant writes. */
+  readonly #knownPrivate = new Map<string, string>();
 
   constructor(database: PluginDatabaseHost, outbound: OutboundHost | undefined, config: ResolvedLedgerConfig, options: LedgerServiceOptions = {}) {
     this.#store = new LedgerStore(database);
@@ -55,8 +59,31 @@ export class LedgerService {
     return next;
   }
 
+  /**
+   * Some platforms (Discord, Lark, Slack, ...) address a private chat by a conversation id that is
+   * not the user id. When the user talks to the bot in private we save that real conversation and
+   * use it for later private deliveries; until then the user id is the best available guess.
+   */
+  async #rememberPrivate(caller: LedgerCaller): Promise<void> {
+    if (!caller.isPrivate) return;
+    const raw = JSON.stringify(caller.conversation);
+    if (this.#knownPrivate.get(caller.ownerKey) === raw) return;
+    try {
+      await this.#store.setPrivateTarget(caller.ownerKey, caller.conversation);
+      this.#knownPrivate.set(caller.ownerKey, raw);
+    } catch (error) {
+      logger.warn(`saving private target failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+
+  async #privateTargetOf(caller: LedgerCaller): Promise<DeliveryTarget> {
+    if (caller.isPrivate) return caller.conversation;
+    return (await this.#store.getPrivateTarget(caller.ownerKey)) ?? caller.privateTarget;
+  }
+
   async addEntry(caller: LedgerCaller, text: string): Promise<string> {
-    const parsed = parseEntryInput(text);
+    await this.#rememberPrivate(caller);
+    const parsed = parseEntryInput(text, caller.locale);
     if (!parsed.ok) return parsed.reason;
     const { category, amountCents, note } = parsed.entry;
     const seq = await this.#withUserLock(caller.ownerKey, async () => {
@@ -73,16 +100,17 @@ export class LedgerService {
     });
     const amount = caller.isPrivate ? formatCents(amountCents) : MASKED_AMOUNT;
     const noteText = note ? ` · ${note}` : '';
-    return `✅ 已记账 #${seq} · ${category} ${amount}${noteText}`;
+    return t(caller.locale, 'added', { seq, category, amount, note: noteText });
   }
 
   async deleteEntry(caller: LedgerCaller, seq: number): Promise<string> {
+    await this.#rememberPrivate(caller);
     return this.#withUserLock(caller.ownerKey, async () => {
       const entry = await this.#store.findEntry(caller.ownerKey, seq);
-      if (!entry) return `没有找到你的账目 #${seq}（只能删除自己的记账，可用「账单」查看编号）`;
+      if (!entry) return t(caller.locale, 'notFound', { seq });
       await this.#store.deleteEntry(caller.ownerKey, seq);
       const amount = caller.isPrivate ? formatCents(entry.amountCents) : MASKED_AMOUNT;
-      return `🗑️ 已删除 #${seq} · ${entry.category} ${amount}`;
+      return t(caller.locale, 'deleted', { seq, category: entry.category, amount });
     });
   }
 
@@ -94,36 +122,39 @@ export class LedgerService {
 
   async periodSummary(caller: LedgerCaller, period: LedgerPeriod): Promise<string> {
     const entries = await this.#entriesIn(caller.ownerKey, period);
-    const reply = formatPeriodSummary(summarize(entries, period, this.#now(), this.#config.timezone));
-    return this.#deliver(caller, reply, `${periodLabel(period)}消费`);
+    const reply = formatPeriodSummary(summarize(entries, period, this.#now(), this.#config.timezone, caller.locale), caller.locale);
+    return this.#deliver(caller, reply, t(caller.locale, 'spending', { period: periodLabel(period, caller.locale) }));
   }
 
   async categoryStatistics(caller: LedgerCaller, period: LedgerPeriod): Promise<string> {
     const entries = await this.#entriesIn(caller.ownerKey, period);
-    const reply = formatCategoryStatistics(summarize(entries, period, this.#now(), this.#config.timezone));
-    return this.#deliver(caller, reply, '分类统计');
+    const reply = formatCategoryStatistics(summarize(entries, period, this.#now(), this.#config.timezone, caller.locale), caller.locale);
+    return this.#deliver(caller, reply, t(caller.locale, 'statistics'));
   }
 
   async listEntries(caller: LedgerCaller, period: LedgerPeriod): Promise<string> {
     const entries = await this.#entriesIn(caller.ownerKey, period);
-    const reply = formatEntryList(entries, period, this.#now(), this.#config.timezone);
-    return this.#deliver(caller, reply, `${periodLabel(period)}账单`);
+    const reply = formatEntryList(entries, period, this.#now(), this.#config.timezone, caller.locale);
+    return this.#deliver(caller, reply, t(caller.locale, 'entryList', { period: periodLabel(period, caller.locale) }));
   }
 
   /** Private chat: full reply. Group/channel: try a private message, else the masked reply. */
   async #deliver(caller: LedgerCaller, reply: LedgerReply, title: string): Promise<string> {
-    if (caller.isPrivate) return reply.full;
+    if (caller.isPrivate) {
+      await this.#rememberPrivate(caller);
+      return reply.full;
+    }
     if (reply.full === reply.masked) return reply.full;
     const delivered = await this.#sendPrivately(caller, reply.full);
-    if (delivered) return `🔒 ${title}已私信发送给你`;
-    return `${reply.masked}\n（群聊中金额已隐藏，私聊我可查看完整金额）`;
+    if (delivered) return t(caller.locale, 'privateSent', { title });
+    return t(caller.locale, 'privateFallback', { text: reply.masked });
   }
 
   async #sendPrivately(caller: LedgerCaller, content: string): Promise<boolean> {
     const sendTarget = this.#outbound?.sendTarget;
     if (!sendTarget) return false;
     try {
-      await sendTarget.call(this.#outbound, caller.privateTarget, content);
+      await sendTarget.call(this.#outbound, await this.#privateTargetOf(caller), content, { locale: resolveLocale(caller.locale) });
       return true;
     } catch (error) {
       logger.debug(`private delivery unavailable: ${error instanceof Error ? error.message : String(error)}`);
@@ -131,29 +162,31 @@ export class LedgerService {
     }
   }
 
-  async dailyReport(caller: LedgerCaller, action: DailyReportAction): Promise<string> {
+  async dailyReport(caller: LedgerCaller, action: DailyReportAction, commandHead?: string): Promise<string> {
+    await this.#rememberPrivate(caller);
+    const hint = (action: 'on' | 'off') => commandHead ? t(caller.locale, 'commandHint', { command: `${commandHead} ${resolveLocale(caller.locale) === 'en' ? action : action === 'on' ? '开启' : '关闭'}` }) : '';
     const reportTime = this.#config.reportTime;
     const user = await this.#store.getUser(caller.ownerKey);
     if (action === 'status') {
-      if (user?.reportEnabled) return `记账日报已开启：每天 ${reportTime}（${this.#config.timezone}）私信发送当天消费`;
-      return '记账日报未开启。发送「记账日报 开启」订阅';
+      if (user?.reportEnabled) return t(caller.locale, 'reportEnabled', { time: reportTime, timezone: this.#config.timezone });
+      return [t(caller.locale, 'reportDisabled'), hint('on')].filter(Boolean).join(' ');
     }
     if (action === 'off') {
       await this.#store.setReport(caller.ownerKey, false, undefined, user?.lastReportDate ?? '');
-      return '已关闭记账日报';
+      return t(caller.locale, 'reportOff');
     }
-    if (!this.#outbound?.sendTarget) return '当前环境不支持主动私信，无法开启记账日报';
-    const confirmation = `已开启记账日报：每天 ${reportTime}（${this.#config.timezone}）私信发送当天消费。发送「记账日报 关闭」取消`;
+    if (!this.#outbound?.sendTarget) return t(caller.locale, 'noPrivate');
+    const confirmation = [t(caller.locale, 'reportOn', { time: reportTime, timezone: this.#config.timezone }), hint('off')].filter(Boolean).join(' ');
     if (!caller.isPrivate) {
       const reachable = await this.#sendPrivately(caller, confirmation);
-      if (!reachable) return '无法私信你，请先私聊我后再发送「记账日报 开启」';
+      if (!reachable) return [t(caller.locale, 'cannotPrivate'), hint('on')].filter(Boolean).join(' ');
     }
     const nowMs = this.#now();
     const today = localDateKey(nowMs, this.#config.timezone);
     const alreadyPastReportTime = localTimeKey(nowMs, this.#config.timezone) >= reportTime;
     const lastReportDate = alreadyPastReportTime ? today : '';
-    await this.#store.setReport(caller.ownerKey, true, caller.privateTarget, lastReportDate);
-    return caller.isPrivate ? confirmation : '🔒 已开启记账日报，确认消息已私信发送给你';
+    await this.#store.setReport(caller.ownerKey, true, await this.#privateTargetOf(caller), lastReportDate, resolveLocale(caller.locale));
+    return caller.isPrivate ? confirmation : t(caller.locale, 'reportOnPrivate');
   }
 
   /**
@@ -174,9 +207,9 @@ export class LedgerService {
       if (!subscriber.reportTarget || !this.#outbound?.sendTarget) continue;
       const entries = await this.#entriesIn(subscriber.ownerKey, 'today');
       if (entries.length === 0 && !this.#config.reportWhenEmpty) continue;
-      const summary = formatPeriodSummary(summarize(entries, 'today', nowMs, timezone));
+      const summary = formatPeriodSummary(summarize(entries, 'today', nowMs, timezone, subscriber.reportLocale), subscriber.reportLocale);
       try {
-        await this.#outbound.sendTarget(subscriber.reportTarget, `🌙 记账日报\n${summary.full}`);
+        await this.#outbound.sendTarget(subscriber.reportTarget, t(subscriber.reportLocale, 'report', { text: summary.full }), { locale: resolveLocale(subscriber.reportLocale) });
         sent += 1;
       } catch (error) {
         logger.warn(`daily report delivery failed: ${error instanceof Error ? error.message : String(error)}`);