Kami
从内容结构走到实际页面
把已有材料整理成有版式约束的文档:先定内容,再填 HTML,导出 PDF 并逐页检查;可另选可编辑 PPTX 或产品落地页。
打开作者原图作者的一页 Kami 介绍:白底、中文衬线与横向指标。图内保留 v1.9.1 及当时的示例说明。
查看作者示例以下是作者 README 中的原始图片,未经本站生成或重排。保留图中的历史版本、价格与示例说法,仅用于观察版式;当前安装步骤与能力范围以本文核验内容为准。
本页首用路线
- Claude Code 插件
- 本地项目文件
- 按格式准备导出环境
- GitHub Star
- 12,132
- 版本
- 1.20.0
- 资料核对
- 分类
- 文档与幻灯片
第一份先做一页、事实完整的提案
选定一个读者、一个结论和 3–4 个真实指标,把内容压实,再检查一页 PDF。不要一开始同时追求 PDF、PPTX、Word 和网页;不同路线的排版与验收工作不能互相替代。
选一个任务,开始使用
先安装并确认入口,再在项目目录准备材料。下面的任务都是本站依据源码编写的使用示例,命令由你的助手在具备依赖的环境中执行。
带上目标读者、核心判断、3–4 个可核实数字和下一步行动;适合需要打印或发给决策者的项目介绍。
在 Claude Code 会话中安装
在 Claude Code 会话中逐行执行。第一行添加市场,第二行安装 kami 插件;完成后确认 /kami:kami 入口。其他宿主使用 README 对应安装路线。
查看作者安装说明/plugin marketplace add tw93/kami /plugin install kami@kami确认技能目录,再诊断导出环境
两条安装命令分别添加市场和安装插件。确认 /kami:kami 已可用,让助手报告实际 SKILL.md 所在目录;文件放在自己的项目目录,脚本用完整路径调用。先运行 python3 <实际Kami目录>/scripts/build.py --doctor,再按报告补齐所选格式的依赖与字体。不要直接运行不带参数的 build.py:它会构建仓库示例。
查看环境与导出说明把这段话发给 AI
以下为编辑示例,替换材料后使用;/kami:kami 对应本页的 Claude Code 插件安装方式。其他宿主按其实际技能入口调用。
/kami:kami 请把我附上的 brief.md 排成一页中文 A4 项目提案,交给业务负责人阅读,采用白底打印版。交付 proposal.html、proposal.pdf、逐页 PNG 和 content.json。 先读取已安装 Kami 的 SKILL.md,确认其实际目录;在当前项目的 proposal/ 目录制作文件。整理读者、用途、1 页目标、3–4 个真实指标、论点、证据和下一步;不足或冲突先列缺项,不编数字。按 one-pager schema 写 content.json,brief 指定 template=one-pager、page_target=1、formats=[html,pdf,png]。内容定下后,把 assets/templates/one-pager.html 复制成 proposal.html 再填充,不改安装目录的模板。 从文档目录用已确认的完整脚本路径运行 python3 <Kami实际目录>/scripts/build.py --doctor,再运行 --check-content content.json。若缺依赖或合适字体,先报告具体缺项。把图片和获准使用的字体放入项目并修正 HTML 路径;按 production.md 的白底配方调整纸面和浅色块。 完成 HTML 后运行 python3 <Kami实际目录>/scripts/build.py --deliver proposal.html content.json。修复 ERROR 后重跑;逐项解释 WARN 和 GAP。打开生成的每张 page PNG,确认确实只有一页、文字完整、中文字体正确、指标和来源一致,并检查 PDF 的链接与文字选取。若不能看图,明确说视觉检查未完成。最后给出文件路径、实际页数、检查结果和未解决事项。
检查你拿到的结果
- 可继续修改的 proposal.html、content.json,以及成功导出后的一页 proposal.pdf 和 proposal-visual/page-01.png。
- 数字、引用和下一步在页面中可找到;白底版的浅色块、字体和页边缘经过实际检查。
- 交接说明包含实际页数及所有 WARN、GAP;“READY”不会替代人工看图。
进一步了解这个 Skill
Kami 是 Tw93 给 AI 助手准备的文档制作技能,包含写作约束、内容结构、HTML 与 Python 模板,以及导出和检查脚本。它适合把项目资料、履历或演讲材料变成可以阅读和分享的页面。默认风格是暖纸色、衬线字和少量墨蓝强调;品牌色可以调整,面向打印的文档也有明确的白底配方。
当前仍是八类内置文档:一页纸、长文、正式信件、作品集、简历、幻灯片、个股研报和更新日志。另有面向浏览器的产品落地页。这里的“八类”不是八个可独立调用的子技能,也不等于所有文件数;语言版和 PDF、PPTX、Marp 路线会带来不同模板。英文和中文最完整,日韩输出还要核对字体与排版。
新文档先把读者、用途、格式、长度和验收要求写入 content.json,再由助手将内容填进选定模板。这个 JSON 是内容清单与检查依据,脚本不会单凭一份 Markdown 或 JSON 自动排好所有页面。普通文档以 HTML 为可修改源文件,WeasyPrint 导出 PDF,PyMuPDF 再生成逐页 PNG;需要可编辑幻灯片时才选择独立的 Python PPTX 模板。
它的价值也在交付后的检查:内容是否遗漏、页数是否达标、中文实际用了什么字体,都有相应检查入口。但脚本不能替你确认事实、看懂页面或证明所有链接可用。最终还需要打开真实产物;未解决的问题应随文件一起交代。
来源与核验
资料核对
依据固定提交 b311c77c 的作者文档、模板与脚本静态核验;作者原图已目视检查。本站未安装 Kami、执行导出或测试生成效果。