# photoshop-syncartboard

**Repository Path**: msuno/syncartboard

## Basic Information

- **Project Name**: photoshop-syncartboard
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-29
- **Last Updated**: 2025-10-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# KUON - Adobe Photoshop CEP 扩展

一个用于Adobe Photoshop的CEP（Common Extensibility Platform）扩展，提供画板同步、图层复制和Excel/CSV数据导入功能。

## 📋 功能特性

### 🎨 画板同步
- **选中图层**：选择要同步的图层
- **同步图层**：将选中的图层同步到所有其他画板
- 支持普通图层、文本图层、智能对象等

### 📊 数据导入
- **导入文案**：从Excel/CSV文件导入数据
- 支持多种编码格式（UTF-8、GBK、GB2312、Big5）
- 自动编码检测，解决中文乱码问题

### 🔄 图层复制
- **复制图层**：快速复制当前图层指定次数
- 支持批量图层创建

## 🚀 安装指南

### 系统要求
- Adobe Photoshop CC 2015 或更高版本
- Windows 10/11 或 macOS 10.12+
- 支持CEP 6.0+

### 安装步骤

1. **下载扩展文件**
   ```bash
   # 克隆或下载项目到本地
   git clone [项目地址]
   ```

2. **复制到CEP扩展目录**
   
   **Windows:**
   ```
   C:\Program Files (x86)\Common Files\Adobe\CEP\extensions\com.msuno.syncartboard
   ```
   
   **macOS:**
   ```
   /Library/Application Support/Adobe/CEP/extensions/com.msuno.syncartboard
   ```

3. **启用调试模式**（开发时需要）
   
   **Windows:**
   ```reg
   [HKEY_CURRENT_USER\Software\Adobe\CSXS.6]
   "PlayerDebugMode"="1"
   ```
   
   **macOS:**
   ```bash
   defaults write com.adobe.CSXS.6 PlayerDebugMode 1
   ```

4. **重启Photoshop**
   - 完全关闭Photoshop
   - 重新启动Photoshop
   - 在菜单栏找到 `窗口 > 扩展 > KUON`

## 📖 使用教程

### 基础操作流程

#### 1. 画板同步
```
1. 在Photoshop中打开包含多个画板的文档
2. 选择要同步的图层
3. 点击"选中图层"按钮
4. 点击"同步图层"按钮
5. 图层将自动复制到所有其他画板
```

#### 2. 数据导入
```
1. 准备Excel或CSV文件（支持中文）
2. 点击"导入文案"按钮
3. 选择文件（支持.xlsx, .xls, .csv格式）
4. 系统自动处理编码并导入数据
```

#### 3. 图层复制
```
1. 选择要复制的图层
2. 点击"复制图层"按钮
3. 输入要复制的数量
4. 点击确定完成复制
```

### 高级功能

#### 编码支持
- **UTF-8**：国际标准编码
- **GBK**：中文Windows常用编码
- **GB2312**：简体中文编码
- **Big5**：繁体中文编码

#### 文件格式支持
- **Excel文件**：.xlsx, .xls
- **CSV文件**：.csv（支持多种编码）

## 🛠️ 开发指南

### 项目结构
```
com.msuno.syncartboard/
├── CSXS/
│   └── manifest.xml          # 扩展配置文件
├── css/
│   └── styles.css            # 样式文件
├── js/
│   ├── CSInterface.js        # CEP接口库
│   ├── main.js              # 主要JavaScript逻辑
│   └── xlsx.full.min.js     # Excel处理库
├── jsx/
│   └── func.jsx             # Photoshop脚本
├── index.html               # 主界面
└── README.md               # 说明文档
```

### 核心文件说明

#### `manifest.xml`
```xml
<!-- 扩展基本信息 -->
<ExtensionBundleId>com.msuno.syncartboard</ExtensionBundleId>
<ExtensionBundleVersion>1.0</ExtensionBundleVersion>

<!-- 支持的Photoshop版本 -->
<Host Name="PHXS" Version="[11.0,99.9]"/>
<Host Name="PHSP" Version="[11.0,99.9]"/>

<!-- 界面配置 -->
<Type>Panel</Type>
<Menu>KUON</Menu>
```

#### `main.js` - 主要功能
- 文件选择和处理
- 编码检测和转换
- 与Photoshop通信
- 用户界面交互

#### `func.jsx` - Photoshop脚本
- 图层操作
- 画板同步
- 数据导入处理

### 开发环境设置

1. **安装CEP开发工具**
   ```bash
   npm install -g cep-interface
   ```

2. **调试模式**
   - 启用PlayerDebugMode
   - 使用浏览器开发者工具
   - 查看控制台输出

3. **测试流程**
   ```
   1. 修改代码
   2. 重启Photoshop
   3. 测试功能
   4. 查看错误日志
   ```

### 代码示例

#### 文件读取和编码处理
```javascript
// 多编码检测
var encodings = [
  { name: 'UTF-8', decoder: function() { return new TextDecoder('utf-8').decode(data); } },
  { name: 'GBK', decoder: function() { return new TextDecoder('gbk').decode(data); } },
  { name: 'GB2312', decoder: function() { return new TextDecoder('gb2312').decode(data); } }
];

// 检测乱码
if (!/[\uFFFD]/.test(csvText)) {
  // 处理成功
}
```

#### Photoshop脚本调用
```javascript
// 调用Photoshop脚本
cs.evalScript('processExcelData(' + JSON.stringify(dataString) + ')', function (res) {
  statusDiv.textContent = res || '数据已处理完成';
});
```

## 🐛 故障排除

### 常见问题

#### 1. 扩展不显示
- 检查CEP扩展目录是否正确
- 确认manifest.xml配置
- 重启Photoshop

#### 2. CSV文件乱码
- 尝试保存为UTF-8格式
- 检查文件编码
- 使用Excel另存为CSV

#### 3. 图层同步失败
- 确认选中了有效图层
- 检查画板结构
- 查看错误提示

### 调试方法

1. **启用调试模式**
   ```javascript
   // 在main.js中添加
   console.log('调试信息:', data);
   ```

2. **查看错误日志**
   - 打开浏览器开发者工具
   - 查看Console面板
   - 检查Network请求

3. **测试单个功能**
   - 分别测试每个按钮
   - 检查文件格式
   - 验证数据格式

## 📝 更新日志

### v1.0.0
- ✅ 基础画板同步功能
- ✅ Excel/CSV数据导入
- ✅ 多编码支持
- ✅ 图层复制功能

## 🤝 贡献指南

1. Fork 项目
2. 创建功能分支
3. 提交更改
4. 发起 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 📞 支持

如有问题或建议，请：
- 提交 Issue
- 发送邮件
- 查看文档

---

**注意**：本扩展需要Adobe Photoshop CC 2015或更高版本才能正常运行。