UIP 解决方案项目

uip solution project管理.uipx解决方案清单中列出的项目，包括工作流、测试用例、库、智能体、Maestro 流和应用程序。提供三个可用子命令：

子命令	用途
add	注册一个已位于解决方案目录中的项目文件夹。
import	将外部项目文件夹复制到解决方案目录中，然后注册。
remove	从.uipx中取消注册项目（不会删除磁盘上的文件）。

所有三个子命令均仅作用于本地文件；无需身份验证。

大纲

uip solution project add <projectPath> [solutionFile]
uip solution project import --source <path> [--solutionFile <path>]
uip solution project remove <projectPath> [solutionFile]

每个子命令都遵循全局选项，并返回标准退出代码。

常见行为

• 目标项目文件夹必须包含project.uiproj或旧版project.json描述符。该命令会自动检测对应的角色。
• 当省略<solutionFile>时，该命令从项目路径（若是import ，则在当前目录）向上搜索最近的.uipx 。如果找不到此类文件，或者同一个文件夹中存在多个.uipx文件，则该命令将失败并显示描述性错误，并以1退出。
• 系统会为添加到清单文件的每个项目条目生成唯一的Id (UUID)。

---

UIP 解决方案项目添加

注册已驻留在解决方案目录中的项目文件夹。项目文件夹的相对路径记录在.uipx中，且系统会在解决方案的内部资源构建器中配置匹配的条目。

参数

• <projectPath> （必填） — 项目文件夹的路径。必须包含project.uiproj或project.json 。
• [solutionFile] （可选） — .uipx解决方案清单文件的路径。如果省略，则通过从<projectPath>向上遍历来找到最近的.uipx 。

选项

除全局选项外无此选项。

示例

最小

uip solution project add ./my-solution/my-project ./my-solution/my-solution.uipx

Auto-detect the .uipx

uip solution project add ./my-solution/my-project

脚本编写 — 添加，然后打包在一个管道中

uip solution project add ./my-solution/my-project
uip solution pack ./my-solution ./dist --version 1.0.0

数据形状（--输出 json）

{
  "Code": "ProjectAdd",
  "Data": {
    "Status": "Added successfully",
    "Project": "my-project/project.uiproj",
    "Solution": "/workspace/my-solution/my-solution.uipx"
  }
}

故障模式

• 项目位于解决方案文件夹之外。该命令使用指向project import的指针拒绝添加，这会复制外部项目。
• 项目已注册。退出1和一条消息，命名现有ProjectRelativePath 。

---

UIP 解决方案项目导入

将外部项目文件夹复制到解决方案目录中（保留其文件夹名称），然后在.uipx中将其注册。当要包含的项目尚未在解决方案根目录下时，请使用此选项。

选项

• --source <path> （必填） — 要导入的外部项目文件夹的路径。必须是包含project.uiproj或project.json目录。
• --solutionFile <path> （可选） — .uipx解决方案清单文件的路径。默认为从当前工作目录向上找到的最接近的.uipx 。

示例

常见

uip solution project import \
  --source ./external-project \
  --solutionFile ./my-solution/my-solution.uipx

From inside the solution directory (auto-detect .uipx)

cd ./my-solution
uip solution project import --source ../shared-library

数据形状（--输出 json）

{
  "Code": "ProjectImport",
  "Data": {
    "Status": "Imported successfully",
    "Project": "external-project/project.uiproj",
    "Solution": "/workspace/my-solution/my-solution.uipx"
  }
}

故障模式和回滚

• 目标文件夹已存在。命令拒绝覆盖；请先重命名源文件夹或删除现有目标。
• 项目已在.uipx清单中存储。在复制任何文件之前拒绝。
• 复制、写入或构建器步骤失败。命令回滚 — 复制的目录将被删除，并且.uipx将还原为其原始内容。

---

UIP 解决方案项目删除

从.uipx解决方案清单文件中取消注册项目，并从内部资源生成器中删除其条目。不会删除磁盘上的文件。

参数

• <projectPath> （必填） — 要删除的项目文件夹的路径。当前必须在.uipx中注册。
• [solutionFile] （可选） — .uipx解决方案清单文件的路径。默认为从<projectPath>向上遍历找到的最近的.uipx 。

示例

最小

uip solution project remove ./my-solution/my-project ./my-solution/my-solution.uipx

Scripting — 删除多个项目

for p in project-a project-b project-c; do
  uip solution project remove "./my-solution/$p" || true
done

数据形状（--输出 json）

{
  "Code": "ProjectRemove",
  "Data": {
    "Status": "Removed successfully",
    "Project": "my-project",
    "Solution": "/workspace/my-solution/my-solution.uipx"
  }
}

故障模式

• 项目位于解决方案文件夹之外。相对路径不得以..开头。
• 项目不在清单中。以1退出并将相对路径用于搜索。

---

相关命令

• uip solution new — 在添加项目之前构建解决方案。
• uip solution resource refresh — 编辑项目绑定后重新同步资源。
• uip solution pack — 在项目列表最终确定后打包解决方案。

另请参阅

• 您的第一个管道— 端到端示例。
• uip solution概述。