changelogkit 0.1.0__tar.gz

changelogkit-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+venv/
+.pytest_cache/
+.mypy_cache/
+_site/

changelogkit-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nuclear0709
+
+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.

changelogkit-0.1.0/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.5
+Name: changelogkit
+Version: 0.1.0
+Summary: 本機變更歷史 GUI 與開發索引：解析 ChangeHistory.md、唯讀索引 Git／文件／API 宣告
+Project-URL: Homepage, https://github.com/TwhomeGH/ChangeLogKit
+Project-URL: Repository, https://github.com/TwhomeGH/ChangeLogKit
+Project-URL: Issues, https://github.com/TwhomeGH/ChangeLogKit/issues
+Project-URL: Documentation, https://github.com/TwhomeGH/ChangeLogKit/tree/main/Docs
+Author: TwhomeGH
+License: MIT
+License-File: LICENSE
+Keywords: changelog,developer-tools,docc,documentation,git
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.10
+Requires-Dist: tomli>=2; python_version < '3.11'
+Description-Content-Type: text/markdown
+
+# changelogkit
+
+本機（開發機）用的兩合一工具，與特定 repo 解耦：
+
+- **變更歷史 GUI**：解析 `Docs/ChangeHistory.md`（路徑可設定），提供網頁瀏覽／新增／編輯與 CLI 檢索。
+- **開發索引**：唯讀索引 Git 近期改動（提交可展開看 unified diff，含語法上色）、Swift 宣告定位、Markdown 文件與鎖定套件。
+
+不需要 Xcode；只要開發機有 Python 3.10+ 與 `git`。
+
+## 安裝
+
+```bash
+pipx install changelogkit          # 建議：隔離安裝並提供全域指令
+# 或
+pip install changelogkit
+```
+
+## 在 PyPI 上線前如何使用
+
+套件尚未發佈到 PyPI 時，有三種本機用法（擇一）。以下把 `<ChangeLogTools>` 換成套件所在目錄。
+
+### 1. 零安裝（最快；改程式即時生效）
+
+用**絕對路徑**的 `PYTHONPATH` 指向套件的 `src/`，即可在任何 repo 內執行：
+
+```powershell
+$env:PYTHONPATH = "<ChangeLogTools>\src"     # PowerShell；路徑要用絕對路徑
+cd D:\某個repo
+python -m changelogkit serve --no-browser
+python -m changelogkit list
+```
+
+（可在該 repo 放一個薄殼 `change_log.cmd` 包住上述指令，之後雙擊即可。）
+
+### 2. 可編輯安裝（開發套件本身）
+
+```powershell
+cd <ChangeLogTools>
+pip install -e .
+changelogkit serve
+```
+
+> ⚠️ **路徑含非 ASCII 字元時不要用 `-e`。** 若套件放在像 `…\桌面\…` 這種路徑，editable 安裝會寫出含中文路徑的 `.pth`；在 **cp950（繁體中文）語系的 Windows** 上，Python 以 locale 讀 `.pth` 會 `UnicodeDecodeError`，害**任何 `python`／`pip` 指令都啟動不了**（`Fatal Python error: init_import_site`）。
+> 解法：刪掉那個 `.pth` 後改用一般安裝 `pip install <ChangeLogTools>`（複製進 site-packages，不產生 `.pth`）或第 3 種 pipx；也可先 `set PYTHONUTF8=1`。
+
+### 3. 全域 CLI、又保持隔離（推薦）
+
+```powershell
+pipx install <ChangeLogTools>
+# 之後更新程式：
+pipx install --force <ChangeLogTools>
+# 或直接從 git（不經 PyPI）：
+pipx install git+https://github.com/TwhomeGH/ChangeLogKit.git
+```
+
+### 驗證「使用者真正拿到的成品」
+
+```powershell
+python -m build
+python -m venv .venv
+.\.venv\Scripts\pip install dist\changelogkit-0.1.0-py3-none-any.whl
+.\.venv\Scripts\changelogkit --help
+```
+
+## 使用
+
+在任何 repo 目錄下執行：
+
+```bash
+changelogkit                 # 等同 serve：啟動本機網頁 GUI
+changelogkit serve --port 8710 --no-browser
+changelogkit add "修正 XXX" --type 修復 --file a/b.swift
+changelogkit list --grep RTMP
+changelogkit show 3
+```
+
+網頁 GUI：`/` 為變更歷史，`/development` 為開發索引（功能／API 宣告／文件／近期改動）。
+
+## 設定：`.changelog.toml`
+
+放在 repo 根目錄（工具會從工作目錄往上尋找；找不到就用預設值）：
+
+```toml
+[tool.changelog]
+title    = "ReplyKit 變更歷史"                    # 網頁標題
+history  = "Docs/ChangeHistory.md"               # 變更歷史 markdown
+features = "Docs/development/features.json"      # 選填：功能清單
+assets   = "Scripts/changelog-overrides"         # 選填：覆寫預設網頁資產
+
+[[tool.changelog.sources]]                       # 開發索引要一起看的 repo（預設只有自己）
+name = "app"
+path = "."
+[[tool.changelog.sources]]
+name = "haishinkit"
+path = "${HAISHINKIT_ROOT}"                      # 支援環境變數；不存在就略過
+```
+
+未設定時預設：`history = Docs/ChangeHistory.md`、`features = Docs/development/features.json`、
+`title = <repo 目錄名>`、單一來源（自己）。`path` 支援 `${ENV}` 展開。
+
+### 覆寫網頁資產
+
+`assets` 指向一個目錄；載入資產時**先找該目錄的同名檔，找不到才用套件預設**。因此可以：
+
+- 只放 `theme.css` → 只換配色；
+- 放整套 `index.*`／`dev.*`／`file.*` → 整包換掉版面。
+
+## 文件
+
+- [安裝與本地使用](Docs/install.md)：三種裝法、cp950／中文路徑地雷、解除安裝
+- [用法](Docs/usage.md)：指令、`.changelog.toml` 全欄位、資產覆寫、變更歷史格式
+- [GitHub Pages](Docs/pages.md)：靜態匯出的產物、限制與啟用方式
+- [PyPI 發佈](Docs/publishing.md)：Trusted Publishing 設定與版本流程
+- [架構](Docs/architecture.md)：模組結構與設計要點
+
+## 開發
+
+```bash
+pip install -e .
+python tests/test_changelogkit.py
+```
+
+網頁資產在 `src/changelogkit/assets/`，改版面／配色只需動這些檔案，不必改 Python。

