QoderWake自定义图标包测评：文件列表颜值提升
替换QoderWake图标包时，必须按照固定目录结构准备16px、24px、32px三组尺寸的SVG或PNG图标。每个文件的命名必须与内置图标ID完全一致。然后将图标文件夹打包成无嵌套的ZIP压缩包，计算SHA-256校验值并写入manifest.json。最后通过管理后台上传或手动覆盖部署即可生效。
若希望QoderWake文件列表的图标风格更符合个人审美，而非默认的扁平化通用图标，就需要手动替换整套图标资源包。操作本身并不复杂，但必须严格遵循目录结构、尺寸规范与校验机制，否则界面将回退为占位符或直接报加载失败。
几个关键点：图标包需包含16px、24px、32px三套尺寸，分别对应不同缩放比例下的清晰渲染。缺失任一尺寸，高DPI屏幕下图标便会模糊或错位，严重影响视觉体验。
在本地新建一个文件夹，命名为icons；在该文件夹内再创建三个子文件夹：【16px】、【24px】、【32px】。将设计好的SVG或PNG图标按尺寸分别放入对应子文件夹。一个常见陷阱：所有图标文件名必须与QoderWake内置图标ID完全一致——例如file_doc.svg、folder_open.svg，否则渲染节点无法匹配，图标将无法显示。
导出环节同样需注意。不建议使用Photoshop导出PNG，因其易残留透明底噪或产生非整数像素偏移。推荐使用Figma或Illustrator，导出时勾选“对齐像素网格”与“导出为整数尺寸”，确保图标边缘清晰锐利。
打包与签名图标ZIP包
第一步：将icons文件夹整体压缩为ZIP格式，命名为qoder-icons-custom.zip。注意切勿嵌套父级文件夹，确保解压后直接可见16px/、24px/、32px/三层目录。
第二步：打开终端，执行SHA-256校验命令：shasum -a 256 qoder-icons-custom.zip。复制输出的64位哈希值，该值将在后续皮肤包验证环节使用。
第三步：在ZIP包同级目录下新建manifest.json，写入以下内容（务必将your_hash_here替换为上一步获得的真实哈希值）：
{
"type": "icon-pack",
"version": "1.0.0",
"checksum": "your_hash_here",
"required_qoderwake_version": ">=0.3.5"
}
部署图标包至QoderWake
以下提供两种部署方式，可根据个人习惯选择。
**方法一：通过管理后台上传**
1. 登录QoderWake超级管理后台，依次进入「外观设置」→「图标资源管理」。 2. 点击「上传自定义图标包」按钮，选择此前准备好的qoder-icons-custom.zip文件。 3. 系统将自动读取manifest.json并校验SHA-256值——【若校验失败，上传立即终止，且不提示具体错误位置】。因此务必确保哈希值正确。 4. 校验通过后，点击「启用此图标包」，所有已连接的终端将在10秒内刷新文件列表图标。**方法二：手动部署至安装目录**
1. 先关闭QoderWake客户端进程，防止资源被锁定。 2. 定位到安装目录下的resources/skins/default/路径（Windows默认路径为C:Program FilesQoderWakeresourcesskinsdefault）。 3. 将qoder-icons-custom.zip重命名为icons.zip，覆盖原有的icons.zip文件。 4. 重启QoderWake，观察左下角状态栏是否出现图标更新提示——齿轮图标闪烁两次即表示更新成功。两种方式效果相同，按个人偏好选择即可。完成后，文件列表的图标将替换为定制版本。