ChenRaft

装好,就能开始

清理 + 导出 + 手机预览。安装后,在 Photoshop 面板内登录使用。

安装与登录

  1. 下载对应系统的版本,保存工作并退出 Photoshop。
  2. Windows 直接运行 EXE 安装器;Mac 解压后双击「安装ChenRaft.command」。
  3. 勾选需要的清理、导出、手机预览。安装器自动查找 PS;若有多个版本,选择平时使用的版本。
  4. 打开 PS,在「窗口 / 扩展功能(旧版)」中打开 ChenRaft,输入账号密码登录。

手机预览的后台会一起安装到所选 PS。请在 PS「首选项 / 增效工具」中启用生成器后重启,再开始预览。

Apple 芯片 Mac 需使用 Rosetta。Mac 版仍为试用版,尚未完成真机 Photoshop 验证,详细步骤请查看安装页。

进入完整安装页

PSD清理

先选项目,再执行。用示例观察保存、检测、暂停确认,以及档内清理与深清重开的区别。

清理 0.5.8:重绘预检与无修改时跳过保存

先检查重绘是否稳定。档内清理先在临时完整图层副本上检查重复渲染。如果原样重绘也会改变像素,就提前保留内嵌对象及其元数据,并在运行记录中说明原因;可再选择深清直接处理文件元数据。

回写仍逐分支检查。稳定渲染的文档继续精确比较回写前后像素,发现变化时恢复该分支。常规历史恢复校验失败后会尝试完整快照;快照恢复可能截断更早的历史。恢复仍失败则停止后续处理与最终保存。

没有内容可清理,就不重复保存。其他清理项先检查,有实际修改才创建相应历史步骤并保存,避免深清后空操作又生成元数据。图层样式仅清理关闭的效果,保留开启效果、不透明度、填充和混合模式。

已修复旧版 CEP 中部分文件深清出现的 overlapping_edits 错误。部分 PSD 原样重开也会有轻微重绘差异,不能把深清理解为保证重开后的实时画面绝对一致。

下方动画只演示常见操作流程,不模拟像素校验、快照恢复或无修改时跳过保存;实际处理与跳过情况请看运行记录。

尚未执行
教程只操作虚拟示例,不读写你的文件。

可操作教程面板 · 示例文件

查看模式区别、清理规则与保存说明

0.5.8:先选清理项目,再点击底部按钮。两个元数据模式互斥,也可都不选;智能对象栅格化入口已移除。

两个元数据模式,怎么选?

元数据·档内清理

主文档保持打开。先处理主文档,再按元数据量从大到小进入可处理的内嵌智能对象,逐级保存;共享内容成功处理后跳过重复实例。

尽量保留历史,但元数据和嵌套内容不保证完整撤销。选中图层仅限制内嵌遍历范围,主文档元数据仍整体处理。

元数据·深清重开

仅支持 PSD / PSB。流式清理整份文件及可解析内嵌文档的 XMP、IPTC 和摘要,不逐个打开智能对象;校验通过后替换或打开新副本。

重开后旧历史重置,再执行其他勾选项目,保留一个图层清理撤销步骤;最后保存,不再次重开。此模式禁用“清理选中图层”。

两种模式都保留智能对象可编辑结构。外部链接、不支持或无法解析的内容可能跳过;查看运行记录。保存时 Photoshop 可能重新生成基础信息。

检测、推荐与暂停确认
  1. 单独点击“检测”只读取磁盘已保存版本,不保存、不清理。未保存修改不计入。
  2. 点击清理后,先自动保存,再重新检测。首次未保存的文档需要选择保存位置;保存失败或取消时不开始清理。
  3. 元数据总量 ≥128 MiB 或单处 ≥64 MiB 时建议深清。这是初始参考值,不是耗时或效果保证;推荐不会自动改模式。
  4. 档内模式遇到深清推荐时先暂停,尚未执行任何清理。切到深清后再点击清理,或保持档内模式点击“继续文档内清理”。
  5. 文件、文档、选中范围或选项变化后会重新确认。批量继续保留剩余队列,已完成文件不重复处理;每个需要推荐的文件分别确认。