changelogkit-0.1.0/README.md

@@ -0,0 +1,123 @@
+# changelogkit
+
+本機（開發機）用的兩合一工具，與特定 repo 解耦：
+
+- **變更歷史 GUI**：解析 `Docs/ChangeHistory.md`（路徑可設定），提供網頁瀏覽／新增／編輯與 CLI 檢索。
+- **開發索引**：唯讀索引 Git 近期改動（提交可展開看 unified diff，含語法上色）、Swift 宣告定位、Markdown 文件與鎖定套件。
+
+不需要 Xcode；只要開發機有 Python 3.10+ 與 `git`。
+
+## 安裝
+
+```bash
+pipx install changelogkit          # 建議：隔離安裝並提供全域指令
+# 或
+pip install changelogkit
+```
+
+## 在 PyPI 上線前如何使用
+
+套件尚未發佈到 PyPI 時，有三種本機用法（擇一）。以下把 `<ChangeLogTools>` 換成套件所在目錄。
+
+### 1. 零安裝（最快；改程式即時生效）
+
+用**絕對路徑**的 `PYTHONPATH` 指向套件的 `src/`，即可在任何 repo 內執行：
+
+```powershell
+$env:PYTHONPATH = "<ChangeLogTools>\src"     # PowerShell；路徑要用絕對路徑
+cd D:\某個repo
+python -m changelogkit serve --no-browser
+python -m changelogkit list
+```
+
+（可在該 repo 放一個薄殼 `change_log.cmd` 包住上述指令，之後雙擊即可。）
+
+### 2. 可編輯安裝（開發套件本身）
+
+```powershell
+cd <ChangeLogTools>
+pip install -e .
+changelogkit serve
+```
+
+> ⚠️ **路徑含非 ASCII 字元時不要用 `-e`。** 若套件放在像 `…\桌面\…` 這種路徑，editable 安裝會寫出含中文路徑的 `.pth`；在 **cp950（繁體中文）語系的 Windows** 上，Python 以 locale 讀 `.pth` 會 `UnicodeDecodeError`，害**任何 `python`／`pip` 指令都啟動不了**（`Fatal Python error: init_import_site`）。
+> 解法：刪掉那個 `.pth` 後改用一般安裝 `pip install <ChangeLogTools>`（複製進 site-packages，不產生 `.pth`）或第 3 種 pipx；也可先 `set PYTHONUTF8=1`。
+
+### 3. 全域 CLI、又保持隔離（推薦）
+
+```powershell
+pipx install <ChangeLogTools>
+# 之後更新程式：
+pipx install --force <ChangeLogTools>
+# 或直接從 git（不經 PyPI）：
+pipx install git+https://github.com/TwhomeGH/ChangeLogKit.git
+```
+
+### 驗證「使用者真正拿到的成品」
+
+```powershell
+python -m build
+python -m venv .venv
+.\.venv\Scripts\pip install dist\changelogkit-0.1.0-py3-none-any.whl
+.\.venv\Scripts\changelogkit --help
+```
+
+## 使用
+
+在任何 repo 目錄下執行：
+
+```bash
+changelogkit                 # 等同 serve：啟動本機網頁 GUI
+changelogkit serve --port 8710 --no-browser
+changelogkit add "修正 XXX" --type 修復 --file a/b.swift
+changelogkit list --grep RTMP
+changelogkit show 3
+```
+
+網頁 GUI：`/` 為變更歷史，`/development` 為開發索引（功能／API 宣告／文件／近期改動）。
+
+## 設定：`.changelog.toml`
+
+放在 repo 根目錄（工具會從工作目錄往上尋找；找不到就用預設值）：
+
+```toml
+[tool.changelog]
+title    = "ReplyKit 變更歷史"                    # 網頁標題
+history  = "Docs/ChangeHistory.md"               # 變更歷史 markdown
+features = "Docs/development/features.json"      # 選填：功能清單
+assets   = "Scripts/changelog-overrides"         # 選填：覆寫預設網頁資產
+
+[[tool.changelog.sources]]                       # 開發索引要一起看的 repo（預設只有自己）
+name = "app"
+path = "."
+[[tool.changelog.sources]]
+name = "haishinkit"
+path = "${HAISHINKIT_ROOT}"                      # 支援環境變數；不存在就略過
+```
+
+未設定時預設：`history = Docs/ChangeHistory.md`、`features = Docs/development/features.json`、
+`title = <repo 目錄名>`、單一來源（自己）。`path` 支援 `${ENV}` 展開。
+
+### 覆寫網頁資產
+
+`assets` 指向一個目錄；載入資產時**先找該目錄的同名檔，找不到才用套件預設**。因此可以：
+
+- 只放 `theme.css` → 只換配色；
+- 放整套 `index.*`／`dev.*`／`file.*` → 整包換掉版面。
+
+## 文件
+
+- [安裝與本地使用](Docs/install.md)：三種裝法、cp950／中文路徑地雷、解除安裝
+- [用法](Docs/usage.md)：指令、`.changelog.toml` 全欄位、資產覆寫、變更歷史格式
+- [GitHub Pages](Docs/pages.md)：靜態匯出的產物、限制與啟用方式
+- [PyPI 發佈](Docs/publishing.md)：Trusted Publishing 設定與版本流程
+- [架構](Docs/architecture.md)：模組結構與設計要點
+
+## 開發
+
+```bash
+pip install -e .
+python tests/test_changelogkit.py
+```
+
+網頁資產在 `src/changelogkit/assets/`，改版面／配色只需動這些檔案，不必改 Python。

