倉頡五代升級攻略：Win 10/11 使用者的完美解決方案 (2026 加入一鍵更換、含倉頡三代升級)

作者：吳祐賓

 

 

你使用倉頡打字的時候，有沒有感受到奇怪的味道：

* 晚上的「晚」永遠都排在第二個字

* 「卜竹竹手一」打不出「産」？而「木中中女」打不出「樓」？

 

這代表你也是微軟倉頡四代的受災戶

 

在學習倉頡五代後，一直覺得微軟倉頡和新倉頡的倉頡四代碼表很不友善，一直到最近看到倉頡之友的【替換微軟倉頡碼表，盡享倉頡補完計劃的樂趣】，才知道原來微軟倉頡也可以更新碼表，終於能享受到輸入文字的樂趣了！

 

首先，本篇文章適用範圍：Windows 10 2004 版以上。記得，Windows 更新有時會覆蓋原來倉頡四代的碼表，記得要再回來更新 (2026/03/18 文末追加：一鍵更換 DLC)

 

 

倉頡碼表下載點

 

下載：MSCJData_Cangjie 開頭字樣檔案

例如：

• MSCJData_20251014_Cangjie3_WithExtJ.7z  (三代，到 2025 年 10 月後就沒再更新) 
• MSCJData_Cangjie5_20260207.zip (五代) 

 

 

給倉頡三代的使用者 (習慣打法為：「木中田女」=樓；「戈土心」=應) 

 

倉頡三代補完計劃替換碼表下載地址：https://github.com/Arthurmcarthur/Cangjie3-Plus/releases

 

 

 

 

給倉頡五代的使用者 (習慣打法為：「木中中女」=樓；「戈人土心」=應)

 

倉頡五代補完計劃替換碼表下載地址：https://github.com/Jackchows/Cangjie5/releases

 

 

安裝步驟

 

1. 任務管理器裏結束兩個Microsoft IME進程。
2. 進入 C:\Windows\System32\zh-hk 目錄，刪除
   
   • ChtCangjie.sdc
   • ChtCangjie.spd
   • ChtCangjieExt.lex
   三個文件（刪除前請備份），然後將此處提供的 ChtCangjieExt.lex，複製到該目錄。
   
   
   
   
   
   
   
3. 打開「包含香港增補字符集字元(HKSCS)」開關。
   
   
   

 

 

完成上述步驟後請重新開機，接下來就可以好好體驗倉頡五代所帶來的暢快輸入感！

 

相信更多愛用倉頡的愛好者不滿足於預設的內容。不過因為我個人沒用到進階設定，想要了解更多細節的倉頡愛好者，歡迎再閱讀補完計畫說明檔。

總結

 

使用倉頡補完計畫優點

 

• 字碼編排最貼近符合倉頡歷代改版標準。
• 可以使用倉頡五代輸入方式。 
• 重難(ZX)符號輸入完整呈現。
• 還有微軟倉頡獨門快速鍵 100% 保留，例如：
  Ctrl+, ，
  Ctrl+' 、
  Ctrl+. 。
  Ctrl+; ；
  Ctrl+Shift+; ：
  
  `+ ＋
  `- －
  `/ ／
  `/ 向下鍵 ÷
  `* 向下鍵 ×
  `+ 向下鍵 ±
  
  Ctrl+[ 【 向下鍵 「...
  Ctrl+] 】 向下鍵 」...
  
  Ctrl+Alt+, 叫出特殊符號表 (輸入法整合器) 

 

使用倉頡補完計畫缺點

• Z開頭的符號碼無法使用，只能使用微軟輸入法的符號快速輸入鍵輸入。 (20220904 MSCJData 版本已解決此問題)
• 由於微軟倉頡的排序邏輯寫死在程序中，與碼表沒有關聯。補完計畫在調整此問題已將部首、筆畫、兼容區字符移除，RIME 則無此問題
  

 

整體來說優點大於缺點，能暢快享受輸入文字的樂趣，在這邊分享給大家。

 

2026/03/03 附記：

為什麼我執意要使用微軟輸入法引擎？

1. PIME 容易當機 (Python 不知道為什麼就閃退) 

2. 小小輸入法在 WinUI (Win App 2.0) 是不能用的，它只能在傳統應用程式下使用

3. 其它的自由倉頡、RIME 等輸入法引擎，操作習慣都要重新熟悉，新設備也需要另外安裝。但熟悉微軟輸入法引擎下，新環境我只需要忍耐字碼位置就好，比較不會換了新設備就變智缺化 (笑)

 

 

2026/03/18 追加：

 

上述人工步驟在每次被 Window Update 陰了後，就很懶得重複做，於是我讓 AI 寫了批次檔來做自動更新

 

懶人自動包：倉頡三代使用者

 

你可以將底下的文字內容存成【AutoUpdateCJ3.bat】，並以【系統管理員身份執行】。

由於倉三以 7z 儲存，所以會多一道 7z 程式下載，詳見程式碼説明。
* 我用的是倉五，所以倉三沒有驗證，還請使用後留言跟我説一下是否成功。

@echo off
chcp 65001 >nul
setlocal enabledelayedexpansion
title 倉頡三代碼表自動更新工具 (路徑修正版)

:: 1. 設定變數
set "URL_7Z=https://github.com/Arthurmcarthur/Cangjie3-Plus/releases/download/4.2/MSCJData_20251014_Cangjie3_WithExtJ.7z"
set "TARGET_DIR=%SystemRoot%\System32\zh-hk"
set "TEMP_WORK=%TEMP%\CJ3_Update"
set "FILE_7Z=%TEMP_WORK%\CJ3.7z"
set "EXE_7ZA=%TEMP_WORK%\7za.exe"

:: 這裡指定 7z 內部的精確路徑 (注意 7z 內部路徑斜線方向)
set "INTERNAL_FILE=Windows 10 2004及之后的Windows\ChtCangjieExt.lex"

echo [*] 正在建立工作目錄...
if exist "%TEMP_WORK%" rd /s /q "%TEMP_WORK%"
mkdir "%TEMP_WORK%"

