@downcity/plugins 1.0.147 → 1.0.149

package/src/chat/runtime/ChatAuthorizationRuntime.ts

@@ -165,7 +165,7 @@ export function createChatAuthorizationResolves(): PluginResolves {
 export function createChatAuthorizationActions(): PluginActions {
   return {
     [CHAT_AUTHORIZATION_ACTIONS.snapshot]: createAction({
-      description: "读取 chat 授权快照（catalog/config/users/chats）。",
+      description: "Read chat authorization snapshot (catalog/config/users/chats).",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {} },
@@ -181,7 +181,7 @@ export function createChatAuthorizationActions(): PluginActions {
       },
     }),
     [CHAT_AUTHORIZATION_ACTIONS.readConfig]: createAction({
-      description: "读取当前 chat 授权配置。",
+      description: "Read current chat authorization config.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {} },
@@ -194,7 +194,7 @@ export function createChatAuthorizationActions(): PluginActions {
       },
     }),
     [CHAT_AUTHORIZATION_ACTIONS.writeConfig]: createAction({
-      description: "写入 chat 授权配置（整体覆盖）。",
+      description: "Write chat authorization config as a full replacement.",
       input_schema: {
         zod: z.object({
           config: z.record(z.string(), z.unknown()).optional(),
@@ -202,7 +202,7 @@ export function createChatAuthorizationActions(): PluginActions {
         json_schema: {
           type: "object",
           properties: {
-            config: { type: "object", description: "授权配置" },
+            config: { type: "object", description: "Authorization config." },
           },
         },
       },
@@ -225,7 +225,7 @@ export function createChatAuthorizationActions(): PluginActions {
       },
     }),
     [CHAT_AUTHORIZATION_ACTIONS.setUserRole]: createAction({
-      description: "为某个渠道用户设置角色。",
+      description: "Set the role for a channel user.",
       input_schema: {
         zod: z.object({
           channel: z.enum(["telegram", "feishu", "qq"]),

package/src/chat/runtime/ChatPluginActionRegistry.ts

@@ -104,15 +104,15 @@ export function createChatPluginActions(params: {
 }): PluginActions {
   return {
     status: createAction({
-      description: "查看 chat 渠道连接状态。",
+      description: "View chat channel connection status.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "查看 chat 渠道连接状态",
+        description: "View chat channel connection status.",
         configure(command: Command) {
-          command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
+          command.option("--channel <name>", "Specify channel (telegram|feishu|qq).");
         },
         mapInput: mapChatChannelCommandInput,
       },
@@ -125,15 +125,15 @@ export function createChatPluginActions(params: {
       },
     }),
     test: createAction({
-      description: "测试 chat 渠道连通性。",
+      description: "Test chat channel connectivity.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "测试 chat 渠道连通性",
+        description: "Test chat channel connectivity.",
         configure(command: Command) {
-          command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
+          command.option("--channel <name>", "Specify channel (telegram|feishu|qq).");
         },
         mapInput: mapChatChannelCommandInput,
       },
@@ -146,15 +146,15 @@ export function createChatPluginActions(params: {
       },
     }),
     reconnect: createAction({
-      description: "重连 chat 渠道（默认全部）。",
+      description: "Reconnect chat channels, all by default.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "重连 chat 渠道（默认全部）",
+        description: "Reconnect chat channels, all by default.",
         configure(command: Command) {
-          command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
+          command.option("--channel <name>", "Specify channel (telegram|feishu|qq).");
         },
         mapInput: mapChatChannelCommandInput,
       },
@@ -167,15 +167,15 @@ export function createChatPluginActions(params: {
       },
     }),
     open: createAction({
-      description: "打开（启用）指定 chat 渠道。",
+      description: "Open and enable the specified chat channel.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "打开 chat 渠道（enabled=true，已配置则尝试启动）",
+        description: "Open chat channel (enabled=true, and start it if configured).",
         configure(command: Command) {
-          command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
+          command.option("--channel <name>", "Specify channel (telegram|feishu|qq).");
         },
         mapInput: mapChatChannelCommandInput,
       },
@@ -188,15 +188,15 @@ export function createChatPluginActions(params: {
       },
     }),
     close: createAction({
-      description: "关闭（禁用）指定 chat 渠道。",
+      description: "Close and disable the specified chat channel.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "关闭 chat 渠道（enabled=false，并停止运行）",
+        description: "Close chat channel (enabled=false and stop runtime).",
         configure(command: Command) {
-          command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
+          command.option("--channel <name>", "Specify channel (telegram|feishu|qq).");
         },
         mapInput: mapChatChannelCommandInput,
       },
@@ -209,15 +209,15 @@ export function createChatPluginActions(params: {
       },
     }),
     configuration: createAction({
-      description: "查看 chat 渠道配置元信息。",
+      description: "View chat channel configuration metadata.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "查看 chat 渠道配置元信息（字段、类型、说明）",
+        description: "View chat channel configuration metadata (fields, types, descriptions).",
         configure(command: Command) {
-          command.option("--channel <name>", "指定渠道（telegram|feishu|qq）");
+          command.option("--channel <name>", "Specify channel (telegram|feishu|qq).");
         },
         mapInput: mapChatChannelCommandInput,
       },
@@ -229,21 +229,21 @@ export function createChatPluginActions(params: {
       },
     }),
     configure: createAction({
-      description: "更新 chat 渠道运行态参数。",
+      description: "Update runtime parameters for a chat channel.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "更新 chat 渠道运行态参数（可选立即重载）",
+        description: "Update runtime parameters for a chat channel, optionally restarting it immediately.",
         configure(command: Command) {
           command
-            .requiredOption("--channel <name>", "指定渠道（telegram|feishu|qq）")
+            .requiredOption("--channel <name>", "Specify channel (telegram|feishu|qq).")
             .requiredOption(
               "--config-json <json>",
-              "配置 patch JSON（例如 '{\"channelAccountId\":\"qq-main\",\"enabled\":true}'）",
+              "Configuration patch JSON, for example '{\"channelAccountId\":\"qq-main\",\"enabled\":true}'.",
             )
-            .option("--restart", "配置后立即重载渠道", false);
+            .option("--restart", "Restart the channel immediately after configuration.", false);
         },
         mapInput: mapChatConfigureCommandInput,
       },
@@ -256,18 +256,18 @@ export function createChatPluginActions(params: {
       },
     }),
     list: createAction({
-      description: "列出当前 agent 已记录的 chat 会话。",
+      description: "List chat conversations recorded by the current agent.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "列出当前 agent 已记录的 chat 会话（chatTitle/chatKey）",
+        description: "List chat conversations recorded by the current agent (chatTitle/chatKey).",
         configure(command: Command) {
           command
-            .option("--channel <name>", "渠道过滤（telegram|feishu|qq）")
-            .option("--limit <n>", "返回最近 N 条（默认 50）")
-            .option("--q <text>", "关键词过滤（title/chatId/sessionId/actor）");
+            .option("--channel <name>", "Filter by channel (telegram|feishu|qq).")
+            .option("--limit <n>", "Return the latest N records, default 50.")
+            .option("--q <text>", "Keyword filter (title/chatId/sessionId/actor).");
         },
         mapInput: mapChatListCommandInput,
       },
@@ -279,17 +279,17 @@ export function createChatPluginActions(params: {
       },
     }),
     info: createAction({
-      description: "查看指定 chat 会话的路由/路径/上下文快照。",
+      description: "View route, paths, and context snapshot for a specified chat conversation.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "查看指定 chat 会话信息（路由/本地路径/上下文快照）",
+        description: "View specified chat conversation info (route/local paths/context snapshot).",
         configure(command: Command) {
           command
-            .option("--chat-key <chatKey>", "目标 chatKey（不传则尝试读取 DC_CTX_CHAT_KEY）")
-            .option("--session-id <sessionId>", "显式指定 sessionId（优先级更高）");
+            .option("--chat-key <chatKey>", "Target chatKey; reads DC_CTX_CHAT_KEY if omitted.")
+            .option("--session-id <sessionId>", "Explicit sessionId, with higher priority.");
         },
         mapInput: mapChatInfoCommandInput,
       },
@@ -301,23 +301,23 @@ export function createChatPluginActions(params: {
       },
     }),
     send: createAction({
-      description: "向目标 chatKey 发送消息（支持文本/附件/延迟）。",
+      description: "Send a message to the target chatKey, supporting text, attachments, and delay.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "发送消息到目标 chatKey",
+        description: "Send a message to the target chatKey.",
         configure(command: Command) {
           command
-            .option("--text <text>", "消息正文")
-            .option("--stdin", "从标准输入读取消息正文", false)
-            .option("--text-file <file>", "从文件读取消息正文（相对当前目录）")
-            .option("--reply", "显式使用 reply_to_message 回复目标消息", false)
-            .option("--message-id <id>", "显式指定 reply 目标消息 ID")
+            .option("--text <text>", "Message body.")
+            .option("--stdin", "Read message body from stdin.", false)
+            .option("--text-file <file>", "Read message body from a file relative to the current directory.")
+            .option("--reply", "Explicitly reply to the target message with reply_to_message.", false)
+            .option("--message-id <id>", "Explicit reply target message ID.")
             .option(
               "--chat-key <chatKey>",
-              "目标 chatKey（不传则尝试读取 DC_CTX_CHAT_KEY）",
+              "Target chatKey; reads DC_CTX_CHAT_KEY if omitted.",
             );
           attachCommandHelpText(command, CHAT_SEND_HELP_TEXT);
         },
@@ -331,21 +331,21 @@ export function createChatPluginActions(params: {
       },
     }),
     react: createAction({
-      description: "给目标消息贴表情（当前仅 Telegram 支持）。",
+      description: "React to a target message, currently supported only by Telegram.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "给目标消息贴表情（当前仅 Telegram 支持）",
+        description: "React to a target message, currently supported only by Telegram.",
         configure(command: Command) {
           command
-            .option("--emoji <emoji>", "表情字符（默认 👍）")
-            .option("--big", "使用大表情效果（Telegram is_big）", false)
-            .option("--message-id <id>", "目标消息 ID（默认尝试从 chat meta 回填）")
+            .option("--emoji <emoji>", "Emoji character, default thumbs-up.")
+            .option("--big", "Use large reaction effect (Telegram is_big).", false)
+            .option("--message-id <id>", "Target message ID; defaults to chat meta when available.")
             .option(
               "--chat-key <chatKey>",
-              "目标 chatKey（不传则尝试读取 DC_CTX_CHAT_KEY）",
+              "Target chatKey; reads DC_CTX_CHAT_KEY if omitted.",
             );
           attachCommandHelpText(command, CHAT_REACT_HELP_TEXT);
         },
@@ -359,15 +359,15 @@ export function createChatPluginActions(params: {
       },
     }),
     context: createAction({
-      description: "查看当前会话上下文快照。",
+      description: "View current conversation context snapshot.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "查看当前会话上下文快照",
+        description: "View current conversation context snapshot.",
         configure(command: Command) {
-          command.option("--chat-key <chatKey>", "显式覆盖 chatKey");
+          command.option("--chat-key <chatKey>", "Explicitly override chatKey.");
         },
         mapInput(input) {
           const chatKey =
@@ -385,17 +385,17 @@ export function createChatPluginActions(params: {
       },
     }),
     delete: createAction({
-      description: "彻底删除指定 chat 会话（映射+历史+context）。",
+      description: "Permanently delete a specified chat conversation, including mapping, history, and context.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "彻底删除指定 chat 会话（映射+历史+context）",
+        description: "Permanently delete a specified chat conversation, including mapping, history, and context.",
         configure(command: Command) {
           command
-            .option("--chat-key <chatKey>", "显式指定 chatKey")
-            .option("--session-id <sessionId>", "显式指定 sessionId");
+            .option("--chat-key <chatKey>", "Explicit chatKey.")
+            .option("--session-id <sessionId>", "Explicit sessionId.");
         },
         mapInput: mapChatDeleteCommandInput,
       },
@@ -407,24 +407,24 @@ export function createChatPluginActions(params: {
       },
     }),
     history: createAction({
-      description: "读取 chat 历史消息。",
+      description: "Read chat history messages.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "读取 chat 历史消息（默认最近 30 条）",
+        description: "Read chat history messages, defaulting to the latest 30.",
         configure(command: Command) {
           command
-            .option("--chat-key <chatKey>", "显式覆盖 chatKey")
-            .option("--session-id <sessionId>", "显式覆盖 sessionId")
-            .option("--limit <n>", "返回最近 N 条（默认 30）")
+            .option("--chat-key <chatKey>", "Explicitly override chatKey.")
+            .option("--session-id <sessionId>", "Explicitly override sessionId.")
+            .option("--limit <n>", "Return the latest N records, default 30.")
             .option(
               "--direction <direction>",
-              "方向过滤（all|inbound|outbound）",
+              "Direction filter (all|inbound|outbound).",
             )
-            .option("--before-ts <ts>", "仅返回 ts 小于该值的记录（毫秒）")
-            .option("--after-ts <ts>", "仅返回 ts 大于该值的记录（毫秒）");
+            .option("--before-ts <ts>", "Return only records with ts lower than this value, in milliseconds.")
+            .option("--after-ts <ts>", "Return only records with ts greater than this value, in milliseconds.");
         },
         mapInput: mapChatHistoryCommandInput,
       },

package/src/contact/Action.ts

@@ -97,21 +97,21 @@ export type ContactActionHandlers = {
 export function createContactActions(handlers: ContactActionHandlers): PluginActions {
   return {
     link: createAction({
-      description: "生成一次性 contact link code，供其他 agent approve。",
+      description: "Create a one-time contact link code for another agent to approve.",
       input_schema: {
         zod: z.object({ ttlSeconds: z.number().optional() }),
         json_schema: {
           type: "object",
           properties: {
-            ttlSeconds: { type: "number", description: "link 过期秒数，默认 600" },
+            ttlSeconds: { type: "number", description: "Link expiration in seconds, defaulting to 600." },
           },
         },
       },
-      examples: [{ title: "生成默认 link", payload: {} }],
+      examples: [{ title: "Create default link", payload: {} }],
       command: {
-        description: "生成一次性 contact link code，交给另一个 agent approve",
+        description: "Create a one-time contact link code for another agent to approve.",
         configure(command) {
-          command.option("--ttl-seconds <seconds>", "link 过期秒数，默认 600", Number);
+          command.option("--ttl-seconds <seconds>", "Link expiration in seconds, defaulting to 600.", Number);
         },
         mapInput({ opts }) {
           const payload: JsonObject = {};
@@ -128,7 +128,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     approve: createAction({
-      description: "使用 contact link code 建立点对点联系。",
+      description: "Use a contact link code to establish a peer-to-peer contact.",
       input_schema: {
         zod: z.object({
           code: z.string(),
@@ -139,7 +139,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
           required: ["code"],
           properties: {
             code: { type: "string", description: "link code" },
-            name: { type: "string", description: "本地 contact 别名" },
+            name: { type: "string", description: "Local contact alias." },
           },
         },
       },
@@ -147,11 +147,11 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
         { title: "approve link", payload: { code: "abc123", name: "alice" } },
       ],
       command: {
-        description: "使用 contact link code 建立点对点联系",
+        description: "Use a contact link code to establish a peer-to-peer contact.",
         configure(command) {
           command
             .argument("<code>")
-            .option("--name <alias>", "本地 contact 别名");
+            .option("--name <alias>", "Local contact alias.");
         },
         mapInput({ args, opts }) {
           const code = String(args[0] || "").trim();
@@ -170,14 +170,14 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     list: createAction({
-      description: "列出已建立的 contact。",
+      description: "List established contacts.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {} },
       },
-      examples: [{ title: "列出 contact", payload: {} }],
+      examples: [{ title: "List contacts", payload: {} }],
       command: {
-        description: "列出已建立的 contact",
+        description: "List established contacts.",
         mapInput() {
           return {};
         },
@@ -190,7 +190,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     check: createAction({
-      description: "检查 contact 或 endpoint 当前是否在线可用。",
+      description: "Check whether a contact or endpoint is currently online and reachable.",
       input_schema: {
         zod: z.object({
           target: z.string().optional(),
@@ -199,21 +199,21 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
         json_schema: {
           type: "object",
           properties: {
-            target: { type: "string", description: "已保存的 contact 名" },
-            endpoint: { type: "string", description: "直接检查的 endpoint" },
+            target: { type: "string", description: "Saved contact name." },
+            endpoint: { type: "string", description: "Endpoint to check directly." },
           },
         },
       },
       examples: [
-        { title: "检查 contact", payload: { target: "alice" } },
-        { title: "检查 endpoint", payload: { endpoint: "https://example.com" } },
+        { title: "Check contact", payload: { target: "alice" } },
+        { title: "Check endpoint", payload: { endpoint: "https://example.com" } },
       ],
       command: {
-        description: "检查 contact 或 endpoint 当前是否在线可用",
+        description: "Check whether a contact or endpoint is currently online and reachable.",
         configure(command) {
           command
             .argument("[target]")
-            .option("--to <endpoint>", "直接检查未保存的 endpoint");
+            .option("--to <endpoint>", "Directly check an unsaved endpoint.");
         },
         mapInput({ args, opts }) {
           const payload: JsonObject = {};
@@ -232,7 +232,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     chat: createAction({
-      description: "和某个 contact 的长期对话线聊天，或读取对话历史。",
+      description: "Chat with a contact in its long-lived conversation thread, or read conversation history.",
       input_schema: {
         zod: z.object({
           to: z.string(),
@@ -242,19 +242,19 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
           type: "object",
           required: ["to"],
           properties: {
-            to: { type: "string", description: "目标 contact" },
-            message: { type: "string", description: "要发送的消息" },
+            to: { type: "string", description: "Target contact." },
+            message: { type: "string", description: "Message to send." },
           },
         },
       },
       examples: [
-        { title: "发送消息", payload: { to: "alice", message: "hello" } },
-        { title: "读取历史", payload: { to: "alice" } },
+        { title: "Send message", payload: { to: "alice", message: "hello" } },
+        { title: "Read history", payload: { to: "alice" } },
       ],
       command: {
-        description: "和某个 contact 的长期对话线聊天",
+        description: "Chat with a contact in its long-lived conversation thread.",
         configure(command) {
-          command.requiredOption("--to <contact>", "目标 contact").argument("[message...]");
+          command.requiredOption("--to <contact>", "Target contact.").argument("[message...]");
         },
         mapInput({ args, opts }) {
           const payload: JsonObject = {
@@ -274,7 +274,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     share: createAction({
-      description: "向 contact 分享文本、链接、文件或目录。",
+      description: "Share text, links, files, or directories with a contact.",
       input_schema: {
         zod: z.object({
           to: z.string(),
@@ -286,26 +286,26 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
           type: "object",
           required: ["to"],
           properties: {
-            to: { type: "string", description: "目标 contact" },
-            text: { type: "string", description: "分享文本" },
-            links: { type: "array", items: { type: "string" }, description: "分享链接" },
-            paths: { type: "array", items: { type: "string" }, description: "分享文件/目录路径" },
+            to: { type: "string", description: "Target contact." },
+            text: { type: "string", description: "Text to share." },
+            links: { type: "array", items: { type: "string" }, description: "Links to share." },
+            paths: { type: "array", items: { type: "string" }, description: "File or directory paths to share." },
           },
         },
       },
       examples: [
         {
-          title: "分享一段文本",
+          title: "Share text",
           payload: { to: "alice", text: "看看这个" },
         },
       ],
       command: {
-        description: "向 contact 分享文本、链接、文件或目录",
+        description: "Share text, links, files, or directories with a contact.",
         configure(command) {
           command
-            .requiredOption("--to <contact>", "目标 contact")
-            .option("--text <text>", "分享文本")
-            .option("--link <url...>", "分享链接")
+            .requiredOption("--to <contact>", "Target contact.")
+            .option("--text <text>", "Text to share.")
+            .option("--link <url...>", "Links to share.")
             .argument("[paths...]");
         },
         mapInput({ args, opts }) {
@@ -331,14 +331,14 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     inbox: createAction({
-      description: "查看 contact inbox。",
+      description: "View the contact inbox.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {} },
       },
-      examples: [{ title: "查看 inbox", payload: {} }],
+      examples: [{ title: "View inbox", payload: {} }],
       command: {
-        description: "查看 contact inbox",
+        description: "View the contact inbox.",
         mapInput() {
           return {};
         },
@@ -351,20 +351,20 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     receive: createAction({
-      description: "接收 inbox 中的 share。",
+      description: "Receive a share from the inbox.",
       input_schema: {
         zod: z.object({ shareId: z.string() }),
         json_schema: {
           type: "object",
           required: ["shareId"],
           properties: {
-            shareId: { type: "string", description: "inbox 中的 shareId" },
+            shareId: { type: "string", description: "Share ID from the inbox." },
           },
         },
       },
-      examples: [{ title: "接收 share", payload: { shareId: "share_1" } }],
+      examples: [{ title: "Receive share", payload: { shareId: "share_1" } }],
       command: {
-        description: "接收 inbox 中的 share",
+        description: "Receive a share from the inbox.",
         configure(command) {
           command.argument("<shareId>");
         },
@@ -383,7 +383,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     remoteping: createAction({
-      description: "处理远端 ping 请求（内部 endpoint）。",
+      description: "Handle a remote ping request (internal endpoint).",
       execute: async (params) => ({
         success: true,
         data: (await handlers.remotePing(
@@ -393,7 +393,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     remoteapprove: createAction({
-      description: "处理远端 approve 请求（内部 endpoint）。",
+      description: "Handle a remote approve request (internal endpoint).",
       execute: async (params) => ({
         success: true,
         data: (await handlers.remoteApprove(
@@ -403,7 +403,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     remoteconfirm: createAction({
-      description: "处理远端 confirm 请求（内部 endpoint）。",
+      description: "Handle a remote confirm request (internal endpoint).",
       execute: async (params) => ({
         success: true,
         data: (await handlers.remoteConfirm(
@@ -413,7 +413,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       }),
     }),
     remotechat: createAction({
-      description: "处理远端 chat 请求（内部 endpoint）。",
+      description: "Handle a remote chat request (internal endpoint).",
       execute: async (params) => {
         const payload = readContactObject(params.input);
         const body = readContactObject(payload.body);
@@ -428,7 +428,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       },
     }),
     remoteshare: createAction({
-      description: "处理远端 share 请求（内部 endpoint）。",
+      description: "Handle a remote share request (internal endpoint).",
       execute: async (params) => ({
         success: true,
         data: (await handlers.remoteShare(params.context, params.input)) as unknown as JsonValue,