changelogkit-0.1.0/examples/README.md

@@ -0,0 +1,22 @@
+# 範例 repo
+
+把這個目錄當成一個獨立 repo 的縮影，示範 `changelogkit` 需要的檔案與設定：
+
+```
+repo/
+  .changelog.toml                 # 設定（可省略，用預設值）
+  Docs/ChangeHistory.md           # 變更歷史（必要）
+  Docs/development/features.json  # 功能清單（選填）
+  Sources/Sample.swift            # 被索引的原始碼（開發索引用）
+```
+
+試跑（先 `pip install -e ..`，或在 repo 內設定 `PYTHONPATH` 指向套件的 `src`）：
+
+```bash
+cd examples/repo
+changelogkit serve --no-browser      # 開 / 與 /development
+changelogkit list
+```
+
+複製 `.changelog.toml` 到你的專案根目錄，再依需要調整 `title` / `history` /
+`features` / `assets` / `sources` 即可。

changelogkit-0.1.0/examples/repo/.changelog.toml

@@ -0,0 +1,14 @@
+# 這個 repo 的 changelogkit 設定。全部欄位皆可省略（省略時用預設值）。
+[tool.changelog]
+title    = "範例專案變更歷史"
+history  = "Docs/ChangeHistory.md"
+features = "Docs/development/features.json"
+# assets  = "Scripts/changelog-overrides"   # 選填：覆寫預設網頁資產的目錄
+
+# 開發索引要一起看的來源；未設定時預設為單一來源（name = "app", path = "."）。
+# [[tool.changelog.sources]]
+# name = "app"
+# path = "."
+# [[tool.changelog.sources]]
+# name = "lib"
+# path = "${SOME_LIB_ROOT}"     # 支援 ${ENV} 展開；不存在就略過

