@zhin.js/plugin-nettools 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @zhin.js/plugin-nettools
 
+## 0.1.3
+
+### Patch Changes
+
+- 53bc6a0: 官方工具插件与游戏支持中英文反馈、帮助和配置标签；提醒增加与中文对应的有限英文时间语法。聊天后台任务记录创建者当时语言，管理员任务记录项目语言，旧任务保持中文；多轮选择与游戏使用开始时语言，保留第三方内容和已生成报告。
+- Updated dependencies [53bc6a0]
+- Updated dependencies [7595136]
+- Updated dependencies [17d1301]
+  - @zhin.js/tool@1.1.10
+  - @zhin.js/skill@1.1.10
+
+## 0.1.2
+
+### Patch Changes
+
+- Updated dependencies [6da2bad]
+- Updated dependencies [3781f1c]
+  - @zhin.js/tool@1.1.9
+  - @zhin.js/skill@1.1.9
+
 ## 0.1.1
 
 ### Patch Changes

package/commands/dns/[name]/[[type]]/index.js

@@ -3,16 +3,16 @@ import { defineCommand } from 'zhin.js/command';
 import { commandCallerKey } from "../../../../lib/cooldown.js";
 import { nettoolsServiceToken } from "../../../../lib/runtime.js";
 export default defineCommand({
-    description: 'DNS 查询（DoH），类型可选 A/AAAA/CNAME/MX/TXT/NS/SOA/CAA/SRV/PTR/DS/DNSKEY',
+    description: 'DNS 查询（DoH），类型可选 A/AAAA/CNAME/MX/TXT/NS/SOA/CAA/SRV/PTR/DS/DNSKEY', descriptionI18n: { en: "DNS lookup over HTTPS; supports A/AAAA/CNAME/MX/TXT/NS/SOA/CAA/SRV/PTR/DS/DNSKEY" },
     params: {
-        name: { type: 'string', description: '域名；PTR 查询时可填 IP' },
-        type: { type: 'string', description: '记录类型，默认 A' },
+        name: { type: 'string', description: '域名；PTR 查询时可填 IP', descriptionI18n: { en: "Domain name, or an IP address for PTR queries" } },
+        type: { type: 'string', description: '记录类型，默认 A', descriptionI18n: { en: "Record type (default: A)" } },
     },
-    async execute({ params, input, use, signal }) {
+    async execute({ params, input, use, signal, locale }) {
         const service = use(nettoolsServiceToken);
         const name = String(params.name ?? '');
         const type = params.type == null ? undefined : String(params.type);
         const callerKey = commandCallerKey(input);
-        return service.run(() => service.dns(name, type, callerKey, signal));
+        return service.run(() => service.dns(name, type, callerKey, signal, locale), locale);
     },
 });

package/commands/dns/[name]/[[type]]/index.ts

@@ -3,16 +3,16 @@ import { commandCallerKey } from '../../../../src/cooldown.js';
 import { nettoolsServiceToken } from '../../../../src/runtime.js';
 
 export default defineCommand({
-  description: 'DNS 查询（DoH），类型可选 A/AAAA/CNAME/MX/TXT/NS/SOA/CAA/SRV/PTR/DS/DNSKEY',
+  description: 'DNS 查询（DoH），类型可选 A/AAAA/CNAME/MX/TXT/NS/SOA/CAA/SRV/PTR/DS/DNSKEY', descriptionI18n: { en: "DNS lookup over HTTPS; supports A/AAAA/CNAME/MX/TXT/NS/SOA/CAA/SRV/PTR/DS/DNSKEY" },
   params: {
-    name: { type: 'string', description: '域名；PTR 查询时可填 IP' },
-    type: { type: 'string', description: '记录类型，默认 A' },
+    name: { type: 'string', description: '域名；PTR 查询时可填 IP', descriptionI18n: { en: "Domain name, or an IP address for PTR queries" } },
+    type: { type: 'string', description: '记录类型，默认 A', descriptionI18n: { en: "Record type (default: A)" } },
   },
-  async execute({ params, input, use, signal }) {
+  async execute({ params, input, use, signal, locale }) {
     const service = use(nettoolsServiceToken);
     const name = String(params.name ?? '');
     const type = params.type == null ? undefined : String(params.type);
     const callerKey = commandCallerKey(input);
-    return service.run(() => service.dns(name, type, callerKey, signal));
+    return service.run(() => service.dns(name, type, callerKey, signal, locale), locale);
   },
 });

package/commands/domain-price/[suffix]/[[order]]/index.js

@@ -3,17 +3,17 @@ import { defineCommand } from 'zhin.js/command';
 import { commandCallerKey } from "../../../../lib/cooldown.js";
 import { nettoolsServiceToken } from "../../../../lib/runtime.js";
 export default defineCommand({
-    description: '域名注册/续费/转入价格比价（nazhumi.com）',
+    description: '域名注册/续费/转入价格比价（nazhumi.com）', descriptionI18n: { en: "Compare domain registration, renewal and transfer prices (nazhumi.com)" },
     alias: ['域名比价'],
     params: {
-        suffix: { type: 'string', description: '域名后缀（com、.cn、.co.uk）或完整域名' },
-        order: { type: 'string', description: '注册(register) / 续费(renew) / 转入(transfer)，默认注册' },
+        suffix: { type: 'string', description: '域名后缀（com、.cn、.co.uk）或完整域名', descriptionI18n: { en: "Domain suffix (com, .cn, .co.uk) or a full domain" } },
+        order: { type: 'string', description: '注册(register) / 续费(renew) / 转入(transfer)，默认注册', descriptionI18n: { en: "register (default), renew, or transfer" } },
     },
-    async execute({ params, input, use, signal }) {
+    async execute({ params, input, use, signal, locale }) {
         const service = use(nettoolsServiceToken);
         const suffix = String(params.suffix ?? '');
         const order = params.order == null ? undefined : String(params.order);
         const callerKey = commandCallerKey(input);
-        return service.run(() => service.domainPrice(suffix, order, callerKey, signal));
+        return service.run(() => service.domainPrice(suffix, order, callerKey, signal, locale), locale);
     },
 });

package/commands/domain-price/[suffix]/[[order]]/index.ts

@@ -3,17 +3,17 @@ import { commandCallerKey } from '../../../../src/cooldown.js';
 import { nettoolsServiceToken } from '../../../../src/runtime.js';
 
 export default defineCommand({
-  description: '域名注册/续费/转入价格比价（nazhumi.com）',
+  description: '域名注册/续费/转入价格比价（nazhumi.com）', descriptionI18n: { en: "Compare domain registration, renewal and transfer prices (nazhumi.com)" },
   alias: ['域名比价'],
   params: {
-    suffix: { type: 'string', description: '域名后缀（com、.cn、.co.uk）或完整域名' },
-    order: { type: 'string', description: '注册(register) / 续费(renew) / 转入(transfer)，默认注册' },
+    suffix: { type: 'string', description: '域名后缀（com、.cn、.co.uk）或完整域名', descriptionI18n: { en: "Domain suffix (com, .cn, .co.uk) or a full domain" } },
+    order: { type: 'string', description: '注册(register) / 续费(renew) / 转入(transfer)，默认注册', descriptionI18n: { en: "register (default), renew, or transfer" } },
   },
-  async execute({ params, input, use, signal }) {
+  async execute({ params, input, use, signal, locale }) {
     const service = use(nettoolsServiceToken);
     const suffix = String(params.suffix ?? '');
     const order = params.order == null ? undefined : String(params.order);
     const callerKey = commandCallerKey(input);
-    return service.run(() => service.domainPrice(suffix, order, callerKey, signal));
+    return service.run(() => service.domainPrice(suffix, order, callerKey, signal, locale), locale);
   },
 });

package/commands/ping/[host]/index.js

@@ -3,12 +3,12 @@ import { defineCommand } from 'zhin.js/command';
 import { commandCallerKey } from "../../../lib/cooldown.js";
 import { nettoolsServiceToken } from "../../../lib/runtime.js";
 export default defineCommand({
-    description: '从多个地区 Ping 一个公网主机（check-host.net）',
-    params: { host: { type: 'string', description: '域名或公网 IP' } },
-    async execute({ params, input, use, signal }) {
+    description: '从多个地区 Ping 一个公网主机（check-host.net）', descriptionI18n: { en: "Ping a public host from multiple regions (check-host.net)" },
+    params: { host: { type: 'string', description: '域名或公网 IP', descriptionI18n: { en: "Domain name or public IP address" } } },
+    async execute({ params, input, use, signal, locale }) {
         const service = use(nettoolsServiceToken);
         const host = String(params.host ?? '');
         const callerKey = commandCallerKey(input);
-        return service.run(() => service.ping(host, callerKey, signal));
+        return service.run(() => service.ping(host, callerKey, signal, locale), locale);
     },
 });

package/commands/ping/[host]/index.ts

@@ -3,12 +3,12 @@ import { commandCallerKey } from '../../../src/cooldown.js';
 import { nettoolsServiceToken } from '../../../src/runtime.js';
 
 export default defineCommand({
-  description: '从多个地区 Ping 一个公网主机（check-host.net）',
-  params: { host: { type: 'string', description: '域名或公网 IP' } },
-  async execute({ params, input, use, signal }) {
+  description: '从多个地区 Ping 一个公网主机（check-host.net）', descriptionI18n: { en: "Ping a public host from multiple regions (check-host.net)" },
+  params: { host: { type: 'string', description: '域名或公网 IP', descriptionI18n: { en: "Domain name or public IP address" } } },
+  async execute({ params, input, use, signal, locale }) {
     const service = use(nettoolsServiceToken);
     const host = String(params.host ?? '');
     const callerKey = commandCallerKey(input);
-    return service.run(() => service.ping(host, callerKey, signal));
+    return service.run(() => service.ping(host, callerKey, signal, locale), locale);
   },
 });

package/commands/whois/[domain]/index.js

@@ -3,12 +3,12 @@ import { defineCommand } from 'zhin.js/command';
 import { commandCallerKey } from "../../../lib/cooldown.js";
 import { nettoolsServiceToken } from "../../../lib/runtime.js";
 export default defineCommand({
-    description: '查询域名注册信息（RDAP / WHOIS）',
-    params: { domain: { type: 'string', description: '要查询的域名' } },
-    async execute({ params, input, use, signal }) {
+    description: '查询域名注册信息（RDAP / WHOIS）', descriptionI18n: { en: "Look up domain registration information using RDAP / WHOIS" },
+    params: { domain: { type: 'string', description: '要查询的域名', descriptionI18n: { en: "Domain to look up" } } },
+    async execute({ params, input, use, signal, locale }) {
         const service = use(nettoolsServiceToken);
         const domain = String(params.domain ?? '');
         const callerKey = commandCallerKey(input);
-        return service.run(() => service.whois(domain, callerKey, signal));
+        return service.run(() => service.whois(domain, callerKey, signal, locale), locale);
     },
 });

package/commands/whois/[domain]/index.ts

@@ -3,12 +3,12 @@ import { commandCallerKey } from '../../../src/cooldown.js';
 import { nettoolsServiceToken } from '../../../src/runtime.js';
 
 export default defineCommand({
-  description: '查询域名注册信息（RDAP / WHOIS）',
-  params: { domain: { type: 'string', description: '要查询的域名' } },
-  async execute({ params, input, use, signal }) {
+  description: '查询域名注册信息（RDAP / WHOIS）', descriptionI18n: { en: "Look up domain registration information using RDAP / WHOIS" },
+  params: { domain: { type: 'string', description: '要查询的域名', descriptionI18n: { en: "Domain to look up" } } },
+  async execute({ params, input, use, signal, locale }) {
     const service = use(nettoolsServiceToken);
     const domain = String(params.domain ?? '');
     const callerKey = commandCallerKey(input);
-    return service.run(() => service.whois(domain, callerKey, signal));
+    return service.run(() => service.whois(domain, callerKey, signal, locale), locale);
   },
 });

package/lib/address-policy.d.ts

@@ -1,3 +1,4 @@
+import { type NettoolsMessage } from './messages.js';
 export type ParsedHost = {
     readonly kind: 'ipv4';
     readonly address: string;
@@ -15,6 +16,7 @@ export type AddressVerdict = {
 } | {
     readonly blocked: true;
     readonly reason: string;
+    readonly detail: NettoolsMessage;
 };
 export interface ParseHostOptions {
     /** Allow `_` in labels (needed for DNS names such as `_dmarc.example.com`). */

package/lib/address-policy.js

@@ -1,3 +1,4 @@
+import { message, formatMessage } from './messages.js';
 /**
  * Target address policy (SSRF guard).
  *
@@ -26,10 +27,10 @@
 import { isIPv4, isIPv6 } from 'node:net';
 import { NettoolsError } from './errors.js';
 const ALLOWED = Object.freeze({ blocked: false });
-function blocked(reason) {
-    return Object.freeze({ blocked: true, reason });
+function blocked(detail) {
+    return Object.freeze({ blocked: true, reason: formatMessage(detail), detail });
 }
-const CLOUD_METADATA_REASON = '云服务元数据地址';
+const CLOUD_METADATA_REASON = message('cloudMetadata');
 /** Exact IPv4 metadata endpoints, checked before the range table for a clearer message. */
 const CLOUD_METADATA_IPV4 = new Set([
     '169.254.169.254', // AWS / GCP / Azure / Oracle / OpenStack instance metadata
@@ -41,29 +42,29 @@ const CLOUD_METADATA_IPV4 = new Set([
 /** Exact IPv6 metadata endpoints. */
 const CLOUD_METADATA_IPV6 = ['fd00:ec2::254', 'fd00:ec2::23'];
 const BLOCKED_IPV4_RANGES = [
-    ipv4Rule('0.0.0.0', 8, '未指定 / “本网络”地址'),
-    ipv4Rule('10.0.0.0', 8, '私有地址 (RFC 1918)'),
-    ipv4Rule('100.64.0.0', 10, '运营商级 NAT 地址 (CGNAT, RFC 6598)'),
-    ipv4Rule('127.0.0.0', 8, '回环地址'),
-    ipv4Rule('169.254.0.0', 16, '链路本地地址'),
-    ipv4Rule('172.16.0.0', 12, '私有地址 (RFC 1918)'),
-    ipv4Rule('192.0.0.0', 24, 'IETF 协议保留地址'),
-    ipv4Rule('192.0.2.0', 24, '文档示例地址'),
-    ipv4Rule('192.88.99.0', 24, '已废弃的 6to4 中继地址'),
-    ipv4Rule('192.168.0.0', 16, '私有地址 (RFC 1918)'),
-    ipv4Rule('198.18.0.0', 15, '基准测试保留地址'),
-    ipv4Rule('198.51.100.0', 24, '文档示例地址'),
-    ipv4Rule('203.0.113.0', 24, '文档示例地址'),
-    ipv4Rule('224.0.0.0', 4, '组播地址'),
-    ipv4Rule('240.0.0.0', 4, '保留地址（含广播地址）'),
+    ipv4Rule('0.0.0.0', 8, message('unspecifiedV4')),
+    ipv4Rule('10.0.0.0', 8, message('privateV4')),
+    ipv4Rule('100.64.0.0', 10, message('cgnat')),
+    ipv4Rule('127.0.0.0', 8, message('loopback')),
+    ipv4Rule('169.254.0.0', 16, message('linkLocal')),
+    ipv4Rule('172.16.0.0', 12, message('privateV4')),
+    ipv4Rule('192.0.0.0', 24, message('ietfReserved')),
+    ipv4Rule('192.0.2.0', 24, message('documentation')),
+    ipv4Rule('192.88.99.0', 24, message('relay6to4')),
+    ipv4Rule('192.168.0.0', 16, message('privateV4')),
+    ipv4Rule('198.18.0.0', 15, message('benchmark')),
+    ipv4Rule('198.51.100.0', 24, message('documentation')),
+    ipv4Rule('203.0.113.0', 24, message('documentation')),
+    ipv4Rule('224.0.0.0', 4, message('multicast')),
+    ipv4Rule('240.0.0.0', 4, message('reservedBroadcast')),
 ];
 /** Special IPv6 ranges inside 2000::/3 that are still refused. */
 const BLOCKED_GLOBAL_IPV6_RANGES = [
-    ipv6Rule('2001::', 32, 'Teredo 隧道地址'),
-    ipv6Rule('2001:2::', 48, '基准测试保留地址'),
-    ipv6Rule('2001:10::', 28, 'ORCHID 保留地址'),
-    ipv6Rule('2001:db8::', 32, '文档示例地址'),
-    ipv6Rule('3fff::', 20, '文档示例地址'),
+    ipv6Rule('2001::', 32, message('teredo')),
+    ipv6Rule('2001:2::', 48, message('benchmark')),
+    ipv6Rule('2001:10::', 28, message('orchid')),
+    ipv6Rule('2001:db8::', 32, message('documentation')),
+    ipv6Rule('3fff::', 20, message('documentation')),
 ];
 const BLOCKED_HOSTNAMES = new Set([
     'localhost',
@@ -105,19 +106,19 @@ const MAX_LABEL_LENGTH = 63;
 export function parseHostInput(input, options = {}) {
     const trimmed = input.trim();
     if (trimmed.length === 0) {
-        throw invalid('请提供主机名或 IP 地址');
+        throw invalid(message('hostRequired'));
     }
     if (trimmed.length > MAX_HOSTNAME_LENGTH + 2) {
-        throw invalid('主机名过长');
+        throw invalid(message('hostTooLong'));
     }
     if (/[\s/\\@?#%]/u.test(trimmed)) {
-        throw invalid('只接受裸主机名或 IP，不要带协议、端口、路径或特殊字符');
+        throw invalid(message('bareHost'));
     }
     const bracketed = trimmed.startsWith('[') && trimmed.endsWith(']');
     const ipv6Candidate = bracketed ? trimmed.slice(1, -1) : trimmed;
     if (bracketed || trimmed.includes(':')) {
         if (!isIPv6(ipv6Candidate)) {
-            throw invalid('不是有效的 IPv6 地址（如需端口请去掉端口）');
+            throw invalid(message('ipv6NoPort'));
         }
         const canonical = canonicalizeWithUrlParser(`[${ipv6Candidate}]`);
         const address = canonical.slice(1, -1);
@@ -142,33 +143,33 @@ function canonicalizeWithUrlParser(host) {
     const result = probe.hostname;
     const unchanged = result === placeholder && host.toLowerCase() !== placeholder;
     if (unchanged || result.length === 0) {
-        throw invalid('不是有效的主机名或 IP 地址');
+        throw invalid(message('invalidHost'));
     }
     return result;
 }
 function validateDomainSyntax(name, options) {
     if (name.length === 0 || name.length > MAX_HOSTNAME_LENGTH) {
-        throw invalid('主机名长度不合法');
+        throw invalid(message('hostLength'));
     }
     const labels = name.split('.');
     if (labels.length < (options.minLabels ?? 2)) {
-        throw invalid('请提供完整域名（例如 example.com）');
+        throw invalid(message('fullDomain'));
     }
     const labelPattern = options.allowUnderscore
         ? /^[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?$/u
         : /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/u;
     for (const label of labels) {
         if (label.length === 0 || label.length > MAX_LABEL_LENGTH || !labelPattern.test(label)) {
-            throw invalid(`域名标签不合法：${label || '(空)'}`);
+            throw invalid(message('invalidLabel', { label: label || message('empty') }));
         }
     }
     const topLevel = labels[labels.length - 1] ?? '';
     if (/^\d+$/u.test(topLevel)) {
-        throw invalid('顶级域不能是纯数字');
+        throw invalid(message('numericTld'));
     }
 }
-function invalid(message) {
-    return new NettoolsError('invalid_input', message);
+function invalid(detail) {
+    return new NettoolsError('invalid_input', detail);
 }
 /* ------------------------------------------------------------------ */
 /* Classification                                                      */
@@ -187,7 +188,7 @@ export function classifyParsedHost(host) {
 export function classifyAddress(address) {
     const parsed = parseHostInput(address);
     if (parsed.kind === 'domain') {
-        throw invalid(`不是 IP 地址：${address}`);
+        throw invalid(message('notIp', { address }));
     }
     return classifyParsedHost(parsed);
 }
@@ -195,12 +196,12 @@ export function classifyHostname(name) {
     const normalized = name.toLowerCase().replace(/\.$/u, '');
     if (BLOCKED_HOSTNAMES.has(normalized)) {
         return normalized.startsWith('localhost')
-            ? blocked('本机主机名')
+            ? blocked(message('localhost'))
             : blocked(CLOUD_METADATA_REASON);
     }
     for (const suffix of BLOCKED_SUFFIXES) {
         if (normalized === suffix || normalized.endsWith(`.${suffix}`)) {
-            return blocked(`内网或保留域名后缀 .${suffix}`);
+            return blocked(message('reservedSuffix', { suffix }));
         }
     }
     return ALLOWED;
@@ -229,11 +230,11 @@ const MULTICAST_PREFIX = ipv6ToBytes('ff00::');
 const CLOUD_METADATA_IPV6_BYTES = CLOUD_METADATA_IPV6.map((address) => ipv6ToBytes(address));
 function classifyIpv6Bytes(bytes) {
     if (bytes.every((byte) => byte === 0)) {
-        return blocked('未指定地址 (::)');
+        return blocked(message('unspecifiedV6'));
     }
     const isLoopback = bytes.slice(0, 15).every((byte) => byte === 0) && bytes[15] === 1;
     if (isLoopback) {
-        return blocked('回环地址 (::1)');
+        return blocked(message('loopbackV6'));
     }
     for (const metadata of CLOUD_METADATA_IPV6_BYTES) {
         if (matchesPrefix(bytes, metadata, 128)) {
@@ -241,31 +242,31 @@ function classifyIpv6Bytes(bytes) {
         }
     }
     if (matchesPrefix(bytes, IPV4_MAPPED_PREFIX, 96)) {
-        return classifyEmbeddedIpv4(bytes.slice(12, 16), 'IPv4 映射地址');
+        return classifyEmbeddedIpv4(bytes.slice(12, 16), message('mappedV4'));
     }
     if (matchesPrefix(bytes, NAT64_WELL_KNOWN_PREFIX, 96)) {
-        return classifyEmbeddedIpv4(bytes.slice(12, 16), 'NAT64 地址');
+        return classifyEmbeddedIpv4(bytes.slice(12, 16), message('nat64'));
     }
     if (matchesPrefix(bytes, NAT64_LOCAL_PREFIX, 48)) {
-        return blocked('本地 NAT64 地址');
+        return blocked(message('localNat64'));
     }
     if (matchesPrefix(bytes, SIX_TO_FOUR_PREFIX, 16)) {
-        return classifyEmbeddedIpv4(bytes.slice(2, 6), '6to4 地址');
+        return classifyEmbeddedIpv4(bytes.slice(2, 6), message('sixToFour'));
     }
     if (matchesPrefix(bytes, UNIQUE_LOCAL_PREFIX, 7)) {
-        return blocked('唯一本地地址 (ULA, fc00::/7)');
+        return blocked(message('ula'));
     }
     if (matchesPrefix(bytes, LINK_LOCAL_PREFIX, 10)) {
-        return blocked('链路本地地址 (fe80::/10)');
+        return blocked(message('linkLocalV6'));
     }
     if (matchesPrefix(bytes, SITE_LOCAL_PREFIX, 10)) {
-        return blocked('已废弃的站点本地地址 (fec0::/10)');
+        return blocked(message('siteLocalV6'));
     }
     if (matchesPrefix(bytes, MULTICAST_PREFIX, 8)) {
-        return blocked('组播地址 (ff00::/8)');
+        return blocked(message('multicastV6'));
     }
     if (!matchesPrefix(bytes, GLOBAL_UNICAST_PREFIX, 3)) {
-        return blocked('非全球单播 IPv6 地址');
+        return blocked(message('notGlobalV6'));
     }
     for (const rule of BLOCKED_GLOBAL_IPV6_RANGES) {
         if (matchesPrefix(bytes, rule.prefix, rule.bits)) {
@@ -280,7 +281,7 @@ function classifyEmbeddedIpv4(embedded, wrapper) {
         return verdict;
     }
     const dotted = Array.from(embedded).join('.');
-    return blocked(`${wrapper}指向 ${dotted}（${verdict.reason}）`);
+    return blocked(message('embeddedV4', { wrapper, address: dotted, reason: verdict.detail }));
 }
 /* ------------------------------------------------------------------ */
 /* Byte helpers                                                        */
@@ -307,7 +308,7 @@ export function ipv4ToBytes(address) {
     const parts = address.split('.').map((part) => Number(part));
     const valid = parts.length === 4 && parts.every((part) => Number.isInteger(part) && part >= 0 && part <= 255);
     if (!valid) {
-        throw invalid(`不是有效的 IPv4 地址：${address}`);
+        throw invalid(message('invalidV4', { address }));
     }
     return Uint8Array.from(parts);
 }
@@ -326,13 +327,13 @@ export function ipv6ToBytes(address) {
     }
     const halves = text.split('::');
     if (halves.length > 2) {
-        throw invalid(`不是有效的 IPv6 地址：${address}`);
+        throw invalid(message('invalidV6', { address }));
     }
     const head = parseGroups(halves[0] ?? '');
     const rest = halves.length === 2 ? parseGroups(halves[1] ?? '') : [];
     const missing = 8 - head.length - rest.length;
     if (halves.length === 2 ? missing < 1 : missing !== 0) {
-        throw invalid(`不是有效的 IPv6 地址：${address}`);
+        throw invalid(message('invalidV6', { address }));
     }
     groups.push(...head);
     for (let index = 0; index < missing && halves.length === 2; index += 1) {
@@ -355,7 +356,7 @@ function parseGroups(text) {
     }
     return text.split(':').map((group) => {
         if (!/^[0-9a-f]{1,4}$/u.test(group)) {
-            throw invalid(`IPv6 分组不合法：${group}`);
+            throw invalid(message('invalidV6Group', { group }));
         }
         return Number.parseInt(group, 16);
     });
@@ -379,7 +380,7 @@ export function reverseLookupName(host) {
         }
         return `${nibbles.reverse().join('.')}.ip6.arpa`;
     }
-    throw invalid('反向解析需要 IP 地址');
+    throw invalid(message('reverseNeedsIp'));
 }
 /** Human label for a parsed host. */
 export function displayHost(host) {