cc-web/.planning/2026-08-25-instance-custom-icon/progress.md

实例自定义图标进度

2026-08-25

• 已读取 planning-with-files、todo-list-csv 与 Trellis 工作流。
• 已确认 home-cc-web codebase-memory 索引状态为 ready。
• 已创建并启动 Trellis 任务 08-25-instance-custom-icon。
• 已识别并保留与本任务无关的工作区改动：.gitignore、README.md、config/cross-conversation-replies.json。
• 待办脚本首次使用项目内路径失败，已确定实际安装路径并写入错误记录。
• 独立计划审查已通过，无阻断问题。
• 并行 codebase-memory 查询因 transport closed 失败；索引此前已确认 ready，改由两个只读代理串行使用 MCP 调研，主线程稍后做本地交叉验证。
• 前端只读调研完成并与本地精确检索交叉验证，结果已持久化到 Trellis research 文档。
• 服务端只读调研完成，确认可复用 CC_WEB_CONFIG_DIR、二进制图片上传、Bearer 鉴权与固定路径写入模式；结果已持久化。
• 已完成跨层数据流、HTTP 契约、持久化与错误语义设计，写入 Trellis info.md。
• 已配置并验证 Trellis implement/check 上下文；实现代理已启动，正在按测试先行方式修改产品代码。
• Trellis 实现代理长时间无产品改动且未响应进度询问，已安全中断；主线程接手测试与实现。
• 实现代理的在途工具调用于中断后完成落盘，新增 scripts/regression.js --target instance-icon 的完整测试目标；实现前运行按预期失败，静态契约缺少 index/frontend/SW/server/style/gitignore 五类实现。
• 第一版代码已落下；首次验证发现服务端预置同名大小常量导致重复声明，语法检查已在集成测试前准确阻断，正在定向修正。
• 合并重复常量后，node --check server.js、node --check public/app.js 与 node scripts/regression.js --target instance-icon 均通过。
• 服务端 API、CONFIG_DIR 固定路径持久化、动态图标/Manifest、设置页裁剪上传/预览/恢复与全局消费点已实现；进入相关与全量回归。
• instance-icon、frontend-asset-version 聚焦回归与 npm run regression 全量回归通过；git diff --check 通过。
• git check-ignore 证明正式/临时实例图标文件由新增精确规则忽略，且 git ls-files 不跟踪它们；用户已暂存 .gitignore 改动与本功能工作树改动保持分层。
• Trellis Phase 2.2 独立审查无阻断/高/中风险发现；按唯一低风险建议移除动态图标 link 的固定 sizes，避免默认 192px 与自定义 512px 共用时提示不准确。
• 用户要求取消后续额外审计，改为重新打包并将当前工作区全部修改统一提交、推送。
• 已复用本机 @oven/bun-linux-x64-baseline 重新执行 npm run build:single-exe，更新 dist-exe/cc-web-bun-linux-x64-baseline.tar.gz。
• 发布校验通过：六项 JavaScript 语法检查无错误；打包后二进制的 MCP initialize 返回有效 JSON-RPC；tar.gz 可读取；git diff --check 通过。
• 新发布包 SHA-256 为 2fb1f0a55ada79420f9599584c53fd4c1d04fb2d05cf25c29cda2150e3b27a48，大小 43,871,596 bytes。