changelogkit-0.1.0/examples/repo/Docs/ChangeHistory.md

@@ -0,0 +1,24 @@
+## 2026.01.02 10:00 新增範例功能
+
+**類型**: 功能 · **檔案**: `Sources/Sample.swift`
+
+### 修改 - 新增 Sample
+
+- 示範一條變更紀錄的格式。
+
+---
+
+## 2026.01.01 09:00 範例修正
+
+**類型**: 修正 · **檔案**: `Sources/Sample.swift`
+
+### 問題 - 有錯
+
+說明。
+
+### 根因 - 原因
+
+說明。
+
+---
+

changelogkit-0.1.0/examples/repo/Docs/development/features.json

@@ -0,0 +1,12 @@
+[
+  {
+    "id": "sample-feature",
+    "name": "範例功能",
+    "summary": "示範功能清單的一筆（欄位完全通用）。",
+    "labels": { "platform": "平台", "status": "狀態" },
+    "platform": "iOS / macOS",
+    "status": "待驗證",
+    "files": ["Sources/Sample.swift"],
+    "docs": ["Docs/ChangeHistory.md"]
+  }
+]

changelogkit-0.1.0/examples/repo/Sources/Sample.swift

@@ -0,0 +1,9 @@
+import Foundation
+
+/// 範例型別，供開發索引的宣告掃描示範。
+public struct Sample {
+    /// 執行範例。
+    public func run() {
+        print("hello")
+    }
+}

changelogkit-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "changelogkit"
+version = "0.1.0"
+description = "本機變更歷史 GUI 與開發索引：解析 ChangeHistory.md、唯讀索引 Git／文件／API 宣告"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "TwhomeGH" }]
+keywords = ["changelog", "documentation", "docc", "git", "developer-tools"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Documentation",
+  "Topic :: Software Development :: Version Control :: Git",
+]
+# tomllib 是 Python 3.11+ 的標準庫；3.10 需要 tomli 讀 .changelog.toml。
+dependencies = ["tomli>=2; python_version < '3.11'"]
+
+[project.scripts]
+changelogkit = "changelogkit.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/TwhomeGH/ChangeLogKit"
+Repository = "https://github.com/TwhomeGH/ChangeLogKit"
+Issues = "https://github.com/TwhomeGH/ChangeLogKit/issues"
+Documentation = "https://github.com/TwhomeGH/ChangeLogKit/tree/main/Docs"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/changelogkit"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src", "tests", "examples", "README.md"]

