@zhin.js/plugin-group-suite 1.1.14 → 1.1.16

package/skills/checkin/tools/checkin_query/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from '../../../../src/i18n.js';
 import { conversationKey, toolGroupConversation } from '../../../../src/conversation-scope.js';
 import { defineAgentTool } from '@zhin.js/tool';
 import { getCheckinModel } from '../../../../src/db-store.js';
@@ -18,7 +19,7 @@ export default defineAgentTool<{ user_id?: string; group_id?: string }>({
   async execute({ user_id: userId, group_id: requestedGroupId }, context) {
     const runtime = context.use(groupSuiteRuntimeToken);
     const model = getCheckinModel(runtime.db);
-    if (!model) return '签到数据库尚未就绪';
+    if (!model) return t(context.locale, 'checkinDb');
     const groupId = conversationKey(toolGroupConversation(context, requestedGroupId));
     const query = {
       ...(userId ? { user_id: userId } : {}),
@@ -26,12 +27,12 @@ export default defineAgentTool<{ user_id?: string; group_id?: string }>({
     };
     const rows = await model.select().where(query);
     if (userId) {
-      if (rows.length === 0) return `用户 ${userId} 没有签到记录`;
+      if (rows.length === 0) return t(context.locale, 'userCheckinEmpty', { user: userId });
       const user = rows[0]!;
-      return `${String(user.user_name ?? userId)}: 积分=${Number(user.points ?? 0)}, 累计=${Number(user.total_checkins ?? 0)}天, 连续=${Number(user.streak ?? 0)}天, 最长=${Number(user.max_streak ?? 0)}天, 上次=${String(user.last_checkin ?? '')}`;
+      return t(context.locale, 'userCheckinInfo', { name: String(user.user_name ?? userId), points: Number(user.points ?? 0), total: Number(user.total_checkins ?? 0), streak: Number(user.streak ?? 0), max: Number(user.max_streak ?? 0), last: String(user.last_checkin ?? '') });
     }
     const totalPoints = rows.reduce((sum, user) => sum + Number(user.points ?? 0), 0);
     const todayCount = rows.filter((user) => user.last_checkin === todayStr()).length;
-    return `签到系统统计\n总用户: ${rows.length}\n总积分: ${totalPoints}\n今日签到: ${todayCount}人`;
+    return t(context.locale, 'checkinOverview', { users: rows.length, points: totalPoints, today: todayCount });
   },
 });

package/skills/checkin/tools/checkin_rank/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../lib/i18n.js";
 import { conversationKey, toolGroupConversation } from "../../../../lib/conversation-scope.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { getCheckinModel } from "../../../../lib/db-store.js";
@@ -17,7 +18,7 @@ export default defineAgentTool({
     async execute({ limit, group_id: requestedGroupId }, context) {
         const model = getCheckinModel(context.use(groupSuiteRuntimeToken).db);
         if (!model)
-            return '签到数据库尚未就绪';
+            return t(context.locale, 'checkinDb');
         const groupId = conversationKey(toolGroupConversation(context, requestedGroupId));
         const rows = await model.select().where({ context_type: 'group', context_id: groupId });
         const count = Math.min(Math.max(Number(limit) || 10, 1), 50);
@@ -25,7 +26,7 @@ export default defineAgentTool({
             .sort((left, right) => Number(right.points ?? 0) - Number(left.points ?? 0))
             .slice(0, count);
         if (ranked.length === 0)
-            return '暂无排行数据';
-        return ranked.map((user, index) => `${index + 1}. ${String(user.user_name ?? user.user_id)} — ${Number(user.points ?? 0)}分 (连续${Number(user.streak ?? 0)}天)`).join('\n');
+            return t(context.locale, 'rankEmpty');
+        return ranked.map((user, index) => t(context.locale, 'pointsToolRow', { rank: index + 1, name: String(user.user_name ?? user.user_id), points: Number(user.points ?? 0), days: Number(user.streak ?? 0) })).join('\n');
     },
 });

package/skills/checkin/tools/checkin_rank/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from '../../../../src/i18n.js';
 import { conversationKey, toolGroupConversation } from '../../../../src/conversation-scope.js';
 import { defineAgentTool } from '@zhin.js/tool';
 import { getCheckinModel } from '../../../../src/db-store.js';
@@ -16,16 +17,16 @@ export default defineAgentTool<{ limit?: number; group_id?: string }>({
   scopes: ['group'],
   async execute({ limit, group_id: requestedGroupId }, context) {
     const model = getCheckinModel(context.use(groupSuiteRuntimeToken).db);
-    if (!model) return '签到数据库尚未就绪';
+    if (!model) return t(context.locale, 'checkinDb');
     const groupId = conversationKey(toolGroupConversation(context, requestedGroupId));
     const rows = await model.select().where({ context_type: 'group', context_id: groupId });
     const count = Math.min(Math.max(Number(limit) || 10, 1), 50);
     const ranked = [...rows]
       .sort((left, right) => Number(right.points ?? 0) - Number(left.points ?? 0))
       .slice(0, count);
-    if (ranked.length === 0) return '暂无排行数据';
+    if (ranked.length === 0) return t(context.locale, 'rankEmpty');
     return ranked.map((user, index) =>
-      `${index + 1}. ${String(user.user_name ?? user.user_id)} — ${Number(user.points ?? 0)}分 (连续${Number(user.streak ?? 0)}天)`,
+      t(context.locale, 'pointsToolRow', { rank: index + 1, name: String(user.user_name ?? user.user_id), points: Number(user.points ?? 0), days: Number(user.streak ?? 0) }),
     ).join('\n');
   },
 });

package/skills/group-daily-analysis/tools/group_announce/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../lib/i18n.js";
 import { defineAgentTool } from '@zhin.js/tool';
 export default defineAgentTool({
     description: '生成群聊公告或通知消息',
@@ -8,7 +9,7 @@ export default defineAgentTool({
         required: ['message'],
     },
     requiresApproval: 'never',
-    execute({ message }) {
-        return `📢 群公告：\n${message}`;
+    execute({ message }, context) {
+        return t(context.locale, 'announcement', { message });
     },
 });

package/skills/group-daily-analysis/tools/group_announce/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from '../../../../src/i18n.js';
 import { defineAgentTool } from '@zhin.js/tool';
 
 export default defineAgentTool<{ message: string }>({
@@ -8,7 +9,7 @@ export default defineAgentTool<{ message: string }>({
     required: ['message'],
   },
   requiresApproval: 'never',
-  execute({ message }) {
-    return `📢 群公告：\n${message}`;
+  execute({ message }, context) {
+    return t(context.locale, 'announcement', { message });
   },
 });

package/skills/group-daily-analysis/tools/stats_query/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../lib/i18n.js";
 import { conversationKey, toolGroupConversation } from "../../../../lib/conversation-scope.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { groupSuiteRuntimeToken } from "../../../../lib/runtime-state.js";
@@ -24,11 +25,11 @@ export default defineAgentTool({
             : period === 'month' ? monthStartStr() : todayStr();
         const stats = await queryStats(groupId, fromDate, runtime);
         if (stats.size === 0)
-            return `${period} 暂无消息统计数据`;
+            return t(context.locale, 'periodStatsEmpty', { period });
         const ranked = [...stats.values()].sort((left, right) => right.count - left.count);
         const total = ranked.reduce((sum, item) => sum + item.count, 0);
         const lines = ranked.slice(0, 10)
-            .map((item, index) => `${index + 1}. ${item.name} — ${item.count}条`);
-        return `消息统计 (${period})\n总消息: ${total}条, 活跃用户: ${stats.size}人\n${lines.join('\n')}`;
+            .map((item, index) => t(context.locale, 'statsRow', { prefix: `${index + 1}.`, name: item.name, count: item.count }));
+        return t(context.locale, 'statsOverview', { period, total, users: stats.size, lines: lines.join('\n') });
     },
 });

package/skills/group-daily-analysis/tools/stats_query/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from '../../../../src/i18n.js';
 import { conversationKey, toolGroupConversation } from '../../../../src/conversation-scope.js';
 import { defineAgentTool } from '@zhin.js/tool';
 import { groupSuiteRuntimeToken } from '../../../../src/runtime-state.js';
@@ -25,11 +26,11 @@ export default defineAgentTool<{ group_id?: string; period?: Period }>({
       ? weekStartStr()
       : period === 'month' ? monthStartStr() : todayStr();
     const stats = await queryStats(groupId, fromDate, runtime);
-    if (stats.size === 0) return `${period} 暂无消息统计数据`;
+    if (stats.size === 0) return t(context.locale, 'periodStatsEmpty', { period });
     const ranked = [...stats.values()].sort((left, right) => right.count - left.count);
     const total = ranked.reduce((sum, item) => sum + item.count, 0);
     const lines = ranked.slice(0, 10)
-      .map((item, index) => `${index + 1}. ${item.name} — ${item.count}条`);
-    return `消息统计 (${period})\n总消息: ${total}条, 活跃用户: ${stats.size}人\n${lines.join('\n')}`;
+      .map((item, index) => t(context.locale, 'statsRow', { prefix: `${index + 1}.`, name: item.name, count: item.count }));
+    return t(context.locale, 'statsOverview', { period, total, users: stats.size, lines: lines.join('\n') });
   },
 });

package/skills/group-daily-analysis/tools/stats_user/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t } from "../../../../lib/i18n.js";
 import { conversationKey, toolGroupConversation } from "../../../../lib/conversation-scope.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { getStatsModel } from "../../../../lib/db-store.js";
@@ -22,14 +23,14 @@ export default defineAgentTool({
         await flushStatsBuffer(runtime);
         const model = getStatsModel(runtime.db);
         if (!model)
-            return '统计数据库尚未就绪';
+            return t(context.locale, 'statsDb');
         const groupId = conversationKey(toolGroupConversation(context, requestedGroupId));
         const rows = await model.select().where({
             user_id: userId,
             group_id: groupId,
         });
         if (rows.length === 0)
-            return `用户 ${userId} 暂无消息记录`;
+            return t(context.locale, 'userStatsEmpty', { user: userId });
         const today = todayStr();
         const weekStart = weekStartStr();
         let todayCount = 0;
@@ -44,6 +45,6 @@ export default defineAgentTool({
                 todayCount += count;
         }
         const name = String(rows[0].user_name ?? userId);
-        return `${name} 的统计\n今日: ${todayCount}条\n本周: ${weekCount}条\n总计: ${totalCount}条\n活跃天数: ${rows.length}天`;
+        return t(context.locale, 'userStatsInfo', { name, today: todayCount, week: weekCount, total: totalCount, days: rows.length });
     },
 });

package/skills/group-daily-analysis/tools/stats_user/index.ts

@@ -1,3 +1,4 @@
+import { messages as t } from '../../../../src/i18n.js';
 import { conversationKey, toolGroupConversation } from '../../../../src/conversation-scope.js';
 import { defineAgentTool } from '@zhin.js/tool';
 import { getStatsModel } from '../../../../src/db-store.js';
@@ -21,13 +22,13 @@ export default defineAgentTool<{ user_id: string; group_id?: string }>({
     const runtime = context.use(groupSuiteRuntimeToken);
     await flushStatsBuffer(runtime);
     const model = getStatsModel(runtime.db);
-    if (!model) return '统计数据库尚未就绪';
+    if (!model) return t(context.locale, 'statsDb');
     const groupId = conversationKey(toolGroupConversation(context, requestedGroupId));
     const rows = await model.select().where({
       user_id: userId,
       group_id: groupId,
     });
-    if (rows.length === 0) return `用户 ${userId} 暂无消息记录`;
+    if (rows.length === 0) return t(context.locale, 'userStatsEmpty', { user: userId });
     const today = todayStr();
     const weekStart = weekStartStr();
     let todayCount = 0;
@@ -40,6 +41,6 @@ export default defineAgentTool<{ user_id: string; group_id?: string }>({
       if (row.date === today) todayCount += count;
     }
     const name = String(rows[0]!.user_name ?? userId);
-    return `${name} 的统计\n今日: ${todayCount}条\n本周: ${weekCount}条\n总计: ${totalCount}条\n活跃天数: ${rows.length}天`;
+    return t(context.locale, 'userStatsInfo', { name, today: todayCount, week: weekCount, total: totalCount, days: rows.length });
   },
 });

package/src/analysis-card.ts

@@ -1,3 +1,4 @@
+import { messages as t } from './i18n.js';
 import { jsx, renderToHtml } from "@zhin.js/jsx";
 import {
   BarChart,
@@ -28,10 +29,11 @@ const T = {
 } as const;
 
 export async function buildAnalysisReportHtml(
-  data: AnalysisReportData
+  data: AnalysisReportData,
+  locale?: import('zhin.js/i18n').Locale
 ): Promise<string> {
   const { stats, channelName, days, startDate, endDate, llm } = data;
-  const title = channelName ? `${channelName} · 群日常分析` : "群日常分析";
+  const title = channelName ? t(locale, 'analysisNamed', { name: channelName }) : t(locale, 'analysis');
   const peakLabel = `${String(stats.mostActiveHour).padStart(2, "0")}:00`;
   const hourlyValues = Array.from(
     { length: 24 },
@@ -41,7 +43,7 @@ export async function buildAnalysisReportHtml(
   const llmBlocks = [
     llm?.topics?.length
       ? jsx(Section, {
-          title: "热门话题",
+          title: t(locale, 'topics'),
           children: llm.topics.map((topic, i) =>
             jsx(TopicItem, {
               index: i + 1,
@@ -53,7 +55,7 @@ export async function buildAnalysisReportHtml(
       : "",
     llm?.quotes?.length
       ? jsx(Section, {
-          title: "金句精选",
+          title: t(locale, 'quotes'),
           children: llm.quotes.map((quote, i) =>
             jsx(QuoteCard, {
               index: i + 1,
@@ -66,7 +68,7 @@ export async function buildAnalysisReportHtml(
       : "",
     llm?.userTitles?.length
       ? jsx(Section, {
-          title: "用户画像",
+          title: t(locale, 'profiles'),
           children: llm.userTitles.map((user, i) =>
             jsx(ProfileRow, {
               index: i + 1,
@@ -82,27 +84,27 @@ export async function buildAnalysisReportHtml(
   const body = elevatedCard([
     jsx(CardHeader, {
       title,
-      subtitle: `${startDate} 至 ${endDate} · 最近 ${days} 天`,
+      subtitle: t(locale, 'analysisRange', { start: startDate, end: endDate, days }),
     }),
     jsx(Row, {
       children: [
         jsx(StatChip, {
-          label: "消息",
+          label: t(locale, 'messages'),
           value: formatCount(stats.messageCount),
           accent: T.accentMsg,
         }),
         jsx(StatChip, {
-          label: "参与",
+          label: t(locale, 'participants'),
           value: formatCount(stats.participantCount),
           accent: T.accentPeople,
         }),
         jsx(StatChip, {
-          label: "字数",
+          label: t(locale, 'characters'),
           value: formatCount(stats.totalChars),
           accent: T.accentChars,
         }),
         jsx(StatChip, {
-          label: "活跃",
+          label: t(locale, 'active'),
           value: peakLabel,
           accent: T.accentHour,
         }),
@@ -111,7 +113,7 @@ export async function buildAnalysisReportHtml(
       style: "margin-bottom:4px",
     }),
     jsx(Section, {
-      title: "每小时消息分布",
+      title: t(locale, 'hourDistribution'),
       children: jsx(BarChart, {
         values: hourlyValues,
         peakIndex: stats.mostActiveHour,

package/src/analysis.ts

@@ -1,3 +1,4 @@
+import { messages as t } from './i18n.js';
 /**
  * 群日常分析：从收件箱查询、基础统计、文本报告。
  * 数据源为 zhin 内置 unified_inbox_message 表（需 inbox.enabled）。
@@ -155,21 +156,22 @@ export function computeBasicStats(rows: InboxMessageRow[]): BasicStats {
  */
 export function formatTextReport(
   stats: BasicStats,
-  options: { channelName?: string; days: number; startDate: string; endDate: string }
+  options: { channelName?: string; days: number; startDate: string; endDate: string },
+  locale?: import('zhin.js/i18n').Locale
 ): string {
   const lines: string[] = [];
   const title = options.channelName
-    ? `【${options.channelName}】群日常分析`
-    : "群日常分析";
+    ? t(locale, 'analysisTextNamed', { name: options.channelName })
+    : t(locale, 'analysis');
   lines.push(`📊 ${title}`);
-  lines.push(`📅 统计区间：${options.startDate} 至 ${options.endDate}（最近 ${options.days} 天）`);
+  lines.push(t(locale, 'analysisTextRange', { start: options.startDate, end: options.endDate, days: options.days }));
   lines.push("");
-  lines.push(`💬 消息总数：${stats.messageCount} 条`);
-  lines.push(`👥 参与人数：${stats.participantCount} 人`);
-  lines.push(`📝 总字数：${stats.totalChars} 字`);
-  lines.push(`⏰ 最活跃时段：${stats.mostActiveHour}:00 - ${stats.mostActiveHour + 1}:00`);
+  lines.push(t(locale, 'analysisMessages', { count: stats.messageCount }));
+  lines.push(t(locale, 'analysisPeople', { count: stats.participantCount }));
+  lines.push(t(locale, 'analysisChars', { count: stats.totalChars }));
+  lines.push(t(locale, 'analysisPeak', { start: stats.mostActiveHour, end: stats.mostActiveHour + 1 }));
   lines.push("");
-  lines.push("📈 每小时消息分布：");
+  lines.push(t(locale, 'hourDistributionText'));
   const maxH = Math.max(...Object.values(stats.hourlyDistribution), 1);
   for (let h = 0; h < 24; h++) {
     const c = stats.hourlyDistribution[h] || 0;
@@ -183,24 +185,24 @@ export function formatTextReport(
  * 将 LLM 分析结果追加到文本报告。
  * 话题/金句/用户画像 设计灵感来自 astrbot_plugin_qq_group_daily_analysis
  */
-export function appendLLMReport(textReport: string, llm: LLMAnalysis): string {
+export function appendLLMReport(textReport: string, llm: LLMAnalysis, locale?: import('zhin.js/i18n').Locale): string {
   const lines: string[] = [textReport, ""];
   if (llm.topics?.length) {
-    lines.push("🔥 热门话题（LLM 提取）：");
+    lines.push(t(locale, 'llmTopics'));
     llm.topics.forEach((t, i) => {
       lines.push(`  ${i + 1}. ${t.topic}${t.summary ? ` — ${t.summary}` : ""}`);
     });
     lines.push("");
   }
   if (llm.quotes?.length) {
-    lines.push("💬 金句（LLM 筛选）：");
+    lines.push(t(locale, 'llmQuotes'));
     llm.quotes.forEach((q, i) => {
       lines.push(`  ${i + 1}. 「${q.content}」 — ${q.sender}（${q.reason}）`);
     });
     lines.push("");
   }
   if (llm.userTitles?.length) {
-    lines.push("👤 用户画像/称号（LLM）：");
+    lines.push(t(locale, 'llmProfiles'));
     llm.userTitles.forEach((u, i) => {
       lines.push(`  ${i + 1}. ${u.name} — ${u.title}${u.reason ? `（${u.reason}）` : ""}`);
     });

package/src/checkin-lib.ts

@@ -1,3 +1,4 @@
+import { messages as t } from './i18n.js';
 import type { ConversationInput } from './conversation-scope.js';
 import type { GroupSuiteConfig } from './config.js';
 import { getCheckinModel } from './db-store.js';
@@ -70,19 +71,19 @@ export async function doCheckin(
   runtime: GroupSuiteRuntime,
 ): Promise<string> {
   const M = getCheckinModel(runtime.db);
-  if (!M) return '签到数据库尚未就绪，请稍后重试';
+  if (!M) return t(input.locale, 'checkinRetry');
 
   const { id: userId, name: userName } = resolveSender(input);
-  if (!userId) return '无法获取用户信息';
+  if (!userId) return t(input.locale, 'senderMissing');
 
   const { type: ctxType, id: ctxId } = resolveContextKey(input);
   return serializedCheckin(runtime.checkinChains, `${userId}:${ctxType}:${ctxId}`, async () => {
     const user = await getOrCreateUser(M, userId, userName, ctxType, ctxId);
-    if (!user) return '签到失败，请重试';
+    if (!user) return t(input.locale, 'checkinFailed');
 
     const today = todayStr();
     if (user.last_checkin === today) {
-      return `你今天已经签到过了哦～\n当前积分: ${user.points}\n连续签到: ${user.streak} 天`;
+      return t(input.locale, 'alreadyChecked', { points: String(user.points), days: String(user.streak) });
     }
 
     const isConsecutive = user.last_checkin === yesterdayStr();
@@ -106,9 +107,9 @@ export async function doCheckin(
       context_id: ctxId,
     });
 
-    const lines = [`签到成功！`, `基础积分: +${base}`];
-    if (bonus > 0) lines.push(`连续奖励: +${bonus} (连续${newStreak}天)`);
-    lines.push(`本次获得: +${earned}`, `当前积分: ${newPoints}`);
+    const lines = [t(input.locale, 'checkinDone'), t(input.locale, 'basePoints', { points: base })];
+    if (bonus > 0) lines.push(t(input.locale, 'bonusPoints', { points: bonus, days: newStreak }));
+    lines.push(t(input.locale, 'earnedPoints', { points: earned }), t(input.locale, 'currentPoints', { points: newPoints }));
     return lines.join('\n');
   });
 }
@@ -116,9 +117,10 @@ export async function doCheckin(
 export async function myPoints(
   input: ConversationInput,
   runtime: GroupSuiteRuntime,
+  commandHead?: string,
 ): Promise<string> {
   const M = getCheckinModel(runtime.db);
-  if (!M) return '签到数据库尚未就绪';
+  if (!M) return t(input.locale, 'checkinDb');
   const { id: userId } = resolveSender(input);
   const { type: ctxType, id: ctxId } = resolveContextKey(input);
   const rows = (await M.select().where({
@@ -126,16 +128,16 @@ export async function myPoints(
     context_type: ctxType,
     context_id: ctxId,
   })) as Record<string, unknown>[];
-  if (rows.length === 0) return '你还没有签到记录哦，发送「checkin」开始吧！';
+  if (rows.length === 0) return commandHead ? t(input.locale, 'checkinHint', { command: commandHead }) : t(input.locale, 'checkinHintNoHead');
   const u = rows[0];
   const checkedToday = u.last_checkin === todayStr();
   return [
-    `${u.user_name || '用户'} 的积分信息`,
-    `积分: ${u.points}`,
-    `累计签到: ${u.total_checkins} 天`,
-    `连续签到: ${u.streak} 天`,
-    `最长连续: ${u.max_streak} 天`,
-    checkedToday ? '今日已签到 ✓' : '今日未签到',
+    t(input.locale, 'pointsTitle', { name: String(u.user_name || t(input.locale, 'user')) }),
+    t(input.locale, 'points', { points: String(u.points) }),
+    t(input.locale, 'checkinTotal', { days: String(u.total_checkins) }),
+    t(input.locale, 'checkinStreak', { days: String(u.streak) }),
+    t(input.locale, 'checkinMax', { days: String(u.max_streak) }),
+    checkedToday ? t(input.locale, 'checked') : t(input.locale, 'unchecked'),
   ].join('\n');
 }
 
@@ -145,23 +147,23 @@ export async function pointsRank(
   runtime: GroupSuiteRuntime,
 ): Promise<string> {
   const M = getCheckinModel(runtime.db);
-  if (!M) return '签到数据库尚未就绪';
+  if (!M) return t(input.locale, 'checkinDb');
   const { type: ctxType, id: ctxId } = resolveContextKey(input);
   const all = (await M.select().where(
     { context_type: ctxType, context_id: ctxId },
   )) as Record<string, unknown>[];
-  if (all.length === 0) return '还没有人签到过哦～';
+  if (all.length === 0) return t(input.locale, 'checkinEmpty');
   const sorted = all.sort((a, b) => Number(b.points || 0) - Number(a.points || 0));
   const top = sorted.slice(0, cfg.rankSize);
   const medals = ['🥇', '🥈', '🥉'];
   const lines = top.map((u, i) => {
     const prefix = i < 3 ? medals[i] : `${i + 1}.`;
-    return `${prefix} ${u.user_name || u.user_id} — ${u.points}分 (${u.total_checkins}天)`;
+    return t(input.locale, 'pointsRow', { prefix, name: String(u.user_name || u.user_id), points: String(u.points), days: String(u.total_checkins) });
   });
-  const title = ctxType === 'group' ? '本群积分排行'
-    : ctxType === 'channel' ? '本频道积分排行' : '当前私聊积分排行';
+  const title = ctxType === 'group' ? t(input.locale, 'groupPoints')
+    : ctxType === 'channel' ? t(input.locale, 'channelPoints') : t(input.locale, 'privatePoints');
   const { id: userId } = resolveSender(input);
   const myRank = sorted.findIndex((u) => u.user_id === userId);
-  const footer = myRank >= 0 ? `\n你的排名: 第${myRank + 1}名` : '';
+  const footer = myRank >= 0 ? t(input.locale, 'myRankFooter', { rank: myRank + 1 }) : '';
   return `${title}\n${lines.join('\n')}${footer}`;
 }

package/src/conversation-scope.ts

@@ -3,6 +3,7 @@ import { adapterFeatureId, type AdapterIndex } from 'zhin.js/adapter';
 import type { ToolInvocationOrigin } from '@zhin.js/tool';
 
 export interface ConversationInput {
+  readonly locale?: import('zhin.js/i18n').Locale;
   readonly conversation?: DeliveryTarget;
   readonly sender?: Readonly<{ id: string; name?: string }>;
   readonly content?: unknown;