@lansenger-pm/openclaw-lansenger-channel 3.12.2 → 3.13.0

package/CHANGELOG.md

@@ -4,70 +4,81 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
 
-## [3.12.2] - 2026-06-03
+## [3.13.0] - 2026-06-03
+
+> **Compatible with OpenClaw `^2026.5.28`** (tested against `2026.5.28`).
+
+### Bug Fix
+
+- **Missing `dist/src/setup-i18n.*` in npm package**: `setup-wizard.js` imports `./setup-i18n.js`, but the `files` field in `package.json` did not include `dist/src/setup-i18n.*`, causing `Cannot find module './setup-i18n.js'` at gateway startup. Added `dist/src/setup-i18n.*` to the `files` array.
 
 ### Outbound Hook Expansion
 
-- **`reply_payload_sending` hook**: Register typed plugin hook via `api.on()` for lansenger channel. Intercepts reply payloads before delivery for logging, approval context injection, and payload rewrite/cancel decisions.
-- **`normalizePayload` expansion**: Code block detection (`\`\`\``) now marks `_lansengerFormatText: true` even when payload has `mediaUrl` or `presentation`, ensuring Markdown rendering for code-rich replies.
-- **`beforeDeliverPayload` approval-resolved**: When `hint.kind === "approval-resolved"`, proactively updates the original appCard status via `updateDynamicCard`. Provides crash-recovery safety for card status updates since the delivery pipeline replays on gateway restart.
-- **`shouldSuppressLocalPayloadPrompt`**: Suppresses local text prompt when native approval route is active (`hint.kind === "approval-pending"` with `nativeRouteActive === true`). Prevents duplicate approval prompts (native appCard + local text).
-- **`pendingApprovalCards` Map**: Tracks sent approval card messageIds keyed by chatId, enabling `beforeDeliverPayload` to correlate approval-resolved payloads with the original card.
+- **`reply_payload_sending` hook**: Register typed plugin hook via `api.on()` for the lansenger channel. Intercepts reply payloads before delivery — enables logging, approval context injection, and payload rewrite/cancel decisions.
+- **`message_sending` hook**: Register hook in gateway startup for early-stage reply interception.
+- **`normalizePayload` — code-block detection**: Payloads containing `\`\`\`` code fences are now marked `_lansengerFormatText: true` even when they also carry `mediaUrl` or `presentation`. Previously, code-rich agent replies with attachments fell back to plain-text `msgType`, losing Markdown formatting. Now they always render via `formatText`.
+- **`beforeDeliverPayload` — approval-resolved crash recovery**: When `hint.kind === "approval-resolved"`, the delivery pipeline now proactively updates the original appCard status via `updateDynamicCard`. Because the delivery pipeline replays on gateway restart, this provides crash-recovery safety.
+- **`shouldSuppressLocalPayloadPrompt`**: Suppresses the local text prompt when the native approval route is active (`hint.kind === "approval-pending"` with `nativeRouteActive === true`). Prevents duplicate approval prompts.
+- **`pendingApprovalCards` Map**: Tracks sent approval card `messageId`s keyed by `chatId`. Enables `beforeDeliverPayload` to correlate approval-resolved payloads with the original card for status updates.
 - **Text chunking**: Add `textChunkLimit: 4000`, `chunkerMode: "markdown"`, and `chunker` (using SDK `chunkMarkdownTextWithMode`). Long agent replies are automatically split into multiple Lansenger messages, preserving Markdown structure across chunks.
 - **`resolveEffectiveTextChunkLimit`**: Uses SDK `resolveTextChunkLimit` to allow config-level override of the chunk limit.
+- Add `normalizePayload` and `beforeDeliverPayload` callbacks on outbound base (structural preparation for outbound hooks).
+- Add session-scoped delivery dedup (`sessionDeliveryTracker`) to prevent duplicate sends across turns in the same session.
 
-### Approval Flow Enhancement
+### OpenClaw 2026.5.27–28 Compatibility
 