changelogkit-0.1.0/src/changelogkit/__init__.py

@@ -0,0 +1,11 @@
+"""changelogkit：本機變更歷史 GUI 與開發索引。
+
+通用工具，與任何特定 repo 解耦：
+
+* 變更歷史 — 解析 ``Docs/ChangeHistory.md``（可設定路徑），提供網頁 GUI 與 CLI。
+* 開發索引 — 唯讀索引 Git 近期改動（可展開 diff）、Swift 宣告定位、Markdown 文件。
+
+每個 repo 的差異由 repo 根目錄的 ``.changelog.toml`` 提供；未提供時用預設值。
+"""
+
+__version__ = "0.1.0"

changelogkit-0.1.0/src/changelogkit/__main__.py

@@ -0,0 +1,6 @@
+"""``python -m changelogkit`` 的進入點（等同 CLI 指令 ``changelogkit``）。"""
+
+from .cli import main
+
+if __name__ == "__main__":
+    main()

changelogkit-0.1.0/src/changelogkit/assets/about.html

@@ -0,0 +1,37 @@
+<!doctype html>
+<html lang="{{lang_html}}"><head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>{{t.about.title}}</title>
+<script src="/assets/theme.js"></script>
+<script src="/assets/i18n.js"></script>
+<script>window.CK_I18N = {{i18n_json}};</script>
+<link rel="stylesheet" href="/assets/theme.css">
+<style>
+  main { max-width: 720px; margin: 0 auto; padding: 24px }
+  .card dl { display: grid; grid-template-columns: 120px 1fr; gap: 8px 16px; margin: 10px 0 0 }
+  .card dt { color: var(--mut); font-size: 13px }
+  .card dd { margin: 0; overflow-wrap: anywhere }
+  .card code { font-size: 13px }
+</style>
+</head><body>
+<header class="appbar">
+  <h1>{{t.about.title}}</h1>
+  <a href="/">{{t.nav.history}}</a>
+  <a href="/development">{{t.nav.dev}}</a>
+  <button id="theme" aria-label="{{t.btn.theme}}" title="{{t.btn.theme}}">🌙</button>
+</header>
+<main>
+  <article class="card">
+    <h2>changelogkit</h2>
+    <p class="muted">{{t.about.intro}}</p>
+    <dl>
+      <dt>{{t.about.version}}</dt><dd id="version">…</dd>
+      <dt>{{t.about.commit}}</dt><dd id="commit">…</dd>
+      <dt>{{t.about.locales}}</dt><dd id="locales">…</dd>
+      <dt>{{t.about.home}}</dt><dd><a href="https://github.com/TwhomeGH/ChangeLogKit">github.com/TwhomeGH/ChangeLogKit</a></dd>
+    </dl>
+  </article>
+</main>
+<script src="/assets/about.js"></script>
+</body></html>

changelogkit-0.1.0/src/changelogkit/assets/about.js

@@ -0,0 +1,22 @@
+/* 關於頁：向 /api/buildinfo 取版本與來源 commit（commit 連到 GitHub）。 */
+const REPO = "https://github.com/TwhomeGH/ChangeLogKit";
+
+fetch("/api/buildinfo")
+  .then((r) => r.json())
+  .then((b) => {
+    document.getElementById("version").textContent = b.version || CK_T("about.na");
+    /* UI 語系清單，* 標示目前生效者。 */
+    document.getElementById("locales").textContent =
+      (b.locales || []).map((l) => l + (l === b.locale ? " *" : "")).join("   ");
+    const raw = b.commit || "";
+    if (!raw) {
+      document.getElementById("commit").textContent = CK_T("about.unknown");
+      return;
+    }
+    const hash = raw.replace(/\+dirty$/, "");
+    document.getElementById("commit").innerHTML =
+      '<a href="' + REPO + "/commit/" + hash + '"><code>' + raw + "</code></a>";
+  })
+  .catch(() => {
+    document.getElementById("version").textContent = CK_T("about.load_failed");
+  });

