Skip to content
CAI
Software that uses CAICheck a score

tw93/MiaoYan

49.5

Weak · 14 November 2026

37.9k

lines of production code

Swift

primary language

7

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Added Simplified Chinese localization for MiaoYan

The application now displays its user interface in Simplified Chinese. This change adds the \zh-Hans.lproj\ localization bundle, including \Localizable.strings\ for core UI elements (menus, dialogs, settings), \Main.strings\ for menu titles and window labels, \ContentViewController.strings\ for metadata labels, and \InfoPlist.strings\ for the app name and bundle display name. Also in this area: 2 commits (0 fixes) modifying Resources; 2 commits (1 fix) modifying Resources; Simplified UI copy and refined localization strings; Localization updates and UI adjustments in the main window; Updated in-app guides and added attachment cleanup safety message.

Resources/Localization/zh-Hans.lproj · medium confidence · unverified

Added syntax highlighting support for presentations

The presentation plugin now includes a bundled version of the Highlight.js library (v10.7.0) to enable syntax highlighting for code blocks within slides. This addition introduces a new \highlight.js\ file in the plugin directory, providing the core engine for rendering highlighted code snippets in the PPT viewer.

Resources/DownView.bundle/ppt/plugin · high confidence

Initial project structure and source file registration

The MiaoYan Xcode project has been initialized with a comprehensive set of source files, frameworks, and resources. This includes the core application components (AppDelegate, MainWindowController, ViewController), UI elements (Sidebar, Editor, Preview, Settings), and supporting modules (CloudSync, PinService, FontConfiguration). The project also registers key third-party dependencies such as CMarkGFM, Highlightr, Sparkle, and KeyboardShortcuts, along with test targets for various features like HTML management, font handling, and storage logic.

MiaoYan.xcodeproj · high confidence

Initial repository structure and configuration

The repository is initialized with the foundational configuration files required for the MiaoYan project, including \.gitattributes\ and \.gitignore\ to manage version control and build artifacts, \.swift-format\ and \.swiftlint.yml\ to enforce code style and quality standards, and \Info.plist\ defining the macOS application metadata and entitlements. Essential documentation files such as \AGENTS.md\, \ARCHITECTURE.md\, \DEPENDENCIES.md\, \LICENSE\, \README\_CN.md\, \CONTRIBUTING.md\, and \CODE\_OF\_CONDUCT.md\ are added to guide development and usage, alongside entitlement files for the macOS and iOS targets.

(repo-wide) · high confidence

Introduce SwiftUI-based Shell window with storyboard parity

A new SwiftUI-driven shell window is available (activated via the -MiaoYanShell YES launch argument) that replicates the functionality and layout of the existing AppKit storyboard window. This implementation includes a split-view editor with adjustable pane widths, a sidebar for folder management (create, move, rename, delete), and export capabilities for PDF, images, HTML, and Reveal.js decks. The shell maintains state parity with the storyboard window, including layout persistence, folder expansion states, and live light/dark mode switching, while introducing features like multi-note selection and search-to-note creation.

Shell · high confidence

Introduce split-view settings and unified preferences architecture

The application now features a redesigned Preferences window with a sidebar navigation and dedicated pages for General, Editor, and Typography settings. This change introduces specific configuration options for the new split-view mode, allowing users to toggle between single and split layouts directly from the General settings. Additionally, the Editor settings page provides controls for line break styles, image upload services, and preview location/width, while the General settings page manages appearance, language, storage location, and always-on-top behavior. The underlying controller architecture has been refactored to support this modular preferences structure, including new view controllers for handling these specific settings and a centralized base class for preference form layout.

Controllers · high confidence

Japanese and Traditional Chinese localization files added

The application now includes localized user interface strings for Japanese (ja) and Traditional Chinese (zh-Hant). This change adds new \.strings\ files for the main menu, settings, content view, and system info, enabling these languages to be displayed in the app's menus, dialogs, and preferences.

Resources/Localization/ja.lproj, Resources/Localization/zh-Hant.lproj · high confidence

New CLI tool, installer, and build/test automation scripts

This change introduces the \miao\ command-line interface for managing notes (open, list, search, cat, new) and an \install.sh\ script to install it via Homebrew-style paths. It also adds \build.sh\ for creating unsigned app archives and DMGs with custom Finder layouts, \add\_tests\_target.rb\ to automate adding the \MiaoYanTests\ Xcode target and wiring it to the scheme, and \wire\_helper\_files.rb\ to ensure specific Swift helper files are included in the Xcode project build phase.

