devops-mcp-server-extension 1.0.0

package/dist/operations/codeup/changeRequests.js

@@ -0,0 +1,230 @@
+import { yunxiaoRequest, buildUrl, handleRepositoryIdEncoding, floatToIntString, isRegionEdition } from "../../common/utils.js";
+import { resolveOrganizationId } from "../organization/organization.js";
+import { ChangeRequestSchema, PatchSetSchema } from "./types.js";
+// 通过API获取仓库的数字ID
+async function getRepositoryNumericId(organizationId, repositoryId) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${repositoryId}`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${repositoryId}`;
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    if (!response || typeof response !== 'object' || !('id' in response)) {
+        throw new Error("Failed to get repository ID");
+    }
+    const repoId = response.id;
+    if (!repoId) {
+        throw new Error("Could not get repository ID");
+    }
+    return repoId.toString();
+}
+/**
+ * 查询合并请求详情
+ *
+ * @param organizationId 组织ID，示例：'60d54f3daccf2bbd6659f3ad'
+ * @param repositoryId 代码库ID或路径，示例：'2835387' 或 '60de7a6852743a5162b5f957%2FDemoRepo'
+ * @param localId 合并请求局部ID，示例：'1'
+ */
+export async function getChangeRequestFunc(organizationId, repositoryId, localId) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const encodedRepoId = handleRepositoryIdEncoding(repositoryId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${encodedRepoId}/changeRequests/${localId}`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${encodedRepoId}/changeRequests/${localId}`;
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    return ChangeRequestSchema.parse(response);
+}
+/**
+ * 查询合并请求列表
+ * 支持多条件筛选、分页以及排序
+ *
+ * @param organizationId 组织ID，示例：'60d54f3daccf2bbd6659f3ad'
+ * @param page 页码，从1开始，默认1
+ * @param perPage 每页大小，默认20
+ * @param projectIds 代码库ID或路径列表，多个以逗号分隔，示例：'2813489,2813490'
+ * @param authorIds 创建者用户ID列表，多个以逗号分隔，示例：'62c795xxxb468af8'
+ * @param reviewerIds 评审人用户ID列表，多个以逗号分隔，示例：'62c795xxxb468af8'
+ * @param state 合并请求筛选状态：'opened' - 已开启；'merged' - 已合并；'closed' - 已关闭。默认为null，即查询全部状态
+ * @param search 标题关键字搜索，示例：'mr title'
+ * @param orderBy 排序字段：'created_at' - 创建时间；'updated_at' - 更新时间（默认）
+ * @param sort 排序方式：'asc' - 升序；'desc' - 降序（默认）
+ * @param createdBefore 起始创建时间，ISO 8601格式，示例：'2024-04-05T15:30:45Z'
+ * @param createdAfter 截止创建时间，ISO 8601格式，示例：'2024-04-05T15:30:45Z'
+ */
+export async function listChangeRequestsFunc(organizationId, page, perPage, projectIds, authorIds, reviewerIds, state, // Possible values: opened, merged, closed
+search, orderBy, // Possible values: created_at, updated_at
+sort, // Possible values: asc, desc
+createdBefore, createdAfter) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const baseUrl = isRegionEdition()
+        ? `/oapi/v1/codeup/changeRequests`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/changeRequests`;
+    // 构建查询参数
+    const queryParams = {};
+    if (page !== undefined) {
+        queryParams.page = page;
+    }
+    if (perPage !== undefined) {
+        queryParams.perPage = perPage;
+    }
+    if (projectIds !== undefined) {
+        queryParams.projectIds = projectIds;
+    }
+    if (authorIds !== undefined) {
+        queryParams.authorIds = authorIds;
+    }
+    if (reviewerIds !== undefined) {
+        queryParams.reviewerIds = reviewerIds;
+    }
+    if (state !== undefined) {
+        queryParams.state = state;
+    }
+    if (search !== undefined) {
+        queryParams.search = search;
+    }
+    if (orderBy !== undefined) {
+        queryParams.orderBy = orderBy;
+    }
+    if (sort !== undefined) {
+        queryParams.sort = sort;
+    }
+    if (createdBefore !== undefined) {
+        queryParams.createdBefore = createdBefore;
+    }
+    if (createdAfter !== undefined) {
+        queryParams.createdAfter = createdAfter;
+    }
+    // 使用buildUrl函数构建包含查询参数的URL
+    const url = buildUrl(baseUrl, queryParams);
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    // 确保响应是数组
+    if (!Array.isArray(response)) {
+        return [];
+    }
+    // 解析每个变更请求对象
+    return response.map(changeRequest => ChangeRequestSchema.parse(changeRequest));
+}
+/**
+ * 查询合并请求的版本列表（Patch Sets）
+ * Patch Sets 表示合并请求在不同时间点的版本快照
+ *
+ * @param organizationId 组织ID，示例：'60d54f3daccf2bbd6659f3ad'
+ * @param repositoryId 代码库ID或路径，示例：'2835387' 或 '60de7a6852743a5162b5f957%2FDemoRepo'
+ * @param localId 合并请求局部ID，示例：'1'
+ */
+export async function listChangeRequestPatchSetsFunc(organizationId, repositoryId, localId) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const encodedRepoId = handleRepositoryIdEncoding(repositoryId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${encodedRepoId}/changeRequests/${localId}/diffs/patches`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${encodedRepoId}/changeRequests/${localId}/diffs/patches`;
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    // 确保响应是数组
+    if (!Array.isArray(response)) {
+        return [];
+    }
+    // 解析每个版本对象
+    return response.map(patchSet => PatchSetSchema.parse(patchSet));
+}
+/**
+ * 创建合并请求
+ *
+ * @param organizationId 组织ID，示例：'60d54f3daccf2bbd6659f3ad'
+ * @param repositoryId 代码库ID或路径，示例：'2835387' 或 '60de7a6852743a5162b5f957%2FDemoRepo'
+ * @param title 标题，不超过256个字符，示例：'mr title'
+ * @param sourceBranch 源分支名称，示例：'demo-branch'
+ * @param targetBranch 目标分支名称，示例：'master'
+ * @param description 描述，不超过10000个字符（可选），示例：'mr description'
+ * @param sourceProjectId 源库ID（可选，未提供时将尝试自动获取），示例：2813489
+ * @param targetProjectId 目标库ID（可选，未提供时将尝试自动获取），示例：2813489
+ * @param reviewerUserIds 评审人用户ID列表（可选），示例：['62c795xxxb468af8']
+ * @param workItemIds 关联工作项ID列表（可选），示例：['workitem-123']
+ * @param createFrom 创建来源，默认 'WEB'。可选值：'WEB' - 页面创建；'COMMAND_LINE' - 命令行创建
+ * @param triggerAIReviewRun 是否触发AI评审，默认 false
+ */
+export async function createChangeRequestFunc(organizationId, repositoryId, title, sourceBranch, targetBranch, description, sourceProjectId, targetProjectId, reviewerUserIds, workItemIds, createFrom = "WEB", // Possible values: WEB, COMMAND_LINE
+triggerAIReviewRun = false // Whether to trigger AI review
+) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const encodedRepoId = handleRepositoryIdEncoding(repositoryId);
+    // 检查和获取sourceProjectId和targetProjectId
+    let sourceIdString;
+    let targetIdString;
+    if (sourceProjectId !== undefined) {
+        sourceIdString = floatToIntString(sourceProjectId);
+    }
+    if (targetProjectId !== undefined) {
+        targetIdString = floatToIntString(targetProjectId);
+    }
+    // 如果repositoryId是纯数字，且sourceProjectId或targetProjectId未提供，直接使用repositoryId的值
+    if (!isNaN(Number(repositoryId))) {
+        // 是数字ID，可以直接使用
+        if (sourceIdString === undefined) {
+            sourceIdString = repositoryId;
+        }
+        if (targetIdString === undefined) {
+            targetIdString = repositoryId;
+        }
+    }
+    else if (repositoryId.includes("%2F") || repositoryId.includes("/")) {
+        // 如果是组织ID与仓库名称的组合，调用API获取数字ID
+        if (sourceIdString === undefined || targetIdString === undefined) {
+            try {
+                const numericId = await getRepositoryNumericId(organizationId, encodedRepoId);
+                if (sourceIdString === undefined) {
+                    sourceIdString = numericId;
+                }
+                if (targetIdString === undefined) {
+                    targetIdString = numericId;
+                }
+            }
+            catch (error) {
+                throw new Error(`When using 'organizationId%2Frepo-name' format, you must first get the numeric ID of the repository and use it for sourceProjectId and targetProjectId parameters. Please use get_repository tool to get the numeric ID of '${repositoryId}' and then use that ID as the value for sourceProjectId and targetProjectId.`);
+            }
+        }
+    }
+    // 确保sourceProjectId和targetProjectId已设置
+    if (sourceIdString === undefined) {
+        throw new Error("Could not get sourceProjectId, please provide this parameter manually");
+    }
+    if (targetIdString === undefined) {
+        throw new Error("Could not get targetProjectId, please provide this parameter manually");
+    }
+    const url = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${encodedRepoId}/changeRequests`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${encodedRepoId}/changeRequests`;
+    // 准备payload
+    const payload = {
+        title: title,
+        sourceBranch: sourceBranch,
+        targetBranch: targetBranch,
+        sourceProjectId: sourceIdString,
+        targetProjectId: targetIdString,
+        createFrom: createFrom,
+    };
+    // 添加可选参数
+    if (description !== undefined) {
+        payload.description = description;
+    }
+    if (reviewerUserIds !== undefined) {
+        payload.reviewerUserIds = reviewerUserIds;
+    }
+    if (workItemIds !== undefined) {
+        payload.workItemIds = workItemIds;
+    }
+    if (triggerAIReviewRun !== undefined) {
+        payload.triggerAIReviewRun = triggerAIReviewRun;
+    }
+    const response = await yunxiaoRequest(url, {
+        method: "POST",
+        body: payload,
+    });
+    return ChangeRequestSchema.parse(response);
+}

package/dist/operations/codeup/commits.js

@@ -0,0 +1,121 @@
+import { z } from "zod";
+import { yunxiaoRequest, buildUrl, handleRepositoryIdEncoding, isRegionEdition } from "../../common/utils.js";
+import { resolveOrganizationId } from "../organization/organization.js";
+import { DevopsCommitVOSchema as DevopsCommitVOSchemaType } from "./types.js";
+// Commit schemas
+export const ListCommitsRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    repositoryId: z.string().describe("代码库ID或者URL-Encoder编码的全路径"),
+    refName: z.string().describe("分支名称、标签名称或提交版本，默认为代码库默认分支"),
+    since: z.string().optional().describe("提交起始时间，格式：YYYY-MM-DDTHH:MM:SSZ"),
+    until: z.string().optional().describe("提交截止时间，格式：YYYY-MM-DDTHH:MM:SSZ"),
+    page: z.number().int().optional().describe("页码"),
+    perPage: z.number().int().optional().describe("每页大小"),
+    path: z.string().optional().describe("文件路径"),
+    search: z.string().optional().describe("搜索关键字"),
+    showSignature: z.boolean().optional().describe("是否展示签名"),
+    committerIds: z.string().optional().describe("提交人ID列表（多个ID以逗号隔开）"),
+});
+export const GetCommitRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    repositoryId: z.string().describe("代码库ID或者URL-Encoder编码的全路径"),
+    sha: z.string().describe("提交ID，即Commit SHA值"),
+});
+export const CreateCommitCommentRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    repositoryId: z.string().describe("代码库ID或者URL-Encoder编码的全路径"),
+    sha: z.string().describe("提交的SHA值"),
+    content: z.string().describe("commit的评论内容"),
+});
+// Response schemas
+export const DevopsCommitVOSchema = z.object({
+    id: z.string().nullable().optional().describe("提交ID"),
+    shortId: z.string().nullable().optional().describe("代码组路径"),
+    title: z.string().nullable().optional().describe("标题，提交的第一行内容"),
+    message: z.string().nullable().optional().describe("提交内容"),
+    authorName: z.string().nullable().optional().describe("作者姓名"),
+    authorEmail: z.string().nullable().optional().describe("作者邮箱"),
+    authoredDate: z.string().nullable().optional().describe("作者提交时间"),
+    committerName: z.string().nullable().optional().describe("提交者姓名"),
+    committerEmail: z.string().nullable().optional().describe("提交者邮箱"),
+    committedDate: z.string().nullable().optional().describe("提交者提交时间"),
+    webUrl: z.string().nullable().optional().describe("页面访问地址"),
+    parentIds: z.array(z.string()).nullable().optional().describe("父提交ID"),
+});
+export const DevopsCommitStatVOSchema = z.object({
+    additions: z.number().int().nullable().optional().describe("增加行数"),
+    deletions: z.number().int().nullable().optional().describe("删除行数"),
+    total: z.number().int().nullable().optional().describe("总变动行数"),
+});
+export const CreateCommitCommentVOSchema = z.object({
+    content: z.string().describe("commit的评论内容"),
+});
+// API functions
+export async function listCommits(params) {
+    const { organizationId, repositoryId, refName, since, until, page, perPage, path, search, showSignature, committerIds } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const encodedRepoId = handleRepositoryIdEncoding(repositoryId);
+    const baseUrl = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${encodedRepoId}/commits`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${encodedRepoId}/commits`;
+    const queryParams = {
+        refName: refName
+    };
+    if (since !== undefined) {
+        queryParams.since = since;
+    }
+    if (until !== undefined) {
+        queryParams.until = until;
+    }
+    if (page !== undefined) {
+        queryParams.page = page;
+    }
+    if (perPage !== undefined) {
+        queryParams.perPage = perPage;
+    }
+    if (path !== undefined) {
+        queryParams.path = path;
+    }
+    if (search !== undefined) {
+        queryParams.search = search;
+    }
+    if (showSignature !== undefined) {
+        queryParams.showSignature = String(showSignature);
+    }
+    if (committerIds !== undefined) {
+        queryParams.committerIds = committerIds;
+    }
+    const url = buildUrl(baseUrl, queryParams);
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    if (!Array.isArray(response)) {
+        return [];
+    }
+    return response.map(commit => DevopsCommitVOSchemaType.parse(commit));
+}
+export async function getCommit(params) {
+    const { organizationId, repositoryId, sha } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const encodedRepoId = handleRepositoryIdEncoding(repositoryId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${encodedRepoId}/commits/${sha}`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${encodedRepoId}/commits/${sha}`;
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    return DevopsCommitVOSchemaType.parse(response);
+}
+export async function createCommitComment(params) {
+    const { organizationId, repositoryId, sha, content } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const encodedRepoId = handleRepositoryIdEncoding(repositoryId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${encodedRepoId}/commits/${sha}/comments`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${encodedRepoId}/commits/${sha}/comments`;
+    const response = await yunxiaoRequest(url, {
+        method: "POST",
+        body: { content }
+    });
+    return response;
+}

package/dist/operations/codeup/compare.js

@@ -0,0 +1,30 @@
+import { yunxiaoRequest, buildUrl, handleRepositoryIdEncoding, isRegionEdition } from "../../common/utils.js";
+import { resolveOrganizationId } from "../organization/organization.js";
+import { CompareSchema } from "./types.js";
+export async function getCompareFunc(organizationId, repositoryId, from, to, sourceType, // Possible values: branch, tag
+targetType, // Possible values: branch, tag
+straight) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const encodedRepoId = handleRepositoryIdEncoding(repositoryId);
+    const baseUrl = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${encodedRepoId}/compares`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${encodedRepoId}/compares`;
+    const queryParams = {
+        from,
+        to
+    };
+    if (sourceType !== undefined) {
+        queryParams.sourceType = sourceType;
+    }
+    if (targetType !== undefined) {
+        queryParams.targetType = targetType;
+    }
+    if (straight !== undefined) {
+        queryParams.straight = straight;
+    }
+    const url = buildUrl(baseUrl, queryParams);
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    return CompareSchema.parse(response);
+}

package/dist/operations/codeup/files.js

@@ -0,0 +1,249 @@
+import { yunxiaoRequest, buildUrl, pathEscape, isRegionEdition } from "../../common/utils.js";
+import { resolveOrganizationId } from "../organization/organization.js";
+import { FileContentSchema, CreateFileResponseSchema, DeleteFileResponseSchema, FileInfoSchema } from "./types.js";
+// Common helper function to handle repositoryId and filePath encoding
+function handlePathEncoding(repositoryId, filePath) {
+    let encodedRepoId = repositoryId;
+    let encodedFilePath = filePath;
+    // 自动处理repositoryId中未编码的斜杠
+    if (repositoryId.includes("/")) {
+        // 发现未编码的斜杠，自动进行URL编码
+        const parts = repositoryId.split("/", 2);
+        if (parts.length === 2) {
+            const encodedRepoName = encodeURIComponent(parts[1]);
+            // 移除编码中的+号（空格被编码为+，但我们需要%20）
+            const formattedEncodedName = encodedRepoName.replace(/\+/g, "%20");
+            encodedRepoId = `${parts[0]}%2F${formattedEncodedName}`;
+        }
+    }
+    // 确保filePath已被URL编码
+    if (filePath.includes("/")) {
+        const startsWithSlash = filePath.startsWith("/");
+        if (startsWithSlash) {
+            encodedFilePath = encodedFilePath.substring(1);
+        }
+        encodedFilePath = encodeURIComponent(filePath);
+    }
+    return { encodedRepoId, encodedFilePath };
+}
+/**
+ * 查询文件内容
+ * @param organizationId
+ * @param repositoryId
+ * @param filePath
+ * @param ref
+ */
+export async function getFileBlobsFunc(organizationId, repositoryId, filePath, ref) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    // const { encodedRepoId, encodedFilePath } = handlePathEncoding(repositoryId, filePath);
+    let encodedRepoId = repositoryId;
+    let encodedFilePath = filePath;
+    // 自动处理repositoryId中未编码的斜杠
+    if (repositoryId.includes("/")) {
+        // 发现未编码的斜杠，自动进行URL编码
+        const parts = repositoryId.split("/", 2);
+        if (parts.length === 2) {
+            const encodedRepoName = encodeURIComponent(parts[1]);
+            // 移除编码中的+号（空格被编码为+，但我们需要%20）
+            const formattedEncodedName = encodedRepoName.replace(/\+/g, "%20");
+            encodedRepoId = `${parts[0]}%2F${formattedEncodedName}`;
+        }
+    }
+    // 确保filePath已被URL编码
+    if (filePath.includes("/")) {
+        encodedFilePath = encodeURIComponent(filePath);
+    }
+    const baseUrl = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${encodedRepoId}/files/${encodedFilePath}`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${encodedRepoId}/files/${encodedFilePath}`;
+    // 构建查询参数
+    const queryParams = {
+        ref: ref
+    };
+    // 使用buildUrl函数构建包含查询参数的URL
+    const url = buildUrl(baseUrl, queryParams);
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    return FileContentSchema.parse(response);
+}
+/**
+ * 创建文件
+ * @param organizationId
+ * @param repositoryId
+ * @param filePath
+ * @param content
+ * @param commitMessage
+ * @param branch
+ * @param encoding
+ */
+export async function createFileFunc(organizationId, repositoryId, filePath, content, commitMessage, branch, encoding) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    let encodedRepoId = repositoryId;
+    let encodedFilePath = filePath;
+    if (repositoryId.includes("/")) {
+        // 发现未编码的斜杠，自动进行URL编码
+        const parts = repositoryId.split("/", 2);
+        if (parts.length === 2) {
+            const encodedRepoName = encodeURIComponent(parts[1]);
+            // 移除编码中的+号（空格被编码为+，但我们需要%20）
+            const formattedEncodedName = encodedRepoName.replace(/\+/g, "%20");
+            encodedRepoId = `${parts[0]}%2F${formattedEncodedName}`;
+        }
+    }
+    // 确保filePath已被URL编码
+    if (filePath.includes("/")) {
+        encodedFilePath = pathEscape(filePath);
+    }
+    const url = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${encodedRepoId}/files`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${encodedRepoId}/files`;
+    const body = {
+        branch: branch,
+        filePath: encodedFilePath,
+        content: content,
+        commitMessage: commitMessage,
+        encoding: encoding || "text" // 默认使用text编码
+    };
+    const response = await yunxiaoRequest(url, {
+        method: "POST",
+        body: body
+    });
+    return CreateFileResponseSchema.parse(response);
+}
+/**
+ * 更新文件内容
+ * @param organizationId
+ * @param repositoryId
+ * @param filePath
+ * @param content
+ * @param commitMessage
+ * @param branch
+ * @param encoding
+ */
+export async function updateFileFunc(organizationId, repositoryId, filePath, content, commitMessage, branch, encoding) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    //const { encodedRepoId, encodedFilePath } = handlePathEncoding(repositoryId, filePath);
+    let encodedRepoId = repositoryId;
+    let encodedFilePath = filePath;
+    // 自动处理repositoryId中未编码的斜杠
+    if (repositoryId.includes("/")) {
+        // 发现未编码的斜杠，自动进行URL编码
+        const parts = repositoryId.split("/", 2);
+        if (parts.length === 2) {
+            const encodedRepoName = encodeURIComponent(parts[1]);
+            // 移除编码中的+号（空格被编码为+，但我们需要%20）
+            const formattedEncodedName = encodedRepoName.replace(/\+/g, "%20");
+            encodedRepoId = `${parts[0]}%2F${formattedEncodedName}`;
+        }
+    }
+    // 确保filePath已被URL编码
+    if (filePath.includes("/")) {
+        const pathToEncode = filePath.startsWith("/") ? filePath.substring(1) : filePath;
+        encodedFilePath = encodeURIComponent(pathToEncode);
+    }
+    const url = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${encodedRepoId}/files/${encodedFilePath}`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${encodedRepoId}/files/${encodedFilePath}`;
+    const body = {
+        branch: branch,
+        commitMessage: commitMessage,
+        content: content,
+        encoding: encoding || "text" // 默认使用text编码
+    };
+    const response = await yunxiaoRequest(url, {
+        method: "PUT",
+        body: body
+    });
+    return CreateFileResponseSchema.parse(response);
+}
+/**
+ * 删除文件
+ * @param organizationId
+ * @param repositoryId
+ * @param filePath
+ * @param commitMessage
+ * @param branch
+ */
+export async function deleteFileFunc(organizationId, repositoryId, filePath, commitMessage, branch) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    let encodedRepoId = repositoryId;
+    let encodedFilePath = filePath;
+    if (repositoryId.includes("/")) {
+        // 发现未编码的斜杠，自动进行URL编码
+        const parts = repositoryId.split("/", 2);
+        if (parts.length === 2) {
+            const encodedRepoName = encodeURIComponent(parts[1]);
+            // 移除编码中的+号（空格被编码为+，但我们需要%20）
+            const formattedEncodedName = encodedRepoName.replace(/\+/g, "%20");
+            encodedRepoId = `${parts[0]}%2F${formattedEncodedName}`;
+        }
+    }
+    // 确保filePath已被URL编码
+    if (filePath.includes("/")) {
+        encodedFilePath = encodeURIComponent(filePath);
+    }
+    const baseUrl = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${encodedRepoId}/files/${encodedFilePath}`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${encodedRepoId}/files/${encodedFilePath}`;
+    // 构建查询参数
+    const queryParams = {
+        branch: branch,
+        commitMessage: commitMessage
+    };
+    // 使用buildUrl函数构建包含查询参数的URL
+    const url = buildUrl(baseUrl, queryParams);
+    const response = await yunxiaoRequest(url, {
+        method: "DELETE",
+    });
+    return DeleteFileResponseSchema.parse(response);
+}
+/**
+ * 查询文件树
+ * @param organizationId
+ * @param repositoryId
+ * @param path
+ * @param ref
+ * @param type
+ */
+export async function listFilesFunc(organizationId, repositoryId, path, ref, type // Possible values: DIRECT, RECURSIVE, FLATTEN
+) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    // 自动处理repositoryId中未编码的斜杠
+    let encodedRepoId = repositoryId;
+    if (repositoryId.includes("/")) {
+        // 发现未编码的斜杠，自动进行URL编码
+        const parts = repositoryId.split("/", 2);
+        if (parts.length === 2) {
+            const encodedRepoName = encodeURIComponent(parts[1]);
+            // 移除编码中的+号（空格被编码为+，但我们需要%20）
+            const formattedEncodedName = encodedRepoName.replace(/\+/g, "%20");
+            encodedRepoId = `${parts[0]}%2F${formattedEncodedName}`;
+        }
+    }
+    const baseUrl = isRegionEdition()
+        ? `/oapi/v1/codeup/repositories/${encodedRepoId}/files/tree`
+        : `/oapi/v1/codeup/organizations/${finalOrgId}/repositories/${encodedRepoId}/files/tree`;
+    // 构建查询参数
+    const queryParams = {};
+    if (path) {
+        queryParams.path = path;
+    }
+    if (ref) {
+        queryParams.ref = ref;
+    }
+    if (type) {
+        queryParams.type = type;
+    }
+    // 使用buildUrl函数构建包含查询参数的URL
+    const url = buildUrl(baseUrl, queryParams);
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    // 确保响应是数组
+    if (!Array.isArray(response)) {
+        return [];
+    }
+    // 解析每个文件信息对象
+    return response.map(fileInfo => FileInfoSchema.parse(fileInfo));
+}