kcode-pi 0.1.14 → 0.1.16

package/extensions/kingdee-harness.ts

@@ -18,6 +18,7 @@ import {
 } from "../src/harness/state.ts";
 import { readArtifact } from "../src/harness/artifacts.ts";
 import { flagshipWriteBlockReason, isSourceLikePath, planWriteBlockReason } from "../src/harness/path-policy.ts";
+import { sdkSignatureProductionWriteBlockReason } from "../src/harness/sdk-policy.ts";
 import { tddProductionWriteBlockReason } from "../src/harness/tdd-policy.ts";
 import { readProjectContext } from "../src/context/project-context.ts";
 import { windowsPathHint } from "../src/platform/path.ts";
@@ -84,7 +85,7 @@ function sendWorkflowPrompt(pi: ExtensionAPI, ctx: ExtensionContext, run: NonNul
 		return;
 	}
 	pi.sendUserMessage(prompt, { deliverAs: "followUp" });
-	if (ctx.hasUI) ctx.ui.notify("KCode harness message queued.", "info");
+	if (ctx.hasUI) ctx.ui.notify("KCode 工作流消息已排队。", "info");
 }
 
 function workflowPromptForRun(cwd: string, run: NonNullable<ReturnType<typeof readActiveRun>>, userText: string): string {
@@ -123,9 +124,11 @@ function workflowPromptForRun(cwd: string, run: NonNullable<ReturnType<typeof re
 		"",
 		phaseGuidance[run.phase],
 		"必须先理解当前业务项目已有目录、模块、包名、基类和本地封装，再决定文件位置和实现方式。",
+		"禁止凭记忆、模型知识或随包知识库直接编写 SDK 方法调用。Java/C# 代码中出现的 SDK 类、方法、构造器、枚举和属性，必须来自 kd_sdk_signature 对当前项目 jar/dll 的成功结果、项目构建输出或官方元数据证据。",
+		"kd_search、kd_cosmic_api 和随包知识只能用于找线索；没有 evidence/sdk-signature.md 或明确构建证据时，不得进入 execute，也不得写生产源码。",
 		"路径规则：在 Windows 工作区内，优先使用项目相对路径；如需绝对路径必须使用 `D:\\...` 这类 Windows 路径，禁止把路径改写成 `/mnt/d/...`、`/d/...` 等 WSL/MSYS 风格路径。",
 		"execute 阶段只能写 PLAN.md 明确列出的源码文件；如果目标文件不在计划内，必须先回到 plan 更新 PLAN.md。",
-		"写生产源码前必须先有红灯证据 evidence/tdd-red.md；红绿证据可以是 kd_sdk_signature 本地 SDK 签名、API/基类/方法签名、元数据、编译、既有测试框架或外部接口最小验证，不要为了测试引入额外 jar。",
+		"写生产源码前必须先有红灯证据 evidence/tdd-red.md；Java/C# 还必须有 SDK 签名证据 evidence/sdk-signature.md。红绿证据可以是 kd_sdk_signature 本地 SDK 签名、API/基类/方法签名、元数据、编译、既有测试框架或外部接口最小验证，不要为了测试引入额外 jar。",
 	].join("\n");
 }
 
@@ -158,13 +161,17 @@ function codeWriteBlockReason(cwd: string, path: string | undefined): string | u
 		return `当前 KCode 阶段是 ${run.phase}，不能写产品代码。请先完成 discuss -> spec -> plan 并进入 execute。`;
 	}
 
