iCangJie · iCangJie · 爱仓颉 · 愛倉頡

iCangJie is a comprehensive Cangjie input method learning and character lookup tool for iPhone, iPad, and Mac. With a curated library of 27,000+ Han characters covering Cangjie 3rd and 5th Gen standards, radical breakdown, full/quick/mixed typing practice, a card-style daily quiz, 11 HTML tutorials, pinyin & Jyutping search, converter tools, 8 widgets, and optional iCloud sync, it is the all-in-one companion for mastering Cangjie — offline-first, privacy-respecting, zero third-party SDKs.

Built with pure SwiftUI. Current App Store version: 1.0.0.

Why iCangJie?

Most dictionary apps stop at cold codes. iCangJie is built for learners who actually type:

• See why a code is built that way — radical highlights and keyboard strips on every detail page.
• Drill with three typing modes, 16 classical passages (Simplified & Traditional), and wrong-book retry.
• Quiz yourself with a configurable daily quiz (5–15 questions, custom word source & code length).
• Track progress with 7/30-day typing reports and JSON backup for your learning data.
• Glance at progress on the Home Screen, Lock Screen, or StandBy with 8 purpose-built widgets.
• Ask Siri to look up a Cangjie code or start today’s quiz; index favorites in Spotlight.
• Switch the entire app to English, Simplified Chinese, or Traditional Chinese — UI refreshes instantly.

Getting Started

1. Complete the 5-screen onboarding on first launch (or skip anytime). Follow the Newcomer Path card in Learn for quick links.
2. Open Lookup and search by Cangjie code, character, pinyin prefix, or Jyutping — or tap the search prompt card on the resting screen.
3. Browse Levels by code length (1–5) or quick-method buckets; shuffle for random practice.
4. Enter Learn for HTML tutorials and pinch-zoom radical charts (adjustable reading size).
5. Try Typing — pick full-code, quick-code, or mixed mode; open Practice Report for trends.
6. Take the Daily Quiz — customize questions in quiz settings. Review mistakes in the Wrong Book.
7. Add widgets to your Home Screen or Lock Screen. Configure up to 4 Home Screen Quick Actions and optional Spotlight indexing in Settings.

Features

Dictionary & Lookup

• 27,000+ curated characters — Cangjie 3rd & 5th Gen; offline bundled JSON cleaned for renderable Han characters only.
• Four char-set priorities — Hong Kong, Taiwan Traditional, Simplified, and General — affect search ranking.
• Four search modes — Cangjie code prefix, exact character, pinyin prefix, and Jyutping prefix; smart hints when a mode returns no results.
• Home screen cards — Favorites, recent views, and quick code-length shortcuts (toggleable).
• Word detail — Large character tile, colored code badges, per-code radical keyboard strips; 3rd/5th Gen side-by-side compare for single characters; one-tap copy for character or codes; learning status, favorites, Youdao online lookup, and long-image share.

Levels (Code Length)

• Browse the full table by 3rd / 5th Gen × code length 1–5 or quick-method buckets.
• List or grid layout with device-aware column counts; pull to shuffle.

Typing Practice

• Three modes — Full code, quick code (levels 1–2), and mixed (try quick first, fall back to full after a mistake).
• Content sources — 16 built-in classical passages (SC/TC JSON), random word lists, pasted text, favorites, and wrong-book retry (auto-resolves the correct Han character).
• Live radical key highlights; optional passage pinyin; virtual keyboard with wrong-key keep or clear preference.
• Session stats (accuracy, streak) and daily aggregates (up to 120 days) sync via iCloud when enabled.
• Practice Report — 7/30-day typing trend chart and code-length distribution; open from Typing hub or Settings → Learning Stats.

Daily Quiz & Wrong Book

• Configurable quiz — 5 / 8 / 10 / 15 questions per day; word source: dictionary, favorites, or wrong book; code-length filter 1–5; toggle question types.
• Three types: character→code, code→character (with keyboard strip), and character→first radical key.
• Card-style UI with instant feedback and end-of-round wrong-answer review. Reshuffle for a fresh set. Gear icon opens Quiz Settings.

Learn (Tutorials & Onboarding)

• 5-screen onboarding on first launch; Newcomer Path card in Learn tab (lookup, quiz, first tutorial, widget guide).
• 11 HTML lessons + grouped radical chart images in the Learn hub.
• Adjustable reading size (85%–160%); HTML adapts to light/dark; Traditional script when app language is zh-Hant.
• Pinch-zoom charts; swipe gallery between images at 1× zoom; save to Photos or share (iOS).