echo [*] 正在下載 7-Zip 獨立版工具...
powershell -Command "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; Invoke-WebRequest -Uri 'https://github.com/mcmilk/7-Zip-zstd/releases/download/v22.01-v1.5.2-R1/7za.exe' -OutFile '%EXE_7ZA%'"

echo [*] 正在下載三代碼表壓縮檔...
powershell -Command "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; Invoke-WebRequest -Uri '%URL_7Z%' -OutFile '%FILE_7Z%'"

if %ERRORLEVEL% NEQ 0 (
    echo [!] 下載失敗，請檢查網路。
    pause
    exit /b
)

echo [*] 正在從 7z 提取指定版本：!INTERNAL_FILE!
:: 直接提取特定路徑檔案，避開遍歷錯誤
"%EXE_7ZA%" e "%FILE_7Z%" -o"%TEMP_WORK%" "%INTERNAL_FILE%" -r -y >nul

set "SOURCE_LEX=%TEMP_WORK%\ChtCangjieExt.lex"

if not exist "%SOURCE_LEX%" (
    echo [!] 提取失敗！找不到指定的路徑檔案。
    echo 預期路徑: %INTERNAL_FILE%
    pause
    exit /b
)

echo [*] 正在關閉輸入法背景進程...
taskkill /F /IM CTFMON.EXE /T >nul 2>&1
taskkill /F /IM MicrosoftIME.exe /T >nul 2>&1

echo [*] 執行權限檢查與備份...
set "DATE_STR=%date:~0,4%%date:~5,2%%date:~8,2%"
set "BACKUP_DIR=%TARGET_DIR%\Backup_CJ3_%DATE_STR%"
mkdir "%BACKUP_DIR%" 2>nul
if %ERRORLEVEL% NEQ 0 (
    echo [!] 權限不足！請右鍵點選「以系統管理員身分執行」。
    pause
    exit /b
)

copy /Y "%TARGET_DIR%\ChtCangjie.sdc" "%BACKUP_DIR%\" >nul
copy /Y "%TARGET_DIR%\ChtCangjie.spd" "%BACKUP_DIR%\" >nul
copy /Y "%TARGET_DIR%\ChtCangjieExt.lex" "%BACKUP_DIR%\" >nul

echo [*] 正在替換系統碼表 (三代 2004+ 版)...
del /F /Q "%TARGET_DIR%\ChtCangjie.sdc"
del /F /Q "%TARGET_DIR%\ChtCangjie.spd"
del /F /Q "%TARGET_DIR%\ChtCangjieExt.lex"
copy /Y "%SOURCE_LEX%" "%TARGET_DIR%\ChtCangjieExt.lex"

echo [*] 寫入 HKSCS 登錄檔設定...
reg add "HKEY_CURRENT_USER\Software\Microsoft\IME\15.0\CHT\Cangjie" /v "Enable HKSCS" /t REG_DWORD /d 1 /f >nul

echo.
echo ==================================================
echo 三代更新完畢 (已選用 Windows 10 2004 及之後版本)
echo 1. 已備份舊檔至 System32\zh-hk\Backup_CJ3_%DATE_STR%
echo 2. 請「立即重新啟動電腦」以讓碼表生效
echo ==================================================
rd /s /q "%TEMP_WORK%"
pause
start ctfmon.exe
exit

 

 

懶人自動包：倉頡五代使用者

 

你可以將底下的文字內容存成【AutoUpdateCJ5.bat】，並以【系統管理員身份執行】。

我自己測試後可正確使用。

@echo off
:: 切換至 UTF-8 碼頁，確保能處理中文字路徑
chcp 65001 >nul
setlocal enabledelayedexpansion
title 倉頡五代碼表自動更新工具 (壓縮檔提取版)

:: 1. 設定變數
set "ZIP_URL=https://github.com/Jackchows/Cangjie5/releases/download/v4.1-beta/MSCJData_Cangjie5_20260207.zip"
set "TARGET_DIR=%SystemRoot%\System32\zh-hk"
set "TEMP_WORK=%TEMP%\CJ5_Update"
set "ZIP_FILE=%TEMP_WORK%\CJ5.zip"

:: 這裡指定壓縮檔內的子路徑（對應您需要的「傳統漢字優先」版本）
set "INTERNAL_PATH=傳統漢字優先（偏好台灣用字習慣）/ChtCangjieExt.lex"

echo [*] 正在建立工作目錄...
if exist "%TEMP_WORK%" rd /s /q "%TEMP_WORK%"
mkdir "%TEMP_WORK%"

echo [*] 正在下載壓縮檔...
powershell -Command "Invoke-WebRequest -Uri '%ZIP_URL%' -OutFile '%ZIP_FILE%'"

if %ERRORLEVEL% NEQ 0 (
    echo [!] 下載失敗，請檢查網路連線。
    pause
    exit /b
)

echo [*] 正在從 ZIP 提取指定碼表 (ChtCangjieExt.lex)...
powershell -Command "Expand-Archive -Path '%ZIP_FILE%' -DestinationPath '%TEMP_WORK%\Extracted' -Force"

echo [*] 正在定位碼表檔案...
:: 直接組合路徑，並將 INTERNAL_PATH 的 / 換成 \
set "TEMP_INTERNAL=%INTERNAL_PATH:/=\%"
set "SOURCE_LEX=%TEMP_WORK%\Extracted\%TEMP_INTERNAL%"

:: 萬一直接指定失敗（通常是編碼導致路徑對不起來），就用 dir 指令掃描含有 "台灣" 的路徑
if not exist "%SOURCE_LEX%" (
    for /f "delims=" %%a in ('dir /s /b "%TEMP_WORK%\Extracted\ChtCangjieExt.lex" ^| findstr "台灣"') do (
        set "SOURCE_LEX=%%a"
    )
)

:: 最後檢查一次變數是否有值
if "%SOURCE_LEX%"=="" (
    echo [!] 找不到檔案，路徑可能有誤。
    pause
    exit /b
)

echo [*] 已定位檔案: "%SOURCE_LEX%"

echo [*] 正在停止 Microsoft IME 進程...
taskkill /F /IM CTFMON.EXE /T >nul 2>&1
taskkill /F /IM MicrosoftIME.exe /T >nul 2>&1

