P6AI

AI 驱动的 Primavera P6 Professional（独立版 SQLite）计划建库工具。

👥 不熟悉程序的土木行业朋友，请看：给土木行业朋友的说明

P6AI 接收结构化的施工计划 JSON，先做完整性 / 业务 / 网络（DAG）校验， 再以单事务直接写入 P6 Professional 独立版的 PPMDBSQLite.db，自动备份、 自动回滚、自动对齐主键序列。写入后打开 P6 按 F9 即可完成进度计算。

⚠️ 非官方工具，与 Oracle 无关联。仅面向 P6 Professional 独立版（SQLite PMDB）。

---

Features

• 计划校验：字段完整性、WBS 引用、工期合法性、逻辑关系类型、循环依赖检测
• 结构自检：写入前核对数据库表 / 字段是否与当前 P6 版本兼容，防止误写 EPPM 库
• 安全写入：自动备份 + 单事务 + 失败整体回滚 + NEXTKEY 主键序列对齐
• 版本适配：针对 P6 Professional 23.12 独立版真实表结构编写（含 22 位 GUID、EPS 挂接）
• 无第三方运行时依赖（仅 Python 标准库）

Quick Start

# 1. 结构自检：确认目标库与本工具兼容
python -m p6ai check --db "C:\Users\<you>\Documents\PPMDBSQLite.db"

# 2. 校验计划 JSON（不写库）
python -m p6ai validate --plan plan.json

# 3. 写入 P6 数据库（自动备份）
python -m p6ai create --plan plan.json --db "C:\Users\<you>\Documents\PPMDBSQLite.db"

# 4. 打开 P6 Professional，打开新项目，按 F9 进度计算

Plan JSON Format

{
  "project_code": "PRJ-2026-001",
  "project_name": "某变电站土建及机电安装工程",
  "start_date": "2026-09-01 08:00:00",
  "calendar_name": "Corporate - Standard Full Time",
  "wbs_tree": [
    { "wbs_code": "WBS.1", "wbs_name": "土建工程", "parent": null },
    { "wbs_code": "WBS.1.1", "wbs_name": "桩基与地基处理", "parent": "WBS.1" }
  ],
  "tasks": [
    { "task_code": "A1010", "task_name": "场地平整及放线", "wbs_code": "WBS.1.1", "duration_days": 5 },
    { "task_code": "A1020", "task_name": "静压管桩施工及检测", "wbs_code": "WBS.1.1", "duration_days": 12.5 }
  ],
  "relationships": [
    { "pred_code": "A1010", "succ_code": "A1020", "type": "PR_FS", "lag_days": 0 }
  ]
}

• 逻辑关系类型：PR_FS / PR_SS / PR_FF / PR_SF
• duration_days 可为小数，必须大于 0
• 全网必须是有向无环图（DAG），禁止循环

Safety Notes

• 写入期间必须完全关闭 P6 Professional（数据库被占用时会拒绝写入并提示）
• 每次写入前自动生成 PPMDBSQLite.db.bak_时间戳 备份
• 写入基于逆向验证的表结构，不同 P6 版本请先运行 check

MCP 接口（AI 工具）

p6ai 内置一个零依赖的 MCP 服务器（stdio 传输，仅使用 Python 标准库）， 任何支持 MCP 的 AI 客户端（Claude Desktop、Codex、Cursor 等）都可以直接调用：

工具	说明
validate_plan	校验计划 JSON（字段、WBS 引用、工期、关系类型、循环依赖）
create_project	校验并写入 P6 数据库（自动备份、单事务、失败回滚）
list_projects	只读列出数据库中的项目
check_database	数据库结构自检与版本识别

启动服务器：

python -m p6ai serve
# 安装后也可直接：p6ai serve

Claude Desktop 配置示例（claude_desktop_config.json）：

{
  "mcpServers": {
    "p6ai": {
      "command": "python",
      "args": ["-m", "p6ai", "serve"],
      "cwd": "C:\\path\\to\\p6ai"
    }
  }
}

Codex CLI 配置示例（~/.codex/config.toml）：

[mcp_servers.p6ai]
command = "python"
args = ["-m", "p6ai", "serve"]
cwd = "C:\\path\\to\\p6ai"

如果 python 不在系统 PATH 中，请把 command 换成 Python 解释器的完整路径。 AI 客户端可以直接用自然语言驱动这些工具，例如："校验这份计划"、"把这个施工方案 建到 P6 里"。

Supported Environments

• Primavera P6 Professional 23.12（独立版 SQLite，PPMDB,2312.*）
• Python 3.9+

Roadmap

• [x] MCP 服务器：向 AI 客户端（Claude / Codex / Cursor）暴露校验、建库、列表、自检工具
• [ ] XER 导出与 DCMA 质检集成
• [ ] 多版本 schema 适配层

License

MIT

Disclaimer

本工具为社区项目，与 Oracle Corporation 及其产品无任何关联或背书。 使用直接写入数据库的方式操作 P6 数据存在风险，请务必自行备份并在测试环境验证后使用。