-- `approvalCapability.transport.send` now stores card `messageId` in `pendingApprovalCards` Map for later correlation in `beforeDeliverPayload`.
-- Card status updates (pending → approved/denied) now happen both via `transport.update` (approval framework) and `beforeDeliverPayload` (delivery pipeline). The latter provides crash-recovery safety.
+- Migrate `api.runtime.channel.turn` → `api.runtime.channel.inbound` (OpenClaw removed the old `turn` runtime alias; the new `inbound` namespace provides the same `run` function with identical parameters). This is a **required** migration — the old `turn` alias no longer exists in OpenClaw 2026.5.27.
+- Thread canonical `sessionKey` into outbound hooks (`sendText`, `sendMedia`, `sendFormattedText`) for multi-session/multi-agent routing and dedup.
+- Fallback `sessionKey` now includes `accountId` for multi-bot scenarios (`agent:main:lansenger:<accountId>:<chatType>:<chatId>`).
+- Pin npm install spec to exact version (`@lansenger-pm/openclaw-lansenger-channel@3.13.0`) to prevent supply-chain attacks and accidental upgrades.
+- Bump `openclaw` devDependency from `^2026.5.20` to `^2026.5.28`.
+- Split changelog out of READMEs into standalone `CHANGELOG.md` (all 5 locale READMEs now reference this file).
 
-## [3.12.1] - 2026-06-03
+### Approval Flow Enhancement
 
-### OpenClaw 2026.5.28 Compatibility
+- `approvalCapability.transport.send` now stores card `messageId` in `pendingApprovalCards` for later correlation in `beforeDeliverPayload`.
+- Card status updates (pending → approved/denied) now happen via both `transport.update` (approval framework) and `beforeDeliverPayload` (delivery pipeline). The latter provides crash-recovery safety.
 
-- Pin npm install spec to exact version (`@lansenger-pm/openclaw-lansenger-channel@3.12.1`) to prevent supply-chain attacks and accidental upgrades.
-- Thread canonical `sessionKey` into outbound hooks (`sendText`, `sendMedia`, `sendFormattedText`) for multi-session/multi-agent routing and dedup.
-- Register `message_sending` hook in gateway startup for early-stage reply interception.
-- Add `normalizePayload` and `beforeDeliverPayload` callbacks on outbound base (structural preparation for `reply_payload_sending` hook).
-- Add session-scoped delivery dedup (`sessionDeliveryTracker`) to prevent duplicate sends across turns in the same session.
-- Fallback `sessionKey` now includes `accountId` for multi-bot scenarios (`agent:main:lansenger:<accountId>:<chatType>:<chatId>`).
-- Bump `openclaw` devDependency to `^2026.5.28`.
+### Setup Wizard i18n
+
+- **Locale-aware setup wizard**: Replace all bilingual hard-coded strings (`"Chinese / English"`) with `createSetupTranslator()` + plugin-owned dictionary. The wizard now displays in the user's locale (resolved from `OPENCLAW_LOCALE` → `LC_ALL` → `LC_MESSAGES` → `LANG`, fallback English).
+- Supported locales: **`en`**, **`zh-CN`**, **`zh-TW`**. French and other locales fall back to English for wizard prompts (READMEs remain 5-language).
+- Common strings (status labels, "Docs:" prefix, etc.) use the built-in OpenClaw catalog keys (`wizard.channels.*`). Plugin-specific strings use a local dictionary with `lt()`.
+- New file: `src/setup-i18n.ts` — locale resolver + 40+ entry dictionary.
 
 ### Security
 
-- **SecretRef support for appSecret**: `resolveAccount()` now detects SecretRef objects via `coerceSecretRef()` and resolves from env vars. No need to store appSecret as plaintext in config.
-- **Plaintext appSecret warning**: `resolveAccount()` now emits a `log.warn` when `appSecret` is stored as a plaintext string in `openclaw.json`, advising migration to SecretRef via `openclaw secrets configure`.
-- **README security notes**: All 5 locale READMEs now include a prominent security advisory urging users to migrate plaintext `appSecret` to SecretRef storage.
-- **SSRF protection for sendImageUrl**: `assertHttpUrlTargetsPrivateNetwork()` blocks RFC1918/link-local/metadata-IP targets by default (aligned with Feishu/Discord/BlueBubbles channels in 2026.5.28).
+- **SecretRef support for appSecret**: `resolveAccount()` now detects SecretRef objects via `coerceSecretRef()` and resolves from env vars. No need to store appSecret as plaintext in config. After running `openclaw secrets configure`, the config contains `__OPENCLAW_SECRET__({ref_id})` instead of the raw secret value, while the actual value is stored in the system credential store.
+- **Plaintext appSecret warning in `resolveAccount()`**: Emits `log.warn` on every gateway startup when `appSecret` is stored as a plaintext string in `openclaw.json`, advising migration to SecretRef via `openclaw secrets configure`.
+- **Plaintext appSecurity warning in setup wizard `finalize`**: Console output in the user's locale when plaintext appSecret is detected after config migration.
+- **`securityNote` in setup wizard**: A conditional note that appears only when a plaintext appSecret exists, with locale-appropriate migration instructions.
+- **README security advisory**: All 5 locale READMEs now include a prominent `⚠️ Security: Migrate appSecret to SecretRef storage` block.
+- **SSRF protection for sendImageUrl**: `assertHttpUrlTargetsPrivateNetwork()` blocks RFC1918/link-local/metadata-IP targets by default.
 - **`dangerouslyAllowPrivateNetwork` config**: Opt-in at top-level or per-account to allow private network image URLs. Audit finding (`lansenger/dangerously-allow-private-network`) warns when enabled.
