Changelog

1. Refined the resume templates with quieter headers, section rules, and project spacing for a cleaner two-page rhythm.
2. Reworked the metrics row so key numbers align better and stay easier to scan.
3. Refreshed the public English and Korean resume demos so previews match the shipped templates.

更新日志

1. 优化简历模板的页眉、版块分隔线和项目间距,让两页版式更克制稳定。
2. 调整顶部关键数字区域,让数值更整齐、标签更容易扫读。
3. 刷新公开的英文和韩文简历 demo,让预览与实际发布模板一致。

Changelog

1. Improved documentation-site guidance for help pages, with sidebar navigation, on-page table of contents, mobile layout, and quieter previous / next links.
2. Added clearer screen checks for landing pages and docs pages, making it easier to catch mobile CTA, code block, table, and line-widow issues before shipping.
3. Tightened Marp deck theme checks so Markdown slide decks stay aligned with Kami's color and typography tokens.
4. Simplified the Claude Desktop skill archive by removing obsolete stabilization files and keeping the package easier to inspect.
5. Clarified overflow handling for one-pagers, letters, and resumes: cut or merge content first, instead of shrinking typography until the page becomes hard to read.

更新日志

1. 改进帮助页和文档站的制作规则,补清侧边栏导航、页内目录、移动端布局,以及更轻的上一页 / 下一页链接样式。
2. 补充落地页和文档页的屏幕检查规则,更容易在发布前发现移动端按钮、代码块、表格和孤行问题。
3. 加强 Marp deck theme 检查,让 Markdown 幻灯片持续对齐 Kami 的颜色和排版 token。
4. 简化 Claude Desktop skill archive,移除过时的 stabilization 文件,让包更容易检查。
5. 明确一页纸、信件和简历的溢出处理方式:优先删减或合并内容,而不是把字号和行距压到难读。

Changelog

1. Added a dedicated Korean template family across documents, decks, and landing pages, with KO resume demo and public SEO coverage.
2. Added optional brand-profile logo slots for one-pager, portfolio, and WeasyPrint slides without changing the default visual path.
3. Moved large CJK font recovery outside the skill package and clarified Chinese / Korean font fallback for Claude Desktop installs.
4. Hardened palette and token checks with off-palette lint, Marp token coverage, and CN / EN / KO root consistency checks.
5. Refined slide and product-site guidance around ghost deck tests, one evidence shape per slide, screenshot slot planning, and material gaps.
6. Aligned release readiness surfaces: public template counts, package docs, PT-Serif fallback verification, deterministic zip packaging, and final tag timing.

更新日志

1. 新增完整韩语模板族,覆盖文档、幻灯片和落地页,并补齐 KO 简历 demo 与公开站点 SEO 展示。
2. 为一页纸、作品集和 WeasyPrint 幻灯片加入可选品牌 logo 槽位,同时保持默认视觉路径不变。
3. 将大型 CJK 字体恢复移到 skill 包之外,并补清 Claude Desktop 安装时的中文 / 韩文字体 fallback 说明。
4. 加强调色与 token 检查,新增 off-palette lint、Marp token 覆盖,以及 CN / EN / KO root 一致性检查。
5. 收紧幻灯片和产品站点规则,加入 ghost deck test、单页单证据、截图槽位规划和素材缺口处理。
6. 对齐发布前真相面:公开模板数量、包说明、PT-Serif fallback 验证、可复现 zip 打包和最终 tag 时机。

Changelog

