Build and deploy 小貓中文 DOS demo

README.md

@@ -8,16 +8,22 @@ sdk: static
 
 # 小貓中文 DOS 6.22
 
-「小貓中文」是在瀏覽器執行的 DOS 6.22 注音中文系統示範。DOSBox 由 js-dos 6.22 提供；字型使用 GNU Unifont，詞庫由開放資料產生。
+「小貓中文」是 DOS 常駐（TSR）的 Big5 中文顯示與注音輸入外掛，在瀏覽器的 js-dos 6.22 上執行；字型使用 GNU Unifont，詞庫由開放資料產生。載入後回到一般 DOS 提示字元，DOS 指令照常使用，並可直接輸入、顯示中文。
 
-## 操作方式
+## 運作方式
+
+- `XIAOMAO.EXE` 常駐約 10 KB 傳統記憶體（可用 `LH` 載入高記憶體）；字型與詞庫放在 XMS（需要 `HIMEM.SYS`）。
+- 載入時（及再次執行 `XIAOMAO`）才顯示常駐大小、可用傳統記憶體與 XMS（即時 MEM），沒有狀態列。
+- 顯示：攔截 INT 29h，遇到 Big5 雙位元組時，把 16×16 字形拆成兩個 8×16 字塊寫入 VGA 字型，再用原本的 INT 29h 輸出，游標、換行與捲動由 DOS 處理。80×25 文字模式，切為 8 點寬字元。
+- 輸入：攔截 INT 16h。`Ctrl+Space` 切換注音／英數；注音選字列顯示於畫面最底列，用完即還原。`Backspace` 一次刪一個中文字。
+- INT 2Fh `AX=D7A0h` 防止重複載入。
 
-- 點選 DOS 畫面後使用實體鍵盤，或用畫面下方的虛擬鍵盤。
-- `Ctrl+Space` 切換注音／英文輸入。
-- 注音採相容倚天鍵位；輸入音節後按空白鍵選字，按 `1`–`9` 選候選字。
-- `F1` 查看系統資訊；`Alt+X` 離開。
+## 操作方式
 