scripts · high confidence

New MiaoYan App entry point with enhanced Markdown rendering and image handling

The DownView bundle now initializes via a new MiaoYanApp entry point that integrates common utilities for improved Markdown preview. This includes wrapping wide tables in scrollable containers to prevent content clipping, enabling interactive checkboxes that sync with the host app, and implementing aggressive lazy loading for images using Intersection Observer to improve performance. Additionally, the bundle now includes auto-render.min.js for default LaTeX math support and d3.min.js (v6.7.0) to support markmap visualizations. Also in this area: Improved preview styling and copy behavior; Warmer theme colors and precise task-item editing in preview.

Resources/DownView.bundle/js · high confidence

New PPT presentation themes (Night and White) added

The PPT preview engine now supports two new visual themes, 'Night' and 'White', in addition to existing options. These themes provide distinct styling for text, backgrounds, code syntax highlighting, and interactive elements like links and selections, allowing users to choose a color scheme that best fits their content or preference.

Resources/DownView.bundle/ppt/dist/theme · high confidence

New helper modules for syntax highlighting, clipboard management, and file system events

The Helpers directory now includes several new modules that enhance the editor's core capabilities. BacktickAndFontNormalizer and CodeBlockHighlighter manage syntax highlighting for code blocks and inline code, with performance optimizations for large files. ClipboardManager handles rich text pasting by converting structured HTML to Markdown and supports image uploads via PicGo/PicList. FileSystemEventManager and FileWatcher integrate FSEvents to detect external file changes, enabling live reloads and automatic note imports. Diagnostics provides a structured logging sink for error tracking, and EditorMenuManager centralizes formatting actions. Also in this area: 4 commits (4 fixes) fixing Helpers; Improved typing, search, and sorting performance; Unified code and HTML tag coloring in the editor; Refined visual theme and clarified user-facing messages; Fix sidebar folder selection after upgrading from v4.5.0; and 1 more.

Helpers · medium confidence · unverified

New utility extensions for export, formatting, and system integration

The Extensions directory now includes a suite of new helper files to support core application features. MPreviewView+Export introduces a robust export pipeline with progress tracking, timeout protection, and dynamic style injection for PDF and image outputs. ImageAttachment+ and NSImage+ provide comprehensive image handling, including caching, thumbnail generation, and resizing. NSMenu+ centralizes menu icon management using a symbol registry, while NSFont+, NSMutableAttributedString+, and NSTextStorage+ handle text styling, letter spacing, and paragraph layout. Additional extensions like Date+, FileManager+, NSColor+, String+, and URL+ add utility functions for date formatting, file system checks, CSS color parsing, regex caching, and extended attribute management.

Extensions · high confidence

Behavioural changes

5 commits (1 fix) modifying Resources

A change to existing behaviour in Resources — 5 commits (1 fix), 3 files: “feat: ship appfiles.json in the app bundle”; “chore: move DMG background image to Resources/”; “fix: ship the Markdown document icon so Finder shows MiaoYan on .md files”; and 1 more.

Resources · medium confidence · unverified

Automated release pipeline with notarization and per-language release notes

The release process now automates the full build, notarization, and publishing workflow. The new \build\_notarize\_package.sh\ script handles code signing, notarization (supporting both API key and Apple ID credentials), and creates a DMG with a custom background and Finder layout. Release content generation has been split: \generate\_release\_content.sh\ creates structured JSON highlights (with an AI fallback), while \notes\_to\_html.sh\ and \render\_release\_body.sh\ convert \RELEASE\_NOTES.md\ into HTML. Crucially, the appcast update (\update\_appcast.sh\) now supports per-language release notes (\en\ and \zh-Hans\), allowing Sparkle to display the correct language to users based on their system settings. Signature verification is also hardened with a new \verify\_sparkle\_signature.sh\ script.

scripts/release-ci · high confidence

Centralized font management and unified environment facade

The app now uses a centralized font configuration system that classifies installed fonts into text, code, and Latin categories, displaying them in localized sections within the font picker and ensuring proper fallback stacks for mixed-script content. A new AppEnvironment facade centralizes access to core services like storage and session state, replacing scattered singleton usage. Additionally, the default editor font has shifted to TsangerJinKai02 (now a system-installed font rather than bundled), with a dedicated download link provided if the user does not have it installed. Also in this area: 3 commits (1 fix) modifying Business; Improved typing, search, and sorting performance; Updated quote styling and fixed folder date caching; Fixes for backlink accuracy, folder placement, and trash visibility; Fixes for HTML export, font defaults, and note integrity; and 2 more.