在右侧将示例文件切到“元数据较多的 PSD”,即可体验暂停和继续。

其他四项清理规则
选项会改哪里
画布外删除完全在画布外的内容图层;部分越界、调整层保留。含画板或无法确认画板状态时跳过。
隐藏图层删除隐藏图层及隐藏组;隐藏组包含的子图层一并删除。
空白图层删除空组和零尺寸普通像素层;不按零尺寸规则删除调整层等特殊类型。
图层样式移除关闭的样式,保留开启的样式;整组效果关闭时移除整组,支持图层组。

首次默认开启档内元数据、画布外、隐藏和空白图层;深清与图层样式默认关闭。没有选择任何项目时不保存、不执行。

副本、覆盖、批量与取消
  • 所有项目都先自动保存输入文档当前修改。副本模式不代表原文档的未保存修改不会写入磁盘。
  • 默认副本:档内模式另存 文件名_cleaned;深清另存 文件名_metadata_cleaned。同名副本递增编号,原文档保留。
  • 覆盖:写回原文件。深清替换不保留额外备份,重开后旧历史重置。覆盖开关每次重载面板恢复关闭。
  • 批量:原本打开的文档保留;本次打开的文件及输出副本处理后关闭。仅深清元数据时,原本关闭的文件不必打开;叠加图层清理时需打开处理。关闭后的文档不保留撤销历史。
  • 点击“取消清理”或面板内按 Esc 请求停止。单次打开或保存可能要等结束;已完成的修改和先前保存的批量文件不回滚。
  • 深清若已开始替换,会先完成替换或恢复并重开,再停止后续项目。保存失败时保留结果文档,查看运行记录后手动处理。
首次使用 · 安装与登录
  1. 下载对应系统版本,保存工作并退出 Photoshop。
  2. Windows 直接运行 EXE 安装器;Mac 解压后双击「安装ChenRaft.command」。
  3. 打开「窗口 / 扩展功能(旧版)/ ChenRaft 清理 / 导出 / 手机预览」。
  4. 在 PS 面板内输入分配的账号密码,点击登录。

勾选记住登录后保留 7 天。退出入口在清理说明、导出设置或手机预览底部。Apple 芯片 Mac 需使用 Rosetta,具体步骤见包内安装说明。

完整文字参考 · 功能规则与常见问题

三个工具如何配合使用

在副本中整理 PSD,按规则导出素材,再用手机预览确认画面效果。三个工具保留原有功能规则,在 PS 面板里登录后使用。

ChenRaft 清理 · 0.5.8

清理 0.5.8 使用要点

先检查重绘是否稳定。档内清理先在临时完整图层副本上检查重复渲染。如果原样重绘也会改变像素,就提前保留内嵌对象及其元数据,并在运行记录中说明原因;可再选择深清直接处理文件元数据。

回写仍逐分支检查。稳定渲染的文档继续精确比较回写前后像素,发现变化时恢复该分支。常规历史恢复校验失败后会尝试完整快照;快照恢复可能截断更早的历史。恢复仍失败则停止后续处理与最终保存。

没有内容可清理,就不重复保存。其他清理项先检查,有实际修改才创建相应历史步骤并保存,避免深清后空操作又生成元数据。图层样式仅清理关闭的效果,保留开启效果、不透明度、填充和混合模式。

已修复旧版 CEP 中部分文件深清出现的 overlapping_edits 错误。部分 PSD 原样重开也会有轻微重绘差异,不能把深清理解为保证重开后的实时画面绝对一致。

下方动画只演示常见操作流程,不模拟像素校验、快照恢复或无修改时跳过保存;实际处理与跳过情况请看运行记录。

0.5.8:先选清理项目,再点击底部按钮。两个元数据模式互斥,也可都不选;智能对象栅格化入口已移除。

两个元数据模式,怎么选?

元数据·档内清理

主文档保持打开。先处理主文档,再按元数据量从大到小进入可处理的内嵌智能对象,逐级保存;共享内容成功处理后跳过重复实例。

