中文文字 · 官方 CLI 实测 · 约 8 分钟

PhotoCraft 官方 CLI 中文文字实测：Unicode、字体与可复现 PNG 流程

使用官方 CLI 和文中的完整命令复现中文文字任务。本记录检查命令行引擎、保存的文字与渲染输出，不声称桌面文字输入或中文输入法候选组合已经验证。

资料核对 2026-10-11实测 2026-10-11文章更新 2026-10-11

版本、环境与实际任务结果

记录项目	内容
PhotoCraft 版本	PhotoCraft CLI 0.7.0 — official macOS Universal release
操作系统	macOS 15.5 (24F74)
处理器 / 架构	Apple M2 · arm64
实测日期	2026-10-11
任务结果	通过

这两行中文以 PingFang SC Regular、60 pt 实际渲染。保存的 PSD 保留真实文字层，重新打开后再次导出的 PNG 完全一致；山景底图像素没有变化。

实际插入文字的方式

通过官方 CLI 的 type.edit 命令传入 UTF-8 JSON 文字字符串和明确的换行。没有把这次结果称为桌面粘贴或中文输入法候选词组合测试。

本次使用的输入素材

下载两项可复现练习包

准备好的分层输入：YOUR TITLE

由官方 CLI 准备：原创山景底图加一层真实 YOUR TITLE 文字，位置 (140,150)，PingFangSC-Regular、60 pt。PSD 引用字体名称，没有打包字体文件。

下载本次实际输入文件 · 1200 × 800 px

原始山景背景

这张 PNG 是准备分层输入时使用的背景原图，不是编辑后的结果。

下载本次实际输入文件 · 1200 × 800 px · CC0

准备官方 CLI 与运行目录

使用下方官方 PhotoCraft CLI 0.7.0 macOS Universal 包。以下命令假定 photocraft-cli 可执行文件已加入 PATH；也可以把命令开头替换成你解压后对应可执行文件的路径。解压练习包，从包含 practice/ 的目录执行，保留原件，把结果写入 practice/output/。这是命令行流程，不是桌面界面输入记录。

下载对应版本的官方 macOS Universal CLI ZIP · photocraft-cli-0.7.0-macos-universal.zip

下面命令只对应文中记录的 macOS 环境。下载、解压官方 CLI 后，在文中指定的工作目录运行；输入文件与输出名字应与命令保持一致。桌面应用与 CLI 是不同入口。

实际运行的 CLI 步骤与命令

替换已有标题并检查排版

type.edit 把准备好的文字层替换成两行。JSON 中的 \n 表示换行；本次 type.info 的实际结果为两行，基线分别为 0 与 72 像素。

photocraft-cli run practice/source/chinese-title-starter.psd --cmd type.edit --params '{"text":"山间好时光\n从一张照片开始"}' --cmd type.info --params '{}' --out practice/output/chinese-text-test-cli.psd

把保存的分层工程导出为 PNG
从实际保存的 PSD 导出。检查生成的 PNG，而不是仅凭命令退出成功判断。
```
photocraft-cli convert practice/output/chinese-text-test-cli.psd practice/output/chinese-text-test-cli.png
```

重新打开，另存第二份 PSD 并再次导出

官方 CLI 重新加载首份 PSD，再另存 PSD 和 PNG。第二张 PNG 与首张逐像素一致，两份 PSD 都保留相同的中文文字字符串。

photocraft-cli info practice/output/chinese-text-test-cli.psd --compact
photocraft-cli convert practice/output/chinese-text-test-cli.psd practice/output/chinese-text-test-cli-reopened.psd
photocraft-cli convert practice/output/chinese-text-test-cli-reopened.psd practice/output/chinese-text-test-cli-reopened.png

实际输出与分项检查

检查项目	结果	实际观察
中文字符串与明确换行	通过	真实文字层保留指定 UTF-8 字符串，渲染器实际排为两行。
字体与文字层结构	通过	PingFangSC-Regular、60 pt，共 pixel 与 type 两层。这验证了保存的结构，不代表所有应用中的继续编辑行为。
原始背景	通过	背景图层像素与源 PNG 完全一致。
保存工程与重开后的 PNG	通过	PNG 为 1200 × 800；重开保存的 PSD 后再次导出，PNG 完全一致。
桌面文字输入与中文输入法组合	未测试	CLI 文字插入不能证明桌面粘贴、拼音候选词组合或画布上的继续编辑已通过。

PhotoCraft CLI 0.7.0 的实际导出：PingFang SC Regular 排版的两行指定中文。

查看实际输出文件的独立检查记录

范围与尚未验证的事项

只检查了这两行指定文字与这台 Mac 已安装的 PingFang SC。未测试 Windows、Linux、其他字体、复杂排版、桌面输入法或 Photoshop 交接。

结果只对应文中这段文字、字体、版本与 Mac。直接插入 Unicode 或粘贴不等于验证中文输入法的候选词组合；其他字体、文字和平台需要另行检查。

想先完成基础流程，可以看首次编辑实录。