kcode-pi 0.1.34 → 0.1.38

package/README.md

@@ -6,12 +6,12 @@ KCode 默认面向中文用户。命令名和产品标识保持英文，例如 `
 
 ## 文档导航
 
-如果你是第一次使用，按顺序看：
+首次使用按顺序阅读：
 
 1. [用户指南](docs/USER_GUIDE.md)：安装、初始化、启动、模型配置、升级。
 2. [Harness 工作流](docs/HARNESS_WORKFLOW.md)：如何从需求进入 discuss -> spec -> plan -> execute -> verify -> ship。
 3. [产品画像确认](docs/PRODUCT_PROFILE.md)：如何用 `/kd-product` 确认苍穹、星瀚、星空旗舰版或企业版。
-4. [证据和门禁](docs/EVIDENCE_AND_GATES.md)：为什么需要 evidence、SDK 签名、TDD 红绿证据、风险确认。
+4. [证据和门禁](docs/EVIDENCE_AND_GATES.md)：evidence、SDK 签名、TDD 红绿证据和风险确认规则。
 5. [命令参考](docs/COMMAND_REFERENCE.md)：完整 `kcode` 子命令、Pi 内 `/kd-*` 命令和内置工具参数。
 6. [更新日志](docs/CHANGELOG.md)：查看版本变化、发布验证和近期改进。
 7. [故障排查](docs/TROUBLESHOOTING.md)：模型、旧版本、Windows 路径、终端显示等常见问题。
@@ -28,7 +28,7 @@ KCode 默认面向中文用户。命令名和产品标识保持英文，例如 `
 
 - Node.js `>=22.19.0`
 - npm
-- Windows 推荐使用 Windows Terminal
+- Windows 环境使用 Windows Terminal
 
 安装：
 
@@ -44,7 +44,7 @@ kcode doctor --deep
 kcode start
 ```
 
-如果首次启动提示没有模型，在 KCode/Pi 中执行：
+首次启动出现无模型信息时，在 KCode/Pi 中执行：
 
 ```text
 /login
@@ -53,19 +53,19 @@ kcode start
 
 ## 第一个需求
 
-推荐显式指定产品：
+使用显式产品参数：
 
 ```text
 /kd-start --product cangqiong 实现采购订单保存校验
 ```
 
-也可以直接提供需求文档：
+支持直接提供需求文档：
 
 ```text
 /kd-start --product cangqiong E:\project\docs\需求说明.md
 ```
 
-如果已经创建了 run，但标题栏显示产品未确认：
+已创建 run 且标题栏显示产品未确认时：
 
 ```text
 /kd-product cangqiong --version V6.0
@@ -82,7 +82,7 @@ flagship    星空旗舰版 / 基于苍穹/Cosmic
 enterprise  金蝶企业版 / C#
 ```
 
-进入 `ship` 前还需要确认风险：
+进入 `ship` 前必须确认风险：
 
 ```text
 /kd-risk low 已完成本地构建和元数据检查，无残余交付风险
@@ -156,7 +156,7 @@ KCode 只维护当前业务项目内的配置和工作流状态：
 .pi/kd/runs/<run-id>/evidence/index.json
 ```
 
-KCode 不要求你单独安装全局 `pi` 命令，也不会修改用户全局 Pi 配置。
+KCode 无需单独安装全局 `pi` 命令，也不会修改用户全局 Pi 配置。
 
 ## 升级
 
@@ -165,7 +165,7 @@ npm install -g kcode-pi@latest
 kcode version
 ```
 
-升级后建议在业务项目根目录重新执行：
+升级后在业务项目根目录重新执行：
 
 ```powershell
 kcode init

package/dist/cli/kcode.js