echo [*] 正在備份與清理舊檔案...
set "BACKUP_DIR=%TARGET_DIR%\Backup_%date:~0,4%%date:~5,2%%date:~8,2%"
if not exist "%BACKUP_DIR%" mkdir "%BACKUP_DIR%"
copy /Y "%TARGET_DIR%\ChtCangjie.sdc" "%BACKUP_DIR%\"
copy /Y "%TARGET_DIR%\ChtCangjie.spd" "%BACKUP_DIR%\"
copy /Y "%TARGET_DIR%\ChtCangjieExt.lex" "%BACKUP_DIR%\"

del /F /Q "%TARGET_DIR%\ChtCangjie.sdc"
del /F /Q "%TARGET_DIR%\ChtCangjie.spd"
del /F /Q "%TARGET_DIR%\ChtCangjieExt.lex"

echo [*] 正在部署新碼表...
copy /Y "%SOURCE_LEX%" "%TARGET_DIR%\ChtCangjieExt.lex"

echo [*] 正在自動開啟 HKSCS 選項 (修改登錄檔)...
reg add "HKEY_CURRENT_USER\Software\Microsoft\IME\15.0\CHT\Cangjie" /v "Enable HKSCS" /t REG_DWORD /d 1 /f >nul 2>&1

echo.
echo ==========================================
echo 更新成功！
echo 已提取：傳統漢字優先（偏好台灣用字習慣）
echo 已自動備份至：%BACKUP_DIR%
echo.
echo 請「重新啟動電腦」以生效。
echo ==========================================
rd /s /q "%TEMP_WORK%"
pause
start ctfmon.exe
exit

 

這樣就實現一鍵安裝的倉頡更新啦！

若是哪天又被天殺的微軟「更新」蓋掉，只要再對 bat 按右鍵「以系統管理員身份執行」，3 秒鐘就修復完成！

 

 

2026 年，使用 Intel 迷你 PC 打造 AI 伴侶，使用 SillyTavern + ollama-ipex-llm

 作者：吳祐賓

 

SillyTavern 預載的 Seraphina 角色卡
可供初次載入的聊天對象

 

 

 

2025 年，我寫了篇【告別 AI 訂閱費？我的 Intel 迷你電腦 AI 本機實戰（LM Studio / Ollama / IPEX-LLM）】，在 2026 年來看，實在是太困難了，後來重建的時候發現它變簡單了。

 

一、環境準備

先在 D 槽或不需系統管理員權限的位置，建立一個資料夾， 例如：IPEX_LLAMA

 

二、安裝 SillyTavern

首先要安裝 node.js，安裝 LTS 版本即可

SillyTavern Github

看是要直接從網站打包 zip 下載，還是使用以下指令安裝 SillyTavern 都可以。

git clone https://github.com/SillyTavern/SillyTavern -b release 

 

執行【Start.bat】啟動 SillyTavern。啟動後，瀏覽器會自動開啟 http://127.0.0.1:8000

三、安裝 Ollama-IPEX-LLM

Intel 使用 IPEX-LLM 讓 Arc / Iris XE 顯示晶片能夠儲存並運算 GGUF 模型

附帶一提，

IPEX-LLM專案已於2026年1月28日被Intel官方archive（設為唯讀） 

目前 Ollama-IPEX-LLM 不僅堪用且好用，待日後若使用其它替代方案，會再另寫新文章

 

Ollama-IPEX-LLM Github 

步驟 1: 下載免安裝連結

https://github.com/ipex-llm/ipex-llm/releases/tag/v2.3.0-nightly

下載後解壓縮到一個資料夾中 

步驟 2:  啟動 Ollama Serve

打開命令提示字元（cmd），並輸入指令 cd /d PATH\TO\EXTRACTED\FOLDER 進入解壓縮後的資料夾
在視窗中執行 start-ollama.bat 即可啟動 Ollama Serve

 

四、安裝模型

回到原來命令列，使用以下方式設置模型：

ollama run openhermes:7b-mistral-v2.5-q4_K_M

 

* 只要支援中文的模型，內容都會被和諧，講不出垃圾話，還是原生的英文最沒有拒絕回答的傾向，雖然新版模型文字上很優雅，但 OpenHermes 還是最合我的味道

題外話， NVIDIA RTX 2060 6G 下

經測試，q4_K_M 約 4.13 G，適合 6G 顯卡使用

q5_K_M 約 5.1 G，6G 會稍微吃緊

效能比 3050 8G 要好，當然 8 G 的話能吃的上下文就更多了 

 

五、 完成連接

 

 

 

1. 回到 SillyTavern 瀏覽器頁面。
2. 點擊上方插頭圖示 (API Connections)。
3. API 類型選擇 Ollama。
4. API URL 確認為 http://127.0.0.1:11434。
5. 點擊 Connect，燈號變綠即大功告成！

AI 伴侶角色卡與設定內容未完待續...

 

 

 

 

Horse: DataSnap 平替方案

 作者：吳祐賓

 

 

Horse: DataSnap 平替方案

 

評估：

1. 開放原始碼，不會來陰招，在套件裡安插後門來監視你

2. MIT 授權，避免無謂的糾紛 

 

Horse 借鏡 Express.js 設計概念所開發出的 WebAPI 框架

它基於 Boss 之上

Boss 是受 npm 啟發的 Delphi 套件管理工具，用來輕鬆安裝 Horse 等開源套件，可視為 GetIt 的平替

缺點就是 Boss 這名字很大眾，很難找到相關資料

 

Boss 安裝

Boss 安裝檔

https://github.com/hashload/boss/releases 

操作環境，應是泛 Win32 平台都可使用，目前在 Windows Server 2012 下仍能執行 (v3)

Boss Github

https://github.com/HashLoad/boss

 

Horse 安裝 

https://github.com/HashLoad/horse

boss install horse

 

如果不想用 Boss，怎麼安裝 Horse？

官方推薦用 Boss，因為最方便，但有簡單的手動方式：

1. 去 Horse 的 GitHub 頁面：https://github.com/HashLoad/horse
2. 點擊綠色的 Code 按鈕 → Download ZIP，下載整個專案壓縮檔。
3. 解壓縮後，找到裡面的 src 資料夾（這就是 Horse 的核心原始碼）。
4. 在你的 Delphi 專案中：
   • 把 src 資料夾複製到你的專案目錄下（或任何你喜歡的位置）。
   • 在 Delphi IDE 裡：Project → Options → Delphi Options → Library → Library path，加入這個 src 資料夾的完整路徑。
