@openbrt/audioctl 0.1.11 → 0.1.12

package/README.md

@@ -83,6 +83,8 @@ audioctl light set all --color amber --brightness 0.35
 audioctl light timeline ./hero.light.json
 audioctl light bind ./hero.light-bindings.json
 audioctl light clear
+audioctl firmware check --json
+audioctl firmware update --yes --json
 audioctl feedback signal ready
 audioctl feedback flash cyan --repeat 2
 audioctl feedback volume 66
@@ -97,8 +99,25 @@ audioctl prompt 123456 --agent codex --alias 视听房音箱
 
 `inspect` asks the device for a redacted configuration/status snapshot over the
 existing MQTT channel. Agent scripts can read Wi-Fi connection state, BLE
-provisioning state, wake-word capability, playback, VM/app status, and health
-without receiving Wi-Fi passwords, MQTT credentials, or music-platform secrets.
+provisioning state, wake-word capability, playback, VM/app status, firmware
+runtime version, and health without receiving Wi-Fi passwords, MQTT
+credentials, or music-platform secrets.
+
+`firmware check` reads the official firmware index from
+`https://weclawbot.link/firmware/audio/manifest.json`, compares it with
+`inspect.firmware.version`, and reports whether a host/runtime update is
+available. `firmware update` is intentionally gated: without `--yes` it only
+prints the update plan and `confirmation_required`. An agent must show the
+version, source and notes to the user first, then run `audioctl firmware update
+--yes --json` only after the user explicitly confirms. Firmware updates are for
+the device host/runtime and VM manager; they do not erase Wi-Fi, MQTT binding,
+music-platform settings, queues, rules, or installed VM app slots.
+
+```bash
+audioctl firmware check --json
+audioctl firmware update --json        # dry plan, no mutation
+audioctl firmware update --yes --json  # runs only after explicit user approval
+```
 
 `light` controls expose programmable visual surfaces. Agents should use
 `audioctl light describe --json` to inspect surfaces such as `all`, `ring`, and
@@ -265,3 +284,33 @@ Light messages use a distinct command envelope:
 
 Supported light commands are `describe`, `set`, `timeline`, `bind`, and
 `clear`. Continuous light timing and event reactions run on the device VM.
+
+Firmware update messages also use the same MQTT envelope, but carry only an
+official release descriptor. The device downloads the artifact itself from
+`weclawbot.link`, enforces HTTPS, checks SHA-256 and byte size, installs from a
+staging directory, restarts local services, and reports health through
+`inspect`.
+
+```json
+{
+  "schema": "weclawbot.control.v1",
+  "id": "firmware_<uuid>",
+  "kind": "firmware_update",
+  "firmware": {
+    "schema": "weclawbot.firmware.update.v1",
+    "confirmed_by_user": true,
+    "release": {
+      "schema": "weclawbot.firmware.release.v1",
+      "device_class": "audio_voice_ambient_endpoint",
+      "runtime": "rokid_music_runtime",
+      "version": "0.1.1",
+      "channel": "stable",
+      "artifact": {
+        "url": "https://weclawbot.link/firmware/audio/rokid-music-runtime-0.1.1.tar",
+        "sha256": "<64 hex chars>",
+        "bytes": 123456
+      }
+    }
+  }
+}
+```

package/agent-plugin.json

@@ -18,7 +18,8 @@
       "不要读取或解析 audioctl 本地 MQTT 凭据文件",
       "不要直接 import mqtt、打开或保持 MQTT 长连接来控制设备",
       "不要写 agent 端 while/sleep/BPM loop 来反复发布 feedback/LED 命令",
-      "不要把 weclawbot.link 当作实时灯效、音频分析或本地交互的数据面"
+      "不要把 weclawbot.link 当作实时灯效、音频分析或本地交互的数据面",
+      "不要在未获得用户明确确认时执行固件更新；agent 只能先发现新版并说明变更、版本和来源"
     ],
     "continuous_feedback": "连续灯效、节拍灯、呼吸灯、动画和按键反馈必须通过 audioctl light timeline/bind、VM app 或兼容的 feedback effect 一次下发，在设备本地运行；停止使用 audioctl light clear 或 feedback clear。"
   },
@@ -28,7 +29,8 @@
       "把用户自然语言目标拆成需要的 I/O、媒体、反馈、输入绑定和持久运行需求",
       "在用户已授权的平台、连接器、OAuth 或 secret store 中选择合法数据来源",
       "决定使用 queue、rule、light timeline/bind、feedback、input binding 或 VM app install 的组合",
