kcode-pi 0.1.42 → 0.1.43

package/dist/harness/prompt-policy.js

@@ -148,6 +148,7 @@ export const PROJECT_PERSISTENT_RULES = [
     "提示语集中管理为正式工程指令；禁止口语化、闲聊式、鼓励式提示词进入运行时规则。",
     "工具使用必须匹配当前会话实际可用工具和操作系统；Windows 默认使用 PowerShell、`rg`、`Get-ChildItem`、`Get-Content`，禁止假设 bash 可用。",
     "Windows 查找文件和目录时优先使用 `kd_find_file`、`kd_list_dir` 或 PowerShell；禁止用 Linux find/ls 语法反复调用 Pi 内置 bash。",
+    "写入或编辑文件时禁止使用当前工作区外的绝对路径；生产源码必须使用当前业务项目相对路径，并受 PLAN.md 批准文件约束。",
     "文件定位必须使用真实搜索或目录读取结果；工具不可用时明确说明阻塞原因和需要用户执行的命令，禁止猜测路径、反复自述工具失败或用 kd_subagent 代替基础文件搜索。",
     "不做旧状态迁移兼容或旧问题答案推断；坏状态只过滤，缺失事实必须重新提问确认。",
 ];
@@ -192,6 +193,7 @@ export const PROMPT_PROHIBITED_BEHAVIORS = [
     "禁止一次性向用户索要多项业务信息。",
     "禁止重复询问已确认事实或已存在 open blocking question 的问题。",
     "禁止猜测路径、包名、类名、FormId、字段、实体、SQL 表名、数据库字段名或接口字段映射。",
+    "禁止写入或编辑当前工作区外的绝对路径。",
     "禁止用子 agent、shell 失败自述或自由文本计划绕过门禁。",
     "禁止将外部系统操作、BOS 注册、人工功能测试或生产验证描述为 LLM 已完成。",
 ];
@@ -210,7 +212,7 @@ export const CORE_WORKFLOW_CONSTRAINTS = [
     "Java/Cosmic 使用当前项目 Gradle；C#/企业版使用 dotnet build。",
     "evidence 必须记录命令、Exit 和关键输出；命令无法运行时记录阻塞原因。",
     "外部系统操作、BOS 注册、人工功能测试和生产环境验证不能由 LLM 代办；必须要求用户提供验证结果或可核验证据，并记录证据来源。",
-    "Windows 路径规则：项目相对路径为默认；绝对路径使用 D:\\... 形式。",
+    "Windows 路径规则：读取可使用工作区内绝对路径；写入和编辑必须使用当前工作区内路径，默认使用项目相对路径。禁止写入 C:\\Users、Desktop 或其他非当前工作区路径。",
     "工具规则：按当前会话实际 shell 和工具执行；Windows 不假设 bash，优先用 kd_find_file/kd_list_dir/PowerShell；禁止猜路径或用 kd_subagent 代替基础搜索失败。",
 ];
 export const PHASE_GUIDANCE = {

package/docs/CHANGELOG.md

@@ -6,6 +6,19 @@
 
 - 暂无。
 
+## 0.1.43 - 2026-06-07
+
+### 修复
+
+- `write`/`edit` 工具调用新增工作区外绝对路径拦截，禁止直接写入 `C:/Users`、Desktop 或其他非当前工作区路径。
+- Windows 路径规则补充为写入必须使用当前项目相对路径或工作区内路径，避免外部绝对路径触发上游写入超时。
+- Harness smoke 增加 `C:/Users/...` 外部路径判定回归测试。
+
+### 验证
+
+- `npm run check`
+- `npm run smoke:harness`
+
 ## 0.1.42 - 2026-06-07
 
 ### 改进

package/extensions/kingdee-harness.ts

@@ -26,7 +26,7 @@ import { flagshipWriteBlockReason, isSourceLikePath, planWriteBlockReason } from
 import { sdkSignatureProductionWriteBlockReason } from "../src/harness/sdk-policy.ts";
 import { dataSourceProductionWriteBlockReason } from "../src/harness/data-source-policy.ts";
 import { tddProductionWriteBlockReason } from "../src/harness/tdd-policy.ts";
-import { windowsPathHint } from "../src/platform/path.ts";
+import { isExternalAbsolutePath, isPathInsideWorkspace, windowsPathHint } from "../src/platform/path.ts";
 import { repairPromptForRun, workflowPromptForRun } from "../src/harness/prompt.ts";
 import { recordVerifyResult, type VerifyResultOutcome } from "../src/harness/repair.ts";
 import { isSubagentChild, subagentRoleFromEnv, subagentToolCallBlockReason } from "../src/harness/delegation.ts";
@@ -157,6 +157,12 @@ function codeWriteBlockReason(cwd: string, path: string | undefined): string | u
 	);
 }
 
