YSS Issue Helper 是一款面向前端团队的 VS Code 扩展，用于在编辑器内连接企业 GitLab，规范创建、查看和维护 Issue。
主要功能
- 支持个人访问令牌和 OAuth 浏览器授权两种 GitLab 连接方式。
- 通过引导式表单填写 Issue 信息，并选择已配置的目标项目。
- 支持保存和自动恢复 Issue 草稿，创建失败时自动保留已填写内容。
- 支持粘贴剪贴板截图或选择本地图片，自动生成 GitLab Markdown。
- 提交前可预览完整的 GitLab Issue 内容。
- 集中查看当前用户创建的 Issue，支持状态筛选、搜索和刷新。
- 在 VS Code 内查看 Issue 正文及活动记录，并可跳转到 GitLab 网页。
- 支持复制 Issue 链接，以及修改支持编辑的 Issue 标题和正文。
- 支持配置并启用多个 AI 模型服务商，统一管理 API 地址、API 密钥、自定义请求头和模型列表。
- 支持对开放中的 Issue 发起 AI 初审，分析问题根因并给出推荐解决方案。
快速开始
- 安装扩展后，点击 VS Code 活动栏中的 YSS Issue Helper（技规前端） 图标。
- 选择一种连接方式：
- OAuth 连接：点击“打开浏览器授权”，在企业 GitLab 页面完成授权后返回 VS Code。
- Token 连接：创建具有
api权限的个人访问令牌并粘贴到输入框中。
- 连接成功后进入 Issue 工作台：
- 在 新建 Issue 中填写、预览并提交 Issue。
- 在 我的 Issue 中查看、搜索和维护已创建的 Issue。
- 在 AI 初审 中查看当前配置项目内由自己创建或指派给自己的开放 Issue，并发起初步分析。
AI 初审
AI 初审会实时读取所选 Issue 的最新标题和正文，将问题信息发送给当前选择的大模型，并生成包含以下内容的初审报告：
- Issue 概要
- Issue 分析
- 问题定位原因
- 推荐解决方案
初审报告仅在当前临时会话中展示，不会保存到 Issue 或插件本地。报告内容由大模型根据 Issue 已提供的信息生成，仅供问题排查和解决方案评估时参考。
配置 AI 模型服务
首次使用前，在 AI 初审 页面点击 配置；尚未配置可用模型时，也可以点击 去配置 AI 模型服务商。在模型服务页面完成以下配置：
- 添加服务商并选择对应的服务商类型。
- 填写 API 地址和 API 密钥；如服务需要，还可以配置自定义请求头。
- 手动添加模型，或从服务商接口获取模型列表后选择添加。
- 保存配置并启用服务商。首次启用时需要选择一个模型进行连通性检测，检测成功后才会启用。
插件支持 OpenAI 兼容接口、OpenAI Responses、Gemini、Anthropic、Azure OpenAI、New API、CherryIN 和 Ollama 等服务商类型。API 地址会根据服务商类型自动补充常用请求路径；如果服务地址不需要自动附加版本路径，可在地址末尾添加 #。
配置好至少一个已启用服务商及模型后，返回 AI 初审 页面，在分组下拉列表中选择模型即可发起初审。插件会记住最后一次选择的模型，下次进入时自动选中；已停用或删除的服务商模型不会出现在可选列表中。
发起 AI 初审
- 打开 AI 初审，必要时通过标题或 Issue 编号过滤列表。
- 在开放中的 Issue 列表中找到目标 Issue，点击 发起 AI 初审。
- 等待模型完成分析后查看报告；可返回列表，对其他 Issue 发起初审。
AI 初审列表独立于 我的 Issue：其中会汇总当前配置的所有目标项目内，由当前用户创建或指派给当前用户的开放 Issue；我的 Issue 仍只展示当前用户创建的 Issue。
自定义目标项目
插件默认使用内置的目标项目列表。如需替换，可以在 VS Code 的 settings.json 中配置：
{
"yssIssueHelper.useCustomGitLabIssueConfig": true,
"yssIssueHelper.gitLabIssueConfig": [
{
"projectPath": "group/subgroup/project",
"projectName": "项目显示名称"
}
]
}
projectPath 填写 GitLab 项目的完整路径，不包含 GitLab 域名。关闭自定义配置开关后，插件会恢复使用内置项目列表。
使用提示
- OAuth 授权页面未打开或被关闭时，可以重新打开授权页面，也可以取消本次授权。
- 新建 Issue 时可随时保存草稿；创建成功后，对应草稿会自动清除。
- 截图可以直接粘贴到附件区域，扩展会将其上传并插入 Issue 内容。
- 可通过页面中的断开连接操作安全退出当前 GitLab 账号。
- 个人访问令牌等敏感连接信息由 VS Code 安全存储，不会写入项目文件。
- AI 服务商的 API 密钥使用 VS Code 安全存储；其他模型配置保存在扩展本地，不会写入项目文件。
- 发起 AI 初审会将所选 Issue 的标题和正文发送给当前选择的模型服务商，请按照团队的数据安全规范选择服务商和待分析内容。
适用范围
本扩展用于已配置的企业 GitLab 实例和目标项目。可用项目、权限及访问范围以团队 GitLab 配置为准。