尽量保留历史,但元数据和嵌套内容不保证完整撤销。选中图层仅限制内嵌遍历范围,主文档元数据仍整体处理。

元数据·深清重开

仅支持 PSD / PSB。流式清理整份文件及可解析内嵌文档的 XMP、IPTC 和摘要,不逐个打开智能对象;校验通过后替换或打开新副本。

重开后旧历史重置,再执行其他勾选项目,保留一个图层清理撤销步骤;最后保存,不再次重开。此模式禁用“清理选中图层”。

两种模式都保留智能对象可编辑结构。外部链接、不支持或无法解析的内容可能跳过;查看运行记录。保存时 Photoshop 可能重新生成基础信息。

检测、推荐与暂停确认
  1. 单独点击“检测”只读取磁盘已保存版本,不保存、不清理。未保存修改不计入。
  2. 点击清理后,先自动保存,再重新检测。首次未保存的文档需要选择保存位置;保存失败或取消时不开始清理。
  3. 元数据总量 ≥128 MiB 或单处 ≥64 MiB 时建议深清。这是初始参考值,不是耗时或效果保证;推荐不会自动改模式。
  4. 档内模式遇到深清推荐时先暂停,尚未执行任何清理。切到深清后再点击清理,或保持档内模式点击“继续文档内清理”。
  5. 文件、文档、选中范围或选项变化后会重新确认。批量继续保留剩余队列,已完成文件不重复处理;每个需要推荐的文件分别确认。

在右侧将示例文件切到“元数据较多的 PSD”,即可体验暂停和继续。

其他四项清理规则
选项会改哪里
画布外删除完全在画布外的内容图层;部分越界、调整层保留。含画板或无法确认画板状态时跳过。
隐藏图层删除隐藏图层及隐藏组;隐藏组包含的子图层一并删除。
空白图层删除空组和零尺寸普通像素层;不按零尺寸规则删除调整层等特殊类型。
图层样式移除关闭的样式,保留开启的样式;整组效果关闭时移除整组,支持图层组。

首次默认开启档内元数据、画布外、隐藏和空白图层;深清与图层样式默认关闭。没有选择任何项目时不保存、不执行。

副本、覆盖、批量与取消
  • 所有项目都先自动保存输入文档当前修改。副本模式不代表原文档的未保存修改不会写入磁盘。
  • 默认副本:档内模式另存 文件名_cleaned;深清另存 文件名_metadata_cleaned。同名副本递增编号,原文档保留。
  • 覆盖:写回原文件。深清替换不保留额外备份,重开后旧历史重置。覆盖开关每次重载面板恢复关闭。
  • 批量:原本打开的文档保留;本次打开的文件及输出副本处理后关闭。仅深清元数据时,原本关闭的文件不必打开;叠加图层清理时需打开处理。关闭后的文档不保留撤销历史。
  • 点击“取消清理”或面板内按 Esc 请求停止。单次打开或保存可能要等结束;已完成的修改和先前保存的批量文件不回滚。
  • 深清若已开始替换,会先完成替换或恢复并重开,再停止后续项目。保存失败时保留结果文档,查看运行记录后手动处理。

ChenRaft 导出 常用切图

导出 0.2.7 更新

切图以所属画板为边界。规则批量导出的单项 PNG 先按所属画板裁切;没有画板时按文档画布裁切,再去掉透明边缘。画布外的图形和投影不会进入图片,完全在外或范围内没有像素的项会记为失败,不生成空白图。

例如原图层宽 1406px、所属画板宽 1080px,超出左右边界的部分不进入切图;若画板内还有透明边缘,最终图片还会继续裁边。匹配规则、组整体导出、命名与同名覆盖方式保持一致。

导出前读取更轻。手动切图减少对整份 PSD 和复杂图层边界的重复读取,改善部分大型文件在准备阶段等待过久的问题。操作步骤不变:选图层 / 选格式/倍率 / 选目录 / 导出。

处理期间等当前任务完成,再执行下一次导出。不同文件的实际耗时仍会变化。

