需替换qoderwake图标包，须严格按目录结构准备16px/24px/32px三套尺寸svg或png图标，文件名与内置id一致；打包为无嵌套zip并生成sha-256校验值写入manifest.json；最后通过后台上传或手动覆盖部署。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让QoderWake文件列表中的图标更贴合企业VI或个人审美，而不是默认的扁平化通用图标，就得替换整套图标资源包。这需要严格遵循目录结构、尺寸规范与校验机制，否则界面会回退到占位符或报加载失败。
准备符合规范的图标资源
图标包必须包含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
方法一：通过管理后台上传
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
1、登录QoderWake超级管理后台 → 进入「外观设置」→ 「图标资源管理」。
2、点击「上传自定义图标包」按钮，选择已准备好的qoder-icons-custom.zip文件。
3、系统自动读取manifest.json并校验SHA-256值，【若校验失败，上传立即终止且不提示具体错误位置】。
4、校验通过后点击「启用此图标包」，所有已连接终端将在10秒内刷新文件列表图标。
方法二：手动部署至安装目录
1、关闭QoderWake客户端进程，防止资源锁死。
2、定位安装目录下的resources/skins/default/路径（Windows默认在C:\Program Files\QoderWake\resources\skins\default\）。
3、将qoder-icons-custom.zip重命名为icons.zip，覆盖原icons.zip文件。
4、重启QoderWake，观察左下角状态栏是否出现图标更新提示（齿轮图标闪烁两次）。
