kcode-pi 0.1.14 → 0.1.16

package/src/tools/build-debug.ts

@@ -20,17 +20,17 @@ export interface DebugFinding {
 
 export function planBuild(cwd: string, profile: ProductProfile, target?: string): BuildPlan {
 	if (profile.product === "unknown") {
-		throw new Error("Product profile is unknown. Set product before running kd_build.");
+		throw new Error("产品画像未知。运行 kd_build 前请先设置 product。");
 	}
 
 	if (profile.platform === "cosmic") return planJavaBuild(cwd, profile, target);
 	if (profile.platform === "enterprise-csharp") return planCsharpBuild(cwd, profile, target);
 	if (profile.platform === "enterprise-python") {
 		throw new Error(
-			"Enterprise Python plugins usually have no local build step. Verify by BOS registration and functional testing; record the script path, plugin type, FormId, field/entity keys, and test data in VERIFY.md.",
+			"企业版 Python 插件通常没有本地构建步骤。请通过 BOS 注册和功能测试验证，并在 VERIFY.md 中记录脚本路径、插件类型、FormId、字段/实体标识和测试数据。",
 		);
 	}
-	throw new Error(`No build strategy for ${profile.product}/${profile.platform}/${profile.techStack}.`);
+	throw new Error(`未找到 ${profile.product}/${profile.platform}/${profile.techStack} 的构建策略。`);
 }
 
 export async function runBuild(plan: BuildPlan, dryRun?: boolean) {
@@ -55,66 +55,66 @@ export function analyzeDebugText(text: string): DebugFinding[] {
 	pushIfMatch(findings, lines, /NullPointerException|Object reference not set/i, {
 		severity: "error",
 		rule: "null-pointer",
-		message: "Detected null pointer failure.",
-		nextStep: "Check field metadata, nullable fields, DynamicObject access, and DataSet row getters near the stack frame.",
+		message: "检测到空指针/空引用异常。",
+		nextStep: "检查堆栈附近的字段元数据、可空字段、DynamicObject 取值和 DataSet 行读取。",
 	});
 
 	pushIfMatch(findings, lines, /ClassNotFoundException|NoClassDefFoundError|FileNotFoundException.*\.jar/i, {
 		severity: "error",
 		rule: "classpath",
-		message: "Detected missing class or jar dependency.",
-		nextStep: "Verify module dependency, biz/cuslib deployment, and whether the correct product/version SDK is used.",
+		message: "检测到类或 jar 依赖缺失。",
+		nextStep: "检查模块依赖、biz/cuslib 部署，以及是否使用了正确产品/版本的 SDK。",
 	});
 
 	pushIfMatch(findings, lines, /DataSet.*closed|ResultSet.*closed|connection.*closed/i, {
 		severity: "error",
 		rule: "dataset-scope",
-		message: "Detected closed DataSet/connection usage.",
-		nextStep: "Keep DataSet processing inside try-with-resources and inside the transaction/resource scope that created it.",
+		message: "检测到已关闭的 DataSet/connection 被继续使用。",
+		nextStep: "确保 DataSet 处理位于 try-with-resources 内，并处于创建它的事务/资源作用域内。",
 	});
 
 	pushIfMatch(findings, lines, /SQLSyntaxErrorException|PSQLException|syntax error|invalid column|column .* does not exist/i, {
 		severity: "error",
 		rule: "sql-metadata",
-		message: "Detected SQL or metadata mismatch.",
-		nextStep: "Use kd_cosmic_metadata with sql=true to verify table names, DB fields, enum values, and dbName/dbKey.",
+		message: "检测到 SQL 或元数据不匹配。",
+		nextStep: "使用 kd_cosmic_metadata 并设置 sql=true 查证表名、数据库字段、枚举值和 dbName/dbKey。",
 	});
 
 	pushIfMatch(findings, lines, /deadlock|lock wait timeout|could not serialize access|并发|死锁/i, {
 		severity: "error",
 		rule: "transaction-lock",
-		message: "Detected transaction locking or concurrency failure.",
-		nextStep: "Review transaction size, cross-database writes, update ordering, and whether external calls run inside transactions.",
+		message: "检测到事务锁或并发问题。",
+		nextStep: "检查事务范围、跨库写入、更新顺序，以及外部调用是否放在事务内。",
 	});
 
 	pushIfMatch(findings, lines, /OutOfMemoryError|GC overhead|Java heap space|内存溢出/i, {
 		severity: "error",
 		rule: "memory",
-		message: "Detected memory pressure or OOM.",
-		nextStep: "Check full-table queries, unbounded collections, deep field paths, and large DataSet/materialized loads.",
+		message: "检测到内存压力或 OOM。",
+		nextStep: "检查全表查询、无限集合、过深字段路径，以及大 DataSet/物化加载。",
 	});
 
 	pushIfMatch(findings, lines, /StackOverflowError|propertyChanged/i, {
 		severity: "warning",
 		rule: "event-recursion",
-		message: "Potential recursive event handling.",
-		nextStep: "Check propertyChanged/setValue loops and compare old/new values before writing fields.",
+		message: "可能存在事件递归触发。",
+		nextStep: "检查 propertyChanged/setValue 循环，写字段前比较新旧值。",
 	});
 
 	pushIfMatch(findings, lines, /Gradle|Compilation failed|javac|CS\d{4}|MSB\d{4}|BUILD FAILED|BUILD FAILURE/i, {
 		severity: "error",
 		rule: "build-error",
-		message: "Detected build or compiler error.",
-		nextStep: "Use product-specific build output. For Cosmic Java verify SDK signatures; for enterprise C# verify namespaces and references.",
+		message: "检测到构建或编译错误。",
+		nextStep: "使用产品对应的构建输出。Cosmic Java 需查证 SDK 签名；企业版 C# 需查证命名空间和引用。",
 	});
 
 	if (findings.length === 0) {
 		findings.push({
 			severity: "info",
 			rule: "no-known-pattern",
-			message: "No known Kingdee debug pattern matched.",
+			message: "未匹配到已知金蝶调试模式。",
 			evidence: "",
-			nextStep: "Provide fuller logs, stack trace, product/version, target bill/form, and recent code changes.",
+			nextStep: "请提供更完整的日志、堆栈、产品/版本、目标单据/表单和最近代码改动。",
 		});
 	}
 
@@ -127,8 +127,8 @@ export function formatDebugFindings(findings: DebugFinding[]): string {
 			[
 				`[${finding.severity}] ${finding.rule}`,
 				finding.message,
-				finding.evidence ? `Evidence: ${finding.evidence}` : undefined,
-				`Next: ${finding.nextStep}`,
+				finding.evidence ? `证据：${finding.evidence}` : undefined,
+				`下一步：${finding.nextStep}`,
 			]
 				.filter(Boolean)
 				.join("\n"),
@@ -138,7 +138,7 @@ export function formatDebugFindings(findings: DebugFinding[]): string {
 
 export function readDebugInput(cwd: string, text?: string, path?: string): { source: string; text: string } {
 	if (text) return { source: "inline", text };
-	if (!path) throw new Error("Provide either text or path for kd_debug.");
+	if (!path) throw new Error("kd_debug 需要提供 text 或 path。");
 
 	const fullPath = resolveWorkspacePath(cwd, path);
 	return { source: path, text: readFileSync(fullPath, "utf8") };
@@ -152,39 +152,39 @@ function planJavaBuild(cwd: string, profile: ProductProfile, target?: string): B
 	const mvnw = join(cwd, "mvnw");
 
 	if (existsSync(gradlewBat)) {
-		return buildPlan(profile, gradlewBat, [task], cwd, "Detected Gradle wrapper for Cosmic-family Java project.");
+		return buildPlan(profile, gradlewBat, [task], cwd, "检测到 Cosmic 家族 Java 项目的 Gradle wrapper。");
 	}
 	if (existsSync(gradlew)) {
-		return buildPlan(profile, gradlew, [task], cwd, "Detected Gradle wrapper for Cosmic-family Java project.");
+		return buildPlan(profile, gradlew, [task], cwd, "检测到 Cosmic 家族 Java 项目的 Gradle wrapper。");
 	}
 	if (existsSync(mvnwBat)) {
-		return buildPlan(profile, mvnwBat, [target ?? "test"], cwd, "Detected Maven wrapper for Cosmic-family Java project.");
+		return buildPlan(profile, mvnwBat, [target ?? "test"], cwd, "检测到 Cosmic 家族 Java 项目的 Maven wrapper。");
 	}
 	if (existsSync(mvnw)) {
-		return buildPlan(profile, mvnw, [target ?? "test"], cwd, "Detected Maven wrapper for Cosmic-family Java project.");
+		return buildPlan(profile, mvnw, [target ?? "test"], cwd, "检测到 Cosmic 家族 Java 项目的 Maven wrapper。");
 	}
 	if (existsSync(join(cwd, "build.gradle")) || existsSync(join(cwd, "build.gradle.kts"))) {
-		return buildPlan(profile, "gradle", [task], cwd, "Detected Gradle build file; wrapper not found.");
+		return buildPlan(profile, "gradle", [task], cwd, "检测到 Gradle 构建文件，但未找到 wrapper。");
 	}
 	if (existsSync(join(cwd, "pom.xml"))) {
-		return buildPlan(profile, "mvn", [target ?? "test"], cwd, "Detected Maven pom.xml; wrapper not found.");
+		return buildPlan(profile, "mvn", [target ?? "test"], cwd, "检测到 Maven pom.xml，但未找到 wrapper。");
 	}
 
-	throw new Error("No Java build entry found. Expected gradlew, build.gradle, mvnw, or pom.xml in workspace root.");
+	throw new Error("未找到 Java 构建入口。期望在工作区根目录看到 gradlew、build.gradle、mvnw 或 pom.xml。");
 }
 
 function planCsharpBuild(cwd: string, profile: ProductProfile, target?: string): BuildPlan {
 	const explicit = target ? resolveWorkspacePath(cwd, target) : undefined;
 	if (explicit && existsSync(explicit)) {
-		return buildPlan(profile, "dotnet", ["build", explicit], cwd, "Using explicit C# project or solution target.");
+		return buildPlan(profile, "dotnet", ["build", explicit], cwd, "使用显式指定的 C# 项目或解决方案。");
 	}
 
 	const candidates = readdirSync(cwd).filter((entry) => [".sln", ".csproj"].includes(extname(entry).toLowerCase()));
 	if (candidates.length > 0) {
-		return buildPlan(profile, "dotnet", ["build", join(cwd, candidates[0])], cwd, `Detected ${candidates[0]} for enterprise C# project.`);
+		return buildPlan(profile, "dotnet", ["build", join(cwd, candidates[0])], cwd, `检测到企业版 C# 项目文件 ${candidates[0]}。`);
 	}
 
-	throw new Error("No C# build entry found. Expected .sln or .csproj in workspace root, or pass target path.");
+	throw new Error("未找到 C# 构建入口。期望在工作区根目录看到 .sln 或 .csproj，或通过 target 指定路径。");
 }
 
 function buildPlan(profile: ProductProfile, executable: string, args: string[], cwd: string, reason: string): BuildPlan {
@@ -201,7 +201,7 @@ function buildPlan(profile: ProductProfile, executable: string, args: string[],
 }
 
 function formatBuildPlan(plan: BuildPlan): string {
-	return [`Product: ${plan.profile}`, `Reason: ${plan.reason}`, `Command: ${plan.command.display}`].join("\n");
+	return [`产品：${plan.profile}`, `原因：${plan.reason}`, `命令：${plan.command.display}`].join("\n");
 }
 
 function formatArg(value: string): string {

package/src/tools/sdk-signature.ts

@@ -46,7 +46,7 @@ export async function inspectSdkSignature(cwd: string, params: SdkSignatureParam
 			query,
 			exitCode: 2,
 			stdout: "",
-			stderr: "Provide query or className for kd_sdk_signature. method is only a filter within a matched class/type.",
+			stderr: "kd_sdk_signature 需要提供 query 或 className。method 只是在已匹配类/类型内部过滤。",
 			sources: [],
 		};
 	}
@@ -57,14 +57,14 @@ export async function inspectSdkSignature(cwd: string, params: SdkSignatureParam
 
 export function formatSdkSignatureResult(result: SdkSignatureResult): string {
 	return [
-		`Language: ${result.language}`,
-		`Query: ${result.query}`,
-		`Exit: ${result.exitCode}`,
-		result.sources.length ? `Sources:\n${result.sources.map((source) => `- ${source}`).join("\n")}` : "Sources: none",
+		`语言：${result.language}`,
+		`查询：${result.query}`,
+		`退出码：${result.exitCode}`,
+		result.sources.length ? `来源：\n${result.sources.map((source) => `- ${source}`).join("\n")}` : "来源：无",
 		result.stdout.trim() ? `\nSTDOUT:\n${result.stdout.trim()}` : undefined,
 		result.stderr.trim() ? `\nSTDERR:\n${result.stderr.trim()}` : undefined,
 		"",
-		"Use this as local SDK evidence only when Exit is 0. If it fails, use build output or project SDK configuration before trusting bundled knowledge.",
+		"只有退出码为 0 时，才能把该结果作为本地 SDK 证据。失败时，应先使用构建输出或项目 SDK 配置查证，再相信随包知识库。",
 	]
 		.filter(Boolean)
 		.join("\n");
@@ -79,7 +79,7 @@ async function inspectJavaSignature(cwd: string, params: SdkSignatureParams, que
 			query,
 			exitCode: 2,
 			stdout: "",
-			stderr: "No jar files found in the current project. Build/copy dependencies first or pass path=<sdk/lib directory>.",
+			stderr: "当前项目未找到 jar 文件。请先构建/复制依赖，或传入 path=<sdk/lib 目录>。",
 			sources: [],
 		};
 	}
@@ -91,7 +91,7 @@ async function inspectJavaSignature(cwd: string, params: SdkSignatureParams, que
 			query,
 			exitCode: 1,
 			stdout: "",
-			stderr: `No class matching "${query}" found in project jars.`,
+			stderr: `项目 jar 中未找到匹配 "${query}" 的类。`,
 			sources: jars.map((jar) => relativeOrSelf(cwd, jar)).slice(0, 20),
 		};
 	}
@@ -136,7 +136,7 @@ async function inspectCsharpSignature(cwd: string, params: SdkSignatureParams, q
 			query,
 			exitCode: 2,
 			stdout: "",
-			stderr: "No dll files found in the current project. Build/restore references first or pass path=<sdk/bin directory>.",
+			stderr: "当前项目未找到 dll 文件。请先构建/还原引用，或传入 path=<sdk/bin 目录>。",
 			sources: [],
 		};
 	}
@@ -180,7 +180,7 @@ async function inspectCsharpSignature(cwd: string, params: SdkSignatureParams, q
 			query,
 			exitCode: stdout.trim() ? 0 : 1,
 			stdout,
-			stderr: stdout.trim() ? "" : `No public type matching "${query}" found in project dlls.`,
+			stderr: stdout.trim() ? "" : `项目 dll 中未找到匹配 "${query}" 的公开类型。`,
 			sources: dlls.map((dll) => relativeOrSelf(cwd, dll)).slice(0, 20),
 		};
 	} catch (error) {