changelogkit-0.1.0/src/changelogkit/assets/dev.css

@@ -0,0 +1,90 @@
+/* 開發索引頁面版面。主題與共用元件在 theme.css。 */
+main { max-width: 1100px; margin: auto; padding: 24px 28px 60px }
+#hint { margin: 4px 0 0 }
+#tabs { display: flex; gap: 8px; margin: 18px 0 6px; flex-wrap: wrap }
+#tabs button { white-space: nowrap }
+#tabs button[aria-pressed="true"] { background: var(--accent); color: var(--accent-fg); border-color: var(--accent) }
+#message { padding: 6px 0 10px; font-size: 13px }
+article.card h2 { margin: 0 0 6px; font-size: 19px; line-height: 1.35 }
+article.card h2 a { color: var(--fg); text-decoration: none }
+article.card h2 a:hover { color: var(--accent); text-decoration: underline }
+.meta { font-size: 12.5px; color: var(--mut); margin-bottom: 8px }
+.kind {
+  display: inline-block; font-size: 11px; font-weight: 700; letter-spacing: .03em;
+  padding: 1px 7px; border-radius: 6px; background: var(--code); color: var(--accent); margin-right: 6px;
+}
+.card dl { display: grid; grid-template-columns: 108px 1fr; gap: 6px 12px; margin: 10px 0 4px }
+.card dt { color: var(--mut); font-size: 13px } .card dd { margin: 0 }
+.card h3 { font-size: 13px; color: var(--mut); margin: 14px 0 6px; text-transform: none }
+.doc { line-height: 1.6 } .doc p { margin: .3em 0 } .doc ul { margin: .3em 0; padding-left: 1.3em }
+.files a { display: inline-block; margin: 0 12px 6px 0 }
+.preview { font: 13px/1.6 ui-monospace, Consolas, "Courier New", monospace; color: var(--mut); white-space: pre-wrap; overflow-wrap: anywhere; margin: 4px 0 0 }
+pre.blob { background: var(--code); border: 1px solid var(--line); border-radius: 10px; padding: 12px 14px; overflow: auto; font-size: 12.5px; line-height: 1.55 }
+.deps { display: grid; grid-template-columns: 1fr auto; gap: 6px 14px; margin-top: 6px }
+.deps code { font-size: 12.5px }
+@media (max-width: 640px) {
+  main { padding: 16px 16px 48px }
+  .card dl { grid-template-columns: 1fr }
+  .card dt { font-weight: 700 }
+}
+
+/* 「API 宣告」篩選列。 */
+#filters { margin: 4px 0 10px; display: flex; flex-direction: column; gap: 6px }
+#filters .supported { font-size: 12.5px; color: var(--mut); overflow-wrap: anywhere }
+#filters .chips { display: flex; flex-wrap: wrap; gap: 6px 8px }
+#filters .chip.on { background: var(--accent); color: var(--accent-fg); border-color: var(--accent) }
+#filters .kindfilter { font-size: 13px; color: var(--mut) }
+#filters .kindfilter select { width: auto; margin-left: 6px }
+
+/* 符號簽名列：等寬、可換行、深淺色一致。 */
+.sig {
+  margin: 6px 0 10px; padding: 9px 12px; border-radius: 10px;
+  background: var(--code); border: 1px solid var(--line);
+  color: var(--fg); font-size: 12.5px; white-space: pre-wrap;
+  word-break: break-word; overflow-x: auto;
+}
+
+/* 近期改動：提交卡片與差異檢視。 */
+.commits { display: flex; flex-direction: column; gap: 6px }
+.commit { border: 1px solid var(--line); border-radius: 10px; overflow: hidden; background: var(--bg) }
+.commit-head {
+  display: flex; flex-direction: column; gap: 3px; align-items: stretch; width: 100%;
+  text-align: left; background: transparent; border: 0; border-radius: 0; padding: 8px 12px;
+}
+.commit-head:hover { background: var(--line2) }
+.commit-top { display: flex; gap: 10px; align-items: baseline; flex-wrap: wrap }
+.commit-head .hash { color: var(--accent); font-size: 12.5px; background: none; padding: 0 }
+.commit-head .when { color: var(--mut); font-size: 12px; white-space: nowrap }
+.commit-head .subject { font-weight: 600; white-space: normal; overflow-wrap: anywhere }
+.commit-files { display: flex; flex-wrap: wrap; gap: 4px 14px; padding: 7px 12px; border-top: 1px solid var(--line2) }
+.commit-files a.cfile { font-size: 12px; color: var(--mut) }
+.commit-files a.cfile:hover { color: var(--accent) }
+.wt-wrap { margin: 6px 0 2px }
+.commit .diff, .wt-wrap .diff { padding: 8px 12px 10px }
+
+/* 統一分歧（unified diff）：等寬、可橫向捲動，+／- 綠紅底色。 */
+.dpre {
+  margin: 0; background: var(--code); border: 1px solid var(--line); border-radius: 10px;
+  overflow: auto; padding: 8px 0; white-space: pre;
+  font: 12.5px/1.55 ui-monospace, Consolas, "Courier New", monospace;
+}
+.dline { display: block; padding: 0 12px }
+.dmark { display: inline-block; width: 1.3em; color: var(--mut); user-select: none }
+.d-add { background: rgba(16, 185, 129, .14) }
+.d-del { background: rgba(239, 68, 68, .13) }
+.d-add .dmark { color: #059669 } .d-del .dmark { color: #dc2626 }
+.d-hunk { color: #8b5cf6; background: rgba(139, 92, 246, .08) }
+.d-file { color: var(--mut); font-weight: 600 }
+.d-meta { color: var(--mut) }
+
+/* 靜態匯出：<details class="commit">（動態版用 button.commit-head，故這些規則不衝突）。 */
+details.commit > summary { padding: 8px 12px; cursor: pointer }
+details.commit > summary::marker { color: var(--mut) }
+details.commit > summary:hover { background: var(--line2) }
+details.commit > summary .cbody { display: block }
+details.commit > summary .commit-top { display: flex; gap: 10px; align-items: baseline; flex-wrap: wrap }
+details.commit > summary .hash { color: var(--accent); font-size: 12.5px; background: none; padding: 0 }
+details.commit > summary .when { color: var(--mut); font-size: 12px; white-space: nowrap }
+details.commit > summary .subject { display: block; font-weight: 600; white-space: normal; overflow-wrap: anywhere }
+details.commit > .commit-files { border-top: 1px solid var(--line2) }
+details.commit > .dpre { margin: 8px 12px 10px }

changelogkit-0.1.0/src/changelogkit/assets/dev.html

@@ -0,0 +1,29 @@
+<!doctype html>
+<html lang="{{lang_html}}"><head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>{{t.dev.title}}</title>
+<script src="/assets/theme.js"></script>
+<script src="/assets/i18n.js"></script>
+<script>window.CK_I18N = {{i18n_json}};</script>
+<link rel="stylesheet" href="/assets/theme.css">
+<link rel="stylesheet" href="/assets/dev.css">
+</head><body>
+<header class="appbar">
+  <h1>{{t.dev.title}}</h1>
+  <a href="/">{{t.nav.history}}</a>
+  <a href="/about">{{t.nav.about}}</a>
+  <input id="search" aria-label="{{t.dev.search}}" placeholder="{{t.dev.search}}">
+  <select id="repo" aria-label="{{t.dev.repo_all}}"><option value="">{{t.dev.repo_all}}</option></select>
+  <button id="reload" aria-label="{{t.dev.reload}}" title="{{t.dev.reload}}">↻</button>
+  <button id="theme" aria-label="{{t.btn.theme}}" title="{{t.btn.theme}}">🌙</button>
+</header>
+<main>
+  <p class="muted" id="hint">{{t.dev.hint}}</p>
+  <nav id="tabs"></nav>
+  <div id="message" role="status" class="muted">{{t.dev.loading}}</div>
+  <div id="filters" hidden></div>
+  <section id="results"></section>
+</main>
+<script src="/assets/dev.js"></script>
+</body></html>