Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

feat(i18n): bundle a Traditional Chinese (Taiwan) Viewer catalog

kevinlincgbebb3f2ee96d
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3dc560dd..53255b84 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,7 @@ All notable changes are documented here. Format loosely follows [Keep a Changelo
> Development identity: `v3.0.2-dev.1`. Not a stable release.
### Added
+- **Traditional Chinese (Taiwan) Viewer catalog.** `meta.locale: "zh-TW"` now selects a bundled catalog covering all 487 Viewer keys with Taiwan terminology (for example 循序圖, 資料流, 匯出, 檢視), instead of falling back to English. Enrollment is data only: `locales/zh-TW.json` plus one manifest entry. `zh-Hant` and `zh-HK` remain distinct, unbundled tags.
- **GitLab source links.** Repository evidence on gitlab.com, or on a self-managed host declared with `provider: "gitlab"`, now generates revision-pinned web links (`/-/blob/<revision>/<path>#L<a>-<b>`, `/-/tree/<revision>`) instead of requiring `link_mode: "local-only"`. Nested groups are accepted, SSH and HTTPS origins on the same host match, paths compare case-insensitively, and cited Markdown line ranges open the plain view. Verification is unchanged and `local-only` remains available.
### Fixed
diff --git a/README.md b/README.md
index 07a7cee7..401fd5b9 100644
--- a/README.md
+++ b/README.md
@@ -352,7 +352,7 @@ Settings:
}
```
-`meta.locale` localizes page title, Legend, states/errors, a11y, HTML/SVG `lang`—never authored content. `en`, `zh-CN`, `es`, and `ko` are bundled and need only `meta.locale`; `meta.translations` (canonical message key → translated string) overrides individual keys and keeps the rest of the language. Other languages supply their catalog there (see `archify/examples/locales/`), or the renderer falls back to English and discloses it. Static omits `animation`; `classic` defaults.
+`meta.locale` localizes page title, Legend, states/errors, a11y, HTML/SVG `lang`—never authored content. `en`, `zh-CN`, `zh-TW`, `es`, and `ko` are bundled and need only `meta.locale`; `meta.translations` (canonical message key → translated string) overrides individual keys and keeps the rest of the language. Other languages supply their catalog there (see `archify/examples/locales/`), or the renderer falls back to English and discloses it. Static omits `animation`; `classic` defaults.
</details>
diff --git a/README_EN.md b/README_EN.md
index 07a7cee7..401fd5b9 100644
--- a/README_EN.md
+++ b/README_EN.md
@@ -352,7 +352,7 @@ Settings:
}
```
-`meta.locale` localizes page title, Legend, states/errors, a11y, HTML/SVG `lang`—never authored content. `en`, `zh-CN`, `es`, and `ko` are bundled and need only `meta.locale`; `meta.translations` (canonical message key → translated string) overrides individual keys and keeps the rest of the language. Other languages supply their catalog there (see `archify/examples/locales/`), or the renderer falls back to English and discloses it. Static omits `animation`; `classic` defaults.
+`meta.locale` localizes page title, Legend, states/errors, a11y, HTML/SVG `lang`—never authored content. `en`, `zh-CN`, `zh-TW`, `es`, and `ko` are bundled and need only `meta.locale`; `meta.translations` (canonical message key → translated string) overrides individual keys and keeps the rest of the language. Other languages supply their catalog there (see `archify/examples/locales/`), or the renderer falls back to English and discloses it. Static omits `animation`; `classic` defaults.
</details>
diff --git a/README_JA.md b/README_JA.md
index 04e7757d..8bb5cf94 100644
--- a/README_JA.md
+++ b/README_JA.md
@@ -334,7 +334,7 @@ node bin/archify.mjs deliver workflow examples/agent-tool-call.workflow.json /tm
}
```
-`meta.locale=en|zh-CN|es|ko` はページタイトル、Legend、状態/エラー、アクセシビリティ、HTML/SVG の `lang` をローカライズします(記述された内容自体は変更しません)。該当しない場合は省略し、要求された言語の文言はそのまま維持し、英語へフォールバックした場合はその旨を明示してください。静止出力では `animation` は省略され、`classic` が既定になります。
+`meta.locale=en|zh-CN|zh-TW|es|ko` はページタイトル、Legend、状態/エラー、アクセシビリティ、HTML/SVG の `lang` をローカライズします(記述された内容自体は変更しません)。該当しない場合は省略し、要求された言語の文言はそのまま維持し、英語へフォールバックした場合はその旨を明示してください。静止出力では `animation` は省略され、`classic` が既定になります。
</details>
diff --git a/README_ZH.md b/README_ZH.md
index d83806da..f111c48a 100644
--- a/README_ZH.md
+++ b/README_ZH.md
@@ -353,7 +353,7 @@ node bin/archify.mjs deliver workflow examples/agent-tool-call.workflow.json /tm
}
```
-不设置 `animation` 时结果完全静态;`classic` 始终是默认视觉预设。设计评审、发布说明和技术文档可以显式选择 `editorial`,获得暖纸张与深墨色的编辑风格,同时保持几何完全不变。将 `meta.locale` 设为任意合法语言标签,可选择 `<html lang>`、默认图例、无障碍文案和所有固定 Viewer UI。`en`、`zh-CN`、`es` 与 `ko` 已内置,只需设置 `meta.locale`;`meta.translations`(规范消息键到译文字符串的映射)可逐键覆盖,其余文案保持所选语言。其他语言需在该字段中提供完整目录(参见 `archify/examples/locales/`),否则渲染器回退为英文并在 stderr 中说明。作者编写的标题、节点、关系和卡片不会被机器翻译。未带该字段的旧文件仍然有效,并默认使用英文。对于既未内置也未提供 `meta.translations` 的创作语言,应省略 `meta.locale`、保持 authored content 使用用户要求的语言,并主动告知用户固定 Viewer UI 与 `<html lang>` 回退为英文,因此该成品不属于完整本地化。
+不设置 `animation` 时结果完全静态;`classic` 始终是默认视觉预设。设计评审、发布说明和技术文档可以显式选择 `editorial`,获得暖纸张与深墨色的编辑风格,同时保持几何完全不变。将 `meta.locale` 设为任意合法语言标签,可选择 `<html lang>`、默认图例、无障碍文案和所有固定 Viewer UI。`en`、`zh-CN`、`zh-TW`、`es` 与 `ko` 已内置,只需设置 `meta.locale`;`meta.translations`(规范消息键到译文字符串的映射)可逐键覆盖,其余文案保持所选语言。其他语言需在该字段中提供完整目录(参见 `archify/examples/locales/`),否则渲染器回退为英文并在 stderr 中说明。作者编写的标题、节点、关系和卡片不会被机器翻译。未带该字段的旧文件仍然有效,并默认使用英文。对于既未内置也未提供 `meta.translations` 的创作语言,应省略 `meta.locale`、保持 authored content 使用用户要求的语言,并主动告知用户固定 Viewer UI 与 `<html lang>` 回退为英文,因此该成品不属于完整本地化。
</details>
diff --git a/archify.zip b/archify.zip
index b48c34a5..bf0ac8f5 100644
Binary files a/archify.zip and b/archify.zip differ
diff --git a/archify/locales/README.md b/archify/locales/README.md
index 267a1fd1..139c40b9 100644
--- a/archify/locales/README.md
+++ b/archify/locales/README.md
@@ -22,6 +22,7 @@ never collapsed onto another catalog.
| --- | --- | --- |
| `en` | Archify source strings | Canonical |
| `zh-CN` | #108 | Maintained with the renderer |
+| `zh-TW` | kevinlincg | Complete; OpenCC `s2twp` conversion hand-reviewed for Taiwan terminology; not independently native-reviewed |
| `es` | Juan Pablo Tamayo (#457, moved to data in #586) | Complete; not independently native-reviewed |
| `ko` | uygnoey (#457) | Complete; not independently native-reviewed |
diff --git a/archify/locales/manifest.json b/archify/locales/manifest.json
index 2e93c019..e6fd1186 100644
--- a/archify/locales/manifest.json
+++ b/archify/locales/manifest.json
@@ -2,6 +2,7 @@
"catalogs": [
{ "locale": "en", "file": "en.json" },
{ "locale": "zh-CN", "file": "zh-CN.json" },
+ { "locale": "zh-TW", "file": "zh-TW.json" },
{ "locale": "es", "file": "es.json" },
{ "locale": "ko", "file": "ko.json" }
]
diff --git a/archify/locales/zh-TW.json b/archify/locales/zh-TW.json
new file mode 100644
index 00000000..b28a6e85
--- /dev/null
+++ b/archify/locales/zh-TW.json
@@ -0,0 +1,489 @@
+{
+ "page.title": "{title}",
+ "diagram.description.architecture": "由 Archify 產生的架構圖。",
+ "diagram.description.workflow": "由 Archify 產生的工作流程圖。",
+ "diagram.description.sequence": "由 Archify 產生的循序圖。",
+ "diagram.description.dataflow": "由 Archify 產生的資料流圖。",
+ "diagram.description.lifecycle": "由 Archify 產生的生命週期圖。",
+ "node.focus": "聚焦{label}",
+ "node.focus.detail": "聚焦{label},{detail}",
+ "node.context.architecture": "架構元件",
+ "node.context.workflow": "工作流程節點",
+ "node.context.sequence": "循序圖參與者",
+ "node.context.dataflow": "資料流節點",
+ "node.context.lifecycle": "生命週期狀態",
+ "legend.title": "圖例",
+ "legend.architecture.frontend": "前端",
+ "legend.architecture.backend": "後端",
+ "legend.architecture.database": "資料庫",
+ "legend.architecture.cloud": "雲端服務",
+ "legend.architecture.security": "安全",
+ "legend.architecture.messagebus": "訊息匯流排",
+ "legend.architecture.external": "外部系統",
+ "legend.workflow.frontend": "使用者介面",
+ "legend.workflow.backend": "Agent 邏輯",
+ "legend.workflow.security": "政策",
+ "legend.workflow.messagebus": "工具操作",
+ "legend.workflow.database": "脈絡 / 追蹤",
+ "legend.workflow.cloud": "雲端服務",
+ "legend.workflow.external": "外部系統",
+ "legend.sequence.emphasis": "主路徑請求",
+ "legend.sequence.return": "回傳",
+ "legend.sequence.security": "安全",
+ "legend.sequence.dashed": "非同步追蹤",
+ "legend.sequence.default": "一般訊息",
+ "legend.dataflow.emphasis": "主要資料",
+ "legend.dataflow.security": "政策 / 個資",
+ "legend.dataflow.dashed": "非同步批次處理",
+ "legend.dataflow.database": "資料儲存",
+ "legend.dataflow.default": "資料流",
+ "legend.lifecycle.start": "初始狀態",
+ "legend.lifecycle.active": "進行中",
+ "legend.lifecycle.waiting": "等待",
+ "legend.lifecycle.decision": "決策",
+ "legend.lifecycle.success": "成功",
+ "legend.lifecycle.failure": "失敗 / 結束",
+ "legend.lifecycle.neutral": "中性狀態",
+ "legend.lifecycle.external": "外部狀態",
+ "legend.lifecycle.final": "最終狀態",
+ "viewer.kind.frontend": "前端",
+ "viewer.kind.backend": "後端",
+ "viewer.kind.database": "資料庫",
+ "viewer.kind.cloud": "雲端服務",
+ "viewer.kind.security": "安全",
+ "viewer.kind.messagebus": "訊息匯流排",
+ "viewer.kind.external": "外部系統",
+ "viewer.kind.neutral": "中性",
+ "viewer.kind.node": "節點",
+ "viewer.kind.start": "開始",
+ "viewer.kind.active": "進行中",
+ "viewer.kind.waiting": "等待",
+ "viewer.kind.decision": "決策",
+ "viewer.kind.success": "成功",
+ "viewer.kind.failure": "失敗",
+ "viewer.toolbar.actions": "圖表操作",
+ "viewer.theme.toggle.title": "切換主題(T)",
+ "viewer.theme.toggle": "切換顏色主題",
+ "viewer.theme.dark": "深色",
+ "viewer.theme.light": "淺色",
+ "viewer.preset.choose.title": "選擇視覺風格(S 輪流切換)",
+ "viewer.preset.choose": "選擇視覺風格",
+ "viewer.preset.style": "風格",
+ "viewer.preset.menu": "視覺風格",
+ "viewer.preset.identity": "視覺識別",
+ "viewer.preset.cycles": "輪流切換",
+ "viewer.preset.classic": "經典",
+ "viewer.preset.classic.short": "經典",
+ "viewer.preset.classic.hint": "穩定的技術預設風格",
+ "viewer.preset.flow": "訊號流",
+ "viewer.preset.flow.short": "流動",
+ "viewer.preset.flow.hint": "突出動態流向",
+ "viewer.preset.blueprint": "藍圖",
+ "viewer.preset.blueprint.hint": "工程評審",
+ "viewer.preset.editorial": "編輯風格",
+ "viewer.preset.editorial.hint": "適合發布與上線說明",
+ "viewer.preset.badge.signalFlow": "訊號流",
+ "viewer.preset.badge.blueprint": "藍圖 / 修訂 01",
+ "viewer.preset.badge.editorial": "編輯風格 / 現場筆記",
+ "viewer.preset.badge.editorialPlate": "ARCHIFY / 圖版 04",
+ "viewer.preset.current": "目前視覺風格:{style}。選擇視覺風格",
+ "viewer.motion.live": "動態",
+ "viewer.motion.still": "靜態",
+ "viewer.motion.pause": "暫停動畫",
+ "viewer.motion.resume": "恢復動畫",
+ "viewer.motion.reduced": "已依「減少動態效果」設定暫停動畫",
+ "viewer.motion.hidden": "頁面隱藏時已暫停動畫",
+ "viewer.motion.yielding": "暫停動畫;目前讓給{owner}",
+ "viewer.motion.yielding.title": "動態預覽已開啟 · 目前讓給{owner}",
+ "viewer.owner.route": "路徑探測",
+ "viewer.owner.lens": "語意透鏡",
+ "viewer.owner.relationship": "關係預覽",
+ "viewer.owner.intent": "意圖追蹤",
+ "viewer.owner.focus": "語意聚焦",
+ "viewer.owner.legend": "圖例預覽",
+ "viewer.owner.reader": "讀者互動",
+ "viewer.present.enter": "進入簡報模式",
+ "viewer.present.enter.title": "簡報模式(F)",
+ "viewer.present.exit": "離開簡報模式",
+ "viewer.present.exit.title": "離開簡報模式(F 或 Escape)",
+ "viewer.present.present": "簡報",
+ "viewer.present.exit.label": "離開",
+ "viewer.export.button": "匯出",
+ "viewer.export.button.title": "匯出圖表(E)",
+ "viewer.export.diagram": "匯出圖表",
+ "viewer.export.menu": "匯出",
+ "viewer.export.subtitle": "方便攜帶、乾淨的輸出",
+ "viewer.export.share": "分享",
+ "viewer.export.shareCard": "分享卡片",
+ "viewer.export.routeShareCard": "路徑分享卡片",
+ "viewer.export.reachShareCard": "可達範圍分享卡片",
+ "viewer.export.copyDiagram": "複製圖表",
+ "viewer.export.clipboardPng": "複製 PNG 到剪貼簿",
+ "viewer.export.raster": "點陣圖",
+ "viewer.export.image": "圖片",
+ "viewer.export.lossless": "無損圖片",
+ "viewer.export.compact": "壓縮圖片",
+ "viewer.export.modern": "新式圖片格式",
+ "viewer.export.vectorMotion": "向量與動畫",
+ "viewer.export.vectorMotion.heading": "向量與動畫",
+ "viewer.export.editable": "可編輯向量圖",
+ "viewer.export.svg.auto": "SVG · 自動",
+ "viewer.export.svg.auto.hint": "跟隨頁面主題",
+ "viewer.export.svg.light": "SVG · 淺色",
+ "viewer.export.svg.light.hint": "一律淺色",
+ "viewer.export.svg.dark": "SVG · 深色",
+ "viewer.export.svg.dark.hint": "一律深色",
+ "viewer.export.motion6s": "6 秒動畫",
+ "viewer.export.unsupported": "目前瀏覽器不支援",
+ "viewer.export.clipboardUnsupported": "目前瀏覽器不支援寫入圖片剪貼簿",
+ "viewer.export.clipboardUnsupported.short": "此瀏覽器不支援寫入圖片剪貼簿。",
+ "viewer.export.motionUnavailable": "目前瀏覽器無法錄製動畫",
+ "viewer.export.webmUnavailable": "目前瀏覽器不支援 WebM",
+ "viewer.export.failed": "匯出失敗:{message}",
+ "viewer.export.unknownVariant": "未知的分享卡片類型:{variant}",
+ "viewer.export.routeRequired": "請先追蹤路徑,再匯出路徑分享卡片",
+ "viewer.export.reachRequired": "請先追蹤圖中的可達範圍,再匯出可達範圍分享卡片",
+ "viewer.export.unknown": "未知錯誤",
+ "viewer.export.routeFailed": "路徑分享卡片匯出失敗:{message}",
+ "viewer.export.reachFailed": "可達範圍分享卡片匯出失敗:{message}",
+ "viewer.export.copyFailed": "複製失敗:{message}",
+ "viewer.export.copiedPng": "已將 PNG 複製到剪貼簿",
+ "viewer.export.downloadedRoute": "已下載路徑分享卡片",
+ "viewer.export.downloadedReach": "已下載可達範圍分享卡片",
+ "viewer.export.downloadedWebm": "已下載 WebM",
+ "viewer.export.recording": "正在錄製 6 秒動畫…",
+ "viewer.export.card.routeSummary.one": "路徑:{source} → {target} · {count} 步",
+ "viewer.export.card.routeSummary.other": "路徑:{source} → {target} · {count} 步",
+ "viewer.export.card.reachSummary": "從{origin}開始的{direction} · {nodes} · {links} · 最多 {hops}",
+ "viewer.export.card.node.one": "{count} 個節點",
+ "viewer.export.card.node.other": "{count} 個節點",
+ "viewer.export.card.link.one": "{count} 條連線",
+ "viewer.export.card.link.other": "{count} 條連線",
+ "viewer.export.card.hop.one": "{count} 跳",
+ "viewer.export.card.hop.other": "{count} 跳",
+ "viewer.export.card.routeBadge": "ARCHIFY · 路徑 · {hops}",
+ "viewer.export.card.reachBadge": "ARCHIFY · {direction}可達範圍",
+ "viewer.export.direction.upstream": "上游",
+ "viewer.export.direction.downstream": "下游",
+ "viewer.export.error.canvasUnavailable": "無法為{label}使用畫布",
+ "viewer.export.error.contextUnavailable": "無法為{label}建立 2D 繪圖環境",
+ "viewer.export.error.toBlobUnavailable": "{label}無法使用 canvas.toBlob",
+ "viewer.export.error.toBlobNull": "{label}的 canvas.toBlob 未回傳資料",
+ "viewer.export.error.variantsCombined": "無法同時組合多種分享卡片類型",
+ "viewer.export.error.viewerState": "分享卡片匯出後無法移除暫時的檢視器狀態",
+ "viewer.export.error.routeState": "路徑卡片匯出無法安全保留已解析路徑",
+ "viewer.export.error.reachState": "可達範圍卡片匯出時無法安全保留圖中的可達範圍",
+ "viewer.export.error.webmRequirements": "WebM 動畫匯出需要追蹤動畫及瀏覽器 MediaRecorder 支援",
+ "viewer.export.error.mediaRecorder": "MediaRecorder 錄製失敗",
+ "viewer.export.error.emptyWebm": "MediaRecorder 產生了空的 WebM",
+ "viewer.export.error.webmBackground": "無法為 WebM 匯出載入 SVG 背景",
+ "viewer.guide.title": "探索這個系統",
+ "viewer.focus.selectedNodes": "已選擇 {count} 個節點",
+ "viewer.guide.eyebrow": "圖表指南",
+ "viewer.guide.close": "關閉圖表指南",
+ "viewer.guide.inspecting": "正在檢查編譯後的語意",
+ "viewer.guide.actions": "圖表探索操作",
+ "viewer.guide.find": "尋找任意節點",
+ "viewer.guide.find.hint": "搜尋標籤、職責、類型和穩定 ID。",
+ "viewer.guide.route": "追蹤路徑",
+ "viewer.guide.route.aria": "追蹤有向路徑",
+ "viewer.guide.route.hint": "查看兩個語意節點如何依圖中方向相連。",
+ "viewer.guide.map": "檢視完整系統",
+ "viewer.guide.map.hint": "開啟語意雷達,顯示即時可視範圍與穩定的節點位置。",
+ "viewer.guide.lens": "比較語意類型",
+ "viewer.guide.lens.hint": "統計各角色、顯示其流量,並比較圖中的直接連線。",
+ "viewer.guide.present": "進入簡報模式",
+ "viewer.guide.present.hint": "讓即時圖占滿畫面,不影響匯出結果。",
+ "viewer.guide.shortcuts": "其他鍵盤快速鍵",
+ "viewer.guide.shortcut.export": "匯出",
+ "viewer.guide.shortcut.theme": "主題",
+ "viewer.guide.shortcut.style": "風格",
+ "viewer.guide.shortcut.reset": "重設",
+ "viewer.guide.shortcut.zoomIn": "放大",
+ "viewer.guide.shortcut.zoomOut": "縮小",
+ "viewer.guide.shortcut.close": "關閉",
+ "viewer.guide.facts": "{nodes} · {relationships}",
+ "viewer.guide.fact.node.one": "{count} 個語意節點",
+ "viewer.guide.fact.node.other": "{count} 個語意節點",
+ "viewer.guide.fact.relationship.one": "{count} 條關係",
+ "viewer.guide.fact.relationship.other": "{count} 條關係",
+ "viewer.guide.open": "開啟圖表指南",
+ "viewer.finder.title": "尋找節點",
+ "viewer.finder.close": "關閉節點尋找器",
+ "viewer.finder.placeholder": "搜尋標籤或 ID",
+ "viewer.finder.search": "搜尋圖表節點",
+ "viewer.finder.results": "圖表節點",
+ "viewer.finder.empty": "沒有符合的節點",
+ "viewer.finder.result.focus": "聚焦{label}",
+ "viewer.finder.result.routeStart": "選擇{label}作為路徑起點",
+ "viewer.finder.result.routeTarget": "選擇{label}作為路徑終點,{links}",
+ "viewer.finder.status.empty": "沒有符合的節點",
+ "viewer.finder.status.count.one": "{count} 個符合的節點",
+ "viewer.finder.status.count.other": "{count} 個符合的節點",
+ "viewer.finder.noun.nodes": "個節點",
+ "viewer.finder.link.one": "{count} 條連線",
+ "viewer.finder.link.other": "{count} 條連線",
+ "viewer.finder.result.focus.one": "聚焦{label},{count} 條相關連線",
+ "viewer.finder.result.focus.other": "聚焦{label},{count} 條相關連線",
+ "viewer.finder.status.filtered": "{visible}/{available} {noun}",
+ "viewer.finder.status.all": "{available} {noun}",
+ "viewer.passport.eyebrow": "語意護照",
+ "viewer.passport.metadata": "節點後設資料",
+ "viewer.passport.evidence": "已驗證的原始碼證據",
+ "viewer.passport.verified": "已驗證來源",
+ "viewer.passport.verificationScope": "已依固定版本驗證本機 Git,未檢查遠端存取權限。",
+ "viewer.passport.reach": "圖中可達範圍",
+ "viewer.passport.reach.trace": "追蹤圖中可達範圍",
+ "viewer.passport.upstream": "上游",
+ "viewer.passport.downstream": "下游",
+ "viewer.passport.upstream.trace": "追蹤上游可達範圍",
+ "viewer.passport.downstream.trace": "追蹤下游可達範圍",
+ "viewer.passport.close": "關閉語意護照",
+ "viewer.passport.move": "移動語意護照。可拖曳、用方向鍵移動,或按 Home 回到自動位置。",
+ "viewer.passport.copy": "複製連結",
+ "viewer.passport.copy.focus": "複製聚焦節點的連結",
+ "viewer.passport.relations": "關係",
+ "viewer.passport.relations.show": "顯示相連的關係",
+ "viewer.passport.relations.hide": "隱藏相連的關係",
+ "viewer.passport.relations.list": "相連的關係",
+ "viewer.passport.copyRelation": "複製關係",
+ "viewer.passport.copyNode": "複製節點",
+ "viewer.passport.copyPinned": "複製固定關係的連結",
+ "viewer.passport.copySource": "複製來源節點的連結",
+ "viewer.passport.copy.focused.success": "已複製聚焦節點連結",
+ "viewer.passport.copy.pinned.success": "已複製固定關係連結",
+ "viewer.passport.copy.focused.failed": "無法複製聚焦節點連結",
+ "viewer.passport.copy.pinned.failed": "無法複製固定關係連結",
+ "viewer.passport.relationship.none": "沒有相連的關係",
+ "viewer.passport.relationship.count.one": "{count} 條關係",
+ "viewer.passport.relationship.count.other": "{count} 條關係",
+ "viewer.passport.relationship.show.one": "顯示 {count} 條相連的關係",
+ "viewer.passport.relationship.show.other": "顯示 {count} 條相連的關係",
+ "viewer.passport.relationship.summary": "{out} 條出向 · {in} 條入向{loops}",
+ "viewer.passport.relationship.loops": " · {count} 條自環",
+ "viewer.passport.relationship.explorer": "直接關係瀏覽",
+ "viewer.passport.relationship.help": "使用方向鍵瀏覽關係。按 Enter 或空格鍵固定詳細資訊;按 Escape 清除。",
+ "viewer.passport.relationship.loopsBack": "回到自身",
+ "viewer.passport.relationship.connectsTo": "連到",
+ "viewer.passport.relationship.connectsFrom": "來自",
+ "viewer.passport.relationship.pinned": "已固定關係 · {from} → {to} · {label}",
+ "viewer.passport.relationship.inspect": "檢查第 {index}/{total} 條關係:{from} 到 {to},{label}。按 Enter 檢視詳細資訊。",
+ "viewer.passport.relationship.group.out": "出向",
+ "viewer.passport.relationship.group.in": "入向",
+ "viewer.passport.relationship.group.loop": "自環",
+ "viewer.passport.relationship.row": "{group}:{relationship},{neighbor}",
+ "viewer.passport.relationship.direction.out": "出 →",
+ "viewer.passport.relationship.direction.in": "← 入",
+ "viewer.passport.relationship.direction.loop": "自環",
+ "viewer.passport.sourceCount.one": "{count} 個已驗證來源引用",
+ "viewer.passport.sourceCount.other": "{count} 個已驗證來源引用",
+ "viewer.passport.sourceMarker": "來源",
+ "viewer.passport.beacon.one": "{count} 個已驗證來源;聚焦此節點以檢查",
+ "viewer.passport.beacon.other": "{count} 個已驗證來源;聚焦此節點以檢查",
+ "viewer.passport.repository.open": "開啟已驗證的儲存庫版本 {revision}",
+ "viewer.passport.source.open": "開啟版本 {revision} 中已驗證的來源 {path}",
+ "viewer.passport.source.openLink": "開啟 ↗",
+ "viewer.passport.reach.upstream.one": "追蹤 {count} 個上游節點",
+ "viewer.passport.reach.upstream.other": "追蹤 {count} 個上游節點",
+ "viewer.passport.reach.downstream.one": "追蹤 {count} 個下游節點",
+ "viewer.passport.reach.downstream.other": "追蹤 {count} 個下游節點",
+ "viewer.passport.reach.noUpstream": "沒有上游節點",
+ "viewer.passport.reach.noDownstream": "沒有下游節點",
+ "viewer.passport.reach.status": "{direction} · {nodes} 個節點 · {links} 條連線 · 最多 {hops} 跳",
+ "viewer.route.eyebrow": "路徑",
+ "viewer.route.start": "點選路徑的起點",
+ "viewer.route.start.find": "尋找起點",
+ "viewer.route.start.find.aria": "尋找路徑起點",
+ "viewer.route.copy": "複製連結",
+ "viewer.route.copy.aria": "複製已追蹤路徑的連結",
+ "viewer.route.clear": "清除",
+ "viewer.route.clear.aria": "清除路徑探測",
+ "viewer.route.traced": "路徑",
+ "viewer.route.pickTwo": "在圖上點兩個節點",
+ "viewer.route.pickOne": "在圖上點一個節點",
+ "viewer.route.controls": "路徑旅程控制",
+ "viewer.route.previous": "上一個路徑位置",
+ "viewer.route.play": "播放路徑旅程",
+ "viewer.route.pause": "暫停路徑旅程",
+ "viewer.route.replay": "重播路徑旅程",
+ "viewer.route.next": "下一個路徑位置",
+ "viewer.route.journey": "旅程",
+ "viewer.route.pause.label": "暫停",
+ "viewer.route.replay.label": "重播",
+ "viewer.route.overview": "總覽",
+ "viewer.route.overview.aria": "顯示完整路徑總覽",
+ "viewer.route.instructions": "先點起點,再點終點,沿箭頭方向找路。",
+ "viewer.route.destination": "從{label}出發,走到哪裡?",
+ "viewer.route.destination.find": "尋找目標",
+ "viewer.route.destination.find.aria": "尋找可達的路徑目標",
+ "viewer.route.differentDestination": "選擇其他目標",
+ "viewer.route.distinct": "請選兩個不同的節點。",
+ "viewer.route.unreachable": "走不到{label}",
+ "viewer.route.unreachable.detail": "沿箭頭方向,從{source}走不到{target}。請選一個標示出來的節點。",
+ "viewer.route.start.instructions": "接著選終點,能走到的節點會亮起。",
+ "viewer.route.copy.success": "已複製路徑連結",
+ "viewer.route.copy.failed": "無法複製路徑連結",
+ "viewer.route.position": "路徑位置 {index}/{total}:{label}",
+ "viewer.route.step": "第 {index}/{total} 步 · {phase} · {label}",
+ "viewer.route.motionRequired": "自動旅程需要動態模式",
+ "viewer.route.trigger.clear": "清除已追蹤路徑",
+ "viewer.route.overview.status": "{nodes} · {hops} · 最短路徑",
+ "viewer.route.overview.node.one": "{count} 個節點",
+ "viewer.route.overview.node.other": "{count} 個節點",
+ "viewer.route.overview.hop.one": "{count} 步",
+ "viewer.route.overview.hop.other": "{count} 步",
+ "viewer.route.phase.playing": "播放中",
+ "viewer.route.phase.complete": "已完成",
+ "viewer.route.phase.inspecting": "檢查中",
+ "viewer.route.destination.count.one": "已標示出 {count} 個能走到的節點,點一下。",
+ "viewer.route.destination.count.other": "已標示出 {count} 個能走到的節點,點其中一個。",
+ "viewer.route.noOutgoing": "這個節點沒有向外的箭頭。清除後換一個起點。",
+ "viewer.route.result.title": "{source} 到 {target}",
+ "viewer.route.finder.source.title": "選擇路徑起點",
+ "viewer.route.finder.source.placeholder": "搜尋路徑來源",
+ "viewer.route.finder.source.empty": "沒有符合的路徑來源",
+ "viewer.route.finder.source.results": "可作為路徑起點的節點",
+ "viewer.route.finder.source.noun": "個路徑來源",
+ "viewer.route.finder.source.badge": "起點",
+ "viewer.route.finder.target.title": "從{label}出發的目標",
+ "viewer.route.finder.target.placeholder": "搜尋可達目標",
+ "viewer.route.finder.target.empty": "沒有符合的可達目標",
+ "viewer.route.finder.target.results": "可達路徑目標",
+ "viewer.route.finder.target.noun": "個可達目標",
+ "viewer.route.hop.one": "{count} 跳",
+ "viewer.route.hop.other": "{count} 跳",
+ "viewer.lens.eyebrow": "語意透鏡",
+ "viewer.lens.title": "比較系統角色",
+ "viewer.lens.close": "關閉語意透鏡",
+ "viewer.lens.instruction": "最多選兩種語意類型。選一種會顯示它實際的流量;選兩種只比較兩者之間的直接關係。",
+ "viewer.lens.kinds": "語意類型",
+ "viewer.lens.choose": "選擇一種類型,檢查它的節點和相連的關係。",
+ "viewer.lens.copy": "複製語意透鏡連結",
+ "viewer.lens.clear": "清除語意透鏡",
+ "viewer.lens.open": "開啟語意透鏡",
+ "viewer.lens.openActive": "開啟目前語意透鏡",
+ "viewer.lens.legend": "語意圖例",
+ "viewer.lens.legend.inspect.one": "檢查{label},{count} 個節點",
+ "viewer.lens.legend.inspect.other": "檢查{label},{count} 個節點",
+ "viewer.lens.kind.count.one": "{label},{count} 個節點",
+ "viewer.lens.kind.count.other": "{label},{count} 個節點",
+ "viewer.lens.compare.one": "{first} → {second}:{forward} · {second} → {first}:{reverse} · 共 {count} 條直接關係",
+ "viewer.lens.compare.other": "{first} → {second}:{forward} · {second} → {first}:{reverse} · 共 {count} 條直接關係",
+ "viewer.lens.single": "{nodes} · {relationships} · 已連線節點保持可見",
+ "viewer.lens.node.one": "{count} 個{label}節點",
+ "viewer.lens.node.other": "{count} 個{label}節點",
+ "viewer.lens.relationship.one": "{count} 條相連關係",
+ "viewer.lens.relationship.other": "{count} 條相連關係",
+ "viewer.radar.title": "語意雷達",
+ "viewer.radar.building": "正在建立總覽",
+ "viewer.radar.openFull": "開啟完整語意雷達",
+ "viewer.radar.open": "開啟雷達",
+ "viewer.radar.close": "關閉語意雷達",
+ "viewer.radar.surface": "圖的總覽。點選節點以聚焦,或用方向鍵平移。",
+ "viewer.radar.click": "點選節點",
+ "viewer.radar.drag": "拖曳平移",
+ "viewer.radar.space": "語意雷達需要更多空間。",
+ "viewer.radar.nodes": "語意圖表雷達節點",
+ "viewer.radar.focus": "從語意雷達聚焦{label}",
+ "viewer.radar.status": "{count} 個節點 · {viewport}",
+ "viewer.radar.fullMap": "{count} 個節點 · 完整地圖",
+ "viewer.radar.compacted": "已縮小雷達,避免擋住語意護照或地圖控制項。",
+ "viewer.radar.cancelWaiting": "取消等待空間的語意雷達",
+ "viewer.radar.needsSpace": "語意雷達需要更多可見空間",
+ "viewer.radar.viewport.full": "完整地圖",
+ "viewer.radar.viewport.width": "寬度 {percent}%",
+ "viewer.radar.viewport.scale": "可視範圍 {percent}%",
+ "viewer.nav.controls": "圖表檢視控制",
+ "viewer.nav.route": "追蹤有向路徑",
+ "viewer.nav.route.title": "追蹤路徑(R)",
+ "viewer.nav.route.short": "路徑",
+ "viewer.nav.radar": "開啟語意雷達",
+ "viewer.nav.radar.title": "語意雷達(M)",
+ "viewer.nav.radar.short": "地圖",
+ "viewer.nav.lens": "開啟語意透鏡",
+ "viewer.nav.lens.title": "語意透鏡(L)",
+ "viewer.nav.lens.short": "透鏡",
+ "viewer.nav.find": "尋找節點",
+ "viewer.nav.find.title": "尋找節點(/)",
+ "viewer.outline.title": "節點索引",
+ "viewer.rail.show": "要點與索引",
+ "viewer.rail.controls": "側欄",
+ "viewer.rail.collapse": "收起側欄",
+ "viewer.rail.bottom": "移到圖下方",
+ "viewer.rail.right": "移到圖右側",
+ "viewer.nav.guide": "開啟圖表指南",
+ "viewer.nav.guide.title": "圖表指南(?)",
+ "viewer.nav.zoomOut": "縮小",
+ "viewer.nav.zoomOut.title": "縮小(-)",
+ "viewer.nav.reset": "重設圖表檢視",
+ "viewer.nav.reset.title": "重設檢視(0)",
+ "viewer.nav.read": "閱讀",
+ "viewer.nav.zoomIn": "放大",
+ "viewer.nav.zoomIn.title": "放大(+)",
+ "viewer.nav.camera": "{hint}。重設圖表檢視",
+ "viewer.nav.camera.title": "{semantic}{hint} · 重設檢視(0)",
+ "viewer.nav.camera.semantic": "語意鏡頭已開啟 · ",
+ "viewer.nav.level.map": "概覽",
+ "viewer.nav.level.read": "閱讀",
+ "viewer.nav.level.full": "完整",
+ "viewer.nav.level.auto": "自動",
+ "viewer.nav.detail.map": "放大以顯示關係標籤和節點脈絡",
+ "viewer.nav.detail.read": "再放大以顯示標記和註解",
+ "viewer.nav.detail.full": "完整細節",
+ "viewer.intent.summary": "{label}。{out} 條出向,{in} 條入向{loops}。共 {total} 條連線。按 Enter 檢視詳細資訊。",
+ "viewer.intent.loops": ",{count} 條自環",
+ "viewer.common.copied": "已複製",
+ "viewer.common.copyFailed": "複製失敗",
+ "viewer.common.copyLink": "複製連結",
+ "viewer.common.clear": "清除",
+ "viewer.common.close": "關閉",
+ "diagram.description.erd": "由 Archify 產生的實體關聯圖。",
+ "node.context.erd": "實體",
+ "legend.erd.pk": "主鍵",
+ "legend.erd.fk": "外來鍵",
+ "legend.erd.uk": "唯一鍵",
+ "legend.erd.one": "一",
+ "legend.erd.many": "多",
+ "legend.erd.optional": "選填",
+ "diagram.description.tree": "由 Archify 產生的階層圖。",
+ "node.context.tree.root": "根節點",
+ "node.context.tree.branch": "分支節點",
+ "node.context.tree.leaf": "葉節點",
+ "tree.toggle.collapse": "收合 {label}(下方 {count} 項)",
+ "tree.toggle.expand": "展開 {label}(已隱藏 {count} 項)",
+ "tree.expandAll": "全部展開",
+ "diagram.description.class": "由 Archify 產生的類別與介面圖。",
+ "node.context.class.class": "類別",
+ "node.context.class.abstract": "抽象類別",
+ "node.context.class.interface": "介面",
+ "node.context.class.enum": "列舉",
+ "node.context.class.record": "記錄",
+ "legend.class.dependency": "相依",
+ "legend.class.association": "關聯",
+ "legend.class.inheritance": "繼承",
+ "legend.class.realization": "實作",
+ "legend.class.composition": "組合",
+ "legend.class.aggregation": "聚合",
+ "diagram.description.timeline": "由 Archify 產生的事件時間軸。",
+ "timeline.axis": "時間",
+ "timeline.break": "時間軸中斷:略過 {duration} 沒有事件的區間",
+ "timeline.compressed": "已壓縮 {count} 段無事件的期間(≈)",
+ "timeline.evidence.observed": "實際記錄的事件",
+ "timeline.evidence.illustrative": "示意資料",
+ "legend.timeline.default": "事件",
+ "legend.timeline.change": "變更",
+ "legend.timeline.alert": "警示",
+ "legend.timeline.action": "處置",
+ "legend.timeline.recovery": "復原",
+ "diagram.description.waterfall": "由 Archify 產生的執行瀑布圖。",
+ "waterfall.evidence.measured": "實測耗時",
+ "waterfall.evidence.illustrative": "示意耗時",
+ "waterfall.wall": "總耗時 {duration}",
+ "waterfall.share": "占總耗時 {total} 的 {percent}",
+ "waterfall.incomplete": "未完成,≥ {duration}",
+ "waterfall.operation": "操作",
+ "legend.waterfall.ok": "已完成",
+ "legend.waterfall.error": "錯誤",
+ "legend.waterfall.cancelled": "已取消",
+ "legend.waterfall.incomplete": "未完成(沒有結束記錄)"
+}
diff --git a/archify/references/authoring-contract.md b/archify/references/authoring-contract.md
index 1dc56249..ed70eb29 100644
--- a/archify/references/authoring-contract.md
+++ b/archify/references/authoring-contract.md
@@ -80,7 +80,7 @@ chooses one primary locale for the Viewer; follow an explicit primary-language
request, then prompt order or conversation dominance.
Bundled Viewer catalogs are enrolled in `locales/manifest.json`: currently
-`en`, `zh-CN`, `es`, and `ko`. For these, `meta.locale` alone selects the full
+`en`, `zh-CN`, `zh-TW`, `es`, and `ko`. For these, `meta.locale` alone selects the full
catalog. Tags match case-insensitively (`zh-cn` selects `zh-CN`), but region
and script variants are distinct: `zh-Hant`, `es-MX`, or `ko-KR` select no
bundled catalog.
diff --git a/archify/references/authoring-defaults.md b/archify/references/authoring-defaults.md
index 1ae97dde..201f014c 100644
--- a/archify/references/authoring-defaults.md
+++ b/archify/references/authoring-defaults.md
@@ -32,7 +32,7 @@ Examples show field shape, not legal values or source facts. Read the mode schem
## Presentation and modes
-Use one primary authored language from the user's choice or the request/conversation. Set `meta.locale`; `en`, `zh-CN`, `es`, and `ko` select a bundled Viewer catalog with nothing further. For other languages, supply `meta.translations` with reusable UI translations, or disclose the fixed Viewer UI and `<html lang>` English fallback. Keep exact product, code, protocol, command, API, and environment names while localizing surrounding explanation. See [Language consistency](authoring-contract.md#language-consistency) for bilingual cases.
+Use one primary authored language from the user's choice or the request/conversation. Set `meta.locale`; `en`, `zh-CN`, `zh-TW`, `es`, and `ko` select a bundled Viewer catalog with nothing further. For other languages, supply `meta.translations` with reusable UI translations, or disclose the fixed Viewer UI and `<html lang>` English fallback. Keep exact product, code, protocol, command, API, and environment names while localizing surrounding explanation. See [Language consistency](authoring-contract.md#language-consistency) for bilingual cases.
Omit `meta.visual_preset` for classic, `meta.subtitle` for a title-only header, `meta.legend` for truthful auto, and `meta.engineering_profile` for an ordinary system overview. Explicit styles and a subtitle require a user request. Use legend or deployment ownership under the [legend](authoring-contract.md#legend-contract) or [engineering profile](authoring-contract.md#engineering-profile-default) contracts. Branding is optional and explicit when a node names a real product; [Brand marks](brand-marks.md) gives lookup and capture rules for that branch. Never let a badge replace semantic type, label, or relationship facts. Set required `meta.output` to a portable POSIX-relative `.html` path within the working directory; see [Output path contracts](delivery-contract.md#output-path-contracts) for native path exceptions.
diff --git a/archify/schemas/README.md b/archify/schemas/README.md
index 1e7344db..767c865d 100644
--- a/archify/schemas/README.md
+++ b/archify/schemas/README.md
@@ -30,7 +30,7 @@ It also accepts `locale`, any well-formed language tag (schema pattern
`^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$`). The field selects the fixed Viewer UI,
renderer-owned default legend and accessibility copy, document-title suffix,
and `<html lang>` value; it does not translate authored strings. The bundled
-catalogs enrolled in `locales/manifest.json` (`en`, `zh-CN`, `es`, `ko`) are
+catalogs enrolled in `locales/manifest.json` (`en`, `zh-CN`, `zh-TW`, `es`, `ko`) are
selected by tag, case-insensitively; region and script variants are distinct
tags. Any other tag needs a matching `translations` object (see below) or the
renderer falls back to English and discloses it.
diff --git a/test/erd-i18n.test.mjs b/test/erd-i18n.test.mjs
index 8c77bfd0..c2c9f08e 100644
--- a/test/erd-i18n.test.mjs
+++ b/test/erd-i18n.test.mjs
@@ -74,7 +74,7 @@ test('ERD accepts partial translations through validate, render and deliver', t
test('ERD empty translations preserve locale-only artifacts byte for byte', t => {
const directory = workspace(t);
- for (const locale of ['en', 'zh-CN', 'es', 'ko']) {
+ for (const locale of ['en', 'zh-CN', 'zh-TW', 'es', 'ko']) {
const baseline = run(directory, fixture(undefined, locale));
assert.equal(baseline.status, 0, baseline.stderr);
const before = html(directory);
diff --git a/test/i18n.test.mjs b/test/i18n.test.mjs
index ca244b78..a5f1c524 100644
--- a/test/i18n.test.mjs
+++ b/test/i18n.test.mjs
@@ -151,7 +151,7 @@ async function loadArtifact(browser, artifactPath) {
}
test('zh-CN localizes renderer-owned output across all five modes without translating authored content', () => {
- assert.deepEqual(SUPPORTED_LOCALES, ['en', 'zh-CN', 'es', 'ko']);
+ assert.deepEqual(SUPPORTED_LOCALES, ['en', 'zh-CN', 'zh-TW', 'es', 'ko']);
for (const type of Object.keys(EXAMPLES)) {
const document = example(type);
const authoredTitle = document.meta.title;
diff --git a/test/skill-metadata.test.mjs b/test/skill-metadata.test.mjs
index 5c7ac196..c5352bf8 100644
--- a/test/skill-metadata.test.mjs
+++ b/test/skill-metadata.test.mjs
@@ -68,7 +68,7 @@ test('update awareness is notification-only and never replaces the requested wor
test('language behavior stays within the bounded locale contract', () => {
assert.match(defaults, /one primary authored language/);
assert.match(defaults, /user's choice or the request\/conversation/);
- assert.match(defaults, /`en`, `zh-CN`, `es`, and `ko` select a bundled Viewer catalog/);
+ assert.match(defaults, /`en`, `zh-CN`, `zh-TW`, `es`, and `ko` select a bundled Viewer catalog/);
assert.match(defaults, /meta\.translations/);
assert.match(defaults, /exact product, code, protocol, command, API, and environment names/);
assert.match(defaults, /Language consistency\]\(authoring-contract\.md#language-consistency\)/);