5. 之後在你的 .dpr 或 unit 裡直接 uses Horse; 就能用了。

（官方文件也提到過類似方式：「Download the latest version of Horse and include the src/ folder in your project's Library Path.」）

 

Horse 專案超簡單就能用 Delphi IDE 的 F9 直接執行和 debug！因為它本質上是個 Console Application（控制台程式），啟動後會開一個 HTTP server，一直運行聽取請求（不會自動結束）。

步驟-by-步驟教學（從零開始）：

1. 在 Delphi IDE 建立新專案：

   • File → New → Other → Console Application（選擇 Delphi 的 Console Application）。
   • 存檔到你喜歡的資料夾，例如 Project1.dpr。

2. 加入 Horse 的 src 路徑（如果你是手動安裝）：

   • Project → Options → Delphi Options → Library → Library path。
   • 加入你下載的 Horse src 資料夾完整路徑（例如 C:\Horse\src）。
   • OK 存檔。

3. 寫程式碼（取代預設的 .dpr 內容）： 把下面這段最簡單的範例貼到你的 .dpr 檔案（整個取代原本的 begin..end）：

   pascal

   uses
     Horse;  // 這行很重要
   
   begin
     // 註冊一個路由：GET /ping 回傳 pong
     THorse.Get('/ping',
       procedure(Req: THorseRequest; Res: THorseResponse)
       begin
         Res.Send('pong');
       end);
   
     // 啟動 server，監聽 9000 port
     THorse.Listen(9000);
   
     // 這行會讓程式保持運行（可選，但建議加）
     Writeln('Server is running on http://localhost:9000');
     Writeln('Press ENTER to stop...');
     Readln;
   end.

 

執行（F9）：

• 直接按 F9（或 Run → Run）。
• 程式會編譯，然後在 IDE 的輸出視窗顯示：

Server is running on http://localhost:9000
Press ENTER to stop... 

 

Debug（除錯）怎麼做？

完全跟一般 Delphi 程式一樣，超方便：

• 在程式碼上設斷點（點左邊灰色區域，紅點出現）。
  • 例如在 Res.Send('pong'); 這行設斷點。
• 按 F9 啟動。
• 用瀏覽器發請求到 /ping。
• 當請求進來觸發那段程式碼時，IDE 會自動停在斷點！
• 你可以用 F8（step over）、F7（step into）、觀察變數（Watch）、Req.Query、Req.Body 等。
• 因為是多執行緒（Horse 用 Indy 或其他處理請求），但 Delphi IDE 對多執行緒 debug 支援很好，斷點一樣會命中。

小Tips：

• 如果你用 Boss 安裝，會自動把 src 加到專案，步驟更少。
• 想加 JSON、CORS 等功能？之後用 Boss 安裝 middleware（如 boss install horse-jhonson）。
• 正式部署時，可以編譯成 Windows Service 或 Linux daemon，但開發時 Console 就夠了。

 

Horse 專案**完全可以編譯成 Windows Service** 來正式部署！這樣就能在背景自動運行、不依賴使用者登入、開機自啟動，非常適合生產環境的 Web API 服務。

### 步驟-by-步驟教學：

1. **建立 Service 專案**：
   - 在 Delphi IDE：File → New → Other → Delphi Projects → Service Application。
   - 這會產生一個新的專案，包含一個 TService 類別（例如 MyService: TService）。
   - 存檔專案（例如 HorseService.dproj）。

2. **加入 Horse 原始碼**：
   - 同樣手動或用 Boss 安裝 Horse 的 src 資料夾。
   - Project → Options → Library path → 加入 Horse src 路徑。

3. **寫程式碼**（在 Service 的 unit 中）：
   - 在你的 Service unit（例如 Unit1.pas）加入 `uses Horse;`。
   - 把原本 Console 的程式碼移到 Service 的事件裡：
     ```pascal
     unit Unit1;

     interface

     uses
       Winapi.Windows, Winapi.Messages, System.SysUtils, System.Classes,
       Vcl.Graphics, Vcl.Controls, Vcl.SvcMgr, Vcl.Dialogs, Horse;

     type
       TMyHorseService = class(TService)
         procedure ServiceCreate(Sender: TObject);
         procedure ServiceStart(Sender: TService; var Started: Boolean);
         procedure ServiceStop(Sender: TService; var Stopped: Boolean);
         procedure ServiceDestroy(Sender: TObject);
       private
         { Private declarations }
       public
         function GetServiceController: TServiceController; override;
         { Public declarations }
       end;

     var
       MyHorseService: TMyHorseService;

     implementation

     {$R *.dfm}

     procedure ServiceController(CtrlCode: DWord); stdcall;
     begin
       MyHorseService.Controller(CtrlCode);
     end;

     function TMyHorseService.GetServiceController: TServiceController;
     begin
       Result := ServiceController;
     end;

     procedure TMyHorseService.ServiceCreate(Sender: TObject);
     begin
       // 可在這裡初始化一些東西
     end;

     procedure TMyHorseService.ServiceStart(Sender: TService; var Started: Boolean);
     begin
       // 註冊路由
       THorse.Get('/ping',
         procedure(Req: THorseRequest; Res: THorseResponse)
         begin
           Res.Send('pong');
         end);

       // 啟動 Horse server（非阻塞）
       THorse.Listen(9000);  // 或你想要的 port

       Started := True;  // 告訴 Windows 服務已啟動
     end;

     procedure TMyHorseService.ServiceStop(Sender: TService; var Stopped: Boolean);
     begin
       // 停止 Horse server（Horse 較新版本有 Stop 方法，若沒有可忽略或用其他方式）
       // THorse.Stop;  // 如果你的 Horse 版本支援
       Stopped := True;
     end;

     procedure TMyHorseService.ServiceDestroy(Sender: TObject);
     begin
       // 清理資源
     end;

     end.
     ```

