🍎 Windchill 技能部署包 (Mac)

将 Windows 上的 Windchill 开发技能迁移到 Mac 电脑的 Claude Code 中。

快速开始

# 1. 解压
cd ~/Downloads
tar xzf windchill-mac-pkg.tar.gz

# 2. 运行安装脚本
cd windchill-mac-pkg
bash install.sh

# 3. 按照提示输入安装目录（默认 ~/workspace/windchill-tools）

安装内容

安装后会在你的 Mac 上创建以下结构：

~/workspace/windchill-tools/
├── .claude/
│   ├── settings.json            # MCP 服务配置（自动填入路径）
│   ├── settings.local.json      # 权限配置
│   └── skills/
│       ├── wc-codebase.md       # 代码库参考 skill
│       ├── wc-mvc.md            # MVC 前端开发 skill
│       ├── wc-lifecycle.md      # 生命周期/工作流 skill
│       ├── wc-query.md          # 查询/报表 skill
│       ├── wc-crud.md           # CRUD 操作 skill
│       └── wc-action.md         # Action 开发 skill
├── mcp-windchill-server/
│   ├── server.py                # MCP 服务入口
│   ├── windchill_mcp/           # Python 知识库引擎
│   └── data/
│       ├── windchill_api.db     # API 索引（已编译，34MB）
│       ├── windchill_schema.db  # 表结构索引
│       └── codebase_index.db    # 代码库索引
├── windchill_api_packages/      # API 包源文件（11个，用于重建索引）
└── doc/
    └── PDMLink表结构说明.md      # 数据库表结构文档

13 个 MCP 工具

工具	说明
lookup_class	查询类的继承、方法、字段
search_api	全文搜索 API
lookup_method	查询方法签名
lookup_table	查询数据库表结构
search_schema	搜索表/字段
explain_table	查询表的业务信息
search_codebase	搜索公司代码库
check_api	验证 API 存在性
validate_java	验证 Java 代码中的 API 引用
validate_java_with_annotations	验证 + 源码标注
search_queries	搜索常用 SQL 查询
list_modules	列出所有数据模块
search_implementation	搜索方法实现体

验证

安装完成后，打开 Claude Code 进入安装目录：

cd ~/workspace/windchill-tools

在对话中测试：

lookup_class("wt.part.WTPart")

应该返回类的完整信息（继承层次、方法列表、字段列表）。

故障排除

MCP 服务启动失败

# 手动测试
cd ~/workspace/windchill-tools/mcp-windchill-server
python3 server.py

# 确认 mcp 包已安装
pip3 list | grep mcp

# 安装依赖
pip3 install mcp>=1.0.0

API 查询无结果

# 重建知识库索引
cd ~/workspace/windchill-tools/mcp-windchill-server
python3 build_index.py --source-dir ../windchill_api_packages --output data/windchill_api.db

权限提示

安装脚本已自动生成配置文件，但如果 Claude Code 仍询问某些命令的权限，请确认 settings.local.json 已包含对应条目。