1. Marp Slide Deck Variant: a new Markdown-first deck path (EN/CN) under assets/templates/marp/. One .md source renders to HTML, PDF, or PPTX via marp-cli, and the theme CSS is self-contained, carrying the full Kami token set (parchment, ink-blue, serif rhythm). It joins WeasyPrint HTML-to-PDF (default) and python-pptx (editable) as a third, user-triggered slide path. Kami's own build pipeline does not call marp; users run marp-cli themselves.
2. Landing-Page Production Companion Files: five .example scaffolding files for shipping a generated landing page as a real multilingual site, llms.txt + llms-full.txt for AI assistants, robots.txt with an AI allowlist, sitemap.xml with hreflang, and vercel.json for rewrites and headers. Documented in SKILL.md and packaged in the skill.
3. Site Reaches Five Languages: the official site adds Traditional Chinese and Korean pages alongside English, Simplified Chinese, and Japanese, with a collapsible language switcher that auto-detects the browser language.
4. Scripts Split + Real Render CI: build.py dropped from 1062 to 361 lines, split into focused lint / checks / verify / tokens / optional_deps modules. A new verify-render CI job installs WeasyPrint plus Noto CJK and actually renders the strict-page-count templates, so page-count regressions can no longer slip through lint-only CI. The overflow solver gains end-to-end tests.
5. Robustness & CI Hardening: render verification now accepts DejaVu / Liberation as a serif fallback and adds a KAMI_ALLOW_FALLBACK_ONLY opt-in so CI (which never has commercial fonts) can still gate page counts; the build warns clearly when Pygments is missing; Marp deck visuals tightened.

更新日志

1. Marp 幻灯片: 多了一条用 Markdown 写幻灯片的路子(中英文),放在 assets/templates/marp/。同一份 .md 用 marp-cli 就能导出 HTML、PDF 或 PPTX,主题样式自成一体,内置整套 Kami 配色和字体节奏,不用再配额外 CSS。加上默认的 WeasyPrint(HTML 转 PDF)和 python-pptx(可编辑 PPT),出片现在有三种方式,按需挑一个。Kami 自己的构建流程不碰 marp,要用时本地跑一下 marp-cli 就行。
2. 落地页上线配套文件: 新增五个 .example 脚手架,帮你把生成的落地页真正部署成多语言站点:给 AI 助手读的 llms.txt 和 llms-full.txt、带 AI 抓取白名单的 robots.txt、带 hreflang 的 sitemap.xml,以及管 rewrite 和响应头的 vercel.json。SKILL.md 里有说明,也一并打进了 skill 包。
3. 官网支持五种语言: 在英文、简体中文、日文之外,新增繁体中文和韩文页面,配了个可折叠的语言切换器,会按浏览器语言自动跳转。
4. 脚本拆分 + 渲染级 CI: build.py 从 1062 行瘦到 361 行,拆成职责清楚的 lint、checks、verify、tokens、optional_deps 五个模块。新增的 verify-render 任务会装上 WeasyPrint 和 Noto CJK,把限定页数的模板真正渲染一遍,页数超标再也绕不过只跑 lint 的 CI。溢出 solver 也补齐了端到端测试。
5. 稳健性和 CI 加固: 渲染校验现在认 DejaVu、Liberation 作为 serif 回退,还加了 KAMI_ALLOW_FALLBACK_ONLY 开关,让本来没有商业字体的 CI 也能卡页数;缺 Pygments 时构建会直接提示;顺手收紧了 Marp 幻灯片的视觉细节。

Kami is a quiet design system for professional documents, one constraint set that any agent can trust. https://github.com/tw93/Kami

Changelog

1. Landing Page Template + Showcase: new screen-first template (EN/CN) with interactive gallery, hero, features, principles, pricing, FAQ, and footer. Direction-aware transitions, auto-rotating carousel, 3 responsive breakpoints. Official site adds a "Built with Kami" section showing three live products (Kami, Luo, Mole) from the same template, with browser language auto-detection (EN/ZH/JA) and OG image upgrade.
2. Template Pattern Distillation: absorbed five patterns from the Mole landing page into Kami templates: italic poetic captions on gallery and feature subtitles, FAQ tail paragraph, editorial footer with middot-separated links and italic ethos sign-off, eyebrow version link slot.
3. Syntax Highlighting: code blocks with class="language-*" now get Pygments-based coloring at build time using existing Kami color tokens. No external CSS required. Closes #20.
4. Writing Specs from PPT Experience: 3 new anti-patterns covering caption flow restatement, AI tone cliches with self-check grep, and sans CJK fallback clash. 2 new writing principles covering term annotation half-life and English term density cap in CJK text.
5. Screen-Scale Specs: CJK serif body line-height 1.55-1.65 at slide scale, slide caption floor 24px, diagram SVG fill >=65% on 1080p. Olive confirmed safe for zh-CN TsangerJinKai02 without override.
6. Behind the Scenes: --verify now surfaces advisory density warnings for sparse pages. Rhythm tokens standardize multi-page template spacing. Per-page density target defined in SKILL.md Step 4.1.

