kcode-pi 0.1.14 → 0.1.16

package/extensions/kingdee-tools.ts

@@ -1,6 +1,6 @@
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { readFileSync } from "node:fs";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { Type } from "@earendil-works/pi-ai";
 import { defineTool, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { formatSearchResults, formatTableSchema } from "../src/knowledge/format.ts";
@@ -22,6 +22,9 @@ import {
 	writeOfficialEvidence,
 } from "../src/official/kingdee-skills.ts";
 import { resolveWorkspacePath } from "../src/platform/path.ts";
+import { readActiveRun } from "../src/harness/state.ts";
+import { runArtifactPath } from "../src/harness/paths.ts";
+import { SDK_SIGNATURE_EVIDENCE } from "../src/harness/sdk-policy.ts";
 
 const extensionDir = dirname(fileURLToPath(import.meta.url));
 const knowledgePath = join(extensionDir, "..", "knowledge");
@@ -74,8 +77,8 @@ function sdkLanguageForProfile(profile: ProductProfile, value: string | undefine
 
 function rejectNonCosmic(profile: ProductProfile): string | undefined {
 	if (isCosmicFamily(profile)) return undefined;
-	if (profile.product === "unknown") return "Provide a Cosmic-family product first: cangqiong, xinghan, flagship, or cosmic.";
-	return `Product ${profile.product} uses ${profile.platform}/${profile.techStack}; Cosmic official scripts are not applicable.`;
+	if (profile.product === "unknown") return "请先提供 Cosmic 家族产品：cangqiong、xinghan、flagship 或 cosmic。";
+	return `当前产品 ${profile.product} 使用 ${profile.platform}/${profile.techStack}，不适用 Cosmic 官方能力。`;
 }
 
 async function runOrDryRun(
@@ -87,7 +90,7 @@ async function runOrDryRun(
 	const command = await commandPromise;
 	if (dryRun) {
 		return {
-			content: [{ type: "text" as const, text: `Dry run command:\n${command.display}` }],
+			content: [{ type: "text" as const, text: `仅展示命令，不执行：\n${command.display}` }],
 			details: { command: command.display, dryRun: true },
 		};
 	}
@@ -102,13 +105,13 @@ async function runOrDryRun(
 
 const kdSearchTool = defineTool({
 	name: "kd_search",
-	label: "KD Search",
-	description: "Search bundled Kingdee SDK knowledge, plugin lifecycle notes, code patterns, and common implementation guidance.",
+	label: "KD 搜索",
+	description: "搜索 KCode 随包金蝶知识库，包括 SDK、插件生命周期、代码模式和常见实现建议。",
 	parameters: Type.Object({
-		query: Type.String({ description: "Keyword or API/class/table/lifecycle term to search for" }),
-		product: Type.Optional(Type.String({ description: "Kingdee product: flagship, cosmic, xinghan, cangqiong, or enterprise." })),
-		edition: Type.Optional(Type.String({ description: "Legacy alias for product. Prefer product." })),
-		limit: Type.Optional(Type.Number({ description: "Maximum number of results. Defaults to 5." })),
+		query: Type.String({ description: "要搜索的关键词、API、类名、表名或生命周期术语。" }),
+		product: Type.Optional(Type.String({ description: "金蝶产品：flagship、cosmic、xinghan、cangqiong 或 enterprise。" })),
+		edition: Type.Optional(Type.String({ description: "旧参数，等同于 product。优先使用 product。" })),
+		limit: Type.Optional(Type.Number({ description: "最大结果数，默认 5。" })),
 	}),
 
 	async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
@@ -117,15 +120,15 @@ const kdSearchTool = defineTool({
 		if (!scopes) {
 			const guidance =
 				profile.product === "unknown"
-					? "Provide product first, for example product=flagship, enterprise, cosmic, xinghan, or cangqiong."
-					: "No knowledge scope is configured for this product profile.";
+					? "请先提供 product，例如 flagship、enterprise、cosmic、xinghan 或 cangqiong。"
+					: "当前产品画像未配置可搜索知识范围。";
 			return {
 				content: [
 					{
 						type: "text",
 						text: [
-							`Product profile: ${profile.product}/${profile.techStack}/${profile.language}`,
-							"Bundled searchable knowledge requires a known product profile.",
+							`产品画像：${profile.product}/${profile.techStack}/${profile.language}`,
+							"KCode 随包知识库搜索需要明确产品画像。",
 							guidance,
 						].join("\n"),
 					},
@@ -145,12 +148,12 @@ const kdSearchTool = defineTool({
 
 const kdTableTool = defineTool({
 	name: "kd_table",
-	label: "KD Table",
-	description: "Look up a bundled Kingdee table schema by table name for the selected product profile.",
+	label: "KD 表结构",
+	description: "按表名查询 KCode 随包金蝶表结构，查询结果受产品画像约束。",
 	parameters: Type.Object({
-		table: Type.String({ description: "Table name, for example T_PUR_POORDER" }),
-		product: Type.Optional(Type.String({ description: "Kingdee product: flagship, cosmic, xinghan, cangqiong, or enterprise." })),
-		edition: Type.Optional(Type.String({ description: "Legacy alias for product. Prefer product." })),
+		table: Type.String({ description: "表名，例如 T_PUR_POORDER。" }),
+		product: Type.Optional(Type.String({ description: "金蝶产品：flagship、cosmic、xinghan、cangqiong 或 enterprise。" })),
+		edition: Type.Optional(Type.String({ description: "旧参数，等同于 product。优先使用 product。" })),
 	}),
 
 	async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
@@ -159,15 +162,15 @@ const kdTableTool = defineTool({
 		if (!edition) {
 			const guidance =
 				profile.product === "unknown"
-					? "Provide product first. Do not assume a table schema across Kingdee product families."
-					: "Do not reuse flagship/enterprise table assumptions for Cosmic/Xinghan/Cangqiong without metadata verification.";
+					? "请先提供 product。不要跨金蝶产品族猜测表结构。"
+					: "没有元数据查证前，不要把旗舰版/企业版表结构假设复用到苍穹/星瀚/Cosmic。";
 			return {
 				content: [
 					{
 						type: "text",
 						text: [
-							`Product profile: ${profile.product}/${profile.techStack}/${profile.language}`,
-							"Bundled table schemas currently cover flagship and enterprise only.",
+							`产品画像：${profile.product}/${profile.techStack}/${profile.language}`,
+							"KCode 随包表结构目前主要覆盖旗舰版和企业版。",
 							guidance,
 						].join("\n"),
 					},
@@ -186,14 +189,14 @@ const kdTableTool = defineTool({
 
 const kdCheckTool = defineTool({
 	name: "kd_check",
-	label: "KD Check",
+	label: "KD 检查",
 	description:
-		"Check Kingdee Java/C#/Python plugin code for magic values, naming issues, DB calls in loops, and empty catch blocks.",
+		"检查金蝶 Java/C#/Python 插件代码中的魔法值、命名问题、循环内 DB 调用和空 catch 等问题。",
 	parameters: Type.Object({
-		code: Type.Optional(Type.String({ description: "Source code to check. Use this or path." })),
-		path: Type.Optional(Type.String({ description: "Path to a source file to check. Use this or code." })),
-		product: Type.Optional(Type.String({ description: "Kingdee product. Used to derive Java or C# when language is omitted." })),
-		language: Type.Optional(Type.String({ description: "Language: java, csharp, or python. Overrides product-derived language." })),
+		code: Type.Optional(Type.String({ description: "要检查的源码。与 path 二选一。" })),
+		path: Type.Optional(Type.String({ description: "要检查的源码文件路径。与 code 二选一。" })),
+		product: Type.Optional(Type.String({ description: "金蝶产品。未提供 language 时用于推导 Java 或 C#。" })),
+		language: Type.Optional(Type.String({ description: "语言：java、csharp 或 python。会覆盖产品推导结果。" })),
 	}),
 
 	async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
@@ -210,7 +213,7 @@ const kdCheckTool = defineTool({
 
 		if (!code) {
 			return {
-				content: [{ type: "text", text: "Provide either code or path for kd_check." }],
+				content: [{ type: "text", text: "kd_check 需要提供 code 或 path。" }],
 				details: { error: "missing-code-or-path" },
 			};
 		}
@@ -220,7 +223,7 @@ const kdCheckTool = defineTool({
 			content: [
 				{
 					type: "text",
-					text: `Source: ${source}\nProduct: ${profile.product}/${profile.techStack}\nLanguage: ${language}\n\n${formatCheckResults(results)}`,
+					text: `来源：${source}\n产品：${profile.product}/${profile.techStack}\n语言：${language}\n\n${formatCheckResults(results)}`,
 				},
 			],
 			details: { source, product: profile.product, language, issues: results },
@@ -230,12 +233,12 @@ const kdCheckTool = defineTool({
 
 const kdCosmicConfigTool = defineTool({
 	name: "kd_cosmic_config",
-	label: "KD Cosmic Config",
-	description: "Run the official ok-cosmic configuration precheck for Cosmic-family Kingdee products.",
+	label: "KD Cosmic 配置",
+	description: "运行 Cosmic 家族金蝶产品的官方能力配置预检查。",
 	parameters: Type.Object({
-		product: Type.String({ description: "Cosmic-family product: cangqiong, xinghan, flagship, or cosmic." }),
-		config: Type.Optional(Type.String({ description: "Optional ok-cosmic.json path. Defaults to current working directory behavior." })),
-		dryRun: Type.Optional(Type.Boolean({ description: "Return the command without executing it." })),
+		product: Type.String({ description: "Cosmic 家族产品：cangqiong、xinghan、flagship 或 cosmic。" }),
+		config: Type.Optional(Type.String({ description: "可选 ok-cosmic.json 路径。默认按当前工作目录解析。" })),
+		dryRun: Type.Optional(Type.Boolean({ description: "只返回命令，不实际执行。" })),
 	}),
 
 	async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
@@ -248,18 +251,18 @@ const kdCosmicConfigTool = defineTool({
 
 const kdCosmicMetadataTool = defineTool({
 	name: "kd_cosmic_metadata",
-	label: "KD Cosmic Metadata",
-	description: "Query official Cosmic form/bill metadata for fields, enum values, operations, and SQL table details.",
+	label: "KD Cosmic 元数据",
+	description: "查询官方 Cosmic 表单/单据元数据，包括字段、枚举值、操作和 SQL 表信息。",
 	parameters: Type.Object({
-		product: Type.String({ description: "Cosmic-family product: cangqiong, xinghan, flagship, or cosmic." }),
-		form: Type.String({ description: "Form ID, bill ID, or Chinese bill name. Multiple targets can be comma-separated." }),
-		config: Type.Optional(Type.String({ description: "Optional ok-cosmic.json path." })),
-		fuzzy: Type.Optional(Type.String({ description: "Optional field keywords separated by spaces or commas." })),
-		typeFilter: Type.Optional(Type.String({ description: "Optional field type regex, for example combo|check or decimal." })),
-		sql: Type.Optional(Type.Boolean({ description: "Include database table and field information." })),
-		op: Type.Optional(Type.Boolean({ description: "Show operations for the form/bill." })),
-		showDetail: Type.Optional(Type.Boolean({ description: "Show detailed metadata output." })),
-		dryRun: Type.Optional(Type.Boolean({ description: "Return the command without executing it." })),
+		product: Type.String({ description: "Cosmic 家族产品：cangqiong、xinghan、flagship 或 cosmic。" }),
+		form: Type.String({ description: "Form ID、单据 ID 或中文单据名；多个目标可用逗号分隔。" }),
+		config: Type.Optional(Type.String({ description: "可选 ok-cosmic.json 路径。" })),
+		fuzzy: Type.Optional(Type.String({ description: "可选字段关键词，用空格或逗号分隔。" })),
+		typeFilter: Type.Optional(Type.String({ description: "可选字段类型正则，例如 combo|check 或 decimal。" })),
+		sql: Type.Optional(Type.Boolean({ description: "是否包含数据库表和字段信息。" })),
+		op: Type.Optional(Type.Boolean({ description: "是否显示表单/单据操作。" })),
+		showDetail: Type.Optional(Type.Boolean({ description: "是否显示详细元数据输出。" })),
+		dryRun: Type.Optional(Type.Boolean({ description: "只返回命令，不实际执行。" })),
 	}),
 
 	async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
@@ -273,15 +276,15 @@ const kdCosmicMetadataTool = defineTool({
 const kdCosmicApiTool = defineTool({
 	name: "kd_cosmic_api",
 	label: "KD Cosmic API",
-	description: "Query bundled Cosmic API knowledge for class and method clues. Use kd_sdk_signature or build output for final local SDK facts.",
+	description: "查询随包 Cosmic API 知识，获取类和方法线索；最终签名事实应以 kd_sdk_signature 或项目构建输出为准。",
 	parameters: Type.Object({
-		product: Type.String({ description: "Cosmic-family product: cangqiong, xinghan, flagship, or cosmic." }),
-		mode: Type.String({ description: "search, search-method, or detail." }),
-		query: Type.String({ description: "Class name, method name, or fully qualified class name." }),
-		config: Type.Optional(Type.String({ description: "Optional ok-cosmic.json path." })),
-		method: Type.Optional(Type.String({ description: "Optional method filter for detail mode." })),
-		compact: Type.Optional(Type.Boolean({ description: "Request compact detail output when supported." })),
-		dryRun: Type.Optional(Type.Boolean({ description: "Return the command without executing it." })),
+		product: Type.String({ description: "Cosmic 家族产品：cangqiong、xinghan、flagship 或 cosmic。" }),
+		mode: Type.String({ description: "查询模式：search、search-method 或 detail。" }),
+		query: Type.String({ description: "类名、方法名或完整限定类名。" }),
+		config: Type.Optional(Type.String({ description: "可选 ok-cosmic.json 路径。" })),
+		method: Type.Optional(Type.String({ description: "detail 模式下的可选方法过滤条件。" })),
+		compact: Type.Optional(Type.Boolean({ description: "支持时请求紧凑详情输出。" })),
+		dryRun: Type.Optional(Type.Boolean({ description: "只返回命令，不实际执行。" })),
 	}),
 
 	async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
@@ -289,7 +292,7 @@ const kdCosmicApiTool = defineTool({
 		const rejection = rejectNonCosmic(profile);
 		if (rejection) return { content: [{ type: "text", text: rejection }], details: { rejected: true, product: profile.product } };
 		if (!["search", "search-method", "detail"].includes(params.mode)) {
-			return { content: [{ type: "text", text: "mode must be one of: search, search-method, detail" }], details: { error: "invalid-mode" } };
+			return { content: [{ type: "text", text: "mode 必须是 search、search-method 或 detail。" }], details: { error: "invalid-mode" } };
 		}
 		return runOrDryRun(
 			cosmicApiCommand(ctx.cwd, {
@@ -305,17 +308,17 @@ const kdCosmicApiTool = defineTool({
 
 const kdSdkSignatureTool = defineTool({
 	name: "kd_sdk_signature",
-	label: "KD SDK Signature",
+	label: "KD SDK 签名",
 	description:
-		"Inspect method/type signatures from SDK jars or dlls actually present in the current project. Prefer this over bundled knowledge for factual API signatures.",
+		"从当前项目真实存在的 SDK jar 或 dll 中检查方法/类型签名。涉及 API 签名事实时，优先使用它而不是随包知识库。",
 	parameters: Type.Object({
-		product: Type.Optional(Type.String({ description: "Kingdee product. Used to derive Java or C# when language is omitted." })),
-		language: Type.Optional(Type.String({ description: "java or csharp. Defaults from product profile." })),
-		query: Type.Optional(Type.String({ description: "Class/type keyword to search, for example QueryServiceHelper or DynamicObject." })),
-		className: Type.Optional(Type.String({ description: "Fully qualified Java/C# type name when known." })),
-		method: Type.Optional(Type.String({ description: "Optional method/property name filter within the matched class/type. Does not scan all methods globally." })),
-		path: Type.Optional(Type.String({ description: "Optional SDK lib/bin directory or specific dependency root. Defaults to current project." })),
-		limit: Type.Optional(Type.Number({ description: "Maximum jars/dlls/classes to inspect. Defaults to 20 result classes and 200 files." })),
+		product: Type.Optional(Type.String({ description: "金蝶产品。未提供 language 时用于推导 Java 或 C#。" })),
+		language: Type.Optional(Type.String({ description: "java 或 csharp。默认由产品画像推导。" })),
+		query: Type.Optional(Type.String({ description: "要搜索的类/类型关键词，例如 QueryServiceHelper 或 DynamicObject。" })),
+		className: Type.Optional(Type.String({ description: "已知时提供完整限定 Java/C# 类型名。" })),
+		method: Type.Optional(Type.String({ description: "在匹配类/类型内过滤方法或属性；不会全局扫描所有方法。" })),
+		path: Type.Optional(Type.String({ description: "可选 SDK lib/bin 目录或依赖根路径。默认从当前项目查找。" })),
+		limit: Type.Optional(Type.Number({ description: "最大检查 jar/dll/class 数量。默认 20 个结果类、200 个文件。" })),
 	}),
 
 	async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
@@ -329,21 +332,23 @@ const kdSdkSignatureTool = defineTool({
 			path: params.path,
 			limit: params.limit,
 		});
+		const text = formatSdkSignatureResult(result);
+		const evidencePath = result.exitCode === 0 ? writeSdkSignatureEvidence(ctx.cwd, text) : undefined;
 		return {
-			content: [{ type: "text", text: formatSdkSignatureResult(result) }],
-			details: { product: profile.product, ...result },
+			content: [{ type: "text", text: evidencePath ? `${text}\n\n已写入 SDK 签名证据：${evidencePath}` : text }],
+			details: { product: profile.product, evidencePath, ...result },
 		};
 	},
 });
 
 const kdKsqlLintTool = defineTool({
 	name: "kd_ksql_lint",
-	label: "KD KSQL Lint",
-	description: "Run the official ok-ksql lint script against a generated KSQL/SQL file.",
+	label: "KD KSQL 检查",
+	description: "对生成的 KSQL/SQL 文件运行官方 ok-ksql lint 检查。",
 	parameters: Type.Object({
-		product: Type.String({ description: "Cosmic-family product: cangqiong, xinghan, flagship, or cosmic." }),
-		path: Type.String({ description: "SQL/KSQL file path, relative to workspace or absolute." }),
-		dryRun: Type.Optional(Type.Boolean({ description: "Return the command without executing it." })),
+		product: Type.String({ description: "Cosmic 家族产品：cangqiong、xinghan、flagship 或 cosmic。" }),
+		path: Type.String({ description: "SQL/KSQL 文件路径，可为工作区相对路径或绝对路径。" }),
+		dryRun: Type.Optional(Type.Boolean({ description: "只返回命令，不实际执行。" })),
 	}),
 
 	async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
@@ -356,12 +361,12 @@ const kdKsqlLintTool = defineTool({
 
 const kdBuildTool = defineTool({
 	name: "kd_build",
-	label: "KD Build",
-	description: "Run or dry-run a product-aware Kingdee build command for Cosmic Java or enterprise C# projects.",
+	label: "KD 构建",
+	description: "按产品画像运行或预览金蝶构建命令，支持 Cosmic Java 和企业版 C# 项目。",
 	parameters: Type.Object({
-		product: Type.String({ description: "Kingdee product: cangqiong, xinghan, flagship, cosmic, or enterprise." }),
-		target: Type.Optional(Type.String({ description: "Optional Gradle/Maven task for Java or .sln/.csproj path for C#." })),
-		dryRun: Type.Optional(Type.Boolean({ description: "Return the build command without executing it." })),
+		product: Type.String({ description: "金蝶产品：cangqiong、xinghan、flagship、cosmic 或 enterprise。" }),
+		target: Type.Optional(Type.String({ description: "Java 可提供 Gradle/Maven task；C# 可提供 .sln/.csproj 路径。" })),
+		dryRun: Type.Optional(Type.Boolean({ description: "只返回构建命令，不实际执行。" })),
 	}),
 
 	async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
@@ -380,12 +385,12 @@ const kdBuildTool = defineTool({
 
 const kdDebugTool = defineTool({
 	name: "kd_debug",
-	label: "KD Debug",
-	description: "Analyze Kingdee build/runtime logs or stack traces and map them to likely causes and next checks.",
+	label: "KD 调试",
+	description: "分析金蝶构建/运行日志或堆栈，给出可能原因和下一步检查建议。",
 	parameters: Type.Object({
-		text: Type.Optional(Type.String({ description: "Log text or stack trace. Use this or path." })),
-		path: Type.Optional(Type.String({ description: "Path to a log file. Use this or text." })),
-		product: Type.Optional(Type.String({ description: "Optional product hint for context." })),
+		text: Type.Optional(Type.String({ description: "日志文本或堆栈。与 path 二选一。" })),
+		path: Type.Optional(Type.String({ description: "日志文件路径。与 text 二选一。" })),
+		product: Type.Optional(Type.String({ description: "可选产品提示，用于补充上下文。" })),
 	}),
 
 	async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
@@ -397,7 +402,7 @@ const kdDebugTool = defineTool({
 				content: [
 					{
 						type: "text",
-						text: `Source: ${input.source}\nProduct: ${profile.product}/${profile.platform}/${profile.techStack}\n\n${formatDebugFindings(findings)}`,
+						text: `来源：${input.source}\n产品：${profile.product}/${profile.platform}/${profile.techStack}\n\n${formatDebugFindings(findings)}`,
 					},
 				],
 				details: { source: input.source, product: profile.product, findings },
@@ -423,3 +428,27 @@ export default function (pi: ExtensionAPI) {
 	pi.registerTool(kdBuildTool);
 	pi.registerTool(kdDebugTool);
 }
+
+function writeSdkSignatureEvidence(cwd: string, content: string): string | undefined {
+	const run = readActiveRun(cwd);
+	if (!run) return undefined;
+
+	const path = runArtifactPath(cwd, run, SDK_SIGNATURE_EVIDENCE);
+	mkdirSync(dirname(path), { recursive: true });
+	writeFileSync(
+		path,
+		[
+			"# SDK 签名证据",
+			"",
+			`- 生成时间：${new Date().toISOString()}`,
+			"- 来源：kd_sdk_signature 当前项目本地 SDK jar/dll",
+			"",
+			"```text",
+			content.trim(),
+			"```",
+			"",
+		].join("\n"),
+		"utf8",
+	);
+	return path;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kcode-pi",
-  "version": "0.1.14",
-  "description": "Kingdee-specific package and harness for Pi Coding Agent",
+  "version": "0.1.16",
+  "description": "面向金蝶开发的 Pi Coding Agent 启动器、工具包和 Harness 工作流",
   "type": "module",
   "private": false,
   "bin": {

package/prompts/kd-discuss.md

@@ -1,11 +1,11 @@
 ---
-description: Start or refine the Kingdee Harness Engineering discussion phase.
+description: 开始或继续金蝶 Harness 工作流的需求讨论阶段。
 ---
 
-Use the `kd-discuss` skill.
+使用 `kd-discuss` skill。
 
-Start or update the active Kingdee harness run for this request:
+围绕本次请求开始或更新当前金蝶 Harness run：
 
 {{args}}
 
-Capture business goal, Kingdee product/version, tech stack, plugin type, target object, out-of-scope items, and open questions in `CONTEXT.md`.
+请把业务目标、金蝶产品/版本、技术栈、插件类型、目标单据/表单/实体、非目标范围和待确认问题记录到 `CONTEXT.md`。

package/prompts/kd-execute.md

@@ -1,12 +1,11 @@
 ---
-description: Execute the active Kingdee plan under Harness Engineering gates.
+description: 在 Harness 门禁约束下执行当前金蝶实施计划。
 ---
 
-Use the `kd-execute` skill.
+使用 `kd-execute` skill。
 
-Before editing code, check the active run with `kd_plan_status`. If `PLAN.md` is missing or the gate is blocked, stop and explain the missing artifact. Otherwise implement only the approved plan and update `EXECUTION.md`.
+编辑代码前，先使用 `kd_plan_status` 检查当前 run。如果缺少 `PLAN.md`、`evidence/sdk-signature.md` 或门禁被阻塞，必须停止并说明缺少的文档或证据。通过后只实现 `PLAN.md` 批准的内容，并更新 `EXECUTION.md`。禁止凭记忆、模型知识或随包知识库猜 SDK 方法签名。
 
-Extra user guidance:
+用户补充说明：
 
 {{args}}
-

package/prompts/kd-plan.md

@@ -1,12 +1,11 @@
 ---
-description: Draft the Kingdee implementation plan artifact for the active harness run.
+description: 为当前金蝶 Harness run 编写实施计划。
 ---
 
-Use the `kd-plan` skill.
+使用 `kd-plan` skill。
 
-Read `CONTEXT.md` and `SPEC.md`, then draft or update `PLAN.md`. Include files to inspect, files likely to edit, required Kingdee lookups, validation commands, and rollback notes.
+读取 `CONTEXT.md` 和 `SPEC.md`，编写或更新 `PLAN.md`。必须包含已检查的项目结构、需要查看的文件、预计修改的真实路径、必须查证的金蝶 API/元数据、SDK 签名证据、验证命令和回滚说明。Java/C# SDK 方法签名必须来自 `kd_sdk_signature` 当前项目 jar/dll、项目构建输出或官方元数据，不能凭记忆猜。
 
-Extra user guidance:
+用户补充说明：
 
 {{args}}
-

package/prompts/kd-ship.md

@@ -1,12 +1,11 @@
 ---
-description: Prepare Kingdee delivery summary after verification.
+description: 验证后整理金蝶交付摘要。
 ---
 
-Use the `kd-ship` skill.
+使用 `kd-ship` skill。
 
-Read the active run artifacts and produce `SHIP.md` with changed behavior, verification evidence, residual risks, and follow-up tasks. Do not ship if `VERIFY.md` is missing.
+读取当前 run 的阶段文档，生成 `SHIP.md`，说明行为变化、验证证据、残余风险和后续事项。缺少 `VERIFY.md` 时不得进入交付总结。
 
-Extra user guidance:
+用户补充说明：
 
 {{args}}
-

package/prompts/kd-spec.md

@@ -1,12 +1,11 @@
 ---
-description: Draft the Kingdee specification artifact for the active harness run.
+description: 为当前金蝶 Harness run 编写需求规格文档。
 ---
 
-Use the `kd-spec` skill.
+使用 `kd-spec` skill。
 
-Read the active Kingdee run context and draft or update `SPEC.md`. Include acceptance criteria, lifecycle hooks, data objects, exception behavior, performance constraints, assumptions, and risks.
+读取当前金蝶 run 的上下文，编写或更新 `SPEC.md`。必须包含验收标准、生命周期/扩展点、数据对象、异常行为、性能约束、假设和风险。
 
-Extra user guidance:
+用户补充说明：
 
 {{args}}
-

package/prompts/kd-verify.md

@@ -1,12 +1,11 @@
 ---
-description: Verify the active Kingdee implementation and collect evidence.
+description: 验证当前金蝶实现并收集证据。
 ---
 
-Use the `kd-verify` skill.
+使用 `kd-verify` skill。
 
-Run the planned validation commands, collect evidence, run available checks, and update `VERIFY.md`. If anything cannot run, record the exact blocker and residual risk.
+执行计划中的验证命令，收集证据，运行可用检查，并更新 `VERIFY.md`。如果某项验证无法运行，记录具体阻塞原因和残余风险。
 
-Extra user guidance:
+用户补充说明：
 
 {{args}}
-

package/src/context/project-context.ts

@@ -59,33 +59,33 @@ export function generateProjectContext(cwd: string): string {
 	const sourceSamples = scan.files.filter((file) => SOURCE_EXTENSIONS.has(extname(file).toLowerCase())).slice(0, MAX_SOURCE_SAMPLES);
 
 	return [
-		"# KCode Project Context",
+		"# KCode 项目上下文",
 		"",
-		`- Project root: ${cwd}`,
-		`- Project name: ${basename(cwd)}`,
-		`- Generated at: ${new Date().toISOString()}`,
+		`- 项目根目录：${cwd}`,
+		`- 项目名称：${basename(cwd)}`,
+		`- 生成时间：${new Date().toISOString()}`,
 		"",
-		"## Persistent Rules",
+		"## 持久规则",
 		"",
-		"- This file is project memory for KCode. Read it before planning or editing code.",
-		"- Do not create demo/sample/scaffold code for business requirements.",
-		"- Do not assume module layout. Follow the actual paths below and verify target files before editing.",
-		"- Use project-relative paths when calling file tools. On Windows, do not rewrite paths to /mnt/<drive>/... or /<drive>/...; use Windows paths only when an absolute path is necessary.",
-		"- If this file is stale, regenerate with `kcode context --refresh` before planning.",
-		"- Write product code only after the Harness reaches `execute` and PLAN.md names the real target path.",
+		"- 本文件是 KCode 的项目记忆，计划或编辑代码前必须读取。",
+		"- 业务需求不得生成 demo/sample/scaffold 代码。",
+		"- 不要假设模块结构。必须基于下方真实路径，并在编辑前确认目标文件。",
+		"- 调用文件工具时优先使用项目相对路径。在 Windows 中，不要把路径改写为 /mnt/<drive>/... 或 /<drive>/...；只有确需绝对路径时才使用 Windows 路径。",
+		"- 如果本文件过期，计划前先运行 `kcode context --refresh` 重新生成。",
+		"- 只有 Harness 进入 `execute` 且 PLAN.md 写明真实目标路径后，才能写产品代码。",
 		"",
-		"## Layout Summary",
+		"## 项目结构摘要",
 		"",
-		`- Has code directory: ${codeDir ? "yes" : "no"}`,
-		`- Likely source roots: ${formatList(likelyRoots)}`,
-		`- Build files: ${formatList(buildFiles)}`,
-		`- Detected modules: ${formatList(modules)}`,
+		`- 是否存在 code 目录：${codeDir ? "是" : "否"}`,
+		`- 可能的源码根：${formatList(likelyRoots)}`,
+		`- 构建文件：${formatList(buildFiles)}`,
+		`- 识别到的模块：${formatList(modules)}`,
 		"",
-		"## Source Samples",
+		"## 源码样例",
 		"",
 		formatBlockList(sourceSamples),
 		"",
-		"## Top-Level Directories",
+		"## 顶层目录",
 		"",
 		formatBlockList(scan.directories.filter((dir) => !dir.includes("/") && !dir.includes("\\")).sort()),
 		"",
@@ -202,11 +202,11 @@ function isSolutionOrProject(file: string): boolean {
 }
 
 function formatList(values: string[]): string {
-	return values.length > 0 ? values.join(", ") : "none detected";
+	return values.length > 0 ? values.join(", ") : "未识别";
 }
 
 function formatBlockList(values: string[]): string {
-	if (values.length === 0) return "- none detected";
+	if (values.length === 0) return "- 未识别";
 	return values.map((value) => `- ${value}`).join("\n");
 }