Build and deploy 小貓中文 (FreeDOS, self-hosted js-dos)

LICENSE-js-dos.txt

@@ -0,0 +1,339 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users.  This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it.  (Some other Free Software Foundation software is covered by
+the GNU Lesser General Public License instead.)  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+this service if you wish), that you receive source code or can get it
+if you want it, that you can change the software or use pieces of it
+in new free programs; and that you know you can do these things.
+
+  To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have.  You must make sure that they, too, receive or can get the
+source code.  And you must show them these terms so they know their
+rights.
+
+  We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+  Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software.  If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+  Finally, any free program is threatened constantly by software
+patents.  We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary.  To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                    GNU GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License.  The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language.  (Hereinafter, translation is included without limitation in
+the term "modification".)  Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+  1. You may copy and distribute verbatim copies of the Program's
+source code as you receive it, in any medium, provided that you
+conspicuously and appropriately publish on each copy an appropriate
+copyright notice and disclaimer of warranty; keep intact all the
+notices that refer to this License and to the absence of any warranty;
+and give any other recipients of the Program a copy of this License
+along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and
+you may at your option offer warranty protection in exchange for a fee.
+
+  2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+    a) You must cause the modified files to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    b) You must cause any work that you distribute or publish, that in
+    whole or in part contains or is derived from the Program or any
+    part thereof, to be licensed as a whole at no charge to all third
+    parties under the terms of this License.
+
+    c) If the modified program normally reads commands interactively
+    when run, you must cause it, when started running for such
+    interactive use in the most ordinary way, to print or display an
+    announcement including an appropriate copyright notice and a
+    notice that there is no warranty (or else, saying that you provide
+    a warranty) and that users may redistribute the program under
+    these conditions, and telling the user how to view a copy of this
+    License.  (Exception: if the Program itself is interactive but
+    does not normally print such an announcement, your work based on
+    the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Program,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Program, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Program.
+
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+
+    a) Accompany it with the complete corresponding machine-readable
+    source code, which must be distributed under the terms of Sections
+    1 and 2 above on a medium customarily used for software interchange; or,
+
+    b) Accompany it with a written offer, valid for at least three
+    years, to give any third party, for a charge no more than your
+    cost of physically performing source distribution, a complete
+    machine-readable copy of the corresponding source code, to be
+    distributed under the terms of Sections 1 and 2 above on a medium
+    customarily used for software interchange; or,
+
+    c) Accompany it with the information you received as to the offer
+    to distribute corresponding source code.  (This alternative is
+    allowed only for noncommercial distribution and only if you
+    received the program in object code or executable form with such
+    an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for
+making modifications to it.  For an executable work, complete source
+code means all the source code for all modules it contains, plus any
+associated interface definition files, plus the scripts used to
+control compilation and installation of the executable.  However, as a
+special exception, the source code distributed need not include
+anything that is normally distributed (in either source or binary
+form) with the major components (compiler, kernel, and so on) of the
+operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering
+access to copy from a designated place, then offering equivalent
+access to copy the source code from the same place counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  4. You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License.  Any attempt
+otherwise to copy, modify, sublicense or distribute the Program is
+void, and will automatically terminate your rights under this License.
+However, parties who have received copies, or rights, from you under
+this License will not have their licenses terminated so long as such
+parties remain in full compliance.
+
+  5. You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Program or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+  6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program subject to
+these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties to
+this License.
+
+  7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Program at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Program by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under
+any particular circumstance, the balance of the section is intended to
+apply and the section as a whole is intended to apply in other
+circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system, which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+  8. If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program under this License
+may add an explicit geographical distribution limitation excluding
+those countries, so that distribution is permitted only in or among
+countries not thus excluded.  In such case, this License incorporates
+the limitation as if written in the body of this License.
+
+  9. The Free Software Foundation may publish revised and/or new versions
+of the General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+Each version is given a distinguishing version number.  If the Program
+specifies a version number of this License which applies to it and "any
+later version", you have the option of following the terms and conditions
+either of that version or of any later version published by the Free
+Software Foundation.  If the Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.
+
+  10. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, write to the author
+to ask for permission.  For software which is copyrighted by the Free
+Software Foundation, write to the Free Software Foundation; we sometimes
+make exceptions for this.  Our decision will be guided by the two goals
+of preserving the free status of all derivatives of our free software and
+of promoting the sharing and reuse of software generally.
+
+                            NO WARRANTY
+
+  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
+YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License along
+    with this program; if not, write to the Free Software Foundation, Inc.,
+    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this
+when it starts in an interactive mode:
+
+    Gnomovision version 69, Copyright (C) year name of author
+    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, the commands you use may
+be called something other than `show w' and `show c'; they could even be
+mouse-clicks or menu items--whatever suits your program.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the program, if
+necessary.  Here is a sample; alter the names:
+
+  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+  `Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+  <signature of Ty Coon>, 1 April 1989
+  Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into
+proprietary programs.  If your program is a subroutine library, you may
+consider it more useful to permit linking proprietary applications with the
+library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.

NOTICE.md

@@ -0,0 +1,17 @@
+# 小貓中文 — 第三方元件與授權 (NOTICE)
+
+本專案原始碼（C、ASM、HTML、建置與生成工具）：GNU GPL-3.0-only（見 `LICENSE`、`LICENSE-GPL-3.0.txt`）。
+
+建置時由上游下載、經雜湊驗證，**不含專有軟體**：
+
+| 元件 | 用途 | 授權 | 來源 |
+|---|---|---|---|
+| FreeDOS 1.4 Floppy Edition（KERNEL.SYS 與 FreeCOM COMMAND.COM、MEM 等） | 開機磁片內的 DOS | GPL-2.0（各套件原始碼見 FreeDOS 專案） | https://www.freedos.org/ |
+| HimemX（FDHimem 衍生，XMS 管理員） | 提供 XMS | GPL 與/或 Artistic（見 Readme） | https://github.com/FDOS/himemX |
+| GNU Unifont | 16x16 點陣字形 | GPL-2.0-or-later + 字型嵌入例外 | https://unifoundry.com/unifont/ |
+| Open Watcom 1.9 | 編譯工具（不發佈） | Sybase Open Watcom Public License | https://openwatcom.org/ |
+| JWasm | 組譯 HimemX 的工具（不發佈） | Sybase Open Watcom Public License | https://github.com/Baron-von-Riedesel/JWasm |
+| js-dos 6.22 / DOSBox | 瀏覽器內 x86 + DOS 模擬 | GPL-2.0 | https://js-dos.com/ |
+| pypinyin、jieba、OpenCC | 產生注音詞庫的工具 | MIT / MIT / Apache-2.0 | PyPI |
+
+FreeDOS 元件以原樣放入開機映像，原始碼可自上游取得（FreeDOS 1.4 發行版的 source 套件）。

README.md

@@ -1,45 +1,45 @@
 ---
-title: 小貓中文 DOS 6.22
-emoji: 🖥️
+title: 小貓中文 FreeDOS
+emoji: 🐱
 colorFrom: blue
 colorTo: green
 sdk: static
 ---
 
-# 小貓中文 DOS 6.22
+# 小貓中文 (XiaoMao Chinese)
 
-「小貓中文」是 DOS 常駐（TSR）的 Big5 中文顯示與注音輸入外掛，在瀏覽器的 js-dos 6.22 上執行；字型使用 GNU Unifont，詞庫由開放資料產生。載入後回到一般 DOS 提示字元，DOS 指令照常使用，並可直接輸入、顯示中文。
+DOS 常駐（TSR）的 Big5 中文顯示與注音輸入外掛，在瀏覽器（含手機）中以 FreeDOS + js-dos 6.22 執行。載入後回到一般 DOS 提示字元，DOS 指令照常使用，並可直接輸入、顯示中文。全部元件皆為開源，建置時由上游下載並驗證雜湊。
 
 ## 運作方式
 
-- `XIAOMAO.EXE` 常駐約 10 KB 傳統記憶體（可用 `LH` 載入高記憶體）；字型與詞庫放在 XMS（需要 `HIMEM.SYS`）。
+- `XIAOMAO.EXE` 常駐約 10 KB 傳統記憶體；字型與詞庫放在 XMS（FreeDOS 開機片以 HimemX 提供）。
 - 載入時（及再次執行 `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 畫面後使用實體鍵盤，或用畫面下方的虛擬鍵盤（含 Shift、`\`、`:`、Tab）。
-- `Ctrl+Space` 切換注音／英數（網頁上有按鈕）。
+- `Ctrl+Space` 切換注音／英數（網頁有按鈕）。
 - 注音採倚天鍵位；輸入音節後按聲調鍵（`6 3 4 7`）或空白鍵出候選字，按 `1`–`9` 或空白鍵選字。
 - 試用：`TYPE DEMO.TXT`。限制：直接寫入顯示記憶體的程式不會顯示中文。
 
-## 本機建置
+## 一鍵建置與部署
 
-需求：OpenWatcom（預設 `/opt`，可用 `WATCOM` 指定）、NASM、mtools、curl、Python 3，以及可開機的 DOS 6.22 FAT12 映像（預設為 `dos/boot622.img`）。建置工具 `tools/genime.py` 需要 `pypinyin`、`jieba`、`opencc`；`tools/genfont.py` 預設讀取 `/usr/share/unifont/unifont.hex`；GPL-3.0 授權全文預設取自 `/usr/share/common-licenses/GPL-3`（可用 `GPL3_TEXT` 覆寫）。
+主機需有：`bash gcc make nasm mtools unzip curl gzip python3(含 venv)`。其餘（Open Watcom 1.9、JWasm、HimemX 原始碼、GNU Unifont、FreeDOS 1.4、js-dos 6.22.60、Python 套件）由 `build.sh` 自動下載、驗證、建置。
 
 ```sh
-HF_TOKEN=hf_... ./build.sh
+HF_TOKEN=hf_xxx HF_SPACE=user/space ./build.sh   # 建置並上傳
+./build.sh                                        # 只建置到 dist/
 ```
 
-若未設定 `HF_TOKEN`，腳本會產生本機發佈檔但略過 Hugging Face 上傳。可用 `DOS_BASE_IMAGE=/path/to/boot.img` 指定其他基底映像。上傳目標為 `HelloSun/c_dos`，token 僅從環境讀取，不寫入專案。
+`HF_TOKEN`、`HF_SPACE` 是 `build.sh` 開頭的變數（可用環境變數覆寫）；token 絕不寫入專案。上傳內容含網頁、自架 DOSBox、開機映像，以及開發包 `dev/xiaomao-dev.zip` 與 `dev/HANDOFF.md`。
 
-HF 靜態 Space 以無 CORS 的重新導向提供二進位檔，因此開機映像以 base64 文字放在 `dist/dos.b64.js`，頁面載入後轉為 Blob 交給 js-dos；DOSBox 核心（`wdosbox.js`）取自 js-dos.com。
+HF 靜態 Space 以無 CORS 的重新導向提供二進位檔，所以 DOSBox 核心與開機映像以 base64 文字放在 `emu.b64.js`／`dos.b64.js`，頁面載入後轉成 Blob 交給 js-dos，不依賴任何外部 CDN。
 
-## 授權與來源
+接手開發請讀 `HANDOFF.md`。第三方授權見 `NOTICE.md`。
 
-- 本專案原始碼（C、ASM、HTML 與建置/生成工具）：GNU GPL-3.0-only；授權全文隨發佈檔提供為 `LICENSE-GPL-3.txt`，DOS 映像內含 `LICENSE.TXT`。
-- GNU Unifont 字形：GPL-2.0-or-later，附 font embedding exception；其授權與本專案授權分開適用。
-- js-dos 6.22：使用其發佈檔案，請依上游授權條款使用。
-- DOS 6.22 系統檔案：由使用者提供的 DOS 開機映像取得；建置時移除可選應用程式以騰出磁碟空間。
+## 授權
+
+本專案原始碼：GNU GPL-3.0-only（`LICENSE`、`LICENSE-GPL-3.0.txt`）。FreeDOS、HimemX、GNU Unifont、js-dos 各依其上游授權，詳見 `NOTICE.md`。

dev/HANDOFF.md

@@ -1,37 +1,42 @@
 # 小貓中文 — 接手說明 (HANDOFF)
 
-目標：DOS 常駐 (TSR) Big5 中文顯示 + 注音輸入，跑在 js-dos 6.22（瀏覽器/手機），部署到 HF static Space `HelloSun/c_dos`
-(https://hellosun-c-dos.static.hf.space/index.html)。傳統記憶體越少越好（現況常駐約 10 KB，不強制 600K）。授權 GPL-3.0-only。
+目標：DOS 常駐 (TSR) Big5 中文顯示 + 注音輸入，跑在 js-dos 6.22（瀏覽器/手機），部署為 HF static Space。
+傳統記憶體越少越好（現況常駐約 10 KB，不強制 600K）。授權 GPL-3.0-only。全部元件開源，不含專有軟體。
+
+## 一鍵流程
+`HF_TOKEN=... HF_SPACE=user/space ./build.sh`（兩者是腳本開頭變數，token 不入檔）。空目錄也能跑：自動建 Python venv、下載並以雜湊驗證
+Open Watcom 1.9、JWasm+HimemX 原始碼（現場編成 HIMEMX.EXE）、GNU Unifont、FreeDOS 1.4 Floppy、js-dos 6.22.60(npm)，再產生字型/詞庫、編譯、組開機片、產生 `dist/`、上傳。
+主機需求：bash gcc make nasm mtools unzip curl gzip python3(venv)。快取在 `.cache/`，工具在 `.build/`（皆 .gitignore）。
 
 ## 現況（已驗證）
-- DOS 提示字元可顯示中文、`Ctrl+Space` 切換注音、候選列在最底列、Backspace 刪整個中文字。
-- 手機尺寸 390x844 + 觸控虛擬鍵盤驗證過；HF 線上版開機正常。
+- FreeDOS 開機 → `FDCONFIG.SYS` 載 HIMEMX → `FDAUTO.BAT` 載 XIAOMAO.EXE → 回到 `A:\>`；顯示 MEM；`Ctrl+Space` 注音；候選列在最底列；Backspace 刪整個中文字。
+- 手機尺寸(390x844)+觸控虛擬鍵盤驗證過；DOSBox 核心與開機片都自架，不依賴外部 CDN。
 
 ## 架構
-- `src/xiaomao.c`：TSR 主程式。`key_service`（INT16 處理）、`out_filter`（INT29 處理）、載入器（`main`）。
-- `src/xms.asm` (NASM OMF)：XMS 包裝、INT16/29/2F 掛勾（私有 1 KB 堆疊在 _TEXT，SS=CS）、`vga_tile`(INT10 AX=1100h 載入 8x16 字塊)、`vga_8dot`（8 點寬，去掉 9 點縫）。
-  所有 helper 只能改 AX；Watcom 暫存器呼叫 AX,DX,BX,CX；large model 以 `retf` 返回；符號後綴 `_`。
-- 顯示：Big5 前導+後隨位元組 → 取 32 byte 字形(XMS) → 拆左右 8x16 → 載入 VGA 字塊 → 以舊 INT29 輸出兩個字塊字元。
-  字塊池：0x80-0xE5(51 對)+低控制碼 12 對=63 對；掃描螢幕找未使用者再覆寫；0xE6-0xFF(13 對) 專給底列候選列。
-- 輸入：INT16 AH=0/1/0x10/0x11 掛勾，按鍵進 IME 狀態機，輸出 Big5 兩個位元組入 16 字佇列；`run` 計數讓 Backspace 一次退兩格。
-- 資料：`FONT.DAT`("ETNF" 18 byte 頭, ASCII 256x16, CJK 32 byte/字, 索引 (lead-0xA1)*157+trail索引) 與 `IME.DAT`("ETNI", 12 byte 頭, 5 byte 記錄 key/offset/count)；載入到 XMS，需 HIMEM。
+- `src/xiaomao.c`：TSR。`key_service`(INT16)、`out_filter`(INT29)、載入器 `main`。
+- `src/xms.asm` (NASM OMF)：XMS 包裝、INT16/29/2F 掛勾（私有 1 KB 堆疊在 _TEXT，SS=CS）、`vga_tile`(INT10 AX=1100h 載入 8x16 字塊)、`vga_8dot`。
+  helper 只能改 AX；Watcom 暫存器呼叫 AX,DX,BX,CX；large model 用 `retf`；符號後綴 `_`。
+- 顯示：Big5 前導+後隨 → 取 32 byte 字形(XMS) → 拆左右 8x16 → 載入 VGA 字塊 → 以舊 INT29 輸出兩個字塊字元。
+  字塊池：0x80-0xE5(51 對)+低控制碼 12 對=63 對（掃描螢幕找未使用者再覆寫）；0xE6-0xFF(13 對)專給底列候選列。
+- 輸入：INT16 AH=0/1/0x10/0x11 掛勾 → IME 狀態機 → Big5 兩位元組入 16 字佇列；`run` 計數讓 Backspace 一次退兩格。
+- 資料：`FONT.DAT`("ETNF" 18 byte 頭, ASCII 256x16, CJK 32 byte/字, 索引 (lead-0xA1)*157+trail索引) 與 `IME.DAT`("ETNI", 12 byte 頭, 5 byte 記錄 key/offset/count)，載入 XMS。
   key=(((ini*4+med)*14+fin)*5+tone)；XMS 搬移長度必須為偶數。
-- 常駐大小：build.sh 兩階段編譯，從連結 map 的 STACK 段位址 +0x10 得 `TSR_PARAS`，init 用的大緩衝放在堆疊（不常駐）。
-- 重複載入偵測 INT2F AX=D7A0h→584Dh；再次執行 XIAOMAO 只顯示 MEM 報告。
-- 網頁：`index.html` 虛擬鍵盤 + `Ctrl+Space` 按鈕。開機映像以 base64 放 `dos.b64.js`（HF 對二進位檔回 302 無 CORS，所以不能放 .zip/.img）；wdosbox 從 js-dos.com 載入。
+- 常駐大小：build.sh 兩階段編譯，由連結 map 的 STACK 段位址 +0x10 得 `TSR_PARAS`；init 用大緩衝放堆疊（不常駐）。
+- 防重複載入 INT2F AX=D7A0h→584Dh；再次執行 XIAOMAO 只顯示 MEM。
+- 網頁：`index.html`。HF 對二進位檔回 302 無 CORS，所以 `emu.b64.js`(wdosbox.js+wasm 的 base64) 與 `dos.b64.js`(開機片 zip 的 base64) 以 Blob URL 供 js-dos；
+  用 monkeypatch `XMLHttpRequest.prototype.open` 把 `wdosbox.js`/`wdosbox.wasm.js` 對應到 Blob URL（js-dos 以 `.js`→`.wasm.js` 推導 wasm 檔名）。
+- FreeDOS 開機片：取 FD14 `144m/x86BOOT.img`，刪除安裝用檔，換 `dos/FDCONFIG.SYS`、`dos/FDAUTO.BAT`（CRLF 由 build.sh 轉）。FreeDOS 主控台輸出走 INT 29h（已���證）。
+
+## 編譯注意
+Open Watcom 1.9：`wcl -bt=dos -ml -0 -os -s -zu -k6144`（`-s` 必要：私有堆疊上不可堆疊檢查）。無 `_AX` 偽暫存器；`_psp` 需自行 `extern unsigned _psp;`。
 
-## 建置 / 部署
-- 工具：OpenWatcom 2.0（`WATCOM=/opt`, 用 `/opt/binl64/wcl`）、nasm、mtools、curl、python3(`pypinyin jieba opencc huggingface_hub`)、`/usr/share/unifont/unifont.hex`。
-- 編譯旗標：`-bt=dos -ml -0 -os -s -zu -k6144`（`-s` 必要：私有堆疊上不可做堆疊檢查）。Watcom 沒有 `_AX` 偽暫存器；`_psp` 需自行 `extern unsigned _psp;`。
-- `./build.sh` 產生 `dist/`；設環境變數 `HF_TOKEN` 才會上傳（token 絕不寫入檔案）。
-- `dos/boot622.img` 是使用者提供的 MS-DOS 6.22 開機磁片，**未放入本 zip（授權）**，需自備放到 `dos/boot622.img` 或用 `DOS_BASE_IMAGE=`。
-  CONFIG.SYS：HIMEM + EMM386 NOEMS + DOS=HIGH,UMB；AUTOEXEC.BAT 以 `LH XIAOMAO.EXE` 載入。檔案需 CRLF（build.sh 會轉）。
-- 測試：無本機 DOS 模擬器；用 Playwright chromium + 本機 http.server 載入 dist 內容，`page.keyboard.press('Control+Space')`，截圖檢查。
-  Chromium：`/root/.cache/ms-playwright/chromium-1248/chrome-linux64/chrome --no-sandbox --disable-gpu --disable-dev-shm-usage`。
+## 測試方式
+無本機 DOS 模擬器：用 Playwright chromium + `python3 -m http.server` 載入 `dist/`，`page.keyboard.press('Control+Space')` 等，截圖檢查。
+Chromium 旗標：`--no-sandbox --disable-gpu --disable-dev-shm-usage`。
 
 ## 已知限制 / 待辦
-1. 從零建置：目前依賴自備的 MS-DOS 6.22；可改 FreeDOS 1.4 floppy（需 HIMEM/JEMM，boot 片內沒有）。
-2. 直接寫 B800 的程式（EDIT 等）不顯示中文；CP437 畫框字元連續出現時會被誤判為 Big5。可加開關。
-3. 同畫面不同漢字超過 63 個會互相覆蓋（可考慮 512 字元字型模式）。
-4. 輸入法只有注音；候選限 9 個無翻頁；無詞組/聯想。
-5. 依賴 js-dos.com 提供 wdosbox（可改自架，但 HF 對 .wasm/.js 大檔可能走 LFS，需 base64 方案）。
+1. 直接寫 B800 的程式（EDIT 等）不顯示中文；CP437 畫框字元連續出現時會被誤判為 Big5。可加開關。
+2. 同畫面不同漢字超過 63 個會互相覆蓋（可考慮 512 字元字型模式）。
+3. 輸入法只有注音；候選限 9 個無翻頁；無詞組/聯想。
+4. 可加 FreeDOS `LH`/UMB（需 JEMM386）進一步降低傳統記憶體；目前 TSR 約 10 KB 已很小。
+5. 尚未做：自動化回歸測試（Playwright 腳本可放 `tests/`）。

dev/xiaomao-dev.zip

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:c44781dc52b9ce710d8cf1469c534d3ab8a74626f3dd87b55a1379d44ddda774
-size 58589
+oid sha256:deb6dab953d76c514eac29d2aae5414820799196d0fd20e74d231d1cdf19f521
+size 41092

index.html

@@ -6,7 +6,7 @@
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width,initial-scale=1,maximum-scale=1,user-scalable=no">
   <meta name="theme-color" content="#05070a">
-  <title>小貓中文 DOS · js-dos 6.22</title>
+  <title>小貓中文 DOS · FreeDOS</title>
   <style>
     :root { color-scheme: dark; font-family: system-ui, sans-serif; background: #05070a; color: #e7edf5; }
     * { box-sizing: border-box; }
@@ -38,7 +38,7 @@
 </head>
 <body>
   <header>
-    <strong>小貓中文 DOS 6.22</strong>
+    <strong>小貓中文 FreeDOS</strong>
     <span id="memory">載入時於 DOS 畫面顯示即時 MEM</span>
   </header>
   <main>
@@ -47,7 +47,7 @@
       <button id="ime-toggle" type="button">Ctrl+Space 注音切換</button>
       <button id="fullscreen" type="button">全螢幕</button>
       <span class="spacer"></span>
-      <span id="message" role="status">正在載入 DOS 6.22…</span>
+      <span id="message" role="status">正在載入 FreeDOS…</span>
     </div>
     <p class="hint">點選 DOS 畫面後可使用實體鍵盤。手機可用下方按鍵輸入；注音使用相容鍵位。F1 顯示系統資訊，Alt+X 離開。</p>
     <section class="keypad" aria-label="虛擬鍵盤">
@@ -65,6 +65,7 @@
   </main>
   <footer>小貓中文 GPL-3.0 · OpenWatcom · GNU Unifont · Big5 注音 · 載入時顯示即時 MEM · <a href="LICENSE">License</a></footer>
   <script src="js-dos.js"></script>
+  <script src="emu.b64.js"></script>
   <script src="dos.b64.js"></script>
   <script>
     (() => {
@@ -145,7 +146,23 @@
         send(event.keyCode, false);
       });
       if (typeof Dos !== 'function') { status.textContent = 'js-dos 核心載入失敗'; return; }
-      Dos(host, { wdosboxUrl: 'https://js-dos.com/6.22/current/wdosbox.js' }).ready((fs, main) => {
+      // Self-hosted emulator: HF static Spaces send binary files through a CORS-less
+      // redirect, so the DOSBox core ships as base64 text and is served from Blob URLs.
+      const b64blob = (b64, type) => {
+        const bin = Uint8Array.from(atob(b64), (c) => c.charCodeAt(0));
+        return URL.createObjectURL(new Blob([bin], { type }));
+      };
+      if (!window.XM_WDOSBOX_B64 || !window.XM_WASM_B64) { status.textContent = '啟動失敗：emu.b64.js'; return; }
+      const virtual = {
+        'wdosbox.js': b64blob(window.XM_WDOSBOX_B64, 'application/javascript'),
+        'wdosbox.wasm.js': b64blob(window.XM_WASM_B64, 'application/octet-stream'),
+      };
+      const xhrOpen = XMLHttpRequest.prototype.open;
+      XMLHttpRequest.prototype.open = function (method, url, ...rest) {
+        const name = String(url).split('?')[0].split('/').pop();
+        return xhrOpen.call(this, method, virtual[name] || url, ...rest);
+      };
+      Dos(host, { wdosboxUrl: 'wdosbox.js' }).ready((fs, main) => {
         status.textContent = '正在載入 DOS 開機磁碟…';
         if (!window.XIAOMAO_B64) { status.textContent = '啟動失敗：dos.b64.js'; return; }
         const bin = Uint8Array.from(atob(window.XIAOMAO_B64), (c) => c.charCodeAt(0));
@@ -155,7 +172,7 @@
             controller = ci;
             window.etController = ci;
             canvas.tabIndex = 0;
-            status.textContent = 'DOS 6.22 已啟動；點選畫面輸入';
+            status.textContent = 'FreeDOS 已啟動；點選畫面輸入';
                       })
           .catch((error) => { status.textContent = '啟動失敗：' + (error.message || error); });
       });