-      "在设备 VM 内放置需要离线、低延迟或持续运行的逻辑"
+      "在设备 VM 内放置需要离线、低延迟或持续运行的逻辑",
+      "运行 audioctl firmware check 发现官网固件新版，并在用户确认后运行 audioctl firmware update --yes"
     ],
     "not_prescribed": "插件不会也无法穷举所有 agent 方案；agent 应读取 capabilities 后自己想办法达到目标。"
   },
@@ -83,6 +85,7 @@
     "event.bind",
     "iot.control",
     "device.inspect",
+    "firmware.update",
     "music.autopilot",
     "music.set_rule",
     "music.set_queue",
@@ -117,6 +120,13 @@
       "intent": "让音箱作为语音遥控、家庭智能或语音互动端点",
       "primary_command": "audioctl app install MANIFEST.json APP.wasm",
       "agent_strategy": "不要把设备假定为音乐播放器。先运行 audioctl inspect --json 读取设备能力，再生成声明最小 capabilities 的 VM app。语音、TTS、家居控制等能力必须通过 manifest capabilities 显式声明；设备侧只执行授权范围内的 I/O。"
+    },
+    {
+      "intent": "检查并升级设备固件",
+      "primary_command": "audioctl firmware check --json",
+      "agent_strategy": "先运行 audioctl firmware check --json，从 https://weclawbot.link/firmware/audio/manifest.json 发现最新官方固件和当前设备版本。只向用户展示版本、来源、release notes 和风险提示；不得自行执行更新。只有用户明确确认后，才运行 audioctl firmware update --yes --json。固件更新是设备 host/runtime 更新，不等同于 VM app install；更新过程中不要读取 MQTT 凭据或私钥。",
+      "if_update_available": "向用户确认：官网发现新固件，是否现在更新？说明版本、预计会重启部分本地服务、不会清除 Wi-Fi/MQTT/音乐平台/VM app 配置。",
+      "if_user_confirms": "运行 audioctl firmware update --yes --json，并在完成后运行 audioctl inspect --json 验证 firmware.version、health 和 vm 状态。"
     }
   ],
   "commands": [
@@ -164,6 +174,10 @@
       "name": "app install",
       "usage": "audioctl app install MANIFEST.json APP.wasm"
     },