-	return tddProductionWriteBlockReason(cwd, run, path) ?? planWriteBlockReason(cwd, run, path, readArtifact(cwd, run, "plan") ?? "");
+	return (
+		sdkSignatureProductionWriteBlockReason(cwd, run, path) ??
+		tddProductionWriteBlockReason(cwd, run, path) ??
+		planWriteBlockReason(cwd, run, path, readArtifact(cwd, run, "plan") ?? "")
+	);
 }
 
 const kdPlanStatusTool = defineTool({
 	name: "kd_plan_status",
-	label: "KD Status",
-	description: "Inspect the active Kingdee Harness Engineering run, current phase, required artifacts, and gate status.",
+	label: "KD 状态",
+	description: "查看当前金蝶 Harness run、当前阶段、必需文档和门禁状态。",
 	parameters: Type.Object({}),
 
 	async execute(_toolCallId, _params, _signal, _onUpdate, ctx) {
@@ -178,24 +185,24 @@ const kdPlanStatusTool = defineTool({
 
 const kdQuestionTool = defineTool({
 	name: "kd_question",
-	label: "KD Question",
+	label: "KD 问题",
 	description:
-		"Create, answer, or list structured Kingdee Harness questions. Ask exactly one short blocking question at a time; do not batch a checklist.",
+		"创建、回答或列出金蝶 Harness 结构化问题。每次只能问一个最阻塞的短问题，不要批量列清单。",
 	parameters: Type.Object({
-		action: Type.Optional(Type.String({ description: "ask, answer, or list. Defaults to ask." })),
-		id: Type.Optional(Type.String({ description: "Question id when action=answer, for example Q-001." })),
-		question: Type.Optional(Type.String({ description: "One short question to ask when action=ask. No numbered lists or multiple questions." })),
-		answer: Type.Optional(Type.String({ description: "User answer when action=answer." })),
-		reason: Type.Optional(Type.String({ description: "Why this question blocks or matters." })),
-		choices: Type.Optional(Type.Array(Type.String(), { description: "Optional concrete choices for the user, maximum 3 short labels." })),
-		blocking: Type.Optional(Type.Boolean({ description: "Whether the question blocks phase advancement. Defaults to true." })),
+		action: Type.Optional(Type.String({ description: "操作类型：ask、answer 或 list，默认 ask。" })),
+		id: Type.Optional(Type.String({ description: "回答问题时的问题编号，例如 Q-001。" })),
+		question: Type.Optional(Type.String({ description: "提问内容。只能是一个短问题，不要写编号清单或多个问题。" })),
+		answer: Type.Optional(Type.String({ description: "用户答案，action=answer 时使用。" })),
+		reason: Type.Optional(Type.String({ description: "说明为什么这个问题会阻塞当前阶段。" })),
+		choices: Type.Optional(Type.Array(Type.String(), { description: "可选项，最多 3 个简短选项。" })),
+		blocking: Type.Optional(Type.Boolean({ description: "是否阻塞阶段推进，默认 true。" })),
 	}),
 
 	async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
 		const run = readActiveRun(ctx.cwd);
 		if (!run) {
 			return {
-				content: [{ type: "text", text: "No active Kingdee harness run. Start one with /kd-start <goal> first." }],
+				content: [{ type: "text", text: "当前没有 active Kingdee Harness run。请先使用 /kd-start <需求> 创建。" }],
 				details: { error: "no-active-run" },
 			};
 		}
@@ -209,34 +216,34 @@ const kdQuestionTool = defineTool({
 		if (action === "answer") {
 			if (!params.id || !params.answer) {
 				return {
-					content: [{ type: "text", text: "kd_question action=answer requires id and answer." }],
+					content: [{ type: "text", text: "kd_question action=answer 需要同时提供 id 和 answer。" }],
 					details: { error: "missing-answer-params" },
 				};
 			}
 			const answered = answerQuestion(ctx.cwd, run, params.id, params.answer);
 			if (!answered) {
 				return {
-					content: [{ type: "text", text: `Question not found: ${params.id}` }],
+					content: [{ type: "text", text: `未找到问题：${params.id}` }],
 					details: { error: "question-not-found", id: params.id },
 				};
 			}
-			appendQuestionEventToArtifact(ctx.cwd, run, [`- Answered ${answered.id}: ${answered.answer}`]);
+			appendQuestionEventToArtifact(ctx.cwd, run, [`- 已回答 ${answered.id}：${answered.answer}`]);
 			return {
-				content: [{ type: "text", text: `Recorded answer for ${answered.id}. Gate refreshed.` }],
+				content: [{ type: "text", text: `已记录 ${answered.id} 的答案，并刷新门禁。` }],
 				details: { question: answered, gate: readActiveRun(ctx.cwd)?.gate },
 			};
 		}
 
 		if (action !== "ask") {
 			return {
-				content: [{ type: "text", text: `Unknown kd_question action: ${params.action}. Use ask, answer, or list.` }],
+				content: [{ type: "text", text: `未知 kd_question action：${params.action}。请使用 ask、answer 或 list。` }],
 				details: { error: "unknown-action", action: params.action },
 			};
 		}
 
 		if (!params.question?.trim()) {
 			return {
-				content: [{ type: "text", text: "kd_question action=ask requires question." }],
+				content: [{ type: "text", text: "kd_question action=ask 需要提供 question。" }],
 				details: { error: "missing-question" },
 			};
 		}
@@ -272,15 +279,15 @@ const kdQuestionTool = defineTool({
 		if (interactiveAnswer) {
 			const answered = answerQuestion(ctx.cwd, run, question.id, interactiveAnswer);
 			if (answered) {
-				appendQuestionEventToArtifact(ctx.cwd, run, [`- Answered ${answered.id}: ${answered.answer}`]);
+				appendQuestionEventToArtifact(ctx.cwd, run, [`- 已回答 ${answered.id}：${answered.answer}`]);
 				return {
-					content: [{ type: "text", text: `User answered ${answered.id}: ${answered.answer}` }],
+					content: [{ type: "text", text: `用户已回答 ${answered.id}：${answered.answer}` }],
 					details: { question: answered, gate: readActiveRun(ctx.cwd)?.gate, answered: true },
 				};
 			}
 		}
 
-		const text = `${formatQuestionCard(question)}\n\nInteractive answer was not provided; keep this question open until the user answers.`;
+		const text = `${formatQuestionCard(question)}\n\n未获得交互式答案；在用户回答前，该问题会保持 open。`;
 		return { content: [{ type: "text", text }], details: { question, gate: readActiveRun(ctx.cwd)?.gate, answered: false } };
 	},
 });
@@ -309,7 +316,7 @@ export default function (pi: ExtensionAPI) {
 		if (!run && shouldStartHarnessFromInput(event.text)) {
 			run = createActiveRun(ctx.cwd, event.text);
 			if (ctx.hasUI) {
-				ctx.ui.notify(`Started Kingdee harness run: ${run.id} (${run.profile?.product}/${run.profile?.techStack})`, "info");
+				ctx.ui.notify(`已启动 Kingdee Harness run：${run.id}（${run.profile?.product}/${run.profile?.techStack}）`, "info");
 			}
 		}
 
@@ -341,14 +348,14 @@ export default function (pi: ExtensionAPI) {
 	});
 
 	pi.registerCommand("kd-status", {
-		description: "Show the active Kingdee harness run and gate status",
+		description: "查看当前 Kingdee Harness run 和门禁状态",
 		handler: async (_args, ctx) => {
 			ctx.ui.notify(formatStatus(ctx.cwd, readActiveRun(ctx.cwd)), "info");
 		},
 	});
 
 	pi.registerCommand("kd-runs", {
-		description: "List Kingdee harness runs for this project",
+		description: "列出当前项目的 Kingdee Harness run",
 		handler: async (_args, ctx) => {
 			const active = readActiveRun(ctx.cwd);
 			ctx.ui.notify(formatRuns(listRuns(ctx.cwd), active?.id), "info");
@@ -356,46 +363,46 @@ export default function (pi: ExtensionAPI) {
 	});
 
 	pi.registerCommand("kd-gate", {
-		description: "Refresh and show the active Kingdee harness gate",
+		description: "刷新并查看当前 Kingdee Harness 门禁",
 		handler: async (_args, ctx) => {
 			const run = requireRun(ctx.cwd);
 			if (!run) {
-				ctx.ui.notify("No active Kingdee harness run. Use /kd-start <goal>.", "error");
+				ctx.ui.notify("当前没有 active Kingdee Harness run。请使用 /kd-start <需求>。", "error");
 				return;
 			}
 			const refreshed = refreshGate(ctx.cwd, run);
-			ctx.ui.notify(refreshed.gate.passed ? "Gate passed" : `Gate blocked: ${refreshed.gate.reason}`, "info");
+			ctx.ui.notify(refreshed.gate.passed ? "门禁通过" : `门禁阻塞：${refreshed.gate.reason}`, "info");
 		},
 	});
 
 	pi.registerCommand("kd-start", {
-		description: "Start a Kingdee harness run: /kd-start [--product product] [--version version] <goal>",
+		description: "启动一个 Kingdee Harness run：/kd-start [--product 产品] [--version 版本] <需求>",
 		handler: async (args, ctx) => {
 			const parsed = parseStartArgs(args);
 			const goal = parsed.goal;
 			if (!goal) {
-				ctx.ui.notify("Usage: /kd-start [--product product] [--version version] <goal>", "error");
+				ctx.ui.notify("用法：/kd-start [--product 产品] [--version 版本] <需求>", "error");
 				return;
 			}
 
 			const run = createActiveRun(ctx.cwd, goal, parsed.product, parsed.version);
-			ctx.ui.notify(`Started Kingdee harness run: ${run.id} (${run.profile?.product}/${run.profile?.techStack})`, "info");
+			ctx.ui.notify(`已启动 Kingdee Harness run：${run.id}（${run.profile?.product}/${run.profile?.techStack}）`, "info");
 			sendWorkflowPrompt(pi, ctx, run, `继续 KCode Harness run ${run.id}：${goal}`);
 		},
 	});
 
 	pi.registerCommand("kd-resume", {
-		description: "Resume the active Kingdee harness run and inject persisted context",
+		description: "接续当前 Kingdee Harness run，并注入已落盘上下文",
 		handler: async (args, ctx) => {
 			const run = requireRun(ctx.cwd);
 			if (!run) {
-				ctx.ui.notify("No active Kingdee harness run. Use /kd-start <goal> or /kd-runs.", "error");
+				ctx.ui.notify("当前没有 active Kingdee Harness run。请使用 /kd-start <需求> 或 /kd-runs。", "error");
 				return;
 			}
 
 			const note = args.trim();
 			const message = [
-				`继续 KCode Harness run ${run.id}：${run.goal ?? "unknown goal"}`,
+				`继续 KCode Harness run ${run.id}：${run.goal ?? "未知需求"}`,
 				note ? `用户补充：${note}` : undefined,
 			]
 				.filter(Boolean)
@@ -405,64 +412,64 @@ export default function (pi: ExtensionAPI) {
 	});
 
 	pi.registerCommand("kd-switch", {
-		description: "Switch active Kingdee harness run: /kd-switch <run-id>",
+		description: "切换当前 active Kingdee Harness run：/kd-switch <run-id>",
 		handler: async (args, ctx) => {
 			const id = args.trim();
 			if (!id) {
-				ctx.ui.notify("Usage: /kd-switch <run-id>", "error");
+				ctx.ui.notify("用法：/kd-switch <run-id>", "error");
 				return;
 			}
 
 			const run = switchActiveRun(ctx.cwd, id);
 			if (!run) {
-				ctx.ui.notify(`Kingdee harness run not found: ${id}. Use /kd-runs to list runs.`, "error");
+				ctx.ui.notify(`未找到 Kingdee Harness run：${id}。请用 /kd-runs 查看列表。`, "error");
 				return;
 			}
 
-			ctx.ui.notify(`Switched active Kingdee harness run: ${run.id} (${run.phase})`, "info");
+			ctx.ui.notify(`已切换 active Kingdee Harness run：${run.id}（${run.phase}）`, "info");
 		},
 	});
 
 	pi.registerCommand("kd-finish", {
-		description: "Mark the active Kingdee harness run as done and clear active run",
+		description: "标记当前 Kingdee Harness run 完成，并清除 active run",
 		handler: async (_args, ctx) => {
 			const run = requireRun(ctx.cwd);
 			if (!run) {
-				ctx.ui.notify("No active Kingdee harness run. Use /kd-start <goal>.", "error");
+				ctx.ui.notify("当前没有 active Kingdee Harness run。请使用 /kd-start <需求>。", "error");
 				return;
 			}
 
 			const finished = finishActiveRun(ctx.cwd, run);
-			ctx.ui.notify(`Finished Kingdee harness run: ${finished.id}. Start the next feature with /kd-start <goal>.`, "info");
+			ctx.ui.notify(`已完成 Kingdee Harness run：${finished.id}。下一个功能点请使用 /kd-start <需求>。`, "info");
 		},
 	});
 
 	pi.registerCommand("kd-product", {
-		description: "Set the active Kingdee product profile: /kd-product <flagship|cosmic|xinghan|cangqiong|enterprise> [--version version]",
+		description: "设置当前金蝶产品画像：/kd-product <flagship|cosmic|xinghan|cangqiong|enterprise> [--version 版本]",
 		handler: async (args, ctx) => {
 			const run = requireRun(ctx.cwd);
 			if (!run) {
-				ctx.ui.notify("No active Kingdee harness run. Use /kd-start <goal>.", "error");
+				ctx.ui.notify("当前没有 active Kingdee Harness run。请使用 /kd-start <需求>。", "error");
 				return;
 			}
 
 			const parsed = parseProductArgs(args);
 			if (!parsed) {
-				ctx.ui.notify("Usage: /kd-product <flagship|cosmic|xinghan|cangqiong|enterprise> [--version version]", "error");
+				ctx.ui.notify("用法：/kd-product <flagship|cosmic|xinghan|cangqiong|enterprise> [--version 版本]", "error");
 				return;
 			}
 
 			const updated = updateProductProfile(ctx.cwd, run, parsed.product, parsed.version);
-			ctx.ui.notify(`Product profile: ${updated.profile?.product}/${updated.profile?.techStack}/${updated.profile?.language}`, "info");
+			ctx.ui.notify(`产品画像：${updated.profile?.product}/${updated.profile?.techStack}/${updated.profile?.language}`, "info");
 		},
 	});
 
 	pi.registerCommand("kd-advance", {
-		description: `Advance Kingdee run to the next phase or a named phase: ${PHASE_ORDER.join("|")}`,
+		description: `推进 Kingdee run 到下一阶段，或指定阶段：${PHASE_ORDER.join("|")}`,
 		handler: async (args, ctx) => {
 			const run = requireRun(ctx.cwd);
 			if (!run) {
-				ctx.ui.notify("No active Kingdee harness run. Use /kd-start <goal>.", "error");
+				ctx.ui.notify("当前没有 active Kingdee Harness run。请使用 /kd-start <需求>。", "error");
 				return;
 			}
 
@@ -470,7 +477,7 @@ export default function (pi: ExtensionAPI) {
 			let requested: KdPhase | undefined;
 			if (requestedText) {
 				if (!isKdPhase(requestedText)) {
-					ctx.ui.notify(`Unknown phase "${requestedText}". Valid phases: ${PHASE_ORDER.join(", ")}`, "error");
+					ctx.ui.notify(`未知阶段 "${requestedText}"。可用阶段：${PHASE_ORDER.join(", ")}`, "error");
 					return;
 				}
 				requested = requestedText;
@@ -482,67 +489,67 @@ export default function (pi: ExtensionAPI) {
 	});
 
 	pi.registerCommand("kd-artifact", {
-		description: "Create or update a phase artifact: /kd-artifact [phase] [content]",
+		description: "创建或更新阶段文档：/kd-artifact [阶段] [内容]",
 		handler: async (args, ctx) => {
 			const run = requireRun(ctx.cwd);
 			if (!run) {
-				ctx.ui.notify("No active Kingdee harness run. Use /kd-start <goal>.", "error");
+				ctx.ui.notify("当前没有 active Kingdee Harness run。请使用 /kd-start <需求>。", "error");
 				return;
 			}
 
 			const parsed = parseArtifactArgs(args, run.phase);
 			if (!parsed) {
-				ctx.ui.notify("Usage: /kd-artifact [phase] [content]", "error");
+				ctx.ui.notify("用法：/kd-artifact [阶段] [内容]", "error");
 				return;
 			}
 
 			const path = parsed.content
 				? updatePhaseArtifact(ctx.cwd, run, parsed.phase, parsed.content)
 				: ensurePhaseArtifact(ctx.cwd, run, parsed.phase);
-			ctx.ui.notify(`Artifact ready: ${path}`, "info");
+			ctx.ui.notify(`阶段文档已就绪：${path}`, "info");
 		},
 	});
 
 	pi.registerCommand("kd-answer", {
-		description: "Answer a blocking Kingdee harness question: /kd-answer Q-001 <answer>",
+		description: "回答一个阻塞中的 Kingdee Harness 问题：/kd-answer Q-001 <答案>",
 		handler: async (args, ctx) => {
 			const run = requireRun(ctx.cwd);
 			if (!run) {
-				ctx.ui.notify("No active Kingdee harness run. Use /kd-start <goal>.", "error");
+				ctx.ui.notify("当前没有 active Kingdee Harness run。请使用 /kd-start <需求>。", "error");
 				return;
 			}
 			const [id, ...answerParts] = args.trim().split(/\s+/);
 			const answer = answerParts.join(" ").trim();
 			if (!id || !answer) {
-				ctx.ui.notify("Usage: /kd-answer Q-001 <answer>", "error");
+				ctx.ui.notify("用法：/kd-answer Q-001 <答案>", "error");
 				return;
 			}
 			const answered = answerQuestion(ctx.cwd, run, id, answer);
 			if (!answered) {
-				ctx.ui.notify(`Question not found: ${id}`, "error");
+				ctx.ui.notify(`未找到问题：${id}`, "error");
 				return;
 			}
-			appendQuestionEventToArtifact(ctx.cwd, run, [`- Answered ${answered.id}: ${answered.answer}`]);
-			ctx.ui.notify(`Recorded answer for ${answered.id}`, "info");
+			appendQuestionEventToArtifact(ctx.cwd, run, [`- 已回答 ${answered.id}：${answered.answer}`]);
+			ctx.ui.notify(`已记录 ${answered.id} 的答案`, "info");
 		},
 	});
 }
 
 function formatQuestions(run: NonNullable<ReturnType<typeof readActiveRun>>): string {
 	const questions = run.questions ?? [];
-	if (questions.length === 0) return "No harness questions recorded.";
+	if (questions.length === 0) return "尚未记录 Harness 问题。";
 	return questions.map(formatQuestionCard).join("\n\n");
 }
 
 function formatRuns(runs: NonNullable<ReturnType<typeof readActiveRun>>[], activeId?: string): string {
-	if (runs.length === 0) return "No Kingdee harness runs in this project. Start one with /kd-start <goal>.";
+	if (runs.length === 0) return "当前项目没有 Kingdee Harness run。请使用 /kd-start <需求> 创建。";
 	return runs
 		.map((run) =>
 			[
 				`${run.id === activeId ? "*" : "-"} ${run.id}`,
-				`  Goal: ${run.goal ?? "unknown"}`,
-				`  Status: ${run.status ?? "active"} | Phase: ${run.phase} | Product: ${run.profile?.product ?? run.product ?? "unknown"}`,
-				`  Updated: ${run.updatedAt ?? "unknown"}`,
+				`  需求：${run.goal ?? "未知"}`,
+				`  状态：${run.status ?? "active"} | 阶段：${run.phase} | 产品：${run.profile?.product ?? run.product ?? "unknown"}`,
+				`  更新时间：${run.updatedAt ?? "未知"}`,
 			].join("\n"),
 		)
 		.join("\n\n");
@@ -550,14 +557,14 @@ function formatRuns(runs: NonNullable<ReturnType<typeof readActiveRun>>[], activ
 
 function formatQuestionCard(question: NonNullable<NonNullable<ReturnType<typeof readActiveRun>>["questions"]>[number]): string {
 	const lines = [
-		`Question ${question.id} [${question.status}${question.blocking ? ", blocking" : ""}]`,
-		`Phase: ${question.phase}`,
-		`Question: ${question.question}`,
-		question.reason ? `Reason: ${question.reason}` : undefined,
-		question.choices?.length ? `Choices: ${question.choices.join(" | ")}` : undefined,
-		question.answer ? `Answer: ${question.answer}` : undefined,
+		`问题 ${question.id} [${question.status}${question.blocking ? ", blocking" : ""}]`,
+		`阶段：${question.phase}`,
+		`问题：${question.question}`,
+		question.reason ? `原因：${question.reason}` : undefined,
+		question.choices?.length ? `选项：${question.choices.join(" | ")}` : undefined,
+		question.answer ? `答案：${question.answer}` : undefined,
 		question.status === "open"
-			? `Answer the dialog if available, or reply in chat and record it using kd_question action=answer id=${question.id} answer=<answer>.`
+			? `如果有弹窗，请直接回答；否则请在对话中回复，并用 kd_question action=answer id=${question.id} answer=<答案> 记录。`
 			: undefined,
 	];
 	return lines.filter(Boolean).join("\n");
@@ -589,12 +596,12 @@ async function askQuestionInteractively(
 function questionBatchProblem(question: string, choices?: string[]): string | undefined {
 	const text = question.trim();
 	const numberedItems = text.split(/\r?\n/).filter((line) => /^\s*(\d+[\.\)、)]|[-*]\s+)/.test(line)).length;
-	if (numberedItems >= 2) return "kd_question rejected a batched checklist question.";
-	if ((text.match(/[?？]/g) ?? []).length > 1) return "kd_question rejected multiple questions in one prompt.";
-	if (text.length > 220) return "kd_question rejected an overlong question. Ask only the smallest blocking question first.";
-	if ((choices?.length ?? 0) > 3) return "kd_question rejected too many choices. Provide at most 3 concise choices.";
+	if (numberedItems >= 2) return "kd_question 拒绝了批量清单式问题。";
+	if ((text.match(/[?？]/g) ?? []).length > 1) return "kd_question 拒绝了一次包含多个问题的提问。";
+	if (text.length > 220) return "kd_question 拒绝了过长问题。请只问当前最小的阻塞问题。";
+	if ((choices?.length ?? 0) > 3) return "kd_question 拒绝了过多选项。最多提供 3 个简短选项。";
 	if (choices?.some((choice) => choice.length > 40 || /[\r\n?？]/.test(choice))) {
-		return "kd_question rejected complex choices. Choices must be short labels, not nested questions.";
+		return "kd_question 拒绝了复杂选项。选项必须是短标签，不能嵌套问题。";
 	}
 	return undefined;
 }
@@ -602,14 +609,14 @@ function questionBatchProblem(question: string, choices?: string[]): string | un
 function formatQuestionArtifactLines(question: NonNullable<NonNullable<ReturnType<typeof readActiveRun>>["questions"]>[number]): string[] {
 	return [
 		`- ${question.id} [${question.blocking ? "blocking" : "non-blocking"}] ${question.question}`,
-		question.reason ? `  - Reason: ${question.reason}` : undefined,
-		question.choices?.length ? `  - Choices: ${question.choices.join(" | ")}` : undefined,
-		"  - Status: open",
+		question.reason ? `  - 原因：${question.reason}` : undefined,
+		question.choices?.length ? `  - 选项：${question.choices.join(" | ")}` : undefined,
+		"  - 状态：open",
 	].filter(Boolean) as string[];
 }
 
 function appendQuestionEventToArtifact(cwd: string, run: NonNullable<ReturnType<typeof readActiveRun>>, lines: string[]): void {
 	const existing = readArtifact(cwd, run, run.phase) ?? "";
-	const section = ["", "## Harness Questions", "", ...lines, ""].join("\n");
-	updatePhaseArtifact(cwd, run, run.phase, existing.includes("## Harness Questions") ? `${existing.trimEnd()}\n${lines.join("\n")}\n` : `${existing.trimEnd()}${section}`);
+	const section = ["", "## Harness 问题", "", ...lines, ""].join("\n");
+	updatePhaseArtifact(cwd, run, run.phase, existing.includes("## Harness 问题") ? `${existing.trimEnd()}\n${lines.join("\n")}\n` : `${existing.trimEnd()}${section}`);
 }

package/extensions/kingdee-header.ts

@@ -32,7 +32,7 @@ function readActiveRun(cwd: string): ActiveRun | undefined {
 }
 
 function formatProduct(run: ActiveRun | undefined): string {
-	if (!run) return "unselected";
+	if (!run) return "未选择";
 	const product = run.profile?.product ?? run.product ?? "unknown";
 	const techStack = run.profile?.techStack ?? "unknown";
 	const language = run.profile?.language ?? "unknown";
@@ -40,13 +40,13 @@ function formatProduct(run: ActiveRun | undefined): string {
 }
 
 function formatPhase(phase: ActiveRun["phase"]): string {
-	return phase ?? "idle";
+	return phase ?? "空闲";
 }
 
 function formatGate(run: ActiveRun | undefined): string {
-	if (!run?.gate) return "gate: pending";
-	if (run.gate.passed) return "gate: pass";
-	return `gate: blocked${run.gate.reason ? ` - ${run.gate.reason}` : ""}`;
+	if (!run?.gate) return "门禁：待检查";
+	if (run.gate.passed) return "门禁：通过";
+	return `门禁：阻塞${run.gate.reason ? ` - ${run.gate.reason}` : ""}`;
 }
 
 function padOrTrim(text: string, width: number): string {
@@ -60,7 +60,7 @@ function logoLines(theme: Theme): string[] {
 	const muted = (text: string) => theme.fg("muted", text);
 
 	return [
-		`${accent("KCode")} ${muted("Kingdee Pi Harness")}`,
+		`${accent("KCode")} ${muted("金蝶 Pi Harness")}`,
 		`${accent("=====")} ${muted("discuss -> spec -> plan -> execute -> verify -> ship")}`,
 	];
 }
@@ -76,15 +76,15 @@ export default function (pi: ExtensionAPI) {
 					const phase = formatPhase(run?.phase);
 					const product = formatProduct(run);
 					const gate = formatGate(run);
-					const risk = run?.risk ?? "unknown";
-					const runId = run?.id ?? "none";
+					const risk = run?.risk ?? "未知";
+					const runId = run?.id ?? "无";
 
 					const status = [
-						theme.fg("muted", "phase: "),
+						theme.fg("muted", "阶段："),
 						theme.fg("accent", phase),
-						theme.fg("muted", " | product: "),
+						theme.fg("muted", " | 产品："),
 						theme.fg("text", product),
-						theme.fg("muted", " | risk: "),
+						theme.fg("muted", " | 风险："),
 						theme.fg(risk === "high" ? "error" : risk === "medium" ? "warning" : "success", risk),
 						theme.fg("muted", " | "),
 						theme.fg(run?.gate?.passed === false ? "error" : "muted", gate),
@@ -94,7 +94,7 @@ export default function (pi: ExtensionAPI) {
 						"",
 						...logoLines(theme).map((line) => padOrTrim(line, width)),
 						padOrTrim(status, width),
-						padOrTrim(theme.fg("dim", `run: ${runId}`), width),
+						padOrTrim(theme.fg("dim", `run：${runId}`), width),
 						"",
 					];
 				},
@@ -104,19 +104,19 @@ export default function (pi: ExtensionAPI) {
 	});
 
 	pi.registerCommand("kcode-header", {
-		description: "Restore the KCode Kingdee header",
+		description: "恢复 KCode 金蝶标题栏",
 		handler: async (_args, ctx) => {
 			if (ctx.mode !== "tui") return;
-			ctx.ui.notify("Restart the session or reload extensions to restore the KCode header.", "info");
+			ctx.ui.notify("请重启会话或重新加载扩展以恢复 KCode 标题栏。", "info");
 		},
 	});
 
 	pi.registerCommand("builtin-header", {
-		description: "Restore Pi's built-in header",
+		description: "恢复 Pi 内置标题栏",
 		handler: async (_args, ctx) => {
 			if (ctx.mode !== "tui") return;
 			ctx.ui.setHeader(undefined);
-			ctx.ui.notify("Built-in header restored", "info");
+			ctx.ui.notify("已恢复 Pi 内置标题栏", "info");
 		},
 	});
 }