> ## 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-project-query/qoder/skill/download) · [查看当前版本](https://www.superun.com/web-api/packages/superun-project-query/qoder/skill/latest)

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

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

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

## 首次运行

新建任务，在输入框输入 `/`，选择 **superun 项目查询** 对应的技能，再补充具体需求并发送。若菜单显示技术标识，则核对 `superun-project-query`。

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

## 可以这样问

* 「使用 superun 项目查询，帮我查一下最近创建的项目。」
* 「找一下 CRM 管理系统，查询当前进度和已有预览。」
* 「查看这个项目的主线历史版本，先给我第一页。」

## 查询过程与结果

列出项目时，可以指定「我创建的」「团队项目」「分享给我的」或「全部可访问项目」。结果会说明查询范围、项目名称、编号、更新时间及可识别的会话状态；需要更多结果时可以继续翻页。

查看详情和历史时，先明确一个目标。提供项目链接或编号可直接核对；只有名称或存在重名时，从候选中选择一个。

已有预览按设计候选、演示和研发分别展示，多端预览保留各端入口。未返回的链接会说明缺失；会话结束也不代表研发完成或已经上线。

该技能只查询项目，不创建、修改或恢复版本。查询正式上线地址时，请到 superun 网页发布页面查看，或使用[应用发布技能](https://docs.superun.com/superun/third-party-apps/qoder/skills/app-publish.md)查询已有发布结果。


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