Business · medium confidence · unverified

Introduce ContentViewController UI and restructure main menu

The app now displays note metadata (word count, creation time, and update time) in a dedicated ContentViewController view, replacing the previous layout. The main menu has been reorganized to include a Folder submenu with options like New Folder, Rename Folder, Show in Finder, and Open in Terminal, while the File menu now features Search (⌘/), Reload Note (⇧⌘R), and Clean Unused Attachments (⌃⌥⌘C). These changes improve navigation and provide quick access to file management and note details.

Resources/Localization/Base.lproj · high confidence

New Xcode build schemes for MiaoYan and MiaoYanMobile

The project now includes dedicated Xcode schemes for the desktop (MiaoYan) and mobile (MiaoYanMobile) targets. These schemes configure the build, test, and archive actions, ensuring that archive operations for both targets use the AppStore build configuration to streamline the release process.

MiaoYan.xcodeproj/xcshareddata · high confidence

Redesigned Markdown preview and PPT export with enhanced rendering and dark mode support

The DownView bundle has been completely restructured with new \index.html\ and \ppt.html\ templates to improve the user experience. The preview view now features robust dark mode support via CSS variables, lazy-loaded images, and immediate text rendering to prevent layout shifts. It also supports Table of Contents pinning, clickable checkboxes, and math formula rendering (KaTeX) deferred via \requestIdleCallback\ for performance. The PPT export view now integrates Reveal.js with dedicated support for Mermaid, PlantUML, and Markmap diagrams, allowing for inline configuration of presentation settings via markdown comments and handling PDF export flags robustly.

Resources/DownView.bundle · high confidence

Replaced storyboard-based UI with programmatic editor, preview, and split-view components

The application's user interface has been rebuilt from scratch using programmatic Cocoa views, removing reliance on Storyboards and Interface Builder. This change introduces new core components including EditTextView for the editor, MPreviewView for Markdown rendering, and EditorContentSplitView to manage the split-pane layout. The new implementation provides a more robust split-view experience with animated mode switching (editor-only, preview-only, side-by-side), custom search and replace bars for both the editor and preview, and improved handling of image previews and keyboard interactions. Also in this area: 3 commits (2 fixes) fixing Views; 1 commit (1 fix) fixing Views; 4 commits (2 fixes) modifying Views; 1 commit (0 fixes) modifying Views; Improved preview rendering for formulas and diagrams during typing; and 3 more.

Views · medium confidence · unverified

Standardized app theme colors and dark mode assets

The app's visual theme has been updated with a new, standardized color palette and dedicated dark mode assets. This includes new color definitions for the main background, text, titles, highlights, and dividers, ensuring consistent appearance across light and dark modes. Additionally, several UI icons (such as home, new note, and pin note) now have specific SVG assets for dark mode, replacing the previous system-tinted approach for better visual control.

Resources/Images.xcassets · high confidence

Updated PPT preview engine to reveal.js 4.3.1

The PPT preview component now uses reveal.js version 4.3.1 (previously an older version) for rendering slides. This update brings improved CSS resets, better handling of slide fragments and stacking contexts, and enhanced support for embedded media and responsive layouts within the presentation viewer.

Resources/DownView.bundle/ppt/dist · high confidence

Fixes

182 commits (131 fixes) fixing MiaoYanTests

A fix in MiaoYanTests — 182 commits (131 fixs), 39 files: “fix(editor): command-t flips only the task box”; “fix: toggle the checkbox that was clicked in the preview”; “fix(export): mind maps no longer come out blank in PDF and PNG exports”; and 179 more.

MiaoYanTests · medium confidence · unverified

48 commits (26 fixes) fixing Resources/Localization/es.lproj

