kcode-pi 0.1.12 → 0.1.13

package/README.md

@@ -276,6 +276,7 @@ kcode start --provider openai --model gpt-4o
 /kd-status
 /kd-runs
 /kd-switch <run-id>
+/kd-resume [补充说明]
 /kd-finish
 /kd-gate
 /kd-advance [phase]
@@ -291,6 +292,15 @@ kcode start --provider openai --model gpt-4o
 
 `/kd-start` 会创建新的功能点 run，并立即触发 Agent 进入 `discuss` 阶段。如果未识别出产品画像，例如显示 `(unknown/unknown)`，下一步应先确认产品、版本和技术栈，而不是直接写代码。
 
+暂停后接续：
+
+```text
+/kd-resume
+/kd-resume 继续确认采购入库单即时库存检查插件
+```
+
+重新 `kcode start` 时，如果当前项目存在未完成 active run，KCode 会提示当前功能点和阶段。`/kd-resume` 会读取项目常驻上下文、active run 状态和已落盘的阶段文档，再把完整工作流上下文交给 Agent 继续。
+
 支持的产品画像：
 
 ```text
@@ -348,7 +358,7 @@ KCode 会把金蝶开发需求纳入 Harness 工作流。你可以直接输入
 .pi/kd/runs/<run-id>/evidence/
 ```
 
-下次重新 `kcode start` 时，KCode 会读取当前项目的 active run、项目常驻上下文和已生成的阶段文档，再继续当前功能点的当前阶段。已完成或暂停的功能点仍保留在 `.pi/kd/runs/<run-id>/`，可用 `/kd-runs` 查看，用 `/kd-switch <run-id>` 切回。
+下次重新 `kcode start` 时，KCode 会提示当前项目的 active run。执行 `/kd-resume` 后，KCode 会读取项目常驻上下文、active run 状态和已生成的阶段文档，再继续当前功能点的当前阶段。已完成或暂停的功能点仍保留在 `.pi/kd/runs/<run-id>/`，可用 `/kd-runs` 查看，用 `/kd-switch <run-id>` 切回。
 
 阶段含义：
 

package/extensions/kingdee-harness.ts

@@ -77,6 +77,16 @@ function shouldStartHarnessFromInput(text: string): boolean {
 	return KINGDEE_INTENT_PATTERN.test(text);
 }
 
+function sendWorkflowPrompt(pi: ExtensionAPI, ctx: ExtensionContext, run: NonNullable<ReturnType<typeof readActiveRun>>, userText: string): void {
+	const prompt = workflowPromptForRun(ctx.cwd, run, userText);
+	if (ctx.isIdle()) {
+		pi.sendUserMessage(prompt);
+		return;
+	}
+	pi.sendUserMessage(prompt, { deliverAs: "followUp" });
+	if (ctx.hasUI) ctx.ui.notify("KCode harness message queued.", "info");
+}
+
 function workflowPromptForRun(cwd: string, run: NonNullable<ReturnType<typeof readActiveRun>>, userText: string): string {
 	const status = formatStatus(cwd, run);
 	const memory = workflowMemoryForRun(cwd, run);
@@ -243,7 +253,7 @@ const kdQuestionTool = defineTool({
 							"请先问第一个必须确认的问题，例如：",
 							"kd_question action=ask question=\"采购入库单 Form ID 是否为 pur_receivebill？\" choices=[\"是\", \"不是\"]",
 							"",
-							"注意：Pi 当前不会弹出表单；问题会显示在对话里，用户在对话中回答后再用 kd_question action=answer 记录。",
+							"注意：交互模式下会弹出选择/输入对话并自动记录；非交互模式下用户在对话中回答后再用 kd_question action=answer 记录。",
 						].join("\n"),
 					},
 				],
@@ -279,6 +289,19 @@ export default function (pi: ExtensionAPI) {
 	pi.registerTool(kdPlanStatusTool);
 	pi.registerTool(kdQuestionTool);
 
+	pi.on("session_start", async (_event, ctx) => {
+		const run = readActiveRun(ctx.cwd);
+		if (!run || !ctx.hasUI) return;
+		ctx.ui.notify(
+			[
+				`发现未完成 KCode run：${run.goal ?? run.id}`,
+				`阶段：${run.phase}，产品：${run.profile?.product ?? run.product ?? "unknown"}`,
+				"输入 /kd-resume 可接续；输入 /kd-runs 查看其他功能点。",
+			].join("\n"),
+			"info",
+		);
+	});
+
 	pi.on("input", async (event, ctx) => {
 		if (event.source === "extension") return { action: "continue" };
 
@@ -357,13 +380,27 @@ export default function (pi: ExtensionAPI) {
 
 			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");
-			const kickoff = `继续 KCode Harness run ${run.id}：${goal}`;
-			if (ctx.isIdle()) {
-				pi.sendUserMessage(kickoff);
-			} else {
-				pi.sendUserMessage(kickoff, { deliverAs: "followUp" });
-				ctx.ui.notify("KCode harness kickoff queued.", "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",
+		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");
+				return;
 			}
+
+			const note = args.trim();
+			const message = [
+				`继续 KCode Harness run ${run.id}：${run.goal ?? "unknown goal"}`,
+				note ? `用户补充：${note}` : undefined,
+			]
+				.filter(Boolean)
+				.join("\n");
+			sendWorkflowPrompt(pi, ctx, run, message);
 		},
 	});
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kcode-pi",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "Kingdee-specific package and harness for Pi Coding Agent",
   "type": "module",
   "private": false,