Tools (Settings)

• Pinyin & Cangjie converter — Multiple output styles (toned, plain, numbered, annotated, aligned grid); optional Cangjie codes; copy or share preview image.
• Text-to-speech playground — Play, pause, and stop.
• Widget guide — Full catalog with Lock Screen steps and FAQ (iOS).
• Home Screen Quick Actions — Pick up to 4 from 7 options (search, quiz, favorites, wrong, levels, feedback, rate).
• Spotlight indexing (iOS) — Surface favorites & recents in system search (toggle in Settings).
• Siri & Shortcuts — Built-in App Intents: look up Cangjie code, start daily quiz, open lookup.
• JSON backup & restore — Export/import learning data (merge or replace) from Settings → Learning Stats.

Personalization

• 16 built-in gradient themes + custom accent color; light / dark / system appearance.
• In-app language — English, Simplified Chinese, Traditional Chinese, or follow system; widgets mirror language via App Group.
• List/grid layout preferences; pinyin overlay toggle; default Cangjie version and char-set.

iOS & iPad

• 8 widget kinds — Daily Character, Code Length, Daily Quiz, Typing Glance, Favorites, Wrong Book, Recent, Learning Progress. Home Screen, Lock Screen, and StandBy.
• Daily Character shuffle button on medium widgets (iOS 17+). Code Length widget: pick 1–5 when adding; shuffle button on medium to refresh the trio (iOS 17+).
• Favorites / Wrong / Recent widgets show 2×3 (small) / 3×3 (medium) rice-grid previews with codes.

macOS

• Native Mac app with transparent navigation chrome, Esc back navigation, system share sheet, and full typing practice.
• Lookup search integration; floating Safari sheet for external links in tutorials.

Privacy

• Offline core — Dictionary, quizzes, tutorials, and typing work without network.
• No ads · No tracking — No analytics SDKs. Optional iCloud uses Apple KVS only.
• Photo library access is requested only when you choose to save a radical chart image (add-only).

Widgets

iCangJie offers 8 widget kinds for Home Screen, Lock Screen, and StandBy. See the in-app Widget Guide (Settings → Tools) for step-by-step setup, a visual catalog, and FAQ.

Widget accent follows your app theme (optional neutral background in Settings).

Deep Links & Quick Actions

iCangJie:// supported paths: search, word, quiz, typing, favorites, wrong, levels, learn, feedback, review.

Built-in Siri phrases and Shortcuts App Intents also open lookup, word detail, and quiz. See the URL Scheme Reference for parameters, App Intents, and Shortcuts examples.

System Requirements

Lock Screen accessories require iOS 16+. Some widget interactions require iOS 17+.

Data Sources

Cangjie dictionary data is credited in-app and drawn from community projects including Cangjie5, Cangjie3-Plus, rime-cangjie, and rime-cantonese (Jyutping, CC-BY-4.0). Typing passages are public-domain classical Chinese texts.

Contact Us

• Email: AppleOSer@gmail.com
• GitHub Issues: github.com/iHTCTeam/iApp/issues

We typically respond within 48 hours.

FAQ · URL Scheme · Privacy Policy

爱仓颉（iCangJie） 是一款面向 iPhone、iPad 与 Mac 的 仓颉输入法 学习与查字工具。精选 2.7 万+ 常用汉字，覆盖仓颉三代与五代码表；字根拆分、完整/速成/混合 打字练习、卡片式 每日测验、11 篇 HTML 教程、拼音与粤拼搜索、转换工具、8 款小组件 与可选 iCloud 同步——离线优先、尊重隐私、零第三方 SDK。

纯 SwiftUI 构建。当前 App Store 版本：1.0.0。

为什么用爱仓颉？

普通字典只给你冷冰冰的编码。爱仓颉为 真正想练打字的人 设计：

• 字根拆分 + 键盘条，拆码原理一眼看懂，不再死记硬背。
• 三种打字模式、16 篇简繁古典名篇、错题本智能重练，零碎时间也能巩固手感。
• 可配置每日测验（5–15 题、字词来源、码长与题型），答完即看错题回顾。
• 练习报告 看 7/30 天打字曲线；JSON 备份 守护学习进度。
• 8 款主屏/锁屏 Widget；Siri 查码、开测验；Spotlight 索引收藏与最近。
• 应用内 英文 / 简体 / 繁体 即时切换，界面文案立即刷新。

快速上手

