kcode-pi 0.1.20 → 0.1.23

package/dist/cli/kcode.js

@@ -166,7 +166,7 @@ export function start(cwd, piArgs) {
     if (!piCli) {
         return {
             exitCode: 1,
-            output: `${init.output}\n未找到随包 Pi CLI 或全局 pi 命令。请重新安装 kcode-cli 后再运行 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 });
@@ -294,7 +294,7 @@ function piCliPackageVersion(piCli) {
 }
 function helpText() {
     return [
-        "KCode 企业入口",
+        "KCode 金蝶开发入口",
         "",
         "用法：",
         "  kcode init      初始化当前项目的 .pi/settings.json",

package/docs/CHANGELOG.md

@@ -0,0 +1,60 @@
+# 更新日志
+
+本文记录 KCode 的重要版本变化。版本号以 `package.json` 为准。
+
+## 未发布
+
+### 新增
+
+- 新增更新日志文档，并在 README 文档导航中提供入口。
+
+## 0.1.23 - 2026-06-07
+
+### 新增
+
+- 支持工程化需求工作流，覆盖需求讨论、规格、计划、执行、验证和发布推进。
+
+### 改进
+
+- 将包版本更新到 `0.1.23`，并同步 `package-lock.json` 顶层版本信息。
+- 改进文档示例、用户文档和 README 使用说明。
+- 优化 Harness 门禁、证据跟踪、恢复流程和风险确认提示。
+- 使用 Gradle 和 dotnet 作为对应产品画像的构建验证入口。
+- 本地化 KCode prompts，并要求关键 SDK 结论提供签名证据。
+
+### 验证
+
+- `npm run release:check` 通过，包含 TypeScript 检查、CLI 构建、Harness smoke、KCode 命令 smoke、SDK 签名 smoke、package smoke 和 pack dry run。
+
+## 0.1.12 - 2026-06-06
+
+### 新增
+
+- 增加本地 SDK 签名检查能力，用于从当前项目实际 jar/dll 中读取类和方法签名。
+- 增加 Harness 阻断问题记录、回答和恢复流程。
+- 增加生产就绪检查和更严格的 vendor runtime、reviewer 规则。
+
+### 改进
+
+- 强化 Harness run、问题状态和门禁修复指引。
+- 启动后自动进入 Harness 引导，减少首次使用路径断点。
+
+## 0.1.5 - 2026-06-06
+
+### 新增
+
+- 发布 `kcode-pi` npm 包，提供全局 `kcode` 命令和随包 Pi 工作环境。
+- 打包金蝶专属 extensions、skills、prompts、themes、知识库和 vendor 资料。
+
+## 0.1.4 - 2026-06-06
+
+### 新增
+
+- 准备 KCode npm 分发能力和基础 CLI 入口。
+
+## 0.1.3 - 2026-06-06
+
+### 新增
+
+- 准备早期 `kcode-pi` 发布版本。
+- 增加自定义模型供应商说明。

package/docs/COMMAND_REFERENCE.md

@@ -0,0 +1,512 @@
+# 命令参考
+
+本文集中说明 KCode 的终端命令、Pi 内命令和内置工具参数。首次使用请先看 [用户指南](USER_GUIDE.md)，工作流顺序请看 [Harness 工作流](HARNESS_WORKFLOW.md)。
+
+## 终端命令
+
+终端命令在业务项目根目录执行。
+
+### kcode help
+
+显示帮助：
+
+```powershell
+kcode help
+kcode --help
+```
+
+### kcode version
+
+显示 KCode、随包 Pi CLI 和 Node 版本：
+
+```powershell
+kcode version
+kcode --version
+kcode -v
+```
+
+### kcode init
+
+初始化当前业务项目的 Pi package 配置，并生成项目上下文：
+
+```powershell
+kcode init
+```
+
+会写入或更新：
+
+```text
+.pi/settings.json
+.pi/kd/PROJECT_CONTEXT.md
+```
+
+### kcode context
+
+生成或读取项目常驻上下文：
+
+```powershell
+kcode context
+```
+
+项目结构变化后强制刷新：
+
+```powershell
+kcode context --refresh
+kcode context -r
+```
+
+### kcode doctor
+
+检查 Node、Pi CLI、KCode package、项目级配置和项目上下文：
+
+```powershell
+kcode doctor
+```
+
+深度检查会额外检查 Node 版本、全局 npm 目录、旧 KCode package 路径和 active run：
+
+```powershell
+kcode doctor --deep
+```
+
+### kcode repair
+
+清理旧 KCode package 路径，保留当前安装路径，并刷新项目上下文：
+
+```powershell
+kcode repair
+```
+
+升级后或 `doctor --deep` 提示旧路径时使用。
+
+### kcode start
+
+启动 KCode/Pi 工作环境：
+
+```powershell
+kcode start
+```
+
+`start` 会先自动执行项目级初始化，再启动随包 Pi CLI。后续参数会原样传给 Pi CLI：
+
+```powershell
+kcode start --provider openai --model gpt-4o
+```
+
+## Pi 内命令
+
+以下命令在 `kcode start` 进入 Pi 后输入。
+
+### /kd-start
+
+创建一个新的 Kingdee Harness run。输入可以是一条需求，也可以是需求文档来源：
+
+```text
+/kd-start [--product 产品] [--version 版本] <需求或需求组>
+```
+
+推荐显式带产品：
+
+```text
+/kd-start --product cangqiong --version V6.0 实现采购订单保存校验
+```
+
+使用需求文档：
+
+```text
+/kd-start --product cangqiong E:\project\docs\需求说明.md
+/kd-start --product cangqiong https://example.com/requirements
+```
+
+支持产品：
+
+```text
+cangqiong
+xinghan
+flagship
+enterprise
+```
+
+### /kd-status
+
+查看当前 active run、阶段、产品画像、风险和门禁状态：
+
+```text
+/kd-status
+```
+
+### /kd-gate
+
+刷新并查看当前阶段门禁：
+
+```text
+/kd-gate
+```
+
+门禁阻塞时，按输出补齐产品、阶段文档、问题答案、证据或风险说明。
+
+### /kd-product
+
+设置当前 run 的产品画像：
+
+```text
+/kd-product <flagship|xinghan|cangqiong|enterprise> [--version 版本]
+```
+
+示例：
+
+```text
+/kd-product flagship
+/kd-product cangqiong --version V6.0
+```
+
+选择规则见 [产品画像确认](PRODUCT_PROFILE.md)。
+
+### /kd-risk
+
+设置 ship 前的风险等级和原因：
+
+```text
+/kd-risk <low|medium|high> <原因>
+```
+
+示例：
+
+```text
+/kd-risk low 已完成本地构建和元数据检查，无残余交付风险
+```
+
+风险原因必须来自真实验证结果。
+
+### /kd-advance
+
+推进到下一阶段，或推进到指定阶段：
+
+```text
+/kd-advance
+/kd-advance spec
+/kd-advance plan
+/kd-advance execute
+/kd-advance verify
+/kd-advance ship
+```
+
+阶段顺序：
+
+```text
+discuss -> spec -> plan -> execute -> verify -> ship
+```
+
+### /kd-artifact
+
+创建当前阶段文档，或创建指定阶段文档：
+
+```text
+/kd-artifact
+/kd-artifact plan
+```
+
+显式覆盖阶段文档：
+
+```text
+/kd-artifact plan <完整内容> --replace
+```
+
+默认拒绝覆盖已有文档。
+
+### /kd-answer
+
+回答一个阻塞中的结构化问题：
+
+```text
+/kd-answer Q-001 <答案>
+```
+
+### /kd-runs
+
+列出当前项目所有 Kingdee Harness run：
+
+```text
+/kd-runs
+```
+
+### /kd-switch
+
+切换 active run：
+
+```text
+/kd-switch <run-id>
+```
+
+### /kd-resume
+
+接续当前 active run，并把已落盘阶段文档注入上下文：
+
+```text
+/kd-resume
+/kd-resume 补充说明
+```
+
+### /kd-finish
+
+标记当前 run 完成，并清除 active run：
+
+```text
+/kd-finish
+```
+
+## 内置工具
+
+这些工具多数情况下会由 KCode 自动使用；当需要明确证据或排障时，也可以按下面参数手动调用。
+
+### kd_plan_status
+
+查看当前 Harness run、阶段、文档和门禁：
+
+```text
+kd_plan_status
+```
+
+### kd_question
+
+记录、回答或列出结构化问题：
+
+```text
+kd_question action=ask question="采购入库单 Form ID 是否为 pur_receivebill？" choices=["是","不是"]
+kd_question action=answer id=Q-001 answer=是
+kd_question action=list
+```
+
+一次只能登记一个当前最阻塞的问题，最多 3 个简短选项。
+
+### kd_search
+
+搜索随包金蝶知识库：
+
+```text
+kd_search query=QueryServiceHelper product=cangqiong limit=5
+```
+
+参数：
+
+```text
+query     必填，关键词、API、类名、表名或生命周期术语
+product   可选，flagship/xinghan/cangqiong/enterprise
+edition   旧参数，等同 product
+limit     可选，默认 5，最大 10
+```
+
+### kd_table
+
+查询随包表结构：
+
+```text
+kd_table table=T_PUR_POORDER product=flagship
+```
+
+参数：
+
+```text
+table     必填，表名
+product   可选，flagship/xinghan/cangqiong/enterprise
+edition   旧参数，等同 product
+```
+
+随包表结构主要覆盖旗舰版和企业版；Cosmic 家族字段和数据库信息优先用 `kd_cosmic_metadata`。
+
+### kd_check
+
+检查金蝶 Java/C#/Python 插件代码：
+
+```text
+kd_check path=src/main/java/com/example/MyPlugin.java product=cangqiong
+kd_check code="<源码片段>" language=java
+```
+
+参数：
+
+```text
+code      可选，与 path 二选一
+path      可选，与 code 二选一
+product   可选，用于推导语言和产品规则
+language  可选，java/csharp/python
+```
+
+### kd_cosmic_config
+
+运行 Cosmic 家族官方能力配置预检：
+
+```text
+kd_cosmic_config product=cangqiong
+kd_cosmic_config product=flagship config=ok-cosmic.json dryRun=true
+```
+
+参数：
+
+```text
+product  必填，cangqiong/xinghan/flagship
+config   可选，ok-cosmic.json 路径
+dryRun   可选，只展示命令
+```
+
+有 active run 时，成功结果会写入 `evidence/cosmic-config.txt`。
+
+### kd_cosmic_metadata
+
+查询 Cosmic 表单、单据、字段、枚举、操作和 SQL 表信息：
+
+```text
+kd_cosmic_metadata product=cangqiong form=sal_order
+kd_cosmic_metadata product=cangqiong form=sal_order fuzzy="数量 金额" showDetail=true
+kd_cosmic_metadata product=flagship form=采购订单 sql=true op=true
+```
+
+参数：
+
+```text
+product     必填，cangqiong/xinghan/flagship
+form        必填，Form ID、单据 ID 或中文单据名；多个目标可用逗号分隔
+config      可选，ok-cosmic.json 路径
+fuzzy       可选，字段关键词
+typeFilter  可选，字段类型正则，例如 combo|check
+sql         可选，包含数据库表和字段信息
+op          可选，显示操作
+showDetail  可选，显示详细元数据
+dryRun      可选，只展示命令
+```
+
+有 active run 时，成功结果会写入 `evidence/cosmic-metadata.json`。
+
+### kd_cosmic_api
+
+查询随包 Cosmic API 知识线索：
+
+```text
+kd_cosmic_api product=cangqiong mode=search query=QueryServiceHelper
+kd_cosmic_api product=cangqiong mode=search-method query=loadSingle
+kd_cosmic_api product=cangqiong mode=detail query=kd.bos.servicehelper.QueryServiceHelper method=loadSingle compact=true
+```
+
+参数：
+
+```text
+product  必填，cangqiong/xinghan/flagship
+mode     必填，search/search-method/detail
+query    必填，类名、方法名或完整限定类名
+config   可选，ok-cosmic.json 路径
+method   可选，detail 模式下过滤方法
+compact  可选，请求紧凑详情输出
+dryRun   可选，只展示命令
+```
+
+`kd_cosmic_api` 只能作为线索；最终 SDK 签名事实以 `kd_sdk_signature`、项目构建输出或官方元数据为准。
+
+### kd_sdk_signature
+
+从当前业务项目真实 SDK jar/dll 检查类型和方法签名：
+
+```text
+kd_sdk_signature product=cangqiong query=QueryServiceHelper method=loadSingle
+kd_sdk_signature product=enterprise query=DynamicObject method=GetDynamicObject
+kd_sdk_signature language=java className=kd.bos.servicehelper.QueryServiceHelper method=loadSingle
+```
+
+参数：
+
+```text
+product    可选，用于推导 Java/C#
+language   可选，java/csharp
+query      可选，类或类型关键词
+className  可选，完整限定类型名
+method     可选，在匹配类型内过滤方法或属性
+path       可选，SDK lib/bin 目录或依赖根路径
+limit      可选，最大检查数量
+```
+
+有 active run 且查询成功时，会写入 `evidence/sdk-signature.md`。
+
+### kd_ksql_lint
+
+检查 KSQL/SQL 文件：
+
+```text
+kd_ksql_lint product=cangqiong path=scripts/fix.sql
+kd_ksql_lint product=flagship path=scripts/fix.sql dryRun=true
+```
+
+参数：
+
+```text
+product  必填，cangqiong/xinghan/flagship
+path     必填，SQL/KSQL 文件路径
+dryRun   可选，只展示命令
+```
+
+有 active run 时，成功结果会写入 `evidence/ksql-lint.txt`。
+
+### kd_build
+
+按产品画像运行或预览构建命令：
+
+```text
+kd_build product=cangqiong
+kd_build product=cangqiong target=:module:build
+kd_build product=enterprise target=Project.sln
+kd_build product=flagship dryRun=true
+```
+
+参数：
+
+```text
+product  必填，cangqiong/xinghan/flagship/enterprise
+target   可选，Java Gradle task 或 C# .sln/.csproj 路径
+dryRun   可选，只展示命令
+```
+
+### kd_debug
+
+分析金蝶构建、运行日志或堆栈：
+
+```text
+kd_debug path=logs/error.log product=cangqiong
+kd_debug text="<日志或堆栈>" product=enterprise
+```
+
+参数：
+
+```text
+text     可选，与 path 二选一
+path     可选，与 text 二选一
+product  可选，产品提示
+```
+
+## 常用组合
+
+新需求：
+
+```text
+/kd-start --product cangqiong --version V6.0 实现采购订单保存校验
+/kd-status
+/kd-gate
+```
+
+已有 run 补产品：
+
+```text
+/kd-product cangqiong --version V6.0
+/kd-gate
+```
+
+进入 execute 前补签名证据：
+
+```text
+kd_sdk_signature product=cangqiong query=QueryServiceHelper method=loadSingle
+/kd-gate
+```
+
+ship 前补风险：
+
+```text
+/kd-risk low 已完成本地构建和元数据检查，无残余交付风险
+/kd-gate
+```

package/docs/DEVELOPMENT.md

@@ -7,7 +7,7 @@
 克隆仓库并安装依赖：
 
 ```powershell
-git clone <KCodeV2仓库地址>
+git clone https://github.com/wangneal/kcode-pi.git
 cd KCodeV2
 npm install
 ```
@@ -34,7 +34,7 @@ npm run smoke:official
 npm run smoke:build-debug
 npm run smoke:sdk-signature
 npm run smoke:package
-npm run smoke:kcode-cli
+npm run smoke:kcode-command
 npm run release:check
 ```
 
@@ -147,7 +147,7 @@ docs/KCODE_DISTRIBUTION.md
 允许接入前必须检查：
 
 - package 来源和维护状态。
-- license 是否允许企业内部分发。
+- license 是否允许随包分发和商业使用。
 - 是否注册 extensions、hooks、commands、tools。
 - 是否写全局配置或访问敏感路径。
 - 是否与 KCode harness、权限策略、上下文策略冲突。
@@ -156,6 +156,6 @@ docs/KCODE_DISTRIBUTION.md
 
 ## 当前维护事项
 
-- 当前包名是 `kcode-pi`；如果企业侧要叫 `kcode-cli`，发布前需要调整 `package.json.name`。
+- 当前包名是 `kcode-pi`，全局命令是 `kcode`。
 - 更深层的 reviewer 语义规则、HTML 审查报告、自动 SQL 产物生成仍在后续计划中。
 - 集成进度见根目录 `OFFICIAL_SKILLS_STATUS.md`。