# 克隆项目
git clone <repository-url>
cd docx_mcp

# 安装依赖
pip install -r requirements.txt

python final_complete_server.py

启动最终完整MCP服务器...
功能模块:
- 基础文档管理 (8个工具)
- 智能文档创建 (1个工具)
- 基础文本内容 (4个工具)
- 智能内容处理 (1个工具)
- 基础表格处理 (5个工具)
- 表格结构提取 (4个工具)
- 智能表格处理 (2个工具)
- 智能规划指导 (3个工具)
- 基础图片处理 (3个工具)
- 基础页面设置 (3个工具)
- 智能建议 (1个工具)
- 系统状态 (3个工具)

总计: 42个工具 (32个基础工具 + 10个智能工具)

# 1. 分析文档结构，提取坐标信息
analysis = extract_fillable_fields("实习鉴定表.docx")

# 2. 根据分析结果创建填充计划
fill_plan = {
    "张三": [1, 0, 2],           # 表格1, 行0, 列2 (姓名字段右侧)
    "2024001234": [1, 1, 2],     # 表格1, 行1, 列2 (学号字段右侧)
    "计算机学院": [1, 0, 4],      # 表格1, 行0, 列4 (学院字段右侧)
    "软件工程专业": [1, 0, 6],    # 表格1, 行0, 列6 (专业字段右侧)
    "腾讯科技有限公司": [1, 1, 4], # 表格1, 行1, 列4 (实习单位字段右侧)
    "2024年7月-9月": [1, 1, 6]    # 表格1, 行1, 列6 (实习时间字段右侧)
}

# 3. 执行精确填充
result = fill_with_coordinates("实习鉴定表.docx", fill_plan)

# 创建文档副本
copy_document("原始文档.docx", "工作副本.docx")

# 创建工作副本
create_work_copy("实习鉴定表.docx", "_填写版")

docx_mcp/
├── core/                                    # 核心组件
│   ├── intelligent_table_analyzer.py        # 智能表格分析器
│   ├── universal_table_filler.py            # 通用表格填充器
│   ├── table_structure_extractor.py         # 表格结构提取器
│   ├── intelligent_tool_planner.py          # 智能工具规划器
│   ├── smart_suggestion_engine.py           # 智能建议引擎
│   ├── enhanced_state_manager.py            # 增强状态管理器
│   ├── ai_guidance_enhancer.py              # AI指导增强器
│   ├── workflow_engine.py                   # 工作流引擎
│   ├── template_engine.py                   # 模板引擎
│   ├── json_validation_engine.py            # JSON验证引擎
│   ├── font_processor.py                    # 字体处理器
│   ├── image_processor.py                   # 图片处理器
│   ├── oss_processor.py                     # OSS处理器
│   ├── file_path_utils.py                   # 文件路径工具
│   ├── fixed_docx_processor.py              # 修复的docx处理器
│   ├── enhanced_docx_processor.py           # 增强docx处理器
│   ├── ai_interface.py                      # AI接口
│   ├── docx_processor.py                    # docx处理器
│   ├── state_machine.py                     # 状态机
│   ├── state_manager.py                     # 状态管理器
│   └── models.py                            # 数据模型
├── templates/                               # 模板文件
│   └── academic/                            # 学术模板
│       └── academic_paper_simple.json       # 学术论文简单模板
├── tests/                                   # 测试文件
│   ├── test_universal_table_filler.py       # 通用表格填充器测试
│   ├── test_intelligent_analyzer.py         # 智能分析器测试
│   ├── test_table_structure_extractor.py    # 表格结构提取器测试
│   ├── test_intelligent_tool_planner.py     # 智能工具规划器测试
│   ├── test_smart_suggestion_engine.py      # 智能建议引擎测试
│   ├── test_enhanced_state_manager.py       # 增强状态管理器测试
│   ├── test_ai_guidance_enhancer.py         # AI指导增强器测试
│   ├── test_workflow_engine.py              # 工作流引擎测试
│   ├── test_template_engine.py              # 模板引擎测试
│   ├── test_json_validation_engine.py       # JSON验证引擎测试
│   ├── test_font_processor.py               # 字体处理器测试
│   ├── test_image_processor.py              # 图片处理器测试
│   ├── test_oss_processor.py                # OSS处理器测试
│   └── test_integration.py                  # 集成测试
├── docs/                                    # 测试文档
│   ├── 附件7：岭南师范学院毕业（生产）实习鉴定表A3打印.docx
│   ├── 附件11：岭南师范学院专业实习优秀实习生登记表.docx
│   └── ... (其他测试文档)
├── final_complete_server.py                 # 主MCP服务器
├── requirements.txt                         # 依赖文件
├── pyproject.toml                          # 项目配置
├── README.md                               # 项目说明
├── LICENSE                                 # 许可证
└── COMPREHENSIVE_PROJECT_DOCUMENTATION.md  # 完整项目文档

文档输入 → 结构分析 → 字段识别 → 坐标提取 → 填充规划 → 精确填充 → 文档保存
    ↓         ↓         ↓         ↓         ↓         ↓         ↓
   .docx → 表格结构 → 字段位置 → 3D坐标 → 填充计划 → 内容写入 → 保存完成

# 1. 打开文档
open_document("实习鉴定表.docx")

# 2. 分析文档结构
analysis = extract_fillable_fields("实习鉴定表.docx")
print("字段坐标:", analysis['field_coordinates'])
print("填充建议:", analysis['fill_suggestions'])

# 3. 创建填充计划
fill_plan = {
    "张三": [1, 0, 2],                    # 姓名
    "2024001234": [1, 1, 2],              # 学号
    "计算机学院": [1, 0, 4],               # 学院
    "软件工程专业2021级1班": [1, 0, 6],     # 专业班别
    "腾讯科技有限公司": [1, 1, 4],          # 实习单位
    "2024年7月-2024年9月": [1, 1, 6]       # 实习时间
}

# 4. 执行填充
result = fill_with_coordinates("实习鉴定表.docx", fill_plan)
print("填充结果:", result)

# 5. 保存文档
save_document()

# 使用智能填充功能（自动匹配字段）
fill_data = {
    "姓名": "张三",
    "学号": "2024001234",
    "学院": "计算机学院",
    "专业": "软件工程专业",
    "实习单位": "腾讯科技有限公司",
    "实习时间": "2024年7月-2024年9月"
}

result = basic_table_fill("实习鉴定表.docx", fill_data)
print("智能填充结果:", result)

# 创建文档副本
copy_result = copy_document(
    "原始文档.docx", 
    "工作副本.docx"
)

# 创建工作副本
work_copy = create_work_copy(
    "实习鉴定表.docx", 
    "_填写版"
)

# 打开工作副本
open_document("实习鉴定表_填写版.docx")

# 进行填充操作...

# 保存并关闭
save_document()
close_document()

# 表格1的基本信息填充
"张三": [1, 0, 2],           # 姓名字段右侧
"计算机学院": [1, 0, 4],      # 学院字段右侧
"2024001234": [1, 1, 2],     # 学号字段右侧
"腾讯科技有限公司": [1, 1, 4]  # 实习单位字段右侧

# 运行所有测试
python -m pytest tests/

# 运行特定测试
python tests/test_universal_table_filler.py
python tests/test_intelligent_analyzer.py

# 运行集成测试
python tests/test_integration.py

# 启用详细日志
export LOG_LEVEL=DEBUG
python final_complete_server.py