> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 版本对比

> 在 Qoder 查看 superun 作品版本树，对比发布日志和逐文件代码差异，分析新增、修改与删除内容。

superun 版本对比帮助你了解两个版本之间改了什么：既看版本之间的关系和发布说明，也展示实际文件与代码差异。

## 安装

本文使用 Qoder 桌面端的操作入口。尚未安装客户端时，前往 [Qoder 官方下载页](https://qoder.com.cn/download)，选择桌面版；IDE、CLI 的安装界面与本文不同。

### 方式一：从 Qoder 扩展市场安装

1. 打开左侧 **扩展 → 技能**，搜索 `superun`，在结果中选择 **superun 版本对比**。
2. 若当前市场中有对应条目，打开详情，核对名称、发布者和能力说明后点击 **安装**。
3. 在 **已安装** 中确认 **superun 版本对比** 已添加。市场条目会受账号、组织及上架状态影响；找不到时使用下面的 ZIP 导入方式。

### 方式二：下载并导入 ZIP

[下载技能 ZIP](https://www.superun.com/web-api/packages/superun-version-diff/qoder/skill/download) · [查看当前版本](https://www.superun.com/web-api/packages/superun-version-diff/qoder/skill/latest)

1. 下载完整 ZIP，保留原文件，无需解压或重新压缩。
2. 在 **扩展 → 技能 → 添加技能 → 上传 Skill** 中选择刚下载的 ZIP。
3. 完成导入后，在 **已安装** 中确认 `superun-version-diff`；如有启用提示，按提示启用。

请导入完整 ZIP，单独上传 `SKILL.md` 会缺少本技能需要的脚本和引用资源。更新时重新下载；若同名导入提示冲突，先备份自行修改过的说明和资源，再在 **已安装** 中移除旧版并导入新版。不要通过重命名唯一标识另装一个副本。

安装入口说明可参考 [Qoder 官方技能文档](https://docs.qoder.cn/qoder/skills)。

## 首次运行

新建任务，在输入框输入 `/`，选择 **superun 版本对比** 对应的技能，再补充具体需求并发送。若菜单显示技术标识，则核对 `superun-version-diff`。

按提示准备 Node.js 22 或更高版本、npm 和 superun CLI 等运行环境，在系统浏览器登录自己的 superun 账号并完成授权，再返回原任务。Qoder 登录与 superun 授权分别完成；无需把密码或访问令牌贴到对话里。恢复登录或等待中断后，继续原任务，避免重复提交已启动的操作。

## 可以这样问

* 「使用 superun 版本对比，对比 CRM 管理系统最近两个版本改了什么。」
* 「查看销售管理系统最近两个版本新增和删除了哪些文件。」
* 「对比咖啡预约网站最近两次成功发布的日志，再看看选定代码版本的详细差异。」

## 对比过程

先确定一个作品，再查看版本树，明确旧、新两端。指定「最近两个版本」时，会沿当前版本的实际父链核对；存在分支时，结果会说明关系。

发布日志和代码版本分别选择。两者无法可靠关联时，会分别列出对比对象；缺少日志正文时，仅分析已有摘要并说明缺失。

## 交付内容

* 所选版本、时间及版本树中的关系。
* 发布说明的新增、移除和调整，或实际缺失原因。
* 文件新增、修改、删除清单及真实代码差异片段。
* 重点逻辑变化、影响和实际查看范围。

文件较多或代码片段较长时，可以继续翻页和展开。需要完整覆盖本次返回内容时，明确要求完整对比。

新侧可能包含当前账号的未提交暂存，结果会标注这一点。代码变化需要进一步验证，不能单凭差异认定测试通过或已经上线。该技能不修改、恢复或发布代码。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.