-- **`mediaLocalRoots` config**: Restrict local file delivery to configured directories. If empty, all paths allowed. Prevents agents from accessing arbitrary files outside allowed roots. Available at top-level and per-account.
+- **`mediaLocalRoots` config**: Restrict local file delivery to configured directories. Prevents agents from accessing arbitrary files outside allowed roots. Available at top-level and per-account.
 - **Path validation**: `isPathAllowed()` validates local file paths against `mediaLocalRoots` before delivery; blocked paths are logged and skipped.
 
-## [3.12.0] - 2026-05-29
-
-### OpenClaw 2026.5.27 Compatibility
-
-- Migrate `api.runtime.channel.turn` → `api.runtime.channel.inbound` (OpenClaw removed the old `turn` runtime alias from `PluginRuntimeChannel`; the new `inbound` namespace provides the same `run` function with identical parameters).
-- Bump `openclaw` devDependency from `^2026.5.20` to `^2026.5.27`.
-- Split changelog out of READMEs into standalone `CHANGELOG.md` (all 5 locale READMEs now reference this file).
-
 ## [3.11.0] - 2026-05-26
 
+> **Compatible with OpenClaw `^2026.5.20`** (tested against `2026.5.20` and `2026.5.22`).
+
 ### Breaking Changes
 
-- Remove `child_process` dependency (was blocking OpenClaw install due to security scan).
-- Video messages now require manual `coverImagePath` + `videoWidth`/`videoHeight`/`videoDuration` params (use ffmpeg/ffprobe before calling send-file; auto-probing removed because it depended on child_process).
+- Remove `child_process` dependency (was blocking OpenClaw install due to security scan). OpenClaw's built-in dangerous-code scanner flagged `child_process` as a critical pattern and blocked plugin installation — users could not install without `--dangerously-force-unsafe-install`. v3.11.0 removes all `child_process` usage, so the plugin installs cleanly without override flags.
+- Video messages now require **4 manual parameters**: `coverImagePath`, `videoWidth`, `videoHeight`, `videoDuration`. Previous v3.10.0 auto-extracted these via ffmpeg/ffprobe (which depended on `child_process`). Now the agent must use ffmpeg/ffprobe before calling send-file. See the skill docs for exact commands.
 
 ### Bug Fixes
 
-- Inbound video cover downloaded as image type (previously misclassified).
+- Inbound video cover downloaded as image type (previously misclassified as video type).
 
 ## [3.10.0] - 2026-05-22
 
+> **Compatible with OpenClaw `^2026.5.20`** (tested against `2026.5.22`).
+
 ### Features
 
 - Fix video message: Lansenger API requires `mediaIds=[video, coverImage]` (2 elements). `sendFile()` auto-extracts first frame via ffmpeg and uploads as cover image.
-- `send-text` with file attachment now uses correct mediaType instead of hardcoded `3`.
+- `send-text` with file attachment now uses correct `mediaType` instead of hardcoded `3`.
 
 ### Bug Fixes
 
@@ -76,6 +87,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [3.9.0] - 2026-05-20
 
+> **Compatible with OpenClaw `^2026.5.20`** (tested against `2026.5.20`).
+
 ### Features
 
 - Switch file upload to `/v1/app/medias/create` API (supports larger files up to 10M/20M, uses string type `image`/`video`/`audio`/`file` instead of numeric media type).
