commit 4ba201fa276fc1f37fa5c356df71c83c8eaa621b
Author: tangsongdayo
Date: Fri Nov 20 14:46:07 2026 +0800
Mouse Clock 1.0.0: Silly Clock 3 (Kurt Grigg) rewrite with touch support, settings and setup guide
Co-Authored-By: Claude Opus 5.5
diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..6313b56
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1 @@
+* text=auto eol=lf
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..3ac4b03
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,31 @@
+滑鼠立體時鐘 Mouse Clock
+
+Original script: "Silly Clock 3" by Kurt Grigg.
+Traditional Chinese adaptation: 網頁建置百寶箱 JavaScript 收集區.
+The original clock design and algorithm remain the work of Kurt Grigg.
+Please keep the credit comment at the top of mouse-clock.js.
+
+The modifications in this repository (packaging, settings, touch support,
+start/stop API, documentation) are released under the MIT License:
+
+MIT License
+
+Copyright (c) 2026 唐宋打油 (https://tsdylab.com/)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..37d60d6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,139 @@
+# 滑鼠立體時鐘 Mouse Clock
+
+一個會跟著滑鼠跑的類比時鐘:鐘面數字、時針、分針、秒針一個字一個字拖著跑,外圈還有一圈旋轉的日期。這是 1990 年代末很多個人網頁都會放的經典效果,原作是 Kurt Grigg 的 **Silly Clock 3**,台灣的「網頁建置百寶箱」收錄過中文化版本。
+
+這個版本由[唐宋打油](https://tsdylab.com/)改寫,用在〈[平淡文章的華麗產地:敲敲打打的工坊✨BBP 11](https://tsdylab.com/savepoint/tinkering-workshop/)〉。和原版相比:
+
+- 一個檔案、一行就能放進網頁,不用改任何程式。
+- 手機也能用:手指在畫面上滑動,時鐘會出現在手指上方(不會被手掌擋住)。
+- 顏色、大小、位置、速度、日期語言(中文/英文)都可以設定。
+- 分頁在背景時不計算;系統開啟「減少動態」的使用者預設不顯示。
+- 可以用程式開關(`MouseClock.start()`、`MouseClock.stop()`)。
+
+## 檔案
+
+| 檔案 | 用途 |
+| --- | --- |
+| `mouse-clock.js` | 時鐘本體,只需要這個檔案 |
+| `index.html` | 範例頁,下載後用瀏覽器打開就能試 |
+
+---
+
+## 放置教學
+
+### 方法一:上傳檔案再引用(推薦)
+
+1. 下載 `mouse-clock.js`(在檔案頁按「原始檔」或「下載」)。
+2. 上傳到你的網站,例如放在網站根目錄的 `js/` 資料夾。
+3. 在網頁的 `