ChenRaft 导出将多种素材输出方式集中在「ChenRaft 导出」面板中。顶部菜单用于切换功能,底部统一选择导出目录;右上角「…」可设置输出参数、预设和查看运行记录。初始首页为「规则批量导出」;0.2.7 可在顶部菜单拖动排序,下次以第一项为首页。

教程一 按名称批量导出

  1. 将待导出图层或组命名为「界面_类型_名称」,例如 login_img_button。
  2. 在「编辑类型标签」中确认 img 已包含在类型列表中;匹配依据是名称中第二段的类型标签。
  3. 选择导出目录,点击「扫描预览」,核对识别到的对象及数量。
  4. 选择「只导出切图」「只导出效果图」或「切图和效果图」,再点击「开始批量导出」。

命名提示:匹配到图层组后,会把该组作为一个整体导出,不再重复导出组内子图层。要分别导出子元素,应避免父组先命中规则。

教程二 手动导出选中图层

  1. 从顶部切换到「手动切图」,在 Photoshop 中选中一个或多个图层。
  2. 选择 Web、iOS 或 Android,再选择所需格式或倍率。格式可多选,切换平台后其他平台的已选项仍会保留。
  3. 需要多层合成一张图时,勾选「合并选中的图层」并填写合并文件名;不勾选则分别输出。
  4. 设置输出目录,点击「导出选中图层」,打开输出文件夹检查尺寸、透明边和效果。
需要的结果建议设置
透明素材使用 PNG;通常选择 PNG-24 保留完整色彩。
多倍率交付选择对应平台的倍率;额外倍率可在「自定义输出」中添加。
指定画布大小填写宽高,内容居中补边;内容过大时等比缩小。
保留原画板范围在「透明边缘」中选择保留画板/文档尺寸。

同名文件:手动切图默认覆盖输出目录中的同名文件,可在更多选项中改为「自动加序号」。同一次任务中多个同名图层会自动加序号。手动设置不会改变规则批量导出的设置。

ChenRaft 导出 进阶功能

文字拆分导出

适合将数字、单词或带效果的文字拆成独立 PNG。每个单词放在一个顶层图层组中;这个流程会调整文字和图层结构,建议在专用副本中操作。

  1. 字距:点击「扫描并应用字距」,默认值为 1000。检查字符及投影之间是否留有间隙。已有进度可先点击「读取进度」。
  2. 合并:点击「备份并合并文字组」。插件保留隐藏的 backup_ 备份,并把原组合并为像素图层。
  3. 检测:点击「检测全部字符边界」。默认灵敏度 0、最小间隙 4、扫描步长 2;边界不合适时调整后重新检测。
  4. 拆分:点击「拆分并重命名」,按检测边界生成字符图层。切换文档或改变相关内容后,应重新读取或检测。
  5. 导出:选择普通、只有数字等高或全部等高,点击「导出字符切图」。等高仅补充纵向透明范围,不拉伸字符;按原组名创建子目录,同名文件覆盖。

注意:关闭重开面板后,尚未拆分的图层需要重新检测。当前合并版文字流程已有独立逻辑测试,最终像素输出仍需在实际素材上验收。

参考线切图

  1. 在 Photoshop 中放好横向和纵向参考线,再切换到「参考线切图」。
  2. 选择「选中的图层」或「整个文档」,再选择 PNG 或 JPG,可填写文件名前缀。
  3. 点击「预览分割数量」核对范围,然后点击「开始切图」。

选中多个图层时会逐层分割。分块保留完整矩形范围,不自动裁掉块内透明边。默认编号按从左到右、每列从上到下的顺序生成。

自动九宫处理

先把待处理 PNG 复制到独立文件夹,切换到「自动九宫处理」,选择处理目录后点击「开始九宫处理」。它识别可重复区域并保留 8px 安全边距,完成后会覆盖目录中的原 PNG;运行依赖系统可用的 node 命令。

功能边界:自动九宫处理不是带边缘黑线标记的点9输出。GIF 为静态图;JPG 和 BMP 不支持透明背景;SVG 转换不会把位图变成真正矢量。点9切图、APP 图标切图及图片分割切图尚未加入当前可用流程。