A fix in Resources/Localization/es.lproj — 48 commits (26 fixs), 6 files: “feat(sidebar): mark All Notes as selected and title the list All Notes”; “fix: stop calling TsangerJinKai02 the default font in its install alert”; “feat(sidebar): files opened from Finder list under Opened, the library stays”; and 45 more (refs \#528).

Resources/Localization/es.lproj · medium confidence · unverified

Fixes to note parsing, previews, and search accuracy

The MiaoYanCore package now correctly handles YAML frontmatter by verifying it contains actual key-value pairs, preventing slide decks starting with '---' from losing their first slide. Card previews no longer duplicate the note's title by stripping an opening H1 that matches the filename, and search results now guarantee that exact title matches are never dropped by earlier body matches. Additionally, notes encoded in GBK/GB18030 are now readable during search, and the search reader supports cancellation and files larger than the previous chunk limit. Also in this area: Improved typing, search, and sorting performance; Improved note preview cleanliness and legacy encoding detection. Also in this area: 1 commit (1 fix) fixing Packages/MiaoYanCore; 3 commits (3 fixes) fixing Packages/MiaoYanCore; 3 commits (1 fix) modifying Packages/MiaoYanCore.

Packages/MiaoYanCore · medium confidence · unverified

Redesigned Markdown preview with new typography, theme, and diagram styling

The Markdown preview rendering has been overhauled with a new set of CSS files that replace the previous styling. This introduces a refined typographic system (based on Heti) with adjusted letter-spacing and line-heights, and a new theming architecture using CSS variables for light and dark modes. Key visual improvements include better handling of wide GFM tables (scrollable wrappers instead of breaking layout), corrected Mermaid diagram edge label backgrounds, and proper clamping of HDR photos to SDR on iOS/macOS. The preview now also supports KaTeX v0.16.0 for math rendering and includes dedicated styles for TOC navigation, Markmap, and PlantUML diagrams. Also in this area: Improved preview styling and copy behavior; Refined visual styling for blockquotes, alerts, and table of contents; Warmer theme colors and precise task-item editing in preview.

Resources/DownView.bundle/css · high confidence

Dependencies

Migrate to Swift Package Manager and upgrade to Swift 6

The project has replaced its previous dependency management system with Swift Package Manager, introducing a new Package.swift manifest and resolved lockfiles. This migration includes an upgrade to Swift 6 and sets the minimum deployment targets to macOS 11 and iOS 18. The dependency list now explicitly pins Highlightr (2.3.0), KeyboardShortcuts (2.4.0), Prettier (0.2.1), swift-cmark-gfm (1.0.2), and Sparkle (2.8.0 in the root manifest, 2.9.0 in the workspace manifest).

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 47 → 50 (+2.5)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 72 → 71 (-0.6)
  • Architecture 80 → 83 (+3.0)
  • Maturity 71 → 73 (+1.6)
  • Readiness 41 → 47 (+6.5)
  • Security 80 → 74 (-6.3)
  • Accessibility 34 → 35 (+1.4)
  • Performance 78 → 100 (+22.3)

Resolved (38)

  • Boundary-crossing change coupling: String+.swift ↔ EditTextView.swift (Extensions/String+.swift)
  • Boundary-crossing change coupling: ViewController.swift ↔ Toast.swift (Controllers/ViewController.swift)
  • Duplicated block (10 lines × 2) (Helpers/TextFormatter.swift)
  • Duplicated block (12 lines × 2) (Controllers/ViewController+Editor.swift)
  • Duplicated block (14 lines × 2) (Controllers/ViewController+Action.swift)
  • Duplicated block (17–18 lines × 2) (Views/EditTextView.swift)
  • Duplicated block (3–10 lines × 3) (Business/HtmlManager.swift)
  • Duplicated block (3–5 lines × 3) (Business/HtmlManager.swift)
  • Duplicated block (5 lines × 2) (Helpers/CustomTextStorage.swift)
  • Duplicated block (6 lines × 2) (Extensions/MPreviewView+Export.swift)
  • Duplicated block (6 lines × 2) (Views/EditTextView.swift)
  • Duplicated block (6 lines × 4) (Helpers/TextFormatter.swift)
  • Duplicated block (7 lines × 2) (Helpers/CustomTextStorage.swift)
  • Duplicated block (7–9 lines × 4) (Helpers/MarkdownRuleHighlighter.swift)
  • Duplicated block (8 lines × 2) (Controllers/ViewController+Editor.swift)
  • Duplicated block (8 lines × 2) (Helpers/TextFormatter.swift)
  • Duplicated block (9–10 lines × 2) (Business/Storage.swift)
  • EditTextView.renderPreviewContent (cognitive 31) (Views/EditTextView.swift)
  • EditTextView.renderPreviewContent (cyclomatic 17) (Views/EditTextView.swift)
  • Hotspot: Business/Markdown.swift (Business/Markdown.swift)
  • …and 18 more

New (87)

  • Duplicated block (12 lines × 2) (Controllers/ViewController+Editor.swift)
  • Duplicated block (14 lines × 2) (Controllers/ViewController+Action.swift)
  • Duplicated block (17–18 lines × 2) (Business/Storage.swift)
  • Duplicated block (18–19 lines × 2) (Views/EditTextView.swift)
  • Duplicated block (5 lines × 2) (Helpers/CustomTextStorage.swift)
  • Duplicated block (6 lines × 2) (Controllers/ViewController+Action.swift)
  • Duplicated block (6 lines × 2) (Helpers/ImageLinkParser.swift)
  • Duplicated block (6 lines × 4) (Helpers/TextFormatter.swift)
  • Duplicated block (7 lines × 2) (Helpers/CustomTextStorage.swift)
  • Duplicated block (8 lines × 2) (Helpers/TextFormatter.swift)
  • Duplicated block (9 lines × 2) (Business/HtmlManager.swift)
  • Duplicated block (9 lines × 2) (Helpers/ClipboardManager.swift)
  • EditTextView.renderPreviewContent (cognitive 32) (Views/EditTextView+Preview.swift)
  • EditTextView.renderPreviewContent (cyclomatic 18) (Views/EditTextView+Preview.swift)
  • Edited copies of one member (3 members, 5+ corresponding lines) (Helpers/HtmlToMarkdown.swift)
  • Edited copies of one member (5 members, 19+ corresponding lines) (Extensions/NSFont+.swift)
  • Edited copy of a member (10 corresponding lines) (Controllers/ViewController+Editor.swift)
  • Edited copy of a member (11 corresponding lines) (Business/Sidebar.swift)
  • Edited copy of a member (11 corresponding lines) (Controllers/AppDelegate.swift)
  • Edited copy of a member (12 corresponding lines) (Views/PrefsControls.swift)
  • …and 67 more

Changes since last survey

  • 221 commits — 114 feature/other, 107 fixes

By area

  • (root) — 29 commits
  • docs/incidents.md — 22 commits
  • Resources/Localization — 19 commits
  • Resources/DownView.bundle — 15 commits
  • (repo) — 9 commits
  • .github/RELEASE_NOTES.md — 9 commits
  • Business/Note.swift — 8 commits
  • Packages/MiaoYanCore — 8 commits
  • Business/HtmlManager.swift — 7 commits
  • Helpers/Theme.swift — 7 commits
  • Controllers/ViewController+Editor.swift — 6 commits
  • MiaoYanTests/MediaPlaceholderTests.swift — 5 commits
  • MiaoYanTests/PreviewPatchTests.swift — 5 commits
  • docs/weekly-audit.md — 5 commits
  • Business/Storage.swift — 4 commits
  • Controllers/ViewController+Action.swift — 4 commits
  • Helpers/ClipboardManager.swift — 4 commits
  • Helpers/TextFormatter.swift — 4 commits
  • Helpers/FileSystemEventManager.swift — 3 commits
  • Helpers/NotesTextProcessor.swift — 3 commits

Notable commits

  • fix: fix(alert): read the glass corner only from a view that has one
  • fix: fix(attachments): keep parent-folder files a subfolder note reaches with ../
  • fix: fix(core): Return leaves a thematic break alone and keeps a CRLF note's line endings
  • fix: fix(core): Return on a line with U+2028 no longer deletes the line
  • fix: fix(core): damaged UTF-8 needs four good sequences per bad one
  • fix: fix(core): indent under an ordered item nests at its content column
  • fix: fix(core): toggle task on a quote line keeps the quote
  • fix: fix(editor): a note dragged from the list is not imported as a file
  • fix: fix(editor): accept photos dragged from Photos, Mail and browsers
  • fix: fix(editor): an underscore inside a word no longer marks italic
  • fix: fix(editor): clamp the caret the storyboard refill puts back
  • fix: fix(editor): command-t flips only the task box
  • fix: fix(editor): files dropped from Finder are copied and linked like a paste
  • fix: fix(editor): format is one undo step in both windows
  • fix: fix(editor): link caret, CRLF list continuation, tab selection length
  • fix: fix(editor): markers in inline code no longer colour the prose between
  • fix: fix(editor): return after a ticked task starts an unticked one
  • fix: fix(export): PDF headings stop printing blurred and heavy in one-weight faces
  • fix: fix(export): PDFs draw captions, quotes and videos as the preview does
  • fix: fix(export): PNG export waits for lazy and pending diagrams as PDF does
  • …and 201 more

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

tw93/MiaoYan was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 14 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 2fce9e33142e094be99078d1152b01faddaae074 — the exact code this score is about.
  • Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-e1a3b69fc8ee.