-啟動時會顯示 DOS 狀態列中的傳統記憶體用量，目標為保留 600KB 以上。
+- 點選 DOS 畫面後使用實體鍵盤，或用畫面下方的虛擬鍵盤（含 Shift、`\`、`:`、Tab）。
+- `Ctrl+Space` 切換注音／英數（網頁上有按鈕）。
+- 注音採倚天鍵位；輸入音節後按聲調鍵（`6 3 4 7`）或空白鍵出候選字，按 `1`–`9` 或空白鍵選字。
+- 試用：`TYPE DEMO.TXT`。限制：直接寫入顯示記憶體的程式不會顯示中文。
 
 ## 本機建置
 
@@ -29,7 +35,7 @@ HF_TOKEN=hf_... ./build.sh
 
 若未設定 `HF_TOKEN`，腳本會產生本機發佈檔但略過 Hugging Face 上傳。可用 `DOS_BASE_IMAGE=/path/to/boot.img` 指定其他基底映像。上傳目標為 `HelloSun/c_dos`，token 僅從環境讀取，不寫入專案。
 
-`dist/dos.zip` 內含 `XIAOMAO.img`，供頁面中的 js-dos 啟動；`dist/XIAOMAO.img` 可直接用於本機測試。
+HF 靜態 Space 以無 CORS 的重新導向提供二進位檔，因此開機映像以 base64 文字放在 `dist/dos.b64.js`，頁面載入後轉為 Blob 交給 js-dos；DOSBox 核心（`wdosbox.js`）取自 js-dos.com。
 
 ## 授權與來源
 

XIAOMAO.img

@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:4ad1f23262b00f3d36bd27dca929d207f5fee3500c294d9413a5e5d684411b89
-size 1474560

index.html

@@ -39,7 +39,7 @@
 <body>
   <header>
     <strong>小貓中文 DOS 6.22</strong>
-    <span id="memory">DOS 啟動後顯示可用傳統記憶體</span>
+    <span id="memory">載入時於 DOS 畫面顯示即時 MEM</span>
   </header>
   <main>
     <div id="screen-wrap"><canvas id="dosbox" width="640" height="480" aria-label="DOS emulator screen"></canvas></div>
@@ -59,11 +59,13 @@
       <button type="button" data-key="76">L ㄠ</button><button type="button" data-key="190">. ㄡ</button><button type="button" data-key="48">0 ㄢ</button><button type="button" data-key="80">P ㄣ</button><button type="button" data-key="186">; ㄤ</button><button type="button" data-key="191">/ ㄥ</button>
       <button type="button" data-key="189">- ㄦ</button><button type="button" data-key="54">6 ˊ</button><button type="button" data-key="51">3 ˇ</button><button type="button" data-key="52">4 ˋ</button><button type="button" data-key="55">7 ˙</button><button type="button" data-key="8">⌫</button>
       <button type="button" data-key="27">Esc</button><button type="button" data-key="13">Enter</button><button type="button" data-key="32" class="wide">Space</button><button type="button" data-key="37">←</button><button type="button" data-key="38">↑</button><button type="button" data-key="39">→</button><button type="button" data-key="40">↓</button>
+      <button type="button" data-key="220">\</button><button type="button" data-key="186" data-shift="1">:</button><button type="button" data-key="9">Tab</button><button id="shift" type="button">Shift</button>
       <button type="button" data-key="112">F1</button><button id="alt-x" type="button" class="wide">Alt+X</button>
     </section>
   </main>
-  <footer>小貓中文 GPL-3.0 · OpenWatcom · GNU Unifont · Big5 注音 · 保留 600KB 以上傳統記憶體 · <a href="LICENSE">License</a></footer>
+  <footer>小貓中文 GPL-3.0 · OpenWatcom · GNU Unifont · Big5 注音 · 載入時顯示即時 MEM · <a href="LICENSE">License</a></footer>
   <script src="js-dos.js"></script>
+  <script src="dos.b64.js"></script>
   <script>
     (() => {
       const status = document.getElementById('message');
@@ -79,6 +81,9 @@
         send(code, true);
         window.setTimeout(() => send(code, false), 90);
       };
+      let shiftOn = false;
+      const setShift = (on) => { shiftOn = on; document.getElementById('shift').classList.toggle('active', on); };
+      document.getElementById('shift').addEventListener('click', () => setShift(!shiftOn));
       const toggleIme = () => {
         send(17, true);
         tap(32);
@@ -94,7 +99,11 @@
         button.addEventListener('pointerdown', (event) => {
           event.preventDefault();
           const code = Number(button.dataset.key);
-          tap(code);
+          if (button.dataset.shift || shiftOn) {
+            send(16, true);
+            window.setTimeout(() => { tap(code); window.setTimeout(() => send(16, false), 130); }, 40);
+            setShift(false);
+          } else tap(code);
           button.classList.add('active');
         });
         button.addEventListener('pointerup', () => button.classList.remove('active'));
@@ -138,14 +147,16 @@
       if (typeof Dos !== 'function') { status.textContent = 'js-dos 核心載入失敗'; return; }
       Dos(host, { wdosboxUrl: 'https://js-dos.com/6.22/current/wdosbox.js' }).ready((fs, main) => {
         status.textContent = '正在載入 DOS 開機磁碟…';
-        fs.extract('dos.zip', '/').then(() => main(['-c', 'boot XIAOMAO.img']))
+        if (!window.XIAOMAO_B64) { status.textContent = '啟動失敗：dos.b64.js'; return; }
+        const bin = Uint8Array.from(atob(window.XIAOMAO_B64), (c) => c.charCodeAt(0));
+        const zipUrl = URL.createObjectURL(new Blob([bin], { type: 'application/zip' }));
+        fs.extract(zipUrl, '/').then(() => main(['-c', 'boot XIAOMAO.img']))
           .then((ci) => {
             controller = ci;
             window.etController = ci;
             canvas.tabIndex = 0;
             status.textContent = 'DOS 6.22 已啟動；點選畫面輸入';
-            memory.textContent = '小貓中文 · js-dos 6.22';
-          })
+                      })
           .catch((error) => { status.textContent = '啟動失敗：' + (error.message || error); });
       });
     })();