@@ -83,15 +96,19 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [3.8.2] - 2026-05-20
 
+> **Compatible with OpenClaw `^2026.5.20`** (tested against `2026.5.20`).
+
 ### Features
 
 - Add `security.collectWarnings` and `security.collectAuditFindings` for `openclaw doctor --lint` integration. Checks: credentials missing/incomplete, dmPolicy not pairing, apiGatewayUrl not set, group config unused.
 - Add `doctor.repairConfig` to auto-fix dmPolicy to pairing.
-- Require OpenClaw >= 2026.5.20.
+- Bump `openclaw` devDependency from `^2026.5.7` to `^2026.5.20`.
 - Fix apiGatewayUrl lint check to skip when accounts have gateway set.
 
 ## [3.7.9] - 2026-05-18
 
+> **Compatible with OpenClaw `^2026.5.7`**. This is the last release compatible with OpenClaw 2026.5.7. The next version (v3.8.2) raises the minimum to `^2026.5.20`.
+
 ### Features
 
 - **Inbound debounce**: integrate OpenClaw `messages.inbound.debounceMs` for merging rapid consecutive messages (uses `createChannelInboundDebouncer` + `shouldDebounceTextInbound` from `openclaw/plugin-sdk/channel-inbound`).
@@ -108,6 +125,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [3.6.0] - 2026-05-16
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Bug Fixes
 
 - Fix health-monitor infinite restart loop: register `gateway.startAccount`/`stopAccount` so channelManager runtime store gets `running=true` + `connected=true`.
@@ -116,6 +135,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [3.5.0] - 2026-05-14
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Features
 
 - **Per-turn dedup**: prevent duplicate text/media delivery within a single inbound turn.
@@ -130,6 +151,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [3.4.5] - 2026-05-12
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Bug Fixes
 
 - Fix duplicate delivery — `deliver()` deferred to outbound adapter; text dedup + empty caption for files.
@@ -137,6 +160,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [3.3.0] - 2026-05-10
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Features
 
 - **Merge tools into channel plugin**: all 9 agent tools (`send_file`, `send_text`, `send_format_text`, `send_image_url`, `revoke_message`, `send_link_card`, `send_app_articles`, `send_app_card`, `update_dynamic_card`, `query_groups`) are now built-in. No separate `openclaw-lansenger-tools` plugin needed.
@@ -146,6 +171,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [3.2.10] - 2026-05-08
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Features
 
 - Startup warning for missing `group:plugins` in tool allowlist (`openclaw doctor` integration).
@@ -157,6 +184,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [3.1.0] - 2026-05-06
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Features
 
 - **Multi-account setup wizard**: add multiple bots with independent App IDs; agent routing via `bindings[]` config.
@@ -167,6 +196,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [3.0.0] - 2026-05-04
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Features
 
 - Add `lansenger_send_format_text` tool (Markdown + @mention support via `formatText` API).
@@ -181,6 +212,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [2.10.0] - 2026-04-28
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Features
 
 - **px→pt auto-conversion**: `sendAppCard` converts CSS `font-size` from px to pt (Lansenger requires pt; px renders incorrectly).
@@ -189,6 +222,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [2.9.12] - 2026-04-26
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Features
 
 - **Status adapter**: expose channel status via `buildChannelSummary` + `probeAccount` + `buildAccountSnapshot`.
@@ -198,6 +233,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [2.8.1] - 2026-04-24
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Features
 
 - **OpenClaw bindings multi-agent routing**: use `resolveAgentRoute` from SDK for agent routing; remove per-account `agentId` and `BindingManager`/`execSync` dependency.
@@ -207,6 +244,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [2.7.0] - 2026-04-22
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Features
 
 - Register tools as plain objects (not factory functions) — external plugin capture API only accepts non-function tool descriptors.
@@ -215,6 +254,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [2.6.0] - 2026-04-20
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Bug Fixes
 
 - Register tools unconditionally — resolve account at execute time instead of registration time (fixes `tools.allow 'no registered tools matched'`).
@@ -222,6 +263,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [2.5.0] - 2026-04-18
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Features
 
 - `formatText` reminder support (auto-fallback: strips reminder on API error).