1. 首次启动完成 五屏引导（可随时跳过）；学习 Tab 新手路径 卡片一键入门。
2. 在 查字 按仓颉码、汉字、拼音或粤拼搜索；空态时点击 搜索引导卡。
3. 在 码长 按 1–5 码或速成法浏览整表，支持列表/网格与洗牌。
4. 进入 学习 阅读 HTML 教程，字根图支持捏合缩放与画廊左右滑。
5. 打开 打字 练完整码/速成/混合，在 练习报告 查看趋势。
6. 完成 每日测验（可在测验设置中自定义）；在错题本复习答错的字。
7. 添加 小组件；在设置中配置 主屏快捷操作 与 Spotlight 索引。

主要功能

查字与字典

• 2.7 万+ 精选汉字 — 仓颉三代 + 五代；离线内置，仅保留可渲染汉字。
• 四套字集优先级 — 香港 / 台湾 / 简体 / 综合，影响搜索结果排序。
• 四种搜索 — 仓颉码前缀、汉字、拼音前缀、粤拼前缀；无结果时智能提示切换模式。
• 首页卡片 — 收藏、最近浏览、快捷码长（可单独开关）。
• 字词详情 — 米字格、字根键盘条；单字 三代/五代并排对照；一键复制汉字或编码；有道查词、长图分享、收藏与学习状态。

码长

• 按 三代/五代 × 1–5 码 或 速成法 分桶浏览。
• 列表/网格、设备自适应列数、下拉 洗牌。

打字练习

• 三种模式 — 完整码、速成（1–2 码）、混合（先速成后全码）。
• 内容来源 — 16 篇简繁内置名篇、随机字表、粘贴文本、收藏、错题本（自动解析单字）。
• 实时 字根键位高亮；篇章可选拼音；错键可 保留或清空。
• 练习报告 — 7/30 天打字字数曲线、码长分布；打字 Hub 或设置 → 学习统计进入。
• 按日统计保留约 120 天；可选 iCloud 同步。

每日测验与错题本

• 可配置测验 — 题量 5/8/10/15；来源：字典/收藏/错题本；码长 1–5；题型可单独开关。
• 字→码、码→字（含键盘条）、字→首键；完成页 错题回顾；齿轮打开 测验设置。
• 支持 重新出题；错题供打字重练。

教程与引导

• 五屏首次引导；学习 Tab 新手路径（查字、测验、首篇教程、Widget 教程）。
• 11 篇 HTML + 分组 字根图。
• 可调字号（85%–160%）；HTML 深浅自适应；繁体语言下简转繁。
• 字根图捏合缩放、1× 时画廊左右滑、保存相册/分享（iOS）。

工具（设置）

• 拼音/仓颉转换器 — 多格式输出 + 可选仓颉码；复制或 预览长图分享。
• 语音朗读 — 播放 / 暂停 / 停止。
• Widget 教程 — 添加步骤、锁屏说明、8 Widget 图鉴与 FAQ。
• 主屏快捷操作 — 7 项中选 4 项。
• Spotlight 索引 — 收藏与最近浏览写入系统搜索（iOS，可开关）。
• Siri / 快捷指令 — 查仓颉码、开始测验、打开查字。
• JSON 备份与恢复 — 设置 → 学习统计；合并或覆盖导入。

个性化

• 16 套渐变主题 + 自定义取色；浅色/深色/跟随系统。
• 应用内三语；小组件经 App Group 同步语言与主题色。
• 列表/网格、拼音显示、默认仓颉版本与字集等偏好。

iOS 与 iPad

• 8 款小组件 — 今日一字、码长精选、每日测验、打字一览、收藏、错题、最近、学习进度；主屏、锁屏、StandBy。
• 今日一字中尺寸 换字；码长 Widget 添加时选 1–5 码，中尺寸 换一组（iOS 17+）。
• 收藏/错题/最近为中/小尺寸 米字格网格 预览。

macOS

• 原生 Mac 体验：Esc 返回、系统分享、完整打字练习；教程外链系统浏览器打开。

隐私

• 核心离线 — 字典、测验、教程、打字无需联网。
• 无广告 · 无追踪 — 无统计 SDK；iCloud 仅用 Apple KVS。
• 仅在 保存字根图到相册 时请求相册写入权限。

小组件

爱仓颉提供 8 款小组件。完整添加教程、图鉴与 FAQ 见应用内 设置 → 工具 → Widget 教程。

深度链接与快捷操作

iCangJie:// 支持：search、word、quiz、typing、favorites、wrong、levels、learn、feedback、review。

详见 URL Scheme 文档（含 Siri App Intents）。

系统要求

数据来源

