MINIATURE WORLD · v0.1.3

从一个物件,
发现另一个世界。

微缩摄影 Skill 的离线安装与使用指南。适合用已有 AI 宿主,把日常物件变成有故事的小世界。

代码与自编文档采用 MIT;图片各有许可。v0.1.3 维护版;发布状态以 Release 页为准。图像能力与额度由宿主提供。先用文字方案确认安装,再请求生成。

先试一句,不生成图片

安装后在新任务中确认实际加载路径,再发送:

使用 $create-miniature-world,把一把普通刨丝器做成微缩摄影。
先给三个方案,不要生图;说明每案的可见联系,推荐一案。

预期结果:三个不同的物件关系、明确推荐及参考图缺口;此步骤只输出文字,不调用图像工具。Claude Code 把入口改为 /create-miniature-world。物品名称即可完成这项冒烟,不要求下载或提供照片。

它能做什么

验收范围与边界

2026-10-13 两张真实刨丝器参考样张,经用户对照照片确认商品外观、故事、人物尺度、美感四项通过。它说明这两张在所声明范围内通过,不保证任意商品或细节都可靠。

准确文字、全部 SKU、精确微孔/纹理、隐藏面、真实毫米比例与人偶雕塑型号仍不保证。没有工具时只交方案/提示词;能看图不代表图像工具能接收参考图。

16位RGBA TIFF可能在本机后期丢失Alpha;这类输入保留原图,不运行后期。高位深PNG保护未扩大到所有格式。

输入准备

模式、次数与成本

请求动作工具/费用
先看方案 / 只给提示读图、文字策划不调用图像工具;宿主文字模型费用或额度仍依账号
直接生成默认两案各一张;只有一案成立、指定创意或只要一张时一次调用宿主图像工具,可能消耗额度或费用
修改当前图按用户点名编辑,原图留存需实际编辑能力,可能另消耗额度
本机后期颗粒、可选轻微景深,另存文件本地 Python/Pillow/NumPy,不调用生图服务

先交初图、等用户选择,选中后有需要才编辑;整轮初始图共享最多一次编辑。可自动定向修正仅限结构错误,人物尺度和构图偏差报告后等用户点名,不因画高目标自动缩小。两个都不喜欢时先诊断,明确请求新方向才再生成。指定次数或禁止重试时优先遵守。它不包含模型、登录、密钥、图像额度或付费 API 客户端,也不会为验收自行接新服务。

安装前看这里

环境已验证仍未验证
macOS / Codex CLI 0.161.0参考图生成、指定编辑、保存;两条拍法与真实参考样张;2026-10-14本项目新会话显式加载、11文件摘要核对另一台新机器的自动触发、全版本兼容性
macOS / Claude Code 2.1.295(2026-10-09记录)项目级安装、显式调用、方案输出;2026-10-14更新并核对11文件当前新拍法及本轮Claude新会话;当时无内置生图/编辑
Windows / Linux文件结构可复制,未作为宿主验收宿主发现、生成、更新与卸载状态

这里列出测试版本,不声称最低兼容版本。Skill 文件本身没有编译或管理员权限要求。复制十余个运行文件即可;下载和图像账号准备耗时取决于宿主,本轮未计时新机安装。专用ZIP约8.9MB,展开约9.2MB;逐文件大小见随包校验清单。

后期需 Python 3、Pillow、NumPy;本机记录为 Python 3.14.6、Pillow 12.1.1、NumPy 2.4.6,不作为最低版本承诺。缺依赖则先交原图,不自动安装。安装和阅读本指南可离线;AI宿主与图像服务通常需要网络及有效账号。

验证下载,然后安装

从 项目仓库确认发布者和版本;专用安装包应附同名 .sha256 文件。在同一下载目录核验:

shasum -a 256 -c create-miniature-world-v0.1.3.zip.sha256

