# ps

**Repository Path**: jdy2002/ps

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-24
- **Last Updated**: 2026-07-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 袖子对位 Photoshop UXP 插件

这是一个独立实现的 Photoshop UXP 面板，用于在衣身袖窿和袖山两条不同长度的缝线路径上生成对花标记。用户先在第一条路径上设定图案拼接位置，插件会计算该位置占第一条路径总弧长的比例，再在第二条路径的相同比例处生成对应标记。精确点位保存在 Photoshop 路径中，画布上则由独立锁定的标记显示层呈现，方便在标记保持固定时移动和变换图案。面板也保留了按标记自动定位当前图层的辅助功能。

## 兼容性

- Photoshop 2022 23.3 或更高版本
- Windows 和 macOS
- 需要使用 Photoshop 的 UXP Developer Tool 侧载未签名插件

## 安装

1. 安装 Adobe UXP Developer Tool。
2. 打开工具，选择 **Add Plugin**，选中本目录的 `manifest.json`。
3. 点击 **Load**，再回到 Photoshop 的 **窗口 > 扩展 (UXP)** 中打开 **袖子对位**。
4. 运行 `npm run package` 会生成 `dist/sleeve-match-uxp.zip`，压缩包解开后也可把其中的 `manifest.json` 添加到 UXP Developer Tool。

## 使用

1. 在 Photoshop 中用钢笔工具切换到 **路径** 模式，沿衣身袖窿需要对花的缝线画第一条开放路径；再沿袖山对应缝线画第二条开放路径。两条路径应该使用相同的起止语义；方向不一致时打开 **反转** 开关。
2. 在 **对位路径** 中选择两条路径。首次加载时两个 **反转** 开关都关闭；两条曲线可以不同长度，插件会按各自总弧长比例建立对应关系。
3. 显示需要参与拼接的红、青、蓝等图案，隐藏不需要识别的辅助内容，然后点击 **自动识别颜色交界点**。插件会读取当前可见合成效果，先排除抗锯齿和杂色，再沿第一条路径中心线精确定位透明与颜色、不同颜色之间的实际边界。路径起点和终点本身不会被误当成交界。
4. 不需要自动识别时，也可以保持默认 1 点，用 **第一条点距起点** 调整位置，或点击 **读取选中图案中心**。
5. 点击 **生成两条路径对花标记**。插件会生成精确路径 `袖子对位-匹配标记`，同时创建并锁定 `袖子对位-标记显示` 图层。第二条路径的点位按第一条路径的弧长比例自动换算。
6. 生成后插件会取消精确路径的活动状态、恢复原先选中的图案图层并切换到移动工具。此时可按十字标记移动图案，也可使用 `Ctrl+T`（macOS 为 `Command+T`）自由变换大小和角度，锁定的显示层不会随图案变化。导出图片或印刷文件前，在图层面板隐藏 `袖子对位-标记显示`。

面向 Photoshop 初学者的逐步教程见 [docs/使用教程.md](docs/使用教程.md)。

## 图片教程

- [第 1 页：准备并选择两条开放路径](docs/image-tutorial/sleeve-positioning-tutorial-1.png)
- [第 2 页：自动识别第一条路径上的颜色交界](docs/image-tutorial/sleeve-positioning-tutorial-2.png)
- [第 3 页：理解不同长度曲线的比例对应](docs/image-tutorial/sleeve-positioning-tutorial-3.png)
- [第 4 页：生成对花标记并按标记作图](docs/image-tutorial/sleeve-positioning-tutorial-4.png)

## 设计边界

标记生成只负责计算两条路径上的对应位置，不会自动判断图案应该如何变形、裁片或印刷。可选的图层定位动作是刚性相似变换（平移、旋转、可选等比缩放），适合快速把图案移到某一对标记附近；需要网格变形、透视变形、图层蒙版裁片或三维试衣时，应继续使用 Photoshop 的变形、智能对象或蒙版工具。路径面板中若一个路径包含多个开放子路径，插件会使用其中锚点跨度最长的一条。

## 开发检查

```text
npm test       # 运行纯几何和 Photoshop 描述符测试
npm run check  # 语法检查 + 测试
npm run package
```