此功能处于 公开预览 阶段，并且可能会发生变化。
问题工件是附加到问题的已命名内容片段。 它们提供了一个持久的地方，用于保留作为与你的工作并列的上下文的计划、研究、决策、原型和参考材料。
你可以通过 URL 与他人共享工件，如果你更新工件，GitHub 将保留更改记录，以便你可以回过头查看工件在项目过程中是如何演变的。
支持的工件类型
Issue 工件支持以下类型：
- Markdown 文档 （
generic）：常规用途内容，如研究、调查说明或设计文档。 - 计划（
plan）：Markdown 实施方案。 - 链接 （
link）：指向其他地方的内容的命名链接，例如讨论、原型或 Slack 或 Teams 线程。 - HTML 文件 （
embedded_html）：独立 HTML 文档，例如交互式原型、可视化效果、流程图或图表。
创建构件
可以在 GitHub.com 上创建工件，或者要求代理或开发人员工具使用内置的 GitHub MCP 服务器、GitHub CLI 或问题工件 REST API 创建一个工件。 例如，可以要求 Copilot app 创建实施计划、根本原因分析或研究摘要，并将其附加到该问题中。
在 上创建工件
- 导航到要在其中创建工件的问题。
- 在 “Artifacts” 部分中，单击 。
- 选择构件类型：
- 若要添加具名 URL，请单击 添加链接。
- 若要创建 Markdown 文档，请单击“创建工件”。
- 若要创建 HTML 文档，请单击“创建 HTML 构件”。
- 按照提示命名并创建制品。
查看和共享构件
- 导航到包含构件的问题。
- 在 “制品” 部分中，单击制品名称。
- 工件将在问题的侧面板中打开并显示。
- 若要复制 URL 以与他人共享构件，请单击 。
编辑工件
- 打开构件。
- 在构件面板中，单击 。
- 更新工件名称或内容。
- 保存所做的更改。
编辑工件会在其历史记录中创建版本。
查看构件的版本历史记录
- 打开构件。
- 在工件面板中，单击 。
- 选择一个版本以查看其名称、内容、作者和创建时间。
无法在 Web 界面中还原版本。 若要还原早期版本，请使用 gh issue artifact edit --restore-version。 还原会将之前的名称和内容保存为新版本，从而保留完整的历史记录。
重新排序构件
可以通过在 “构件” 部分内拖动构件对构件重新排序。 还可以单击工件旁边的，单击“移动”，然后选择一个位置。
删除构件
警告
删除构件是永久性的，还会删除其版本历史记录。
- 在问题的 “工件”部分中，单击工件旁边的 。
- 单击 “删除” 。
安全地预览 HTML 工件
在 GitHub.com 上，HTML 工件在 源 视图中打开，以便你可以在运行它之前检查代码。 若要呈现 HTML，请选择 “预览”。 GitHub 在受限沙盒中呈现预览。 该界面警告，预览会运行用户提供的代码，这些代码可能会将其内容发送到外部站点。 查看源，仅预览你信任的源中的 HTML。 若要返回到源文件，请选择“源文件”。
将工件与代理配合使用
使用 Copilot app 处理问题时，会话期间创建的工件会自动附加到该问题。 还可以要求 Copilot 创建特定成果物，例如实施计划、根本原因分析或历史上下文摘要。
代理和开发人员工具还可以使用内置的 GitHub MCP 服务器、REST API 或 GitHub CLI 读取和管理工件。
使用 GitHub CLI 管理制品
Issue artifact 命令需要 GitHub CLI 2.103.0 或更高版本。
有关问题工件命令的详细信息，请参阅 gh issue artifact 参考。
延伸阅读
- REST API 文档中的问题工件的 REST API 终结点
- 关于问题