更新日志

1. 落地页模板 + 案例展示: 新增屏幕优先模板(中英文),含交互式 Gallery、Hero、Features、Principles、Pricing、FAQ、Footer 七个 section。方向感知滑动、自动轮播、3 个响应式断点。官网新增 "Built with Kami" 板块,展示同一模板搭建的三款产品(Kami、Luo 落文、Mole 鼹),浏览器语言自动检测跳转,OG image 升级为全页截图。
2. 模板模式沉淀: 从 Mole 落地页吸收五个模式: Gallery 和 Feature 副标题 italic 诗意行、FAQ 收尾段落、编辑式页脚(middot 分隔链接 + italic ethos 签名)、眉栏版本链接 slot。
3. 代码语法高亮: <code> 元素带 class="language-*" 的代码块构建时自动 Pygments 着色,复用 Kami 现有色彩 token,无需外部 CSS。关闭 #20。
4. PPT 实战经验写入规范: 3 条新反模式(caption 禁流程复述、AI 套话自检 grep、Sans + CJK 回退冲突),2 条新写作原则(术语注解半衰期、CJK 正文英文密度上限)。
5. 屏幕尺寸规格补充: 中日文 serif 行高 slide scale 下 1.55-1.65,slide caption 下限 24px,diagram SVG 1080p 填充 >=65%。
6. 工程改进: --verify 稀疏页 advisory 密度警告,多页模板间距 rhythm token 标准化,SKILL.md Step 4.1 定义每页最低密度契约。

Kami is a quiet design system for professional documents, one constraint set that any agent can trust. https://github.com/tw93/Kami

Changelog

