ai-dev-requirements 0.1.8 → 0.1.10

package/dist/index.cjs

@@ -93,6 +93,9 @@ const TASK_DETAIL_QUERY = `
   query Task($key: Key) {
     task(key: $key) {
       key uuid number name
+      description
+      descriptionText
+      desc_rich: description
       issueType { uuid name }
       status { uuid name category }
       priority { value }
@@ -202,6 +205,55 @@ const DEFAULT_STATUS_NOT_IN = [
 	"Dn3k8ffK",
 	"TbmY2So5"
 ];
+const TESTCASE_LIBRARY_LIST_QUERY = `
+  query Q {
+    testcaseLibraries {
+      uuid name key
+      testcaseCaseCount
+    }
+  }
+`;
+const TESTCASE_MODULE_SEARCH_QUERY = `
+  query Q($filter: Filter) {
+    testcaseModules(filter: $filter) {
+      uuid name key
+      parent { uuid name }
+    }
+  }
+`;
+const TESTCASE_LIST_PAGED_QUERY = `
+  query PAGED_LIBRARY_TESTCASE_LIST($testCaseFilter: Filter, $pagination: Pagination) {
+    buckets(groupBy: {testcaseCases: {}}, pagination: $pagination) {
+      testcaseCases(filterGroup: $testCaseFilter, limit: 10000) {
+        uuid name key id
+        priority { uuid value }
+        type { uuid value }
+        assign { uuid name }
+        testcaseModule { uuid }
+      }
+      key
+      pageInfo { count totalCount hasNextPage endCursor }
+    }
+  }
+`;
+const TESTCASE_DETAIL_QUERY = `
+  query QUERY_TESTCASES_DETAIL($testCaseFilter: Filter, $stepFilter: Filter) {
+    testcaseCases(filter: $testCaseFilter) {
+      uuid name key id condition desc path
+      assign { uuid name }
+      priority { uuid value }
+      type { uuid value }
+      testcaseLibrary { uuid }
+      testcaseModule { uuid }
+      relatedTasks { uuid name number }
+    }
+    testcaseCaseSteps(filter: $stepFilter, orderBy: { index: ASC }) {
+      key uuid
+      testcaseCase { uuid }
+      desc result index
+    }
+  }
+`;
 function parseOnesSearchIntent(query) {
 	if (!query) return "keyword";
 	const normalized = query.toLowerCase();
@@ -273,7 +325,120 @@ function getSetCookies(response) {
 	const raw = response.headers.get("set-cookie");
 	return raw ? [raw] : [];
 }
-function toRequirement(task, description = "") {
+function extractWikiPageUuidsFromText(text) {
+	if (!text) return [];
+	const uuids = /* @__PURE__ */ new Set();
+	for (const pattern of [/\/page\/([\w-]+)/g, /page=([\w-]+)/g]) for (const match of text.matchAll(pattern)) if (match[1]) uuids.add(match[1]);
+	return [...uuids];
+}
+function htmlToPlainText(html) {
+	return html.replace(/<br\s*\/?>/gi, "\n").replace(/<\/p>/gi, "\n").replace(/<[^>]+>/g, "").replace(/&nbsp;/g, " ").replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/\n{3,}/g, "\n\n").trim();
+}
+function getTaskDetailText(task) {
+	return task.descriptionText?.trim() || htmlToPlainText(task.desc_rich ?? task.description ?? "");
+}
+function isRecord(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function parseJsonRecord(value) {
+	try {
+		const parsed = JSON.parse(value);
+		return isRecord(parsed) ? parsed : null;
+	} catch {
+		return null;
+	}
+}
+function asWikiBlocks(value) {
+	if (!Array.isArray(value)) return [];
+	return value.filter(isRecord);
+}
+function renderWikiTextRuns(value) {
+	if (!Array.isArray(value)) return "";
+	return value.map((run) => {
+		if (!isRecord(run)) return "";
+		const attributes = isRecord(run.attributes) ? run.attributes : {};
+		const insert = typeof run.insert === "string" ? run.insert.replace(/\u00A0/g, " ") : "";
+		const link = typeof attributes.link === "string" ? attributes.link : "";
+		if (link && insert.trim()) return `[${insert}](${link})`;
+		const taskName = typeof attributes.taskName === "string" ? attributes.taskName : "";
+		if (link && taskName) return `[${taskName}](${link})`;
+		return insert;
+	}).join("").replace(/\n{3,}/g, "\n\n").trim();
+}
+function renderWikiHeading(text, heading) {
+	if (!heading) return text;
+	const level = Math.min(Math.max(Math.trunc(heading), 1), 6);
+	return `${"#".repeat(level)} ${text}`;
+}
+function getWikiImageSource(block) {
+	const embedData = isRecord(block.embedData) ? block.embedData : {};
+	return typeof embedData.src === "string" ? embedData.src.trim() : "";
+}
+function renderWikiEmbed(block, context) {
+	if (block.embedType === "image") {
+		const src = getWikiImageSource(block);
+		if (src && !context.imageSources.includes(src)) context.imageSources.push(src);
+		return src ? `[Image: ${src}]` : "[Image]";
+	}
+	return block.embedType ? `[Embed: ${block.embedType}]` : "";
+}
+function escapeWikiTableCell(value) {
+	return value.replace(/\|/g, "\\|").replace(/[ \t]*\n+[ \t]*/g, " ").trim();
+}
+function renderWikiCell(value, document, context) {
+	const blocks = asWikiBlocks(value);
+	if (!blocks.length) return "";
+	return blocks.map((block) => renderWikiBlock(block, document, context)).filter(Boolean).join(" ").replace(/[ \t]*\n+[ \t]*/g, " ").trim();
+}
+function renderWikiTable(block, document, context) {
+	const cols = typeof block.cols === "number" && block.cols > 0 ? Math.trunc(block.cols) : 0;
+	const children = Array.isArray(block.children) ? block.children.filter((child) => typeof child === "string") : [];
+	if (!cols || !children.length) return "";
+	const rows = [];
+	for (let index = 0; index < children.length; index += cols) {
+		const cells = children.slice(index, index + cols).map((childId) => escapeWikiTableCell(renderWikiCell(document[childId], document, context)));
+		while (cells.length < cols) cells.push("");
+		rows.push(`| ${cells.join(" | ")} |`);
+	}
+	if (rows.length > 1) rows.splice(1, 0, `| ${Array.from({ length: cols }, () => "---").join(" | ")} |`);
+	return rows.join("\n");
+}
+function renderWikiBlock(block, document, context) {
+	if (block.type === "table") return renderWikiTable(block, document, context);
+	if (block.type === "embed") return renderWikiEmbed(block, context);
+	const text = renderWikiTextRuns(block.text);
+	if (!text) return "";
+	if (block.type === "list") {
+		const level = typeof block.level === "number" ? Math.max(Math.trunc(block.level), 1) : 1;
+		return `${"  ".repeat(level - 1)}${block.ordered ? `${block.start ?? 1}.` : "-"} ${text}`;
+	}
+	return renderWikiHeading(text, block.heading);
+}
+function renderWikiContent(content, context = { imageSources: [] }) {
+	const trimmed = content.trim();
+	if (!trimmed) return "";
+	const document = parseJsonRecord(trimmed);
+	if (!document) return trimmed;
+	if (!("blocks" in document)) return trimmed;
+	return asWikiBlocks(document.blocks).map((block) => renderWikiBlock(block, document, context)).filter(Boolean).join("\n\n").replace(/[ \t]+\n/g, "\n").replace(/\n{3,}/g, "\n\n").trim();
+}
+function mimeTypeFromFileName(fileName) {
+	const normalized = fileName.toLowerCase();
+	if (normalized.endsWith(".jpg") || normalized.endsWith(".jpeg")) return "image/jpeg";
+	if (normalized.endsWith(".gif")) return "image/gif";
+	if (normalized.endsWith(".webp")) return "image/webp";
+	if (normalized.endsWith(".svg")) return "image/svg+xml";
+	return "image/png";
+}
+function attachmentNameFromPath(path) {
+	const name = path.split("/").pop() || path;
+	try {
+		return decodeURIComponent(name);
+	} catch {
+		return name;
+	}
+}
+function toRequirement(task, description = "", attachments = []) {
 	return {
 		id: task.uuid,
 		source: "ones",
@@ -288,7 +453,7 @@ function toRequirement(task, description = "") {
 		createdAt: "",
 		updatedAt: "",
 		dueDate: null,
-		attachments: [],
+		attachments,
 		raw: task
 	};
 }
@@ -568,12 +733,51 @@ var OnesAdapter = class extends BaseAdapter {
 	* Fetch wiki page content via REST API.
 	* Endpoint: /wiki/api/wiki/team/{teamUuid}/online_page/{wikiUuid}/content
 	*/
+	async fetchWikiPageDetail(wikiUuid) {
+		const session = await this.login();
+		const url = `${this.config.apiBase}/wiki/api/wiki/team/${session.teamUuid}/page/${wikiUuid}/detail`;
+		const response = await fetch(url, { headers: { Authorization: `Bearer ${session.accessToken}` } });
+		if (!response.ok) return {};
+		return response.json();
+	}
+	buildWikiImageUrl(session, refUuid, source, token) {
+		const encodedRefUuid = encodeURIComponent(refUuid);
+		const encodedSource = source.split("/").map((part) => encodeURIComponent(part)).join("/");
+		const encodedToken = encodeURIComponent(token);
+		return `${this.config.apiBase}/wiki/api/wiki/editor/${session.teamUuid}/${encodedRefUuid}/resources/${encodedSource}?token=${encodedToken}`;
+	}
 	async fetchWikiContent(wikiUuid) {
 		const session = await this.login();
 		const url = `${this.config.apiBase}/wiki/api/wiki/team/${session.teamUuid}/online_page/${wikiUuid}/content`;
 		const response = await fetch(url, { headers: { Authorization: `Bearer ${session.accessToken}` } });
-		if (!response.ok) return "";
-		return (await response.json()).content ?? "";
+		if (!response.ok) return {
+			content: "",
+			attachments: []
+		};
+		const data = await response.json();
+		const renderContext = { imageSources: [] };
+		const content = renderWikiContent(typeof data.content === "string" ? data.content : "", renderContext);
+		const token = typeof data.token === "string" ? data.token : "";
+		if (!renderContext.imageSources.length || !token) return {
+			content,
+			attachments: []
+		};
+		const detail = await this.fetchWikiPageDetail(wikiUuid);
+		const refUuid = typeof detail.ref_uuid === "string" ? detail.ref_uuid : "";
+		if (!refUuid) return {
+			content,
+			attachments: []
+		};
+		return {
+			content,
+			attachments: renderContext.imageSources.map((source, index) => ({
+				id: `${wikiUuid}-image-${index + 1}`,
+				name: attachmentNameFromPath(source),
+				url: this.buildWikiImageUrl(session, refUuid, source, token),
+				mimeType: mimeTypeFromFileName(source),
+				size: 0
+			}))
+		};
 	}
 	/**
 	* Fetch a single task by UUID or number (e.g. "#95945" or "95945").
@@ -601,13 +805,27 @@ var OnesAdapter = class extends BaseAdapter {
 		}
 		const task = (await this.graphql(TASK_DETAIL_QUERY, { key: `task-${taskUuid}` }, "Task")).data?.task;
 		if (!task) throw new Error(`ONES: Task "${taskUuid}" not found`);
-		const wikiPages = task.relatedWikiPages ?? [];
-		const wikiContents = await Promise.all(wikiPages.filter((w) => !w.errorMessage).map(async (wiki) => {
-			const content = await this.fetchWikiContent(wiki.uuid);
+		const wikiRefs = /* @__PURE__ */ new Map();
+		for (const wiki of task.relatedWikiPages ?? []) if (!wiki.errorMessage) wikiRefs.set(wiki.uuid, {
+			title: wiki.title,
+			uuid: wiki.uuid
+		});
+		const detailForLinkExtraction = [
+			task.description,
+			task.descriptionText,
+			task.desc_rich
+		].filter(Boolean).join("\n");
+		for (const wikiUuid of extractWikiPageUuidsFromText(detailForLinkExtraction)) if (!wikiRefs.has(wikiUuid)) wikiRefs.set(wikiUuid, {
+			title: `Wiki ${wikiUuid}`,
+			uuid: wikiUuid
+		});
+		const wikiContents = await Promise.all([...wikiRefs.values()].map(async (wiki) => {
+			const rendered = await this.fetchWikiContent(wiki.uuid);
 			return {
 				title: wiki.title,
 				uuid: wiki.uuid,
-				content
+				content: rendered.content,
+				attachments: rendered.attachments
 			};
 		}));
 		const parts = [];
@@ -646,7 +864,18 @@ var OnesAdapter = class extends BaseAdapter {
 				else parts.push("(No content available)");
 			}
 		}
-		return toRequirement(task, parts.join("\n"));
+		const detailText = getTaskDetailText(task);
+		const hasWikiContent = wikiContents.some((wiki) => wiki.content.trim());
+		if (detailText && !hasWikiContent) {
+			parts.push("");
+			parts.push("---");
+			parts.push("");
+			parts.push("## Requirement Detail");
+			parts.push("");
+			parts.push(detailText);
+		}
+		const wikiAttachments = wikiContents.flatMap((wiki) => wiki.attachments);
+		return toRequirement(task, parts.join("\n"), wikiAttachments);
 	}
 	/**
 	* Search tasks assigned to current user via GraphQL.
@@ -783,6 +1012,108 @@ var OnesAdapter = class extends BaseAdapter {
 			raw: task
 		};
 	}
+	async getTestcases(params) {
+		let libraryUuid = params.libraryUuid ?? this.config.options?.testcaseLibraryUuid;
+		if (!libraryUuid) {
+			const libs = (await this.graphql(TESTCASE_LIBRARY_LIST_QUERY, {}, "library-select")).data?.testcaseLibraries ?? [];
+			if (libs.length === 0) throw new Error("ONES: No testcase libraries found for this team");
+			libs.sort((a, b) => b.testcaseCaseCount - a.testcaseCaseCount);
+			libraryUuid = libs[0].uuid;
+		}
+		const task = ((await this.graphql(SEARCH_TASKS_QUERY, {
+			groupBy: { tasks: {} },
+			groupOrderBy: null,
+			orderBy: { createTime: "DESC" },
+			filterGroup: [{ number_in: [params.taskNumber] }],
+			search: null,
+			pagination: {
+				limit: 10,
+				preciseCount: false
+			},
+			limit: 10
+		}, "group-task-data")).data?.buckets?.flatMap((b) => b.tasks ?? []) ?? []).find((t) => t.number === params.taskNumber);
+		if (!task) throw new Error(`ONES: Task #${params.taskNumber} not found`);
+		const modules = (await this.graphql(TESTCASE_MODULE_SEARCH_QUERY, { filter: {
+			testcaseLibrary_in: [libraryUuid],
+			name_match: `#${params.taskNumber}`
+		} }, "find-testcase-module")).data?.testcaseModules ?? [];
+		if (modules.length === 0) throw new Error(`ONES: No testcase module matching "#${params.taskNumber}" in library ${libraryUuid}`);
+		const mod = modules[0];
+		const caseList = [];
+		let cursor = "";
+		let totalCount = 0;
+		while (true) {
+			const bucket = (await this.graphql(TESTCASE_LIST_PAGED_QUERY, {
+				testCaseFilter: [{
+					testcaseLibrary_in: [libraryUuid],
+					path_match: mod.uuid
+				}],
+				pagination: {
+					limit: 50,
+					after: cursor,
+					preciseCount: true
+				}
+			}, "testcase-list-paged")).data?.buckets?.[0];
+			if (!bucket) break;
+			caseList.push(...bucket.testcaseCases ?? []);
+			totalCount = bucket.pageInfo.totalCount;
+			if (!bucket.pageInfo.hasNextPage) break;
+			cursor = bucket.pageInfo.endCursor;
+		}
+		if (caseList.length === 0) return {
+			taskNumber: params.taskNumber,
+			taskName: task.name,
+			moduleName: mod.name,
+			moduleUuid: mod.uuid,
+			totalCount: 0,
+			cases: []
+		};
+		const allCases = [];
+		const BATCH_SIZE = 20;
+		for (let i = 0; i < caseList.length; i += BATCH_SIZE) {
+			const uuids = caseList.slice(i, i + BATCH_SIZE).map((c) => c.uuid);
+			const detailData = await this.graphql(TESTCASE_DETAIL_QUERY, {
+				testCaseFilter: { uuid_in: [...uuids, null] },
+				stepFilter: { testcaseCase_in: uuids }
+			}, "library-testcase-detail");
+			const cases = detailData.data?.testcaseCases ?? [];
+			const steps = detailData.data?.testcaseCaseSteps ?? [];
+			const stepsByCase = /* @__PURE__ */ new Map();
+			for (const step of steps) {
+				const caseUuid = step.testcaseCase.uuid;
+				if (!stepsByCase.has(caseUuid)) stepsByCase.set(caseUuid, []);
+				stepsByCase.get(caseUuid).push({
+					uuid: step.uuid,
+					index: step.index,
+					desc: step.desc ?? "",
+					result: step.result ?? ""
+				});
+			}
+			for (const c of cases) {
+				const freshDesc = c.desc ? await this.refreshImageUrls(c.desc) : "";
+				allCases.push({
+					uuid: c.uuid,
+					id: c.id,
+					name: c.name,
+					priority: c.priority?.value ?? "N/A",
+					type: c.type?.value ?? "Unknown",
+					assignName: c.assign?.name ?? null,
+					condition: c.condition ?? "",
+					desc: freshDesc,
+					steps: (stepsByCase.get(c.uuid) ?? []).sort((a, b) => a.index - b.index),
+					modulePath: c.path ?? ""
+				});
+			}
+		}
+		return {
+			taskNumber: params.taskNumber,
+			taskName: task.name,
+			moduleName: mod.name,
+			moduleUuid: mod.uuid,
+			totalCount,
+			cases: allCases
+		};
+	}
 };
 
 //#endregion