Windows 可用系统提供的 SHA-256 文件工具比对完整摘要。校验值只有从可信渠道获得时才帮助检查替换或损坏;摘要和压缩包同时来自被篡改渠道时,摘要不会自行证明发布者身份。

解压后,唯一安装源是 skills/create-miniature-world/。v0.1.3仅安装11个运行文件:入口、agents、references、figure-refs及后期脚本;开发源码的evals与CHANGELOG保留在源码,不安装。选择一个安装范围:

宿主项目级(推荐)用户级(明确需要时)
Codex.agents/skills/create-miniature-world/~/.agents/skills/create-miniature-world/
Claude Code.claude/skills/create-miniature-world/~/.claude/skills/create-miniature-world/

先检查同名目录或符号链接,已有版本先比较和备份。首次安装,在解压目录或包含该源的项目根目录执行下列 Codex 示例;它只复制本项目安装目录,不改全局配置:

if [ ! -d skills/create-miniature-world ]; then
  echo "请先进入含 skills/create-miniature-world 的项目根目录"
elif [ -e .agents/skills/create-miniature-world ] || [ -L .agents/skills/create-miniature-world ]; then
  echo "已有同名目录或链接:先比较与备份,不覆盖"
else
  mkdir -p .agents/skills
  mkdir -p .agents/skills/create-miniature-world
  cp skills/create-miniature-world/SKILL.md .agents/skills/create-miniature-world/
  for part in agents references assets scripts; do
    cp -R "skills/create-miniature-world/$part" .agents/skills/create-miniature-world/
  done
fi

Claude Code 改用 .claude/skills/。Windows 可在文件管理器中复制到同名目录,遇已有目录停止,不选择覆盖。复制目录不等于宿主已发现;打开新任务/会话,显式调用 Skill 并核对实际加载文件。项目级与用户级选择一个,避免同时装两份。

两条拍法与验收样张

公开main使用新名称“柔光棚拍 / Soft Studio”;旧称“田中风格”“田中达也风格”“Tanaka-inspired”仍兼容同一路线。v0.1.3 安装包使用新名称;历史 v0.1.0 安装包保留旧名称。

默认“柔光棚拍”可从柔光与干净承托面开始;“实拍光影”用光向、材质与接触阴影建立观感。机位、焦段、补光和景深按关键关系选择,不固定浅景深或人物画高/人数。人物、部件与标签需要同时清楚时保留清晰范围;造型参考不提供精确物理比例。创意稿用于选案,正式成片需达到本次商品外观等要求;按实际质量推荐交付数量,不固定交两张。

把这张商品图做成微缩摄影,保持商品外观,柔光棚拍,只生成一张。
把这张商品图做成有实拍光影感的微缩摄影,保持商品外观,只生成一张。
只把当前图的光线调暖,商品、人物位置和构图保持,另存一个结果。
柔光棚拍:三名微小工人在米色把手刨丝器旁清理奶酪积雪
柔光棚拍 · AI生成+颗粒后期
实拍光影:暖侧光下工人铲扫奶酪碎屑并装入推车
实拍光影 · AI生成+颗粒后期

查看真实参考照、原图/后期、来源、校验值和四维反馈。微孔和纹理不宣称逐点精确复制,遮挡和局部重绘的观察仍保留。AI样张不自动归入MIT或额外商用许可。

工具不足时

我没有可传入参考图的图像工具,但要求商品标签和结构严格保持。
先给方案并说明当前阻塞,不生图,不切换外部服务。

预期:说明参考图输入能力不足,保留文字方案;不能把文字重生成当成保真编辑。

用真实商品照片入门:遥控器Before / After教程展示上传、选案、生成与保真检查;两张当前结果严格细节保真未通过。回归范围与结果另记。

照片和文件会去哪里

商品图、人偶参考及提示会由你当前的AI宿主和图像服务处理,可能离开本机;只提交你有权分享给这些服务的内容。网站没有照片上传或生图入口,本离线指南没有脚本、分析或追踪器。

