wolege-dou：拼豆工具的流程、人审与授权边界

原研究时间：2026-10-05；2026-10-13 核对修订。项目：gerrywrittenhousea76-design/wolege-dou；许可：PolyForm Noncommercial 1.0.0。

像素虾在本地工作台核对拼豆图纸色卡和用豆清单 — 图 1：拼豆工具的价值，在于确定性计算与清晰的使用边界。

一句话定性

一个本地拼豆技术 MVP：把图片转图纸，或给已有品牌色号图纸做库存检查与报价资料。值得学的是“不让 LLM 猜关键数字”和“两道人审门”，不是把源码包当成已经合规验收的门店系统。

像一家小作坊：颜色、颗数、库存、报价各有账本，最后还得拿真实材料与规则核对。确定性计算保证执行同一算法，不保证输入正确或实物颜色必然一致。

关键事实

官方 README要求 Python 3.11+，网页与业务处理在本机运行。
图片入口生成参考配色、颗数、PNG/PDF/ZIP；参考编号 P01… 不是品牌采购色号。
高级入口需要图纸、色卡、库存、计价规则、订单偏好五类业务输入。
许可证为 PolyForm Noncommercial 1.0.0 原文，应称非商业用途源码公开，不是自由商用的标准开源。
E01～E10 明确为合成评测，不是客户样本或门店验收。
原稿“整个代码仅 310KB”与列出的单文件大小互相矛盾，删除；不再用早期 stars、仓库年龄或无 issues 推断质量与完成度。

作者信息应怎样看

仓库描述与自述可以用于识别项目，不能凭用户名、公开仓库数量或文档风格判断“肯定不是营销号”“身份已交叉认证”。本文不作作者诚信或公司关系认证，只研究可检查的内容。

逻辑全景图

图片出图和已有品牌色号图纸库存报价是两条不同入口 — 图 2：照片参考色不能直接当品牌采购色号，库存报价需要完整业务输入。

├─ 触发层：图片出图 / 已有品牌色号图纸的库存报价
├─ 核心层
│  ├─ 图片缩放、网格与参考配色
│  ├─ 图纸/色卡/库存/计价规则/偏好验证
│  ├─ 缺色候选 → 人工确认换色
│  └─ 展示报价 → 单独批准 → 生产资料包
├─ 输出层：预览、数量、图纸、备料和报价资料
└─ 卡点层
   ├─ 参考色号不能直接采购，屏幕颜色也不等于实物
   ├─ 合成库存不能给客户报价
   ├─ 包生成不代表库存已扣减或订单已执行
   └─ 本机 MVP 没有真实登录、门店角色隔离或公网防护

真正的设计哲学：5 条规则

确定性计算生成唯一事实源，换色和最终价格分别经过人工确认 — 图 3：同一份结果驱动导出，换色与最终价格仍需分别批准。

关键数字用代码计算，LLM 不承担颗数、成本和金额真值。
区分图片入口与高级业务入口。图片入口不保存上传原图；高级流程会在 artifacts 保存输入快照、状态、导出和审计，不能概括成“所有用户数据不落盘”。
绑定回环地址，并明确不应接公网代理、隧道或远程共享。回环监听不是访问认证，更不是完整安全边界。
换色与报价分别批准，批准绑定当前输入和展示结果。
不自动扣库存、收款、采购或发送资料，输出仍需人判断是否能进入生产。

发布与来源记录

原稿多处把文件写成 SOURCE_MANFILE.json，正确名称是 SOURCE_MANIFEST.json。

├─ LICENSE / COMMERCIAL_USE.md：许可与商业咨询
├─ SOURCE_MANIFEST.json：文件、大小、哈希与部分来源/变换字段
├─ PACKAGING_EXCLUSIONS.md：公开包排除范围
├─ THIRD_PARTY_NOTICES.md：依赖声明
├─ docs/SECURITY_AND_PRIVACY.md：数据与副作用边界
└─ docs/INPUT_CONTRACTS.md / DATA_DICTIONARY.md：业务输入契约

manifest 可帮助检查包内一致性，但有些 source_path / transformation 为 null。哈希不证明作者拥有全部权利，也不证明不存在隐私泄露；从来源路径只能看出打包线索，不能据此认证“私有源仓库与专业出版级合规”。

升级路线图（三段位）

入门段（先跑技术 MVP）

