dsh-brick-mosaic · 砖拼工坊

DeepSeek Harness（dsh）插件：把任意图片转成乐高 Art 系列马赛克像素画，生成 PDF/长图拼搭说明书。马赛克计算 100% 在面板浏览器端完成（图片不上传）；会话模型提供创作指导与 AI 风格优化；brick_mosaic 工具管理作品档案与跨作品采购清单。

移植自 custombrickmosaic.github.io（Christoph Fritzsch 开源项目）的 Liangdabiao 深度定制版（原 100% 客户端 Web 应用 + 微信小程序）。

核心功能

🧱 马赛克引擎（面板内，原样保留）：11 个乐高 Art 套装色板（猫王/蝙蝠侠/钢铁侠/西斯/霍格沃茨/米奇/披头士/梦露/自定义肖像/世界地图/Art 项目）、Lab 色差匹配、颗粒数量约束的艺术效果（套装数量支持 0.9 小数微调）、HSV/对比度/暗部亮部调整、自定义裁剪（Cropper.js）、忽略黑色区域
📄 拼搭说明书：16 颗粒分区指引的 PDF（jsPDF）与长图（PNG）下载
✦ AI 风格优化（面板「🤖 AI 风格优化」按钮）：一键把图片转多边形艺术风格——默认走 agnes-ai 图生图（agnes-image-2.0-flash，key 内置、体验价 $0，支持 Config 覆盖与代理），返回 data URI 不经 CORS 直接进引擎重算马赛克
✦ agent 创作指导（mosaic-artist 技能）：照片选择/尺寸规划/套装组合策略/调色思路；AI 风格优化也可由 agent 用 dreamina-canvas / apiz CLI 完成
💾 作品档案（右上角「📁 作品档案」）：面板「💾 存到作品档案」把尺寸/套装组合/颗粒清单 + 一张马赛克 PNG 入库（PNG 是拼出来的预览图，方便回看；源图不上传也不保存）；档案页可看列表缩略图、展开颗粒清单（色块/RGB/element ID/数量）、下载 PNG、勾选多个作品聚合采购清单（CSV 导出）、删除；同一份数据 agent 用 brick_mosaic 工具也能查
🔒 隐私：图片全程本地处理，不上传任何服务器；档案只存参数与颗粒清单，不存图片
🎨 dsh 家族皮肤：面板换成暖纸底 + 砖橙强调色的统一视觉（lab/bm-theme.css），明暗主题跟随宿主（lab/scheme.js + theme/change → postMessage），不再是一块突兀的 Bootstrap 白板

使用流程

侧栏「砖拼工坊」→ 面板里上传图片、裁剪调色、选 Art 套装与尺寸 → 「生成马赛克」
需要创作建议（选照片/尺寸/套装/调色/AI 风格优化）直接在对话里问 agent，它会用 mosaic-artist 技能 + dreamina/apiz CLI 帮你
算完点「💾 存到作品档案」入库（连同马赛克 PNG）；右上角「📁 作品档案」看缩略图与颗粒清单、勾选多个作品聚合采购清单并导出 CSV；对话里问「我这些作品一共要买多少颗粒」→ agent 跑 brick_mosaic(action="parts_list") 给同样的清单

安装

dsh plugin add https://github.com/liangdabiao/dsh-brick-mosaic

依赖自动安装（仅 @deepseek-ai/schemastery）。数据在 ~/.dsh/brick-mosaic/（DSH_HOME 可改）。

开发

npm install npm test # 7 项单测：档案库 + 原项目 11 套装色板完整性校验 npm run build # client.js → dist/client.js node scripts/smoke.mjs # 16 项冒烟：静态页/vendor/API 全链路/工具直调 npm run test:e2e # 浏览器端到端（save 全链路 / 档案页 / AI+裁剪回归） DSH_HOME=<临时目录> node scripts/devserver.mjs 5251 # 面板独立预览（e2e 用它，别污染真实档案）

架构

├── src/host.js brick_mosaic 工具（save/projects/project/parts_list/remove，id 支持前缀引用） ├── src/systemPrompt.js 工作流硬规则（计算在面板/档案用工具/AI 优化给路径） ├── lib/store.js 作品档案（projects/*.json 原子写 + 同目录 .png 缩略图）+ 跨作品零件聚合 ├── lib/api.js /brick-mosaic 前缀路由（档案 CRUD / 缩略图 / AI 优化 / lab 静态资源） ├── lib/ai.js agnes-ai 图生图客户端（key 内置可覆盖、JPEG 尺寸探测选档、代理 CONNECT 隧道） ├── lib/skills.js 技能提供方 ├── skills/mosaic-artist/ 创作方法论 + AI 风格优化 CLI 对接 ├── lab/ │ ├── index.html 原 UI 本地化迁移（品牌条 + 存档按钮 + agent 按钮） │ ├── brickMosaic.js 原引擎 2138 行（行为不变） │ ├── app-shell.js 外壳：存档钩子（含马赛克 PNG 缩略图）+ 套装数量输入重算 │ ├── archive.js 作品档案页：列表(缩略图) / 颗粒清单详情(大图+下载PNG) / 跨作品采购清单(CSV) / 删除 │ ├── bm-theme.css dsh 家族皮肤（明暗双主题 token + Bootstrap 覆盖） │ ├── scheme.js 明暗跟随：宿主 data-ds-dark-theme / postMessage → html[data-scheme] │ ├── vendor/ jspdf 1.5.3 + bootstrap 5.0.0-beta2（本地化） │ └── cropper.min.js/css └── client.js → dist/ 侧栏入口 + iframe 桥

边界与说明

只支持浏览器可解码的图片格式（jpg/png/webp/gif）；扫描件质量的低对比照片效果差，先让 agent 指导调色或风格化
内置 agnes-ai key 为免费体验档（$0），高并发时段可能返回「队列已满」——重试即可，或在 Config 换自己的 key；也可走 agent 的 dreamina/apiz CLI 路径
大图（4000px+）计算耗时随尺寸增长，面板有进度条