svg-composer

# SVG 拼接工具 (svg-composer) > 将 SVG 符号进行横向/纵向拼接，支持内置字符集和四种拼接模式。 ## 触发场景 **正向触发：** - [拼接 / 组合 / 合成 SVG 图标或字符] - [生成 SVG 密码本 / 验证码 / 全排列组合] - [制作复合 SVG 图标 / Logo / 徽章] - [批量生成 SVG 预览 HTML] **否定条件：** - 用户要求生成普通图片（PNG/JPG）——不是 SVG 格式 - 用户要求矢量绘图但非拼接（如画线框图）——请用 draw.io 技能 ## 核心能力 > 📚 **渐进式加载**：本技能采用渐进式 MD 体系，`SKILL.md` 为入口（≤230行），详细内容拆分到 `references/*.md` 按需加载。 | 能力 | 说明 | 限制 | |------|------|------| | **内置字符集拼接** | 基于 Font Awesome Free 字符，拼接 `0-9`、`A-Z` 文本 | 仅 36 个字符，小写自动转大写 | | **四种拼接模式** | 顺序 / 全排列 / 笛卡尔积 / 限制长度 | 笛卡尔积输入 ≤5 字符，length ≤4 | | **自定义符号拼接** | 从外部 SVG 文件加载符号拼接 | 依赖用户提供 .svg 文件 | | **批量预览 HTML** | 自动生成含下载链接的预览页 | 仅内联 SVG 预览，无服务器 | ### 渐进式文件索引 | 文件名 | 分类 | 包含内容 | 审计关联 | |--------|------|----------|----------| | `references/functions.md` | 函数参考 | 完整函数参数与返回值说明 | 无 | | `references/charset.md` | 字符集 | 内置字符集详情与四种拼接模式对比 | 无 | | `references/examples.md` | 使用示例 | 11 个完整使用示例 | R-25 C-17 | | `references/changelog.md` | 版本日志 | 版本更新记录 | R-24 | | `references/faq.md` | 常见问题 | 常见问题与排错 | R-19, R-25 C-19 | | `references/antipatterns.md` | 反模式 | 常见错误做法与正确做法 | R-18 | | `references/permissions.md` | 权限说明 | 安全风险评估 | R-15, R-16 | | `references/LICENSE.md` | 许可协议 | MIT 许可 | R-26 | ## 快速开始 ```python from svg_composer import compose_text # 基础拼接（黑色） svg = compose_text("HELLO", fill="black") with open('hello.svg', 'w', encoding='utf-8') as f: f.write(svg) # 输出: hello.svg — 包含 HELLO 五个字符的横向拼接 SVG # 纵向排列 svg = compose_text("ABC", direction='vertical', canvas_size=(400, 600)) # 输出: S...