官方启动方式在完整源码目录下运行：

python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-public-lock.txt
sh scripts/python.sh -m wolege_dou.cli serve --host 127.0.0.1 --port 8766

打开 http://127.0.0.1:8766/，用自己有权处理的图片试出图，默认 48×48 格、最多 16 色。保留 src、web、config 等目录，不能只复制 Python 包；这些命令是文档示例，本文未执行，也不承诺十分钟完成。

进阶段（理解数据契约）

读 INPUT_CONTRACTS 和 DATA_DICTIONARY，用合成样本研究校验与人工批准。再核对自家品牌色卡和库存的版本、单位、证据类别与计价规则。自检命令为 sh scripts/verify_public.sh；测试跳过不算通过，技术 PASS 不等于真实门店效果或客户报价正确。

高手段（学边界设计）

借鉴“唯一结果源 + 人审 + 输入哈希绑定 + 不默认执行外部副作用”。来源清单和排除清单适合作为发布检查表，不能把某套文件名直接复制就称为合法合规。

场景迁移

底层逻辑是：有限输入 + 确定性计算 + 人工批准 + 可追溯产物。这是工程模式，不是跨行业许可证或合规通行证。

场景 ①：公开源码但限制商业使用

可研究 PolyForm 的允许用途与通知要求。其原文对非商业组织等有专门条款，不能简单写成“所有组织使用都要付费”。超出允许范围的用途应按 COMMERCIAL_USE.md另行咨询；许可不会自动授权第三方图片、商标或色卡，也不能保证防止侵权。

场景 ②：处理用户上传文件的本地应用

借鉴内存处理、最小权限与输出保留策略，可减少某些上传风险。不能宣称“本地库 + 127.0.0.1 = 零出站、零留存、自动满足国内/欧盟要求”。依赖安装、系统备份、浏览器、日志和导出仍要检查。

场景 ③：其他需要对账的垂直工具

材料清单、工程报价、财务辅助表可借鉴结果源和人审门。原稿把它外推到医学影像或法律结论过远：这些场景还需要专门证据、资格、验证与监管要求，本项目不能替它们背书。

部署/借鉴的好处、注意事项、风险

好处

关键数字不交给 LLM、业务输入契约明确、换色和报价分别批准、对外副作用默认关闭。这些设计可降低部分误操作风险。

注意事项

项目自述未完成 Windows 运行/视觉验收，中文 PNG/PDF 仍需字体与阅读器检查。不能从仓库体积推出“很多功能未完成”；应以 README 列出的已实现/未实现能力为准。

风险

安全与隐私文档明确：高级流程保存会话与输入，不自动删除；真实数据仍有保留政策、身份/角色、授权及发布审批等阻塞项。operator_id 是自填追溯标识，不是身份验证。应用也不声称抵御拥有同目录写权限的恶意进程。

图样、客户照片、品牌色卡与成品展示各有权益问题；是否盈利、实物是否能拼好、真实库存是否准确，都不是源码自检能保证的。

与我相关的判断（可借鉴点）

关键数值由可测试代码计算，模型可以解释，但不能编造真值。
canonical_result.json 驱动导出，减少多份结果漂移。
人工批准绑定实际展示结果，输入变了就应重审。
发布清单记录来源与排除项，仍需独立核对权利与敏感数据。
主动写“未验收”比泛称“合规硬、隐私硬”更有信息量。

与前两个项目的对比

维度	内容运营类 Skill	wolege-dou
关键产物	内容建议与运营计划	图纸、数量与报价资料
真值来源	原始材料与人工核查	显式业务输入与计算规则
可借鉴点	协作记忆、反馈闭环	确定性计算、人审与审计

不再用其他文章未经本次复核的许可证和 stars 拼横向排名，也不把“合规姿态”当可量化安全分数。

一句话总结

wolege-dou 的灵魂仍是“克制就是力量”：把计算、批准与真实业务执行分开。它是值得学的本地 MVP，不是靠一套文档就通过验收的合规成品。

2026-10-13 资料核对说明： 实际浏览官方仓库，读取 README、LICENSE、SECURITY_AND_PRIVACY.md、SOURCE_MANIFEST.json 原始内容及源码目录树，修正文件名、代码体积与数据留存误述。PolyForm 官网链接本次返回 404，许可证正文改用仓库内原文核对；未运行服务、自检或真实门店业务。