kcode-pi 0.1.14 → 0.1.15

package/src/harness/artifacts.ts

@@ -40,89 +40,89 @@ export function defaultArtifactContent(phase: KdPhase, goal?: string, profile?:
 	switch (phase) {
 		case "discuss":
 			return [
-				"# Context",
-				"",
-				`- Goal: ${goal ?? "unknown"}`,
-				`- Product: ${profile?.product ?? "unknown"}`,
-				"- Version: unknown",
-				`- Tech stack: ${profile?.techStack ?? "unknown"}`,
-				`- Language: ${profile?.language ?? "unknown"}`,
-				"- Plugin type: unknown",
-				"- Target bill/entity/form: unknown",
-				"- Out of scope: unknown",
-				"- Open questions:",
-				"  - Confirm Kingdee product/version, tech stack, plugin type, and target object.",
+				"# 需求讨论上下文",
+				"",
+				`- 需求目标：${goal ?? "未知"}`,
+				`- 金蝶产品：${profile?.product ?? "未知"}`,
+				"- 版本：未知",
+				`- 技术栈：${profile?.techStack ?? "未知"}`,
+				`- 语言：${profile?.language ?? "未知"}`,
+				"- 插件类型：未知",
+				"- 目标单据/实体/表单：未知",
+				"- 非目标范围：未知",
+				"- 待确认问题：",
+				"  - 确认金蝶产品/版本、技术栈、插件类型和目标对象。",
 				"",
 			].join("\n");
 		case "spec":
 			return [
-				"# Spec",
+				"# 需求规格",
 				"",
-				"## Acceptance Criteria",
+				"## 验收标准",
 				"",
-				"## Lifecycle / Extension Point",
+				"## 生命周期 / 扩展点",
 				"",
-				"## Data Objects and Fields",
+				"## 数据对象和字段",
 				"",
-				"## Exceptions and Performance",
+				"## 异常行为和性能约束",
 				"",
-				"## Assumptions",
+				"## 假设和风险",
 				"",
 			].join("\n");
 		case "plan":
 			return [
-				"# Plan",
+				"# 实施计划",
 				"",
-				"## Project Structure Checked",
+				"## 已检查的项目结构",
 				"",
-				"## Files to Inspect",
+				"## 需要查看的文件",
 				"",
-				"## Target Source Root / Path",
+				"## 目标源码根 / 路径",
 				"",
-				"## Files to Edit",
+				"## 允许修改的文件",
 				"",
-				"## Required Kingdee Lookups",
+				"## 必需的金蝶查证项",
 				"",
-				"## Execution Steps",
+				"## 执行步骤",
 				"",
-				"- [ ] STEP-001: Inspect the existing target files and confirm exact edit locations.",
-				"- [ ] STEP-002: Run a failing red check and record red evidence.",
-				"- [ ] STEP-003: Implement only the approved file changes.",
-				"- [ ] STEP-004: Run the same check again and record green evidence.",
-				"- [ ] STEP-005: Record changed files and step evidence.",
+				"- [ ] STEP-001：检查现有目标文件，确认精确修改位置。",
+				"- [ ] STEP-002：运行一个会失败的红灯检查，并记录红灯证据。",
+				"- [ ] STEP-003：只实现已批准的文件改动。",
+				"- [ ] STEP-004：再次运行同一检查，并记录绿灯证据。",
+				"- [ ] STEP-005：记录变更文件和步骤证据。",
 				"",
-				"## TDD / Red-Green Checks",
+				"## TDD / 红绿检查",
 				"",
-				"- Red evidence: evidence/tdd-red.md",
-				"- Green evidence: evidence/tdd-green.md",
-				"- Red/green command or tool: unknown",
-				"- Allowed checks: official API/base-class/method lookup, metadata lookup, kd_check, build/compile output, existing project test framework, or a minimal external-interface test.",
-				"- Do not add third-party test jars or frameworks just to satisfy this gate.",
-				"- If automated tests are impossible, document the product-specific check that can fail before implementation and pass after implementation.",
+				"- 红灯证据：evidence/tdd-red.md",
+				"- 绿灯证据：evidence/tdd-green.md",
+				"- 红绿检查命令或工具：未知",
+				"- 允许的检查：官方 API/基类/方法签名查证、元数据查证、kd_check、构建/编译输出、项目已有测试框架、外部接口最小验证。",
+				"- 不要为了满足门禁引入第三方测试 jar 或框架。",
+				"- 如果无法自动化测试，记录一个产品相关、实现前应失败且实现后应通过的检查。",
 				"",
-				"## Validation Commands",
+				"## 验证命令",
 				"",
-				"## Rollback / Containment",
+				"## 回滚 / 影响控制",
 				"",
 			].join("\n");
 		case "execute":
 			return [
-				"# Execution",
+				"# 执行记录",
 				"",
-				"## Step Results",
+				"## 步骤结果",
 				"",
-				"Record each planned step as:",
+				"每个计划步骤按以下格式记录：",
 				"",
-				"- [x] STEP-001: completed. Evidence: evidence/step-001.md",
+				"- [x] STEP-001：已完成。证据：evidence/step-001.md",
 				"",
-				"## Changed Files",
+				"## 变更文件",
 				"",
-				"## Deviations",
+				"## 偏离计划说明",
 				"",
 			].join("\n");
 		case "verify":
-			return ["# Verify", "", "## Commands", "", "## Evidence", "", "## Residual Risk", ""].join("\n");
+			return ["# 验证记录", "", "## 命令", "", "## 证据", "", "## 残余风险", ""].join("\n");
 		case "ship":
-			return ["# Ship", "", "## Summary", "", "## Verification Evidence", "", "## Risks", "", "## Follow-ups", ""].join("\n");
+			return ["# 交付摘要", "", "## 摘要", "", "## 验证证据", "", "## 风险", "", "## 后续事项", ""].join("\n");
 	}
 }

