kcode-pi 0.1.13 → 0.1.15

package/extensions/kingdee-tools.ts

@@ -74,8 +74,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 +87,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 +102,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 +117,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 +145,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 +159,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 +186,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 +210,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 +220,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 +230,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 +248,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 +273,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 +289,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 +305,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) {
@@ -338,12 +338,12 @@ const kdSdkSignatureTool = defineTool({
 
 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 +356,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 +380,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) {
@@ -396,9 +396,9 @@ const kdDebugTool = defineTool({
 			return {
 				content: [
 					{
-						type: "text",
-						text: `Source: ${input.source}\nProduct: ${profile.product}/${profile.platform}/${profile.techStack}\n\n${formatDebugFindings(findings)}`,
-					},
+					type: "text",
+					text: `来源：${input.source}\n产品：${profile.product}/${profile.platform}/${profile.techStack}\n\n${formatDebugFindings(findings)}`,
+				},
 				],
 				details: { source: input.source, product: profile.product, findings },
 			};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kcode-pi",
-  "version": "0.1.13",
-  "description": "Kingdee-specific package and harness for Pi Coding Agent",
+  "version": "0.1.15",
+  "description": "面向金蝶开发的 Pi Coding Agent 启动器、工具包和 Harness 工作流",
   "type": "module",
   "private": false,
   "bin": {
@@ -64,6 +64,7 @@
     "smoke:sdk-signature": "tsx scripts/smoke-sdk-signature.ts",
     "smoke:package": "tsx scripts/smoke-package.ts",
     "smoke:kcode-cli": "tsx scripts/smoke-kcode-cli.ts",
+    "release:check": "tsx scripts/release-check.ts",
     "kcode": "tsx scripts/kcode.ts",
     "prepack": "npm run build:cli && npm run smoke:package"
   },

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` 或门禁被阻塞，必须停止并说明缺少的文档或证据。通过后只实现 `PLAN.md` 批准的内容，并更新 `EXECUTION.md`。
 
-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/元数据、验证命令和回滚说明。
 
-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/cli/kcode.ts

@@ -37,7 +37,9 @@ export function runKcodeCli(args: string[], cwd = process.cwd()): KcodeCliResult
 		case "context":
 			return context(cwd, args.slice(1));
 		case "doctor":
-			return doctor(cwd);
+			return doctor(cwd, args.slice(1));
+		case "repair":
+			return repair(cwd);
 		case "version":
 		case "--version":
 		case "-v":
@@ -81,32 +83,101 @@ export function context(cwd: string, args: string[]): KcodeCliResult {
 	};
 }
 
-export function doctor(cwd: string): KcodeCliResult {
+export function doctor(cwd: string, args: string[] = []): KcodeCliResult {
+	const deep = args.includes("--deep");
 	const lines: string[] = [];
 	const node = spawnSync("node", ["--version"], { encoding: "utf8" });
 	const piCli = resolvePiCliCommand(["--version"]);
 	const pi = piCli ? spawnSync(piCli.command, piCli.args, { encoding: "utf8" }) : undefined;
 	const settingsPath = projectSettingsPath(cwd);
+	const projectContextPath = join(cwd, ".pi", "kd", "PROJECT_CONTEXT.md");
+	let errors = 0;
+	let warnings = 0;
 
 	lines.push(`Node：${node.status === 0 ? node.stdout.trim() : "未找到"}`);
 	lines.push(`Pi CLI：${formatPiCliStatus(piCli, pi)}`);
 	lines.push(`KCode version：${packageName}@${packageVersion}`);
 	lines.push(`KCode package：${packageRoot}`);
 	lines.push(`项目配置：${existsSync(settingsPath) ? settingsPath : "未创建，请先运行 kcode init"}`);
-	lines.push(`项目上下文：${existsSync(join(cwd, ".pi", "kd", "PROJECT_CONTEXT.md")) ? join(cwd, ".pi", "kd", "PROJECT_CONTEXT.md") : "未创建，请运行 kcode context"}`);
+	lines.push(`项目上下文：${existsSync(projectContextPath) ? projectContextPath : "未创建，请运行 kcode context"}`);
 
 	if (existsSync(settingsPath)) {
-		const settings = readSettings(settingsPath);
-		const hasKcode = (settings.packages ?? []).includes(normalizePath(packageRoot));
-		lines.push(`KCode package 已登记：${hasKcode ? "是" : "否"}`);
+		const settingsResult = readSettingsSafe(settingsPath);
+		if (!settingsResult.ok) {
+			errors++;
+			lines.push(`[ERROR] 项目配置无法解析：${settingsResult.error}`);
+		} else {
+			const packages = settingsResult.settings.packages ?? [];
+			const hasKcode = packages.includes(normalizePath(packageRoot));
+			lines.push(`KCode package 已登记：${hasKcode ? "是" : "否"}`);
+			if (!hasKcode) warnings++;
+			if (deep) {
+				const kcodePackages = packages.filter((pkg) => isSameKcodePackage(pkg, normalizePath(packageRoot)));
+				const stalePackages = kcodePackages.filter((pkg) => normalizePath(pkg) !== normalizePath(packageRoot));
+				lines.push(`KCode package 条目数：${kcodePackages.length}`);
+				if (stalePackages.length > 0) {
+					warnings++;
+					lines.push(`[WARN] 发现旧 KCode package 路径：${stalePackages.join(" | ")}`);
+					lines.push("       运行 kcode repair 可清理旧路径并刷新项目上下文。");
+				}
+			}
+		}
+	} else {
+		warnings++;
 	}
 
+	if (deep) {
+		if (!isSupportedNodeVersion(process.version)) {
+			errors++;
+			lines.push(`[ERROR] 当前 Node ${process.version} 不满足要求：>=22.19.0`);
+		}
+		if (!existsSync(projectContextPath)) {
+			warnings++;
+			lines.push("[WARN] 项目上下文不存在，运行 kcode context --refresh 或 kcode repair。");
+		}
+		const npmPrefix = spawnSync("npm", ["prefix", "-g"], { encoding: "utf8" });
+		const npmRoot = spawnSync("npm", ["root", "-g"], { encoding: "utf8" });
+		lines.push(`npm prefix -g：${npmPrefix.status === 0 ? npmPrefix.stdout.trim() : "不可用"}`);
+		lines.push(`npm root -g：${npmRoot.status === 0 ? npmRoot.stdout.trim() : "不可用"}`);
+		lines.push(`active run：${existsSync(join(cwd, ".pi", "kd", "active-run.json")) ? "存在" : "无"}`);
+	}
+
+	if (deep) lines.push(`诊断汇总：errors=${errors} warnings=${warnings}`);
+
 	return {
-		exitCode: pi?.status === 0 ? 0 : 1,
+		exitCode: pi?.status === 0 && errors === 0 ? 0 : 1,
 		output: lines.join("\n"),
 	};
 }
 
+export function repair(cwd: string): KcodeCliResult {
+	const settingsPath = projectSettingsPath(cwd);
+	const settingsResult = readSettingsSafe(settingsPath);
+	if (!settingsResult.ok) {
+		return {
+			exitCode: 1,
+			output: `项目配置无法解析，未自动覆盖：${settingsPath}\n原因：${settingsResult.error}`,
+		};
+	}
+
+	const currentPackage = normalizePath(packageRoot);
+	const packages = (settingsResult.settings.packages ?? []).filter((pkg) => !isSameKcodePackage(pkg, currentPackage));
+	packages.unshift(currentPackage);
+	settingsResult.settings.packages = packages;
+	mkdirSync(dirname(settingsPath), { recursive: true });
+	writeFileSync(settingsPath, `${JSON.stringify(settingsResult.settings, null, 2)}\n`, "utf8");
+	const projectContext = writeProjectContext(cwd);
+
+	return {
+		exitCode: 0,
+		output: [
+			`已修复项目级 Pi 配置：${settingsPath}`,
+			`已保留当前 KCode package：${currentPackage}`,
+			`已刷新项目上下文：${projectContext.path}`,
+		].join("\n"),
+	};
+}
+
 export function version(): KcodeCliResult {
 	const piCli = resolvePiCliCommand(["--version"]);
 	const pi = piCli ? spawnSync(piCli.command, piCli.args, { encoding: "utf8" }) : undefined;
@@ -176,6 +247,14 @@ function readSettings(path: string): PiSettings {
 	return JSON.parse(readFileSync(path, "utf8")) as PiSettings;
 }
 
+function readSettingsSafe(path: string): { ok: true; settings: PiSettings } | { ok: false; error: string } {
+	try {
+		return { ok: true, settings: readSettings(path) };
+	} catch (error) {
+		return { ok: false, error: error instanceof Error ? error.message : String(error) };
+	}
+}
+
 function normalizePath(path: string): string {
 	return resolve(path);
 }
@@ -233,6 +312,20 @@ function formatPiCliStatus(
 	return `${version}（${source}：${piCli.displayPath}）`;
 }
 
+function isSupportedNodeVersion(version: string): boolean {
+	const match = /^v?(\d+)\.(\d+)\.(\d+)/.exec(version.trim());
+	if (!match) return false;
+	const [, majorText, minorText, patchText] = match;
+	const major = Number(majorText);
+	const minor = Number(minorText);
+	const patch = Number(patchText);
+	if (major > 22) return true;
+	if (major < 22) return false;
+	if (minor > 19) return true;
+	if (minor < 19) return false;
+	return patch >= 0;
+}
+
 function piCliPackageVersion(piCli: PiCliCommand): string | undefined {
 	if (piCli.source !== "bundled") return undefined;
 
@@ -253,6 +346,7 @@ function helpText(): string {
 		"  kcode init      初始化当前项目的 .pi/settings.json",
 		"  kcode context   生成或刷新 .pi/kd/PROJECT_CONTEXT.md",
 		"  kcode doctor    检查 Node、随包 Pi CLI、KCode package 和项目级配置",
+		"  kcode repair    清理旧 KCode package 路径并刷新项目上下文",
 		"  kcode version   显示 KCode、随包 Pi CLI 和 Node 版本",
 		"  kcode start     初始化项目配置后启动 KCode 工作环境",
 	].join("\n");