隨興雜記

Waveshare ESP32-P4-WIFI6-Touch-LCD-5

2026-10-31T10:33:04.885+08:00

Waveshare ESP32-P4-WIFI6-Touch-LCD-5 與 ESP-IDF v6.1 可直接編譯、運行的完整工程基準與硬體腳位定義。

一、硬體規格與實體腳位定義（Hardware Mapping）

核心 MCU：ESP32-P4 Rev 3.2（雙核 RISC-V 400MHz），板載 32MB 16-Line PSRAM（200MHz）與 16MB SPI Flash。
通訊除錯：Console UART_TX = GPIO 38、UART_RX = GPIO 37。
Wi-Fi 6 / 藍牙：板載 ESP32-C6 協處理器，透過 SDIO 匯流排對接（CLK:18, CMD:19, D0:14, D1:15, D2:16, D3:17, Reset:54）。
MIPI DSI 螢幕（HX8394）：
- 解析度：直屏 720x1280、2-lane MIPI DSI。
- 面板重置：GPIO 27（Panel RST，高電平有效）。
- 面板背光：GPIO 26（Backlight，建議以標準 GPIO 輸出高電平常開，避免與 LEDC Timer 衝突報錯）。
觸控 IC（GT911）：
- I2C1 匯流排：SDA = GPIO 7、SCL = GPIO 8（位址 0x5D）。
- 中斷與復位：硬體未拉出獨立中斷/復位（INT = NC、RST = NC），由原廠適配器以輪詢方式處理點擊事件。
音訊 Codec（ES8311 放音 + ES7210 錄音）：
- I2S1 匯流排：MCLK = GPIO 13、SCLK = GPIO 12、WS(LCLK) = GPIO 10、DOUT = GPIO 9、DSIN = GPIO 11。
- 功放致能（PA_EN）：GPIO 53（高電平致能）。原廠標準採樣率為 22050 Hz（單聲道/立體聲映射）。
MicroSD 卡槽（Slot 0 原生 SDMMC 4-wire）：
- 腳位：CLK = GPIO 43、CMD = GPIO 44、D0 = GPIO 39、D1 = GPIO 40、D2 = GPIO 41、D3 = GPIO 42。
- 卡槽偵測（CD）：無獨立實體 CD 腳位（GPIO 40 為 SDMMC D1 資料線，不可作為 GPIO 偵測輸入）。標準實務為「關機插拔、開機靜態掛載」；若開機未插卡僅執行單次防呆，不進行高頻重複輪詢以防止 LDO 電源單元與記憶體死鎖。

二、ESP-IDF v6.1 驅動相容性修補（解開機死白屏關鍵）

若使用官方 Waveshare HX8394 驅動，在 ESP-IDF v6.1 下預設會出現死白光（背光全亮但無畫面），需確認以下兩處修補：

驅動結構體映射：在 managed_components/waveshare__esp_lcd_hx8394/include/esp_lcd_hx8394.h 內的巨集 WAVESHARE_LCD_DPI_CONFIG_COLOR_FORMAT 需確保同時配置 .in_color_format 與 .out_color_format。
面板初始化序列：在 esp_lcd_hx8394.c 的預設初始化序列末尾，暫存器 0x3A（COLMOD）需修正為 0x55（RGB565），且必須送出 0x21 指令（Display Inversion ON，IPS 常黑反轉），否則像素無法導通。

三、工程相依配置（`main/idf_component.yml`）

YAML
dependencies:
  idf: ">=6.0.0"
  waveshare/esp32_p4_wifi6_touch_lcd_5: "^1.0.0"
  espressif/esp_codec_dev: "^1.3.0"
  espressif/esp_hosted: "^1.0.0"

四、完整且可直接運行的主程式碼（`main/hello_world_main.c`）

此代碼已整合：

ES8311 音訊子系統與 GPIO 53 功放獨立任務非同步播放。
MicroSD 卡槽開機靜態安全掛載（未插卡不崩潰、開機插卡即顯示容量）。
原廠 esp_lv_adapter 封裝之 LVGL 9 與 GT911 觸控整合（解決多重適配器搶鎖死結問題）。
經由 ESP32-C6 Hosted 架構之 Wi-Fi 6 STA 自動連線與非同步 UI 狀態更新。

C
#include <stdio.h>
#include <string.h>
#include <math.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"
#include "esp_system.h"
#include "esp_wifi.h"
#include "esp_event.h"
#include "nvs_flash.h"
#include "driver/gpio.h"
#include "lvgl.h"
#include "esp_lv_adapter.h"
#include "bsp/esp32_p4_wifi6_touch_lcd_5.h"
#include "esp_codec_dev.h"

static const char *TAG = "MAIN_APP";

// Wi-Fi 基地台連線資訊 (請依實際環境修改)
#define WIFI_SSID "uap"
#define WIFI_PASS "23307667"

static esp_codec_dev_handle_t speaker_handle = NULL;
static TaskHandle_t audio_task_handle = NULL;
static lv_obj_t *wifi_status_label = NULL;
static lv_obj_t *sd_status_label = NULL;
static lv_obj_t *touch_status_label = NULL;
static lv_obj_t *btn_label = NULL;
static int click_count = 0;
static bool sd_mounted = false;

static char sd_display_text[128] = "SD Card: Not Installed";

// 產生 22050Hz (官方標準採樣率) 正弦波 PCM 提示音
#define SAMPLE_RATE 22050
#define BEEP_MS 80
#define TOTAL_SAMPLES ((SAMPLE_RATE * BEEP_MS) / 1000)
static int16_t beep_pcm[TOTAL_SAMPLES];

static void init_beep_pcm(void)
{
    for (int i = 0; i < TOTAL_SAMPLES; i++) {
        beep_pcm[i] = (int16_t)(sin(2.0 * M_PI * 1000.0 * i / SAMPLE_RATE) * 22000);
    }
}

static void audio_task(void *arg)
{
    while (1) {
        ulTaskNotifyTake(pdTRUE, portMAX_DELAY);
        if (speaker_handle) {
            gpio_set_level(BSP_POWER_AMP_IO, 1);
            esp_codec_dev_write(speaker_handle, beep_pcm, sizeof(beep_pcm));
        }
    }
}

static void play_beep_async(void)
{
    if (audio_task_handle) {
        xTaskNotifyGive(audio_task_handle);
    }
}

static void btn_click_event_cb(lv_event_t *e)
{
    lv_event_code_t code = lv_event_get_code(e);
    if (code == LV_EVENT_CLICKED) {
        click_count++;
        char buf[64];
        snprintf(buf, sizeof(buf), "Touch Count: %d", click_count);
        if (btn_label) {
            lv_label_set_text(btn_label, buf);
        }
        if (touch_status_label) {
            lv_label_set_text(touch_status_label, "Touch: Clicked!");
        }
        ESP_LOGI(TAG, "Touch Click Event Validated! Count = %d", click_count);
        play_beep_async();
    }
}

static void update_wifi_ui_async(void *user_data)
{
    if (wifi_status_label) {
        lv_label_set_text(wifi_status_label, "Wi-Fi: Connected (192.168.1.192)");
        lv_obj_set_style_text_color(wifi_status_label, lv_color_hex(0x10B981), LV_PART_MAIN);
    }
}

static void wifi_event_handler(void* arg, esp_event_base_t event_base,
                               int32_t event_id, void* event_data)
{
    if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_START) {
        esp_wifi_connect();
    } else if (event_base == IP_EVENT && event_id == IP_EVENT_STA_GOT_IP) {
        ip_event_got_ip_t* event = (ip_event_got_ip_t*) event_data;
        ESP_LOGI(TAG, "Wi-Fi Connected IP: " IPSTR, IP2STR(&event->ip_info.ip));
        lv_async_call(update_wifi_ui_async, NULL);
    }
}

static void wifi_init_sta(void)
{
    esp_netif_init();
    esp_event_loop_create_default();
    esp_netif_create_default_wifi_sta();

    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
    esp_wifi_init(&cfg);

    esp_event_handler_instance_register(WIFI_EVENT, ESP_EVENT_ANY_ID, &wifi_event_handler, NULL, NULL);
    esp_event_handler_instance_register(IP_EVENT, IP_EVENT_STA_GOT_IP, &wifi_event_handler, NULL, NULL);

    wifi_config_t wifi_config = {
        .sta = {
            .ssid = WIFI_SSID,
            .password = WIFI_PASS,
        },
    };
    esp_wifi_set_mode(WIFI_MODE_STA);
    esp_wifi_set_config(WIFI_IF_STA, &wifi_config);
    esp_wifi_start();
}

void app_main(void)
{
    esp_err_t ret = nvs_flash_init();
    if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND) {
        nvs_flash_erase();
        nvs_flash_init();
    }

    init_beep_pcm();

    // 1. MicroSD 卡開機單次靜態掛載檢測 (關機插卡標準工程模式)
    ESP_LOGI(TAG, "Detecting SD Card at boot...");
    if (bsp_sdcard_mount() == ESP_OK && bsp_sdcard != NULL) {
        sd_mounted = true;
        uint64_t total_mb = ((uint64_t)bsp_sdcard->csd.capacity * bsp_sdcard->csd.sector_size) / (1024 * 1024);
        snprintf(sd_display_text, sizeof(sd_display_text), "SD Card: Mounted (%s, %lluMB)", bsp_sdcard->cid.name, total_mb);
        ESP_LOGI(TAG, "%s", sd_display_text);
    } else {
        sd_mounted = false;
        snprintf(sd_display_text, sizeof(sd_display_text), "SD Card: Not Installed");
        ESP_LOGI(TAG, "SD Card not installed at boot.");
    }

    // 2. 音訊子系統初始化 (ES8311 + 功放 GPIO 53 致能)
    gpio_reset_pin(BSP_POWER_AMP_IO);
    gpio_set_direction(BSP_POWER_AMP_IO, GPIO_MODE_OUTPUT);
    gpio_set_level(BSP_POWER_AMP_IO, 1);

    speaker_handle = bsp_audio_codec_speaker_init();
    if (speaker_handle) {
        esp_codec_dev_sample_info_t fs = {
            .bits_per_sample = 16,
            .channel = 1,
            .sample_rate = SAMPLE_RATE,
        };
        esp_codec_dev_open(speaker_handle, &fs);
        esp_codec_dev_set_out_mute(speaker_handle, false);
        esp_codec_dev_set_out_vol(speaker_handle, 85);
        ESP_LOGI(TAG, "Audio Codec Speaker Initialized via BSP.");
    }

    xTaskCreatePinnedToCore(audio_task, "audio_task", 4096, NULL, 5, &audio_task_handle, 0);
    play_beep_async();

    // 3. 顯示與觸控子系統 (透過官方原廠 BSP 與 esp_lv_adapter 啟動)
    ESP_LOGI(TAG, "Starting Display and Touch via BSP...");
    lv_display_t *disp = bsp_display_start();
    assert(disp);

    bsp_display_backlight_on();

    // 使用阻塞式鎖確保 UI 繪製與適配器內部渲染任務同步
    ESP_LOGI(TAG, "Acquiring LVGL Lock (blocking)...");
    ESP_ERROR_CHECK(esp_lv_adapter_lock(-1));

    lv_obj_t *scr = lv_display_get_screen_active(disp);
    lv_obj_set_style_bg_color(scr, lv_color_hex(0x0F172A), LV_PART_MAIN);

    lv_obj_t *title = lv_label_create(scr);
    lv_label_set_text(title, "Waveshare ESP32-P4 Official Driver");
    lv_obj_set_style_text_color(title, lv_color_hex(0x38BDF8), LV_PART_MAIN);
    lv_obj_align(title, LV_ALIGN_TOP_MID, 0, 70);

    sd_status_label = lv_label_create(scr);
    lv_label_set_text(sd_status_label, sd_display_text);
    if (sd_mounted) {
        lv_obj_set_style_text_color(sd_status_label, lv_color_hex(0x10B981), LV_PART_MAIN);
    } else {
        lv_obj_set_style_text_color(sd_status_label, lv_color_hex(0x94A3B8), LV_PART_MAIN);
    }
    lv_obj_align(sd_status_label, LV_ALIGN_TOP_MID, 0, 130);

    wifi_status_label = lv_label_create(scr);
    lv_label_set_text(wifi_status_label, "Wi-Fi: Connecting (uap)...");
    lv_obj_set_style_text_color(wifi_status_label, lv_color_hex(0xFBBF24), LV_PART_MAIN);
    lv_obj_align(wifi_status_label, LV_ALIGN_TOP_MID, 0, 180);

    touch_status_label = lv_label_create(scr);
    lv_label_set_text(touch_status_label, "Touch: Idle (Waiting for touch)");
    lv_obj_set_style_text_color(touch_status_label, lv_color_hex(0xA78BFA), LV_PART_MAIN);
    lv_obj_align(touch_status_label, LV_ALIGN_TOP_MID, 0, 230);

    lv_obj_t *btn = lv_button_create(scr);
    lv_obj_set_size(btn, 550, 250);
    lv_obj_align(btn, LV_ALIGN_CENTER, 0, 70);
    lv_obj_set_style_bg_color(btn, lv_color_hex(0x2563EB), LV_PART_MAIN);
    lv_obj_add_event_cb(btn, btn_click_event_cb, LV_EVENT_CLICKED, NULL);

    btn_label = lv_label_create(btn);
    lv_label_set_text(btn_label, "Touch Count: 0");
    lv_obj_set_style_text_color(btn_label, lv_color_hex(0xFFFFFF), LV_PART_MAIN);
    lv_obj_center(btn_label);

    lv_obj_invalidate(scr);
    esp_lv_adapter_unlock();
    ESP_LOGI(TAG, "UI initialized and LVGL Lock released.");

    // 4. 啟動 Wi-Fi STA 連線
    ESP_LOGI(TAG, "Starting Wi-Fi STA connection...");
    wifi_init_sta();

    while (1) {
        vTaskDelay(pdMS_TO_TICKS(1000));
    }
}

五、編譯與燒錄指令

在專案目錄下執行以下指令進行建置與監控：

PowerShell

idf.py -p COM12 flash monitor

esp32-s3-lcd2 加ov5640

2026-10-28T19:27:31.636+08:00

esphome:

on_boot:

priority: 200

then:

- output.turn_on: lcd_backlight

esp32:

board: esp32-s3-devkitc-1

framework:

type: esp-idf

sdkconfig_options:

CONFIG_ESP_DEFAULT_CPU_FREQ_MHZ_240: "y"

psram:

mode: octal

speed: 80MHz

wifi:

ssid: "xxxxxx"

password: "YOUR_WIFI_PASSWORD"

power_save_mode: none

fast_connect: true

output_power: 20dBm

logger:

level: DEBUG

api:

ota:

- platform: esphome

# 1. 雙獨立硬體 I2C

i2c:

# 觸控專用 (GPIO48/47)

- id: bus_touch

sda: GPIO48

scl: GPIO47

scan: true

frequency: 400kHz

# 相機 SCCB (GPIO21/16)

- id: bus_cam

sda: GPIO21

scl: GPIO16

scan: false

frequency: 100kHz

# 2. 原廠硬體 SPI

spi:

- id: spi_bus

clk_pin: GPIO39

mosi_pin: GPIO38

# 3. 原廠螢幕實體背光控制

output:

- platform: gpio

pin: GPIO1

id: lcd_backlight

# 4. 微雪原廠 DVP 相機

esp32_camera:

id: my_cam

data_pins:

- GPIO12

- GPIO13

- GPIO15

- GPIO11

- GPIO14

- GPIO10

- GPIO7

- GPIO2

vsync_pin: GPIO6

href_pin: GPIO4

pixel_clock_pin: GPIO9

external_clock:

pin: GPIO8

frequency: 20MHz

i2c_id: bus_cam

resolution: 320X240

pixel_format: RGB565

frame_buffer_count: 2

frame_buffer_location: PSRAM

max_framerate: 10fps

# 5. UI 與觸控狀態變數

globals:

- id: current_page

type: int

initial_value: "0" # 0: SYS, 1: CAM

- id: screen_on

type: bool

initial_value: "true"

- id: touch_x

type: int

initial_value: "120"

- id: touch_y

type: int

initial_value: "160"

# 6. 字型

font:

- file: "gfonts://Roboto"

id: font_small

size: 14

- file: "gfonts://Roboto"

id: font_title

size: 16

# 7. 系統感測器

text_sensor:

- platform: wifi_info

ssid:

id: wifi_status_sensor

ip_address:

id: wifi_ip_sensor

sensor:

- platform: wifi_signal

id: wifi_rssi_sensor

update_interval: 10s

# 8. ST7789T3 顯示驅動 (依官方規格校正反轉與色彩排列)

display:

- platform: mipi_spi

id: my_display

spi_id: spi_bus

model: ST7789V

dimensions:

width: 240

height: 320

cs_pin: GPIO45

dc_pin: GPIO42

data_rate: 20MHz

invert_colors: true

color_order: bgr

update_interval: 100ms

lambda: |-

if (!id(screen_on)) {

return;

}

int page = id(current_page);

// --- 頂部導航列 ---

it.filled_rectangle(0, 0, 240, 36, Color(15, 23, 42));

// Tab 1: SYS

if (page == 0) {

it.filled_rectangle(4, 4, 66, 28, Color(37, 99, 235));

} else {

it.filled_rectangle(4, 4, 66, 28, Color(30, 41, 59));

}

it.print(37, 18, id(font_title), Color(255, 255, 255), TextAlign::CENTER, "SYS");

// Tab 2: CAM

if (page == 1) {

it.filled_rectangle(74, 4, 66, 28, Color(37, 99, 235));

} else {

it.filled_rectangle(74, 4, 66, 28, Color(30, 41, 59));

}

it.print(107, 18, id(font_title), Color(255, 255, 255), TextAlign::CENTER, "CAM");

// 關屏按鈕: OFF

it.filled_rectangle(170, 4, 66, 28, Color(220, 38, 38));

it.print(203, 18, id(font_title), Color(255, 255, 255), TextAlign::CENTER, "OFF");

// --- 內容區 ---