@@ -884,6 +1215,11 @@ function loadConfigFromEnv() {
 	const account = process.env.ONES_ACCOUNT;
 	const password = process.env.ONES_PASSWORD;
 	if (!apiBase || !account || !password) return null;
+	let options;
+	const configPath = findConfigFile(process.cwd());
+	if (configPath) try {
+		options = JSON.parse((0, node_fs.readFileSync)(configPath, "utf-8"))?.sources?.ones?.options;
+	} catch {}
 	return {
 		sources: { ones: {
 			enabled: true,
@@ -892,7 +1228,8 @@ function loadConfigFromEnv() {
 				type: "ones-pkce",
 				emailEnv: "ONES_ACCOUNT",
 				passwordEnv: "ONES_PASSWORD"
-			}
+			},
+			options
 		} },
 		defaultSource: "ones"
 	};
@@ -959,7 +1296,7 @@ const GetIssueDetailSchema = zod_v4.z.object({
 * Download an image from URL and return as base64 data URI.
 * Returns null if download fails.
 */
-async function downloadImageAsBase64(url) {
+async function downloadImageAsBase64$1(url) {
 	try {
 		const res = await fetch(url, { redirect: "follow" });
 		if (!res.ok) return null;
@@ -985,7 +1322,7 @@ async function handleGetIssueDetail(input, adapters, defaultSource) {
 	if (!adapter) throw new Error(`Source "${sourceType}" is not configured. Available: ${[...adapters.keys()].join(", ")}`);
 	const detail = await adapter.getIssueDetail({ issueId: input.issueId });
 	const imageUrls = detail.descriptionRich ? extractImageUrls(detail.descriptionRich) : [];
-	const imageResults = await Promise.all(imageUrls.map((url) => downloadImageAsBase64(url)));
+	const imageResults = await Promise.all(imageUrls.map((url) => downloadImageAsBase64$1(url)));
 	const content = [{
 		type: "text",
 		text: formatIssueDetail(detail)
@@ -1071,15 +1408,54 @@ const GetRequirementSchema = zod_v4.z.object({
 	id: zod_v4.z.string().describe("The requirement/issue ID"),
 	source: zod_v4.z.string().optional().describe("Source to fetch from. If omitted, uses the default source.")
 });
+async function downloadImageAsBase64(url, fallbackMimeType = "image/png") {
+	try {
+		const res = await fetch(url, { redirect: "follow" });
+		if (!res.ok) return null;
+		const mimeType = (res.headers.get("content-type") ?? fallbackMimeType).split(";")[0].trim() || fallbackMimeType;
+		return {
+			base64: Buffer.from(await res.arrayBuffer()).toString("base64"),
+			mimeType
+		};
+	} catch {
+		return null;
+	}
+}
+function isImageAttachment(attachment) {
+	if (attachment.mimeType.startsWith("image/")) return true;
+	return /\.(?:png|jpe?g|gif|webp|svg)$/i.test(attachment.url);
+}
+function displayAttachmentUrl(url) {
+	try {
+		const parsed = new URL(url);
+		parsed.search = "";
+		parsed.hash = "";
+		return parsed.toString();
+	} catch {
+		return url.replace(/[?#].*$/, "");
+	}
+}
 async function handleGetRequirement(input, adapters, defaultSource) {
 	const sourceType = input.source ?? defaultSource;
 	if (!sourceType) throw new Error("No source specified and no default source configured");
 	const adapter = adapters.get(sourceType);
 	if (!adapter) throw new Error(`Source "${sourceType}" is not configured. Available: ${[...adapters.keys()].join(", ")}`);
-	return { content: [{
+	const requirement = await adapter.getRequirement({ id: input.id });
+	const imageAttachments = requirement.attachments.filter(isImageAttachment);
+	const imageResults = await Promise.all(imageAttachments.map((attachment) => downloadImageAsBase64(attachment.url, attachment.mimeType)));
+	const content = [{
 		type: "text",
-		text: formatRequirement(await adapter.getRequirement({ id: input.id }))
-	}] };
+		text: formatRequirement(requirement)
+	}];
+	for (const image of imageResults) {
+		if (!image) continue;
+		content.push({
+			type: "image",
+			data: image.base64,
+			mimeType: image.mimeType
+		});
+	}
+	return { content };
 }
 function formatRequirement(req) {
 	const lines = [
@@ -1100,7 +1476,59 @@ function formatRequirement(req) {
 	lines.push("", "## Description", "", req.description || "_No description_");
 	if (req.attachments.length > 0) {
 		lines.push("", "## Attachments");
-		for (const att of req.attachments) lines.push(`- [${att.name}](${att.url}) (${att.mimeType}, ${att.size} bytes)`);
+		for (const att of req.attachments) lines.push(`- [${att.name}](${displayAttachmentUrl(att.url)}) (${att.mimeType}, ${att.size} bytes)`);
+	}
+	return lines.join("\n");
+}
+
+//#endregion
+//#region src/tools/get-testcases.ts
+const GetTestcasesSchema = zod_v4.z.object({
+	taskNumber: zod_v4.z.string().describe("Task number (e.g. \"302\" or \"#302\"). Finds all testcases in the matching module."),
+	libraryUuid: zod_v4.z.string().optional().describe("Testcase library UUID. If omitted, uses configured default."),
+	source: zod_v4.z.string().optional().describe("Source to fetch from. If omitted, uses the default source.")
+});
+async function handleGetTestcases(input, adapters, defaultSource) {
+	const sourceType = input.source ?? defaultSource;
+	if (!sourceType) throw new Error("No source specified and no default source configured");
+	const adapter = adapters.get(sourceType);
+	if (!adapter) throw new Error(`Source "${sourceType}" is not configured. Available: ${[...adapters.keys()].join(", ")}`);
+	const numMatch = input.taskNumber.match(/^#?(\d+)$/);
+	if (!numMatch) throw new Error(`Invalid task number: "${input.taskNumber}". Expected a number like "302" or "#302".`);
+	return { content: [{
+		type: "text",
+		text: formatTestcases(await adapter.getTestcases({
+			taskNumber: Number.parseInt(numMatch[1], 10),
+			libraryUuid: input.libraryUuid
+		}))
+	}] };
+}
+function formatTestcases(result) {
+	const lines = [
+		`# ${result.taskName} — 测试用例`,
+		"",
+		`- **模块**: ${result.moduleName}`,
+		`- **共 ${result.totalCount} 个用例**（已加载 ${result.cases.length} 个）`,
+		""
+	];
+	for (const tc of result.cases) {
+		lines.push(`## ${tc.id} ${tc.name}`);
+		lines.push("");
+		lines.push(`- 优先级: ${tc.priority} | 类型: ${tc.type}`);
+		if (tc.assignName) lines.push(`- 维护人: ${tc.assignName}`);
+		if (tc.condition) lines.push(`- 前置条件: ${tc.condition}`);
+		if (tc.desc) lines.push(`- 备注: ${tc.desc}`);
+		if (tc.steps.length > 0) {
+			lines.push("");
+			lines.push("| 步骤 | 操作描述 | 预期结果 |");
+			lines.push("|------|----------|----------|");
+			for (const step of tc.steps) {
+				const desc = step.desc.replace(/\n/g, "<br>");
+				const res = step.result.replace(/\n/g, "<br>");
+				lines.push(`| ${step.index + 1} | ${desc} | ${res} |`);
+			}
+		}
+		lines.push("");
 	}
 	return lines.join("\n");
 }
@@ -1284,6 +1712,19 @@ async function main() {
 			};
 		}
 	});
+	server.tool("get_testcases", "Get all test cases for a task by its number (e.g. 302). Searches the testcase library for a matching module and returns all cases with steps.", GetTestcasesSchema.shape, async (params) => {
+		try {
+			return await handleGetTestcases(params, adapters, config.config.defaultSource);
+		} catch (err) {
+			return {
+				content: [{
+					type: "text",
+					text: `Error: ${err.message}`
+				}],
+				isError: true
+			};
+		}
+	});
 	const transport = new _modelcontextprotocol_sdk_server_stdio_js.StdioServerTransport();
 	await server.connect(transport);
 }