+    {
+      "name": "firmware",
+      "usage": "audioctl firmware check [--manifest URL] | firmware update [--manifest URL] --yes"
+    },
     {
       "name": "workbgm",
       "usage": "audioctl workbgm --play"

package/bin/audioctl.mjs

@@ -7,6 +7,7 @@ import {
   COMMAND_NAME,
   DEFAULT_CREDENTIALS_PATH,
   DEFAULT_ENDPOINT,
+  DEFAULT_FIRMWARE_MANIFEST_URL,
   DEEPNIGHT_RULE,
   PACKAGE_NAME,
   bindAgent,
@@ -14,12 +15,15 @@ import {
   buildAgentPrompt,
   buildAudioControl,
   buildFeedbackControl,
+  buildFirmwareUpdateControl,
   buildLightControl,
   buildQueueControl,
   buildWorkBgmAppInstallControl,
   expandPath,
   normalizeCredentials,
+  planFirmwareUpdate,
   publishAudioControl,
+  readFirmwareIndex,
   readCredentials,
   redactAgentFacingValue,
   remediationForStatus,
@@ -48,6 +52,7 @@ async function run(name, values) {
   if (name === "inspect") return commandInspect(values);
   if (name === "prompt") return commandPrompt(values);
   if (name === "manifest") return commandManifest();
+  if (name === "firmware") return commandFirmware(values);
   if (name === "app") return commandApp(values);
   if (name === "queue") return commandQueue(values);
   if (name === "rule") return commandRule(values);
@@ -80,6 +85,8 @@ function usage(exitCode = 0) {
   ${COMMAND_NAME} light timeline TIMELINE.json
   ${COMMAND_NAME} light bind BINDINGS.json
   ${COMMAND_NAME} light clear
+  ${COMMAND_NAME} firmware check [--manifest URL]
+  ${COMMAND_NAME} firmware update [--manifest URL] [--yes]
   ${COMMAND_NAME} rule RULE.json
   ${COMMAND_NAME} queue QUEUE.json [--play]
   ${COMMAND_NAME} app install MANIFEST.json APP.wasm
@@ -90,6 +97,7 @@ function usage(exitCode = 0) {
 Options:
   --credentials FILE   override audioctl-managed local credential file
   --endpoint URL       default: ${DEFAULT_ENDPOINT}
+  --manifest URL       default: ${DEFAULT_FIRMWARE_MANIFEST_URL}
   --timeout SECONDS    default: 12
   --json               machine-readable output
   --nowait             publish without waiting for device status
@@ -208,6 +216,78 @@ async function commandManifest() {
   process.stdout.write(`${JSON.stringify(manifest, null, 2)}\n`);
 }
 
+async function commandFirmware(values) {
+  const subcommand = String(values[0] || "check").replace(/-/gu, "_").toLowerCase();
+  if (!new Set(["check", "update", "upgrade"]).has(subcommand)) {
+    throw new Error(`firmware_subcommand_unsupported: ${subcommand}`);
+  }
+  const options = parseOptions(values.slice(1), {
+    credentials: credentialsPath(),
+    manifest: process.env.WEC_FIRMWARE_MANIFEST || DEFAULT_FIRMWARE_MANIFEST_URL,
+    channel: "stable",
+    timeout: subcommand === "check" ? 20 : 120,
+    json: false,
+    nowait: false,
+    yes: false,
+    force: false,
+  });
+  const credentials = await readCredentials(options.credentials);
+  const firmwareIndex = await readFirmwareIndex(options.manifest, {
+    timeoutMs: Number(options.timeout) * 1000,
+  });
+  const statusDelivery = await publishAudioControl(credentials, buildAudioControl("status"), {
+    timeoutMs: Number(options.timeout) * 1000,
+  });
+  if (statusDelivery.status?.kind === "rejected") {
+    print(statusDelivery.status, options.json);
+    process.exitCode = 1;
+    return;
+  }
+  const inspect = statusDelivery.status?.inspect || statusDelivery.status || {};
+  const plan = planFirmwareUpdate(firmwareIndex, inspect, {
+    channel: options.channel,
+    force: options.force,
+  });
+  if (subcommand === "check") {
+    print(plan, options.json);
+    return;
+  }
+  if (!plan.supported) {
+    print({
+      ...plan,
+      update_started: false,
+      reason: "device_does_not_advertise_firmware.update",
+    }, options.json);
+    process.exitCode = 1;
+    return;
+  }
+  if (!plan.release || !plan.update_available) {
+    print({
+      ...plan,
+      update_started: false,
+    }, options.json);
+    return;
+  }
+  if (!options.yes) {
+    print({
+      ...plan,
+      update_started: false,
+      confirmation_required: true,
+      next_step: `Ask the user to confirm, then run: ${COMMAND_NAME} firmware update --yes`,
+    }, options.json);
+    return;
+  }
+  const control = buildFirmwareUpdateControl(plan.release, {
+    yes: true,
+  });
+  const delivery = await publishAudioControl(credentials, control, {
+    timeoutMs: Number(options.timeout) * 1000,
+    wait: !options.nowait,
+  });
+  print(delivery.status || delivery, options.json);
+  if (delivery.status?.kind === "rejected") process.exitCode = 1;
+}
+
 async function commandRule(values) {
   const options = parseOptions(values, {
     credentials: credentialsPath(),
@@ -485,7 +565,7 @@ function parseOptions(values, defaults = {}) {
       continue;
     }
     const key = value.slice(2);
-    if (key === "json" || key === "online" || key === "nowait" || key === "play") {
+    if (key === "json" || key === "online" || key === "nowait" || key === "play" || key === "yes" || key === "force") {
       options[key] = true;
       continue;
     }
@@ -499,7 +579,9 @@ function parseOptions(values, defaults = {}) {
       "credentials",
       "endpoint",
       "effect",
+      "channel",
       "level",
+      "manifest",
       "name",
       "pattern",
       "profile",

package/lib/index.mjs

@@ -8,6 +8,8 @@ import mqtt from "mqtt";
 export const PACKAGE_NAME = "@openbrt/audioctl";
 export const COMMAND_NAME = "audioctl";
 export const DEFAULT_ENDPOINT = "https://weclawbot.link/byoa";
+export const DEFAULT_FIRMWARE_MANIFEST_URL =
+  "https://weclawbot.link/firmware/audio/manifest.json";
 export const DEFAULT_CREDENTIALS_PATH = path.join(
   os.homedir(),
   ".config",
@@ -50,6 +52,8 @@ export const WORKBGM_RULE = Object.freeze({
 export const PLAYABLE_QUEUE_SCHEMA = "weclawbot.playable_queue.v1";
 export const LIGHT_TIMELINE_SCHEMA = "weclawbot.light.timeline.v1";
 export const LIGHT_BINDINGS_SCHEMA = "weclawbot.light.bind.v1";
+export const FIRMWARE_INDEX_SCHEMA = "weclawbot.firmware.index.v1";
+export const FIRMWARE_RELEASE_SCHEMA = "weclawbot.firmware.release.v1";
 
 export const FEEDBACK_COLOR_NAMES = Object.freeze({
   red: Object.freeze({ red: 255, green: 0, blue: 0, alpha: 255 }),
@@ -284,6 +288,20 @@ export function buildAppInstallControl(options = {}) {
   };
 }
 
+export function buildFirmwareUpdateControl(release, options = {}) {
+  const firmwareRelease = normalizeFirmwareRelease(release);
+  return {
+    schema: "weclawbot.control.v1",
+    id: string(options.id) || `firmware_${crypto.randomUUID()}`,
+    kind: "firmware_update",
+    firmware: {
+      schema: "weclawbot.firmware.update.v1",
+      release: firmwareRelease,
+      confirmed_by_user: options.confirmedByUser === true || options.yes === true,
+    },
+  };
+}
+
 export function buildWorkBgmAppInstallControl(options = {}) {
   const play = options.play === true || options.autoplay === true;
   return buildAppInstallControl({
@@ -701,6 +719,142 @@ function normalizeLightEvent(value) {
   return event;
 }
 
+export async function readFirmwareIndex(source = DEFAULT_FIRMWARE_MANIFEST_URL, options = {}) {
+  const location = string(source) || DEFAULT_FIRMWARE_MANIFEST_URL;
+  let payload;
+  if (/^https?:\/\//iu.test(location)) {
+    const response = await fetch(location, {
+      headers: { accept: "application/json" },
+      signal: AbortSignal.timeout(Math.max(1000, Number(options.timeoutMs) || 15_000)),
+    });
+    if (!response.ok) {
+      throw new Error(`firmware_manifest_http_${response.status}`);
+    }
+    payload = await response.json();
+  } else if (location.startsWith("file://")) {
+    payload = JSON.parse(await fs.readFile(new URL(location), "utf8"));
+  } else {
+    payload = JSON.parse(await fs.readFile(expandPath(location), "utf8"));
+  }
+  return normalizeFirmwareIndex(payload, location);
+}
+
+export function normalizeFirmwareIndex(value, source = DEFAULT_FIRMWARE_MANIFEST_URL) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error("firmware_manifest_invalid");
+  }
+  const releasesInput = Array.isArray(value.releases) ? value.releases : [];
+  if (value.schema !== FIRMWARE_INDEX_SCHEMA || releasesInput.length < 1) {
+    throw new Error("firmware_manifest_invalid");
+  }
+  return {
+    schema: FIRMWARE_INDEX_SCHEMA,
+    device_class: string(value.device_class || ABSTRACT_HARDWARE_TYPE).slice(0, 80),
+    channel: string(value.channel || "stable").slice(0, 40),
+    generated_at: string(value.generated_at).slice(0, 80),
+    source: string(source).slice(0, 240),
+    releases: releasesInput.map(normalizeFirmwareRelease),
+  };
+}
+
+export function normalizeFirmwareRelease(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error("firmware_release_invalid");
+  }
+  const artifact = value.artifact && typeof value.artifact === "object" ? value.artifact : {};
+  const url = string(artifact.url || value.url);
+  if (!/^https:\/\/(?:www\.)?weclawbot\.link\/firmware\//iu.test(url)) {
+    throw new Error("firmware_artifact_url_invalid");
+  }
+  const sha256 = string(artifact.sha256 || value.sha256).toLowerCase();
+  if (!/^[0-9a-f]{64}$/u.test(sha256)) {
+    throw new Error("firmware_artifact_sha256_invalid");
+  }
+  const bytes = Math.floor(Number(artifact.bytes || artifact.size || value.bytes || value.size) || 0);
+  if (bytes < 1 || bytes > 96 * 1024 * 1024) {
+    throw new Error("firmware_artifact_size_invalid");
+  }
+  const version = string(value.version).replace(/^v/iu, "");
+  if (!/^[0-9]+(?:\.[0-9]+){1,3}(?:[-+][A-Za-z0-9_.-]+)?$/u.test(version)) {
+    throw new Error("firmware_version_invalid");
+  }
+  return {
+    schema: FIRMWARE_RELEASE_SCHEMA,
+    device_class: string(value.device_class || ABSTRACT_HARDWARE_TYPE).slice(0, 80),
+    runtime: string(value.runtime || "rokid_music_runtime").slice(0, 80),
+    version,
+    channel: string(value.channel || "stable").slice(0, 40),
+    host_api: string(value.host_api || "weclawbot.host.v0").slice(0, 80),
+    released_at: string(value.released_at).slice(0, 80),
+    min_current_version: string(value.min_current_version || "0.0.0").replace(/^v/iu, "").slice(0, 40),
+    requires_user_confirmation: value.requires_user_confirmation !== false,
+    notes: Array.isArray(value.notes)
+      ? value.notes.map((note) => string(note).slice(0, 180)).filter(Boolean).slice(0, 12)
+      : [],
+    artifact: {
+      url,
+      sha256,
+      bytes,
+      format: string(artifact.format || "tar").slice(0, 32),
+    },
+  };
+}
+
+export function compareVersions(a, b) {
+  const parse = (value) => string(value)
+    .replace(/^v/iu, "")
+    .split(/[-+]/u)[0]
+    .split(".")
+    .map((part) => Number.parseInt(part, 10) || 0);
+  const left = parse(a);
+  const right = parse(b);
+  const length = Math.max(left.length, right.length, 3);
+  for (let index = 0; index < length; index += 1) {
+    const difference = (left[index] || 0) - (right[index] || 0);
+    if (difference !== 0) return difference > 0 ? 1 : -1;
+  }
+  return 0;
+}
+
+export function planFirmwareUpdate(index, inspect = {}, options = {}) {
+  const firmwareIndex = normalizeFirmwareIndex(index, index?.source || DEFAULT_FIRMWARE_MANIFEST_URL);
+  const deviceClass =
+    string(inspect.device_type) ||
+    string(inspect.device?.abstract_hardware) ||
+    ABSTRACT_HARDWARE_TYPE;
+  const channel = string(options.channel || firmwareIndex.channel || "stable");
+  const currentVersion =
+    string(inspect.firmware?.version || inspect.device?.firmware_version || "0.0.0")
+      .replace(/^v/iu, "") || "0.0.0";
+  const capabilities = new Set(Array.isArray(inspect.capabilities) ? inspect.capabilities : []);
+  const candidates = firmwareIndex.releases
+    .filter((release) => release.device_class === deviceClass)
+    .filter((release) => !channel || release.channel === channel)
+    .filter((release) => compareVersions(currentVersion, release.min_current_version || "0.0.0") >= 0)
+    .sort((a, b) => compareVersions(b.version, a.version));
+  const release = candidates[0] || null;
+  const supported = capabilities.size === 0 || capabilities.has("firmware.update");
+  const updateAvailable = Boolean(release) &&
+    (options.force === true || compareVersions(release.version, currentVersion) > 0);
+  return {
+    schema: "weclawbot.firmware.plan.v1",
+    device_class: deviceClass,
+    current_version: currentVersion,
+    channel,
+    supported,
+    update_available: updateAvailable,
+    latest_version: release?.version || "",
+    release,
+    source: firmwareIndex.source,
+    requires_user_confirmation: Boolean(updateAvailable && release?.requires_user_confirmation !== false),
+    summary: release
+      ? (updateAvailable
+          ? `Firmware ${release.version} is available for ${deviceClass}.`
+          : `Firmware ${currentVersion} is up to date for ${deviceClass}.`)
+      : `No firmware release found for ${deviceClass} on ${channel}.`,
+  };
+}
+
 function normalizeIdentifier(value, options = {}) {
   const text = string(value);
   const maximum = Number(options.maximum) || 80;
@@ -1070,7 +1224,7 @@ export function buildAgentPrompt(options = {}) {
     `npm exec --package ${PACKAGE_NAME} -- ${COMMAND_NAME} bind ${code} --name ${shellToken(agentName)}`,
     `npm exec --package ${PACKAGE_NAME} -- ${COMMAND_NAME} doctor --online`,
     `这台设备对你是抽象硬件产品：${ABSTRACT_HARDWARE_TYPE}。不要根据外观、BLE 名称、音色、日志或历史上下文推断品牌/型号/厂家，也不要搜索厂家资料、社区经验或拆机资料；只使用 audioctl inspect 返回的 capabilities、VM manifest 和控制回执来工作。`,
-    `绑定成功后，把它作为默认音频/语音/环境 I/O 端点；不要把它假定成只会播放音乐。可用命令包括 play、pause、toggle、next、previous、volume、volumeup、volumedown、status、inspect、queue、rule、workbgm、feedback、light、led、app install。`,
+    `绑定成功后，把它作为默认音频/语音/环境 I/O 端点；不要把它假定成只会播放音乐。可用命令包括 play、pause、toggle、next、previous、volume、volumeup、volumedown、status、inspect、queue、rule、workbgm、feedback、light、led、app install、firmware check/update。`,
     `当我给出目标时，请你在 capabilities、安全边界和用户授权范围内自行规划实现路径；插件只声明能力和边界，不穷举具体玩法。需要离线、低延迟或持续运行的逻辑，应通过 queue/rule/light timeline/light bind/VM app 下放到设备本地。`,
     `MQTT/weclawbot.link 对你只是控制面和部署通道，不是实时灯效数据面。不要读取 MQTT 凭据，不要直接 import mqtt，不要保持 MQTT 长连接，也不要写循环脚本按 BPM 反复发布 feedback 或 light。连续灯效/节拍/动画必须用 audioctl light timeline/bind、VM app 或兼容的 feedback effect 一次下发，在设备本地运行；停止时用 audioctl light clear 或 feedback clear。`,
     `蓝牙/Wi-Fi 配网只负责设备入网、发现和 weclawbot.link 绑定；音乐平台授权请走 agent 侧连接器/OAuth/secret store；配网不决定设备用途。`,
@@ -1079,6 +1233,7 @@ export function buildAgentPrompt(options = {}) {
     `灯效、音量灯、蜂鸣和按键/触控反馈要先 inspect 或 light describe 确认 feedback/input/light capabilities。一次性语义反馈可用 feedback signal/flash/volume/beep/clear；复杂灯效请优先生成 light timeline 和 light bind，把外圈、中心等 surface 与 media/input 事件绑定到设备本地。feedback effect 只作为兼容/demo 入口，不要把 music_beat/pulse/breathing 当成能力边界。具体按键绑定请根据用户目标和 capabilities 自行规划，不要套固定模板。`,
     `如果你当前没有音乐平台身份，请只告诉我：我需要你把音乐平台身份连接到当前 agent 的官方连接器、OAuth 流程或 secret store；完成后回复“已授权”。不要反复重试，不要让我理解内部授权包，也不要要求我把 AppSecret、PrivateKey、accessToken 或 refreshToken 发到聊天里。`,
     `如果返回 health.problems 包含 netease_auth_refresh_failed，说明设备侧内置网易运行时授权失效；优先改走 agent 侧 queue/app 驱动。只有我明确要求继续使用设备侧网易运行时时，才提示需要独立的设备侧音乐账号设置入口；不要混入蓝牙/Wi-Fi 配网流程。`,
+    `固件更新由 agent 端发现新版、用户确认后执行：先运行 audioctl firmware check --json，只展示官网来源、当前版本、新版本和 release notes；只有用户明确同意升级后，才运行 audioctl firmware update --yes --json。固件只从 weclawbot.link 官方 manifest 下载，更新设备 host/runtime，不等同于 VM app，也不要用固件更新去实现普通应用需求。`,
     `如果我要播放「${profile}」，也可以执行：npm exec --package ${PACKAGE_NAME} -- ${COMMAND_NAME} deepnight`,
     `不要向设备写入全局音乐平台私钥；平台授权优先保存在 agent 运行环境。只有在我明确授权时，才把最小范围、可轮换、可撤销的 app-scoped 凭据随 VM app 写入设备。`,
   ].filter(Boolean).join("\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openbrt/audioctl",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "Generic WeClawBot audio/voice endpoint control CLI and AI-agent plugin.",
   "type": "module",
   "license": "MIT",