4. **編譯與安裝 Service**：
   - 編譯專案（Ctrl+F9），產生 .exe 檔（例如 HorseService.exe）。
   - 以**管理員權限**開啟命令提示字元，執行：
     ```
     HorseService.exe /install
     ```
     - 這會自動註冊到 Windows Services（用 sc.exe 或內建方式）。
   - 去「服務」管理員（services.msc），找到你的服務（名稱預設是專案名，可在 TService 的 Name/Description 屬性改）。
   - 設定啟動類型為「自動」，然後啟動服務。

5. **卸載 Service**（如果需要）：
   ```
   HorseService.exe /uninstall
   ```

### 注意事項：
- **不要用 Writeln 或 Readln**：Service 沒有 console，這些會出錯（有些人遇過 I/O error 105，就是因為這個）。改用 TService.LogMessage('Server running...') 記錄到 Event Log。
- **多執行緒安全**：Horse 本身多執行緒，Service 也支援，沒問題。
- **Debug**：開發時，先用 Console 版測試。正式 debug Service 可以用 Attach to Process（Run → Attach to Process），或加參數讓它跑成 Console（進階技巧）。
- **推薦工具**：HashLoad 有個 horse-wizard（GitHub 上），可以直接產生 WinService 版的 Horse 專案模板，超方便！搜尋 "HashLoad horse-wizard" 下載用。
- **防火牆**：記得開 port（例如 9000）。

這樣部署後，你的 Horse API 就變成真正的背景服務了，穩定又專業！如果遇到特定錯誤（如 Access Violation），通常是 DataModule 初始化順序問題，把 Create 移到 ServiceStart 裡試試。

<未完待續> 

EXARC (Express ARC JS Starter Kit) 為 Delphi 開發者打造的現代化 Web 開發框架

EXARC (Express ARC JS Starter Kit)
-- 為 Delphi 開發者打造的現代化 Web 開發框架

🎯 給熟悉 DataSnap、MVC、WebBroker 的您

如果您曾經使用過 Delphi DataSnap REST 的代理自動生成功能，或是體驗過 Delphi MVC Web Framework 的路由機制，那麼 EXARC 將會讓您感到非常熟悉。它將 Delphi 開發中最優雅的概念帶到了現代 JavaScript 生態系統中。

---

🔄 從 Delphi 到 JavaScript：相似的開發哲學

DataSnap REST 的現代化演進

還記得 Delphi DataSnap 如何自動為您的伺服器方法生成用戶端代理嗎？EXARC 採用了相同的理念：

Delphi DataSnap	EXARC	相似度
伺服器方法定義	Express 路由定義	✅ 相同概念
自動生成用戶端代理	自動生成 apiProxy.js	✅ 相同機制
型別安全的呼叫	語義化的 async 呼叫	✅ 相同體驗
內建認證支援	JWT 認證中介軟體	✅ 相同功能

// Delphi DataSnap 伺服器方法
function TServerMethods.EchoMessage(const AMessage: string): string;
begin
  Result := 'Echo: ' + AMessage;
end;

// 自動生成的用戶端代理呼叫
ClientModule.ServerMethods.EchoMessage('Hello');

// EXARC Express 路由定義
app.get('/api/echomsg/:msg', (req, res) => {
    res.json({ echoed: req.params.msg });
});

// 自動生成的前端代理呼叫
await apiProxy.echomsg('Hello');

MVC Web Framework 的路由理念

熟悉 Delphi MVC 的路由屬性嗎？EXARC 採用了相似但更簡潔的方式：

// Delphi MVC Controller
[MVCPath('/api/users')]
[MVCHTTPMethod([httpGET])]
function GetUserList: TObjectList<TUser>;

// EXARC Express 路由
app.get('/api/users/list', (req, res) => {
    res.json(getUserList());
});
// 自動生成: apiProxy.usersList()

---

💡 為什麼 Delphi 開發者會愛上 EXARC？

1. 熟悉的開發模式

您已經習慣了 Delphi 的「定義一次，處處可用」理念：

• DataSnap: 定義伺服器方法 → 自動生成用戶端代理
• EXARC: 定義 Express 路由 → 自動生成前端代理
• 結果: 相同的開發體驗，但擁抱現代 Web 技術

2. 強型別思維的延續

雖然是 JavaScript，但 EXARC 透過 JSDoc 和自動生成機制，提供了接近強型別的開發體驗：

/**
 * 建立使用者資料
 * @param {Object} userData - 使用者資訊
 * @param {string} userData.name - 使用者姓名
 * @param {string} userData.email - 電子郵件
 * @returns {Promise<Object>} 建立結果
 */
app.post('/api/users/create', (req, res) => {
    // 業務邏輯實作
});

// 前端呼叫時會有清楚的參數提示
await apiProxy.usersCreate({
    name: "John Doe",
    email: "john@example.com"
});

3. 內建的測試和除錯工具

就像 Delphi IDE 的整合除錯環境，EXARC 提供內建的 API 測試器：

• 自動掃描所有 API 端點（類似 DataSnap 的伺服器方法瀏覽器）
• 即時參數輸入和測試（類似 Delphi 的 Method Invoker）
• 即時回應查看（類似 REST Debugger）

---

🚀 技術架構對比

從 WebBroker 到 Express.js

概念	Delphi WebBroker	EXARC Express.js
HTTP 伺服器	TWebModule + HTTP.sys	Node.js + Express
路由處理	WebActionItem	app.get/post/put/delete
中介軟體	WebModule Events	Express Middleware
靜態檔案	DocumentRoot	express.static
會話管理	TWebSession	JWT Token

從 DataSnap 到 EXARC

// Delphi DataSnap 架構
TServerContainer -> TDSServer -> TServerMethods
                              -> Auto-generated Client Proxy

// EXARC 架構
Express Router -> API Routes -> Auto-generated apiProxy.js
                            -> Dynamic API Invoker

---

🔧 實際開發對比

Delphi DataSnap 開發流程

// 1. 定義伺服器方法
function TServerMethods.GetCustomerOrders(CustomerID: Integer): TJSONArray;
begin
  // 實作業務邏輯
end;

// 2. 編譯專案，自動更新用戶端代理

// 3. 用戶端呼叫
ClientModule.ServerMethods.GetCustomerOrders(123);

