init

2026-07-02 14:48:05 +08:00
parent a1a314cf99
commit e558733f05
64 changed files with 3258 additions and 1 deletions
@@ -0,0 +1,133 @@
+# 模板格式规范
+
+## 一、对用户（模板提供方）的要求
+
+### 必须遵守
+| 要求 | 说明 |
+|------|------|
+| 标题样式 | 需要 AI 生成的段落，其标题必须应用 Word 内置标题样式（Heading 1~3） |
+| 段落独立性 | 每个标题段落的内容应当主题独立，方便 AI 分别生成 |
+
+### 强烈建议
+| 建议 | 说明 |
+|------|------|
+| 正文提供参考内容 | 标题下的现有文本可作为 AI 生成的上下文，建议保留 |
+| 表格上方有说明文字 | 表格前最好有一段文字说明，方便定位表格归属 |
+| 文件名中文 | 模板文件名建议用中文，方便识别 |
+
+### 不约束
+| 项 | 说明 |
+|----|------|
+| 字体/配色/布局 | 不限，导出时完全保留 |
+| 页眉页脚 | 不限，导出时完全保留 |
+| 图片 | 不限，解析时保留占位，导出时保持不动 |
+| 封面/附录 | 不限，不作为段落处理，导出时保留 |
+
+## 二、解析规则（面向开发）
+
+### 2.1 段落检测算法
+```
+for each paragraph in document.paragraphs:
+    style = paragraph.style.name
+    
+    if style starts with "Heading":
+        → 新段落开始
+        → style 等级 = heading level (1~6)
+        → 该段落为「标题段落」
+    elif style is "Normal" or None:
+        → 属于上一个标题段落的「正文内容」
+        → 追加到 paragraph.content
+    elif paragraph is inside a table cell:
+        → 属于表格内容，跳过段落检测
+```
+
+### 2.2 表格归属
+```
+当前检测到的表格 → 归属于最近的标题段落
+if 无标题段落:
+    → 独立成段，段名 = "表格_{序号}"
+```
+
+### 2.3 样式捕获字段
+对每个标题段落，捕获以下样式信息：
+```json
+{
+  "font": {
+    "name": "等线",
+    "eastAsia": "等线",
+    "size": 16,
+    "bold": true,
+    "italic": false,
+    "color": "000000"
+  },
+  "paragraph": {
+    "alignment": "CENTER",
+    "spaceBefore": 12,
+    "spaceAfter": 6,
+    "lineSpacing": 1.5,
+    "firstLineIndent": 0
+  },
+  "headingLevel": 1
+}
+```
+
+### 2.4 表格样式捕获
+```json
+{
+  "rows": 5,
+  "cols": 6,
+  "gridSpan": {},
+  "cellStyles": [
+    {
+      "font": {"name": "宋体", "size": 10.5, "bold": false},
+      "shading": "D9E2F3",
+      "alignment": "CENTER",
+      "borders": {"top": "single", "bottom": "single", "left": "single", "right": "single"}
+    }
+  ],
+  "tableWidth": 5000
+}
+```
+
+## 三、AI 输出解析规则
+
+### 3.1 强制输出 JSON
+```
+在 prompt 末尾附加：
+请以 JSON 格式返回，不要包含任何其他说明文字。
+{
+  "content": [
+    {"type": "text|table", ...}
+  ]
+}
+```
+
+### 3.2 JSON 解析
+```
+收到 AI 响应后：
+1. 尝试解析为 JSON
+2. 若解析失败，尝试从响应的 ```json ``` 代码块中提取
+3. 若仍然失败，将整个响应作为纯文本处理（type=text）
+```
+
+### 3.3 表格插入
+```
+当 type=table:
+1. 在原始 docx 中找到该段落后面的第一个表格占位
+2. 删除占位表格的 XML 节点
+3. 创建新表格（python-docx add_table）
+4. 逐格填充数据
+5. 应用模板中该位置的表格样式（边框、底纹、对齐）
+```
+
+## 四、段落编辑方式
+
+### 人工编辑
+- 段落内容完全由用户手动输入
+- 不参与 AI 生成流程
+- 导出时保留用户输入的内容
+
+### AI 生成
+- 参与 AI 生成流程
+- 可配置：生成模型、提示词、参考文件、输出格式
+- 生成后可在预览编辑页手动修改