@@ -71,8 +71,8 @@ export function doctor(cwd, args = []) {
     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(projectContextPath) ? projectContextPath : "未创建，请运行 kcode context"}`);
+    lines.push(`项目配置：${existsSync(settingsPath) ? settingsPath : "未创建，运行 kcode init"}`);
+    lines.push(`项目上下文：${existsSync(projectContextPath) ? projectContextPath : "未创建，运行 kcode context"}`);
     if (existsSync(settingsPath)) {
         const settingsResult = readSettingsSafe(settingsPath);
         if (!settingsResult.ok) {
@@ -166,7 +166,7 @@ export function start(cwd, piArgs) {
     if (!piCli) {
         return {
             exitCode: 1,
-            output: `${init.output}\n未找到随包 Pi CLI 或全局 pi 命令。请重新安装 kcode-pi 后再运行 kcode start。`,
+            output: `${init.output}\n未找到随包 Pi CLI 或全局 pi 命令。重新安装 kcode-pi 后再运行 kcode start。`,
         };
     }
     const pi = spawnSync(piCli.command, piCli.args, { cwd, stdio: "inherit", shell: false });

package/dist/context/project-context.js

@@ -1,5 +1,6 @@
 import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { basename, extname, join, relative } from "node:path";
+import { PROJECT_PERSISTENT_RULES, formatPromptLines } from "../harness/prompt-policy.js";
 const IGNORED_DIRS = new Set([
     ".git",
     ".idea",
@@ -55,11 +56,9 @@ export function generateProjectContext(cwd) {
         "",
         "## 持久规则",
         "",
-        "- 本文件是 KCode 的项目记忆，计划或编辑代码前必须读取。",
-        "- 业务需求不得生成 demo/sample/scaffold 代码。",
-        "- 不要假设模块结构。必须基于下方真实路径，并在编辑前确认目标文件。",
-        "- 调用文件工具时优先使用项目相对路径。在 Windows 中，不要把路径改写为 /mnt/<drive>/... 或 /<drive>/...；只有确需绝对路径时才使用 Windows 路径。",
-        "- 如果本文件过期，计划前先运行 `kcode context --refresh` 重新生成。",
+        ...formatPromptLines(PROJECT_PERSISTENT_RULES),
+        "- 禁止假设模块结构。必须基于下方真实路径，并在编辑前确认目标文件。",
+        "- 调用文件工具时默认使用项目相对路径。在 Windows 中禁止把路径改写为 /mnt/<drive>/... 或 /<drive>/...；绝对路径只允许使用 Windows 路径。",
         "- 只有 Harness 进入 `execute` 且 PLAN.md 写明真实目标路径后，才能写产品代码。",
         "",
         "## 项目结构摘要",

package/dist/harness/prompt-policy.d.ts

@@ -0,0 +1,19 @@
+import type { KdPhase } from "./types.ts";
+export interface ContractField {
+    id: string;
+    label: string;
+    aliases: string[];
+    question: string;
+}
+export declare const IMPLEMENTATION_CONTRACT_FIELDS: ContractField[];
+export declare const DATA_SOURCE_CONTEXT_FIELDS: ContractField[];
+export declare const INTEGRATION_CONTEXT_FIELDS: ContractField[];
+export declare const PROJECT_PERSISTENT_RULES: string[];
+export declare const PROMPT_STYLE_RULES: string[];
+export declare const CORE_WORKFLOW_CONSTRAINTS: string[];
+export declare const PHASE_GUIDANCE: Record<KdPhase, string>;
+export declare const PLAN_REQUIRED_CHECK_LINES: string[];
+export declare function formatPromptLines(lines: string[]): string[];
+export declare function fieldLabels(fields: ContractField[]): string[];
+export declare function questionForMissingLabel(label: string): string | undefined;
+export declare function canonicalFactLabel(label: string): string | undefined;

package/dist/harness/prompt-policy.js

@@ -0,0 +1,206 @@
+export const IMPLEMENTATION_CONTRACT_FIELDS = [
+    {
+        id: "trigger",
+        label: "触发入口或执行时机",
+        aliases: ["触发入口", "执行时机", "触发时机", "插件类型和事件", "入口事件"],
+        question: "该实现由哪个入口触发，执行时机是什么？",
+    },
+    {
+        id: "source",
+        label: "源对象/输入数据",
+        aliases: ["源对象", "源单", "输入数据", "数据来源", "取数来源"],
+        question: "实现读取的源对象或输入数据是什么？",
+    },
+    {
+        id: "target",
+        label: "目标对象/输出结果",
+        aliases: ["目标对象", "目标单据", "目标表单", "输出结果", "生成结果"],
+        question: "实现写入、生成或影响的目标对象是什么？",
+    },
+    {
+        id: "data-change",
+        label: "数据变化或字段映射",
+        aliases: ["数据变化", "字段映射", "字段对应", "字段改写", "赋值规则"],
+        question: "列出新增、修改、映射或保持不变的字段。",
+    },
+    {
+        id: "rules",
+        label: "业务规则和适用条件",
+        aliases: ["业务规则", "适用条件", "执行条件", "过滤条件", "前置条件"],
+        question: "该实现在哪些条件下执行，业务规则是什么？",
+    },
+    {
+        id: "failure",
+        label: "失败处理、回滚或人工处理方式",
+        aliases: ["失败处理", "异常处理", "错误处理", "回滚", "补偿", "人工处理"],
+        question: "失败、异常或重复执行时如何处理？",
+    },
+    {
+        id: "acceptance",
+        label: "验收样例或测试数据",
+        aliases: ["验收样例", "测试数据", "请求样例", "响应样例", "示例数据"],
+        question: "用于验收的样例数据和预期结果是什么？",
+    },
+];
+export const DATA_SOURCE_CONTEXT_FIELDS = [
+    {
+        id: "target-form",
+        label: "目标 FormId/单据或表单标识",
+        aliases: ["目标 FormId", "FormId", "Form ID", "form id", "表单标识", "单据标识", "目标单据", "目标表单"],
+        question: "目标 FormId、单据或表单标识是什么？",
+    },
+    {
+        id: "plugin-hook",
+        label: "插件类型和触发事件",
+        aliases: ["插件类型", "触发事件", "生命周期", "挂载点", "插件类型和事件"],
+        question: "插件类型和触发事件是什么？",
+    },
+    {
+        id: "field-entity",
+        label: "字段/实体/分录标识",
+        aliases: ["字段标识", "实体标识", "分录标识", "单据体标识", "字段/实体标识"],
+        question: "涉及哪些字段、实体或分录标识？",
+    },
+    {
+        id: "data-access",
+        label: "数据读取写入方式",
+        aliases: ["数据读取写入方式", "读取方式", "写入方式", "数据访问", "取数方式"],
+        question: "数据通过表单模型、服务、SQL/KSQL 还是接口读取和写入？",
+    },
+    {
+        id: "sql-identifiers",
+        label: "SQL/KSQL 表名和数据库字段名",
+        aliases: ["SQL 表名", "KSQL 表名", "表名", "数据库字段名", "字段名"],
+        question: "SQL/KSQL 场景的表名和数据库字段名是什么？",
+    },
+];
+export const INTEGRATION_CONTEXT_FIELDS = [
+    {
+        id: "interface-doc",
+        label: "接口文档来源/版本",
+        aliases: ["接口文档", "API 文档", "文档来源", "协议文档", "OpenAPI", "Swagger"],
+        question: "第三方接口文档来源和版本是什么？",
+    },
+    {
+        id: "direction",
+        label: "对接方向和触发时机",
+        aliases: ["对接方向", "触发时机", "同步方向", "数据流向"],
+        question: "对接方向、调用方和触发时机是什么？",
+    },
+    {
+        id: "endpoint-auth",
+        label: "接口地址、认证和密钥配置方式",
+        aliases: ["接口地址", "认证", "鉴权", "密钥", "Token", "OAuth"],
+        question: "接口地址、认证方式和密钥配置方式是什么？",
+    },
+    {
+        id: "field-mapping",
+        label: "第三方字段到金蝶字段的映射",
+        aliases: ["字段映射", "映射关系", "字段对应", "字段对照"],
+        question: "第三方字段与金蝶字段如何对应？",
+    },
+    {
+        id: "concurrency",
+        label: "并发/幂等策略",
+        aliases: ["并发", "幂等", "去重", "唯一键", "重复提交"],
+        question: "并发、重复提交和幂等如何处理？",
+    },
+    {
+        id: "retry",
+        label: "超时、重试和限流策略",
+        aliases: ["超时", "重试", "限流", "频率", "熔断"],
+        question: "超时、重试和限流策略是什么？",
+    },
+    {
+        id: "error",
+        label: "错误处理和失败补偿",
+        aliases: ["错误处理", "异常处理", "失败处理", "失败补偿", "告警"],
+        question: "接口失败、异常响应和补偿流程如何处理？",
+    },
+    {
+        id: "logging",
+        label: "日志、审计和敏感信息脱敏策略",
+        aliases: ["日志", "审计", "留痕", "脱敏", "敏感信息"],
+        question: "列出日志字段、审计留痕和敏感信息脱敏规则。",
+    },
+    {
+        id: "samples",
+        label: "请求/响应样例和验收数据",
+        aliases: ["请求样例", "响应样例", "报文样例", "验收数据", "payload"],
+        question: "请求样例、响应样例和验收数据是什么？",
+    },
+];
+export const PROJECT_PERSISTENT_RULES = [
+    "计划或编辑代码前必须读取本文件；本文件过期时先运行 `kcode context --refresh`。",
+    "信息不足时禁止开始编码。必须先登记一个最阻塞的结构化问题，获得可核验答案后再继续；禁止输出 demo/sample/scaffold、模板代码或占位实现。",
+    "API 文档、SDK 文档和知识库只能证明技术用法，不能替代业务事实。FormId、单据/表单标识、字段/实体/分录标识、插件类型与事件、SQL/KSQL 表名和数据库字段名必须来自用户确认、项目元数据或 evidence。",
+    `产品代码实现前必须具备通用实现契约：${IMPLEMENTATION_CONTRACT_FIELDS.map((field) => field.label).join("、")}。`,
+    `涉及业务数据源时必须具备数据源上下文：${DATA_SOURCE_CONTEXT_FIELDS.map((field) => field.label).join("、")}。`,
+    `涉及第三方对接时必须具备接口与运行上下文：${INTEGRATION_CONTEXT_FIELDS.map((field) => field.label).join("、")}。`,
+    "内部插件、自动下推、字段改写、数据同步等需求不得按场景写死提示词；统一通过实现契约、数据源上下文、第三方对接上下文补齐事实。",
+    "PLAN 自由文本不能单独证明 FormId、字段、插件事件或读写方式；门禁只信任结构化 facts 和 evidence。",
+    "`run.facts` 是唯一结构化事实源；已回答 questions 仅为审计记录，禁止在读取状态时从历史 question 反推事实。",
+    "`factLabel` 必须使用集中定义的事实标签或别名；未知标签、占位答案、口头确认语、待确认/TODO/TBD/按实际环境等不能解除门禁。",
+    "用户回答 open question 后，先用 `kd_question action=answer` 写入答案；用户更正事实时用 `kd_question action=revise`，禁止重复询问已确认事实。",
+    "企业版 Python 插件通常没有本地构建可替代验证；BOS 注册、外部系统操作、人工功能测试和生产环境验证必须由用户提供可核验证据并记录来源。",
+    "提示语集中管理为正式工程指令；禁止口语化、闲聊式、鼓励式提示词进入运行时规则。",
+    "不做旧状态迁移兼容或旧问题答案推断；坏状态只过滤，缺失事实必须重新提问确认。",
+];
+export const PROMPT_STYLE_RULES = [
+    "使用正式、可执行的工程指令；禁止口语化、闲聊式、鼓励式表达。",
+    "事实不足时生成阻断问题；禁止输出模板代码、占位实现或基于猜测的业务标识。",
+    "每次只提出一个最阻塞问题；问题必须指向可验证事实、数据标识或验收证据。",
+    "引用顺序：当前项目文件、PLAN/SPEC、元数据 evidence、SDK 签名、验证输出。",
+];
+export const CORE_WORKFLOW_CONSTRAINTS = [
+    "产品代码只在 execute 阶段写入，并限于 PLAN.md 批准的文件。",
+    "写代码前必须具备通用实现契约：触发入口、源对象/输入数据、目标对象/输出结果、数据变化或字段映射、业务规则、失败处理和验收样例。",
+    "业务数据源未知时禁止编码；确认目标 FormId/单据或表单、插件类型和事件、字段/实体/分录标识、数据读取写入方式后再编码；SQL/KSQL 同步确认表名和数据库字段名。",
+    "第三方对接确认接口文档、对接方向、触发时机、认证配置、字段映射、并发/幂等、重试超时限流、错误补偿、日志脱敏和验收样例后再编码。",
+    "事实缺失时使用 kd_question 登记一个最阻塞问题；禁止用 API 文档、SDK 知识库或推测替代业务事实。",
+    "用户输入是在回答 open question 时，必须先调用 kd_question action=answer 记录答案，再继续推进或登记下一个问题。",
+    "同一 factLabel 已有当前事实时禁止重复提问；用户明确更正时使用 kd_question action=revise 记录新事实和更正原因。",
+    "run.facts 是唯一结构化事实源；questions 仅作为问答审计记录，禁止从历史 question 反推门禁事实。",
+    "待确认、未知、按实际环境、TODO/TBD 等占位答案不能解除门禁。",
+    "Java/C# SDK 签名以当前项目 jar/dll、构建输出或官方元数据为准。",
+    "Java/Cosmic 使用当前项目 Gradle；C#/企业版使用 dotnet build。",
+    "evidence 必须记录命令、Exit 和关键输出；命令无法运行时记录阻塞原因。",
+    "外部系统操作、BOS 注册、人工功能测试和生产环境验证不能由 LLM 代办；必须要求用户提供验证结果或可核验证据，并记录证据来源。",
+    "Windows 路径规则：项目相对路径为默认；绝对路径使用 D:\\... 形式。",
+];
+export const PHASE_GUIDANCE = {
+    discuss: "梳理需求来源、范围、已知事实；如缺通用实现契约、数据源或第三方接口关键事实，使用 kd_question 登记一个最阻塞问题。",
+    spec: "将需求转成验收标准、实现契约、数据对象、接口契约、异常行为、依赖和风险；数据对象和字段映射必须落到可核验标识。",
+    plan: "检查项目结构，写明目标路径、允许修改文件、通用实现契约、数据源/元数据查证项、第三方接口契约、插件挂载点、验证命令和回滚说明。",
+    execute: "按 PLAN.md 实现，记录步骤结果、变更文件和 evidence。",
+    verify: "运行计划中的验证命令，并用 kd_verify_result 记录结果；失败会回到 execute 修复，成功后更新 VERIFY.md、证据和残余风险。",
+    ship: "整理 SHIP.md，包括摘要、验证证据、风险和后续事项。",
+};
+export const PLAN_REQUIRED_CHECK_LINES = [
+    "涉及表单、单据、字段、实体、SQL/KSQL、数据读取写入或插件事件时，确认真实数据源/元数据后再编码；禁止只根据 API 文档编码。",
+    "Cosmic 家族数据源证据：evidence/cosmic-metadata.json；企业版/BOS 数据源证据：evidence/data-source.md。",
+    `所有产品代码实现必须写明通用实现契约后再编码：${IMPLEMENTATION_CONTRACT_FIELDS.map((field) => field.label).join("、")}。`,
+    `进入 execute 前必须写明：${DATA_SOURCE_CONTEXT_FIELDS.map((field) => field.label).join("、")}。`,
+    `第三方对接必须写明：${INTEGRATION_CONTEXT_FIELDS.map((field) => field.label).join("、")}。`,
+    "Java/C# 代码涉及 SDK 类、方法、构造器、枚举、属性时，使用 kd_sdk_signature 或项目构建输出确认真实签名后再编码。",
+    "知识库搜索、随包 Cosmic API 查询只能作为线索，不能作为最终方法签名事实。",
+    "SDK 签名证据：evidence/sdk-signature.md",
+];
+export function formatPromptLines(lines) {
+    return lines.map((line) => `- ${line}`);
+}
+export function fieldLabels(fields) {
+    return fields.map((field) => field.label);
+}
+export function questionForMissingLabel(label) {
+    const fields = [...IMPLEMENTATION_CONTRACT_FIELDS, ...DATA_SOURCE_CONTEXT_FIELDS, ...INTEGRATION_CONTEXT_FIELDS];
+    return fields.find((field) => field.label === label)?.question;
+}
+export function canonicalFactLabel(label) {
+    const normalized = normalizeLabel(label);
+    const fields = [...IMPLEMENTATION_CONTRACT_FIELDS, ...DATA_SOURCE_CONTEXT_FIELDS, ...INTEGRATION_CONTEXT_FIELDS];
+    return fields.find((field) => [field.label, ...field.aliases].some((item) => normalizeLabel(item) === normalized))?.label;
+}
+function normalizeLabel(label) {
+    return label.trim().toLowerCase().replace(/\s+/g, "");
+}

package/dist/harness/types.d.ts

@@ -0,0 +1,74 @@
+import type { KdProduct, ProductProfile } from "../product/profile.ts";
+export type KdPhase = "discuss" | "spec" | "plan" | "execute" | "verify" | "ship";
+export type KdRisk = "low" | "medium" | "high";
+export type KdRunStatus = "active" | "paused" | "done";
+export type KdRiskSource = "manual" | "verify" | "ship";
+export interface RiskAssessment {
+    level: KdRisk;
+    reason: string;
+    source: KdRiskSource;
+    updatedAt: string;
+}
+export interface GateResult {
+    passed: boolean;
+    reason?: string;
+    checkedAt: string;
+}
+export interface RepairState {
+    attempts: number;
+    maxAttempts: number;
+    lastFailureEvidence?: string;
+    lastFailureSignature?: string;
+    status: "idle" | "repairing" | "blocked";
+    updatedAt: string;
+}
+export interface KdQuestion {
+    id: string;
+    phase: KdPhase;
+    question: string;
+    reason?: string;
+    factLabel?: string;
+    proposedFactValue?: string;
+    choices?: string[];
+    blocking: boolean;
+    status: "open" | "answered";
+    answer?: string;
+    createdAt: string;
+    answeredAt?: string;
+}
+export type KdFactStatus = "current" | "superseded" | "rejected";
+export type KdFactSource = "question" | "manual";
+export interface KdFact {
+    key: string;
+    label: string;
+    value: string;
+    status: KdFactStatus;
+    source: KdFactSource;
+    sourceQuestionId?: string;
+    reason?: string;
+    createdAt: string;
+    updatedAt: string;
+    supersededBy?: string;
+}
+export interface ActiveRun {
+    id: string;
+    goal?: string;
+    phase: KdPhase;
+    cwd: string;
+    status?: KdRunStatus;
+    createdAt?: string;
+    updatedAt?: string;
+    product?: KdProduct;
+    version?: string;
+    profile?: ProductProfile;
+    riskAssessment?: RiskAssessment;
+    repair?: RepairState;
+    artifacts: Record<string, string>;
+    gate: GateResult;
+    questions?: KdQuestion[];
+    facts?: KdFact[];
+}
+export declare const PHASE_ORDER: KdPhase[];
+export declare const PHASE_ARTIFACTS: Record<KdPhase, string>;
+export declare function isKdPhase(value: string): value is KdPhase;
+export declare function nextPhase(phase: KdPhase): KdPhase | undefined;

package/dist/harness/types.js

@@ -0,0 +1,16 @@
+export const PHASE_ORDER = ["discuss", "spec", "plan", "execute", "verify", "ship"];
+export const PHASE_ARTIFACTS = {
+    discuss: "CONTEXT.md",
+    spec: "SPEC.md",
+    plan: "PLAN.md",
+    execute: "EXECUTION.md",
+    verify: "VERIFY.md",
+    ship: "SHIP.md",
+};
+export function isKdPhase(value) {
+    return PHASE_ORDER.includes(value);
+}
+export function nextPhase(phase) {
+    const index = PHASE_ORDER.indexOf(phase);
+    return index >= 0 ? PHASE_ORDER[index + 1] : undefined;
+}

package/dist/product/profile.d.ts

@@ -0,0 +1,20 @@
+export type KdProduct = "unknown" | "flagship" | "xinghan" | "cangqiong" | "enterprise";
+export type KdPlatform = "unknown" | "cosmic" | "enterprise-csharp" | "enterprise-python";
+export type KdTechStack = "unknown" | "java-bos" | "java-cosmic" | "csharp-bos" | "python-bos" | "ksql";
+export type KdLanguage = "unknown" | "java" | "csharp" | "python" | "sql";
+export type KnowledgeScope = "common" | "flagship" | "enterprise" | "enterprise-python" | "cosmic" | "xinghan" | "cangqiong";
+export interface ProductProfile {
+    product: KdProduct;
+    displayName: string;
+    platform: KdPlatform;
+    techStack: KdTechStack;
+    language: KdLanguage;
+    knowledgeScope: KnowledgeScope;
+    requiresMetadataVerification: boolean;
+    notes: string[];
+}
+export declare function profileForProduct(product: KdProduct | undefined): ProductProfile;
+export declare function resolveProductProfile(input: string | undefined): ProductProfile;
+export declare function normalizeProduct(value: string | undefined): KdProduct;
+export declare function isKnownProduct(product: KdProduct | undefined): boolean;
+export declare function formatProductProfile(profile: ProductProfile | undefined): string;

package/dist/product/profile.js

@@ -0,0 +1,103 @@
+const PROFILES = {
+    unknown: {
+        product: "unknown",
+        displayName: "unknown",
+        platform: "unknown",
+        techStack: "unknown",
+        language: "unknown",
+        knowledgeScope: "common",
+        requiresMetadataVerification: true,
+        notes: ["尚未选择产品；禁止假设插件技术栈、BOS/Cosmic 平台规则或 KSQL/SQL 交付规则。"],
+    },
+    flagship: {
+        product: "flagship",
+        displayName: "金蝶星空旗舰版",
+        platform: "cosmic",
+        techStack: "java-cosmic",
+        language: "java",
+        knowledgeScope: "flagship",
+        requiresMetadataVerification: true,
+        notes: [
+            "星空旗舰版基于苍穹/Cosmic 平台。使用平台元数据、插件生命周期、SDK 和后置检查约束，但接口可能存在旗舰版差异。",
+            "当前工作区存在 code/ 目录时，产品代码必须放在 code/ 下。",
+            "创建或编辑代码前，必须检查 code/ 下真实项目结构，并跟随其实际布局；可能按云、按应用组织，也可能不分模块。",
+        ],
+    },
+    xinghan: {
+        product: "xinghan",
+        displayName: "金蝶星瀚",
+        platform: "cosmic",
+        techStack: "java-cosmic",
+        language: "java",
+        knowledgeScope: "xinghan",
+        requiresMetadataVerification: true,
+        notes: ["星瀚基于苍穹/Cosmic 平台。默认按平台 Java 插件处理，但接口可能存在星瀚差异。"],
+    },
+    cangqiong: {
+        product: "cangqiong",
+        displayName: "金蝶苍穹",
+        platform: "cosmic",
+        techStack: "java-cosmic",
+        language: "java",
+        knowledgeScope: "cangqiong",
+        requiresMetadataVerification: true,
+        notes: ["Cosmic 在 KCode 中按苍穹平台语境处理。使用苍穹/Cosmic 平台插件、SDK、元数据、KSQL/SQL 和生命周期规则。"],
+    },
+    enterprise: {
+        product: "enterprise",
+        displayName: "金蝶企业版",
+        platform: "enterprise-csharp",
+        techStack: "csharp-bos",
+        language: "csharp",
+        knowledgeScope: "enterprise",
+        requiresMetadataVerification: true,
+        notes: ["使用企业版 C# 技术栈。Java 插件规则和 Cosmic API 不适用。"],
+    },
+};
+const PRODUCT_ALIASES = [
+    [/企业版|enterprise|csharp|c#|\.net/i, "enterprise"],
+    [/星瀚|xinghan/i, "xinghan"],
+    [/苍穹|cangqiong/i, "cangqiong"],
+    [/cosmic|云苍穹/i, "cangqiong"],
+    [/星空旗舰版|星空旗舰|旗舰版|旗舰|flagship/i, "flagship"],
+];
+const ENTERPRISE_PYTHON_PATTERN = /(?:python|py)\s*(?:插件|plugin)|(?:python|py).*?(?:插件|plugin)|ironpython|(?:企业版|enterprise|星空|金蝶云星空|BOS).*?python\s*脚本|python\s*脚本.*?(?:企业版|enterprise|星空|金蝶云星空|BOS)/i;
+function enterprisePythonProfile() {
+    return {
+        ...PROFILES.enterprise,
+        platform: "enterprise-python",
+        techStack: "python-bos",
+        language: "python",
+        knowledgeScope: "enterprise-python",
+        notes: [
+            "只有用户明确要求 Python 插件或 IronPython 脚本时，才使用金蝶云企业版 / BOS IronPython 插件模式。",
+            "企业版默认插件开发仍按 C# 处理，除非用户明确要求 Python 插件。",
+            "Python 插件通过 BOS 中的 IronPython 运行，并调用 Kingdee.BOS .NET 程序集；编码前必须确认插件类型、事件、FormId、字段标识和注册步骤。",
+        ],
+    };
+}
+export function profileForProduct(product) {
+    return PROFILES[product ?? "unknown"] ?? PROFILES.unknown;
+}
+export function resolveProductProfile(input) {
+    const text = input?.trim();
+    if (!text)
+        return profileForProduct("unknown");
+    if (ENTERPRISE_PYTHON_PATTERN.test(text))
+        return enterprisePythonProfile();
+    for (const [pattern, product] of PRODUCT_ALIASES) {
+        if (pattern.test(text))
+            return profileForProduct(product);
+    }
+    return profileForProduct("unknown");
+}
+export function normalizeProduct(value) {
+    return resolveProductProfile(value).product;
+}
+export function isKnownProduct(product) {
+    return Boolean(product && product !== "unknown");
+}
+export function formatProductProfile(profile) {
+    const resolved = profile ?? profileForProduct("unknown");
+    return `${resolved.product}/${resolved.platform}/${resolved.techStack}/${resolved.language}`;
+}