EXARC 開發流程

// 1. 定義 Express 路由
app.get('/api/customers/:id/orders', (req, res) => {
    const customerId = req.params.id;
    // 實作業務邏輯
    res.json(getCustomerOrders(customerId));
});

// 2. 儲存檔案，自動更新前端代理

// 3. 前端呼叫
await apiProxy.customersOrders(123);

相似度：95%！

---

🌟 EXARC 相比 Delphi 的優勢

1. 現代化的生態系統

• 豐富的套件庫: npm 生態系統 vs GetIt Package Manager
• 跨平台部署: Linux/Windows/macOS vs Windows 主要
• 容器化支援: Docker 原生支援 vs 需要額外配置

2. 前端技術選擇自由

• 多框架支援: React, Vue, 原生 JS vs 主要是 Delphi 用戶端
• 響應式設計: 內建 Mobile-first 設計
• 現代 UI 框架: Tailwind, Bootstrap 等

3. 開發工具整合

• VS Code 完整支援: IntelliSense, 除錯, Git 整合
• 熱重載: 程式碼變更即時生效
• DevTools: 強大的瀏覽器除錯工具

4. 部署和維運

• 雲端原生: 天然支援 AWS, Azure, GCP
• CI/CD 整合: GitHub Actions, GitLab CI 等
• 監控和日誌: 豐富的 APM 工具

---

🎯 遷移建議：從 Delphi 到 EXARC

階段一：概念對應

• DataSnap 伺服器方法 → Express 路由
• ClientDataSet → JSON 資料處理
• WebBroker Actions → Express 中介軟體
• ISAPI/CGI → Node.js HTTP Server

階段二：逐步遷移

1. API 層先行: 將 DataSnap REST 服務改寫為 Express API
2. 保持資料庫: 繼續使用現有的 SQL Server/Oracle/FireDAC
3. 前端現代化: 逐步將 VCL/FMX 用戶端改為 Web 介面
4. 認證統一: 從 Session-based 遷移到 JWT

階段三：現代化升級

• 導入 TypeScript (可選)
• 整合現代 CSS 框架
• 實作 PWA 功能
• 加入自動化測試

---

📊 成本效益分析

Delphi 開發 vs EXARC 開發

項目	Delphi 生態	EXARC + Node.js
授權成本	Delphi Professional: $1,500+	完全免費
伺服器授權	Windows Server 授權	Linux 免費
部署成本	IIS + Windows	Docker + 雲端 (更便宜)
維護成本	需要 Delphi 專家	JavaScript 開發者更易找
學習曲線	對 Delphi 開發者: 低	中等 (但概念相似)

---

🛠️ 實作範例：從 DataSnap 到 EXARC

Delphi DataSnap 範例

unit ServerMethodsUnit;

interface

uses
  SysUtils, Classes, DSServer, DSAuth, DataSnap.DSProviderDataModuleAdapter,
  Datasnap.DSClientMetadata, Data.FireDACJSONReflect, Data.DB;

type
  TServerMethods = class(TDSServerModule)
  private
  public
    function GetUserProfile(UserID: Integer): TJSONObject;
    function UpdateUserProfile(UserID: Integer; ProfileData: TJSONObject): Boolean;
  end;

implementation

function TServerMethods.GetUserProfile(UserID: Integer): TJSONObject;
begin
  // 實作取得使用者資料邏輯
  Result := TJSONObject.Create;
  Result.AddPair('id', TJSONNumber.Create(UserID));
  Result.AddPair('name', 'John Doe');
end;

function TServerMethods.UpdateUserProfile(UserID: Integer; ProfileData: TJSONObject): Boolean;
begin
  // 實作更新使用者資料邏輯
  Result := True;
end;

EXARC 對應實作

// server.js
const express = require('express');
const app = express();

app.use(express.json());

// 對應 TServerMethods.GetUserProfile
app.get('/api/users/:id/profile', (req, res) => {
    const userId = parseInt(req.params.id);
    
    // 實作取得使用者資料邏輯
    const userProfile = {
        id: userId,
        name: 'John Doe',
        email: 'john@example.com'
    };
    
    res.json(userProfile);
});

// 對應 TServerMethods.UpdateUserProfile
app.put('/api/users/:id/profile', (req, res) => {
    const userId = parseInt(req.params.id);
    const profileData = req.body;
    
    // 實作更新使用者資料邏輯
    const success = updateUserProfile(userId, profileData);
    
    res.json({ success: success });
});

app.listen(3000);

自動生成的前端代理

// apiProxy.js (自動生成)
export const apiProxy = {
    /**
     * 取得使用者資料
     * @param {number} id - 使用者 ID
     * @returns {Promise<Object>} 使用者資料
     */
    usersProfile: async (id) => {
        return handleApiCall(api.get, `users/${id}/profile`);
    },

    /**
     * 更新使用者資料
     * @param {number} id - 使用者 ID  
     * @param {Object} data - 更新資料
     * @returns {Promise<Object>} 更新結果
     */
    usersProfileUpdate: async (id, data) => {
        return handleApiCall(api.put, `users/${id}/profile`, data);
    }
};

// 使用方式 (類似 DataSnap 用戶端代理)
const profile = await apiProxy.usersProfile(123);
const result = await apiProxy.usersProfileUpdate(123, { name: 'Jane Doe' });

---

🎉 結論：擁抱現代化，保持熟悉感

EXARC 為 Delphi 開發者提供了一條平滑的現代化遷移路徑：

✅ 保留 Delphi 的優雅設計理念 - 自動化、強型別思維、整合開發體驗
✅ 擁抱現代 Web 技術 - JavaScript 生態、雲端原生、跨平台部署
✅ 降低學習成本 - 相似的概念映射、熟悉的開發流程
✅ 提升競爭力 - 更低的成本、更大的人才庫、更好的擴展性

立即開始您的現代化之旅

# 30 秒體驗 EXARC
npx degit Eden5Wu/EXARC my-modern-api
cd my-modern-api && npm install && npm run dev

# 訪問 http://localhost:8893/apiProxyInvoker.html
# 體驗類似 DataSnap Method Invoker 的測試工具！

