Skip to content
Back to search

image-to-css-art

将参考图片离线描摹为纯 HTML + CSS 单文件插画的 Agent 插件,支持轮廓提取、局部渐变与输出审计。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/avroracl--image-to-css-art/badge.svg)](/listings/avroracl--image-to-css-art)

HTML

<a href="/listings/avroracl--image-to-css-art"><img src="/api/listings/avroracl--image-to-css-art/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 171 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. # Image to CSS Art
  3. [![release](https://img.shields.io/github/v/release/AvroraCL/image-to-css-art?style=flat-square&logo=github)](https://github.com/AvroraCL/image-to-css-art/releases)
  4. [![checks](https://img.shields.io/github/actions/workflow/status/AvroraCL/image-to-css-art/ci.yml?style=flat-square&label=checks)](https://github.com/AvroraCL/image-to-css-art/actions)
  5. [![Python](https://img.shields.io/badge/Python-3.10%2B-3776AB?style=flat-square&logo=python&logoColor=white)](https://www.python.org/)
  6. [![HTML + CSS](https://img.shields.io/badge/output-HTML%20%2B%20CSS-21B6AD?style=flat-square)](#输出约束)
  7. [![MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
  8. **把参考图片描摹成可直接打开的纯 HTML + CSS 插画。**
  9. 欢迎路过盒U
  10. [GitHub](https://github.com/AvroraCL/image-to-css-art) · [GitCode](https://gitcode.com/HelenaSG/image-to-css-art) · [下载](https://github.com/AvroraCL/image-to-css-art/releases) · [English](README_EN.md)
  11. </div>
  12. Image to CSS Art 是一个带有独立命令行工具的 AI Agent 技能(Skill)。任何能加载 Agent Skills 并执行本地命令的 AI 编程助手(Codex、Claude Code 等)都可以使用它,不需要任何 Agent 时也能直接用命令行调用。它在本地完成颜色分区、轮廓提取与渐变拟合,将参考图转换成大量 HTML 元素和 CSS 多边形。打开成品时无需 Python、图片文件或网络连接。
  13. 项目是独立社区工具。转换属于有损的自动轮廓描摹,生成的图层按颜色与轮廓组织;不会把人物自动拆成可语义编辑的头发、眼睛或服装组件。
  14. ## 面向用户
  15. ### 能做什么
  16. - 将插画、色块图和其他静态位图转换为单文件 HTML。
  17. - 保留原图比例,以 CSS `clip-path` 绘制轮廓、孔洞与细线。
  18. - 在较大色块内拟合渐变,并用内层底色改善缩小显示时的接缝。
  19. - 提供 `preview`、`balanced`、`faithful` 三档精度;`--fit 20` 按目标体积自动降档适配。
  20. - 在 Oklab 感知色彩空间做中位切分量化,色带与细节丢失更少,同档体积更小。
  21. - 用 `--score` 离线栅格化评分,在报告中量化成品与参考图的差异(MAE)。
  22. - 支持中文路径、EXIF 方向、透明图片的背景合成和 JSON 转换报告。
  23. - 自动检查成品的 HTML/CSS 结构约束。
  24. ### 示例
  25. <div align="center">
  26. <img src="docs/contour-study.png" alt="自制输入测试图:青绿环带、珊瑚色球体、孔洞与细线" width="300">
  27. </div>
  28. 上图是仓库自制的**输入测试图**;[对应的纯 CSS 成品](docs/contour-study.html) 下载后可直接打开。该例包含 326 个轮廓、48 个底色块和 98 处渐变,HTML 约 463 KB。README 中的图片仅用于说明,生成的 HTML 不引用它。
  29. ### 下载 v0.2.0
  30. | 文件 | 说明 |
  31. | --- | --- |
  32. | [image-to-css-art-0.2.0-plugin.zip](https://github.com/AvroraCL/image-to-css-art/releases/download/v0.2.0/image-to-css-art-0.2.0-plugin.zip) | 完整插件源包,含清单、Skill、CLI、文档、示例和测试 |
  33. | [image-to-css-art-0.2.0-skill.zip](https://github.com/AvroraCL/image-to-css-art/releases/download/v0.2.0/image-to-css-art-0.2.0-skill.zip) | 可单独安装的 Skill,已包含转换脚本与许可证 |
  34. | [SHA256SUMS.txt](https://github.com/AvroraCL/image-to-css-art/releases/download/v0.2.0/SHA256SUMS.txt) | 两个压缩包的 SHA-256 校验值 |
  35. 源代码同步保存在 [GitCode](https://gitcode.com/HelenaSG/image-to-css-art)。压缩包不内置 Python 或第三方依赖。
  36. 以上压缩包对应 v0.2.0 标签。
  37. ### 系统要求
  38. - 生成时:Python 3.10+,NumPy、Pillow、OpenCV;首次安装依赖需要网络。
  39. - 查看时:支持 CSS 多边形偶奇填充、渐变和 `aspect-ratio` 的浏览器。
  40. - 本地主要在 Windows + Python 3.12 + Chromium 验证,CI 覆盖 Windows / Linux 和 Python 3.10 / 3.12。
  41. ### 在 AI Agent 中使用
  42. 任何支持 Agent Skills 格式的 AI 编程助手都能加载本技能:下载并解压 Skill 包,把 `image-to-css-art` 整个目录放进个人 `~/.agents/skills/`,或项目的 `.agents/skills/`,然后直接用自然语言让 Agent 调用即可。Codex 用户也可以让 `$skill-installer` 从本仓库的 `skills/image-to-css-art` 安装,加载方式见 [OpenAI 的 Skill 文档](https://learn.chatgpt.com/docs/build-skills)。
  43. 安装后提供参考图片并输入:
  44. ```text
  45. $image-to-css-art 将这张参考图尽可能准确地复刻为纯 HTML + CSS 单文件。
  46. 禁止 img、SVG、Canvas、JavaScript、base64 和外部资源。
  47. 使用 faithful 精度,检查桌面与窄屏效果,然后交付 HTML。
  48. ```
  49. 完整插件的清单位于 `.codex-plugin/plugin.json`。如需在 Codex 插件列表中安装,解压插件包后让 `$plugin-creator` 将这个目录登记到个人本地市场,再从该市场安装并在新任务中测试。流程见 [OpenAI 的插件开发文档](https://learn.chatgpt.com/docs/build-plugins)。本仓库提供插件源包,未提交 OpenAI 公共插件目录。
  50. ### 直接使用命令行
  51. 在仓库根目录执行以下 PowerShell 命令:
  52. ```powershell
  53. python -m venv .venv
  54. .\.venv\Scripts\python.exe -m pip install -r skills/image-to-css-art/requirements.txt
  55. .\.venv\Scripts\python.exe skills/image-to-css-art/scripts/image_to_css.py convert "参考.png" -o "插画.html" --preset faithful
  56. .\.venv\Scripts\python.exe skills/image-to-css-art/scripts/image_to_css.py audit "插画.html"
  57. ```
  58. Linux/macOS 使用 `.venv/bin/python`。转换完成后直接在浏览器打开 HTML。
  59. 常用参数:
  60. | 参数 | 用途 |
  61. | --- | --- |
  62. | `--preset preview/balanced/faithful` | 速度、体积与细节之间的取舍,默认 faithful |
  63. | `--max-width 1200` | 限制描摹宽度;最长边也限制为该值的两倍 |
  64. | `--colors 160` | 量化颜色数,范围 2–256 |
  65. | `--background '#faf8f2'` | 指定页面底色与透明区域的合成色 |
  66. | `--title "画面描述"` | 设置标题及无障碍描述,按纯文本转义 |
  67. | `--max-output-mb 32` | HTML 体积预算,单位 MiB,默认 64 |
  68. | `--fit 20` | 目标体积(MiB):自动逐档降低宽度/颜色直到装得下 |
  69. | `--report .work/report.json` | 写入轮廓数、渐变数、依赖版本及 SHA-256 |
  70. | `--no-gradients` / `--no-underpainting` | 关闭局部渐变 / 防接缝底色 |
  71. | `--score` | 离线栅格化并与参考图对比,在报告中写入 MAE 差异度 |
  72. | `--force` | 明确覆盖已有输出与报告 |
  73. ### 输出约束
  74. 成品由 `main`、`div`、内联样式和必要的文档元信息组成。所有可见图形来自 CSS 多边形和渐变,不包含 `<img>`、SVG、Canvas、JavaScript、外链、字体资源或 base64。Python 仅用于离线制作。
  75. ### 已知限制
  76. 高精度成品可能达到数十 MB、数万个元素,低内存设备上的渲染开销较高。照片、纹理与噪点比色块清晰的插画更容易产生大文件。透明背景会被合成到指定底色;动画和多页图片需要先导出单帧。宽色域或 CMYK 来源建议先转成 sRGB。
  77. 自动审计只能验证结构,不能证明相似度;仍应对照参考图查看细线、轮廓、渐变和不同显示尺寸。完整算法与调参说明见 [tuning.md](skills/image-to-css-art/references/tuning.md)。
  78. ---
  79. ## 面向开发者
  80. ### 设计原则
  81. 转换算法与模型分离:Skill 负责选参数、调用工具和视觉检查,Python 负责可重复的图形处理。相同输入、参数和依赖环境生成相同 HTML;报告另行记录耗时。所有运行资源都放在 Skill 内,单独复制 Skill 后仍可使用。
  82. ### 目录结构
  83. ```text
  84. .codex-plugin/plugin.json # Codex 插件清单
  85. skills/image-to-css-art/
  86. ├── SKILL.md # 工作流程与触发条件
  87. ├── agents/openai.yaml # Codex 展示信息
  88. ├── requirements.txt # 制作阶段依赖
  89. ├── scripts/image_to_css.py # CLI 入口
  90. ├── scripts/css_art/ # 分区、几何、渐变、输出与审计
  91. └── references/tuning.md # 调参与边界
  92. scripts/ # 检查、打包和原创测试图生成
  93. tests/ # 回归测试
  94. docs/ # 可公开的输入样例及 HTML 成品
  95. .github/workflows/ci.yml # 跨平台检查
  96. ```
  97. ### 检查与打包
  98. ```powershell
  99. .\.venv\Scripts\python.exe scripts/check.py
  100. .\.venv\Scripts\python.exe scripts/package.py
  101. ```
  102. 压缩包输出到 `dist/`,仅收录明确列出的源码与文档目录,使用固定 ZIP 元数据以便重复构建。`.venv/`、`.work/` 和用户输入不会打包。不要将私有参考图、生成结果或本机路径提交到仓库。
  103. ### 验证场景
  104. | 场景 | 检查内容 |
  105. | --- | --- |
  106. | 极小输入与纯色 | 1×1、空白背景不会崩溃,合法输出可打开 |
  107. | 透明与方向 | 背景合成正确,EXIF 旋转后保持比例 |
  108. | 孔洞与独立色块 | 偶奇多边形桥接保持填充区域 |
  109. | 细线与渐变 | 深色孤立细节保留,平滑色带产生局部渐变 |
  110. | 文件写入 | 拒绝输入/输出冲突、默认拒绝覆盖、超预算不落盘 |
  111. | 输出约束 | 拒绝脚本、图片、资源 URL 与事件属性 |
  112. | 可重复性与分发 | 相同环境下 HTML/ZIP 一致,独立 Skill 包可运行 |
  113. 视觉检查另外覆盖原始宽度及约 390 px 的窄屏;回归脚本不会冒充视觉相似度测试。
  114. ### 相关项目
  115. 社区已有 [css-video](https://github.com/kevinjycui/css-video) 的 CSS 多边形转换和 [img2css](https://github.com/javierbyte/img2css) 的 CSS 像素阴影路线。这些是相关先例;本仓库没有复制或捆绑它们的代码。当前实现侧重独立单文件、局部渐变、细节保留、Skill 流程与自动约束检查。
  116. ### 参与开发与许可证
  117. 欢迎通过 Issue 提供可公开的最小复现图片、命令、依赖版本和浏览器信息。算法改动请补充对应回归并对照检查生成效果。
  118. 代码与仓库自制测试图采用 [MIT](LICENSE),Copyright (c) 2026 AvroraCL。第三方依赖遵循各自许可证;输入图片与派生内容的权利不因使用本工具而改变。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.