aero-bailian-mcp-demo 0.6.0 — P-Clink capability version
=========================================================

本版本不调用 ASAero.exe，也不依赖 Windows API。
它直接通过 Python HTTP 请求调用 P-Clink 的“气动特性工程估算”能力单元。

调用链：
百炼 Agent → Skill → MCP 0.6.0 → P-Clink HTTP → 气动特性工程估算能力单元

P-Clink 基础地址：
https://idarec.buaa.edu.cn

按当前项目约定，YApi 中 `/clink/...` 实际调用时改为 `/p-clink/...`。

使用接口：
POST /p-clink/api/v1/application/cms
POST /p-clink/api/v1/cm/autoRun
GET  /p-clink/api/v1/job/select?id=<jobId>
POST /p-clink/api/v1/datapack/versionData

一、构建
--------
在开发电脑：

    cd aero_bailian_mcp_demo_v060_pclink
    uv build

应生成：
    dist\aero_bailian_mcp_demo-0.6.0-py3-none-any.whl
    dist\aero_bailian_mcp_demo-0.6.0.tar.gz

二、发布
--------
PowerShell：

    $env:UV_PUBLISH_TOKEN="pypi-你的PyPI Token"
    uv publish .\dist\*

三、FC 环境变量
---------------
必须配置：

    PCLINK_TOKEN=<有效token>

建议：
    PCLINK_BASE_URL=https://idarec.buaa.edu.cn
    PCLINK_CAPABILITY_NAME=气动特性工程估算
    PCLINK_POLL_INTERVAL=2
    PCLINK_POLL_TIMEOUT=180

不要把 token 写死进源码或 PyPI 包。

四、FC bootstrap
----------------
    #!/bin/bash
    set -e
    python3 -m pip install --no-cache-dir --index-url https://pypi.org/simple aero-bailian-mcp-demo==0.6.0
    exec python3 -m aero_bailian_mcp_demo --host 0.0.0.0 --port 8080

五、百炼 MCP
------------
建议新建 MCP 服务：
    气动工程估算MCP-PClink

配置：
    {
      "mcpServers": {
        "aero-bailian-mcp-pclink": {
          "url": "https://<新FC地址>/mcp",
          "type": "streamableHttp"
        }
      }
    }

工具：
- get_aero_tool_status
- run_aero_calculation

六、注意
--------
0.6.0 会自动：
1. 查询已发布能力单元；
2. 精确/近似匹配“气动特性工程估算”；
3. 取得能力单元 ID；
4. 根据 parameters 填写内置 Excel 模板；
5. multipart 上传 competenceId + Excel；
6. 取得 jobId；
7. 查询 status；
8. status=4 后按 versionId/outputPackageId 查询最终输出。

若 P-Clink 实际返回 JSON 字段名与 YApi 示例不同，代码会尽量递归寻找常见字段；
首次联调时请保留工具返回的原始错误信息，以便进一步收紧字段解析。