從 Delphi 到 EXARC，不是放棄過去，而是站在巨人的肩膀上擁抱未來。 🚀

---

📞 技術支援

• GitHub: Eden5Wu/EXARC
• 遷移指南: [專為 Delphi 開發者準備的詳細文檔]
• 範例專案: [DataSnap 到 EXARC 的完整遷移範例]

讓我們一起將 Delphi 的優雅帶入現代 Web 開發！ 💪

EXARC (Express ARC JS Starter Kit) 革命性的前後端開發框架

 EXARC (Express ARC JS Starter Kit) 革命性的前後端開發框架

🚀 告別重複工作，專注核心價值

EXARC 是一個基於 Express.js 的輕量級後端開發模板，專為追求高效開發體驗的團隊而設計。它徹底改變了傳統的前後端開發模式，讓您只需專注於業務邏輯的實現，其餘一切交給自動化處理。

---

💡 核心理念：後端驅動，前端自動同步

以後端為唯一真實來源 (Backend as the Single Source of Truth)

傳統開發中，前後端 API 介面需要分別維護，容易造成不同步問題。EXARC 創新地將這個流程完全自動化：

• ✅ 後端定義路由 → 前端 API 代理自動生成
• ✅ API 文件自動更新 → 測試工具即時同步
• ✅ 零手動配置 → 開箱即用的完整解決方案

---

🎯 解決的核心痛點

1. 前後端介面不同步

• ❌ 傳統方式：手動維護前端 fetch/axios 請求，容易與後端脫節
• ✅ EXARC 方式：後端路由變更，前端代理自動更新

2. 重複的樣板程式碼

• ❌ 傳統方式：每個 API 都需要寫相似的請求處理邏輯
• ✅ EXARC 方式：一次定義，處處可用的語義化 API 呼叫

3. API 測試與文件維護

• ❌ 傳統方式：需要額外工具如 Postman，文件容易過時
• ✅ EXARC 方式：內建動態 API 調用器，測試與文件自動同步

4. 認證機制複雜性

• ❌ 傳統方式：前後端認證邏輯分散，難以維護
• ✅ EXARC 方式：統一的 JWT 認證流程，可一鍵切換啟用/停用

---

⚡ 核心特性

🔄 自動化 API 代理生成

// 後端：只需定義 Express 路由
app.get('/api/users/profile', (req, res) => {
    res.json({ user: 'profile data' });
});

// 前端：自動生成語義化呼叫
const profile = await apiProxy.usersProfile();

🧪 動態 API 測試器

• 自動讀取後端路由，生成互動式測試介面
• 支援 JSDoc 註解解析，提供完整的參數說明
• 智能判斷輸入類型（JSON/純文字），零配置使用

🔐 彈性認證系統

• 基於 JWT 的無狀態認證
• 環境變數一鍵切換認證開關
• 前後端獨立控制登入 UI 顯示

🌐 多框架支援

內建完整的範例，支援主流前端技術：

• 原生 JavaScript - 輕量級實作
• React - 現代組件化開發
• Vue.js - 漸進式框架整合
• jQuery Mobile - 移動端快速原型

---

📈 開發效率提升

傳統開發流程 vs EXARC 流程

階段	傳統方式	EXARC 方式	時間節省
API 定義	後端路由 + 前端請求函式	僅需後端路由	50%
介面同步	手動更新前端代碼	自動生成同步	90%
API 測試	配置 Postman 等工具	內建動態測試器	70%
文件維護	手動更新 API 文件	JSDoc 自動解析	80%

實際開發體驗

// 🎯 EXARC：四步驟完成 API 開發

// 1. 後端定義路由（唯一需要手寫的部分）
app.post('/api/orders/create', (req, res) => {
    const order = createOrder(req.body);
    res.json({ success: true, order });
});

// 2. 自動生成前端代理（無需任何操作）
// ✨ 伺服器重啟時自動更新 apiProxy.js

// 3. 前端直接使用（語義化呼叫）
const result = await apiProxy.ordersCreate(orderData);

// 4. 動態測試器自動更新（無需任何操作）
// ✨ 訪問 /apiProxyInvoker.html 即可測試

---

🏗️ 架構優勢

智能文件解析

• 自動掃描 Express 路由堆疊
• 將 REST 路徑轉換為駝峰式函式名稱
• JSDoc 註解自動提取並生成文件

零配置哲學

• 使用 degit 一鍵複製專案模板
• npm run dev 即可啟動完整開發環境
• 內建 nodemon 配置，避免無限重啟問題

生產就緒

• 環境變數管理
• 嚴格的 JWT 認證中介軟體
• 完整的錯誤處理機制

---

🎨 適用場景

完美適合

• 快速原型開發 - 將想法迅速轉化為可用產品
• 中小型專案 - 需要高效開發流程的商業應用
• API 優先設計 - 重視前後端分離的現代化項目
• 團隊協作 - 需要統一開發規範的多人項目

技術團隊

• 全端工程師 - 一人完成前後端開發
• 前端開發者 - 快速建立後端 API 支援
• 後端開發者 - 無需關心前端 API 調用細節
• 專案經理 - 需要快速交付 MVP 的敏捷團隊

---

🚀 快速開始

30 秒啟動專案

# 1. 複製模板
npx degit Eden5Wu/EXARC my-awesome-project

# 2. 安裝依賴
cd my-awesome-project && npm install

# 3. 啟動開發
npm run dev

# 4. 開始編碼！
# 後端：編輯 server.js 新增 API
# 前端：直接使用 apiProxy.methodName()
# 測試：訪問 http://localhost:8893/apiProxyInvoker.html

---

📊 為什麼選擇 EXARC？

對比其他解決方案

特性	EXARC	傳統 Express	Next.js API	tRPC
學習曲線	⭐⭐	⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐⭐
自動化程度	⭐⭐⭐⭐⭐	⭐	⭐⭐	⭐⭐⭐⭐
開發速度	⭐⭐⭐⭐⭐	⭐⭐	⭐⭐⭐	⭐⭐⭐
靈活性	⭐⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐	⭐⭐⭐
內建測試	⭐⭐⭐⭐⭐	⭐	⭐	⭐⭐

---

🎯 結語

