把 Chomy 变成你的写作空间。

01 / 开始使用

从 GitHub Releases 选择对应平台的安装包。macOS 版面向 Apple Silicon（arm64），打开 DMG 后将 Chomy 放到应用程序目录；Windows 便携版为 x64 ZIP，完整解压后运行 Chomy.exe。

当前构建未签名，macOS 版已完成本机回归，Windows 版待实机验收。若 macOS 提示开发者无法验证，确认下载来源后，可按系统提示在“系统设置 → 隐私与安全性”中允许打开。不要关闭系统全局安全设置。

使用“文件”菜单创建或打开文档，在写作视图中直接输入 Markdown。需要精确处理原文时，用右上角圆圈或“显示”菜单切换源码；保存后得到普通的 .md 文件。

02 / 文件与图片

用文件树与大纲整理写作

文件树展示当前目录的文件与文件夹；目录默认折叠，按需展开。大纲随文档标题生成，可以快速跳转。已有的 Markdown 文件无需转换成专有格式。

图片默认引用原路径

插入已有图片或附件时，默认使用原文件路径，不要求先保存当前文档。需要一起移动或分享时，可以改用本地复制，或配置 S3-Compatible、阿里云 OSS、七牛云 Kodo 上传。

直接粘贴截图

剪贴板截图会保存在 Chomy 用户数据的 user-images 目录，未保存文档也能粘贴。保存文档后仍使用绝对路径引用；分享文档前，需要同时处理图片文件或上传图片。

遇到冲突或恢复提示

外部修改与当前编辑发生冲突时，先核对两份内容再决定保存。异常退出后的恢复内容可以重新载入；恢复副本不应在尚未确认文字安全时丢弃。

03 / 代码与公式

在围栏代码块中选择 Java、Python、JavaScript 等语言获得高亮。代码块末行按下方向键，可以继续在下一段书写。

公式使用 LaTeX 源码编辑，并在阅读视图中通过 KaTeX 渲染。包含受保护语法的文档会保留源码编辑器，切换阅读预览后仍可查看排版。未知内容不会因模式切换被静默重写。

$$
e^{i\pi} + 1 = 0
$$

在源码中输入反斜杠命令时，只写 LaTeX 本身需要的转义；不要给公式下划线或定界符额外添加 Markdown 转义。无效语法会显示错误提示，其他有效公式仍能阅读。

04 / 从零制作一个主题

主题是一份描述文件和一份 CSS。它只改变正文，不修改应用外壳、系统菜单或安全提示。下面的最小示例可以直接安装。

第一步：建立主题目录

my-paper/
  theme.json
  theme.css
  preview.png  # 可选，用于设置中的静态预览

第二步：创建 theme.json

{
  "schemaVersion": 1,
  "id": "studio.my-paper",
  "name": "My Paper",
  "version": "1.0.0",
  "engine": ">=1.0.0",
  "author": "Your Name",
  "description": "温暖的纸色，舒适的中文阅读。",
  "modes": ["light"],
  "styles": "theme.css"
}

ID 使用小写字母和数字，以点或连字符分隔。不要使用 chomy- 前缀或 Windows 保留名称。engine 当前必须为字面 >=1.0.0，styles 必须为 theme.css。重新安装相同 ID 会更新主题，因此发布后请保持 ID 稳定。

第三步：创建 theme.css

:root {
  --chomy-bg: #fff8ed;
  --chomy-fg: #352b25;
  --chomy-link-color: #765226;
  --chomy-border: #d3c3aa;
  --chomy-code-bg: #f0e6d7;
  --chomy-heading-color: #31241c;
  --chomy-quote-color: #7c6a59;
  --chomy-table-alt-bg: #fbf0df;
  --chomy-table-header-bg: #f0e6d7;
  --chomy-font-body: Georgia, "Songti SC", serif;
  --chomy-font-mono: ui-monospace, SFMono-Regular, Consolas, monospace;
  --chomy-body-line-height: 1.75;
}

h1, h2 {
  border-bottom: 1px solid var(--chomy-border);
  padding-bottom: 0.2em;
}

blockquote { border-left-width: 4px; }
pre { border: 1px solid var(--chomy-border); }
th, td { padding: 0.55em 0.8em; }

使用公开的 --chomy-* 变量和标准正文标签选择器。应用将主题限制在正文范围内。不要添加 JavaScript、外部图片、字体下载、@import 或 CSS url()；默认使用本机字体，字号和正文宽度优先尊重用户偏好。

第四步：安装、检查与分享

1. 在 Chomy 偏好设置里选择“安装主题文件夹”，选中 my-paper。
2. 选择 My Paper，检查中文、英文、标题、引用、表格、代码、链接和选中态。
3. 重启确认主题选择保留；修改 CSS 后重新安装相同 ID。
4. 分享时把 theme.json、theme.css 和可选 preview.png 打成 ZIP，也可以安装 ZIP。

做暗色主题时，使用 modes: ["dark"] 并在根变量写入暗色。双色主题声明 light 和 dark，再用 @media (prefers-color-scheme: dark) 定义暗色变量。modes 只声明能力，不会自动改写 CSS。

JSON 和 CSS 各不超过 128 KiB，ZIP 不超过 2 MiB。预览必须为静态 PNG，最多 512 KiB、1600×1200，且总像素不超过 2,000,000；添加预览时在描述文件加入 "preview": "preview.png"。完整选择器、变量、校验与排错规则见开发者手册。

05 / 继续扩展

开发者手册涵盖进程架构、Markdown 数据流、文件安全、主题协议、存储提供器、测试和打包流程。可以把它交给另一位开发者，从主题定制开始，再逐步扩展编辑器能力。