@@ -232,6 +275,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [2.4.0] - 2026-04-16
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Bug Fixes
 
 - Fix message body assembly: `wrap()` excludes `msgType` from `msgData`; `appArticles` uses correct `msgType`/`summary`/flat array.
@@ -239,12 +284,16 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [2.3.0] - 2026-04-14
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Features
 
 - Remove legacy `sendGroupText`/`sendGroupFormatText`; all routing via `msgTarget(chatId)` helper (determines private vs group endpoint automatically).
 
 ## [2.2.0] - 2026-04-12
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Features
 
 - Add 9 dedicated agent tools: `send_file`, `send_text`, `send_format_text`, `send_image_url`, `revoke_message`, `send_link_card`, `send_app_articles`, `send_app_card`, `update_dynamic_card`, `query_groups`.
@@ -256,6 +305,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [2.1.0] - 2026-04-10
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Features
 
 - **sendAttachment → send action**: merge `sendAttachment` into `send` action — `filePath` param in `send` action sends file, no MEDIA tags needed. Align with Telegram pattern.
@@ -263,6 +314,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [2.0.0] - 2026-04-08
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Breaking Changes
 
 - **Migrate to Channel Turn Kernel**: replace `BindingManager`/`execSync` with OpenClaw's `channel.inbound.run` for inbound processing.
@@ -277,6 +330,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [1.0.3] - 2026-04-04
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Features
 
 - Quick Start section in all READMEs: one-command setup with `openclaw channels add`, pairing approval flow.
@@ -292,6 +347,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [1.0.1] - 2026-04-02
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Bug Fixes
 
 - Fix README `dmSecurity` example: `allowlist` → `paired`.
@@ -299,6 +356,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [1.0.0] - 2026-04-01
 
+> **Compatible with OpenClaw `^2026.5.7`**.
+
 ### Initial Release
 
 - Lansenger (蓝信) channel plugin for OpenClaw.

package/dist/src/setup-i18n.js