EXARC 不只是一個開發框架，更是一種開發哲學的體現。

它相信開發者的時間應該花在創造價值上，而不是重複性的基礎設施建設。通過極致的自動化和智能化，EXARC 讓您能夠：

• 🎯 專注業務邏輯 - 將創意直接轉化為代碼
• ⚡ 提升開發效率 - 用更少的時間交付更多價值
• 🛡️ 降低維護成本 - 自動同步機制避免技術債務
• 🚀 加速產品迭代 - 從想法到部署的最短路徑

選擇 EXARC，選擇更智慧的開發方式。

---

📞 立即開始

• GitHub: Eden5Wu/EXARC
• 快速開始: npx degit Eden5Wu/EXARC your-project-name
• 授權: MIT License
• 支援: Issues & Discussions on GitHub

讓 EXARC 成為您下一個專案的加速器！ 🚀

Deno 安裝篇

作者：吳祐賓 

 

 

 

Deno 開發的後端專案不會讓我再看到 node_modules 目錄，這是我超想使用 Deno 的理由

 

安裝方便更是讓我在業餘時間毫無壓力地學習它。 

 

 

安裝

Deno 能夠在 macOS、Linux 和 Windows 上運行。Deno 是一個單獨的可執行檔案，它沒有額外的依賴。 

 

下載

官方推薦使用指令碼操作

 

使用 Shell (macOS 和 Linux):

curl -fsSL https://deno.land/x/install/install.sh | sh

使用 PowerShell (Windows):

iwr https://deno.land/x/install/install.ps1 -useb | iex 

 

手動安裝

Deno 也可以手動安裝，只需從 github.com/denoland/deno/releases 下載一個 zip 檔案。它僅包含一個單獨的可執行檔案。在 macOS 和 Linux 上，您需要為它設定執行權限。 

 

 

手動安裝後設定環境變數

如果你不想每次開機都自動常駐，也可以在需要使用 Deno 時，使用指令將 Deno 執行檔所在路徑加入環境變數：

 

# Dos command 

SET PATH=%PATH%;D:\deno

# PowerShell

$env:path+=";D:\deno"

 

 

【所謂的全端工程師，就是在面對突如其來的需求下，仍能給出合宜的解方】 ——打破程式鄙視鏈的迷思

作者：吳祐賓 

 

 

 

▋選擇 Classic ASP 來解決問題，不是瘋狂的叛逆，而是妥協的藝術

當面對一個微小需求：「使用者要在系統看到圖片」

而你那 2000 年開發的 Win32 系統既改不動，也不能改

一般人會有幾個選項：

1.說做不到，放棄

2.另外寫一個系統

 

選 1 的人很正常，領多少錢做多少事，老闆的薪水沒付到這個專業項目

選 2 的人超級認真，是一名做實事的員工，只是對應到「微小需求」的開發時間，聰明的老闆怎麼想都不認為是好的選項

身為一名專業的工程師，當然能不做就不做...我是說做不到的工作就給外包做

我選 3.外部連結或下載 來解決此問題，原因是：

1.繞過歷史包袱：避免於舊技術搏鬥、修改系統所引發的系統性風險 (好像繞口令)

2.成本效益最佳化：「使用者要在系統看到圖片」這句話的重點不是「在系統」，而是「看到圖片」，使用 OS 層的瀏覽器來開圖是成本最低、開發時間最短的方案

▋「成本最低、開發時間最短」的方案，你怎麼選？

 

利用瀏覽器開，可使用本機檔案開啟或另寫網頁圖片顯示功能

由於「本機檔案開啟」需要修改程式，不被許可，於是只能採用網頁圖片顯示

看到這裡，聰明的你應該會想到：

1.Python

2.Node.js

3.Deno

4.PHP

 

這些選項除了 4 之外，其它都是現代網頁開發的主流 (是，JSP 已成古代語了)

Python 絕對是開發時間最短的選項，豐富的三方資源，簡單直白的程式寫碼風格，都是上上之選

然而，除了開發環境複雜，開發除錯服務緩慢，網站服務還得設定反向代理（Reverse proxy），嗯，還是輕輕放下

Node.js / Deno 這兩個都是我目前的主要工具，豐富的 JS、三方資源，但為了實現小功能而承擔 node_modules 無底黑洞和使用反向代理等步驟，是我不考慮的原因

PHP，持續更新、活躍於現今的網頁開發市場，採 FastCGI，使 PHP 在穩定、執行效率更上一層樓，還是 NAS 的基本配備

但我的環境是 IIS + MSSQL 啊！PHP 的跨 NAS 機制對我來說吸引力不高，而 PHP 在 NAS 下要連 MSSQL 也是困難重重，點到 PHP 的技能樹對我的加分並不多

▋Classic ASP 位於程式鄙視鏈最底端，是它無用還是後門太多？

 
Classic ASP，目前版本 3.0（2000年2月17日，​距今至少 25 年前）

它還活著，Windows Server 2025 版，還是有內建 Classic asp 3.0

看到微軟廢棄了這麼多產品，IE6 都走入歷史了，Classic asp 居然還活著，證明 Classic asp 才是真正的歷史包袱

早些年，我也是臨危受命來解救公司內 asp 網站被殖入木馬的問題，所以對攻擊手法也是略懂略懂，不外乎就是被當 SQL 和 HTML 的測試場：

1. SQL 注入 (SQL injection)

2. XSS 注入 (Cross-Site Scripting，又稱跨站腳本攻擊)


綜合這些經驗，另外還有一個冷知識，asp 支援 JS ECMAScript 標準！就是 ECMA 3 (2000年標準) 舊了點

但它還是 JavaScript，在 JS 經驗上也能延續，哪怕 asp 是程式鄙視鍵的最底層，都不影響我使用 Classic asp 的決定

▋所謂的全端工程師，就是能在面對突如其來的需求下，仍能給出合宜的解方

 

透過這些分析可以知道，一名全端工程師，掌握一門可以前後端通透的技術外，巧妙的「技術選型」也是全端工程師必點的技能

使用 Classic asp，只是在我的場合下，能採用的最佳解，它可能不適合你，但上述的思路與大局觀，在任何場合都能適用

成為全端工程師，就是要持續的青春期叛逆