项目输出通常保存在 outputs/,内置工具还可能在宿主返回的原生路径留存图片(本机 Codex 使用 $CODEX_HOME/generated_images/)。输入保留在你选择的目录,原件不覆盖;日志/缓存与提供商保留期、遥测由宿主与账号设置决定,本轮未核实这些期限。

卸载 Skill 不会自动删除输入、输出、宿主图片或对话。需要清理时先备份,再明确删除自己选择的图片/输出目录,并用宿主界面管理历史和账号数据。不要发送账号配置或密钥,也不要把整批日志、照片目录自动提交到仓库。

更新、回退与卸载

  1. 先确认实际加载位置;无个人修改时可更新仓库源,有修改时先比较,不强制拉取或覆盖。
  2. 将旧安装目录复制到独立备份位置,再按上方11文件范围把新源复制到所选安装位置。不要把备份留在宿主扫描的 skills 目录中。
  3. 新任务中核对11个运行文件并跑“先给方案,不要生图”的冒烟;拉取源码不会自动更新旧安装副本。
  4. 回退时关闭活动任务,保留新版本副本,再恢复旧目录,并开新任务确认加载。
  5. 卸载只移除自己选定的安装目录;保留输入、输出和备份,除非另行决定删除。宿主缓存刷新与状态清理未在新主机验证。

本版运行结构不引入额外配置、服务或数据迁移。以上流程已写明;新主机升级/回退/卸载的完整宿主生命周期仍未验收。

排查常见问题

反馈与安全诊断

支持渠道:项目GitHub Issues。先收集宿主/操作系统版本、包版本、实际加载目录、非敏感错误文字和原图/结果差异。

分享前删去密钥、账号ID、私人提示、客户图像、家庭目录详情和完整工具响应。能提供图片时先确认有相应用途权利;不要为排查导出账号设置或秘密文件。

版本、来源与状态

当前版本 v0.1.3 维护版。Release与安装包是固定版本入口;发布成功后可下载。放宽创意类别配额、固定人物占比/人数及摄影限制,补充图像联想与交付等级判断;保留A/B及一次编辑预算、商品结构依据和EXIF/ICC后期。11个运行文件范围不变。包内 MANIFEST.json 记录来源提交及逐文件摘要。

MIT覆盖有权许可的代码与自编文档。包内三张人偶照片仅CC BY-NC 4.0;Grater照片Ben Dalton/noii、CC BY 2.0;AI生成及后期图独立列出来源,不提供额外商用/修改/再分发授权。不授予人偶造型或商标权利,不代表田中达也、Preiser或商品品牌官方合作。

状态词:草案=未完整检查;候选=实现存在、还有待验收项;已验证=证据只覆盖明确范围;已发布=远端Release成功并核对;生产就绪=声明范围全部要求通过;阻塞=缺必要输入/能力/授权;待办=已明确延后。用户认可是一项决定,不能替代未运行的工具验证。

历史 v0.1.2、v0.1.1、v0.1.0 与 rc2 标签及附件保留。v0.1.3 的完整 ZIP 摘要见 Release 随附的同名 .sha256 文件;按上方命令核验,不使用旧版本摘要。

这份指南是 guide-required,可离线阅读、键盘导航和打印。本版放宽固定候选类别、人物画高/人数、取景与景深,补充标签图像等联想入口和创意稿/正式成片的交付区分。已完成本机Codex项目安装与一次独立临时CLI显式读取/三案策划;主会话对三件商品生成5张初图、计时器编辑1次。计时器创意获正向反馈,切蛋器三图的交付建议获认可;严格商品细节保真未通过,不宣称稳定提升或独立盲测。历史刨丝器样张保留当时来源与反馈,本轮新图不随包公开。新机、跨系统、桌面隐式发现与Claude新会话未验证;不宣称生产就绪或全Skill自演进。