# Image Processing

> |

- **Type:** Skill
- **Install:** `agentstack add skill-z0gsh1u-oh-my-writing-skill-image-processing`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [z0gSh1u](https://agentstack.voostack.com/s/z0gsh1u)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [z0gSh1u](https://github.com/z0gSh1u)
- **Source:** https://github.com/z0gSh1u/oh-my-writing-skill/tree/master/skills/image-processing

## Install

```sh
agentstack add skill-z0gsh1u-oh-my-writing-skill-image-processing
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 图片处理 Skill

你是一个图片处理助手，负责为配图添加文字标注和装饰效果。

## 核心能力

1. **底部边框式配文**：在图片下方添加独立的文字区域，类似画框效果
2. **内部贴纸式配文**：在图片内部添加带背景的文字标签，类似小红书贴纸效果
3. **中文支持**：使用 Windows 系统自带的微软雅黑字体
4. **Emoji 支持**：使用 pilmoji 库渲染 Emoji 表情

## 使用方式

### 模式 1：底部边框式配文

在图片下方添加白色/深色背景的文字区域：

```bash
python scripts/image_processor.py input.jpg output.jpg --mode frame --text "这是配文 🎉"
```

**效果示例：**

```
┌────────────────────┐
│                    │
│      原图片         │
│                    │
├────────────────────┤
│  这是配文 🎉        │
└────────────────────┘
```

**参数：**

- `--mode frame`：边框模式
- `--text`：配文内容（支持中文和 Emoji）
- `--bg-color`：背景颜色（默认 `white`，可用 `black`、`#RRGGBB`）
- `--text-color`：文字颜色（默认 `black`）
- `--font-size`：字体大小（默认 32）
- `--padding`：内边距（默认 20）

### 模式 2：内部贴纸式配文

在图片内部指定位置添加带背景的文字标签：

```bash
python scripts/image_processor.py input.jpg output.jpg --mode sticker --text "重点！" --position bottom-right
```

**效果示例：**

```
┌────────────────────┐
│                    │
│      原图片    ┌───┤
│               │重点│
└───────────────┴───┘
```

**参数：**

- `--mode sticker`：贴纸模式
- `--text`：配文内容
- `--position`：位置，可选 `top-left`、`top-right`、`bottom-left`、`bottom-right`、`center`
- `--bg-color`：标签背景色（默认 `#FFE4B5`，浅橙色）
- `--text-color`：文字颜色（默认 `#333333`）
- `--font-size`：字体大小（默认 28）
- `--opacity`：背景透明度 0-255（默认 230）
- `--radius`：圆角半径（默认 10）
- `--margin`：距边缘距离（默认 20）

### 批量处理

处理多张图片：

```bash
python scripts/image_processor.py ./images/*.jpg --output-dir ./output --mode frame --text "配文"
```

## 字体配置

脚本会按以下顺序查找中文字体：

1. `C:/Windows/Fonts/msyh.ttc` - 微软雅黑
2. `C:/Windows/Fonts/simhei.ttf` - 黑体
3. `C:/Windows/Fonts/simsun.ttc` - 宋体
4. 系统默认字体（可能不支持中文）

如需使用自定义字体：

```bash
python scripts/image_processor.py input.jpg output.jpg --font "C:/MyFonts/custom.ttf" --text "配文"
```

## 颜色参考

常用颜色值：

| 名称 | 代码                | 用途          |
| ---- | ------------------- | ------------- |
| 白色 | `white` / `#FFFFFF` | 边框背景      |
| 黑色 | `black` / `#000000` | 深色背景/文字 |
| 浅橙 | `#FFE4B5`           | 贴纸背景      |
| 浅蓝 | `#E3F2FD`           | 贴纸背景      |
| 浅绿 | `#E8F5E9`           | 贴纸背景      |
| 浅粉 | `#FCE4EC`           | 贴纸背景      |

## 与其他 Skill 配合

1. 使用 [图片搜索 Skill](../image-search/SKILL.md) 找到合适的配图
2. 使用本 Skill 添加配文
3. 在 [通用写作 Skill](../general-writing/SKILL.md) 中引用处理后的图片

## 注意事项

1. **图片格式**：支持 JPG、PNG、WEBP 等常见格式
2. **输出格式**：根据输出文件扩展名自动选择格式
3. **Emoji 渲染**：需要安装 pilmoji 库
4. **字体权限**：确保对字体文件有读取权限

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [z0gSh1u](https://github.com/z0gSh1u)
- **Source:** [z0gSh1u/oh-my-writing-skill](https://github.com/z0gSh1u/oh-my-writing-skill)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-z0gsh1u-oh-my-writing-skill-image-processing
- Seller: https://agentstack.voostack.com/s/z0gsh1u
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.