1. Chinese Slides No Longer Garbled — The CN slides-weasy.html font stack now keeps body and table text on TsangerJinKai02, instead of falling into a system sans path that produced unreadable glyphs in some PDF readers (issue #18).

2. Install Path Realigned for Claude Code v2.1.136+ — README, three locale index pages, and llms.txt now lead with the npx skills add route, sidestepping a v2.1.136–138 plugin path regression that breaks /plugin install kami@kami (issue #19, upstream anthropics/claude-code#57570). Existing installs are unaffected.

3. Behind the scenes — CI now runs build.py --check, the test suite, and a smoke build on every push and PR; V* tags auto-build and upload kami.zip. Test suite grew from 12 to 42 cases. --check-density runs ×ばつ faster on sparse pages when numpy is available.

更新日志

1. 中文幻灯片不再乱码 — 修复 slides-weasy.html 中文字体栈,正文与表格文字稳定在 TsangerJinKai02,不再回退到系统 sans 而在部分 PDF 阅读器上出现乱码(issue #18)。

2. 安装路径调整以适配 Claude Code v2.1.136+ — README、三套 index 与 llms.txt 默认推荐 npx skills add 路径,绕开 v2.1.136–138 的插件路径校验回归(issue #19,上游 anthropics/claude-code#57570)。已有安装不受影响。

3. 工程改动 — CI 在每次 push / PR 跑 build.py --check、测试套件与烟雾构建;V* tag 推送自动构建并上传 kami.zip。测试用例从 12 扩到 42 个。--check-density 在 numpy 可用时稀疏页 ×ばつ 提速。

Kami is a quiet design system for professional documents, one constraint set that any agent can trust. https://github.com/tw93/Kami

Changelog

1. Plugin Install Fix: Register Kami via marketplace.json with strict: false so /plugin install kami@kami actually loads in Claude Code.
2. macOS WeasyPrint Runtime: Auto-resolve Homebrew lib paths on both Apple Silicon (/opt/homebrew) and Intel Mac (/usr/local) so cairo and pango load on first run.
3. Documents Now Eight Types: README, three locale index pages, JSON-LD, and llms.txt list Equity Report and Changelog as first-class document types.
4. Diagram & Template Polish: Resume CN @page margin 9mm to 11mm, portfolio-en cover line-height tightened to 1.10, and 14 diagrams re-normalized to spec (font-weight 500, no italic, solid hex pre-blended on parchment).
5. Six New Pitfalls: references/production.md grows from 16 to 22 entries, with CHEATSHEET decision tables cross-referencing each new pitfall.
6. Build Pipeline Tightened: HTML_TEMPLATES lifted into scripts/shared.py as the single source of truth; ensure-fonts.sh portable across bash 3.2+; check commands exit non-zero on bad input.
7. First Test Suite: New scripts/tests/test_build.py with 12 zero-dependency cases covering registry consistency, scan rules, and slide sequence parsing.

更新日志

1. 插件安装修复:把 Kami 注册移到 marketplace.json 并设 strict: false,让 /plugin install kami@kami 在 Claude Code 真正可用。
2. macOS WeasyPrint 运行时:自动识别 Apple Silicon (/opt/homebrew) 与 Intel Mac (/usr/local) 两条 Homebrew 路径,首次构建即可加载 cairo 与 pango。
3. 文档类型扩展到 8 类:README、三套 index、JSON-LD、llms.txt 把 Equity Report 与 Changelog 列为一等公民。
4. 模板与图表打磨:Resume 中文 @page 边距 9mm 调到 11mm,portfolio-en 封面行高收紧到 1.10,14 个图表统一回到规范(font-weight 500、去斜体、rgba 预混到羊皮纸色)。
5. 新增 6 条产线经验:references/production.md 从 16 条扩到 22 条,CHEATSHEET 决策表逐条交叉引用。
6. 构建管线收紧:HTML_TEMPLATES 提到 scripts/shared.py 作单一事实源;ensure-fonts.sh 兼容 bash 3.2+;check 命令在异常输入时退出非零。
7. 首套测试基础设施:新增 scripts/tests/test_build.py,12 个零依赖测试覆盖注册表一致性、扫描规则、幻灯片序列解析。

Kami is a quiet design system for professional documents, one constraint set that any agent can trust. https://github.com/tw93/Kami

Changelog

1. Claude Code Plugin: Install Kami through /plugin marketplace add tw93/Kami and /plugin install kami@kami.
2. WeasyPrint Slides: Add default HTML-to-PDF slide templates for Chinese and English decks.
3. AI Visibility: Add llms.txt, robots.txt, sitemap, FAQ JSON-LD, and aligned public install copy.
4. Font Recovery: Add scripts/ensure-fonts.sh for multi-source TsangerJinKai02 recovery with size checks.
5. Brand Profile: Move profiles to ~/.config/kami/brand.md with a public example and clearer layering.
6. Template Quality: Tighten resume, long-doc, equity report, changelog, and slide rendering behavior.
7. Package and Font Hygiene: Slim kami.zip by excluding large Chinese fonts, while keeping TsangerJinKai02 as the preferred Chinese rendering path.

更新日志

1. Claude Code 插件支持:支持通过 /plugin marketplace add tw93/Kami 与 /plugin install kami@kami 安装 Kami。
2. WeasyPrint 幻灯片:新增中英文 HTML-to-PDF 默认幻灯片模板。
3. AI 可见性:新增 llms.txt、robots.txt、sitemap、FAQ JSON-LD,并同步官网安装说明。
4. 字体恢复:新增 scripts/ensure-fonts.sh,支持多源恢复 TsangerJinKai02 并校验文件大小。
5. Brand Profile:迁移到 ~/.config/kami/brand.md,新增公开示例,并明确分层应用规则。
6. 模板质量:收紧 Resume、Long Doc、Equity Report、Changelog 与 Slides 的渲染行为。
7. 包体与字体治理:精简 kami.zip,不内置大型中文字体;中文输出仍优先使用 TsangerJinKai02。

Kami is a quiet design system for professional documents, one constraint set that any agent can trust. https://github.com/tw93/Kami

Changelog

1. Resume Dense Variant: Add dense to the resume root for compact spacing, plus 7 fixes for class aliases, os-grid alignment, and date nowrap.
2. Slide Layouts: Two new layouts added: funnel for staged flow diagrams and chapter for section covers, expanding deck visual range without custom CSS.
3. Brand Profile Fields: Personal habit, voice, and style fields added for consistent tone across sessions and document types.
4. Travel Block: New shared section that renders from one brief in both slide deck and portfolio image layouts, no duplication needed.
5. Writing Guides: Quality bar guides added for general documents and resume, covering content standards for all eight template types.
6. Typography and Overflow: Fixed font drift and metric label wrap regressions across resume and equity report templates; overflow handling tightened.
7. Layout and Border Fixes: Callout double-border, chapter-01 page break, and funnel stroke corrected; thin border with border-radius combos triggering a WeasyPrint double-ring artifact removed across all templates.

更新日志

1. Resume Dense 变体:为 resume 根元素添加 dense class 即可切换紧凑间距,落地 7 条精修,覆盖 class 别名、os-grid 与日期 nowrap。
2. Slide 布局扩展:新增 funnel 漏斗布局与 chapter 章节封面,无需自定义 CSS 即可扩展 Deck 视觉表达。
3. Brand Profile 字段扩展:新增个人习惯、语气与风格字段,一份 profile 跨会话保持一致的语气与格式。
4. Travel 区块:新增共享区块,同一份内容简介可同时渲染到 Slide 与 Portfolio,无需重复填写。
5. 写作指南:新增通用文档与 Resume 专项写作指南,明确各类模板的内容标准与取舍原则。
6. 字体与溢出修复:修复 Resume 与 equity-report 模板的字体漂移、指标标签换行回归;收紧溢出控制。
7. 布局与边框修复:修复 callout 双边框、chapter-01 分页异常与 funnel 描边问题;全模板清除薄边框配 border-radius 组合,关闭 WeasyPrint 双环渲染。

Kami is a quiet design system for professional documents, one constraint set that any agent can trust. https://github.com/tw93/Kami

Changelog

1. Equity Report & Changelog: Two new document templates for investment analysis (2-3 page ticker/metrics/thesis format) and release notes, both in Chinese and English
2. Candlestick & Waterfall Charts: Two new financial diagram types for stock price history (OHLC) and revenue bridge decomposition, bringing the total to 14 inline SVG diagrams
3. Unified Table Component: All templates now share .kami-table with .compact, .financial, .striped, and .total variants, so tables look consistent across every document type
4. Typography Consolidation: Removed Inter and Newsreader, locked to one serif per page (Charter for English, TsangerJinKai02 for Chinese, YuMincho for Japanese), added Chinese body letter-spacing 0.35px
5. Color Palette Simplification: Consolidated from 11 neutral tokens to 6, migrated olive and stone values across all templates, diagrams, and demos for better readability
6. Auto-Select Charts: The skill now picks the right chart type from data context (proportional -> donut, time series -> line, comparison -> bar) instead of waiting for the user to specify
7. Auto-Select Output Format: PDF always ships, PPTX follows slides, PNG follows sharing context. Users never need to think about export formats
8. Orphan Detection: build.py --check-orphans scans PDFs for orphan text (last line with 1-2 words), catching layout issues before delivery

更新日志

1. 个股研报与更新日志: 新增两种文档模板,个股研报(2-3 页,含行情头、指标卡、投资论点)和更新日志,均支持中英双语
2. K 线图与瀑布图: 新增两种金融图表,K 线用于股价走势(OHLC),瀑布图用于收入桥和估值拆解,内联 SVG 图表总数达到 14 种
3. 统一表格组件: 所有模板共享 .kami-table,支持 .compact、.financial、.striped、.total 四种变体,表格在各类文档中保持一致
4. 字体精简: 去掉 Inter 和 Newsreader,锁定每页一种衬线体(英文 Charter、中文 TsangerJinKai02、日文 YuMincho),中文正文新增 0.35px 字距
5. 色阶精简: 中性色从 11 个 token 收敛到 6 个,olive 和 stone 色值全面迁移,提升可读性
6. 图表自动选择: Skill 现在根据数据上下文自动选择图表类型(占比用环形图、趋势用折线图、对比用柱状图),不再需要用户指定
7. 输出格式自动选择: PDF 始终生成,PPTX 跟随演讲场景,PNG 跟随分享场景,用户不需要考虑导出格式
8. 孤行检测: build.py --check-orphans 扫描 PDF 中的孤行文本(末行仅 1-2 个词),在交付前发现排版问题

Kami is a quiet design system for professional documents, one constraint set that any agent can trust. https://github.com/tw93/Kami