package/src/harness/format.ts

@@ -7,25 +7,25 @@ import { formatProductProfile } from "../product/profile.ts";
 
 export function formatStatus(cwd: string, run: ActiveRun | undefined): string {
 	if (!run) {
-		return ["No active Kingdee harness run.", "", "Start one with:", "/kd-start <goal>"].join("\n");
+		return ["当前没有 active Kingdee Harness run。", "", "创建方式：", "/kd-start <需求>"].join("\n");
 	}
 
 	const refreshed = refreshGate(cwd, run);
 	const next = nextPhase(refreshed.phase) ?? "done";
 
 	return [
-		`Run: ${refreshed.id}`,
-		refreshed.goal ? `Goal: ${refreshed.goal}` : undefined,
-		`Status: ${refreshed.status ?? "active"}`,
-		`Phase: ${refreshed.phase}`,
-		`Next: ${next}`,
-		`Product: ${formatProductProfile(refreshed.profile)}`,
-		`Version: ${refreshed.version ?? "unselected"}`,
-		`Risk: ${refreshed.risk ?? "unknown"}`,
-		`Gate: ${refreshed.gate.passed ? "pass" : "blocked"}`,
-		refreshed.gate.reason ? `Reason: ${refreshed.gate.reason}` : undefined,
+		`Run：${refreshed.id}`,
+		refreshed.goal ? `需求：${refreshed.goal}` : undefined,
+		`状态：${refreshed.status ?? "active"}`,
+		`阶段：${refreshed.phase}`,
+		`下一阶段：${next}`,
+		`产品：${formatProductProfile(refreshed.profile)}`,
+		`版本：${refreshed.version ?? "未选择"}`,
+		`风险：${refreshed.risk ?? "未知"}`,
+		`门禁：${refreshed.gate.passed ? "通过" : "阻塞"}`,
+		refreshed.gate.reason ? `原因：${refreshed.gate.reason}` : undefined,
 		"",
-		`Run directory: ${join(runsDir(cwd), refreshed.id)}`,
+		`Run 目录：${join(runsDir(cwd), refreshed.id)}`,
 	]
 		.filter(Boolean)
 		.join("\n");

package/src/harness/gates.ts

@@ -7,9 +7,9 @@ import { executionStepsBlockReason, planStepsBlockReason } from "./plan-steps.ts
 import { tddPlanBlockReason, tddVerifyBlockReason } from "./tdd-policy.ts";
 
 const REQUIRED_MARKERS: Partial<Record<KdPhase, string[]>> = {
-	plan: ["## Validation Commands"],
-	verify: ["## Evidence"],
-	ship: ["## Verification Evidence"],
+	plan: ["## 验证命令"],
+	verify: ["## 证据"],
+	ship: ["## 验证证据"],
 };
 
 const COSMIC_CONFIG_EVIDENCE = "evidence/cosmic-config.txt";
@@ -162,12 +162,12 @@ function requiredEvidenceForPhase(cwd: string, run: ActiveRun, phase: KdPhase):
 
 function planHasMetadataRequirement(cwd: string, run: ActiveRun): boolean {
 	const plan = readArtifact(cwd, run, "plan") ?? "";
-	return /kd_cosmic_metadata|cosmic-metadata|metadata evidence|元数据|字段验证|字段确认|字段元数据/i.test(plan);
+	return /kd_cosmic_metadata|cosmic-metadata|cosmic-metadata\.json|metadata evidence|字段元数据证据|元数据证据/i.test(plan);
 }
 
 function planHasApiRequirement(cwd: string, run: ActiveRun): boolean {
 	const plan = readArtifact(cwd, run, "plan") ?? "";
-	return /kd_sdk_signature|kd_cosmic_api|cosmic-api|api signature|method signature|sdk.*签名|方法签名|接口签名/i.test(plan);
+	return /kd_sdk_signature|kd_cosmic_api|cosmic-api|cosmic-api\.txt|api signature evidence|method signature evidence|SDK 签名证据|方法签名证据|接口签名证据/i.test(plan);
 }
 
 function runHasKsqlDelivery(cwd: string, run: ActiveRun): boolean {

package/src/harness/plan-steps.ts

@@ -20,13 +20,13 @@ export function parsePlanSteps(plan: string): PlanStep[] {
 }
 
 export function planStepsBlockReason(plan: string): string | undefined {
-	if (!/##\s*Execution Steps/i.test(plan)) {
-		return "PLAN.md 缺少 ## Execution Steps。必须把计划拆成 STEP-001 这种可跟踪步骤。";
+	if (!/##\s*执行步骤/i.test(plan)) {
+		return "PLAN.md 缺少 ## 执行步骤。必须把计划拆成 STEP-001 这种可跟踪步骤。";
 	}
 
 	const steps = parsePlanSteps(plan);
 	if (steps.length === 0) {
-		return "PLAN.md 没有可执行步骤。请使用 `- [ ] STEP-001: ...` 列出步骤。";
+		return "PLAN.md 没有可执行步骤。请使用 `- [ ] STEP-001：...` 列出步骤。";
 	}
 
 	const duplicate = firstDuplicate(steps.map((step) => step.id));

package/src/harness/state.ts

@@ -84,7 +84,7 @@ export function createActiveRun(cwd: string, goal: string, productInput?: string
 		questions: [],
 		gate: {
 			passed: false,
-			reason: "CONTEXT.md and product profile are required before moving to spec",
+			reason: "进入 spec 前必须先完成 CONTEXT.md 并确认产品画像",
 			checkedAt: new Date().toISOString(),
 		},
 	};
@@ -161,21 +161,21 @@ export function updatePhaseArtifact(cwd: string, run: ActiveRun, phase: KdPhase,
 export function advanceRun(cwd: string, run: ActiveRun, requestedPhase?: KdPhase): { run: ActiveRun; message: string } {
 	const target = requestedPhase ?? nextPhase(run.phase);
 	if (!target) {
-		return { run, message: `Run is already at final phase: ${run.phase}` };
+		return { run, message: `Run 已处于最终阶段：${run.phase}` };
 	}
 
 	const gate = canEnterPhase(cwd, run, target);
 	if (!gate.passed) {
 		run.gate = gate;
 		writeActiveRun(cwd, run);
-		return { run, message: gate.reason ?? `Cannot enter ${target}` };
+		return { run, message: gate.reason ?? `不能进入 ${target}` };
 	}
 
 	run.phase = target;
 	ensurePhaseArtifact(cwd, run, target);
 	run.gate = inspectGate(cwd, run);
 	writeActiveRun(cwd, run);
-	return { run, message: `Advanced Kingdee run to phase: ${target}` };
+	return { run, message: `已推进 Kingdee run 到阶段：${target}` };
 }
 
 export function refreshGate(cwd: string, run: ActiveRun): ActiveRun {

package/src/harness/tdd-policy.ts

@@ -8,8 +8,8 @@ export const TDD_RED_EVIDENCE = "evidence/tdd-red.md";
 export const TDD_GREEN_EVIDENCE = "evidence/tdd-green.md";
 
 export function tddPlanBlockReason(plan: string): string | undefined {
-	if (/##\s*TDD\s*\/\s*Red-Green Checks/i.test(plan)) return undefined;
-	return "PLAN.md 缺少 ## TDD / Red-Green Checks。必须声明红灯验证、绿灯验证和无法自动化时的产品验证替代方案。";
+	if (/##\s*TDD\s*\/\s*红绿检查/i.test(plan)) return undefined;
+	return "PLAN.md 缺少 ## TDD / 红绿检查。必须声明红灯验证、绿灯验证和无法自动化时的产品验证替代方案。";
 }
 
 export function tddProductionWriteBlockReason(cwd: string, run: ActiveRun | undefined, path: string | undefined): string | undefined {

package/src/knowledge/format.ts

@@ -3,15 +3,15 @@ import type { SearchResult, TableSchema } from "./types.ts";
 
 export function formatSearchResults(query: string, results: SearchResult[], basePath: string): string {
 	if (results.length === 0) {
-		return `No Kingdee knowledge results found for "${query}".`;
+		return `未找到与 "${query}" 相关的金蝶知识库结果。`;
 	}
 
-	const lines = [`Kingdee knowledge results for "${query}":`, ""];
+	const lines = [`"${query}" 的金蝶知识库结果：`, ""];
 	for (let i = 0; i < results.length; i++) {
 		const result = results[i];
 		lines.push(`[${i + 1}] ${result.section.heading}`);
-		lines.push(`Source: ${relative(basePath, result.file.path)}:${result.section.lineStart + 1}`);
-		lines.push(`Score: ${result.score.toFixed(2)}`);
+		lines.push(`来源：${relative(basePath, result.file.path)}:${result.section.lineStart + 1}`);
+		lines.push(`相关度：${result.score.toFixed(2)}`);
 		lines.push(result.highlights[0] || result.section.content.trim().split("\n").slice(0, 5).join("\n"));
 		lines.push("");
 	}
@@ -20,24 +20,24 @@ export function formatSearchResults(query: string, results: SearchResult[], base
 
 export function formatTableSchema(tableName: string, schema: TableSchema | undefined): string {
 	if (!schema) {
-		return `No table schema found for "${tableName}".`;
+		return `未找到 "${tableName}" 的表结构。`;
 	}
 
 	const lines = [
-		`Table: ${schema.name} (${tableName.toUpperCase()})`,
-		`Module: ${schema.module || "unknown"}`,
-		`Description: ${schema.description || "none"}`,
+		`表：${schema.name} (${tableName.toUpperCase()})`,
+		`模块：${schema.module || "未知"}`,
+		`说明：${schema.description || "无"}`,
 		"",
-		"Fields:",
+		"字段：",
 	];
 
 	for (const field of schema.fields) {
-		const nullable = field.nullable ? "nullable" : "required";
+		const nullable = field.nullable ? "可空" : "必填";
 		lines.push(`- ${field.name} ${field.type} ${nullable} - ${field.description}`);
 	}
 
 	if (schema.relatedTables.length > 0) {
-		lines.push("", "Related tables:");
+		lines.push("", "相关表：");
 		for (const related of schema.relatedTables) {
 			lines.push(`- ${related.table}: ${related.relation} - ${related.description}`);
 		}
@@ -45,4 +45,3 @@ export function formatTableSchema(tableName: string, schema: TableSchema | undef
 
 	return lines.join("\n");
 }
-

package/src/product/profile.ts

@@ -24,61 +24,61 @@ const PROFILES: Record<KdProduct, ProductProfile> = {
 		language: "unknown",
 		knowledgeScope: "common",
 		requiresMetadataVerification: true,
-		notes: ["Product is not selected; do not assume Java, C#, BOS, Cosmic, or KSQL rules."],
+		notes: ["尚未选择产品；不要假设 Java、C#、BOS、Cosmic 或 KSQL 规则。"],
 	},
 	flagship: {
 		product: "flagship",
-		displayName: "Kingdee Xingkong Flagship",
+		displayName: "金蝶星空旗舰版",
 		platform: "cosmic",
 		techStack: "java-cosmic",
 		language: "java",
 		knowledgeScope: "flagship",
 		requiresMetadataVerification: true,
 		notes: [
-			"Xingkong Flagship is Cosmic-family. Use Cosmic metadata, plugin lifecycle, SDK, and post-check constraints.",
-			"Place product code under the workspace code/ directory when that directory exists.",
-			"Before creating or editing code, inspect the existing project structure under code/ and follow its actual layout, whether it is organized by cloud, app, or no module split.",
+			"星空旗舰版属于 Cosmic 家族。使用 Cosmic 元数据、插件生命周期、SDK 和后置检查约束。",
+			"如果当前工作区存在 code/ 目录，产品代码应放在 code/ 下。",
+			"创建或编辑代码前，必须检查 code/ 下真实项目结构，并跟随其实际布局；可能按云、按应用组织，也可能不分模块。",
 		],
 	},
 	cosmic: {
 		product: "cosmic",
-		displayName: "Kingdee Cosmic Platform",
+		displayName: "金蝶 Cosmic 平台",
 		platform: "cosmic",
 		techStack: "java-cosmic",
 		language: "java",
 		knowledgeScope: "cosmic",
 		requiresMetadataVerification: true,
-		notes: ["Cosmic is the shared platform base for Cangqiong, Xinghan, and Xingkong Flagship."],
+		notes: ["Cosmic 是苍穹、星瀚和星空旗舰版的共享平台基础。"],
 	},
 	xinghan: {
 		product: "xinghan",
-		displayName: "Kingdee Xinghan",
+		displayName: "金蝶星瀚",
 		platform: "cosmic",
 		techStack: "java-cosmic",
 		language: "java",
 		knowledgeScope: "xinghan",
 		requiresMetadataVerification: true,
-		notes: ["Treat as Cosmic-family Java unless a Xinghan-specific rule overrides it."],
+		notes: ["除非存在星瀚特有规则，否则按 Cosmic 家族 Java 处理。"],
 	},
 	cangqiong: {
 		product: "cangqiong",
-		displayName: "Kingdee Cangqiong",
+		displayName: "金蝶苍穹",
 		platform: "cosmic",
 		techStack: "java-cosmic",
 		language: "java",
 		knowledgeScope: "cangqiong",
 		requiresMetadataVerification: true,
-		notes: ["Use Cangqiong/Cosmic plugin, SDK, metadata, KSQL, and lifecycle rules."],
+		notes: ["使用苍穹/Cosmic 插件、SDK、元数据、KSQL 和生命周期规则。"],
 	},
 	enterprise: {
 		product: "enterprise",
-		displayName: "Kingdee Enterprise",
+		displayName: "金蝶企业版",
 		platform: "enterprise-csharp",
 		techStack: "csharp-bos",
 		language: "csharp",
 		knowledgeScope: "enterprise",
 		requiresMetadataVerification: true,
-		notes: ["Use enterprise C# stack. Java plugin rules and Cosmic APIs are not applicable."],
+		notes: ["使用企业版 C# 技术栈。Java 插件规则和 Cosmic API 不适用。"],
 	},
 };
 
@@ -101,9 +101,9 @@ function enterprisePythonProfile(): ProductProfile {
 		language: "python",
 		knowledgeScope: "enterprise-python",
 		notes: [
-			"Use Kingdee Cloud Enterprise / BOS IronPython plugin patterns only when the user explicitly asks for Python plugin or IronPython script.",
-			"Default Enterprise plugin work remains C# unless Python plugin is explicitly requested.",
-			"Python plugins run in BOS through IronPython and call Kingdee.BOS .NET assemblies; verify plugin type, event, FormId, field keys, and registration steps before coding.",
+			"只有用户明确要求 Python 插件或 IronPython 脚本时，才使用金蝶云企业版 / BOS IronPython 插件模式。",
+			"企业版默认插件开发仍按 C# 处理，除非用户明确要求 Python 插件。",
+			"Python 插件通过 BOS 中的 IronPython 运行，并调用 Kingdee.BOS .NET 程序集；编码前必须确认插件类型、事件、FormId、字段标识和注册步骤。",
 		],
 	};
 }

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 {