@@ -0,0 +1,60 @@
+function resolveWizardLocale() {
+    const raw = process.env.OPENCLAW_LOCALE || process.env.LC_ALL || process.env.LC_MESSAGES || process.env.LANG || "";
+    const normalized = (raw.split(".")[0] ?? "").replace(/_/g, "-").toLowerCase();
+    if (normalized.startsWith("zh-tw") || normalized.startsWith("zh-hant"))
+        return "zh-TW";
+    if (normalized.startsWith("zh-cn") || normalized.startsWith("zh-hans"))
+        return "zh-CN";
+    if (normalized.startsWith("zh"))
+        return "zh-CN";
+    return "en";
+}
+const LOCALE = resolveWizardLocale();
+const LANSINGER_I18N = {
+    channelLabel: { en: "Lansenger", "zh-CN": "蓝信", "zh-TW": "藍信" },
+    introTitle: { en: "Lansenger Setup", "zh-CN": "蓝信配置", "zh-TW": "藍信設定" },
+    introDesktopPath: { en: "Lansenger Desktop → Contacts → Bots → Personal Bots", "zh-CN": "蓝信桌面端 → 通讯录 → 智能机器人 → 个人机器人", "zh-TW": "藍信桌面端 → 通訊錄 → 智慧機器人 → 個人機器人" },
+    introClickInfo: { en: "Click the ℹ️ icon to view App ID and App Secret", "zh-CN": "点击 ℹ️ 图标查看凭证", "zh-TW": "點擊 ℹ️ 圖標查看憑證" },
+    introPersonalOnly: { en: "Personal Bots only — organization bots not supported", "zh-CN": "仅支持个人机器人", "zh-TW": "僅支援個人機器人" },
+    introNoMobile: { en: "Mobile client does NOT support viewing credentials", "zh-CN": "移动端不支持查看凭证", "zh-TW": "行動端不支援查看憑證" },
+    introToolsIncluded: { en: "✅ Agent tools are included in this plugin (no separate install needed).", "zh-CN": "✅ 代理工具已内置于此插件，无需单独安装。", "zh-TW": "✅ 代理工具已內建於此插件，無需單獨安裝。" },
+    introCliAlt: { en: "CLI is an optional alternative: pip install lansenger-cli", "zh-CN": "CLI 为可选替代方案：pip install lansenger-cli", "zh-TW": "CLI 為可選替代方案：pip install lansenger-cli" },
+    appIdLabel: { en: "Lansenger App ID", "zh-CN": "蓝信 App ID", "zh-TW": "藍信 App ID" },
+    appIdHelpLine1: { en: "App ID from your Lansenger Personal Bot", "zh-CN": "个人机器人的 App ID", "zh-TW": "個人機器人的 App ID" },
+    appIdHelpLine2: { en: "Found alongside App Secret → Contacts → Bots → Personal Bots", "zh-CN": "通讯录 → 智能机器人 → 个人机器人", "zh-TW": "通訊錄 → 智慧機器人 → 個人機器人" },
+    appIdEnvPrompt: { en: "LANSENGER_APP_ID detected. Use env var?", "zh-CN": "检测到环境变量 LANSENGER_APP_ID，是否使用？", "zh-TW": "偵測到環境變數 LANSENGER_APP_ID，是否使用？" },
+    appIdKeepPrompt: { en: "App ID already configured. Keep it?", "zh-CN": "App ID 已配置，是否保留？", "zh-TW": "App ID 已設定，是否保留？" },
+    appIdInputPrompt: { en: "Enter Lansenger App ID", "zh-CN": "输入蓝信 App ID", "zh-TW": "輸入藍信 App ID" },
+    secretLabel: { en: "Lansenger App Secret", "zh-CN": "蓝信 App Secret", "zh-TW": "藍信 App Secret" },
+    secretHelpLine1: { en: "App Secret from your Lansenger Personal Bot", "zh-CN": "个人机器人的 App Secret", "zh-TW": "個人機器人的 App Secret" },
+    secretHelpLine2: { en: "Found alongside App ID → Contacts → Bots → Personal Bots", "zh-CN": "通讯录 → 智能机器人 → 个人机器人", "zh-TW": "通訊錄 → 智慧機器人 → 個人機器人" },
+    secretEnvPrompt: { en: "LANSENGER_APP_SECRET detected. Use env var?", "zh-CN": "检测到环境变量 LANSENGER_APP_SECRET，是否使用？", "zh-TW": "偵測到環境變數 LANSENGER_APP_SECRET，是否使用？" },
+    secretKeepPrompt: { en: "App Secret already configured. Keep it?", "zh-CN": "App Secret 已配置，是否保留？", "zh-TW": "App Secret 已設定，是否保留？" },
+    secretInputPrompt: { en: "Enter Lansenger App Secret", "zh-CN": "输入蓝信 App Secret", "zh-TW": "輸入藍信 App Secret" },
+    baseUrlMessage: { en: "API Gateway URL (optional, default Lansenger public cloud)", "zh-CN": "API 网关地址（可选，默认蓝信公有云）", "zh-TW": "API 閘道位址（可選，預設藍信公有雲）" },
+    allowFromHelpTitle: { en: "Lansenger user ID", "zh-CN": "蓝信用户 ID", "zh-TW": "藍信使用者 ID" },
+    allowFromHelpLine1: { en: "Lansenger user IDs have format: orgId-applicationId (e.g. xxx-xxxxxxx)", "zh-CN": "蓝信用户 ID 格式：orgId-applicationId（如 xxx-xxxxxxx）", "zh-TW": "藍信使用者 ID 格式：orgId-applicationId（如 xxx-xxxxxxx）" },
+    allowFromMessage: { en: "Lansenger allowFrom (user IDs, format: orgId-applicationId)", "zh-CN": "蓝信允许的用户 ID（格式：orgId-applicationId）", "zh-TW": "藍信允許的使用者 ID（格式：orgId-applicationId）" },
+    allowFromInvalidNote: { en: "Lansenger allowFrom requires user IDs in format appId-userId.", "zh-CN": "蓝信 allowFrom 需要格式为 appId-userId 的用户 ID。", "zh-TW": "藍信 allowFrom 需要格式為 appId-userId 的使用者 ID。" },
+    companionTitle: { en: "Messaging Tools", "zh-CN": "消息工具", "zh-TW": "訊息工具" },
+    companionLine1: { en: "Agent tools (lansenger_send_file, etc.) are included in this plugin — no separate install needed.", "zh-CN": "代理工具（lansenger_send_file 等）已内置于此插件，无需单独安装。", "zh-TW": "代理工具（lansenger_send_file 等）已內建於此插件，無需單獨安裝。" },
+    companionLine2: { en: "CLI is an optional alternative (works via bash):", "zh-CN": "CLI 为可选替代方案（通过 bash 调用）：", "zh-TW": "CLI 為可選替代方案（透過 bash 呼叫）：" },
+    companionLine3: { en: "Without CLI, the agent can still use built-in tools for files, cards, and formatted messages.", "zh-CN": "未安装 CLI 时，代理仍可使用内置工具发送文件、卡片和格式化消息。", "zh-TW": "未安裝 CLI 時，代理仍可使用內建工具傳送檔案、卡片和格式化訊息。" },
+    securityTitle: { en: "⚠️ Security: Plaintext appSecret", "zh-CN": "⚠️ 安全：appSecret 明文存储", "zh-TW": "⚠️ 安全：appSecret 明文儲存" },
+    securityLine1: { en: "Your appSecret is stored as plaintext in openclaw.json.", "zh-CN": "appSecret 以明文存储在 openclaw.json 中。", "zh-TW": "appSecret 以明文儲存在 openclaw.json 中。" },
+    securityLine2: { en: "Any workspace tool that reads config can see your bot credentials.", "zh-CN": "任何读取配置的工作区工具都能看到机器人凭证。", "zh-TW": "任何讀取配置的工作區工具都能看到機器人憑證。" },
+    securityLine3: { en: "Migrate to SecretRef storage by running:", "zh-CN": "迁移至 SecretRef 存储，请运行：", "zh-TW": "遷移至 SecretRef 儲存，請執行：" },
+    securityLine4: { en: "Or use the LANSENGER_APP_SECRET environment variable instead.", "zh-CN": "或使用 LANSENGER_APP_SECRET 环境变量替代。", "zh-TW": "或使用 LANSENGER_APP_SECRET 環境變數替代。" },
+    finalizePlaintext1: { en: "⚠️  Your appSecret is stored as plaintext in openclaw.json.", "zh-CN": "⚠️  appSecret 以明文存储在 openclaw.json 中。", "zh-TW": "⚠️  appSecret 以明文儲存在 openclaw.json 中。" },
+    finalizePlaintext2: { en: "   This means any workspace tool that reads config can see your bot credentials.", "zh-CN": "   这意味着任何读取配置的工作区工具都能看到机器人凭证。", "zh-TW": "   這意味著任何讀取配置的工作區工具都能看到機器人憑證。" },
+    finalizePlaintext3: { en: "   Migrate to SecretRef storage by running: openclaw secrets configure", "zh-CN": "   迁移至 SecretRef 存储，请运行：openclaw secrets configure", "zh-TW": "   遷移至 SecretRef 儲存，請執行：openclaw secrets configure" },
+    finalizePlaintext4: { en: "   Or use the LANSENGER_APP_SECRET environment variable instead.", "zh-CN": "   或使用 LANSENGER_APP_SECRET 环境变量替代。", "zh-TW": "   或使用 LANSENGER_APP_SECRET 環境變數替代。" },
+};
+function lt(key) {
+    const entry = LANSINGER_I18N[key];
+    if (!entry)
+        return key;
+    return entry[LOCALE] ?? entry.en ?? key;
+}
+export { lt, LOCALE };
+//# sourceMappingURL=setup-i18n.js.map

package/dist/src/setup-i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-i18n.js","sourceRoot":"","sources":["../../src/setup-i18n.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lansenger-pm/openclaw-lansenger-channel",
-  "version": "3.12.2",
+  "version": "3.13.0",
   "type": "module",
   "main": "dist/index.js",
   "exports": {
@@ -18,6 +18,7 @@
     "dist/src/runtime.js",
     "dist/src/runtime.d.ts",
     "dist/src/runtime.js.map",
+    "dist/src/setup-i18n.*",
     "dist/src/setup-wizard.js",
     "dist/src/setup-wizard.d.ts",
     "dist/src/setup-wizard.js.map",
@@ -85,7 +86,7 @@
       "quickstartAllowFrom": true
     },
     "install": {
-      "npmSpec": "@lansenger-pm/openclaw-lansenger-channel@3.12.2",
+      "npmSpec": "@lansenger-pm/openclaw-lansenger-channel@3.13.0",
       "localPath": ".",
       "defaultChoice": "npm"
     },