一、五分钟了解"资产"
资产是什么？
一句话概括：资产模块是你和团队在麦芽 AI 中所有工作成果的"仓库"——你画的原型、写的代码、设计的用例、配置的数据库、撰写的文档，都在这里集中管理，随时查找、复用和迭代。
点击左侧菜单栏的 "资产"，展开后即可看到五类资产的入口：产品、工程、用例、数据库、文档。点击任意一项即可进入对应页面。
二、产品资产
2.1 进入产品页面
点击左侧菜单 "资产" → "产品"，进入产品管理页面。
2.2 浏览产品
产品页面以卡片形式展示所有产品，每个卡片显示产品名称和最近更新时间，帮助你快速了解团队的产品资产状况。
我的产品 —— 仅展示自己创建的：
全部产品 —— 展示团队所有产品：
2.3 搜索产品
在搜索框中输入产品名称或产品代码，系统会实时过滤匹配结果，帮助你快速定位目标产品。
2.4 创建新产品
点击右上角 "新增产品" 按钮，系统会跳转到画原型页面，你可以开始设计产品原型。
2.5 产品详情页
点击任一产品卡片进入详情页，你可以：
- 查看产品名称、当前迭代版本和页面列表。
- 使用内置的 麦芽 AI 助手，基于已关联的原型、文档、数据库等资源进行需求分析、原型设计和代码开发。
- 继续编辑原型页面，或补充各类资源，支持持续迭代。
2.6 素材库
素材库统一管理图片、音频、视频等素材，支撑 AI 原型生成和内容创作场景。
上传规则：
- 支持批量或单个上传
- 支持格式：JPG / PNG / GIF / MP3 / WAV / MP4 / AVI
- 单个文件不超过 500MB
- 可自定义素材名称和标签，上传后可在原型设计、内容生成等环节直接调用
⚠️ 注意：素材库仅供开发和测试使用，禁止用于正式生产环境。
三、工程资产
3.1 进入工程页面
点击左侧菜单 "资产" → "工程"，进入工程管理页面。
3.2 浏览工程列表
工程以卡片形式展示，每个卡片包含：
- 工程名称（如 business-function-module）
- 中文名称（如"通用业务功能模块"）
- 分支列表：展示该工程下的全部分支（如 main、self_test 等）
3.3 搜索与筛选
页面顶部搜索框支持按工程名称、中文名、分支名进行关键词搜索。同时支持按分组筛选，便于分类查看。
3.4 添加工程分支
点击 "添加工程分支" 按钮，有两种添加方式：
方式一：从 Git 添加
- 输入 Git 仓库地址，点击"获取分支"，系统自动识别版本控制系统类型并拉取分支列表
- 从分支列表中选择目标分支
- 填写系统项目名称及中文名称
- 点击"确定"完成添加，系统自动拉取代码
方式二：手动添加
- 选择 Git 仓库及所属群组
- 填写工程名称、分支名称及工程别名
- 点击"确定"完成添加
3.5 工程详情页
点击任一工程卡片进入详情页，页面分左右两区：
- 左侧：麦芽 AI 助手对话区，可基于已关联的产品原型、文档、数据库等资源发起代码生成、代码开发和 Bug 修复等任务。
- 右侧：代码文件查看区，支持选择并查看代码文件，代码文件支持手动在线编辑。
四、用例资产
4.1 进入用例页面
点击左侧菜单 "资产" → "用例"，进入用例管理页面。
4.2 浏览用例
用例页面展示用例总数及最近更新时间，以卡片形式展示所有用例集。每个卡片包含：
- 用例集名称（如"通用管理后台仪表盘""用户注册系统"等）
- 用例集描述：用例数量或简要说明
- 多版本展示：同一用例集的多个版本按顺序排列
我的用例 —— 仅展示自己创建的：
全部用例 —— 展示团队所有用例：
4.3 搜索用例
在搜索框中输入产品名称关键词，系统会实时过滤当前视图列表中的匹配结果。
4.4 用例详情页
点击任一用例卡片进入详情页：
- AI 助手区域：内置麦芽 AI 助手，支持基于已关联资源协助生成代码、分析代码和生成测试用例。
- 测试模块列表：展示该用例集下的所有测试模块，每个模块显示用例执行进度。
- 用例明细：展示每条用例的标题、ID 编号、操作人、操作类型和执行状态。
4.5 用例执行列表
展示所有历史执行记录，支持按执行名称、执行状态进行搜索。
点击任一执行记录可查看该次执行的详细用例列表及执行结果。
4.6 用例执行详情页
点击执行列表中的任一记录，进入执行详情页：
- 顶部展示执行计划信息（执行计划 ID、执行时间范围）
- 用例列表展示该计划下所有用例，支持按状态、优先级、模块筛选
- 每条用例展示：用例编号、标题、所属模块、版本号、优先级，支持"查看"和"执行"操作
4.7 缺陷管理
展示团队所有缺陷数据，支持多维筛选与搜索：
- 统计概览：全部缺陷数、已解决数、已关闭数
- 筛选条件：缺陷状态、严重程度、日期范围、解决方案、关键词搜索
- 操作按钮：支持"关闭""解决""重新执行"等操作
4.8 手动创建 Bug
点击 "手动创建Bug" 按钮，弹出创建表单，需填写以下信息：
- 所属项目：选择缺陷所属项目
- Bug 标题：输入缺陷标题
- 优先级：选择 P0 / P1 / P2 / P3 / P4
- Bug 类型：选择功能 / 性能 / 界面等类型
- 关联用例：选择关联的测试用例
- Bug 描述：详细描述缺陷情况
- 期望行为：描述期望的正确行为
- 错误截图：上传截图（PNG、JPG、GDT 格式，单张不超过 5MB，最多 10 张）
- 执行环境：选择执行环境（如 sit）
填写完毕后点击"创建bug"完成提交。
4.9 执行历史
在缺陷详情页点击 "执行历史"，进入该缺陷关联的用例执行历史页面：
- 左侧：执行计划列表（计划名称、计划 ID、执行人、用例总数、执行进度百分比）。点击任一计划，右侧同步刷新。
- 右侧：选中计划的用例执行概览与列表，顶部展示通过率、执行中、通过、失败等统计指标。
4.10 项目测试统计分析
按项目维度进行测试数据统计和趋势分析：
项目概览：顶部展示项目名称及环境切换（sit、dev 等），支持按项目维度筛选。
核心指标表格：以表格形式展示各项目的用例数量、通过率、执行次数、平均执行时间、未执行用例、总缺陷数、待修复缺陷及缺陷率。
缺陷分布图表：按优先级和严重程度维度展示缺陷分布，便于识别质量风险。
模块测试统计：按模块维度展示测试数据，包含模块名称、用例数、通过率、执行次数、平均执行时间、未执行用例、总缺陷数、待修复缺陷及缺陷率。
五、数据库资产
5.1 进入数据库页面
点击左侧菜单 "资产" → "数据库"，进入数据库管理页面。
5.2 数据库列表与搜索
数据库以卡片形式展示所有已添加的连接，每个卡片包含：
- 数据库名称、数据库类型
- 连接 ID、主机地址、端口
- 用户名、创建时间
搜索框支持按数据库名称或主机地址进行关键词搜索。
5.3 新增数据库连接
点击 "新增数据库连接" 按钮，弹出配置表单：
- 填写连接名称
- 选择数据库类型（MySQL / PostgreSQL / Oracle 等）
- 输入主机地址、端口、用户名及密码
- 点击 "测试连接" 验证配置是否正确
- 验证通过后点击 "保存" 完成添加
六、文档资产
6.1 进入文档页面
点击左侧菜单 "资产" → "文档"，进入文档管理页面。
6.2 文档列表与筛选
- 文档组筛选：支持按"全部文档""我的文档"等分组筛选
- 关键词搜索：按文档名称快速检索
- 文档列表：展示文档名称、所有者、修改时间，每条文档支持"查看""下载""复制"操作
6.3 上传文档
点击 "上传" 按钮，支持两种方式：
方式一：本地上传
拖拽或点击上传本地文件，支持 DOCX、XLSX、MD 格式。填写文档名称、选择所属文档组、添加备注后完成上传。
📌 格式提示：doc 和 pdf 文件需转换为 docx 后上传；xlsx 将按 sheet 切割存储。
方式二：飞书在线文档
填写文档名称、选择所属文档组、输入飞书文档链接（支持 feishu.cn、larksuite.com 等域名），添加备注后保存。
📌 飞书文档须知：公共飞书文档支持直接获取；公司内部文档需先完成本地化部署及授权配置。
6.4 文档模板库
模板库管理团队文档模板，支持按分类筛选和按模板名称搜索。
上传模板：点击"上传模板"可上传本地模板文件（支持 .docx、.md 格式），选择模板分类后确认上传。
AI 创建模板：点击"AI创建模板"可跳转到麦芽 AI 首页，由 AI 辅助生成文档模板。
七、常见问题
Q1: 我创建的产品为什么在"我的产品"里看不到？
A: 请检查是否选中了"我的产品"视图标签。如果选中的是"全部产品"，你可以在列表中看到自己的产品，但可能淹没在团队其他产品中。切换到"我的产品"即可只看到自己创建的。
Q2: 从 Git 添加工程分支时提示获取失败怎么办？
A: 请依次检查：① Git 仓库地址是否正确；② 是否有该仓库的访问权限；③ 网络连接是否正常。如仍无法解决，可尝试"手动添加"方式。
Q3: 上传文档支持哪些格式？PDF 可以吗？
A: 直接上传支持 DOCX、XLSX、MD 格式。PDF 和 doc 文件需要先转换为 docx 格式后再上传。xlsx 文件上传后会按 sheet 切割存储。
Q4: 素材库的图片可以在哪些地方使用？
A: 素材库中的图片和视频主要用于原型设计和内容生成场景。在画原型过程中，可以直接从素材库选择已上传的素材。
Q5: 数据库连接测试通过了但保存失败？
A: 请检查连接名称是否与已有连接重复，以及是否填写了所有必填字段（连接名称、数据库类型、主机地址、端口、用户名、密码）。