+function externalWriteBlockReason(cwd: string, toolName: string, path: string | undefined): string | undefined {
+	if (!path || !["write", "edit"].includes(toolName)) return undefined;
+	if (!isExternalAbsolutePath(path) || isPathInsideWorkspace(cwd, path)) return undefined;
+	return `拒绝写入工作区外绝对路径 ${path}。执行指令：先确认当前业务项目根目录；生产源码必须使用当前项目相对路径，并受 PLAN.md 批准文件、execute 阶段和证据门禁约束。禁止直接写入 C:/Users、Desktop 或其他非当前工作区路径。`;
+}
+
 const kdPlanStatusTool = defineTool({
 	name: "kd_plan_status",
 	label: "KD 状态",
@@ -427,6 +433,11 @@ export default function (pi: ExtensionAPI) {
 	pi.on("tool_call", (event, ctx) => {
 		const input = event.input as Record<string, unknown>;
 		const path = typeof input.path === "string" ? input.path : undefined;
+		const externalWriteReason = externalWriteBlockReason(ctx.cwd, event.toolName, path);
+		if (externalWriteReason) {
+			if (ctx.hasUI) ctx.ui.notify(externalWriteReason, "warning");
+			return { block: true, reason: externalWriteReason };
+		}
 		const hint = path ? windowsPathHint(path) : undefined;
 		if (hint && ["read", "write", "edit"].includes(event.toolName)) {
 			const reason = `当前是 Windows 工作区，路径 ${path} 不是本项目使用的路径形式。执行指令：改用项目相对路径；必须使用绝对路径时，使用 Windows 路径 ${hint}。`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kcode-pi",
-  "version": "0.1.42",
+  "version": "0.1.43",
   "description": "面向金蝶开发的 Pi Coding Agent 启动器、工具包和 Harness 工作流",
   "type": "module",
   "private": false,

package/src/harness/prompt-policy.ts

@@ -160,6 +160,7 @@ export const PROJECT_PERSISTENT_RULES = [
 	"提示语集中管理为正式工程指令；禁止口语化、闲聊式、鼓励式提示词进入运行时规则。",
 	"工具使用必须匹配当前会话实际可用工具和操作系统；Windows 默认使用 PowerShell、`rg`、`Get-ChildItem`、`Get-Content`，禁止假设 bash 可用。",
 	"Windows 查找文件和目录时优先使用 `kd_find_file`、`kd_list_dir` 或 PowerShell；禁止用 Linux find/ls 语法反复调用 Pi 内置 bash。",
+	"写入或编辑文件时禁止使用当前工作区外的绝对路径；生产源码必须使用当前业务项目相对路径，并受 PLAN.md 批准文件约束。",
 	"文件定位必须使用真实搜索或目录读取结果；工具不可用时明确说明阻塞原因和需要用户执行的命令，禁止猜测路径、反复自述工具失败或用 kd_subagent 代替基础文件搜索。",
 	"不做旧状态迁移兼容或旧问题答案推断；坏状态只过滤，缺失事实必须重新提问确认。",
 ];
@@ -210,6 +211,7 @@ export const PROMPT_PROHIBITED_BEHAVIORS = [
 	"禁止一次性向用户索要多项业务信息。",
 	"禁止重复询问已确认事实或已存在 open blocking question 的问题。",
 	"禁止猜测路径、包名、类名、FormId、字段、实体、SQL 表名、数据库字段名或接口字段映射。",
+	"禁止写入或编辑当前工作区外的绝对路径。",
 	"禁止用子 agent、shell 失败自述或自由文本计划绕过门禁。",
 	"禁止将外部系统操作、BOS 注册、人工功能测试或生产验证描述为 LLM 已完成。",
 ];
@@ -229,7 +231,7 @@ export const CORE_WORKFLOW_CONSTRAINTS = [
 	"Java/Cosmic 使用当前项目 Gradle；C#/企业版使用 dotnet build。",
 	"evidence 必须记录命令、Exit 和关键输出；命令无法运行时记录阻塞原因。",
 	"外部系统操作、BOS 注册、人工功能测试和生产环境验证不能由 LLM 代办；必须要求用户提供验证结果或可核验证据，并记录证据来源。",
-	"Windows 路径规则：项目相对路径为默认；绝对路径使用 D:\\... 形式。",
+	"Windows 路径规则：读取可使用工作区内绝对路径；写入和编辑必须使用当前工作区内路径，默认使用项目相对路径。禁止写入 C:\\Users、Desktop 或其他非当前工作区路径。",
 	"工具规则：按当前会话实际 shell 和工具执行；Windows 不假设 bash，优先用 kd_find_file/kd_list_dir/PowerShell；禁止猜路径或用 kd_subagent 代替基础搜索失败。",
 ];
 

package/src/platform/path.ts

@@ -1,4 +1,4 @@
-import { isAbsolute, resolve } from "node:path";
+import { isAbsolute, relative, resolve } from "node:path";
 
 const WINDOWS_DRIVE_RE = /^[a-zA-Z]:[\\/]/;
 
@@ -7,6 +7,18 @@ export function resolveWorkspacePath(cwd: string, inputPath: string): string {
 	return isAbsolute(normalized) || WINDOWS_DRIVE_RE.test(normalized) ? resolve(normalized) : resolve(cwd, normalized);
 }
 
+export function isExternalAbsolutePath(inputPath: string): boolean {
+	const normalized = normalizeExternalPath(inputPath);
+	return isAbsolute(normalized) || WINDOWS_DRIVE_RE.test(normalized);
+}
+
+export function isPathInsideWorkspace(cwd: string, inputPath: string): boolean {
+	const workspace = resolve(cwd);
+	const target = resolveWorkspacePath(cwd, inputPath);
+	const rel = relative(workspace, target);
+	return rel === "" || (!rel.startsWith("..") && !isAbsolute(rel));
+}
+
 export function normalizeExternalPath(inputPath: string): string {
 	let value = inputPath.trim();
 	if (value.startsWith("file://")) {