仓颉字典数据见应用内关于页，来源于 Cangjie5、Cangjie3-Plus、rime-cangjie、rime-cantonese 等社区项目。打字篇章为公有领域古典文学。

联系我们

• 邮箱： AppleOSer@gmail.com
• GitHub Issues： github.com/iHTCTeam/iApp/issues

我们通常会在 48 小时内回复。

常见问题 · URL Scheme · 隐私政策

愛倉頡（iCangJie） 是一款面向 iPhone、iPad 與 Mac 的 倉頡輸入法 學習與查字工具。精選 2.7 萬+ 常用漢字，涵蓋倉頡三代與五代碼表；字根拆分、完整/速成/混合 打字練習、卡片式 每日測驗、11 篇 HTML 教程、拼音與粵拼搜尋、轉換工具、8 款小工具 與可選 iCloud 同步——離線優先、尊重隱私、零第三方 SDK。

純 SwiftUI 構建。目前 App Store 版本：1.0.0。

為什麼用愛倉頡？

普通字典只給你冷冰冰的編碼。愛倉頡為 真正想練打字的人 設計：

• 字根拆分 + 鍵盤列，拆碼原理一眼看懂，不再死記硬背。
• 三種打字模式、16 篇簡繁古典名篇、錯題本智能重練，零碎時間也能鞏固手感。
• 可配置每日測驗（5–15 題、字詞來源、碼長與題型），答完即看錯題回顧。
• 練習報告 看 7/30 天打字曲線；JSON 備份 守護學習進度。
• 8 款主畫面/鎖屏 Widget；Siri 查碼、開測驗；Spotlight 索引收藏與最近。
• 應用內 英文 / 簡體 / 繁體 即時切換，介面文案立即刷新。

快速上手

1. 首次啟動完成 五屏引導（可隨時跳過）；學習 Tab 新手路徑 一鍵入門。
2. 在 查字 依倉頡碼、漢字、拼音或粵拼搜尋；空態時點擊 搜尋引導卡。
3. 在 碼長 依 1–5 碼或速成法瀏覽；列表/網格與洗牌。
4. 進入 學習 閱讀 HTML 教程，字根圖捏合縮放與畫廊左右滑。
5. 開啟 打字 練完整碼/速成/混合，在 練習報告 查看趨勢。
6. 完成 每日測驗（可於測驗設定自訂）；在錯題本複習。
7. 新增 小工具；設定 主畫面快速操作 與 Spotlight 索引。

主要功能

查字與字典

• 2.7 萬+ 精選漢字 — 倉頡三代 + 五代；離線內建，僅保留可渲染漢字。
• 四套字集優先順序 — 香港 / 台灣 / 簡體 / 綜合。
• 四種搜尋 — 倉頡碼前綴、漢字、拼音前綴、粵拼前綴；無結果時智能提示切換。
• 首頁卡片 — 收藏、最近瀏覽、快捷碼長。
• 字詞詳情 — 米字格、字根鍵盤列；單字 三代/五代並排對照；一鍵複製；有道查詞、長圖分享。

碼長

• 依 三代/五代 × 1–5 碼 或 速成法 分桶；列表/網格、洗牌。

打字練習

• 完整碼 / 速成 / 混合；16 篇簡繁名篇、字表、收藏、錯題本。
• 練習報告：7/30 天曲線、碼長分佈；按日統計約 120 天。

每日測驗與錯題本

• 題量 5–15、來源、碼長、題型可配置；齒輪開啟 測驗設定；可重新出題。

教程與引導

• 五屏引導 + 新手路徑；11 篇 HTML + 字根圖；可調字號、簡轉繁、畫廊、儲存/分享。

工具

• 拼音/倉頡轉換器、語音朗讀、Widget 教學、快速操作、Spotlight、Siri、JSON 備份。

個人化

• 16 套主題 + 自訂色；應用內三語；iCloud 可選同步。

iOS

• 8 款小工具；碼長中尺寸 換一組（iOS 17+）。

隱私

• 核心離線；無廣告無追蹤；儲存字根圖時才請求相簿權限。

小工具

完整教學見 設定 → 工具 → Widget 教學。

深度連結

iCangJie:// 支援：search、word、quiz、typing、favorites、wrong、levels、learn、feedback、review。

詳見 URL Scheme 文件（含 Siri App Intents）。

系統需求

聯絡我們

• 電子郵件： AppleOSer@gmail.com
• GitHub Issues： github.com/iHTCTeam/iApp/issues

常見問題 · URL Scheme · 隱私政策