kingdee-dev-plugin

金蝶苍穹开发助手 — 为金蝶开发者提供 SDK 知识蒸馏、代码生成、规范检查、工作流管理等一站式开发工具。

核心特性

• SDK 知识蒸馏 — 36 个模块、3280 条证据标注的蒸馏知识库，让 AI 代码生成更精准
• 代码生成 — /kd:gen 一键生成表单/工作流/操作/报表插件代码
• SDK 约束生成 — kd-gen 从 SDK 文档自动生成带蒸馏知识引用的约束文件
• 5 阶段工作流 — 新建→讨论→计划→执行→验证
• 统一搜索 — 整合 SDK 文档与社区知识库 (18K+ 条目)
• 智能推荐 — 基于需求推荐 SDK 类和最佳实践
• MCP 服务 — 元数据查询和常量类生成
• 多运行时支持 — 支持 Claude Code、OpenCode、Gemini CLI、Cursor 等

命令总览

CLI 命令

| 命令 | 说明 | |------|------| | install | 安装到 AI 运行时 | | kd-gen <类名> | 生成 SDK 约束文件（.prompt.md + .schema.json，含蒸馏知识） | | kd-gen-constant <实体> | 为实体生成常量类 | | kd-search <关键词> | 统一搜索 SDK 和社区内容 | | kd-search-entity <关键词> | 搜索实体 | | kd-recommend <需求> | 智能推荐 SDK API 和最佳实践 | | kd-analyze <需求> | 需求分析 + SDK 搜索 + 约束生成 | | kd-research <需求> | 研究 SDK，推荐相关 API | | kd-list [模块] | 列出 SDK 模块和类 | | kd-check <文件> | 规范检查 | | kd-setup-mcp | 配置 MCP 数据库连接 | | kd-mcp-server | 启动 MCP 服务 | | kd-new-project [名称] | 新建项目 | | kd-discuss <阶段> | 需求讨论 | | kd-plan-phase <阶段> | 制定计划 | | kd-execute-phase <阶段> | 执行开发 | | kd-verify <阶段> | 需求校验 | | kd-next | 自动推进到下一阶段 | | kd-progress | 查看项目进度 | | kd-roadmap | 查看/生成路线图 | | kd-new-milestone <名称> | 开启新里程碑 | | kd-complete-milestone <版本> | 完成里程碑 | | kd-ship | 创建 PR，推送分支 | | kd-undo | 安全回滚 | | kd-stats | 项目统计 | | kd-cleanup | 归档清理 | | kd-audit-uat | UAT 审计 | | kd-thread <操作> | 跨会话上下文线程管理 | | kd-workspaces <操作> | 工作空间管理 | | kd-debug [问题] | 调试 | | kd-quick [任务] | 快速任务执行 | | kd-do <描述> | 自动路由命令 | | help | 显示帮助 |

AI 聊天命令

在支持 Skill 的 AI 客户端（Claude Code、OpenCode）中可直接使用：

| 命令 | 说明 | |------|------| | /kd:gen | 生成金蝶插件代码（表单/工作流/操作/报表/单据） | | /kd:analyze | 需求分析 - 搜索 SDK + 推荐 + 约束生成 | | /kd:research | 研究 SDK，推荐 API 和用法 | | /kd:list | 列出 SDK 模块、类或方法 | | /kd:check | 检查代码是否符合金蝶开发规范 | | /kd:discuss | 需求讨论，捕获设计决策 | | /kd:spec | 规格定义 | | /kd:plan-phase | 制定阶段执行计划 | | /kd:execute-phase | 执行开发阶段 | | /kd:verify | 验证交付物 | | /kd:next | 自动推进到下一步 | | /kd:distilled | 加载蒸馏知识库（36 模块，3280 条证据） | | /kd:init | 初始化项目 | | /kd:doc | 生成文档 | | /kd:template | 复制开发模板 | | /kd:roadmap | 查看路线图 | | /kd:ship | 发布 PR | | /kd:stats | 查看统计 | | /kd:undo | 回滚 | | /kd:cleanup | 归档清理 | | /kd:spike | 技术验证 | | /kd:explore | 苏格拉底式构思探讨 | | /kd:autonomous | 自主执行所有剩余阶段 | | /kd:mcp | MCP 服务 | | /kd:thread | 线程管理 | | /kd:workspaces | 工作空间管理 | | /kd:code-review-fix | 代码审查自动修复 | | /kd:uat | 验收验证 |

安装

# 全局安装
npm install -g kingdee-dev-plugin

# 安装到 AI 运行时
kingdee-dev-plugin install

安装后 AI 客户端即可使用 /kd:* 命令。

蒸馏知识库

项目内置 SDK 蒸馏知识库，覆盖 36 个金蝶苍穹核心模块：

skills/kd-distilled/
├── 36 个知识模块
│   ├── 10 个 ServiceHelper 类
│   ├── 8 个插件基类
│   ├── 6 个基础设施类
│   ├── 5 个数据实体类
│   ├── 3 个服务类
│   ├── 3 个工具类
│   └── 23 个关键事件
├── 3280 条证据（verbatim 1754 / artifact 1113 / impression 413）
└── SKILL.md（AI 加载入口）

应用场景：

• /kd:gen 代码生成时自动加载蒸馏知识
• kd-gen <类名> 生成的约束文件自动引用蒸馏最佳实践
• /kd:distilled 手动加载知识库

工作流

5 阶段开发流程

kd-new-project    → 新建项目
kd-discuss <N>    → 需求讨论
kd-plan-phase <N> → 制定计划
kd-execute-phase <N> → 执行开发
kd-verify <N>     → 验证交付
kd-next           → 自动推进

快速开始

# 1. 新建项目
kingdee-dev-plugin kd-new-project

# 2. 需求讨论
kingdee-dev-plugin kd-discuss 1

# 3. 生成执行计划
kingdee-dev-plugin kd-plan 1

# 4. 执行开发
kingdee-dev-plugin kd-execute 1

# 5. 验证UAT
kingdee-dev-plugin kd-verify 1

# 自动推进到下一阶段
kingdee-dev-plugin kd-next

项目结构

├── bin/           # CLI 入口 (cli.js + install.js)
├── lib/           # 核心库 (40+ 文件)
│   ├── kd-constraint-generator.js  # 约束生成器（含蒸馏知识集成）
│   ├── unified-search.js           # 统一搜索
│   ├── intelligent-recommender.js  # 智能推荐
│   └── ...
├── engine/        # 引擎层
│   ├── workflows/ # 14个工作流文件
│   ├── templates/ # 代码模板
│   └── scripts/assemble-distilled.js  # 合成引擎
├── skills/        # AI Skills (29个)
│   ├── kd-gen/    # 代码生成技能
│   ├── kd-distilled/  # 蒸馏知识库 ★
│   └── ...
├── sdk/           # SDK 知识库 (105模块, 783方法)
├── community/     # 社区知识库 (18K+ 条目)
├── standards/     # 金蝶开发规范 (13个文件)
├── constraints/   # SDK 约束 schema
└── tests/         # Jest 测试 (705+)

相关文档

• COMMANDS-GUIDE.md — 完整命令参考
• docs/DATABASE-CONFIG-GUIDE.md — 数据库配置
• docs/MCP-GUIDE.md — MCP 服务指南

License

MIT