# 图标命令 (icon)

设置或获取文档/块的图标（emoji）。

## 语法

```bash
siyuan icon <id> [--emoji <emoji>] [--get] [--remove]
```

## 参数说明

| 参数 | 说明 |
|------|------|
| `<id>` | 文档ID或块ID（必需） |
| `--emoji` | 设置图标，支持编码或直接传入 emoji |
| `--get` | 获取当前图标 |
| `--remove` | 移除图标 |

## 使用示例

```bash
# 使用编码设置图标
siyuan icon <docId> --emoji 1f4c4

# 直接传入 emoji 字符
siyuan icon <docId> --emoji 📁

# 获取当前图标
siyuan icon <docId> --get

# 移除图标
siyuan icon <docId> --remove
```

## Emoji 编码说明

思源笔记使用 emoji 的 Unicode 码点作为图标编码，例如 `📄` 的编码是 `1f4c4`。

### 编码转换

- 单个 emoji：`📄` -> `1f4c4`
- 多个码点：`👨💻` -> `1f468-1f4bb` (复合 emoji 示例)

CLI 支持直接传入 emoji 字符，会自动转换为编码。

### 常用 emoji 编码

#### 文档/笔记本类

| 编码 | Emoji | 含义 |
|------|-------|------|
| `1f4c4` | 📄 | 文档 |
| `1f4d4` | 📔 | 笔记本 |
| `1f5c2` | 📂 | 文件夹 |
| `1f4c1` | 📁 | 文件夹 |
| `1f4ca` | 📊 | 图表 |
| `1f4cb` | 📋 | 剪贴板/清单 |
| `1f516` | 🔖 | 书签 |

#### 状态/标记类

| 编码 | Emoji | 含义 |
|------|-------|------|
| `1f4a1` | 💡 | 灯泡/想法 |
| `1f680` | 🚀 | 火箭/项目 |
| `2728` | ✨ | 灵感 |
| `2b50` | ⭐ | 收藏/重要 |
| `1f534` | 🔴 | 紧急/待办 |
| `1f7e2` | 🟢 | 完成/正常 |
| `1f7e1` | 🟡 | 警告/进行中 |
| `26a0` | ⚠️ | 注意 |

#### 分类/组织类

| 编码 | Emoji | 含义 |
|------|-------|------|
| `1f3e0` | 🏠 | 主页 |
| `1f4e6` | 📦 | 收纳盒/归档 |
| `1f4dd` | 📝 | 笔记 |
| `1f310` | 🌐 | 网络/公开 |
| `1f512` | 🔒 | 私有/加密 |
| `1f50d` | 🔍 | 搜索 |
| `1f4da` | 📚 | 书库/资料 |
| `1f3af` | 🎯 | 目标 |

#### 工作/项目类

| 编码 | Emoji | 含义 |
|------|-------|------|
| `1f4bc` | 💼 | 工作 |
| `1f4c5` | 📅 | 日程 |
| `1f4c6` | 📆 | 日历 |
| `270f` | ✏️ | 草稿 |
| `2705` | ✅ | 完成 |
| `274c` | ❌ | 取消/失败 |
| `1f4ac` | 💬 | 讨论/评论 |

#### 技术类

| 编码 | Emoji | 含义 |
|------|-------|------|
| `1f4bb` | 💻 | 代码/开发 |
| `1f916` | 🤖 | AI/自动化 |
| `2699` | ⚙️ | 配置/设置 |
| `1f4db` | 📛 | 标签 |
| `1f527` | 🔧 | 工具 |
| `1f4f1` | 📱 | 移动端 |

## 查找更多 Emoji

- [Emojipedia](https://emojipedia.org/) - 查找 emoji 及其 Unicode 编码
- [Unicode Full Emoji List](https://unicode.org/emoji/charts/full-emoji-list.html)

## 注意事项

1. **编码格式**：使用小写十六进制，多个码点用 `-` 连接
2. **直接传入**：CLI 支持直接传入 emoji 字符，会自动转换
3. **移除图标**：使用 `--remove` 参数移除已设置的图标

## 相关文档

- [属性管理](block-control.md) - 底层属性操作
- [最佳实践](../advanced/best-practices.md)