if (page == 0) {

// [PAGE 0: 系統狀態與觸控板]

it.filled_rectangle(0, 36, 240, 284, Color(15, 23, 42));

it.printf(15, 46, id(font_small), Color(148, 163, 184), "SSID: %s", id(wifi_status_sensor).state.c_str());

it.printf(15, 66, id(font_small), Color(148, 163, 184), "IP: %s", id(wifi_ip_sensor).state.c_str());

it.printf(15, 86, id(font_small), Color(148, 163, 184), "RSSI: %.0f dBm", id(wifi_rssi_sensor).state);

it.filled_rectangle(10, 110, 220, 195, Color(2, 6, 23));

it.rectangle(10, 110, 220, 195, Color(51, 65, 85));

int tx = id(touch_x);

int ty = id(touch_y);

if (tx >= 10 && tx <= 230 && ty >= 110 && ty <= 305) {

it.line(10, ty, 230, ty, Color(71, 85, 105));

it.line(tx, 110, tx, 305, Color(71, 85, 105));

it.filled_circle(tx, ty, 5, Color(56, 189, 248));

}

it.printf(120, 288, id(font_small), Color(226, 232, 240), TextAlign::CENTER, "Touch: X=%d, Y=%d", tx, ty);

} else {

// [PAGE 1: 本機即時影像 - 手動正確解構 RGB565 原色]

camera_fb_t *cam_fb = esp_camera_fb_get();

if (cam_fb != nullptr) {

if (cam_fb->format == PIXFORMAT_RGB565) {

const uint8_t *raw = cam_fb->buf;

for (int y = 0; y < 240 && y < cam_fb->height; y++) {

int row_offset = y * cam_fb->width * 2;

for (int x = 0; x < 240 && x < cam_fb->width; x++) {

int idx = row_offset + (x * 2);

// OV5640 標準 RGB565 雙位元組

uint8_t b1 = raw[idx];

uint8_t b2 = raw[idx + 1];

// 提取 R(5-bit), G(6-bit), B(5-bit) 並擴展至 8-bit

uint8_t r = (b1 & 0xF8);

uint8_t g = ((b1 & 0x07) << 5) | ((b2 & 0xE0) >> 3);

uint8_t b = (b2 & 0x1F) << 3;

// 呼叫明確的 Color(r, g, b) 三通道建構子

it.draw_pixel_at(x, y + 40, Color(r, g, b));

}

esp_camera_fb_return(cam_fb);

}

# 9. CST816D 觸控邏輯 (綁定 bus_touch)

touchscreen:

- platform: cst816

id: my_touch

display: my_display

i2c_id: bus_touch

interrupt_pin: GPIO46

on_touch:

- lambda: |-

if (!id(screen_on)) {

id(screen_on) = true;

id(lcd_backlight).turn_on();

return;

}

id(touch_x) = touch.x;

id(touch_y) = touch.y;

if (touch.y <= 36) {

if (touch.x >= 4 && touch.x <= 70) {

id(current_page) = 0;

} else if (touch.x >= 74 && touch.x <= 140) {

id(current_page) = 1;

} else if (touch.x >= 170 && touch.x <= 236) {

id(screen_on) = false;

id(lcd_backlight).turn_off();

}

Home Assistant 音訊雙軌與原音廣播及 AI 對話

2026-10-11T16:03:19.966+08:00

Home Assistant 音訊雙軌與原音廣播及 AI 對話完整部署手冊

（適用於全新安裝 HA 系統之全端工程部署手冊）

1. 系統架構理念：什麼是「音訊雙軌」？

在傳統智慧家庭系統中，語音廣播（Intercom）通常過度依賴文字轉語音（TTS），導致真人發話失去溫度；而語音助理互動則常受限於特定硬體生態（例如只能對著實體 Nest 音箱說話，無法跨廠牌連動）。

本架構建立於 Home Assistant（HA）之上，採用音訊雙軌並行設計：

                ┌─── [軌道 1：真人原音廣播軌] ───► 麥克風採樣 ──► 4KB 分段寫入 ──► Port 80 原音直推 ──► 多房間喇叭同步播放
前端長按發話 ───┤
                └─── [軌道 2：AI 雙向對話軌]   ───► Web Speech ──► Google Assistant SDK ──► 單一請求解析 ──► 跨生態設備同步回應 / 控制設備

軌道 1：真人原音廣播軌（Human Voice Intercom）
- 長按瀏覽器/手機端按鍵直接收音。
- 以用戶硬體之原生取樣率（動態適配 44.1kHz / 48kHz）生成標準無損 PCM WAV。
- 透過 4KB 分段通道寫入 HA 本地快取，直接以反向代理推送到多房間設備（如 Squeezebox/XZ1、Google Cast、AirPlay）。
軌道 2：AI 雙向對話軌（AI Assistant Conversation & Control）
- 切換至 AI 模式長按發話。
- 利用瀏覽器 Web Speech API 即時轉為純文字。
- 透過後端 google_assistant_sdk.send_text_command 送至 Google 雲端處理。
- 具備智慧家庭直接控制能力（如「打開客廳電燈」、「把冷氣調到 26 度」）。
- 採用 官方多 ID 動態陣列一次性派發，由 HA 底層同步將 Google 助理之回答推播至勾選之複數設備，徹底根除多設備 Session 錯位與 N-1 舊回應殘留問題。

2. 核心技術痛點與避坑設計

全新部署 HA 時，自行開發語音卡片通常會踩中以下底層地雷，本架構已在程式碼層級全數解決：

Linux 命令列參數長度限制（E2BIG 錯誤）
- 問題：錄音 5 秒的音訊轉換成 Base64 字串常達 300KB 以上，直接作為參數傳遞給 shell_command 會觸發 Linux 核心的 Argument list too long 報錯而靜默失敗。
- 解法：前端強制切分成每包 4,000 字元（4KB Chunk），透過 Python 腳本串流追加（Append）寫入暫存檔，最後在 HA 端以 Python 原生解碼還原。
瀏覽器 Web Audio 垃圾回收（Garbage Collection）丟失
- 問題：使用者按下按鈕時，AudioContext 準備期（450ms）尚未有大量音訊樣本流入，ScriptProcessorNode 容易被瀏覽器引擎判定為閒置而提前進行 GC 回收，造成斷音或無聲。
- 解法：錄音節點直接掛載至全域變數 window._activeIntercomRecorderNode，直到放開按鍵後才顯式註銷。
多設備廣播時序錯亂（N-1 vs N 回應覆蓋）
- 問題：以往後端使用 repeat 迴圈逐一對每台設備呼叫 google_assistant_sdk.send_text_command，Google 雲端會視為連續多次獨立請求；反應慢的設備（如 Google Audio）會被塞入前一次（N-1）快取，反應快的設備（如 Sony XZ1 LMS）則播當次（N），造成嚴重的時序分裂。
- 解法：廢除 repeat，改用官方原生支援的多 ID 動態陣列，向 Google 雲端發起唯獨一次請求，由 HA 核心底層跨協議並行推送音訊串流。

3. 全新安裝環境需求與事前準備

硬體與網路環境

已安裝 Home Assistant OS 或 Home Assistant Supervised / Core 之主機。
區域網路內可正常存取 HA（範例 HA 內部 IP 為 192.168.1.187，若你的 IP 不同，僅需更改 YAML 內的廣播 URL）。
至少一台可用的 media_player 實體（如 Google Cast 音箱、Squeezebox / LMS 播放器、Apple TV / HomePod 等）。

必要整合組件（Integrations）

Google Assistant SDK：
- 用於執行 AI 語音雙向對話及語音控制設備。
- 請在 HA 「設定」->「裝置與服務」->「新增整合」 中搜尋並完成 Google Assistant SDK 的 OAuth 授權綁定。
啟用 packages 機制：
- 檢查 /config/configuration.yaml，確保包含以下設定：
```
homeassistant:
  packages: !include_dir_named packages
```

4. 步驟一：後端核心配置 (`/config/packages/intercom.yaml`)

在 HA 設定檔目錄下建立資料夾 /config/packages（若無），並新增檔案 intercom.yaml。

# ==============================================================================
# Home Assistant 獨立音訊對講與 AI 語音 Package (packages/intercom.yaml)
# 遵循【HA 官方原生多設備列表與 Google Assistant SDK 規範 - 方案 B 滿意版】
# 修復重點：
# 1. 4KB 安全分段通道，徹底根絕 Linux Shell Argument list too long 靜默丟失
# 2. 廣播模式支援 Port 80 動態多端點推播
# 3. AI 模式廢除 repeat 串列迴圈，採用官方原生多 media_player 陣列一次性派發，根除 N-1 Session 衝突
# ==============================================================================

shell_command:
  clear_intercom_raw: "mkdir -p /config/www/intercom && rm -f /config/www/intercom/voice.b64 /config/www/intercom/voice.wav"
  save_intercom_chunk: "python3 -c 'import sys; f=open(\"/config/www/intercom/voice.b64\", \"a\"); f.write(\"{{ chunk }}\"); f.close()'"
  decode_intercom_raw: "python3 -c 'import base64; data=open(\"/config/www/intercom/voice.b64\", \"rb\").read(); open(\"/config/www/intercom/voice.wav\", \"wb\").write(base64.b64decode(data))'"

input_boolean:
  ai_conversation_mode:
    name: "AI 語音對話模式"
    icon: mdi:robot
  ai_voice_recording:
    name: "語音廣播發話中"
    icon: mdi:microphone-message

script:
  # ----------------------------------------------------------------------------
  # 廣播模式：真人錄音推播 (標準 Port 80 反向代理，支援多設備一次性發送)
  # ----------------------------------------------------------------------------
  intercom_play_voice:
    alias: "真人錄音對講廣播處理"
    mode: restart
    fields:
      target_player:
        description: "目標廣播播放器清單 (字串或陣列)"
    sequence:
      - action: input_boolean.turn_on
        target:
          entity_id: input_boolean.ai_voice_recording
        continue_on_error: true

      - action: media_player.play_media
        target:
          entity_id: >-
            {{ [target_player] if target_player is string else target_player }}
        data:
          # 內部靜態代理網址，加上時間戳記強制刷新瀏覽器/音箱快取
          media_content_id: "http://192.168.1.187/local/intercom/voice.wav?t={{ as_timestamp(now()) }}"
          media_content_type: "music"

      - delay:
          seconds: 3

      - action: input_boolean.turn_off
        target:
          entity_id: input_boolean.ai_voice_recording
        continue_on_error: true

  # ----------------------------------------------------------------------------
  # AI 模式：方案 B 官方標準多 ID 原生陣列派發 (全動態、單次請求、根除 N-1 衝突)
  # ----------------------------------------------------------------------------
  intercom_ai_talk:
    alias: "AI 對話語音處理 (原生 Google Assistant SDK)"
    mode: restart
    fields:
      target_player:
        description: "目標播放實體清單或單一實體"
      prompt_text:
        description: "真實語音辨識文字"
    sequence:
      - action: input_boolean.turn_on
        target:
          entity_id: input_boolean.ai_voice_recording
        continue_on_error: true

      # 方案 B 核心：動態陣列直送 SDK，向 Google 雲端僅索取 1 次回應並分派各端點
      - action: google_assistant_sdk.send_text_command
        data:
          command: "{{ prompt_text }}"
          media_player: >-
            {{ [target_player] if target_player is string else target_player }}

      - delay:
          seconds: 5

      - action: input_boolean.turn_off
        target:
          entity_id: input_boolean.ai_voice_recording
        continue_on_error: true

  # ----------------------------------------------------------------------------
  # 快捷相容別名：Gemini 直連 Alias
  # ----------------------------------------------------------------------------
  gemini:
    alias: "AI 對話發話處理 (Gemini 直連 Alias)"
    mode: restart
    fields:
      target_player:
        description: "目標播放實體清單或單一實體"
      prompt_text:
        description: "語音發話文字"
    sequence:
      - action: script.intercom_ai_talk
        data:
          target_player: "{{ target_player }}"
          prompt_text: "{{ prompt_text }}"

注意：請將腳本中的 192.168.1.187 替換為你的 Home Assistant 主機區域網路 IP 位址。

5. 步驟二：前端自訂卡片全碼 (`/config/www/intercom/intercom-card.js`)

在 /config/www 下建立 intercom 資料夾，並新增 intercom-card.js 檔案：

/**
 * Home Assistant - Universal Intercom & AI Broadcast Card (custom:intercom-card)
 * 遵循【HA 音訊排查復原點 4：Tiny Room 原生 Sections 整合、全動態端點與零 TTS 封存 - 方案 B 滿意版】
 */

class IntercomCard extends HTMLElement {
  constructor() {
    super();
    this._isAi = false;
    this.audioCtx = null;
    this.micStream = null;
    this.processor = null;
    this.pcmData = [];
    this.isRecording = false;
    this.localHolding = false;
    this.prepTimer = null;
    this.prepCount = 0;
    this.savedCheckedEntities = new Set();
    this.renderedSignature = '';
    this.recognizedSpeechText = '';
    this.recognition = null;
  }

  static getStubConfig() {
    return {};
  }

  setConfig(config) {
    if (Array.isArray(config)) {
      config = config[0] || {};
    }
    this._config = config || {};
  }

  getLayoutOptions() {
    return {
      grid_columns: 4,
      grid_min_columns: 2,
      grid_rows: 2
    };
  }

  set hass(hass) {
    this._hass = hass;
    if (!this.content) {
      this.initCard();
    }
    this.updateCardState();
    this.renderDynamicPlayers();
  }

  initCard() {
    this.innerHTML = `
      <ha-card style="padding: 10px 14px; background: #1c222b; border: 1px solid #283242; border-radius: 12px; color: #fff; box-sizing: border-box; display: flex; flex-direction: column;">
        <!-- 動態在線播放設備列表 (預設全部不勾選) -->
        <div id="player-container" style="display: flex; flex-wrap: wrap; gap: 6px; margin-bottom: 10px;"></div>

        <!-- 控制列：左側 [廣播/AI開關] + 右側 [長按語音對講按鍵] -->
        <div style="display: flex; align-items: center; gap: 10px;">
          <!-- 雙模切換膠囊 -->
          <div id="switch-box" style="display: inline-flex; align-items: center; gap: 6px; background: #181d24; border: 1px solid #2e384d; padding: 6px 12px; border-radius: 8px; flex-shrink: 0; cursor: pointer; user-select: none;">
            <span id="label-broadcast" style="font-size: 14px; font-weight: bold; color: #03a9f4; transition: color 0.2s;">廣播</span>
            <ha-switch id="ai-toggle"></ha-switch>
            <span id="label-ai" style="font-size: 14px; font-weight: bold; color: #64748b; transition: color 0.2s;">AI</span>
          </div>

          <!-- 主發話按鈕 (純色藍 #3b82f6) -->
          <button id="main-action-btn" style="flex: 1 1 140px; min-width: 140px; white-space: nowrap; height: 46px; background: #3b82f6; border: none; border-radius: 8px; color: #fff; font-weight: bold; font-size: 16px; cursor: pointer; user-select: none; -webkit-user-select: none; touch-action: none; display: flex; align-items: center; justify-content: center; gap: 8px; position: relative; overflow: hidden; box-sizing: border-box; transition: all 0.25s ease;">
            <ha-icon id="btn-icon" icon="mdi:microphone" style="color: #ffffff; --mdc-icon-size: 22px;"></ha-icon>
            <span id="btn-label" style="letter-spacing: 0.5px;">長按語音對講</span>
          </button>
        </div>
      </ha-card>
    `;

    this.content = true;
    this.mainBtn = this.querySelector('#main-action-btn');
    this.btnIcon = this.querySelector('#btn-icon');
    this.btnLabel = this.querySelector('#btn-label');
    this.aiToggle = this.querySelector('#ai-toggle');
    this.labelBroadcast = this.querySelector('#label-broadcast');
    this.labelAi = this.querySelector('#label-ai');
    this.playerContainer = this.querySelector('#player-container');

    // 雙模切換點選聯動
    const switchBox = this.querySelector('#switch-box');
    switchBox.addEventListener('click', (e) => {
      if (e.target !== this.aiToggle) {
        this.aiToggle.checked = !this.aiToggle.checked;
        this.aiToggle.dispatchEvent(new Event('change'));
      }
    });

    this.aiToggle.addEventListener('change', (e) => {
      this._isAi = e.target.checked;
      this.updateCardState();
      if (this._hass && this._hass.states && this._hass.states['input_boolean.ai_conversation_mode']) {
        this._hass.callService('input_boolean', this._isAi ? 'turn_on' : 'turn_off', {
          entity_id: 'input_boolean.ai_conversation_mode'
        });
      }
    });

    // 450ms 判定閾值 (5 步每步 90ms 橘色進度條)
    const prepChars = ['系', '系統', '系統準', '系統準備', '系統準備中'];

    const onStart = async (e) => {
      if (e.cancelable) e.preventDefault();
      const targets = this.getSelectedPlayers();
      if (targets.length === 0) {
        this.btnLabel.innerText = '⚠️ 請先勾選設備！';
        this.mainBtn.style.background = '#e65100';
        setTimeout(() => this.updateCardState(), 1200);
        return;
      }

      this.localHolding = true;
      this.isRecording = false;
      this.prepCount = 0;
      this.recognizedSpeechText = '';

      this.btnLabel.innerText = prepChars[0];
      this.mainBtn.style.background = 'linear-gradient(90deg, #ff9800 20%, #1e293b 20%)';

      // 只有廣播模式才預啟動硬體麥克風
      if (!this._isAi) {
        await this.initMicHardware();
      }

      this.prepTimer = setInterval(() => {
        this.prepCount++;
        if (this.prepCount < 5) {
          this.btnLabel.innerText = prepChars[this.prepCount];
          const pct = (this.prepCount + 1) * 20;
          this.mainBtn.style.background = `linear-gradient(90deg, #ff9800 ${pct}%, #1e293b ${pct}%)`;
        } else if (this.prepCount === 5) {
          clearInterval(this.prepTimer);
          this.prepTimer = null;
          this.isRecording = true;
          this.pcmData = []; // 清空預熱雜訊

          this.mainBtn.style.background = this._isAi ? '#15803d' : '#dc2626';
          this.btnIcon.setAttribute('icon', 'mdi:record-rec');
          this.btnLabel.innerText = '錄音中';

          // AI 模式：每次長按全新啟動獨立 SpeechRecognition 實例
          if (this._isAi) {
            this.startSpeechRecognition();
          }
        }
      }, 90);
    };

    const onEnd = async (e) => {
      if (e.cancelable) e.preventDefault();
      if (!this.localHolding) return;
      this.localHolding = false;

      // 未滿 450ms 放開：立即取消
      if (this.prepTimer) {
        clearInterval(this.prepTimer);
        this.prepTimer = null;
        if (!this._isAi) this.closeMicHardware();
        this.stopSpeechRecognition();
        this.updateCardState();
        return;
      }

      // 滿 450ms：放開按鈕微緩衝 300ms 讓辨識引擎結算最後文字後立刻送出
      if (this.isRecording) {
        this.btnLabel.innerText = '發送中...';
        await new Promise(r => setTimeout(r, 300));
        this.isRecording = false;
        await this.finishRecordingAndSend();
      }
    };

    this.mainBtn.addEventListener('pointerdown', onStart);
    this.mainBtn.addEventListener('pointerup', onEnd);
    this.mainBtn.addEventListener('pointercancel', onEnd);
  }

  // 每次全新實例化 Web Speech API
  startSpeechRecognition() {
    const SpeechRec = window.SpeechRecognition || window.webkitSpeechRecognition;
    if (!SpeechRec) {
      console.warn('[Intercom] 瀏覽器環境不支援 Web Speech API');
      return;
    }
    try {
      this.stopSpeechRecognition();
      this.recognition = new SpeechRec();
      this.recognition.lang = 'zh-TW';
      this.recognition.continuous = true;
      this.recognition.interimResults = true;
      this.recognition.maxAlternatives = 1;

      this.recognition.onresult = (e) => {
        let txt = '';
        for (let i = e.resultIndex; i < e.results.length; ++i) {
          txt += e.results[i][0].transcript;
        }
        if (txt.trim()) {
          this.recognizedSpeechText = txt.trim();
          if (this.btnLabel) {
            this.btnLabel.innerText = this.recognizedSpeechText;
          }
        }
      };

      this.recognition.onerror = (e) => {
        console.warn('[Intercom] 語音辨識事件:', e.error);
      };

      this.recognition.start();
    } catch (err) {
      console.warn('[Intercom] 啟動語音辨識異常:', err);
    }
  }

  stopSpeechRecognition() {
    if (this.recognition) {
      try { this.recognition.stop(); } catch (e) {}
      this.recognition = null;
    }
  }

  // 廣播模式：硬體原生音訊採樣
  async initMicHardware() {
    try {
      this.micStream = await navigator.mediaDevices.getUserMedia({
        audio: {
          channelCount: 1,
          echoCancellation: true,
          noiseSuppression: true,
          autoGainControl: true
        },
        video: false
      });

      const AudioCtx = window.AudioContext || window.webkitAudioContext;
      this.audioCtx = new AudioCtx();
      if (this.audioCtx.state === 'suspended') {
        await this.audioCtx.resume();
      }

      const source = this.audioCtx.createMediaStreamSource(this.micStream);
      this.pcmData = [];
      this.processor = this.audioCtx.createScriptProcessor(4096, 1, 1);

      // 核心防護：綁定全域避免在 450ms 準備期被 GC 回收
      window._activeIntercomRecorderNode = this.processor;

      this.processor.onaudioprocess = (e) => {
        if (!this.isRecording) return;
        const channel = e.inputBuffer.getChannelData(0);
        this.pcmData.push(new Float32Array(channel));
      };

      source.connect(this.processor);
      this.processor.connect(this.audioCtx.destination);
    } catch(err) {
      console.error('[Intercom] 麥克風啟動異常:', err);
    }
  }

  closeMicHardware() {
    window._activeIntercomRecorderNode = null;
    if (this.processor) { try { this.processor.disconnect(); } catch(e) {} this.processor = null; }
    if (this.micStream) { try { this.micStream.getTracks().forEach(t => t.stop()); } catch(e) {} this.micStream = null; }
    if (this.audioCtx) { try { this.audioCtx.close(); } catch(e) {} this.audioCtx = null; }
  }

  async finishRecordingAndSend() {
    const targets = this.getSelectedPlayers();

    try {
      if (this._isAi) {
        this.stopSpeechRecognition();
        const q = this.recognizedSpeechText.trim();
        if (!q) {
          console.warn('[Intercom] AI 模式未錄得有效文字，取消發送');
          if (this.btnLabel) this.btnLabel.innerText = '⚠️ 未識別到語音';
          if (this.mainBtn) this.mainBtn.style.background = '#e65100';
          setTimeout(() => this.updateCardState(), 1500);
          return;
        }

        console.log('[Intercom] AI 模式：發送真實識別文字:', q, '動態目標端點清單:', targets);
        this.btnLabel.innerText = 'AI 回應中...';
        await this._hass.callService('script', 'intercom_ai_talk', {
          prompt_text: q,
          target_player: targets
        });
      } else {
        // 廣播模式：抓取設備真實取樣率 (44100Hz / 48000Hz)
        const realSampleRate = (this.audioCtx && this.audioCtx.sampleRate) ? this.audioCtx.sampleRate : 44100;
        const wavBlob = this.encodeWAV(this.pcmData, realSampleRate);
        this.closeMicHardware();

        if (!wavBlob || wavBlob.size < 1000) {
          console.warn('[Intercom] 錄音數據為空，取消廣播');
          if (this.btnLabel) this.btnLabel.innerText = '⚠️ 錄音為空';
          setTimeout(() => this.updateCardState(), 1200);
          return;
        }

        console.log(`[Intercom] 成功錄得原音: ${wavBlob.size} bytes, 取樣率: ${realSampleRate}Hz`);
        await this.uploadAndPlay(wavBlob, targets);
      }
    } catch(err) {
      console.error('[Intercom] 派發異常:', err);
    } finally {
      this.updateCardState();
    }
  }

  // 安全分段通道 (每包 4KB 寫入，保證 voice.wav 100% 寫出)
  async uploadAndPlay(wavBlob, targets) {
    return new Promise((resolve) => {
      const reader = new FileReader();
      reader.readAsDataURL(wavBlob);
      reader.onloadend = async () => {
        try {
          const b64 = reader.result.split(',')[1];
          if (!b64) { resolve(); return; }

          console.log(`[Intercom] 開始寫入音訊，Base64 總長度: ${b64.length}`);

          // 1. 先清空並初始化暫存檔
          await this._hass.callService('shell_command', 'clear_intercom_raw');

          // 2. 每包 4000 字元分段寫入，徹底避免 Argument list too long
          const chunkSize = 4000;
          for (let i = 0; i < b64.length; i += chunkSize) {
            const chunk = b64.slice(i, i + chunkSize);
            await this._hass.callService('shell_command', 'save_intercom_chunk', {
              chunk: chunk
            });
          }

          // 3. 呼叫解碼產生 voice.wav
          await this._hass.callService('shell_command', 'decode_intercom_raw');

          // 4. 等待 200ms 讓磁碟寫入完成
          await new Promise(r => setTimeout(r, 200));

          console.log('[Intercom] voice.wav 產出完成，呼叫 script.intercom_play_voice 推播給:', targets);
          await this._hass.callService('script', 'intercom_play_voice', {
            target_player: targets
          });
        } catch(e) {
          console.error('[Intercom] 上傳播放失敗:', e);
        }
        resolve();
      };
      reader.onerror = () => resolve();
    });
  }

  getSelectedPlayers() {
    return Array.from(this.querySelectorAll('.player-chk:checked')).map(i => i.value);
  }

  renderDynamicPlayers() {
    if (!this.playerContainer || !this._hass || !this._hass.states) return;

    this.querySelectorAll('.player-chk').forEach(input => {
      if (input.checked) this.savedCheckedEntities.add(input.value);
      else this.savedCheckedEntities.delete(input.value);
    });

    const candidateEntities = Object.keys(this._hass.states).filter(entityId => {
      if (!entityId.startsWith('media_player.')) return false;
      const s = this._hass.states[entityId];
      return s && !['unavailable', 'unknown', 'off'].includes(s.state);
    });

    const deduplicated = new Map();
    candidateEntities.forEach(id => {
      const s = this._hass.states[id];
      const name = (s && s.attributes && s.attributes.friendly_name) || id.replace('media_player.', '');
      if (!deduplicated.has(name) || id > deduplicated.get(name).id) {
        deduplicated.set(name, { id, name });
      }
    });

    const playerList = Array.from(deduplicated.values());
    const signature = playerList.map(p => p.id).sort().join(',');

    if (this.renderedSignature !== signature) {
      this.renderedSignature = signature;
      this.playerContainer.innerHTML = playerList.map(p => {
        const checked = this.savedCheckedEntities.has(p.id) ? 'checked' : '';
        return `
          <label style="display: inline-flex; align-items: center; gap: 6px; padding: 4px 10px; background: #262e3d; border: 1px solid #3b465c; border-radius: 6px; cursor: pointer; font-size: 13px; color: #e2e8f0; user-select: none; transition: all 0.2s;">
            <input type="checkbox" class="player-chk" value="${p.id}" ${checked} style="accent-color: #03a9f4; width: 16px; height: 16px; margin: 0; cursor: pointer;">
            <span>${p.name}</span>
          </label>
        `;
      }).join('');
    }
  }

  updateCardState() {
    if (!this.content) return;
    this.aiToggle.checked = this._isAi;

    if (this.localHolding) return;

    if (this._isAi) {
      this.labelBroadcast.style.color = '#64748b';
      this.labelAi.style.color = '#38bdf8';
      this.mainBtn.style.background = '#0284c7';
      this.btnIcon.setAttribute('icon', 'mdi:robot');
      this.btnLabel.innerText = '長按 AI 對話';
    } else {
      this.labelBroadcast.style.color = '#03a9f4';
      this.labelAi.style.color = '#64748b';
      this.mainBtn.style.background = '#3b82f6';
      this.btnIcon.setAttribute('icon', 'mdi:microphone');
      this.btnLabel.innerText = '長按語音對講';
    }
  }

  encodeWAV(samplesArrays, sampleRate) {
    let total = 0;
    for (const a of samplesArrays) total += a.length;
    if (total === 0) return null;
    const samples = new Float32Array(total);
    let offset = 0;
    for (const a of samplesArrays) { samples.set(a, offset); offset += a.length; }

    const buffer = new ArrayBuffer(44 + samples.length * 2);
    const view = new DataView(buffer);
    const writeStr = (v, o, s) => { for (let i = 0; i < s.length; i++) v.setUint8(o + i, s.charCodeAt(i)); };

    writeStr(view, 0, 'RIFF');
    view.setUint32(4, 36 + samples.length * 2, true);
    writeStr(view, 8, 'WAVE');
    writeStr(view, 12, 'fmt ');
    view.setUint32(16, 16, true);
    view.setUint16(20, 1, true); // PCM 格式
    view.setUint16(22, 1, true); // 單聲道
    view.setUint32(24, sampleRate, true); // 動態真實取樣率
    view.setUint32(28, sampleRate * 2, true); // Byte rate
    view.setUint16(32, 2, true); // Block align
    view.setUint16(34, 16, true); // 16-bit
    writeStr(view, 36, 'data');
    view.setUint32(40, samples.length * 2, true);

    let idx = 44;
    for (let i = 0; i < samples.length; i++) {
      let s = Math.max(-1, Math.min(1, samples[i]));
      view.setInt16(idx, s < 0 ? s * 0x8000 : s * 0x7FFF, true);
      idx += 2;
    }
    return new Blob([view], { type: 'audio/wav' });
  }
}

customElements.define('intercom-card', IntercomCard);

window.customCards = window.customCards || [];
window.customCards.push({
  type: 'intercom-card',
  name: 'Intercom Card',
  description: 'Universal Intercom & AI Broadcast Card',
  preview: true
});

6. 步驟三：儀表板註冊與啟用

註冊前端資源（Resources）：
- 前往 HA 「設定」 -> 「儀表板」 -> 右上角「資源」。
- 點擊「新增資源」，輸入：
  - URL：/local/intercom/intercom-card.js?v=20261011
  - 資源類型：JavaScript 模組 (JavaScript Module)
重新載入腳本與設定：
- 前往 「開發者工具」 -> 「YAML」，分別點擊：
  - 「重新載入腳本 (Reload Scripts)」
  - 「重新載入命令列 (Reload Shell Commands)」
  - 「重新載入手動設定的 input_booleans」
新增卡片到儀表板：
- 進入任何儀表板檢視，點擊「新增卡片」，滑到最底選擇「手動 (Manual)」，輸入：
```
type: custom:intercom-card
```
- 儲存後，卡片會自動列出系統中所有非 off / unavailable 的 media_player。

7. 操作說明與智慧家庭語音控制實務

模式切換操作

卡片左側具備 [廣播 / AI] 膠囊切換鈕：
- 廣播模式（藍色）：按鈕顯示「長按語音對講」，收錄真人聲音並原音推播給勾選設備。
- AI 模式（綠色）：按鈕顯示「長按 AI 對話」，將辨識出的繁體中文文字傳送給 Google Assistant SDK。

長按判定保護機制

按下按鈕時有 450ms 系統準備期（按鈕呈現橘色進度條並逐字顯示「系統準備中」）。
防誤觸設計：若按下時間未滿 450ms 放開，系統會自動取消，不產生無效上傳。
滿 450ms 後按鈕變色並顯示「錄音中」，放開按鈕後微延遲 300ms 完成封裝並自動送出。

直接用語音控制家電

在 AI 模式下，因直接對接 Google Assistant SDK，你可以在勾選任意喇叭的情況下直接說出：

開關控制：「打開客廳燈」、「關閉車庫大門」、「打開電視」。
數值調節：「把冷氣溫度調到 25 度」、「將玄關燈亮度設定為 60%」。
情境觸發：「執行睡眠模式」、「啟動離家模式」。
狀態查詢：「客廳溫度幾度？」、「今天外面天氣怎麼樣？」。

Google Assistant 執行完畢後的語音反饋（如「好的，已開啟客廳燈」），會同步廣播至所有勾選的播放器中。

8. 瀏覽器相容性參考

瀏覽器核心 / 品牌	原聲廣播 (PCM WAV)	AI 模式 (Web Speech API)	備註說明
Google Chrome	✅ 支援	✅ 支援	原生完整支援 Google 語音識別雲端金鑰。
Comet (Chromium)	✅ 支援	✅ 支援	完美適配 Web Audio 與 Web Speech。
Microsoft Edge	✅ 支援	⚠️ 部分支援	依賴微軟 Azure Speech 服務，延遲略高。
Brave	✅ 支援	❌ 不相容	隱私引擎強制攔截音訊上傳至 Google。
Vivaldi	✅ 支援	❌ 不相容	缺少 Google Speech 授權 Key，回報 Network Error。
iOS Safari / Chrome	✅ 支援 (需 HTTPS)	⚠️ 受限	iOS 限制背景長按錄音生命週期，建議使用實體發話端點或桌面端。

9. 排查與檢核清單（Troubleshooting）

點擊發話卡片顯示「⚠️ 請先勾選設備！」：
- 請至少在設備列表中勾選一台 media_player。
廣播沒聲音，但 HA 腳本有被觸發：
- 確認 /config/packages/intercom.yaml 中的 IP 是否與當前 HA 主機 IP 一致。
- 檢查瀏覽器控制台（F12），確認音訊是否成功以 4KB 分段上傳至 /local/intercom/voice.wav。
按住時沒有橘色進度條或按鍵無反應：
- 請確認網頁是否透過 http:// 或內部 IP 連線，部分瀏覽器需要 Secure Context（HTTPS 或 localhost / 內網 IP 授權）才允許存取麥克風。
Google Audio 與其他喇叭聲音不同步或回覆舊問題：
- 請確認 packages/intercom.yaml 中的 intercom_ai_talk 是否已完全採用動態陣列直送，而非 repeat 迴圈。

Dify 整合架構

2026-10-07T22:07:36.746+08:00

🎙️ 打造極致 Home Assistant 智能管家：Dify 大腦、Google AI TTS 真人發聲與全域原音對講實戰落地

在現代智慧家庭中，傳統語音助理往往受限於原廠封閉生態、呆板的機器發音以及無法跨裝置廣播的限制。本文公開一套經實機驗證通過的完整生產級架構：以 Dify 本地大腦 賦予管家人性化思維與時空感知，結合次世代 Google AI TTS 擬真口吻開口朗讀，並相容自研 Universal Intercom Card (v=6.0) 實現極低延遲的跨端點 PCM 原音廣播。

🏛️ 系統架構與關鍵技術突破

4KB 安全分段通道（Chunk-based Upload）：前端錄音編碼後，以每包 4,000 字元分段追加寫入 voice.b64，後端直接以 Python 原生庫進行二進位解碼產出 voice.wav，根治 Linux 終端 Argument list too long 與 0 byte 假檔案問題。
動態環境感知上下文注入：大語言模型本體具無狀態特性。後端腳本於觸發對話當下，自動將精確年月日時分、星期與家中 Weather 感測器數據動態包裹為環境上下文，使 Dify 具備即時時空意識。
先進先出（FIFO）滾動通知抽屜：利用微秒級時間戳動態管理通知實體，當記錄累積達 3 筆時自動清除最舊一筆，完美維持最新 3 筆對話歷史常駐顯示。
播放佇列自動釋放機制：監控各媒體播放端點狀態，播音結束後延遲 2 秒自動調用 clear_playlist，避免介面殘留暫停標題或鎖定音訊通道。

🛠️ 第一步：部署後端單一真理來源配置

在 Home Assistant 建立檔案 /config/packages/intercom_pkg.yaml，全選貼上以下自洽配置：

# ==============================================================================
# File: /config/packages/intercom_pkg.yaml
# Description: Dify 智能管家大腦、Google AI TTS 播報與原音廣播整合套件
# ==============================================================================

shell_command:
  clear_intercom_raw: >-
    rm -f /config/www/intercom/voice.wav /config/www/intercom/voice.b64
  save_intercom_chunk: >-
    python3 -c "import sys; open('/config/www/intercom/voice.b64', 'a', encoding='utf-8').write('''{{ chunk }}''')"
  decode_intercom_raw: >-
    python3 -c "import base64; open('/config/www/intercom/voice.wav', 'wb').write(base64.b64decode(open('/config/www/intercom/voice.b64', 'r', encoding='utf-8').read().strip()))"

input_boolean:
  ai_conversation_mode:
    name: "AI 對話模式"
    icon: mdi:robot

script:
  # ----------------------------------------------------------------------------
  # A. 原音廣播核心：推播至前端動態勾選之端點
  # ----------------------------------------------------------------------------
  intercom_play_voice:
    alias: "Intercom: Play Voice Broadcast"
    mode: single
    max_exceeded: silent
    fields:
      target_player:
        description: "前端勾選之 media_player 清單"
    sequence:
      - condition: template
        value_template: "{{ target_player is defined and target_player | length > 0 }}"
      - alias: "推播 16kHz PCM 原音至勾選設備"
        action: media_player.play_media
        target:
          entity_id: "{{ target_player }}"
        data:
          media_content_id: "/local/intercom/voice.wav"
          media_content_type: "music"

  # ----------------------------------------------------------------------------
  # B. AI 對話核心：環境感知注入 + Dify 大腦 + 3 筆滾動通知 + Google AI TTS
  # ----------------------------------------------------------------------------
  intercom_ai_talk:
    alias: "Intercom: AI Talk (Dify + Google AI TTS)"
    mode: single
    max_exceeded: silent
    fields:
      prompt_text:
        description: "前端 Web Speech 識別文字"
      target_player:
        description: "前端勾選之發聲端點清單"
    sequence:
      - variables:
          target_text: "{{ prompt_text | default('', true) | trim }}"
          current_time: "{{ now().strftime('%Y年%m月%d日 %H點%M分') }}"
          current_weekday: >-
            {% set days = ['星期一', '星期二', '星期三', '星期四', '星期五', '星期六', '星期日'] %}
            {{ days[now().weekday()] }}
          weather_entity: >-
            {{ states.weather | map(attribute='entity_id') | first | default('', true) }}
          weather_state: >-
            {% if weather_entity != '' %}
              {{ states(weather_entity) }}，氣溫 {{ state_attr(weather_entity, 'temperature') }}°C，濕度 {{ state_attr(weather_entity, 'humidity') }}%
            {% else %}
              目前無可用天氣感測器
            {% endif %}
          enriched_prompt: >-
            [系統環境資訊：當前時間是 {{ current_time }} {{ current_weekday }}；住家天氣狀況為：{{ weather_state }}]
            使用者發問：{{ target_text }}

      - condition: template
        value_template: "{{ target_text | length > 0 }}"

      - alias: "調用 Dify 大腦處理對話"
        action: conversation.process
        data:
          text: "{{ enriched_prompt }}"
          agent_id: conversation.dify_voice_assistant
        response_variable: dify_reply

      - variables:
          ai_answer: "{{ dify_reply.response.speech.plain.speech }}"
          existing_notifications: >-
            {{ states.persistent_notification 
               | selectattr('entity_id', 'search', '^persistent_notification.intercom_dify_') 
               | sort(attribute='last_updated') 
               | map(attribute='entity_id') 
               | list }}

      # 限制通知抽屜最多常駐 3 筆
      - choose:
          - conditions:
              - condition: template
                value_template: "{{ existing_notifications | length >= 3 }}"
            sequence:
              - alias: "裁切超出上限之最舊通知"
                action: persistent_notification.dismiss
                data:
                  notification_id: "{{ existing_notifications[0].replace('persistent_notification.', '') }}"

      - alias: "推播家庭管家回覆通知"
        action: persistent_notification.create
        data:
          title: "家庭管家回覆 ({{ now().strftime('%H:%M:%S') }})"
          message: "{{ ai_answer }}"
          notification_id: "intercom_dify_{{ now().strftime('%Y%m%d_%H%M%S_%f') }}"

      # 調用 Google AI TTS 生成式語音推播
      - choose:
          - conditions:
              - condition: template
                value_template: "{{ target_player is defined and target_player | length > 0 }}"
            sequence:
              - alias: "調用 Google AI TTS 朗讀"
                action: tts.speak
                target:
                  entity_id: >-
                    {{ 'tts.google_ai_tts' if states('tts.google_ai_tts') != 'unknown' else 'tts.google_translate_zh_tw_com' }}
                data:
                  media_player_entity_id: "{{ target_player }}"
                  message: "{{ ai_answer }}"

  # ----------------------------------------------------------------------------
  # C. 自動釋放佇列：播放完畢延遲 2 秒清理
  # ----------------------------------------------------------------------------
  intercom_auto_clear_player:
    alias: "Intercom: Auto Clear Player"
    mode: parallel
    fields:
      target_entity:
        description: "動態傳入的媒體播放器實體"
    sequence:
      - delay:
          seconds: 2
      - condition: template
        value_template: "{{ states(target_entity) in ['idle', 'paused', 'off'] }}"
      - action: media_player.clear_playlist
        target:
          entity_id: "{{ target_entity }}"

automation:
  - alias: "Intercom: Media Player Idle Watchdog"
    id: intercom_media_player_idle_watchdog
    mode: parallel
    trigger:
      - platform: event
        event_type: state_changed
    condition:
      - condition: template
        value_template: >-
          {{ trigger.event.data.entity_id.startswith('media_player.') 
             and trigger.event.data.new_state.state in ['idle', 'paused']
             and trigger.event.data.old_state.state == 'playing' }}
    action:
      - action: script.intercom_auto_clear_player
        data:
          target_entity: "{{ trigger.event.data.entity_id }}"

📱 第二步：部署前端對講卡片

在 Home Assistant 建立檔案 /config/www/intercom/intercom-card.js，貼上 v=6.0 滿意版代碼：

/**
 * Home Assistant - Universal Intercom & AI Broadcast Card (custom:intercom-card)
 * Version: 6.0
 */

class IntercomCard extends HTMLElement {
  constructor() {
    super();
    this._isAi = false;
    this.audioCtx = null;
    this.micStream = null;
    this.processor = null;
    this.pcmData = [];
    this.isRecording = false;
    this.localHolding = false;
    this.prepTimer = null;
    this.prepCount = 0;
    this.savedCheckedEntities = new Set();
    this.renderedSignature = '';
    this.recognizedSpeechText = '';
    this.recognition = null;
  }

  static getStubConfig() { return {}; }
  setConfig(config) { this._config = (Array.isArray(config) ? config[0] : config) || {}; }
  getLayoutOptions() { return { grid_columns: 4, grid_min_columns: 2, grid_rows: 2 }; }

  set hass(hass) {
    this._hass = hass;
    if (!this.content) this.initCard();
    this.updateCardState();
    this.renderDynamicPlayers();
  }

  initCard() {
    this.innerHTML = `
      <ha-card style="padding: 10px 14px; background: #1c222b; border: 1px solid #283242; border-radius: 12px; color: #fff; box-sizing: border-box; display: flex; flex-direction: column;">
        <div id="player-container" style="display: flex; flex-wrap: wrap; gap: 6px; margin-bottom: 10px;"></div>
        <div style="display: flex; align-items: center; gap: 10px;">
          <div id="switch-box" style="display: inline-flex; align-items: center; gap: 6px; background: #181d24; border: 1px solid #2e384d; padding: 6px 12px; border-radius: 8px; flex-shrink: 0; cursor: pointer; user-select: none;">
            <span id="label-broadcast" style="font-size: 14px; font-weight: bold; color: #03a9f4; transition: color 0.2s;">廣播</span>
            <ha-switch id="ai-toggle"></ha-switch>
            <span id="label-ai" style="font-size: 14px; font-weight: bold; color: #64748b; transition: color 0.2s;">AI</span>
          </div>
          <button id="main-action-btn" style="flex: 1 1 140px; min-width: 140px; white-space: nowrap; height: 46px; background: #3b82f6; border: none; border-radius: 8px; color: #fff; font-weight: bold; font-size: 16px; cursor: pointer; user-select: none; -webkit-user-select: none; touch-action: none; display: flex; align-items: center; justify-content: center; gap: 8px; position: relative; overflow: hidden; box-sizing: border-box; transition: all 0.25s ease;">
            <ha-icon id="btn-icon" icon="mdi:microphone" style="color: #ffffff; --mdc-icon-size: 22px;"></ha-icon>
            <span id="btn-label" style="letter-spacing: 0.5px;">長按語音對講</span>
          </button>
        </div>
      </ha-card>
    `;

    this.content = true;
    this.mainBtn = this.querySelector('#main-action-btn');
    this.btnIcon = this.querySelector('#btn-icon');
    this.btnLabel = this.querySelector('#btn-label');
    this.aiToggle = this.querySelector('#ai-toggle');
    this.labelBroadcast = this.querySelector('#label-broadcast');
    this.labelAi = this.querySelector('#label-ai');
    this.playerContainer = this.querySelector('#player-container');

    const switchBox = this.querySelector('#switch-box');
    switchBox.addEventListener('click', (e) => {
      if (e.target !== this.aiToggle) {
        this.aiToggle.checked = !this.aiToggle.checked;
        this.aiToggle.dispatchEvent(new Event('change'));
      }
    });

    this.aiToggle.addEventListener('change', (e) => {
      this._isAi = e.target.checked;
      this.updateCardState();
      if (this._hass && this._hass.states && this._hass.states['input_boolean.ai_conversation_mode']) {
        this._hass.callService('input_boolean', this._isAi ? 'turn_on' : 'turn_off', {
          entity_id: 'input_boolean.ai_conversation_mode'
        });
      }
    });

    const prepChars = ['系', '系統', '系統準', '系統準備', '系統準備中'];

    const onStart = async (e) => {
      if (e.cancelable) e.preventDefault();
      const targets = this.getSelectedPlayers();
      if (targets.length === 0) {
        this.btnLabel.innerText = '⚠️ 請先勾選設備！';
        this.mainBtn.style.background = '#e65100';
        setTimeout(() => this.updateCardState(), 1200);
        return;
      }

      this.localHolding = true;
      this.isRecording = false;
      this.prepCount = 0;
      this.recognizedSpeechText = '';

      this.btnLabel.innerText = prepChars[0];
      this.mainBtn.style.background = 'linear-gradient(90deg, #ff9800 20%, #1e293b 20%)';

      if (!this._isAi) await this.initMicHardware();

      this.prepTimer = setInterval(() => {
        this.prepCount++;
        if (this.prepCount < 5) {
          this.btnLabel.innerText = prepChars[this.prepCount];
          const pct = (this.prepCount + 1) * 20;
          this.mainBtn.style.background = `linear-gradient(90deg, #ff9800 ${pct}%, #1e293b ${pct}%)`;
        } else if (this.prepCount === 5) {
          clearInterval(this.prepTimer);
          this.prepTimer = null;
          this.isRecording = true;
          this.pcmData = [];

          this.mainBtn.style.background = this._isAi ? '#15803d' : '#dc2626';
          this.btnIcon.setAttribute('icon', 'mdi:record-rec');
          this.btnLabel.innerText = '錄音中';

          if (this._isAi) this.startSpeechRecognition();
        }
      }, 90);
    };

    const onEnd = async (e) => {
      if (e.cancelable) e.preventDefault();
      if (!this.localHolding) return;
      this.localHolding = false;

      if (this.prepTimer) {
        clearInterval(this.prepTimer);
        this.prepTimer = null;
        if (!this._isAi) this.closeMicHardware();
        this.stopSpeechRecognition();
        this.updateCardState();
        return;
      }

      if (this.isRecording) {
        this.btnLabel.innerText = '發送中...';
        await new Promise(r => setTimeout(r, 300));
        this.isRecording = false;
        await this.finishRecordingAndSend();
      }
    };

    this.mainBtn.addEventListener('pointerdown', onStart);
    this.mainBtn.addEventListener('pointerup', onEnd);
    this.mainBtn.addEventListener('pointercancel', onEnd);
  }

  startSpeechRecognition() {
    const SpeechRec = window.SpeechRecognition || window.webkitSpeechRecognition;
    if (!SpeechRec) return;
    try {
      this.stopSpeechRecognition();
      this.recognition = new SpeechRec();
      this.recognition.lang = 'zh-TW';
      this.recognition.continuous = true;
      this.recognition.interimResults = true;
      this.recognition.maxAlternatives = 1;

      this.recognition.onresult = (e) => {
        let txt = '';
        for (let i = e.resultIndex; i < e.results.length; ++i) txt += e.results[i][0].transcript;
        if (txt.trim()) {
          this.recognizedSpeechText = txt.trim();
          if (this.btnLabel) this.btnLabel.innerText = this.recognizedSpeechText;
        }
      };
      this.recognition.start();
    } catch (err) {}
  }

  stopSpeechRecognition() {
    if (this.recognition) {
      try { this.recognition.stop(); } catch (e) {}
      this.recognition = null;
    }
  }

  async initMicHardware() {
    try {
      this.micStream = await navigator.mediaDevices.getUserMedia({
        audio: { channelCount: 1, echoCancellation: true, noiseSuppression: true, autoGainControl: true },
        video: false
      });
      const AudioCtx = window.AudioContext || window.webkitAudioContext;
      this.audioCtx = new AudioCtx();
      if (this.audioCtx.state === 'suspended') await this.audioCtx.resume();

      const source = this.audioCtx.createMediaStreamSource(this.micStream);
      this.pcmData = [];
      this.processor = this.audioCtx.createScriptProcessor(4096, 1, 1);
      window._activeIntercomRecorderNode = this.processor;

      this.processor.onaudioprocess = (e) => {
        if (!this.isRecording) return;
        this.pcmData.push(new Float32Array(e.inputBuffer.getChannelData(0)));
      };

      source.connect(this.processor);
      this.processor.connect(this.audioCtx.destination);
    } catch(err) {}
  }

  closeMicHardware() {
    window._activeIntercomRecorderNode = null;
    if (this.processor) { try { this.processor.disconnect(); } catch(e) {} this.processor = null; }
    if (this.micStream) { try { this.micStream.getTracks().forEach(t => t.stop()); } catch(e) {} this.micStream = null; }
    if (this.audioCtx) { try { this.audioCtx.close(); } catch(e) {} this.audioCtx = null; }
  }

  async finishRecordingAndSend() {
    const targets = this.getSelectedPlayers();
    try {
      if (this._isAi) {
        this.stopSpeechRecognition();
        const q = this.recognizedSpeechText.trim();
        if (!q) {
          if (this.btnLabel) this.btnLabel.innerText = '⚠️ 未識別到語音';
          if (this.mainBtn) this.mainBtn.style.background = '#e65100';
          setTimeout(() => this.updateCardState(), 1500);
          return;
        }
        this.btnLabel.innerText = 'AI 回應中...';
        await this._hass.callService('script', 'intercom_ai_talk', {
          prompt_text: q,
          target_player: targets
        });
      } else {
        const realSampleRate = (this.audioCtx && this.audioCtx.sampleRate) ? this.audioCtx.sampleRate : 44100;
        const wavBlob = this.encodeWAV(this.pcmData, realSampleRate);
        this.closeMicHardware();
        if (!wavBlob || wavBlob.size < 1000) {
          if (this.btnLabel) this.btnLabel.innerText = '⚠️ 錄音為空';
          setTimeout(() => this.updateCardState(), 1200);
          return;
        }
        await this.uploadAndPlay(wavBlob, targets);
      }
    } catch(err) {
    } finally {
      this.updateCardState();
    }
  }

  async uploadAndPlay(wavBlob, targets) {
    return new Promise((resolve) => {
      const reader = new FileReader();
      reader.readAsDataURL(wavBlob);
      reader.onloadend = async () => {
        try {
          const b64 = reader.result.split(',')[1];
          if (!b64) { resolve(); return; }
          await this._hass.callService('shell_command', 'clear_intercom_raw');
          const chunkSize = 4000;
          for (let i = 0; i < b64.length; i += chunkSize) {
            await this._hass.callService('shell_command', 'save_intercom_chunk', {
              chunk: b64.slice(i, i + chunkSize)
            });
          }
          await this._hass.callService('shell_command', 'decode_intercom_raw');
          await new Promise(r => setTimeout(r, 200));
          await this._hass.callService('script', 'intercom_play_voice', {
            target_player: targets
          });
        } catch(e) {}
        resolve();
      };
      reader.onerror = () => resolve();
    });
  }

  getSelectedPlayers() {
    return Array.from(this.querySelectorAll('.player-chk:checked')).map(i => i.value);
  }

  renderDynamicPlayers() {
    if (!this.playerContainer || !this._hass || !this._hass.states) return;
    this.querySelectorAll('.player-chk').forEach(input => {
      if (input.checked) this.savedCheckedEntities.add(input.value);
      else this.savedCheckedEntities.delete(input.value);
    });

    const candidateEntities = Object.keys(this._hass.states).filter(entityId => {
      if (!entityId.startsWith('media_player.')) return false;
      const s = this._hass.states[entityId];
      return s && !['unavailable', 'unknown', 'off'].includes(s.state);
    });

    const deduplicated = new Map();
    candidateEntities.forEach(id => {
      const s = this._hass.states[id];
      const name = (s && s.attributes && s.attributes.friendly_name) || id.replace('media_player.', '');
      if (!deduplicated.has(name) || id > deduplicated.get(name).id) {
        deduplicated.set(name, { id, name });
      }
    });

    const playerList = Array.from(deduplicated.values());
    const signature = playerList.map(p => p.id).sort().join(',');

    if (this.renderedSignature !== signature) {
      this.renderedSignature = signature;
      this.playerContainer.innerHTML = playerList.map(p => {
        const checked = this.savedCheckedEntities.has(p.id) ? 'checked' : '';
        return `
          <label style="display: inline-flex; align-items: center; gap: 6px; padding: 4px 10px; background: #262e3d; border: 1px solid #3b465c; border-radius: 6px; cursor: pointer; font-size: 13px; color: #e2e8f0; user-select: none; transition: all 0.2s;">
            <input type="checkbox" class="player-chk" value="${p.id}" ${checked} style="accent-color: #03a9f4; width: 16px; height: 16px; margin: 0; cursor: pointer;">
            <span>${p.name}</span>
          </label>
        `;
      }).join('');
    }
  }

  updateCardState() {
    if (!this.content) return;
    this.aiToggle.checked = this._isAi;
    if (this.localHolding) return;

    if (this._isAi) {
      this.labelBroadcast.style.color = '#64748b';
      this.labelAi.style.color = '#38bdf8';
      this.mainBtn.style.background = '#0284c7';
      this.btnIcon.setAttribute('icon', 'mdi:robot');
      this.btnLabel.innerText = '長按 AI 對話';
    } else {
      this.labelBroadcast.style.color = '#03a9f4';
      this.labelAi.style.color = '#64748b';
      this.mainBtn.style.background = '#3b82f6';
      this.btnIcon.setAttribute('icon', 'mdi:microphone');
      this.btnLabel.innerText = '長按語音對講';
    }
  }

  encodeWAV(samplesArrays, sampleRate) {
    let total = 0;
    for (const a of samplesArrays) total += a.length;
    if (total === 0) return null;
    const samples = new Float32Array(total);
    let offset = 0;
    for (const a of samplesArrays) { samples.set(a, offset); offset += a.length; }

    const buffer = new ArrayBuffer(44 + samples.length * 2);
    const view = new DataView(buffer);
    const writeStr = (v, o, s) => { for (let i = 0; i < s.length; i++) v.setUint8(o + i, s.charCodeAt(i)); };

    writeStr(view, 0, 'RIFF');
    view.setUint32(4, 36 + samples.length * 2, true);
    writeStr(view, 8, 'WAVE');
    writeStr(view, 12, 'fmt ');
    view.setUint32(16, 16, true);
    view.setUint16(20, 1, true);
    view.setUint16(22, 1, true);
    view.setUint32(24, sampleRate, true);
    view.setUint32(28, sampleRate * 2, true);
    view.setUint16(32, 2, true);
    view.setUint16(34, 16, true);
    writeStr(view, 36, 'data');
    view.setUint32(40, samples.length * 2, true);

    let idx = 44;
    for (let i = 0; i < samples.length; i++) {
      let s = Math.max(-1, Math.min(1, samples[i]));
      view.setInt16(idx, s < 0 ? s * 0x8000 : s * 0x7FFF, true);
      idx += 2;
    }
    return new Blob([view], { type: 'audio/wav' });
  }
}

customElements.define('intercom-card', IntercomCard);
window.customCards = window.customCards || [];
window.customCards.push({
  type: 'intercom-card',
  name: 'Intercom Card',
  description: 'Universal Intercom & AI Broadcast Card',
  preview: true
});

⚙️ 第三步：儀表板註冊與語音助手管線綁定

進入 Settings (設定) ➔ Dashboards (儀表板) ➔ Resources (資源)，新增資源 URL：/local/intercom/intercom-card.js?v=6.0，型態為 JavaScript Module。
在 Lovelace 儀表板中新增手動卡片，填入 type: custom:intercom-card。
進入 Settings (設定) ➔ Voice assistants (語音助理)，確認對話代理指向 Dify (conversation.dify_voice_assistant)，TTS 指向 Google AI TTS (tts.google_ai_tts)。
在 Dify 後台 System Prompt 尾端追加以下規範：
若輸入開頭包含 [系統環境資訊：...]，此為當下真實客觀時空背景，請據此親切回答使用者關於時間、星期或天氣之提問，嚴禁複誦括號內標籤。全篇使用繁體中文（台灣）口語化風格。

📊 驗收指標與客觀數據

項目	驗收基準	標準輸出狀態
原音廣播產出	長按 3 秒發話並放開	`voice.wav` 實體落地，容量約 117KB~200KB（大於 0 byte）
多端點派發	勾選 Sony XZ1、Google Cast 等	放開後 200ms 內各音箱同步出聲播音
管家時空感知	長按 AI 詢問現在時間天氣	精確回答當前時間與溫濕度，並以 Google AI TTS 擬真發聲
通知滾動歷史	連續發問 3 次以上	通知抽屜常駐精確保留最新 3 筆，標題帶時間戳，滿 3 筆先進先出汰換
佇列防殘留	播音結束狀態轉為 idle	延遲 2 秒自動調用 `clear_playlist` 清

🎙️ Home Assistant 2026.10 Dify 雙向中控與 Edge-TTS 曉臻擬真發音

在家庭智慧中控的演進過程中，語音互動的自然度與穩定度是決定體驗成敗的關鍵。我們在基於 PVE 8.4.14 與 VM105 HAOS 的生產環境中，完成了 Dify 智能大腦與 Home Assistant 官方 Voice Assistant Pipeline 的深度整合，成功解構多項架構瓶頸，實現全屋零按鍵負擔的智慧管家互動鏈路。

💡 架構升級三大核心亮點

🚫 根絕 429 資源耗盡：捨棄每日僅 10 次配額的雲端 Gemini TTS，全面遷移至開源 Microsoft Edge-TTS 整合，完全免 API Key、零調用次數限制。
🗣️ 旗艦級中英混讀體驗：採用 zh-TW-HsiaoChenNeural（曉臻）神經語音模型，完美呈現台灣在地語調，中英文名詞穿插切換自然流暢。
🧹 喚醒前綴自動淨化：建立正則過濾中繼，自動切除「OK／嘿／嗨／喂小管家」等口語前綴，大幅縮減送往 Dify Agent 的 Token 消耗。
🛡️ 系統純淨與 Sections 原生相容：堅持 Storage Mode 視覺化可編輯規範，所有對話稽核收斂至 system_log.write，杜絕前端擾民彈窗。

⚙️ 核心後端腳本工程落實（/config/packages/intercom_pkg.yaml）

為確保錄音對講與 AI 互動具備工業級可靠度，底層音訊鏈路採用 Python 寫入二進制資料破除 256KB 傳輸瓶頸，並在發話流程中動態注入環境時空參數（時間、星期、天氣與感測器狀態），讓 Dify 管家開口即具備在地環境意識：

# 語音前綴淨化與動態時空提示詞封裝
cleaned_text: "{{ target_text | regex_replace('^(?:(?:ok|okay|嘿|嗨|喂|請教一下|幫我)?\\s*小管家[，,\\s]*)', '', ignorecase=True) }}"
enriched_prompt: >-
  [系統環境資訊：當前時間是 {{ current_time }} {{ current_weekday }}；住家天氣狀況為：{{ weather_state }}]
  使用者發問：{{ final_prompt }}

# 調用 Edge-TTS 高音質繁中發音實體
action: tts.speak
target:
  entity_id: tts.edge_tts_service
data:
  media_player_entity_id: "{{ target_player }}"
  message: "{{ ai_answer }}"

📊 整合效益量化對比

指標維度	舊架構 (Google AI TTS)	新架構 (Microsoft Edge-TTS 曉臻)
每日請求上限	嚴格限制 10 次 (易觸發 429)	無限制 (完全免費自由調用)
發音與腔調表現	自然度高但 Assist 介面語系鎖定	標準台灣腔女性語音，中英混讀極其滑順
宿主算力佔用	0% (雲端生成)	0% (邊緣網路串流回傳，免本機推理)
首字發聲延遲	約 1.2s - 2.0s	約 0.4s - 0.7s (極致低延遲)

至此，全屋智慧語音對話系統已在 Home Assistant 2026.10 規範下達成高擬真度、零成本與高強健性的生產基線。下一步將銜接公視（PTS）與中央社（CNA）在地 RSS 新聞串流，進一步擴展長輩日常一鍵隨聽之管家生態！🚀

2026-10-07T10:29:44.158+08:00

以下為微雪（Waveshare）ESP32-S3 系列智慧中控、顯示模組與音訊/紅外線擴充週邊預購與入手清單（含參考價格範圍與採購管道）：

名稱 / 型號	尺寸 / 規格	功能簡介	參考價格	入手方式 / 連結
ESP32-S3-Touch-LCD-7B 7吋電容觸控螢幕開發板	7 吋 1024×600	雙核處理器（Wi-Fi/BLE 5）、16M Flash / 8M PSRAM、板載 CAN、RS485、I2C、SD卡槽，支援 LVGL 工控 HMI。	NT$ 1,200 - 1,600 (¥ 260 - 350)	官方文檔 / 微雪官網
ESP32-S3-Touch-LCD-4.3C 4.3吋智慧語音觸控屏	4.3 吋 800×480	內建雙數位麥克風陣列（AI 語音互動），支援 Wi-Fi/BLE 5，適合作為智慧家居與家電控制中樞。	NT$ 800 - 1,100 (¥ 180 - 240)	官方文檔 / 微雪官網
ESP32-S3-CAM-OVxxxx AI 攝影機/觸控開發套件	多媒體組	支援 Wi-Fi/BLE 5、DVP 鏡頭介面（搭配 OV3660/OV5640）、雙數位麥克風陣列（語音識別/降噪）、音訊解碼、SD卡槽。	NT$ 600 - 900 (¥ 130 - 200)	官方文檔 / 微雪官網
ESP32-S3-ePaper-3.97 3.97吋電子紙開發板	3.97 吋 800×480	內建 ESP32-S3 主控（Wi-Fi/BLE 5）、整合電子紙顯示驅動，超低功耗，適合智慧家居控制與低功耗物聯網應用。	NT$ 1,000 - 1,300 (¥ 220 - 280)	官方文檔 / 微雪官網
INMP441 / MSM261S4030H0 I2S 數位麥克風模組	音訊輸入高精度拾音	高精確度 I2S 介面數位 MEMS 麥克風，支援語音辨識、語音助理（如 ESP-NOW / Home Assistant Assist）收音。	NT$ 60 - 150 (¥ 15 - 35)	蝦皮購物、淘寶、露天市集（搜尋型號直接選購）
MAX98357A I2S D級音訊放大輸出模組	音訊輸出 3W 功率放大	高效能 D 級數位音訊放大器，直接接收 I2S 音訊輸入驅動外接喇叭，適合搭配 ESP32 實現語音播報或 TTS 語音回饋。	NT$ 80 - 180 (¥ 20 - 40)	蝦皮購物、淘寶、露天市集（搜尋型號直接選購）
360度紅外線發射模組全向萬能紅外擴充套件	紅外控制 38kHz 全向	環形多燈珠設計，可透過 GPIO 連接至 ESP32-S3 主板，搭配 ESPHome 打造場區/房間萬能紅外遙控。	NT$ 100 - 250 (¥ 25 - 55)	蝦皮購物、淘寶（搜尋「360度紅外發射模組」）

Home Assistant「原聲廣播與 AI 對話」

2026-10-07T08:38:18.982+08:00

[標準工程架構] Home Assistant 原音廣播與 AI 對話：官方多 ID 動態陣列與全生態跨協議同步

本架構為 Home Assistant 智慧家居系統中，多房間真人原音廣播（Intercom）與 Google Assistant SDK 繁體中文 AI 雙向語音互動的完整工程實踐。歷經實機全面驗證，徹底解決了「Linux Shell Argument list too long 參數超限」、「多設備輪詢引發 Google 雲端 Session 競態與 N-1 歷史快取覆蓋」，以及「跨設備生態（Google Cast、Sony XZ1 Squeezebox、AirPlay 等）無法同步發聲與語音控制設備」的三大痛點。全新安裝之 Home Assistant 系統可直接導入套用。

核心架構突破與工程原則

官方標準多 ID 動態陣列一次性派發：廢除傳統引發競態的 repeat 串列迴圈，將前端動態勾選的所有實體直接以陣列傳遞至 google_assistant_sdk.send_text_command。Google 雲端僅生成單次最新（第 N 次）回答，由 HA 底層中樞並行廣播至各端點，徹底杜絕 N-1 殘留。
4KB 安全分段通道（Chunk-based Upload）：前端 PCM-to-WAV 編碼後，以每包 4,000 字元分段追加寫入 voice.b64，根除 Linux 底層命令列的 E2BIG 限制。
AudioContext 垃圾回收防護（GC Guard）：前端錄音節點常駐全域（window._activeIntercomRecorderNode），確保 450ms 系統準備期錄音採樣不被瀏覽器釋放。
支援語音直接控制智慧家庭：直接透過 SDK 直通 Google Home 雲端，支援開關電燈、冷氣調節、情境觸發與狀態查詢，並同步語音回覆給所有端點。

步驟一：後端核心配置 (/config/packages/intercom.yaml)

在 Home Assistant 建立 packages 設定檔，提供分段寫入 Shell 指令、真人廣播與 AI 對話主腳本：

# ==============================================================================
# Home Assistant 獨立音訊對講與 AI 語音 Package (packages/intercom.yaml)
# 遵循【HA 官方原生多設備列表與 Google Assistant SDK 規範 - 方案 B 滿意版】
# ==============================================================================

shell_command:
  clear_intercom_raw: "mkdir -p /config/www/intercom && rm -f /config/www/intercom/voice.b64 /config/www/intercom/voice.wav"
  save_intercom_chunk: "python3 -c 'import sys; f=open(\"/config/www/intercom/voice.b64\", \"a\"); f.write(\"{{ chunk }}\"); f.close()'"
  decode_intercom_raw: "python3 -c 'import base64; data=open(\"/config/www/intercom/voice.b64\", \"rb\").read(); open(\"/config/www/intercom/voice.wav\", \"wb\").write(base64.b64decode(data))'"

input_boolean:
  ai_conversation_mode:
    name: "AI 語音對話模式"
    icon: mdi:robot
  ai_voice_recording:
    name: "語音廣播發話中"
    icon: mdi:microphone-message

script:
  # ----------------------------------------------------------------------------
  # 廣播模式：真人錄音推播 (標準 Port 80 反向代理，支援多設備一次性發送)
  # ----------------------------------------------------------------------------
  intercom_play_voice:
    alias: "真人錄音對講廣播處理"
    mode: restart
    fields:
      target_player:
        description: "目標廣播播放器清單 (字串或陣列)"
    sequence:
      - action: input_boolean.turn_on
        target:
          entity_id: input_boolean.ai_voice_recording
        continue_on_error: true

      - action: media_player.play_media
        target:
          entity_id: >-
            {{ [target_player] if target_player is string else target_player }}
        data:
          media_content_id: "http://192.168.1.187/local/intercom/voice.wav?t={{ as_timestamp(now()) }}"
          media_content_type: "music"

      - delay:
          seconds: 3

      - action: input_boolean.turn_off
        target:
          entity_id: input_boolean.ai_voice_recording
        continue_on_error: true

  # ----------------------------------------------------------------------------
  # AI 模式：方案 B 官方標準多 ID 原生陣列派發 (全動態、單次請求、根除 N-1 衝突)
  # ----------------------------------------------------------------------------
  intercom_ai_talk:
    alias: "AI 對話語音處理 (原生 Google Assistant SDK)"
    mode: restart
    fields:
      target_player:
        description: "目標播放實體清單或單一實體"
      prompt_text:
        description: "真實語音辨識文字"
    sequence:
      - action: input_boolean.turn_on
        target:
          entity_id: input_boolean.ai_voice_recording
        continue_on_error: true

      # 方案 B 核心：動態陣列直送 SDK，向 Google 雲端僅索取 1 次回應並分派各端點
      - action: google_assistant_sdk.send_text_command
        data:
          command: "{{ prompt_text }}"
          media_player: >-
            {{ [target_player] if target_player is string else target_player }}

      - delay:
          seconds: 5

      - action: input_boolean.turn_off
        target:
          entity_id: input_boolean.ai_voice_recording
        continue_on_error: true

  # ----------------------------------------------------------------------------
  # 快捷相容別名：Gemini 直連 Alias
  # ----------------------------------------------------------------------------
  gemini:
    alias: "AI 對話發話處理 (Gemini 直連 Alias)"
    mode: restart
    fields:
      target_player:
        description: "目標播放實體清單或單一實體"
      prompt_text:
        description: "語音發話文字"
    sequence:
      - action: script.intercom_ai_talk
        data:
          target_player: "{{ target_player }}"
          prompt_text: "{{ prompt_text }}"

步驟二：前端自訂卡片全碼 (/config/www/intercom/intercom-card.js)

前端負責自動掃描在線播放設備、提供多選切換、PCM 原生音訊採樣與 Web Speech API 辨識：

/**
 * Home Assistant - Universal Intercom & AI Broadcast Card (custom:intercom-card)
 * 遵循【HA 音訊排查復原點 4：Tiny Room 原生 Sections 整合、全動態端點與零 TTS 封存 - 方案 B 滿意版】
 */

class IntercomCard extends HTMLElement {
  constructor() {
    super();
    this._isAi = false;
    this.audioCtx = null;
    this.micStream = null;
    this.processor = null;
    this.pcmData = [];
    this.isRecording = false;
    this.localHolding = false;
    this.prepTimer = null;
    this.prepCount = 0;
    this.savedCheckedEntities = new Set();
    this.renderedSignature = '';
    this.recognizedSpeechText = '';
    this.recognition = null;
  }

  static getStubConfig() {
    return {};
  }

  setConfig(config) {
    if (Array.isArray(config)) {
      config = config[0] || {};
    }
    this._config = config || {};
  }

  getLayoutOptions() {
    return {
      grid_columns: 4,
      grid_min_columns: 2,
      grid_rows: 2
    };
  }

  set hass(hass) {
    this._hass = hass;
    if (!this.content) {
      this.initCard();
    }
    this.updateCardState();
    this.renderDynamicPlayers();
  }

  initCard() {
    this.innerHTML = `
      <ha-card style="padding: 10px 14px; background: #1c222b; border: 1px solid #283242; border-radius: 12px; color: #fff; box-sizing: border-box; display: flex; flex-direction: column;">
        <!-- 動態在線播放設備列表 (預設全部不勾選) -->
        <div id="player-container" style="display: flex; flex-wrap: wrap; gap: 6px; margin-bottom: 10px;"></div>

        <!-- 控制列：左側 [廣播/AI開關] + 右側 [長按語音對講按鍵] -->
        <div style="display: flex; align-items: center; gap: 10px;">
          <!-- 雙模切換膠囊 -->
          <div id="switch-box" style="display: inline-flex; align-items: center; gap: 6px; background: #181d24; border: 1px solid #2e384d; padding: 6px 12px; border-radius: 8px; flex-shrink: 0; cursor: pointer; user-select: none;">
            <span id="label-broadcast" style="font-size: 14px; font-weight: bold; color: #03a9f4; transition: color 0.2s;">廣播</span>
            <ha-switch id="ai-toggle"></ha-switch>
            <span id="label-ai" style="font-size: 14px; font-weight: bold; color: #64748b; transition: color 0.2s;">AI</span>
          </div>

          <!-- 主發話按鈕 (純色藍 #3b82f6) -->
          <button id="main-action-btn" style="flex: 1 1 140px; min-width: 140px; white-space: nowrap; height: 46px; background: #3b82f6; border: none; border-radius: 8px; color: #fff; font-weight: bold; font-size: 16px; cursor: pointer; user-select: none; -webkit-user-select: none; touch-action: none; display: flex; align-items: center; justify-content: center; gap: 8px; position: relative; overflow: hidden; box-sizing: border-box; transition: all 0.25s ease;">
            <ha-icon id="btn-icon" icon="mdi:microphone" style="color: #ffffff; --mdc-icon-size: 22px;"></ha-icon>
            <span id="btn-label" style="letter-spacing: 0.5px;">長按語音對講</span>
          </button>
        </div>
      </ha-card>
    `;

    this.content = true;
    this.mainBtn = this.querySelector('#main-action-btn');
    this.btnIcon = this.querySelector('#btn-icon');
    this.btnLabel = this.querySelector('#btn-label');
    this.aiToggle = this.querySelector('#ai-toggle');
    this.labelBroadcast = this.querySelector('#label-broadcast');
    this.labelAi = this.querySelector('#label-ai');
    this.playerContainer = this.querySelector('#player-container');

    // 雙模切換點選聯動
    const switchBox = this.querySelector('#switch-box');
    switchBox.addEventListener('click', (e) => {
      if (e.target !== this.aiToggle) {
        this.aiToggle.checked = !this.aiToggle.checked;
        this.aiToggle.dispatchEvent(new Event('change'));
      }
    });

    this.aiToggle.addEventListener('change', (e) => {
      this._isAi = e.target.checked;
      this.updateCardState();
      if (this._hass && this._hass.states && this._hass.states['input_boolean.ai_conversation_mode']) {
        this._hass.callService('input_boolean', this._isAi ? 'turn_on' : 'turn_off', {
          entity_id: 'input_boolean.ai_conversation_mode'
        });
      }
    });

    // 450ms 判定閾值 (5 步每步 90ms 橘色進度條)
    const prepChars = ['系', '系統', '系統準', '系統準備', '系統準備中'];

    const onStart = async (e) => {
      if (e.cancelable) e.preventDefault();
      const targets = this.getSelectedPlayers();
      if (targets.length === 0) {
        this.btnLabel.innerText = '⚠️ 請先勾選設備！';
        this.mainBtn.style.background = '#e65100';
        setTimeout(() => this.updateCardState(), 1200);
        return;
      }

      this.localHolding = true;
      this.isRecording = false;
      this.prepCount = 0;
      this.recognizedSpeechText = '';

      this.btnLabel.innerText = prepChars[0];
      this.mainBtn.style.background = 'linear-gradient(90deg, #ff9800 20%, #1e293b 20%)';

      // 只有廣播模式才預啟動硬體麥克風
      if (!this._isAi) {
        await this.initMicHardware();
      }

      this.prepTimer = setInterval(() => {
        this.prepCount++;
        if (this.prepCount < 5) {
          this.btnLabel.innerText = prepChars[this.prepCount];
          const pct = (this.prepCount + 1) * 20;
          this.mainBtn.style.background = `linear-gradient(90deg, #ff9800 ${pct}%, #1e293b ${pct}%)`;
        } else if (this.prepCount === 5) {
          clearInterval(this.prepTimer);
          this.prepTimer = null;
          this.isRecording = true;
          this.pcmData = []; // 清空預熱雜訊

          this.mainBtn.style.background = this._isAi ? '#15803d' : '#dc2626';
          this.btnIcon.setAttribute('icon', 'mdi:record-rec');
          this.btnLabel.innerText = '錄音中';

          // AI 模式：每次長按全新啟動獨立 SpeechRecognition 實例
          if (this._isAi) {
            this.startSpeechRecognition();
          }
        }
      }, 90);
    };

    const onEnd = async (e) => {
      if (e.cancelable) e.preventDefault();
      if (!this.localHolding) return;
      this.localHolding = false;

      // 未滿 450ms 放開：立即取消
      if (this.prepTimer) {
        clearInterval(this.prepTimer);
        this.prepTimer = null;
        if (!this._isAi) this.closeMicHardware();
        this.stopSpeechRecognition();
        this.updateCardState();
        return;
      }

      // 滿 450ms：放開按鈕微緩衝 300ms 讓辨識引擎結算最後文字後立刻送出
      if (this.isRecording) {
        this.btnLabel.innerText = '發送中...';
        await new Promise(r => setTimeout(r, 300));
        this.isRecording = false;
        await this.finishRecordingAndSend();
      }
    };

    this.mainBtn.addEventListener('pointerdown', onStart);
    this.mainBtn.addEventListener('pointerup', onEnd);
    this.mainBtn.addEventListener('pointercancel', onEnd);
  }

  // 每次全新實例化 Web Speech API
  startSpeechRecognition() {
    const SpeechRec = window.SpeechRecognition || window.webkitSpeechRecognition;
    if (!SpeechRec) {
      console.warn('[Intercom] 瀏覽器環境不支援 Web Speech API');
      return;
    }
    try {
      this.stopSpeechRecognition();
      this.recognition = new SpeechRec();
      this.recognition.lang = 'zh-TW';
      this.recognition.continuous = true;
      this.recognition.interimResults = true;
      this.recognition.maxAlternatives = 1;

      this.recognition.onresult = (e) => {
        let txt = '';
        for (let i = e.resultIndex; i < e.results.length; ++i) {
          txt += e.results[i][0].transcript;
        }
        if (txt.trim()) {
          this.recognizedSpeechText = txt.trim();
          if (this.btnLabel) {
            this.btnLabel.innerText = this.recognizedSpeechText;
          }
        }
      };

      this.recognition.onerror = (e) => {
        console.warn('[Intercom] 語音辨識事件:', e.error);
      };

      this.recognition.start();
    } catch (err) {
      console.warn('[Intercom] 啟動語音辨識異常:', err);
    }
  }

  stopSpeechRecognition() {
    if (this.recognition) {
      try { this.recognition.stop(); } catch (e) {}
      this.recognition = null;
    }
  }

  // 廣播模式：硬體原生音訊採樣
  async initMicHardware() {
    try {
      this.micStream = await navigator.mediaDevices.getUserMedia({
        audio: {
          channelCount: 1,
          echoCancellation: true,
          noiseSuppression: true,
          autoGainControl: true
        },
        video: false
      });

      const AudioCtx = window.AudioContext || window.webkitAudioContext;
      this.audioCtx = new AudioCtx();
      if (this.audioCtx.state === 'suspended') {
        await this.audioCtx.resume();
      }

      const source = this.audioCtx.createMediaStreamSource(this.micStream);
      this.pcmData = [];
      this.processor = this.audioCtx.createScriptProcessor(4096, 1, 1);

      // 核心防護：綁定全域避免在 450ms 準備期被 GC 回收
      window._activeIntercomRecorderNode = this.processor;

      this.processor.onaudioprocess = (e) => {
        if (!this.isRecording) return;
        const channel = e.inputBuffer.getChannelData(0);
        this.pcmData.push(new Float32Array(channel));
      };

      source.connect(this.processor);
      this.processor.connect(this.audioCtx.destination);
    } catch(err) {
      console.error('[Intercom] 麥克風啟動異常:', err);
    }
  }

  closeMicHardware() {
    window._activeIntercomRecorderNode = null;
    if (this.processor) { try { this.processor.disconnect(); } catch(e) {} this.processor = null; }
    if (this.micStream) { try { this.micStream.getTracks().forEach(t => t.stop()); } catch(e) {} this.micStream = null; }
    if (this.audioCtx) { try { this.audioCtx.close(); } catch(e) {} this.audioCtx = null; }
  }

  async finishRecordingAndSend() {
    const targets = this.getSelectedPlayers();

    try {
      if (this._isAi) {
        this.stopSpeechRecognition();
        const q = this.recognizedSpeechText.trim();
        if (!q) {
          console.warn('[Intercom] AI 模式未錄得有效文字，取消發送');
          if (this.btnLabel) this.btnLabel.innerText = '⚠️ 未識別到語音';
          if (this.mainBtn) this.mainBtn.style.background = '#e65100';
          setTimeout(() => this.updateCardState(), 1500);
          return;
        }

        console.log('[Intercom] AI 模式：發送真實識別文字:', q, '動態目標端點清單:', targets);
        this.btnLabel.innerText = 'AI 回應中...';
        await this._hass.callService('script', 'intercom_ai_talk', {
          prompt_text: q,
          target_player: targets
        });
      } else {
        // 廣播模式：抓取設備真實取樣率 (44100Hz / 48000Hz)
        const realSampleRate = (this.audioCtx && this.audioCtx.sampleRate) ? this.audioCtx.sampleRate : 44100;
        const wavBlob = this.encodeWAV(this.pcmData, realSampleRate);
        this.closeMicHardware();

        if (!wavBlob || wavBlob.size < 1000) {
          console.warn('[Intercom] 錄音數據為空，取消廣播');
          if (this.btnLabel) this.btnLabel.innerText = '⚠️ 錄音為空';
          setTimeout(() => this.updateCardState(), 1200);
          return;
        }

        console.log(`[Intercom] 成功錄得原音: ${wavBlob.size} bytes, 取樣率: ${realSampleRate}Hz`);
        await this.uploadAndPlay(wavBlob, targets);
      }
    } catch(err) {
      console.error('[Intercom] 派發異常:', err);
    } finally {
      this.updateCardState();
    }
  }

  // 安全分段通道 (每包 4KB 寫入，保證 voice.wav 100% 寫出)
  async uploadAndPlay(wavBlob, targets) {
    return new Promise((resolve) => {
      const reader = new FileReader();
      reader.readAsDataURL(wavBlob);
      reader.onloadend = async () => {
        try {
          const b64 = reader.result.split(',')[1];
          if (!b64) { resolve(); return; }

          console.log(`[Intercom] 開始寫入音訊，Base64 總長度: ${b64.length}`);

          // 1. 先清空並初始化暫存檔
          await this._hass.callService('shell_command', 'clear_intercom_raw');

          // 2. 每包 4000 字元分段寫入，徹底避免 Argument list too long
          const chunkSize = 4000;
          for (let i = 0; i < b64.length; i += chunkSize) {
            const chunk = b64.slice(i, i + chunkSize);
            await this._hass.callService('shell_command', 'save_intercom_chunk', {
              chunk: chunk
            });
          }

          // 3. 呼叫解碼產生 voice.wav
          await this._hass.callService('shell_command', 'decode_intercom_raw');

          // 4. 等待 200ms 讓磁碟寫入完成
          await new Promise(r => setTimeout(r, 200));

          console.log('[Intercom] voice.wav 產出完成，呼叫 script.intercom_play_voice 推播給:', targets);
          await this._hass.callService('script', 'intercom_play_voice', {
            target_player: targets
          });
        } catch(e) {
          console.error('[Intercom] 上傳播放失敗:', e);
        }
        resolve();
      };
      reader.onerror = () => resolve();
    });
  }

  getSelectedPlayers() {
    return Array.from(this.querySelectorAll('.player-chk:checked')).map(i => i.value);
  }

  renderDynamicPlayers() {
    if (!this.playerContainer || !this._hass || !this._hass.states) return;

    this.querySelectorAll('.player-chk').forEach(input => {
      if (input.checked) this.savedCheckedEntities.add(input.value);
      else this.savedCheckedEntities.delete(input.value);
    });

    const candidateEntities = Object.keys(this._hass.states).filter(entityId => {
      if (!entityId.startsWith('media_player.')) return false;
      const s = this._hass.states[entityId];
      return s && !['unavailable', 'unknown', 'off'].includes(s.state);
    });

    const deduplicated = new Map();
    candidateEntities.forEach(id => {
      const s = this._hass.states[id];
      const name = (s && s.attributes && s.attributes.friendly_name) || id.replace('media_player.', '');
      if (!deduplicated.has(name) || id > deduplicated.get(name).id) {
        deduplicated.set(name, { id, name });
      }
    });

    const playerList = Array.from(deduplicated.values());
    const signature = playerList.map(p => p.id).sort().join(',');

    if (this.renderedSignature !== signature) {
      this.renderedSignature = signature;
      this.playerContainer.innerHTML = playerList.map(p => {
        const checked = this.savedCheckedEntities.has(p.id) ? 'checked' : '';
        return `
          <label style="display: inline-flex; align-items: center; gap: 6px; padding: 4px 10px; background: #262e3d; border: 1px solid #3b465c; border-radius: 6px; cursor: pointer; font-size: 13px; color: #e2e8f0; user-select: none; transition: all 0.2s;">
            <input type="checkbox" class="player-chk" value="${p.id}" ${checked} style="accent-color: #03a9f4; width: 16px; height: 16px; margin: 0; cursor: pointer;">
            <span>${p.name}</span>
          </label>
        `;
      }).join('');
    }
  }

  updateCardState() {
    if (!this.content) return;
    this.aiToggle.checked = this._isAi;

    if (this.localHolding) return;

    if (this._isAi) {
      this.labelBroadcast.style.color = '#64748b';
      this.labelAi.style.color = '#38bdf8';
      this.mainBtn.style.background = '#0284c7';
      this.btnIcon.setAttribute('icon', 'mdi:robot');
      this.btnLabel.innerText = '長按 AI 對話';
    } else {
      this.labelBroadcast.style.color = '#03a9f4';
      this.labelAi.style.color = '#64748b';
      this.mainBtn.style.background = '#3b82f6';
      this.btnIcon.setAttribute('icon', 'mdi:microphone');
      this.btnLabel.innerText = '長按語音對講';
    }
  }

  encodeWAV(samplesArrays, sampleRate) {
    let total = 0;
    for (const a of samplesArrays) total += a.length;
    if (total === 0) return null;
    const samples = new Float32Array(total);
    let offset = 0;
    for (const a of samplesArrays) { samples.set(a, offset); offset += a.length; }

    const buffer = new ArrayBuffer(44 + samples.length * 2);
    const view = new DataView(buffer);
    const writeStr = (v, o, s) => { for (let i = 0; i < s.length; i++) v.setUint8(o + i, s.charCodeAt(i)); };

    writeStr(view, 0, 'RIFF');
    view.setUint32(4, 36 + samples.length * 2, true);
    writeStr(view, 8, 'WAVE');
    writeStr(view, 12, 'fmt ');
    view.setUint32(16, 16, true);
    view.setUint16(20, 1, true); // PCM 格式
    view.setUint16(22, 1, true); // 單聲道
    view.setUint32(24, sampleRate, true); // 動態真實取樣率
    view.setUint32(28, sampleRate * 2, true); // Byte rate
    view.setUint16(32, 2, true); // Block align
    view.setUint16(34, 16, true); // 16-bit
    writeStr(view, 36, 'data');
    view.setUint32(40, samples.length * 2, true);

    let idx = 44;
    for (let i = 0; i < samples.length; i++) {
      let s = Math.max(-1, Math.min(1, samples[i]));
      view.setInt16(idx, s < 0 ? s * 0x8000 : s * 0x7FFF, true);
      idx += 2;
    }
    return new Blob([view], { type: 'audio/wav' });
  }
}

customElements.define('intercom-card', IntercomCard);

window.customCards = window.customCards || [];
window.customCards.push({
  type: 'intercom-card',
  name: 'Intercom Card',
  description: 'Universal Intercom & AI Broadcast Card',
  preview: true
});

步驟三：儀表板卡片宣告

在前端儀表板資源中引入 /local/intercom/intercom-card.js（模組類型）後，卡片可直接加入任意視圖：

type: custom:intercom-card

參考文獻 (References)

Home Assistant Core Architecture & Shell Command Integration. Home Assistant Official Documentation (2026). Executing asynchronous payload ingestion and avoiding E2BIG system limits.
Google Assistant SDK Integration for Home Assistant. Home Assistant Core Components (2026). Text-in / Multi-endpoint media_player array dispatching and conversational state handling.
W3C Audio Working Group. Web Audio API Specifications (W3C Recommendation, 2021). ScriptProcessorNode memory retention and dynamic client-side sample rate synthesis.
W3C Speech API Community Group. Web Speech API Specification (Draft Report, 2023). SpeechRecognition continuous stream tokenization and localized acoustic processing.
SqueezeLite & SlimProto Architecture. Community Squeeze Open Documentation (2025). Low-latency multi-room raw PCM streaming and dynamic endpoint synchronization.

2026-10-07T08:37:48.430+08:00

使用 ESP32-S3 (16MB Flash / 8MB PSRAM, 16R8) 打造隨身 Google / AI 語音終端並同時控制 Home Assistant，最佳的官方且免維護解法是透過 ESPHome 原生 Voice Assistant 管線，搭配 HA 已經架設好的 Google Assistant SDK 與 Assist 語音引擎。

8MB Octal PSRAM 能在本地提供充足的音訊雙向環形緩衝區，支援低延遲音訊串流與回音消除。

一、核心硬體搭配建議

隨身終端需具備雙向音訊功能：

核心晶片：ESP32-S3-WROOM-1 (16R8)
麥克風輸入：INMP441 或 MSM261S4030H0（I2S 數位麥克風）
音訊放大輸出：MAX98357A（I2S DAC 功放，接小喇叭）
實體按鍵：任一 GPIO（長按對講，類似對講機模式）或啟用 ESP-SR 本地喚醒詞（如「Okay Nabu」）

二、系統架構流向（雙重路由架構）

ESP32 不需要自行跑龐大的 AI 模型，而是將音訊串流直送 Home Assistant 擔任中央中樞：

Plaintext

[ESP32 麥克風] 
       │ (I2S 音訊串流 via WiFi)
       ▼
[Home Assistant Assist 語音管線] 
       │
       ├─►「開關客廳燈 / 查詢狀態」 ──► [HA 本地實體控制]
       │
       └─►「問天氣 / 知識 / 複雜問題」 ──► [Google Assistant SDK / Gemini] 
                                                  │
                                                  ▼ (合成音訊回傳)
                                           [ESP32 MAX98357A 喇叭發聲]

三、 ESPHome 固件配置 (以 ESP32-S3 16R8 為基準)

在 ESPHome 中為你的 ESP32-S3 建立如下配置，充分調用 8MB PSRAM 與 I2S 音訊通道：

YAML
esphome:
  name: esp32-voice-terminal
  friendly_name: "隨身語音對講終端"

esp32:
  board: esp32-s3-devkitc-1
  variant: esp32s3
  framework:
    type: esp-idf

# 啟用 16R8 的 Octal PSRAM (提供大音訊緩衝區，杜絕爆音中斷)
psram:
  mode: octal
  speed: 80MHz

# I2S 雙向音訊匯流排
i2s_audio:
  - id: i2s_mic
    i2s_lrclk_pin: GPIO4
    i2s_bclk_pin: GPIO5
  - id: i2s_speaker
    i2s_lrclk_pin: GPIO6
    i2s_bclk_pin: GPIO7

# 麥克風 (INMP441)
microphone:
  - platform: i2s_audio
    id: terminal_mic
    i2s_audio_id: i2s_mic
    i2s_din_pin: GPIO15
    adc_type: external
    pdm: false

# 喇叭輸出 (MAX98357A)
speaker:
  - platform: i2s_audio
    id: terminal_speaker
    i2s_audio_id: i2s_speaker
    i2s_dout_pin: GPIO16
    dac_type: external
    mode: mono

# Home Assistant 原生語音管線對接
voice_assistant:
  microphone: terminal_mic
  speaker: terminal_speaker
  # 實體長按發話按鍵，放開即發送
  trigger_pin:
    number: GPIO0
    inverted: true
    mode:
      input: true
      pullup: true

# 註冊為 HA 的 media_player (讓 HA 的其他自動化或廣播也能推播到此隨身機)
media_player:
  - platform: speaker
    name: "隨身語音終端喇叭"
    speaker: terminal_speaker

四、 Home Assistant 後端無縫銜接（同時控制設備與問 Google）

當 ESP32 燒錄完成並連上 HA 後，它會被自動識別為一個原生 Voice Assistant 與 Media Player：

控制 HA 設備：
- 前往 HA 「設定」 -> 「語音助手（Voice Assistants）」。
- 將語音管線設定為 Home Assistant 預設引擎。
- 按下按鍵說「打開車庫燈」、「玄關冷氣設為 26 度」，HA 意圖引擎會直接執行指令。
問 Google / AI 對話：
- 在「語音助手」管線中，將「對話代理（Conversation agent）」指定為：
  - Google Generative AI (Gemini)：處理百科問答、閒聊與邏輯推理。
  - 或使用先前提到的 Google Assistant SDK 作為 fallback。
- 當發問超出純開關控制的句子（如「今天台北天氣如何？」、「蕃茄炒蛋怎麼做？」），HA 會自動將問題轉給 AI，將回答音訊直接串流回 ESP32 的喇叭播放出來。

雜項-AI應用 Windows 11 系統殘留清理

2026-09-18T12:51:30.170+08:00

🛠️ Windows 11 系統殘留清理與映像修復實戰指引

涵蓋無效驅動卸載、登錄檔孤兒項清理、DISM / SFC 修復與 PSModulePath 環境變數固化

在 Windows 11 長期使用或頻繁安裝/解除安裝大型軟體後，常在系統底層留下殘留驅動、失效的註冊表項、孤兒服務以及映像檔校驗異常。本篇整理一套標準、安全的逐項排查與修復流程，優先保護微軟與硬體晶片組核心 Runtime，精確清除純第三方殘留。

一、第三方儲存與介面卡驅動排查（DriverStore）

Windows 內建的隨附驅動（如 3ware.inf、arcsas.inf、iastorv.inf 等原生 Inbox 驅動）受 WRP 保護且無對應硬體時不耗用資源，無須也不可手動強制刪除。排查重點應放在由第三方軟體匯入的 oem*.inf 套件。

      # 提升權限

      Get-WindowsDriver -Online -All | Where-Object { $_.ClassName -eq 'SCSIAdapter' -and $_.Driver -like 'oem*.inf' -and $_.ProviderName -notmatch 'AMD' } | Select-Object Driver, ProviderName, ClassName, Date, Version | Format-Table -AutoSize

檢核方式：若輸出為空，代表驅動存放庫無多餘第三方陣列/儲存驅動；若有殘留項目，記錄其 Driver 編號（例 oemXX.inf）後執行 pnputil /delete-driver oemXX.inf /force 卸載。

二、背景服務檔案有效性排查（Win32_Service）

部分軟體解除安裝時未能正確註銷其 Windows Service，導致註冊表常駐但實體執行檔（.exe / .sys）已遺失。利用 WMI/CIM 檢查所有服務路徑的實體存在性：

      # 提升權限

      Get-CimInstance Win32_Service | Where-Object { $_.PathName -and -not (Test-Path ($_.PathName -replace '^\s*"([^"]+)".*','$1' -replace '^(.*?)\s+[/|-].*$','$1').Trim()) } | Select-Object Name, DisplayName, State, StartMode, PathName | Format-Table -AutoSize

檢核方式：回傳空白代表全數服務檔案健全。若有遺失檔案的孤兒服務，可依序執行 Stop-Service -Name "服務名" -Force 與 sc.exe delete "服務名" 進行完全註銷。

三、開機自啟動無效登錄項稽核（Run 鍵值）

稽核全域（HKLM）、32位元相容區（WOW6432Node）與目前使用者（HKCU）下的啟動項，比對實體檔案是否仍存在。此處採純文字輸出，避免相依模組異常引發報錯：

      # 提升權限

      "HKLM:\Software\Microsoft\Windows\CurrentVersion\Run", "HKLM:\Software\WOW6432Node\Microsoft\Windows\CurrentVersion\Run", "HKCU:\Software\Microsoft\Windows\CurrentVersion\Run" | ForEach-Object { $k = $_; if (Test-Path $k) { (Get-Item $k).GetValueNames() | ForEach-Object { $val = (Get-ItemProperty -Path $k -Name $_).$_; if ($val) { $raw = ($val -replace '^\s*"([^"]+)".*','$1' -replace '^(.*?)\s+[/|-].*$','$1').Trim(); if (-not (Test-Path $raw)) { Write-Output "[無效自啟動] 名稱: $_ | 路徑: $val | 登錄區: $k" } } } } }

檢核方式：指令執行後直接換行且未輸出任何 [無效自啟動]，即確認開機常駐無任何失效殘留。

四、底層映像庫快取清理與修復（DISM / SFC）

針對 Windows 元件存放庫（WinSxS）進行舊版更新快取整合，並校驗核心系統映像：

1. 清理舊版更新與驅動備份（釋放磁碟空間）

      # 提升權限

      dism.exe /online /cleanup-image /startcomponentcleanup /resetbase

2. 檢查與線上修復映像檔

      # 提升權限

      dism.exe /online /cleanup-image /checkhealth

      dism.exe /online /cleanup-image /restorehealth

檢核方式：若 checkhealth 提示「元件存放區是可修復的」，執行 restorehealth 完成後再次檢測應轉為「未偵測到元件存放區損毀」。

3. 本機系統檔案完整性檢查（SFC）

      # 提升權限

      sfc /scannow

檢核方式：日誌若出現「Repair complete」，可過濾 CBS.log 確認具體變更。若日誌記載 Repairing 0 components，代表僅為交易狀態校對，未有實體執行檔受損。

五、 PowerShell 模組路徑環境變數修復（PSModulePath）

若開啟 PowerShell 時原生 Cmdlet（如 Format-Table、Select-String）頻繁報錯 CouldNotAutoloadMatchingModule，常見原因為第三方安裝程式覆蓋了全域環境變數，或 %SystemRoot% 動態變數未能正確展開。可直接將展開後的官方實體路徑寫入系統層級變數：

      # 提升權限

      [Environment]::SetEnvironmentVariable("PSModulePath", "C:\Program Files\WindowsPowerShell\Modules;C:\Windows\system32\WindowsPowerShell\v1.0\Modules", "Machine")

檢核方式：在 Windows Terminal 新增分頁或重新啟動 PowerShell，輸入 Get-Command Format-Table 能正確輸出 Cmdlet Format-Table Microsoft.PowerShell.Utility 且無紅字報錯。

雜項-AI應用開源DNS

2026-09-17T20:33:16.381+08:00

🌐 公共 DNS 解析：主流與進階 DNS 特性全拆解

選擇公共 DNS 伺服器時，除了網路實體延遲（Ping）外，核心差異主要在於「解析策略」、「威脅與內容過濾」以及「資安情報庫」。以下收錄 1.1.1.1 系列、9.9.9.9 以及其他值得採用的主流公共 DNS 進行深度拆解與橫向對比。

⚡ 1.1.1.1：極致低延遲與純隱私取向

🚀 核心定位：極限提升網頁載入速度與連線反應時間。
🛡️ 過濾機制：❌ 無過濾。採完全放行原則，不論域名是否具有威脅性，皆忠實回傳原始 IP。
🔒 隱私保護：由 Cloudflare 與 APNIC 合作營運，承諾不將使用者真實 IP 寫入永久日誌，且不販售任何瀏覽資料作為廣告分析。
🎯 適用族群：線上遊戲玩家、追求 CDN 快顯極速載入、不希望任何域名解析受到干擾的純效能導向使用者。

🛡️ 1.1.1.2：兼顧速度的主動惡意防護（1.1.1.1 for Families）

🚀 核心定位：在維持 Cloudflare 本地節點低延遲的基礎上，提供第一線惡意域名阻斷。
🛡️ 過濾機制：✅ 自動阻擋惡意軟體、勒索病毒、釣魚網站及殭屍網路（C2）伺服器。攔截時直接將域名解析為 0.0.0.0（IPv6 為 ::）。
🔞 內容限制：僅針對惡意程式進行攔截，完全不干涉或過濾任何成人內容。
🎯 適用族群：一般個人日常上網、常下載第三方模組或測試工具，希望享有極速瀏覽同時多一層資安護盾的使用者。

👨‍👩‍👧‍👦 1.1.1.3：惡意軟體＋成人內容雙重過濾（家庭防護版）

🚀 核心定位：專為家庭與孩童網路環境設計的綠色過濾節點。
🛡️ 過濾機制：✅ 包含 1.1.1.2 的所有惡意軟體攔截功能，並額外主動阻擋成人內容、色情網站及高風險露骨域名。
🔒 阻斷行為：被判定為色情或惡意的域名同樣回傳 0.0.0.0，阻斷瀏覽器存取。
🎯 適用族群：家中有未成年孩童的家用路由器環境、學校或公共圖書館公用電腦。

🏰 9.9.9.9：以資安威脅情報為本的深度防護（Quad9）

🚀 核心定位：深度威脅阻斷與非營利中立資安防禦。
🛡️ 過濾機制：✅ 整合全球超過 20 家以上頂級網路安全威脅情報庫，若遭遇攻擊域名直接回傳 NXDOMAIN。
⚖️ 非營利中立：總部設於瑞士，嚴格遵循 GDPR 與瑞士隱私法規，無任何商業流量變現機制。
🎯 適用族群：企業內網、對惡意連結與詐騙釣魚高度敏感，願以些微延遲換取權威資安防禦的使用者。

🔍 8.8.8.8：高相容性與全球解析覆蓋（Google Public DNS）

🚀 核心定位：業界標準參考系，具備極度龐大的全球節點容量與最佳解析相容性。
🛡️ 過濾機制：❌ 無過濾。不攔截惡意或成人內容，支援 ECS（EDNS-Client-Subnet）以實現更精準的 CDN 本地伺服器調度。
🎯 適用族群：當其他新興 DNS 發生冷門網域解析異常時的最佳萬用備援、全球跨區開發者。

🚫 94.140.14.14：系統級廣告與追蹤攔截（AdGuard DNS）

🚀 核心定位：無需安裝外掛即可在全系統層級封鎖常見廣告與追蹤器。
🛡️ 過濾機制：✅ 自動阻擋網路廣告看板、分析計數器、追蹤代碼以及已知惡意網址。
🎯 適用族群：智慧電視、遊戲主機等無法安裝擴充元件的設備，或希望全機阻擋擾人廣告的使用者。

📊 熱門公共 DNS 規格與設定對照表

服務名稱	慣用 IPv4	備援 IPv4	惡意軟體阻擋	成人內容過濾	廣告追蹤阻擋
Cloudflare (純速度)	`1.1.1.1`	`1.0.0.1`	❌	❌	❌
Cloudflare (安全防護)	`1.1.1.2`	`1.0.0.2`	✅	❌	❌
Cloudflare (家庭防護)	`1.1.1.3`	`1.0.0.3`	✅	✅	❌
Quad9 (深度資安)	`9.9.9.9`	`149.112.112.112`	✅	❌	❌
Google Public DNS	`8.8.8.8`	`8.8.4.4`	❌	❌	❌
AdGuard DNS	`94.140.14.14`	`94.140.15.15`	✅	❌	✅

💡 總結配置建議

📌 極速防護平衡型：慣用 1.1.1.2，其他 9.9.9.9。兼顧 Cloudflare 本地低延遲攔截與 Quad9 跨系統資安情資備援。
📌 家庭與兒少保護型：慣用 1.1.1.3，其他 1.0.0.3。直接在路由器端一鍵阻斷惡意與成人內容。
📌 全域去廣告型：慣用 94.140.14.14，其他 94.140.15.15。適合無法安裝擋廣告套件的設備。
📌 極致連線穩定型：慣用 1.1.1.1，其他 8.8.8.8。兼顧 Cloudflare 極限速度與 Google 龐大穩定的解析容錯能力。

雜項-AI應用 Windows 截圖

2026-09-16T08:56:17.904+08:00

📌 導言：Windows 截圖到底存去哪了？

在 Windows 系統中，螢幕截圖的儲存行為依操作方式而異。許多人在使用快捷鍵框選截圖時，常遇到找不到存檔位置或不知道該去哪裡修改路徑的困擾。本文將完整說明如何更改預設存檔資料夾，以及剪取工具核心設定的差異。

📂 方法一：修改「Win + PrintScreen」快捷鍵存檔路徑

使用鍵盤組合鍵 Win + PrintScreen 進行全螢幕瞬間截圖時，圖檔會直接寫入系統預設資料夾，可依以下步驟搬移至其他磁碟槽：

📁 開啟檔案總管：按快捷鍵 Win + E，展開左側導覽列的「圖片」資料夾。
⚙️ 進入內容設定：在「螢幕擷取畫面（Screenshots）」資料夾上按滑鼠右鍵，點選「內容」。
📍 切換位置分頁：切換至視窗頂端的「位置」標籤頁。
📦 變更儲存路徑：點選「移動...」按鈕，選取目標硬碟目錄後點選「套用」。
✅ 確認搬移：在系統跳出的提示視窗點選「是」，現有截圖將一併轉移至新目錄。

✂️ 方法二：修改「剪取工具（Win + Shift + S）」預設儲存位置

⚠️ 注意：按 Win + Shift + S 彈出的「懸浮工具列」僅提供截圖模式切換（相機、錄影、框選），本身並不具備設定選單。必須啟動主程式方可調整。

🔍 開啟主程式：按 Win + S 搜尋「剪取工具」，按下 Enter 開啟完整應用程式視窗。
⚙️ 開啟設定：點選視窗右上角選單「⋯（其他選項）」，進入「設定」。
💾 指定存檔目錄：展開「自動儲存原始螢幕擷取畫面」（需切換為開啟），點擊旁邊的「變更」按鈕指定目標資料夾。

⚙️ 深入解析：剪取工具設定選項差異與影響

設定項目	功能說明	🟢 開啟狀態	⚪ 關閉狀態
自動複製變更	剪取工具內畫線、標註或裁切後，是否即時同步剪貼簿。	標記後直接按 `Ctrl + V` 即為最新版，省去手動複製步驟。	剪貼簿僅保留原圖，需在編輯後手動點擊「📋 複製」圖示。
自動儲存原始螢幕擷取畫面	框選截圖完成時，是否即時於硬碟寫入未編輯圖檔。	自動寫入硬碟資料夾備查，長期使用需定期整理檔案。	不主動寫入硬碟，僅存在剪貼簿記憶體中，適合即用即貼。

💡 推薦設定組合

💬 通訊與即時文書（日常推薦）：
啟用「自動複製變更」＋停用「自動儲存原始螢幕擷取畫面」。截圖編輯後可直接貼進通訊軟體或文件，避免硬碟累積多餘暫存圖。
🗄️ 教學記錄與圖庫歸檔：
啟用「自動儲存原始螢幕擷取畫面」，展開該項目設定存放磁區（例如非系統碟的大容量硬碟目錄），方便日後快速檢索。

雜項-AI應用 FFmpeg合併影片

2026-09-15T20:34:37.216+08:00

📌 實戰情境與核心目標

在 Windows 11 環境下為動態桌布（如 Lively Wallpaper）製作無縫輪播素材時，直接串接多支從網路（例如 Pexels）下載的 4K 60fps 影片，經常遇到時間戳錯位、片段過渡定格、音訊軌衝突，甚至片長異常膨脹的問題。

本指南以真實除錯過程為範例，完整記錄如何正確部署 FFmpeg、解析多種合併策略的指令效用，克服 PowerShell 系統模組異常，並利用 Intel Arc 獨立顯卡（Quick Sync Video，QSV）硬體加速實現毫秒級無縫切換。

🛠️ 步驟一：Windows 11 終端機與 FFmpeg 快速部署

在指定資料夾內開啟終端機時，請避免直接在網址列輸入模糊指令以免誤開使用者設定目錄。正確且迅速的安裝與路徑開啟方式如下：

📂 精準開啟工作路徑之 PowerShell

🔹 方法 A（檔案總管網址列）：點擊資料夾路徑列，輸入 powershell.exe 並按 Enter（加上 .exe 可防止系統誤判為使用者文件目錄）。
🔹 方法 B（快捷選單）：在資料夾空白處按住 Shift 鍵並點擊滑鼠右鍵，選擇「在終端機中開啟」。
🔹 方法 C（CMD 原地切換）：若目前處於命令提示字元，直接鍵入 powershell 即可就地切換。

⚡ 一行指令安裝 FFmpeg

在 PowerShell 視窗內執行微軟官方套件管理工具：

winget install Gyan.FFmpeg

⚠️ 注意：安裝完成後必須關閉並重開終端機視窗，新的系統環境變數（PATH）才會正式生效。

🔍 過程試誤與實例解說（Troubleshooting）

❌ 試誤案例 1：PowerShell 核心模組無法載入（Out-File / Invoke-Expression）

現象：執行 Out-File 或 Invoke-Expression 動態字串時，拋出 CouldNotAutoloadMatchingModule: Microsoft.PowerShell.Utility 錯誤。

原因與對策：環境的系統工具模組受損或受群組原則限制。匯出文字檔時應改用純管線重導向 >，執行字串命令時改用 & cmd.exe /c $cmd 或直接貼上完整展開的指令。

❌ 試誤案例 2：串接切換處「定格靜止」

現象：使用 -c copy 進行無損串接，影片在 22 秒處畫面瞬間定格，直到下一個片段才恢復播放。

原因與對策：各原始影片的關鍵影格（Keyframe / GOP）間隔不同，未重新編碼時解碼器無法在無 I 幀的銜接點解碼。必須利用 GPU 硬體編碼強制固定 -g 60 -r 60。

❌ 試誤案例 3：總片長異常膨脹（50秒暴增至2分51秒）

現象：3 支影片時長分別為 22s、22s、6s，理論總長 50s，合併後卻拉長為 171s 且充斥靜止畫面。

原因與對策：網路素材部分帶有隱藏無聲長音軌、部分無音軌，且直向（2160×3840）與橫向（3840×2160）尺寸衝突導致解碼器時間戳（PTS/DTS）失步。必須使用 setpts=PTS-STARTPTS 重置時間戳並加上 -an 剔除音軌。

🚀 FFmpeg 常見指令與效用全覽

指令／參數	功能類型	實際效用說明
`-f concat -safe 0`	分離器調用	指定以清單模式合併檔案，`-safe 0` 允許包含底線等特殊檔名與相對路徑。
`-c copy`	流複製模式	不經 CPU/GPU 轉碼直接拼裝。耗時僅 1 秒且畫質 100% 無損，但要求所有素材編碼與長寬完全一致。
`-c:v h264_qsv`	硬體加速編碼	調用 Intel Arc 顯卡之 Quick Sync 獨立硬體編碼單元，大幅降低 CPU 負擔並極速壓制。
`-global_quality 20`	畫質控制	QSV 專屬視覺無損品質模式。數值越低品質越高，20 可確保 4K 畫面維持清晰無色塊。
`-g 60 -r 60`	影格與 GOP 鎖定	鎖定每秒 60 幀，並每秒插入一個完整關鍵影格（I 幀），徹底消除場景過渡時的畫面定格。
`setpts=PTS-STARTPTS`	時間戳重置	將各片段播放時間戳從零重新計算，防止時間軸跳躍與異常膨脹。
`scale ... pad`	畫面適配濾鏡	自動將直向與橫向素材等比例縮放並置中填滿 3840×2160，避免畫面拉伸變形或解析度不一致崩潰。
`-an` / `a=0`	音訊剔除	完全移除音軌。桌布影片不需要聲音，剔除音訊可 100% 杜絕影音不同步造成的切換停頓。

💡 最佳實踐指令範例

情境 A：規格完全一致時之「極速無損串接」

首先建立 files.txt，內容為：

file '1.mp4'
file '2.mp4'
file '3.mp4'

執行指令（耗時約 1~2 秒）：

ffmpeg -f concat -safe 0 -i files.txt -fflags +genpts -c copy output_lossless.mp4

情境 B：11 支素材跨長寬／時間戳／去音軌之「多片段 QSV 無縫合併」

將素材整理為 1.mp4 至 11.mp4，使用 Filter Complex 串接濾鏡，同時完成畫面自適應、時間戳重置並調用 Intel Arc QSV 硬體編碼：

寫法 1：PowerShell 陣列組裝（繞過模組限制執行）

$inputs = 1..11 | ForEach-Object { "-i `"$_.mp4`"" }
$filter_scale = 0..10 | ForEach-Object { "[$_:v]setpts=PTS-STARTPTS,fps=60,scale=3840:2160:force_original_aspect_ratio=decrease,pad=3840:2160:(ow-iw)/2:(oh-ih)/2[v$_]" }
$filter_concat = (0..10 | ForEach-Object { "[v$_]" }) -join ''
$filter_complex = ($filter_scale -join '; ') + "; ${filter_concat}concat=n=11:v=1:a=0[v]"
$cmd = "ffmpeg $inputs -filter_complex `"$filter_complex`" -map `"[v]`" -c:v h264_qsv -global_quality 20 -an Combined_11_Seamless_4K.mp4"

& cmd.exe /c $cmd

寫法 2：單行直接展開指令（最穩健、免任何腳本語言環境）

ffmpeg -i 1.mp4 -i 2.mp4 -i 3.mp4 -i 4.mp4 -i 5.mp4 -i 6.mp4 -i 7.mp4 -i 8.mp4 -i 9.mp4 -i 10.mp4 -i 11.mp4 -filter_complex "[0:v]setpts=PTS-STARTPTS,fps=60,scale=3840:2160:force_original_aspect_ratio=decrease,pad=3840:2160:(ow-iw)/2:(oh-ih)/2[v0]; [1:v]setpts=PTS-STARTPTS,fps=60,scale=3840:2160:force_original_aspect_ratio=decrease,pad=3840:2160:(ow-iw)/2:(oh-ih)/2[v1]; [2:v]setpts=PTS-STARTPTS,fps=60,scale=3840:2160:force_original_aspect_ratio=decrease,pad=3840:2160:(ow-iw)/2:(oh-ih)/2[v2]; [3:v]setpts=PTS-STARTPTS,fps=60,scale=3840:2160:force_original_aspect_ratio=decrease,pad=3840:2160:(ow-iw)/2:(oh-ih)/2[v3]; [4:v]setpts=PTS-STARTPTS,fps=60,scale=3840:2160:force_original_aspect_ratio=decrease,pad=3840:2160:(ow-iw)/2:(oh-ih)/2[v4]; [5:v]setpts=PTS-STARTPTS,fps=60,scale=3840:2160:force_original_aspect_ratio=decrease,pad=3840:2160:(ow-iw)/2:(oh-ih)/2[v5]; [6:v]setpts=PTS-STARTPTS,fps=60,scale=3840:2160:force_original_aspect_ratio=decrease,pad=3840:2160:(ow-iw)/2:(oh-ih)/2[v6]; [7:v]setpts=PTS-STARTPTS,fps=60,scale=3840:2160:force_original_aspect_ratio=decrease,pad=3840:2160:(ow-iw)/2:(oh-ih)/2[v7]; [8:v]setpts=PTS-STARTPTS,fps=60,scale=3840:2160:force_original_aspect_ratio=decrease,pad=3840:2160:(ow-iw)/2:(oh-ih)/2[v8]; [9:v]setpts=PTS-STARTPTS,fps=60,scale=3840:2160:force_original_aspect_ratio=decrease,pad=3840:2160:(ow-iw)/2:(oh-ih)/2[v9]; [10:v]setpts=PTS-STARTPTS,fps=60,scale=3840:2160:force_original_aspect_ratio=decrease,pad=3840:2160:(ow-iw)/2:(oh-ih)/2[v10]; [v0][v1][v2][v3][v4][v5][v6][v7][v8][v9][v10]concat=n=11:v=1:a=0[v]" -map "[v]" -c:v h264_qsv -global_quality 20 -an Combined_11_Seamless_4K.mp4

📝 操作檢核清單（Checklist）

✅ 檔案命名是否簡化（如 1.mp4～11.mp4），避免引數解析時因空格或長檔名遺漏出錯。
✅ 產出之 Combined_11_Seamless_4K.mp4 總時長是否與各分段加總完全相符。
✅ 隨機拖曳進度條至各銜接點，確認畫面無微卡頓、無定格等待且音軌已完全剝離。
✅ 拖入 Lively Wallpaper 設為動態桌布後，確認顯卡 GPU 解碼器（Xe Media Engine）順暢接手運作。

雜項-AI應用 PowerToys 項目功能

2026-09-15T11:38:45.642+08:00

PowerToys (v0.101.2362) 系統工具分類與公用程式全功能圖文解析

本篇以側邊導覽列「系統工具」的 10 項核心子模組為優先，進行深入圖文解析；第二部分則排除重疊項，完整收錄右側「公用程式」其餘 23 項獨立模組，各項目標題前均配有直觀對應的圖示符號。

一、左側「系統工具」子項目深度解析 (共 10 項)

📋 1. 進階貼上 (Advanced Paste) Win + Shift + V

          [剪貼簿文字] → [進階貼上面板: 純文字 / Markdown / JSON / AI 轉換] → [直接貼入目標]
        

核心功能：剪貼簿格式轉換中樞，可一鍵轉為純文字、Markdown、JSON，或透過本機/雲端 AI 模型即時改寫、摘要。
應用實例：從排版混亂的網頁複製內文時，直接貼成乾淨純文字；或將 Excel 儲存格一鍵轉換為 Markdown 表格。
配置建議：強烈推薦開啟（日常文書排版效率翻倍）。

☕ 2. Awake (喚醒) 工作列圖示常駐

          [工作列右鍵咖啡杯圖示] → [設定: 保持喚醒 30 分 / 1 小時 / 無限期] → [螢幕與主機不進入休眠]
        

核心功能：在系統匣快速阻止電腦休眠或螢幕關閉，免進 Windows 設定頻繁修改電源計畫。
應用實例：掛機下載遊戲大檔、跑 batch 轉檔或跑本地 AI 模型運算時，防止休眠中斷。
配置建議：強烈推薦開啟（長時間下載或轉檔必備）。

⚡ 3. 命令選擇區 (Command Palette) Win + Alt + Space

          [快捷鍵喚醒置中面板] → [鍵入系統指令或功能關鍵字] → [Enter 秒級直達設定]
        

核心功能：現代化快速指令與全域搜尋中樞，透過鍵盤極速呼叫系統設定或切換模組。
應用實例：全鍵盤流直接切換深淺模式、關閉網路或啟動特定工具，免用滑鼠在控制台翻找。
配置建議：建議開啟體驗（鍵盤流進階用戶推薦）。

🎨 4. 顏色選擇器 (Color Picker) Win + Shift + C

          [啟動放大鏡游標] → [目標像素點擊左鍵] → [自動複製 #HEX 色碼並開啟調色盤]
        

核心功能：全螢幕螢幕取色滴管工具，支援 HEX、RGB、CMYK 等格式轉換並內建歷史調色盤。
應用實例：在網站或投影片看見出色的配色，一鍵吸取色碼貼入簡報軟體使用。
配置建議：排版與設計必開。

🌓 5. Light Switch 系統自動化排程

          [日間日出時間: 淺色高對比] → [傍晚日落時間: 自動切換深色模式] → [保護視力]
        

核心功能：依排程時間或本機日出日落週期，自動無縫切換 Windows 系統深色/淺色外觀主題。
應用實例：白天維持清爽高對比介面，夜間自動切為深色模式降低雙眼疲勞。
配置建議：推薦自動化開啟。

🚀 6. PowerToys Run Alt + Space

          [Alt+Space 叫出搜尋框] → [輸入: 45*88 或 程式名稱] → [直接算數或瞬間啟動]
        

核心功能：輕量級極速啟動器，整合應用搜尋、檔案查詢、快速計算機及單位換算。
應用實例：需要臨時計算時直接鍵入算式得結果，免開啟小算盤或開始功能表。
配置建議：強烈推薦開啟（全面取代 Windows 內建搜尋列）。

📏 7. 螢幕尺規 (Screen Ruler) Win + Ctrl + Shift + M

          [啟動尺規面板] → [游標移至元素上方: 自動吸附測量] 或 [拖曳拉框量測 px 寬高]
        

核心功能：螢幕像素級直觀測量工具，支援邊界自動偵測、水平/垂直間距與自訂框選量測。
應用實例：校對 PPT 圖文留白、驗證網頁按鈕邊界 (Padding/Margin) 是否精準。
配置建議：前端/美編必備。

⌨️ 8. 快捷鍵指南 (Shortcut Guide) Win + Shift + /

          [長按快捷鍵] → [全螢幕浮現半透明 HUD 疊加層] → [顯示所有可用 Win+ 組合鍵提示]
        

核心功能：系統快速鍵提示疊加層，依當前畫面狀態動態顯示可用的 Windows 組合鍵。
應用實例：忘記視窗貼齊、虛擬桌面切換或截圖熱鍵時，隨時按鍵呼叫速查。
配置建議：新手必開。

🔤 9. 文字擷取器 (Text Extractor) Win + Shift + T

          [框選不可複製區域 (如影片/圖片)] → [OCR 辨識] → [文字自動存入剪貼簿]
        

核心功能：螢幕光學字元辨識 (OCR) 工具，框選畫面任意區域即可直接提取文字。
應用實例：觀看教學影片時暫停，框選畫面中無法複製的程式碼、報表或錯誤訊息。
配置建議：強烈推薦開啟（免去手動打字重抄）。

🔍 10. ZoomIt Ctrl + 1

          [Ctrl+1: 畫面無損放大] → [Ctrl+2: 呼叫彩色畫筆箭頭] → [Esc: 退出]
        

核心功能：簡報展示神物，支援螢幕無損放大、畫筆箭頭標註、打字註記與倒數計時器。
應用實例：遠端會議或教學時，無損放大視窗局部細節，並拉出箭頭標記操作核心。
配置建議：簡報與教學者必備。

二、右側其餘公用程式全項目圖文解析 (排除重疊後共 23 項)

🪟 視窗化與版面配置模組

📑 FancyZones 吸附：按住 Shift | 編輯：Win + Shift + `

          [自訂多欄排版網格] → [按住 Shift 拖曳視窗] → [視窗自動吸附貼齊分區]
        

功能與實例：突破系統預設貼齊限制。4K 或超寬螢幕自訂三欄等寬配置，拖曳視窗即刻自動對齊。

建議：多工與寬螢幕必備核心。

📌 最上層顯示 (Always On Top) Win + Ctrl + T

          [選定目標視窗按快捷鍵] → [視窗加上藍框置頂] → [切換其他軟體不被覆蓋]
        

功能與實例：強制視窗常駐置頂，支援調透明度。對帳時釘選計算機，或邊看教學邊敲代碼。

建議：強烈推薦開啟。

📦 工作區 (Workspaces) 一鍵工作流佈局

          [建立工作區捷徑] → [點擊捷徑: 一鍵啟動多應用程式並定位雙螢幕]
        

功能與實例：一鍵依預設尺寸與位置開啟一組應用程式。進入工作狀態免手動排列視窗。

建議：多螢幕進階工作者選用。

🗂️ 視窗分配區 (New) 單鍵重整視窗

          [桌面視窗散亂重疊] → [執行視窗分配] → [所有開啟視窗秒級靠齊指定區塊]
        

功能與實例：快捷將開啟中的混亂視窗依網格邏輯重整歸位至特定分區，適合視窗過多時快速整理。

建議：視窗管理輔助選用。

✂️ 裁剪和鎖定 (Crop And Lock) Win + Ctrl + Shift + T / R

          [框選目標視窗局部] → [其餘邊框按鈕裁去] → [化為迷你常駐監控窗]
        

功能與實例：裁切目標視窗特定局部。只把股票看板特定數值或監視器畫面裁切釘選在桌面角落。

建議：特定數值監控需求選用。

🖐️ Grab And Move 全系統抓手平移

          [按住指定輔助鍵] → [滑鼠轉為抓手游標] → [拖曳平移長文件與網頁]
        

功能與實例：將 PDF 的抓手平移功能擴展至全系統，免用滾輪即可任意拖動瀏覽超長內容。

建議：依個人操作習慣選用。

🖱️ 輸入與外接周邊控制模組

🎯 尋找我的滑鼠 (Find My Mouse) 連按兩次左 Ctrl 鍵

          [連按兩次左 Ctrl] → [螢幕暗化 + 游標處亮起聚光燈] → [晃動滑鼠自動恢復]
        

功能與實例：游標定位神物。在 4K 螢幕或雙螢幕環境下游標迷失時，兩下 Ctrl 瞬間找到位置。

建議：大螢幕/多螢幕必開。

⏩ 滑鼠跳轉 (Mouse Jump) Win + Shift + D

          [快捷鍵呼叫全景縮圖] → [點選副螢幕任意處] → [游標跨螢幕瞬間到達]
        

功能與實例：跨螢幕瞬移。4K 主螢幕與副螢幕長距離移動時，省去大幅滑動手腕或轉動軌跡球。

建議：多螢幕/寬螢幕必開。

🖍️ 滑鼠螢光筆 (Mouse Highlighter) Win + Shift + H

          [左鍵點擊: 產生黃色光圈] | [右鍵點擊: 產生藍色光圈] → [呈現點擊動作]
        

功能與實例：點擊時產生彩色視覺光圈。線上會議、操作錄影或教學時突顯滑鼠點擊焦點。

建議：教學/簡報展示者開啟。

➕ 滑鼠指標交叉線 (Mouse Crosshairs) Win + Alt + P

          [以游標為中心在全螢幕拉出橫豎雙向十字線] → [跨欄對位不失焦]
        

功能與實例：全螢幕十字定位線。閱讀橫向極長的 Excel 跨欄對帳，或 CAD 比對基準點時防止看錯行。

建議：財務對帳/工程設計選用。

🔄 CursorWrap 螢幕邊緣穿透

          [滑鼠滑出螢幕最右邊界] → [自動從螢幕最左邊界穿出] → [減少往返移動]
        

功能與實例：游標穿透邊緣。寬螢幕操作時滑鼠直接穿透，縮短長距離拉動手部的負擔。

建議：習慣邊緣穿透操作者選用。

⌨️ 鍵盤管理器 (Keyboard Manager) 實體按鍵映射

          [自訂規則: CapsLock → Ctrl] | [自訂快捷鍵: Win+D → 單鍵觸發]
        

功能與實例：重新映射實體按鍵或組合鍵。把少用的 CapsLock 映射為 Ctrl，顯著提高打字效率。

建議：客製鍵盤鍵位者開啟。

🖥️ 無框線的滑鼠 (Mouse Without Borders) 跨主機控制

          [桌機滑鼠滑過邊界] → [直接進入筆電螢幕] → [鍵盤與剪貼簿即時共用]
        

功能與實例：區網跨主機鍵鼠共用。桌面同時擺桌機與工作筆電時，一套鍵鼠無縫操控多台主機並拖曳傳檔。

建議：多主機環境必開（單電腦用戶關閉）。

🖥️ Power Display 螢幕喚醒管理

          [快速覆蓋顯示器睡眠策略] → [指定副螢幕維持常亮不熄滅]
        

功能與實例：針對個別螢幕做供電維持管理。在雙螢幕環境下讓副螢幕持續常駐儀表板或監看畫面。

建議：多螢幕常亮需求者選用。

🔤 Quick Accent 重音字元快速輸入

          [長按字母 e 同時按空格] → [彈出 è, é, ê, ë 選單] → [左右鍵選取輸入]
        

功能與實例：外語特殊字母輸入。撰寫法語、德文等外語專有名詞時，免去切換外語輸入法。

建議：外語輸入需求選用。

📁 檔案管理與檔案總管增強模組

👁️ 預覽 (Peek) Ctrl + Space

          [檔案總管選取檔案] → [按 Ctrl+Space] → [秒開浮動預覽視窗]
        

功能與實例：媲美 macOS 的空白鍵快速預覽。免開啟龐大的 Word 或看圖軟體，直接速覽確認內文。

建議：強烈推薦開啟。

🔒 File Locksmith 右鍵選單整合

          [刪除檔案顯示「正在使用」] → [右鍵: 解除佔用] → [結束進程並刪除]
        

功能與實例：排查被佔用的檔案。刪除檔案或退出隨身碟遇到佔用報錯時，一秒找出程序並釋放。

建議：強烈推薦開啟。

🏷️ PowerRename 批次重新命名

          [選取 100 個檔案右鍵: PowerRename] → [替換字串 + 加入序號] → [一鍵套用]
        

功能與實例：批次重新命名神器。支援正規表示式與編號規則，數百張照片一秒整理完成。

建議：強烈推薦開啟。

🖼️ 圖像大小調整器 (Image Resizer) 右鍵批次縮圖

          [選取多張相片右鍵: 調整圖片大小] → [選取 1080p] → [秒轉出輕量副本]
        

功能與實例：批次縮減圖片尺寸與轉檔。免開修圖軟體，直接在檔案總管將單眼大圖縮圖方便傳送。

建議：強烈推薦開啟。

➕ 新增+ (New+) 自訂範本新增

          [右鍵: 新增+] → [選取專案範本] → [自動產生完整資料夾結構與範本檔]
        

功能與實例：擴充右鍵選單範本庫。開新專案時一鍵產生包含設定檔與目錄樹的完整專案範本。

建議：專案規劃者推薦。

🛠️ 進階系統管理與維護模組

🌐 主機檔案編輯器 (Hosts File Editor) Hosts 視覺化管理

          [開啟圖形介面] → [新增 IP 與 Domain] → [開關切換導向]
        

功能與實例：安全管理系統 hosts 導向條目。本地測試網站時免手動提權開記事本編輯系統檔。

建議：開發與網管選用（一般用戶勿動）。

🔧 環境變數 (Environment Variables) Path 變數視覺化

          [列表檢視系統與使用者 Path] → [增刪路徑] → [防範字串誤刪]
        

功能與實例：圖形化管理系統變數。安裝開發環境時一目了然各個 Path，防止格式錯亂損壞。

建議：開發者必備（一般用戶關閉）。

🧩 登錄預覽 (Registry Preview) .reg 樹狀預覽

          [右鍵 .reg 檔案: 預覽] → [樹狀圖比對鍵值變更] → [確認無誤後套用]
        

功能與實例：視覺化檢視註冊表檔案。套用網路上的註冊表優化前先比對異動內容，避免損壞系統。

建議：進階維修選用。

三、給一般用戶的最佳化配置指南

「系統工具」常駐核心： 🔤 文字擷取器、📋 進階貼上、🚀 PowerToys Run、☕ Awake。
「公用程式」效率必開： 📑 FancyZones、📌 最上層顯示、👁️ 預覽、🔒 File Locksmith、🏷️ PowerRename、🖼️ 圖像大小調整器。
多螢幕與寬螢幕專屬： 🎯 尋找我的滑鼠、⏩ 滑鼠跳轉。
一般用戶建議保持關閉： 🌐 主機檔案編輯器、🔧 環境變數、🧩 登錄預覽、🖥️ 無框線的滑鼠（無多主機環境），以節省系統資源並防範誤觸。

先天八卦（伏羲八卦）與後天八卦（文王八卦）

2026-09-15T08:57:54.413+08:00

先天八卦（伏羲八卦）與後天八卦（文王八卦）是易經哲理與術數應用的兩大核心體系。兩者並非對立，而是「體用互表」：先天為體，描繪宇宙初生與天地陰陽對待的本質規律；後天為用，詮釋萬物運行、四時流轉與人事變化的實時秩序。

先後天八卦核心對比總覽

維度	先天八卦（伏羲八卦）	後天八卦（文王八卦）
哲學核心	為體（空間對待、天地本質、平衡靜止）	為用（時間流行、五行生剋、動態流行）
創制傳說	伏羲氏觀河圖而劃	周文王察洛書而推
排列法則	兩兩對待，陰陽對立互補	四時五行運轉，順應生長收藏
主要方位	天地定位：乾南、坤北、離東、坎西	四方四時：離南、坎北、震東、兌西
數理秩序	乾一、兌二、離三、震四、巽五、坎六、艮七、坤八	坎一、坤二、震三、巽四、中五、乾六、兌七、艮八、離九（洛書數）
主流應用	易數起卦（梅花易數）、本質推演、先天鏡化煞	地理風水（三元玄空、八宅）、奇門遁甲、紫微斗數、醫道養生

符號象徵與八卦取象口訣

八卦符號以陽爻（—）與陰爻（--）三爻疊加而成，宋代朱熹所編的《八卦取象歌》精確概括了符號特徵：

乾三連（☰）： 全陽之象，象徵天、父、剛健、首、君。
坤六斷（☷）： 全陰之象，象徵地、母、柔順、腹、臣。
震仰盂（☳）： 初爻陽，象徵雷、長男、震動、足、起。
艮覆碗（☶）： 上爻陽，象徵山、少男、止伏、手、靜。
離中虛（☲）： 中爻陰，象徵火、日、中女、明亮、目。
坎中滿（☵）： 中爻陽，象徵水、月、中男、險陷、耳。
兌上缺（☱）： 上爻陰，象徵澤、少女、愉悅、口、說。
巽下斷（☴）： 初爻陰，象徵風、長女、深入、股、順。

先天八卦：空間平衡與本質對待

卦序口訣：乾一、兌二、離三、震四、巽五、坎六、艮七、坤八。

方位布局（坐北朝南視角）：乾南、坤北、離東、坎西、震東北、巽西南、艮西北、兌東南。

哲理內涵（《說卦傳》天地對待）：

天地定位： 乾（南、天）與坤（北、地）上下相對，奠定宇宙基本框架。
山澤通氣： 艮（西北、山）與兌（東南、澤）遙相呼應，氣脈貫通。
雷風相薄： 震（東北、雷）與巽（西南、風）互相激盪，鼓動生機。
水火不相射： 坎（西、水）與離（東、火）互為制衡，水火既濟而不相害。

數理特徵：相對兩卦數值相加皆為九（1+8=9、2+7=9、3+6=9、4+5=9），且相對卦象陰陽爻完全相反（如乾三陽爻對坤三陰爻），展現出高度對稱、恆定平衡的宏觀宇宙幾何。

後天八卦：時間運行與流行轉化

洛書九宮數口訣：戴九履一，左三右七，二四為肩，六八為足，五居中央。

卦位配數：坎一（北）、坤二（西南）、震三（東）、巽四（東南）、中宮五、乾六（西北）、兌七（西）、艮八（東北）、離九（南）。

五行屬性：坎水、震巽木、離火、兌乾金、坤艮中宮土。

哲理內涵（《說卦傳》萬物出入流行）：

帝出乎震： 萬物於東方震木萌發（春季）。
齊乎巽： 東南巽木，萬物生長整齊潔淨（春末夏初）。
相見乎離： 正南離火，光明普照，萬物顯現壯盛（盛夏）。
致役乎坤： 西南坤土，大地滋養萬物化育，役養生成（夏末秋初）。
說言乎兌： 正西兌金，秋季成熟收穫，眾生欣悅（秋分）。
戰乎乾： 西北乾金，陰陽相薄，萬物結實歸根（秋冬之交）。
勞乎坎： 正北坎水，勞憊藏伏，萬物歸藏休養（冬至）。
成言乎艮： 東北艮土，冬春之交，象徵終止與嶄新生機之始（立春）。

核心應用領域

起卦與數理運算（以先天數為主）： 梅花易數凡以時間、字畫、聲音起卦，皆取先天八卦數（乾一、兌二至坤八）轉化為卦象；定卦之後，再依據後天八卦的五行生剋推算吉凶應期。
空間方位與風水堪輿（先後天體用結合）： 三元玄空風水羅盤以後天八卦為坐向與九宮飛星基礎，推斷當運旺衰；以先天八卦為「體」，檢查水法與氣場是否符合理氣法門。八宅風水則直接以後天卦位論東四宅與西四宅。
醫學與養生（後天臟腑五行）： 中醫依據後天八卦之五行流行推演臟腑氣化：坎水應腎，離火應心，水火互濟為心腎相交；震木應肝，兌金應肺，坤艮土應脾胃，乾金應大腸與大腦。

雜項-AI應用 Windows 11 ReFS vs NTFS

2026-09-14T17:07:58.894+08:00

Windows 11 系統碟與資料碟全面解析：ReFS vs NTFS 在單碟與雙向鏡像下的量化優劣實測

在建置 Windows 11 本地儲存架構時，磁碟的用途通常分為「承載作業系統的系統碟（System/OS Drive）」與「存放各類檔案的資料碟（Data Drive）」。面對微軟老牌成熟的 NTFS 與新世代具備自癒能力的 ReFS，搭配 Windows「儲存空間」的雙向鏡像（Two-way Mirror）時，兩者在不同磁碟角色下的相容性、效能開銷與資料安全機制大不相同。本文將系統碟限制與資料碟需求合併納入考量，提供完整量化分析。

一、系統碟 vs 資料碟的核心限制與運作機制

【系統碟關鍵限制】Windows 11 原生不支援 ReFS 開機： 在一般終端環境中，Windows 11 系統開機磁區（C: 槽）必須採用 NTFS 格式。ReFS 缺乏完整的開機引導鏈路與部分系統核心屬性支援，無法作為獨立作業系統啟動碟。因此系統碟若需要雙向鏡像高可用性，僅能採用「NTFS 鏡像」；ReFS 的舞台主要在於「次要資料碟（Data Drive）」。
【資料碟特性】大檔與虛擬機區塊複製（Block Cloning）： ReFS 在資料碟上展現強大優勢。若作為虛擬機映象檔（.vhdx）、測試環境或大型專案目錄，ReFS 內部複製數十 GB 檔案能瞬間秒級完成（0 秒複製），且不佔額外實體空間；NTFS 則受限於實體讀寫吞吐。
【資料碟特性】冷熱資料、碎片化與頻繁隨機寫入： 長期封存的家庭照片與影片（冷資料）極易遭遇無聲位元腐蝕（Bit Rot），ReFS 在鏡像資料碟能靠 Integrity Streams 進行背景自動修復；但若是 BT/PT 高頻下載或頻繁修改的小檔案，ReFS 的寫入時複製（CoW）機制會造成嚴重的寫入放大與區塊碎片化，導致機械硬碟隨機 I/O 嚴重卡頓。
第三方資料救援與維護鏈： NTFS 擁有極致完整的磁碟救援生態（Recuva、DiskGenius 等），檔案誤刪或磁區辨識錯誤時容易救回；ReFS 由於 B+ 樹結構封閉且版本更迭頻繁，常見一般救援軟體難以辨識，資料碟一旦意外格式化或誤刪，救援難度與代價極高。

二、全情境量化效能與特性矩陣評比

*以主流 7200 轉 SATA 企業級/NAS 傳統硬碟（單碟基準連續約 200 MB/s、隨機 4K 約 0.6～1.5 MB/s）於 Windows 11 下之典型實測綜合表現為基準：

評比指標	單碟 + NTFS	單碟 + ReFS	雙向鏡像 + NTFS	雙向鏡像 + ReFS
系統開機碟支援	完全原生支援（預設標準）	不支援（無法開機）	支援（可做動態鏡像開機）	不支援（僅能做資料碟）
資料碟大檔連續讀取	單碟吞吐（~200 MB/s）	接近單碟（~195 MB/s）	雙碟分流加速（~360-390 MB/s）	雙碟分流加速（~350-380 MB/s）
資料碟同區塊複製	需實體讀寫（耗時長）	秒級瞬間完成（區塊複製）	需實體讀寫（耗時長）	秒級瞬間完成（區塊複製）
BT下載 / 隨機 4K 寫入	最佳（就地覆寫損耗低）	下降 25%~40%（CoW 放大）	下降 15%~25%（雙碟尋道延遲）	最弱（多執行緒隨機寫入易卡頓）
冷資料防腐蝕能力	無（無校驗機制）	僅能告警（無副本自癒）	無（有副本但無法辨別對錯）	完整自癒（校驗自動修復受損區塊）
異常斷電抗損性	中等（需執行 chkdsk 修復）	極佳（CoW 機制永不需 chkdsk）	良好（容許一顆物理硬碟損壞）	極致（雙碟容錯 + 結構免檢修）
誤刪救援與生態支援	極佳（支援 EFS、Quota、救援工具）	困難（一般救援工具無法解析）	極佳（相容性最高）	困難（依賴專業企業工具）

三、系統碟與資料碟的最佳搭配策略

1. 系統開機碟（C: 槽）最佳解 ➔ 固定使用 NTFS（搭配 NVMe SSD 單碟或軟體鏡像）

微軟在架構上尚未開放消費者端以 ReFS 作為系統開機啟動磁區。系統碟有大量高頻隨機小檔案讀寫、系統還原點與安全權限控制，NTFS 的就地覆寫特性與超低系統負擔是作業系統平穩運行的唯一保障。

2. 資料碟情境 A（冷儲存/家庭回憶/虛擬機）➔ 首選「雙向鏡像 + ReFS」

若資料碟主要是長期封存相片、家庭影片、重要備份或大型 Hyper-V 虛擬機器，這類資料鮮少進行隨機小檔頻繁修改。雙向鏡像結合 ReFS 能徹底杜絕「靜態位元腐蝕」，十年後讀取仍能透過健全副本自動修復損壞區塊；虛擬機複製還能享受瞬間秒開的「區塊複製」優勢。

3. 資料碟情境 B（BT/PT下載/遊戲庫/頻繁解壓縮）➔ 首選「NTFS（單碟或鏡像）」

若資料碟承擔重度 BT/PT 下載、Steam 遊戲安裝庫或解壓縮大型專案，ReFS 的寫入時複製會產生龐大的寫入放大與嚴重的區塊碎片化，導致傳統機械硬碟讀寫磁頭尋道崩潰、效能嚴重衰退。此時具備成熟就地覆寫機制的 NTFS 才是維持流暢度與通用性的最佳解答。

雜項-AI應用硬體 RAID vs HBA vs 晶片組直通

2026-09-14T16:36:36.500+08:00

硬體 RAID vs HBA vs 晶片組直通：Win11 下三種 RAID 10 等效架構深度評比

在建置本地大容量儲存陣列時，究竟該選擇傳統的硬體 RAID 卡、純直通的 HBA 卡，還是直接利用主機板晶片組搭配 Windows 內建的「儲存空間（Storage Spaces）」？本文排除建置成本考量，純粹從軟硬體架構、資料安全、效能與平台適配度出發，針對特定運行環境，將磁碟配置嚴格一致化為 4 顆 2TB（最低門檻） 與 8 顆 2TB（最佳滿載） 進行深度解析。

一、測試與評估環境配置

處理器 (CPU)： AMD Ryzen 5 5600X (6C12T)
主機板 (MB)： ASUS TUF GAMING X570-PRO (WI-FI)
顯示卡 (GPU)： Intel Arc B580（佔用 CPU 直出 PCIe 4.0 x16 插槽）
記憶體 (RAM)： 64GB DDR4
作業系統 (OS)： Windows 11 專業版 / 工作站版
儲存硬碟 (HDD)： 2TB SATA 企業級/NAS 傳統硬碟（4 顆 / 8 顆）
機殼與散熱 (Cooling)： Fractal Design Define 7 搭配 6 顆 Delta AFB1212VH 暴力扇（解決被動散熱晶片高溫問題）
候選控制設備：
- LSI MegaRAID 9271-8i（內建 1GB DDR3 快取，支援 CacheVault/BBU）
- LSI HBA IT Mode 直通卡（如 9211-8i / 9300-8i 等級）
- ASUS X570 原生 8 個 SATA 6Gbps 連接埠

二、磁碟配置基準一致化（RAID 10 等效架構）

為確保對比公平，所有方案均配置為「雙向鏡像 + 條帶化（Striping）」模式：

最少配置（4 顆 2TB，可用容量 4TB）：
- LSI 9271-8i (硬體 RAID 10)： 2 組 RAID 1 做 Striping (RAID 0)。
- HBA 卡 (IT Mode) + Win11 儲存空間： 4 顆直通，建立 2 欄位（Columns=2）雙向鏡像。
- X570 板載 SATA + Win11 儲存空間： 4 顆直連原生 SATA，軟體建立 2 欄位雙向鏡像。
最佳滿載配置（8 顆 2TB，可用容量 8TB）：
- LSI 9271-8i： 4 組 RAID 1 做 Striping，插滿 2 組 SFF-8087 埠。
- HBA 卡 (IT Mode) + Win11 儲存空間： 8 顆直通，建立 4 欄位（Columns=4）雙向鏡像，具備 4 碟併發頻寬。
- X570 板載 SATA + Win11 儲存空間： 插滿主機板原生 8 個 SATA 埠，走晶片組頻寬聚合。

三、三方軟硬體優劣詳細比較

評比維度	LSI 9271-8i (硬體 RAID 10)	HBA (IT Mode) + Win11 儲存空間	X570 原生 SATA + Win11 儲存空間
運作架構	純硬體運算 ROC 晶片排程，對系統包裝成單一虛擬磁區。	硬體通道 + 軟體陣列純訊號轉接，由 Windows 掌控實體碟與排程。	晶片組通道 + 軟體陣列直走 X570 匯流排，由 Windows 掌控實體碟與排程。
隨機/小檔寫入	極佳（大幅領先） 1GB DDR3 快取合併隨機寫入，有效消弭尋道延遲。	普通偏弱受限於 Windows 中繼資料寫入機制，無快取防護。	普通偏弱與 HBA 相同，效能受限於軟體排程而非頻寬。
大檔連續讀寫	高條帶化架構純熟，8 碟配置下吞吐飽和穩定。	高多碟併發分流能力強，8 碟配置下傳輸極限高。	高與 HBA 表現相當，8 顆原生 SATA 並行讀寫順暢。
資料自癒與校驗	一般僅依賴傳統 Patrol Read 巡檢壞軌，無檔案級自癒。	優秀（搭配 ReFS）回傳完整 SMART，具備 Checksum 自動修復靜態資料損壞。	優秀（搭配 ReFS）具備 ReFS 檔案自癒與完整原生硬碟健康監控。
PCIe 通道與主機負擔	需佔用 PCIe 插槽插於第二槽（PCIe 3.0 x4 頻寬），但 0 CPU 負擔。	需佔用 PCIe 插槽佔用第二槽，I/O 消耗部分 5600X CPU 與 RAM。	最優（無額外匯流排瓶頸）直走板載 SATA，不搶占 PCIe 插槽。
發熱與電源管理	苛刻高發熱（需暴力扇壓制）。硬碟無法休眠停轉。	中等發熱量略低，硬碟支援原生休眠指令。	極低無擴充卡積熱，支援原生完整閒置休眠停轉。
災難復原與可攜性	極差卡故障時必須尋找相容 LSI 卡方能讀取資料。	極佳資訊寫在硬碟上，硬碟換到任何 Windows 主機均可辨識。	極佳完全不依賴特定介面卡，隨插即用遷移最便利。

四、方案選型建議

1. 選擇「LSI 9271-8i 硬體 RAID 10」：追求高併發 I/O 與效能極限

適合頻繁資料庫交易、虛擬機磁碟讀寫或持續隨機小檔吞吐。在 6 顆 Delta 暴力扇的強效風道下已根除過熱隱憂。（注意：務必搭配 CacheVault/BBU 以安全啟用 Write-Back 回寫快取）。

2. 選擇「X570 原生 SATA + Win11 儲存空間」：最平衡且維護極簡（推薦）

ASUS TUF X570-PRO 本身已提供 8 個原生 SATA 埠，不佔用次要 PCIe 插槽。搭配 ReFS 檔案系統具備 Checksum 自癒防靜態資料損壞能力，硬碟閒置可正常休眠省電，換機復原性極佳。

3. 關於「HBA 直通卡」的定位

本配置下定位較為尷尬。由於板載 SATA 已有 8 個，插 HBA 卡不僅多佔一組 PCIe 插槽並增加廢熱，效能上限依然受限於 Windows 儲存空間演算法，除非板載埠已被其他設備佔滿，否則無須額外添購。

跨代升級有感嗎？LSI MegaRAID 9361-8i vs 9271-8i 深度對比與平台實務解析

在規劃硬體 RAID 儲存陣列時，LSI MegaRAID 9271-8i 與 9361-8i 都是二手市場或自建儲存池常見的經典陣列卡。兩者表面上是 6Gb/s SAS-2 世代與 12Gb/s SAS-3 世代的交替，但在現代主流平台（如 AMD X570、Win11）搭配多顆傳統 SATA 機械硬碟的環境下，這項升級是否真正具備效益？本文將針對硬體規格、平台適配度與實際效能差異進行全盤剖析。

一、核心硬體規格規格差異一覽

規格項目	LSI MegaRAID 9271-8i (SAS-2)	LSI MegaRAID 9361-8i (SAS-3)
主控 ROC 晶片	LSI SAS2208（雙核 800MHz PowerPC）	LSI SAS3108（雙核 1.2GHz PowerPC）算力提升約 50%，重建與校驗吞吐更強
通道協定頻寬	SAS-2 (6Gbps) / SATA 3.0 (6Gbps)	SAS-3 (12Gbps) / SATA 3.0 (6Gbps)
連接線接頭規格	SFF-8087 (Mini-SAS)	SFF-8643 (Mini-SAS HD) 線材規格不相容，需重新配置線材
內建快取記憶體	1GB DDR3-1333	1GB 或 2GB DDR3-1866（常見為 2GB）
斷電保護配件	CacheVault CV02 或 BBU09 電池模組	CacheVault CV03 (LSICVM02)
UEFI / 主機板相容	傳統 Legacy BIOS 為主（現代主機板易有衝突）	完整原生 UEFI 支援（HII 配置介面）
Windows 11 驅動	官方早已停更，需手動掛載舊版 Legacy 驅動	官方與系統維護良好，隨插即用支援度高
發熱量與功耗	約 14～16W（SAS2208 高溫）	約 16～20W（SAS3108 發熱量更大）

二、在特定硬體平台下的真實體驗解析

若將兩張卡置於主流硬體平台（如 AMD Ryzen 5600X / ASUS TUF X570-PRO / 搭配多顆 2TB SATA 傳統硬碟）中實際運行，差異主要體現在以下層面：

1. 傳統硬碟（2TB SATA）讀寫速度：實質無差別

傳統機械硬碟單顆連續讀寫上限約在 150～220 MB/s，遠未觸碰 SATA 6Gbps 通道天花板。9361-8i 的 12Gb/s SAS-3 頻寬優勢在傳統 SATA 硬碟上完全無法體現（除非日後更換為企業級 12G SAS 硬碟或 SATA/SAS SSD 陣列）。

2. 隨機寫入耐受力：2GB 快取版具備優勢

市面上的 9361-8i 多為 2GB DDR3-1866 快取版本（9271-8i 為 1GB DDR3-1333）。在面對持續不斷的隨機小檔寫入或多工併發排程時，翻倍的快取容量與更高頻寬能吸收更大的突發寫入峰值，減少傳統硬碟尋道停頓的時間。

3. 平台插槽頻寬（PCIe 3.0 x4 瓶頸）：兩者表現一致

兩張卡皆為 PCIe 3.0 x8 介面。當主力顯卡佔用 CPU 直出的第一根插槽時，陣列卡插在 X570 第二根長插槽（晶片組提供 PCIe 4.0 x4 通道），實質皆以 PCIe 3.0 x4 速率運作（頻寬上限約 3.9 GB/s）。這對 8 顆傳統硬碟（總連續吞吐約 1.6 GB/s）來說皆能完全餵飽，匯流排不會構成瓶頸。

4. 現代系統穩定性與相容性：9361-8i 壓倒性勝出

這是跨代最核心的實質差異。9271-8i 在現代 AMD AM4/X570 主機板上，容易出現 UEFI 開機自檢凍結、Option ROM 無法正確載入（常需強開 CSM）以及 Win11 驅動維護脫節等問題。9361-8i 原生具備完整的 UEFI 支援與更健全的系統相容性，免去了維護老硬體的排錯困擾。

三、總結與替換注意事項

單論「多顆傳統機械硬碟能跑多快」，9361-8i 與 9271-8i 的傳輸極限幾乎一模一樣。然而，升級 9361-8i 的核心價值在於「買省心與長期穩定度」——避免了現代主機板的 UEFI 相容障礙，並帶來更健全的 Win11 驅動支援與雙倍寫入快取空間。

⚠️ 替換注意事項：9361-8i 採用 Mini-SAS HD (SFF-8643) 介面，原先 9271-8i 使用的 SFF-8087 訊號線無法通用，升級時必須同步更換為 SFF-8643 轉 SATA 傳輸線。

雜項-AI應用 BIOS 設定

2026-09-14T07:09:40.935+08:00

ASUS TUF GAMING X570-PRO (WI-FI) BIOS 設定對照手冊

硬體環境：AMD Ryzen 5 5600X ｜ Intel Arc B580 12GB ｜ Crucial 64GB DDR4-3200 ｜ BIOS 版本 5044[cite: 1]
用途：日後若執行「載入最佳化預設值（Load Optimized Defaults）」時，可直接對照以下 4 大核心分區進行參數還原。

1. 顯示卡效能必備設定（Intel Arc B580）

⚠️ 警告：未開啟此區兩項設定，Intel Arc 顯卡在遊戲與各類運算效能將衰退 20% 以上。

BIOS 路徑 / 選項名稱	目前狀態 (記錄值)	重設後預設值	恢復後應調整為	功能說明
Advanced \ PCI Subsystem Settings `Above 4G Decoding`	Enabled	Disabled / Auto	Enabled	開啟 64 位元位址空間，為 ReBAR 前提條件。
Advanced \ PCI Subsystem Settings `Re-Size BAR Support`	Enabled (尺寸: 16 GB)[cite: 1]	Disabled	Enabled / Auto	啟用 Resizable BAR，CPU 即可直接存取顯卡全域顯存。

2. 記憶體超頻與時序設定（Crucial 64GB 雙通道）

插滿 4 條 16GB[cite: 1]，已套用原廠 XMP 2.0 運作於 3200 MT/s[cite: 1]。

BIOS 路徑 / 選項名稱	目前狀態 (記錄值)	重設後預設值	恢復後應調整為	功能說明
Ai Tweaker `Ai Overclock Tuner`	D.O.C.P. (Profile 1)	Auto	D.O.C.P.	自動套用原廠 XMP 參數檔[cite: 1]。
Ai Tweaker `Memory Frequency`	DDR4-3200 MHz[cite: 1]	Auto (2400/2666)	DDR4-3200MHz	由 D.O.C.P. 自動帶出。
Ai Tweaker `FCLK Frequency`	1600 MHz	Auto	1600 MHz (或 Auto)	保持 Infinity Fabric 與記憶體 1:1 運作以降低延遲。
Ai Tweaker `DRAM Voltage`	1.35 V[cite: 1]	1.20 V[cite: 1]	1.35 V	維持 4 條雙面顆粒穩定供電。
Ai Tweaker \ DRAM Timing Control 主要時序 (Primary Timings)	16-18-18-36[cite: 1]	Auto	16-18-18-36	D.O.C.P. 套用後自動生效。
Ai Tweaker \ DRAM Timing Control `Command Rate (CR)`	1T[cite: 1]	Auto	1T / Auto	維持 1T 延遲最低，若遇極端不穩再放寬至 2T。

3. 開機與安全防護設定（Windows 11 必要條件）

BIOS 路徑 / 選項名稱	目前狀態 (記錄值)	重設後預設值	恢復後應調整為	功能說明
Advanced \ AMD fTPM configuration `Firmware TPM`	Enabled[cite: 1]	Enabled	Enabled	啟用 AMD 處理器內建 TPM 2.0[cite: 1]。
Boot \ Secure Boot `OS Type`	Windows UEFI mode[cite: 1]	Windows UEFI mode	Windows UEFI mode	安全開機（Secure Boot）認證機制[cite: 1]。
Boot \ CSM (Compatibility Support Module) `Launch CSM`	Disabled	Disabled	Disabled	關閉相容模式，確保純 UEFI 開機並支援 ReBAR。

4. CPU 與晶片組設定（Ryzen 5 5600X）

BIOS 路徑 / 選項名稱	目前狀態 (記錄值)	重設後預設值	恢復後應調整為	功能說明
Advanced \ CPU Configuration `SVM Mode`	Enabled[cite: 1]	Disabled	Enabled	CPU 虛擬化技術，WSL2 與 Hyper-V 必備[cite: 1]。
Ai Tweaker \ Precision Boost Overdrive `PBO`	Auto / Enabled[cite: 1]	Auto	Auto	維持 CPU 單核心最高 4.65 GHz 動態超頻[cite: 1]。
Advanced \ SATA Configuration `SATA Mode`	AHCI[cite: 1]	AHCI	AHCI	標準硬碟通訊協定，切勿誤切 RAID。
Advanced \ PCI Subsystem Settings `PCIEX16_1 Link Speed`	Auto / Gen 4[cite: 1]	Auto	Auto / Gen 4	確認以 PCIe 4.0 頻寬與顯卡溝通[cite: 1]。

📌 快速回復操作流程 (SOP)

開機按 Del 進入 BIOS，先按 F5（載入最佳化預設值），按 Enter 確認。
前往 Ai Tweaker：將 Ai Overclock Tuner 改為 D.O.C.P.[cite: 1]。
前往 Advanced \ PCI Subsystem Settings：將 Above 4G Decoding 與 Re-Size BAR Support 皆設為 Enabled。
前往 Advanced \ CPU Configuration：將 SVM Mode 設為 Enabled。
前往 Boot \ CSM：確認 Launch CSM 維持 Disabled。
按 F10 儲存並重新開機進入 Windows。

雜項-AI應用文章整理發布

2026-09-13T09:22:56.184+08:00

一、日常發布新文章 SOP（日常全自動）

日後在現有的分類（Sony、3C、皮革、天干地支等）發布新文章時：

撰寫文章：在 Blogger 編輯器撰寫新貼文。
勾選標籤：在右側邊欄設定好對應標籤（例如：3c類或手工皮件/手縫皮革等）。
發布文章：點擊發布即可。

完成！對應的專題網頁（如 3C 科技或手縫皮革）會自動讀取並顯示該篇新文章與正確連結，您完全不需要做任何額外動作。

二、新增「全新分類」SOP（例如建立「某某某」專題）

若日後新增了前所未有的全新主題大分類（例如「某某某」），只需執行以下 3 個步驟：

步驟 1：建立全新分類的專題網頁

進入 Blogger 後台 -> 「網頁 (Pages)」 -> 「新增網頁」。
標題：輸入該分類名稱（例如：某某某專題目錄）。
切換為「< > HTML 檢視」，複製貼上下方的【專題網頁公版代碼】。
將代碼中標示【...】的地方替換為您的專題名稱與標籤名稱後，點擊「發布」。
點擊該網頁旁的眼睛圖示（查看），複製該網頁的公開網址（例如 [https://silywuns.blogspot.com/p/xxx.html](https://silywuns.blogspot.com/p/xxx.html)）。

【專題網頁 HTML 公版代碼（一鍵複製）】

HTML

<style>

.topic-index {

max-width: 760px;

margin: 0 auto;

font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "PingFang TC", "Microsoft JhengHei", sans-serif;

color: #2c3e50;

line-height: 1.6;

}

.topic-badge {

display: inline-block;

background: #e8f0fe;

color: #1967d2;

padding: 4px 10px;

border-radius: 12px;

font-size: 13px;

font-weight: bold;

margin-bottom: 12px;

}

.topic-desc {

font-size: 14px;

color: #5f6368;

margin-bottom: 20px;

}

/* 獨立系列文導讀卡片（保留原系列文架構） */

.series-card {

background: #f8f9fa;

border: 1px solid #dadce0;

border-left: 4px solid #1a73e8;

border-radius: 6px;

padding: 14px 18px;

margin-bottom: 24px;

}

.series-title {

font-size: 16px;

font-weight: 700;

color: #202124;

margin-bottom: 8px;

}

.series-steps {

margin: 0;

padding-left: 20px;

font-size: 14px;

color: #3c4043;

}

.series-steps li {

margin-bottom: 4px;

}

/* 自動讀取文章列表樣式 */

.auto-section-title {

font-size: 16px;

font-weight: 700;

color: #202124;

padding-bottom: 6px;

margin-bottom: 10px;

border-bottom: 2px solid #e8eaed;

}

.post-list {

list-style: none;

padding: 0;

margin: 0;

background: #ffffff;

border: 1px solid #e0e0e0;

border-radius: 8px;

overflow: hidden;

}

.post-item {

border-bottom: 1px solid #f1f3f4;

}

.post-item:last-child {

border-bottom: none;

}

.post-item a {

display: flex;

justify-content: space-between;

align-items: center;

padding: 12px 16px;

color: #1a73e8;

text-decoration: none;

font-size: 15px;

transition: background-color 0.15s;

}

.post-item a:hover {

background-color: #f1f8ff;

color: #0d47a1;

}

.post-tag {

font-size: 12px;

background: #f1f3f4;

color: #5f6368;

padding: 2px 8px;

border-radius: 4px;

margin-left: 8px;

white-space: nowrap;

}

.loading-hint {

padding: 16px;

text-align: center;

color: #70757a;

font-size: 14px;

}

</style>

<h2>【雜項-AI應用專題全目錄</h2>

收錄關於【雜項-AI應用】領域的心得、技術筆記。

</div>

<div class="series-title">🧭 系列核心導讀</div>

<li><b>單元一</b>：基礎概念與前置說明</li>

<li><b>單元二</b>：核心流程與實作重點</li>

<li><b>單元三</b>：進階應用與疑難排解</li>

</ol>

</div>

<span>📚 本主題所有相關文章（即時自動更新）</span>

</div>

<div id="category-posts-container" class="loading-hint">文章載入中...</div>

</div>

function renderCategoryPosts(json) {

var container = document.getElementById('category-posts-container');

if (!json || !json.feed || !json.feed.entry || json.feed.entry.length === 0) {

container.innerHTML = '<div style="padding:15px;background:#f8f9fa;border-radius:6px;color:#5f6368;">目前該標籤尚無文章，發文時請確認有勾選對應標籤。</div>';

return;

}

var entries = json.feed.entry;

var html = '<ul class="post-list">';

for (var i = 0; i < entries.length; i++) {

var entry = entries[i];

var title = entry.title.$t;

var postUrl = "";

if (entry.link) {

for (var j = 0; j < entry.link.length; j++) {

if (entry.link[j].rel === "alternate") {

postUrl = entry.link[j].href;

break;

}

var pubDate = entry.published ? entry.published.$t.substring(0, 10) : "";

html += '<li class="post-item">';

html += '<a href="' + postUrl + '" target="_blank">';

html += '<span>' + title + '</span>';

if (pubDate) {

html += '<span class="post-tag">' + pubDate + '</span>';

}

html += '</a></li>';

}

html += '</ul>';

container.innerHTML = html;

}

</script>

步驟 2：將新網頁掛入「總覽」樹狀導覽選單

前往 Blogger 後台「版面配置 (Layout)」 -> 開啟 HTML/JavaScript 小工具。
找到 <ul class="first-level"> 清單，在最後一項（天干地支）的下方加入新分類，並將符號維持為「非最後一項用 ├─，最後一項用 └─」：

HTML

<li>

<span class="tree-branch">├─</span> Sony XZ1 (G8342)

</a>

</li>

<li>

<span class="tree-branch">├─</span> 3C 科技

</a>

</li>

<li>

<span class="tree-branch">├─</span> 手縫皮革

</a>

</li>

<li>

<span class="tree-branch">├─</span> 天干地支

</a>

</li>

<li>

<span class="tree-branch">└─</span> 某某某

</a>

</li>

</ul>

儲存小工具，並點選版面配置右下角「儲存圖示（磁碟片）」。

步驟 3：後續日常發布

完成上述一次性設定後，日後只要撰寫屬於「某某某」的新文章並勾選某某某標籤，新文章就會自動出現在該獨立網頁的目錄列表中，完全不需再次修改任何代碼。

Windows DNS生效方式

2026-09-13T06:42:24.777+08:00

# 電腦設定多組 DNS 真的有用嗎？Windows 生效機制與推薦的安全開源 DNS 清單

在設定網路連線時，我們常在 Windows 的網路介面中看到「慣用 DNS 伺服器」與「其他 DNS 伺服器」，甚至在進階設定中還能填入第三組、第四組。

很多人會好奇：**「設定多組 DNS 是同時查詢加速？還是輪流分流？」**

本篇將帶你釐清 Windows DNS 的背後運作邏輯，並整理 4 款兼具安全、隱私與開源可靠的優質 DNS 推薦。

---

## 一、設定多組 DNS 的生效與切換機制

Windows 對多組 DNS 的處理方式是 **「嚴格優先級 + 故障容錯切換（Failover）」**，而不是頻寬合併或負載平衡：

1. **嚴格優先查詢**

系統發起網址解析時，永遠優先詢問清單中的**第一順位（慣用 DNS）**。只要該伺服器能正常回應（即使回應內容是「找不到該網址 NXDOMAIN」），系統就視為解析完成，**絕對不會**再去向第二組查詢。

2. **逾時容錯切換（Timeout Failover）**

只有當第一順位的伺服器發生**連線超時、宕機或斷線**（通常等待約 1 秒無反應）時，Windows 才會自動將請求轉往第二順位（其他 DNS）或後續清單中的伺服器。

3. **暫時記憶狀態**

一旦觸發備援機制切換至第二組 DNS，Windows 會在短時間內持續向該備援伺服器發送請求，經過一段時間後才會再次嘗試回復至第一順位。

> **重點結論：**

> 第二組 DNS 的角色是「備胎」，平時並不會加速你的網路，但在主要伺服器故障時能確保網路不中斷。

---

## 二、推薦 4 款可靠、安全且注重隱私的公共 DNS

若不想使用 ISP 預設的 DNS（容易有劫持廣告或日誌記錄隱憂），推薦以下幾款注重隱私、開源透明且具備資安防禦能力的服務：

| 服務名稱 | 主要 IPv4 / 備用 IPv4 |主要特色與優勢 |

**Quad9** *(最推薦)* | `9.9.9.9` `149.112.112.112` | **非營利安全防護**：瑞士非營利組織營運，符合嚴格隱私法規。整合全球十數家威脅情報，可自動在 DNS 端封鎖釣魚網址與惡意程式，不記錄個人查詢日誌。

**AdGuard DNS** | `94.140.14.14` `94.140.15.15` | **廣告與追蹤攔截**：核心解析代碼開源，預設攔截惡意網站、線上廣告與追蹤器，適合希望改善瀏覽體驗的使用者。 |

**Cloudflare** | `1.1.1.1``1.0.0.1` | **全球極速解析**：全球節點密度極高，查詢延遲最低。承諾 24 小時內清除日誌，支援 DNSSEC。若需內建惡意軟體過濾，可改設為 `1.1.1.2` / `1.0.0.2`。

**Mullvad DNS** | `194.242.2.2``194.242.2.3` | **極致隱私保護**：由知名無日誌 VPN 團隊提供，所有節點皆為 RAM 運行，完全不儲存任何解析紀錄，高度透明可靠。

## 三、最佳配置建議

在配置網路時，建議採用 **「主過濾 + 備極速」** 的雙保險策略：

* **慣用 DNS 伺服器（第一順位）：** 設定具備安全防護或過濾功能的 DNS（例如 **Quad9 `9.9.9.9`** 或 **AdGuard**）。

* **其他 DNS 伺服器（第二順位）：** 設定全球響應速度最快的備援 DNS（例如 **Cloudflare `1.1.1.1`**）。

> **進階提醒：**

> 傳統 UDP 埠號 53 的 DNS 查詢未經加密，容易遭到區域網路或電信商嗅探。若作業系統或瀏覽器支援，建議開啟 **DoH (DNS over HTTPS)** 或 **DoT (DNS over TLS)**，以確保查詢內容全程加密。

未將 Google Public DNS（8.8.8.8 / 8.8.4.4）列入前述推薦清單，主要基於以下四個考量：

非開源透明（Non-Open Source）： Google Public DNS 是專有封閉架構，核心解析程式碼並未開源，外界無法檢驗其底層日誌處理與請求轉發的實際程式行為。
隱私與日誌收集政策（Data Collection）： Google 是全球最大廣告與數據導向公司。其隱私條款載明：
- 用戶的 IP 位址會被記錄並暫存 24 至 48 小時。
- 關聯的城市層級地理位置、AS 號碼與查詢網域名稱會被抽樣留存至永久儲存庫，作為分析與改進用途。
- 相比之下，Quad9 或 Mullvad 等服務提供完全零日誌（No-Log）或極短暫記憶體快取承諾。
缺乏主動資安防禦（No Threat Filtering）： Google Public DNS 是純中立遞迴解析器，不具備阻擋釣魚、惡意軟體或木馬中繼站的功能。若造訪惡意網址，它依然會忠實解析，無法提供像 Quad9 或 AdGuard 的被動安全攔截。
單一巨頭網路壟斷風險（Centralization）： 全球有極大比例的終端設備預設或手動指向 8.8.8.8。從去中心化與網路抗審查角度來看，將整體 DNS 查詢流量分散至非營利組織或隱私導向機構，能降低單一科技巨頭對全球網路解析流量的集中監控。

何時仍適合使用 Google DNS？ 若使用場景是追求極致的全球可用性、穩定的 CDN 本地節點路由（EDNS Client Subnet 支援佳），或單純用於路由器排錯測試，8.8.8.8 依然是可靠的備用工具；但若以「開源、安全防禦、高隱私」為首要評選標準，它並非最優解。

電商商品價格監測與回報規則整合規範

2026-09-12T22:10:30.735+08:00

一、監測標的與動態讀取規範

資料來源：

試算表連結：電商商品價格監測清單範本

動態讀取標的：

每次執行監測與排程觸發時，動態讀取試算表中狀態標註為「正式監測品」之所有項目。
納入未來新增的商品列，嚴禁將商品名單寫死於程式或指令中。

二、核心執行原則

即時最新數據：

每次執行皆必須連線至官方專屬商品詳細頁抓取即時售價。
嚴禁使用伺服器快取、過期存檔或搜尋摘要。

官方專屬詳細頁規範：

所有回報、通知與排程所附之連結，必須嚴格使用官方商品專屬詳細頁（例如 PChome 為 /prod/、Amazon 為 /dp/）。
嚴禁使用 Google 搜尋結果頁或電商站內關鍵字搜尋清單頁。

三、自癒防呆與自主修復機制（Self-Healing）

網址清洗與正規化：

讀取表格時自動檢查「官方專屬商品網址」欄位。
若帶有站內分類篩選、追蹤或搜尋參數（如 PChome 之 ?fq=...、Amazon 之 ?ref=... 等），自動剔除多餘參數，萃取為純淨標準之官方商品詳細頁網址。

自主回寫修復：

若檢測到網址格式有瑕疵或帶有多餘參數，且經清洗後可成功連線，直接更新回 Google 試算表對應儲存格完成自主修復。
於後續回報中明確列出已修正的項目。

四、價格監測與回報排程設定

共配置 3 組定時排程，均內嵌動態讀取與自癒清洗機制：

1.【即時降價警示】

執行頻率：每 8 小時監測一次（Cron：0 */8 * * *）。
觸發機制：比對最新即時售價與目標門檻價格，當任一商品售價低於目標門檻時，立即發送降價警示通知。
通知內容：商品名稱、當前最新售價、目標門檻價格及官方專屬詳細頁連結。

2.【降價總表寄送】

執行頻率：每天約 8:00 AM 與 6:00 PM 各檢查一次（Cron：0 8,18 * * *）。
觸發機制：若有商品達標降價，彙整並發送降價總表；若皆未達標則不需發送總表。
通知內容：平台、商品名稱、目標價格、當前最新售價、差額及官方專屬詳細頁連結。

3.【每日定時價格回報】

執行頻率：每天約 11:00 AM 執行一次（Cron：0 11 * * *）。
價格變動判斷規則（無變化靜默／有變化才回報）：

無變化靜默：若當日（如 Day 2）各商品最新售價與前一日（Day 1）相比均無任何變化（連續多日相同如 Day 2 = Day 3 = Day 4 時），當日保持靜默，不發送回報。
有變化才回報：僅在檢測到商品售價與前次相比出現變化時，才於當日 11:00 AM 發送最新售價清單（例如第 5 天有變化才回報 Day 5；第 6 天無變化不回報，直到第 7 天又有變化才發送 Day 7 回報）。

回報內容：列出所有監測商品之平台、名稱、規格、當日最新售價、目標門檻、價格漲跌狀態及官方專屬詳細頁連結。

Sony Xperia XZ1 (G8342 / poplar_dsds) 系列一擋廣告AdAway 部署

2026-09-11T21:47:35.852+08:00

🛠️ Android 14 (LineageOS 21) + SukiSU 環境下 AdAway 部署與深度調優指南

📌 一、必要運行環境與先決條件

內核級 Root 環境：SukiSU 或 KernelSU。
系統分區限制突破：Android 14 採用唯讀（EROFS/ext4 read-only）機制，AdAway 直寫 hosts 會觸發 Unable to copy hosts file to /system partition 錯誤，必須掛載 Systemless Hosts 模組實現內核層虛擬掛載（OverlayFS/Bind mount）。
運作模式：採用「Root 模式（修改 hosts）」，避免常駐 VPN 模式，達成零背景程序與零額外電量損耗。

📦 二、必備檔案與模組來源

AdAway 客戶端 (F-Droid 開源版)：
🌐 官方網站：https://adaway.org
📦 F-Droid 專案頁：https://f-droid.org/packages/org.adaway/
Systemless Hosts 模組 (KernelSU / APatch / Magisk 通用)：
⚡ gloeyisk 版本（推薦）：https://github.com/gloeyisk/systemless-hosts/releases/tag/17.2
⚡ Zackptg5 通用版：https://github.com/Zackptg5/Systemless-Hosts-KSU-Apatch-Magisk/releases/latest
台灣在地化過濾規則 (Anti-AD AdAway 專用版)：
🔗 規則直連 URL：
https://raw.githubusercontent.com/mrchi/adaway-hosts/main/anti-ad-adaway.txt

⚙️ 三、完整安裝與配置流程

步驟 1：安裝 Systemless Hosts 模組

下載 systemless-hosts.zip 模組套件。
開啟 SukiSU 管理器，切換至「模組 (Modules)」分頁。
選取該 zip 套件進行刷入（或透過電腦 adb push 後手動安裝）。
重新啟動裝置，確認 SukiSU 模組清單中「Systemless Hosts」顯示為啟用狀態。

步驟 2：安裝 AdAway 並指派權限

安裝 AdAway APK 並啟動。
運作模式選取 Root 模式。
在 SukiSU 權限提示視窗中，永久授予 Superuser 權限。
系統通知權限直接設定為「不允許」，無須保持常駐。

步驟 3：導入台灣在地過濾來源

進入 AdAway「來源 (Hosts sources)」分頁，點擊右下角「+」新增來源：
- 名稱：Taiwan
- 網址 (URL)：https://raw.githubusercontent.com/mrchi/adaway-hosts/main/anti-ad-adaway.txt
- Apply redirected hosts：保持「未勾選」。
點擊右上角勾選圖示儲存。

（ADB 填寫命令）：

adb shell input text "https://raw.githubusercontent.com/mrchi/adaway-hosts/main/anti-ad-adaway.txt"

步驟 4：下載、去重並套用規則

返回 AdAway 首頁。
點擊「向下的箭頭（下載並套用）」圖示。
下載與去重完成後，總 Blocked 規則數將超過 100,000 至 150,000 條。
手動關閉並劃掉 AdAway 後台，底層規則持續生效。

💻 四、電腦端 ADB 驗證指令

1. 驗證 anti-AD 規則是否成功寫入底層：

adb shell "grep -m 3 'anti-ad' /system/etc/hosts"

2. 檢查總規則行數（基準值應突破 100,000 行）：

adb shell "wc -l /system/etc/hosts"

🔍 五、AdAway 運作機制與底層行為釋疑

導向位址為 127.0.0.1 而非 0.0.0.0：屬正常行為。兩者皆為本地阻斷手段，請求在本地環回端直接終止，不產生對外流量。
UI 顯示「3 up-to-date sources」而非 4：點擊「檢查更新（旋轉箭頭）」時，AdAway 僅能檢驗具備 E-Tag / Last-Modified 標頭的官方來源；第三方自訂來源會呈現「Unknown update status」，不影響規則合併。
套用方式：變更來源後，需點擊首頁「向下的箭頭（下載並套用）」，非旋轉箭頭。
權限與模組保留原則：
- Systemless Hosts 模組：嚴禁停用或移除。Android 14 依賴此模組於開機時虛擬掛載 hosts；關閉將導致阻斷完全失效。模組屬純內核掛載，無記憶體佔用與電力消耗。
- AdAway Superuser 授權：維持允許即可。未啟動時無背景行程，不產生安全性漏洞或電量消耗。

🌐 六、Cromite 瀏覽器協同配置（隱藏空白框架與防指紋）

AdAway 負責阻斷網域解析，前端由 Cromite 移除空白廣告框，達成互補。

1. 避免繞過底層 Hosts 解析

路徑：Settings ➔ Privacy and security ➔ Use secure DNS
配置：設為 Off (關閉) 或 With your current service provider (使用目前服務供應商)。
原理：手動指定第三方 DoH 會繞過本地 hosts 檔案，造成 AdAway 攔截失效。

2. 廣告過濾引擎 (Adblock Plus settings)

路徑：Settings ➔ Adblock Plus settings
Enable Adblock Plus：On (開啟)，抹除廣告空白框。
Filter lists 規則收斂（針對 Snapdragon 835 最佳化負載）：
- 保留勾選：EasyList、ABP filters、Cromite experimental filters。
- 取消勾選：badmojr/1Hosts、Celenity/BadBlock Lite（屬網域黑名單，與 AdAway 高度重疊，減少記憶體浪費）。
- 自由選用：I don't care about cookies（屏蔽 Cookie 授權彈窗）。
Enable anti-circumvention and snippets：Off (關閉)（避免每個頁面注入額外 JavaScript，確保渲染速度與節能）。
Check for updates now：配置完成後執行一次更新。
Legacy Adblock settings：維持 Filters URL: about:blank 不變。

3. 隱私防追蹤與權限管控

路徑：Settings ➔ Privacy and security
- Fingerprinting protection：On (開啟)。
- WebRTC IP handling policy：調整為 Disable non-proxied UDP（杜絕內網 IP 洩漏）。
- Do Not Track：On (開啟)。
路徑：Settings ➔ Site settings
- Location (位置)：Blocked (封鎖)。
- Notifications (通知)：Blocked (封鎖)。
- Background sync (背景同步)：Blocked (封鎖)。

🔒 七、終端安全收尾

撤銷 Shell Root 權限：進入 SukiSU 管理器 ➔「超級使用者」分頁 ➔ 關閉 com.android.shell（或終端機/ADB Shell）之授權。
關閉偵錯介面：進入「設定」➔「系統」➔「開發人員選項」➔ 關閉「已取得 Root 權限的偵錯」及「USB 偵錯」。

Sony Xperia XZ1 (G8342 / poplar_dsds) 系列一 LineageOS重刷成去Google 服務的開源純 Wi-Fi機

2026-09-11T13:18:23.844+08:00

📱 極簡無 GApps 隱私副機打造計畫：Sony Xperia XZ1 (LineageOS 21 + ReSukiSU)

將剛接手、尚未重刷的空白背景 Android 設備，改造為極度輕量、零 Google 服務（No GApps）、專注開源與隱私導向的純 Wi-Fi 工具機。以下為完整軟硬體規格、刷機準備與軟體分發鏈規劃。

⚙️ 1. 設備型號與目標環境

設備型號：Sony Xperia XZ1 Dual (G8342 / 內部代號 poplar_dsds)
目標系統：LineageOS 21 (Android 14)，完全不刷入 GApps 與 microG。
Root 方案：ReSukiSU 核心鏡像 (ReSukiSU-34781-poplar_dsds，基於 KernelSU 架構)。

🛠️ 2. 重置與刷機事前準備工具 (PC 端與底層)

💻 電腦端工具與驅動：

Android SDK Platform-Tools（Windows 版，含 adb.exe / fastboot.exe）
Sony Mobile / Google USB Driver（確保 Fastboot 模式與 ADB 介面正常辨識）

📦 底層刷機映像檔：

TWRP Recovery (適用於 poplar / poplar_dsds)
LineageOS 21 系統底包 (poplar_dsds)
ReSukiSU 內核鏡像 (ReSukiSU-34781-poplar_dsds.img 或對應 boot.img)

🔧 刷完開機後手機端必設項目（開發人員選項）：

開啟「Android 偵錯 (USB Debugging)」
開啟「已取得 Root 權限的偵錯 (Rooted debugging / ADB Root)」，確保電腦端執行 adb shell "su -c 'id'" 能直接回傳 uid=0(root) groups=0(root) context=u:r:ksu:s0

📦 3. 預備安裝之核心 App 清單與可靠來源

🏪 軟體分發中心：
- Neo Store (現代化 F-Droid 開源應用商店)：GitHub Releases
- Aurora Store (Google Play 匿名客戶端，不安裝大型 OBB 遊戲時保持預設拒絕全局儲存權限)：官方網站
⌨️ 輸入法：
- Sweet-LIME (純本地開源繁體注音/倉頡輸入法，零聯網權限)：F-Droid 或 GitHub Releases
🛡️ 系統級擋廣告：
- AdAway (透過 SukiSU Root 權限直接掛載寫入系統 Hosts 擋廣告)：GitHub Releases
🌐 主力瀏覽器與 WebApp：
- Cromite (隱私強化 Chromium 分支，自帶廣告與追蹤攔截)：GitHub Releases
🔄 跨平台檔案傳輸：
- LocalSend (開源區域網路互傳工具)：GitHub Releases
🗺️ 離線與在線地圖分工策略：
- Cromite 網頁版捷徑 (主力)：使用 https://www.google.com/maps?force=pwa&nogapps=1，免登入即可順暢查看店家資訊、即時路況與 360 度街景，關閉分頁即徹底休眠，零背景常駐、零快取膨脹。
- Organic Maps (備用)：完全離線向量導航，透過 Neo Store 安裝，作為無網路環境下的離線應急。
🤖 AI 助手：
- duck.ai：透過 Cromite 設為首頁，或使用 Neo Store 的 Native Alpha 封裝為獨立視窗（可調整 125%~150% 頁面縮放以解決字體偏小問題）。

💡 協作模式已啟動：後續將採分段流程推進，每次提供單一步驟、操作指令與自檢驗證點，確認回報後再進入下一階段。

Sony Xperia XZ1 (G8342 / poplar_dsds) 系列一Whatsapp驗證的操作(三)

2026-09-10T18:52:19.999+08:00

📱 設備環境與當前技術配置進展 (Environment & Context State)

⚙️ 1. 硬體與作業系統基礎

設備型號：Sony Xperia XZ1 (Snapdragon 835 / MSM8998 / poplar_dsds / G8342)
作業系統：LineageOS 21 (Android 14 / SDK 34)
底層核心：4.4.x Legacy Kernel（舊核心移植至 Android 14 存在嚴重的 Binder 與 SELinux 相容限制）
GApps 套件：MindTheGapps 14.0 (arm64)
Root 方案：SukiSU Ultra (KernelSU 分支，版本 34781)
開機必要條件：開機後 SELinux 必須切換為 Permissive 狀態 (setenforce 0)，否則系統服務會被 SELinux 攔截。

✅ 2. 已確認解決與排除的核心問題 (Resolved Pitfalls)

WhatsApp 啟動卡死（Deadlock / ANR）真兇已鎖定並解決：
- 日誌抓出關鍵報錯：E Parcel : Expecting header 0x53595354 but found 0x2e006d. Mixing copies of libbinder? 以及 LSPosed-Bridge: ... (ZygoteArgsHook) @startViaZygote force mount data: ... com.whatsapp。
- 根因：LSPosed 在 4.4 舊核心上 Hook 進程時引發底層 Binder IPC 通訊死鎖。
- 處置：已將 LSPosed 完全停用 (/data/adb/modules/zygisk_lsposed/disable)，WhatsApp 現已可完全流暢啟動秒開，不再死鎖。
指紋庫真實性已確認：
- 捨棄了三星 S9 等公開黑名單指紋，已成功自一台原廠無 Root 的 Android 9 實體 Sony XZ1 (G8342) 提取乾淨私有指紋並寫入 pif.json 與 pif.prop：
```
MANUFACTURER=Sony
BRAND=Sony
DEVICE=G8342
PRODUCT=G8342
MODEL=G8342
FINGERPRINT=Sony/G8342/G8342:9/47.2.A.11.228/3311891731:user/release-keys
SECURITY_PATCH=2019-09-01
FIRST_API_LEVEL=26
```
系統屬性 (Props) 已完成 Sony 原廠偽裝：
- ro.build.fingerprint 已被覆蓋為官方 Sony 原廠指紋。
- ro.product.model 顯示為 G8342。
- 透過 Windows 推送 Linux 腳本時產生的 CRLF 換行符問題已透過 tr -d "\r" 解決，並成功執行 resetprop -d ro.lineage.version 等清空指令（getprop ro.lineage.version 已為空）。

⚠️ 3. 當前剩餘瓶頸與核心現象 (Current Bottleneck)

現存核心異常現象：

Play Integrity API 檢測：依然維持 「三紅」（BASIC、DEVICE、STRONG 均未通過）。
WhatsApp 啟動行為：介面秒開不再死鎖，但會直接彈出 「You need the official WhatsApp to log in」或 Custom ROM / 未認證設備警告，阻止簡訊註冊。

🔍 原因診斷：

當前安裝的 PlayIntegrityFix (PIF) 在純 Permissive + 4.4 核心環境下，未能成功將偽裝 Hook 進 GMS 的 Key Attestation / DroidGuard 進程。
系統內部依然有其他未被清乾淨的 LineageOS / 自訂 ROM 屬性（例如系統 Settings 資料庫標記、Build Display ID、內核版本字串、或是缺少有效的硬體金鑰偽裝）。

🧭 4. 下一步待排查方向 (Next Troubleshooting Steps)

確認 PIF 是否真正注入 GMS：
抓取 GMS 進程啟動時的日誌，確認 PIF 動態庫是否被 com.google.android.gms.unstable 載入。
檢查系統殘留特徵：
檢查 ro.build.display.id、ro.build.flavor 等是否依然含有 lineage 字樣；檢查內核版本字串 (/proc/version) 是否暴露自編譯核心特徵。
更換相容的 Play Integrity 方案：
評估在不安裝 LSPosed 的前提下，改用原生相容的 PlayIntegrityFix 或配合 boot-time resetprop 腳本進行純屬性偽裝。

Sony Xperia XZ1 (G8342 / poplar_dsds) 系列一Whatsapp驗證的操作(二)

2026-09-10T17:58:54.713+08:00

📱 設備環境與當前完整技術配置 (System State & Migration Context)

⚙️ 1. 硬體與作業系統基礎

設備型號：Sony Xperia XZ1 (Snapdragon 835 / MSM8998 / poplar_dsds / G8342)
作業系統：LineageOS 21 (Android 14 / SDK 34)
底層核心：4.4.x Legacy Kernel（舊核心搭配 Android 14 存在 Binder 與 SELinux 相容限制）
GApps 套件：MindTheGapps 14.0 (arm64)
Root 方案：SukiSU Ultra (KernelSU 分支，版本 34781)
SELinux 運行要求：因舊核心限制，重啟後必須處於 Permissive 狀態 (setenforce 0)，否則 system_server 與動態注入層將被 SELinux 攔截。

🟢 2. 已驗證成功點亮的核心組件 (Baseline Verified)

Zygisk 注入器：
- 使用 Zygisk-Next-1.5.0-843-5217106-release.zip。
- 雙架構注入正常（zygote 64 與 zygote_secondary 32 均顯示綠色 Injected）。
LSPosed 框架：
- 使用 LSPosed-v1.9.3_mod-7244-zygisk-release.zip（寄生管理器模式）。
- 狀態：Activated (綠燈)。
- 關鍵設定：LSPosed 設定中的 Xposed API call protection 必須關閉 (Off)，否則所有模組 IPC 通訊判定皆會失效。
應用隱藏隔離 (HMA)：
- 使用 Hide My Applist (HMA) v3.2（v3.8.3 在此 4.4 核心環境下不穩定）。
- 作用域：勾選 System Framework (系統框架)。
- 狀態：Module Activated [3.2-410] 且 System service running [96] (亮青色正常運作)。
- 模式：黑名單模式，已封鎖 Root、LSPosed、HMA 本體及檢測工具。

🛠️ 3. 已知踩坑與關鍵經驗總結 (Pitfalls Avoided)

HMA 出現「System service not running」的根因與解法：
若設備開機時 SELinux 處於 Enforcing，system_server 早期註冊服務會失敗；即使開機後手動補下 setenforce 0 亦無效。

標準恢復流程（在寬鬆狀態下重啟 Zygote 讓系統層重孵化）：
```
adb shell "su -c 'setenforce 0 && killall -9 zygote zygote64'"
```
Play Integrity「三紅」的排查結論：
- 原先使用的三星 S9 (SM-G9600) 公開指紋已被 Google 伺服器端全面封禁。
- Tricky Store 因無實體 keybox.xml，目前已在 SukiSU 中手動停用 (disable)，避免空白金鑰干擾。
- GSF ID 雖然已手動向 Google 註冊白名單（確保帳號登入與商店正常），但對 Play Integrity 的 MEETS_DEVICE_INTEGRITY 挑戰無直接放行效果。
WhatsApp 原生防護原則：
WhatsApp 嚴禁加入 LSPosed 的作用範圍（防止進程被 Hook 觸發反竄改機制）；僅需透過 HMA 進行環境隱藏。

🔑 4. 當前指紋配置 (Sourced from Genuine Stock XZ1)

為徹底解決被 Google 封殺的問題，已從另一台未 Root 的原廠 Android 9 Sony XZ1 (G8342) 提取未被公開濫用的乾淨官方指紋，並已生成寫入手機的 pif.json：

檔案已放置於 /data/adb/pif.json 與 /data/adb/modules/playintegrityfix/pif.json。
舊版相衝突的 pif.prop 已自手機端刪除。

⏳ 5. 當前停滯點與待執行的下一步 (Current Task)

當前狀態：在推送專屬 pif.json 並執行 killall -9 zygote zygote64 期間，ADB 暫時斷開，導致最後一步清空快取的指令未成功執行 (pm clear com.google.android.gms)。

📋 接續動作：

連接手機執行 adb shell "pm clear com.google.android.gms" 重置快取。
確認 HMA 依然維持 System service running。
打開 Play Integrity API Checker 驗證是否順利通過 MEETS_DEVICE_INTEGRITY (雙綠)。
通過後立即開啟官方原版 WhatsApp 完成簡訊認證與註冊。

Sony Xperia XZ1 (G8342 / poplar_dsds) 系列一Whatsapp驗證的操作(一)

2026-09-10T14:56:07.866+08:00

📱 設備環境與目前已驗證成功的基準配置 (Baseline Working State)

⚙️ 1. 硬體與系統環境

設備型號：Sony Xperia XZ1 (Snapdragon 835 / MSM8998 / poplar_dsds)
作業系統：LineageOS 21 (Android 14 / SDK 34 / 4.4.x Legacy Kernel)
GApps：MindTheGapps 14.0 (arm64)
Root 方案：SukiSU Ultra (KernelSU 分支，核心版本 34781)
SELinux 狀態：開機後需切換為 Permissive (setenforce 0)，避免舊核心阻斷 Android 14 的 Binder 通訊與動態庫加載。

🟢 2. 已驗證成功點亮的核心組件與關鍵設定

Zygisk 注入器：
- 組件：Zygisk-Next-1.5.0-843-5217106-release.zip（安裝後在 SukiSU 模組目錄顯示為 /data/adb/modules/zygisksu/）。
- 狀態：已確認雙架構注入成功（zygote 64、zygote_secondary 32 均顯示綠色 Injected）。
- 注意點：SukiSU Ultra 本身無內建 Zygisk，僅提供隱藏狀態切換，必須依賴獨立模組。
Xposed 框架：
- 版本：LSPosed-v1.9.3_mod-7244-zygisk-release.zip（寄生管理器模式，撥號代碼 *#*#5776733#*#*）。
- 當前狀態：Activated (已啟動，綠燈)。
- 關鍵設定（破局點）：必須在 LSPosed 設定中將 Xposed API call protection 切換為關閉（Off），否則會阻斷模組的動態 IPC，導致所有模組判定失效。
隔離模組 (HMA)：
- 版本：Hide My Applist (HMA) v3.2（實測 v3.8.3 在此 4.4 核心/Android 14 環境下相容性不佳，v3.2 為唯一驗證通過版本）。
- 當前狀態：Working (運作中，綠燈)。
- 作用域 (Scope)：在 LSPosed 中勾選 System Framework (系統框架)。
- 配置模式：採用 Blacklist (黑名單模式)，建立包含 SukiSU、LSPosed、HMA 本身及各類檢測工具的防偵測範本，並套用至目標應用。Excluded system apps 在黑名單下預設反灰放行。

🛠️ 3. 排除的無效路徑與踩坑記錄 (Pitfalls Avoided)

Toybox 相容問題與 service.d 腳本：
曾嘗試手動建立 /data/adb/service.d/run_lspd.sh 來啟動守護進程，但因時序落後於 system_server 啟動，且容易造成重複佔用與死鎖，目前已徹底刪除。現階段由 Zygisk Next 與 SukiSU 標準流程直接拉起。
日誌排查差異：
- Zygisk Next 模組在當前環境下的實際 ID 為 zygisksu，查詢日誌需使用 adb logcat -d -s Zygisk ZygiskSU 或 ZygiskNext。
- Windows CMD 環境不支援原生 Linux grep，需在手機端 adb shell 內執行或使用 Windows 原生 findstr。
WhatsApp 隔離原則：
WhatsApp 嚴禁加入 LSPosed 的作用域，否則進程被直接注入 Xposed 動態庫會觸發客戶端完整性防護；僅需在 HMA 的應用管理中開啟黑名單隱藏。

⏳ 4. 當前待解進展 (Current Progress & Next Step)

當前進度：LSPosed (Activated) 與 HMA 3.2 (Working) 已全部恢復正常運作。
進行中任務：
- 目標為原版官方 WhatsApp 註冊，需通過 Google Play Integrity 驗證（至少 MEETS_BASIC_INTEGRITY 與 MEETS_DEVICE_INTEGRITY）。
- 剛在 SukiSU 中重新啟用 Play Integrity Fix 與 Tricky Store，並已執行 echo "com.google.android.gms" > /data/adb/tricky_store/target.txt。

⚠️ 目前卡點：上述 Zygisk 模組啟用後尚未完整重啟手機載入注入代碼，且重啟後需確保 setenforce 0 生效與清理 GMS 快取，以驗證 Play Integrity 是否由三紅轉為雙綠/三綠。

Sony Xperia XZ1 (G8342 / poplar_dsds) 系列一Whatsapp驗證的事前準備

2026-09-10T14:32:45.423+08:00

📱 Sony Xperia XZ1 (Android 14 / LineageOS 21) WhatsApp 註冊與防偵測環境搭建指南

本文記錄在舊款旗艦機（Sony Xperia XZ1）刷入 Android 14 客製化韌體並完成 GApps 刷入後，同時成功運行 LSPosed、Hide My Applist (HMA) 與 Zygisk 的狀態，避開 Android 14 底層死鎖陷阱，順利通過 WhatsApp 官方嚴格環境驗證的完整部署指南。

⚙️ 設備規格與運行環境

裝置型號：Sony Xperia XZ1 (G8341 / G8342 / SO-01K)
核心晶片：Qualcomm Snapdragon 835 (MSM8998)
作業系統：LineageOS 21 (Android 14 / SDK 34)
底層核心：Linux 4.4.x（舊架構核心適配 Android 14）
Root 方案：SukiSU (KernelSU 分支，基於核心 Hook 實現)
Google 服務包：MindTheGapps 14.0 (arm64)
目標應用：WhatsApp Official (官方原版，嚴格依賴 Play Integrity 與環境純淨度)

🟢 曾成功同時運行的核心運行環境與版本組合

先前系統能成功點亮「Activated」與「Working」的核心配置組合如下：

Zygisk 運行環境：
- 採用相容 SukiSU 的 Zygisk 實作（如 Zygisk Next 或 SukiSU 內建 Zygisk 支援）。
- 狀態：開機自動掛載注入，提供 Zygote 運行時 Hook 基礎。
LSPosed 模組版本：
- 版本號：v1.9.3 (Build 7244) Zygisk 版。
- 運行模式：寄生管理器（Parasitic Manager / 寄生至系統框架），避開獨立 APK 通訊時的 Binder NPE 異常。
- 撥號快捷入口：*#*#5776733#*#*（即 *#*#LSPOS#*#*）。
Hide My Applist (HMA) 版本：
- 版本：HMA v3.2 穩定版。
- 作用域綁定：已在 LSPosed 中同時勾選 System Framework（系統框架 / android） 與 WhatsApp。
安全策略模式 (關鍵)：
- SELinux 狀態：Permissive（寬鬆模式）。
- 必要性：Android 14 的 SELinux 策略會嚴格阻斷未簽名的 Binder 跨進程通訊。先前成功運行時，底層必須維持寬鬆模式，模組與 system_server 才能完成 IPC 掛鉤。

🛠️ 關鍵技術故障與排除經驗（重要避坑點）

Toybox unshare 參數導致開機中斷
- 問題：LineageOS 21 內建的 toybox 指令集不支援 --propagation slave 參數，官方 service.sh 執行時會報錯 Unknown option 'propagation'，導致守護進程開機未能自啟。
- 修復：將模組啟動指令修正為 Toybox 相容的 unshare -m sh -c "..."，或透過 /data/adb/service.d/ 開機腳本延遲啟動。
SELinux Enforcing 覆蓋導致的 Binder NPE
- 問題：系統若在開機時被 SukiSU 自動拉回 Enforcing，LSPosed 守護服務（lspd）向 system_server 註冊時會拿到空的 Binder 物件，觸發 NullPointerException: IBinder.linkToDeath 崩潰，造成 HMA 永遠顯示「Not running」。
- 修復：必須確保系統維持在 Permissive，讓 Binder IPC 正常掛載。
WhatsApp 雙重偵測防禦
- 第一層（Play Integrity）：未通過 MEETS_DEVICE_INTEGRITY 時，WhatsApp 會在驗證碼階段阻擋並提示「需要官方應用」。
- 第二層（套件清單讀取）：若 WhatsApp 透過系統 API 掃描到 SukiSU、Magisk、LSPosed 或各類模組 APK，會在註冊後直接觸發臨時封禁。

📦 必備套件與模組清單

1. Root 與框架模組 (於 SukiSU Manager 刷入)：

Zygisk Next：提供穩定的 Android 14 Zygote 注入環境。
Play Integrity Fix (PIF)：修復 Basic 與 Device Integrity。
LSPosed (v1.9.3-7244 相容版)：支援 Android 14 Binder 架構的 Zygisk 模組包。

2. 應用程式 (APK 安裝)：

Play Integrity API Checker：檢測 Play 服務環境指標。
Hide My Applist (HMA)：套件清單攔截模組。
WhatsApp 官方安裝包：直接自 Google Play Store 下載安裝。

隨興雜記

Waveshare ESP32-P4-WIFI6-Touch-LCD-5

一、硬體規格與實體腳位定義（Hardware Mapping）

二、ESP-IDF v6.1 驅動相容性修補（解開機死白屏關鍵）

三、工程相依配置（main/idf_component.yml）

四、完整且可直接運行的主程式碼（main/hello_world_main.c）

五、編譯與燒錄指令

esp32-s3-lcd2 加ov5640

Home Assistant 音訊雙軌與原音廣播及 AI 對話

Home Assistant 音訊雙軌與原音廣播及 AI 對話完整部署手冊

1. 系統架構理念：什麼是「音訊雙軌」？

2. 核心技術痛點與避坑設計

3. 全新安裝環境需求與事前準備

硬體與網路環境

必要整合組件（Integrations）

4. 步驟一：後端核心配置 (/config/packages/intercom.yaml)

5. 步驟二：前端自訂卡片全碼 (/config/www/intercom/intercom-card.js)

6. 步驟三：儀表板註冊與啟用

7. 操作說明與智慧家庭語音控制實務

模式切換操作

長按判定保護機制

直接用語音控制家電

8. 瀏覽器相容性參考

9. 排查與檢核清單（Troubleshooting）

Dify 整合架構

🎙️ 打造極致 Home Assistant 智能管家：Dify 大腦、Google AI TTS 真人發聲與全域原音對講實戰落地

🏛️ 系統架構與關鍵技術突破

🛠️ 第一步：部署後端單一真理來源配置

📱 第二步：部署前端對講卡片

⚙️ 第三步：儀表板註冊與語音助手管線綁定

📊 驗收指標與客觀數據

🎙️ Home Assistant 2026.10 Dify 雙向中控與 Edge-TTS 曉臻擬真發音

💡 架構升級三大核心亮點

⚙️ 核心後端腳本工程落實（/config/packages/intercom_pkg.yaml）

📊 整合效益量化對比

Home Assistant「原聲廣播與 AI 對話」

[標準工程架構] Home Assistant 原音廣播與 AI 對話：官方多 ID 動態陣列與全生態跨協議同步

核心架構突破與工程原則

步驟一：後端核心配置 (/config/packages/intercom.yaml)

步驟二：前端自訂卡片全碼 (/config/www/intercom/intercom-card.js)

步驟三：儀表板卡片宣告

參考文獻 (References)

一、 核心硬體搭配建議

二、 系統架構流向（雙重路由架構）

三、 ESPHome 固件配置 (以 ESP32-S3 16R8 為基準)

四、 Home Assistant 後端無縫銜接（同時控制設備與問 Google）

雜項-AI應用 Windows 11 系統殘留清理

一、 第三方儲存與介面卡驅動排查（DriverStore）

二、 背景服務檔案有效性排查（Win32_Service）

三、 開機自啟動無效登錄項稽核（Run 鍵值）

四、 底層映像庫快取清理與修復（DISM / SFC）

五、 PowerShell 模組路徑環境變數修復（PSModulePath）

雜項-AI應用 開源DNS

🌐 公共 DNS 解析：主流與進階 DNS 特性全拆解

⚡ 1.1.1.1：極致低延遲與純隱私取向

🛡️ 1.1.1.2：兼顧速度的主動惡意防護（1.1.1.1 for Families）

👨‍👩‍👧‍👦 1.1.1.3：惡意軟體 ＋ 成人內容雙重過濾（家庭防護版）

🏰 9.9.9.9：以資安威脅情報為本的深度防護（Quad9）

🔍 8.8.8.8：高相容性與全球解析覆蓋（Google Public DNS）

🚫 94.140.14.14：系統級廣告與追蹤攔截（AdGuard DNS）

📊 熱門公共 DNS 規格與設定對照表

💡 總結配置建議

雜項-AI應用 Windows 截圖

📌 導言：Windows 截圖到底存去哪了？

📂 方法一：修改「Win + PrintScreen」快捷鍵存檔路徑

✂️ 方法二：修改「剪取工具（Win + Shift + S）」預設儲存位置

⚙️ 深入解析：剪取工具設定選項差異與影響

💡 推薦設定組合

雜項-AI應用 FFmpeg合併影片

📌 實戰情境與核心目標

🛠️ 步驟一：Windows 11 終端機與 FFmpeg 快速部署

📂 精準開啟工作路徑之 PowerShell

⚡ 一行指令安裝 FFmpeg

🔍 過程試誤與實例解說（Troubleshooting）

🚀 FFmpeg 常見指令與效用全覽

💡 最佳實踐指令範例

情境 A：規格完全一致時之「極速無損串接」

情境 B：11 支素材跨長寬／時間戳／去音軌之「多片段 QSV 無縫合併」

寫法 1：PowerShell 陣列組裝（繞過模組限制執行）

寫法 2：單行直接展開指令（最穩健、免任何腳本語言環境）

三、工程相依配置（`main/idf_component.yml`）

四、完整且可直接運行的主程式碼（`main/hello_world_main.c`）

4. 步驟一：後端核心配置 (`/config/packages/intercom.yaml`)

5. 步驟二：前端自訂卡片全碼 (`/config/www/intercom/intercom-card.js`)

一、核心硬體搭配建議

二、系統架構流向（雙重路由架構）

一、第三方儲存與介面卡驅動排查（DriverStore）

二、背景服務檔案有效性排查（Win32_Service）

三、開機自啟動無效登錄項稽核（Run 鍵值）

四、底層映像庫快取清理與修復（DISM / SFC）

雜項-AI應用開源DNS

👨‍👩‍👧‍👦 1.1.1.3：惡意軟體＋成人內容雙重過濾（家庭防護版）

一、左側「系統工具」子項目深度解析 (共 10 項)

二、右側其餘公用程式全項目圖文解析 (排除重疊後共 23 項)

三、給一般用戶的最佳化配置指南

一、系統碟 vs 資料碟的核心限制與運作機制

二、全情境量化效能與特性矩陣評比

三、系統碟與資料碟的最佳搭配策略

雜項-AI應用硬體 RAID vs HBA vs 晶片組直通

一、測試與評估環境配置

二、磁碟配置基準一致化（RAID 10 等效架構）

三、三方軟硬體優劣詳細比較

四、方案選型建議

一、核心硬體規格規格差異一覽

二、在特定硬體平台下的真實體驗解析

三、總結與替換注意事項

雜項-AI應用文章整理發布

一、日常發布新文章 SOP（日常全自動）

二、新增「全新分類」SOP（例如建立「某某某」專題）

二、核心執行原則

三、自癒防呆與自主修復機制（Self-Healing）

四、價格監測與回報排程設定

Sony Xperia XZ1 (G8342 / poplar_dsds) 系列一擋廣告AdAway 部署