YSS Issue Helper（技规前端）

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 最新内容重新分析。

确认并提交初审结论

每轮 AI 结论底部提供操作按钮：

提交到评论：确认当前报告，并以当前登录用户的身份在 GitLab Issue 下新增一条评论。评论正文末尾会附带一个隐藏标记（HTML 注释），用于识别该评论由 AI 初审结论生成，GitLab 页面上不会显示。
更新评论：已提交过评论后，继续对话得到新的结论时，按钮会变为更新样式。确认后会更新之前提交的同一条评论，而不会重复新增。
已提交的报告会显示为完成状态，避免重复操作。

提交过初审结论评论的 Issue，在 AI 初审列表中的按钮会变为 查看初审结论。点击后以时间轴形式展示该 Issue 下的全部用户评论，其中通过 AI 初审结论提交的评论会被高亮标记，并可通过 ✦ 继续 AI 对话 发起新一轮分析（新结论同样可确认并更新已有评论）。

若对话中存在 AI 最新返回且尚未确认提交的初审报告，离开对话窗口（返回列表或切换页面）时会弹出提醒，确认后才会丢弃该临时对话。

配置 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 配置为准。

YSS Issue Helper(技规前端)

cywcd