kcode-pi 0.1.13 → 0.1.15

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");
 }
 

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、字段标识和注册步骤。",
 		],
 	};
 }