Skip to content

Commit a26aa5e

Browse files
xuanheScriptclaude
andcommitted
feat: 完成插件发布准备
- 完善ZXP打包流程和脚本 - 创建详细的安装说明文档 - 添加发布清单和工作流程 - 优化简化包构建流程 - 生成v1.5.0发布包 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 1e82a02 commit a26aa5e

File tree

12 files changed

+3863
-557
lines changed

12 files changed

+3863
-557
lines changed

.claude/settings.local.json

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
{
2+
"permissions": {
3+
"allow": [
4+
"Bash(mkdir:*)",
5+
"Bash(mv:*)",
6+
"Bash(npm run create-zxp:*)",
7+
"Bash(npx zxp-sign-cmd:*)",
8+
"Bash(./node_modules/.bin/zxp-sign-cmd:*)",
9+
"Bash(ls:*)",
10+
"Bash(node:*)",
11+
"Bash(npm run release:*)",
12+
"Bash(git add:*)"
13+
],
14+
"deny": []
15+
}
16+
}

INSTALLATION.md

Lines changed: 176 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,176 @@
1+
# Illustrator 标注插件 - 安装说明
2+
3+
> **Adobe Illustrator 材质标注插件**,支持多材质选择、单位管理和标注导出功能
4+
5+
## 🎯 系统要求
6+
7+
- **Adobe Illustrator**: 2021, 2022, 2023, 2024 版本
8+
- **操作系统**: Windows 10+ 或 macOS 10.14+
9+
- **CEP版本**: 10.0 (向上兼容)
10+
11+
## 📦 安装方法
12+
13+
### 方法一:ZXP文件安装 (推荐)
14+
15+
#### 步骤 1: 下载安装工具
16+
17+
选择以下任一工具:
18+
19+
**🔹 Anastasiy's Extension Manager (推荐)**
20+
- 下载地址: https://install.anastasiy.com/
21+
- 支持: Windows & macOS
22+
- 特点: 界面友好,功能完整
23+
24+
**🔹 ZXPInstaller**
25+
- 下载地址: https://aescripts.com/learn/zxp-installer/
26+
- 支持: Windows & macOS
27+
- 特点: 轻量级,简单易用
28+
29+
#### 步骤 2: 安装插件
30+
31+
1. 下载插件的 `.zxp` 文件
32+
2. 打开您选择的安装工具
33+
3.`.zxp` 文件拖拽到工具窗口中
34+
4. 点击安装按钮
35+
5. 等待安装完成
36+
37+
### 方法二:手动安装
38+
39+
#### Windows 系统
40+
41+
1. **定位扩展目录**:
42+
```
43+
C:\Users\[用户名]\AppData\Roaming\Adobe\CEP\extensions\
44+
```
45+
46+
2. **创建插件文件夹**:
47+
```
48+
C:\Users\[用户名]\AppData\Roaming\Adobe\CEP\extensions\illustrator-annotation-plugin\
49+
```
50+
51+
3. **复制插件文件**:
52+
- 将所有插件文件复制到上述文件夹中
53+
54+
4. **启用调试模式** (必需):
55+
-`Win + R`,输入 `regedit`
56+
- 导航到: `HKEY_CURRENT_USER\Software\Adobe\CSXS.10`
57+
- 创建字符串值: `PlayerDebugMode` = `1`
58+
59+
#### macOS 系统
60+
61+
1. **定位扩展目录**:
62+
```
63+
~/Library/Application Support/Adobe/CEP/extensions/
64+
```
65+
66+
2. **创建插件文件夹**:
67+
```
68+
~/Library/Application Support/Adobe/CEP/extensions/illustrator-annotation-plugin/
69+
```
70+
71+
3. **复制插件文件**:
72+
- 将所有插件文件复制到上述文件夹中
73+
74+
4. **启用调试模式** (必需):
75+
```bash
76+
defaults write com.adobe.CSXS.10 PlayerDebugMode 1
77+
```
78+
79+
## 🚀 使用插件
80+
81+
### 启动插件
82+
83+
1. **打开 Adobe Illustrator**
84+
2. **访问菜单**: 窗口 > 扩展功能 > Illustrator Quote (CEP 10)
85+
3. **插件面板**: 将在屏幕右侧显示
86+
87+
### 基本操作流程
88+
89+
1. **管理材质**:
90+
- 点击"管理材质"按钮
91+
- 添加/编辑材质及其默认单位
92+
93+
2. **应用标注**:
94+
- 在AI中选择要标注的对象
95+
- 选择一个或多个材质
96+
- 为每个材质设置数值(可选)
97+
- 点击"应用材质"按钮
98+
99+
3. **导出数据**:
100+
- 完成标注后点击"导出标注"
101+
- CSV文件将保存到桌面
102+
103+
## 🔧 故障排除
104+
105+
### 插件未显示
106+
107+
**症状**: 在扩展功能菜单中找不到插件
108+
109+
**解决方案**:
110+
1. 检查AI版本是否支持 (2021-2024)
111+
2. 确认调试模式已启用
112+
3. 重启 Illustrator
113+
4. 检查插件文件是否正确安装
114+
115+
### 调试模式设置
116+
117+
**Windows**:
118+
```cmd
119+
reg add "HKEY_CURRENT_USER\Software\Adobe\CSXS.10" /v PlayerDebugMode /t REG_SZ /d 1 /f
120+
```
121+
122+
**macOS**:
123+
```bash
124+
defaults write com.adobe.CSXS.10 PlayerDebugMode 1
125+
```
126+
127+
### 插件功能异常
128+
129+
1. **检查控制台**:
130+
- 右键点击插件面板 > 检查
131+
- 查看控制台错误信息
132+
133+
2. **重新安装**:
134+
- 删除插件文件夹
135+
- 重新安装插件
136+
137+
3. **清除偏好设置**:
138+
- 重置 Illustrator 偏好设置
139+
140+
## 📋 功能特性
141+
142+
### ✨ 主要功能
143+
144+
- **多材质选择**: 同时选择多个材质进行标注
145+
- **单位管理**: 为每个材质设置默认单位 (cm, mm, m², 个等)
146+
- **智能标注**: 自动计算对象尺寸和面积
147+
- **数据导出**: 导出包含材质信息、尺寸和面积的CSV文件
148+
- **可视化标注**: 在AI中创建标注线和文本说明
149+
150+
### 📊 导出格式
151+
152+
生成的CSV文件包含以下信息:
153+
- 图层名称
154+
- 材质信息 (格式: "数值 单位 材质名")
155+
- 宽度 (mm)
156+
- 高度 (mm)
157+
- 面积 (m²)
158+
159+
## 📞 技术支持
160+
161+
### 开发信息
162+
- **版本**: 1.5.0
163+
- **CEP版本**: 10.0
164+
- **兼容性**: Illustrator 2021-2024
165+
166+
### 反馈渠道
167+
- **GitHub Issues**: 报告问题和建议
168+
- **文档**: 查看最新使用说明
169+
170+
## 📄 许可证
171+
172+
MIT License - 详见 LICENSE 文件
173+
174+
---
175+
176+
*最后更新: 2025年1月*

0 commit comments

Comments
 (0)