@microi.net/cli 5.9.6 → 5.9.8

package/skills/microi-solution-quotation/agents/openai.yaml

@@ -1,4 +1,4 @@
-interface:
-  display_name: "Microi吾码解决方案与报价"
-  short_description: "生成紧凑专业的吾码解决方案、周期与总价报价 Word"
-  default_prompt: "使用 $microi-solution-quotation 生成一份紧凑的一页 Microi吾码系统解决方案与报价 Word。"
+interface:
+  display_name: "Microi吾码解决方案与报价"
+  short_description: "生成紧凑专业的吾码解决方案、周期与总价报价 Word"
+  default_prompt: "使用 $microi-solution-quotation 生成一份紧凑的一页 Microi吾码系统解决方案与报价 Word。"

package/skills/microi-solution-quotation/scripts/build_solution_quote.py

@@ -1,296 +1,296 @@
-import argparse
-import json
-from datetime import date
-from pathlib import Path
-
-from docx import Document
-from docx.enum.table import WD_CELL_VERTICAL_ALIGNMENT, WD_TABLE_ALIGNMENT
-from docx.enum.text import WD_ALIGN_PARAGRAPH
-from docx.oxml import OxmlElement
-from docx.oxml.ns import qn
-from docx.shared import Inches, Pt, RGBColor
-
-
-NAVY = "17365D"
-BLUE = "2F75B5"
-PALE_BLUE = "EAF3F9"
-PALE_GRAY = "F4F6F8"
-PALE_GOLD = "FFF3D6"
-GOLD = "B45309"
-INK = "1F2937"
-MUTED = "64748B"
-WHITE = "FFFFFF"
-BORDER = "CBD5E1"
-FONT = "Microsoft YaHei"
-PAGE_WIDTH_DXA = 11909
-MARGIN_DXA = 720
-TABLE_INDENT_DXA = 120
-TABLE_WIDTH_DXA = PAGE_WIDTH_DXA - MARGIN_DXA * 2 - TABLE_INDENT_DXA
-
-
-def set_run_font(run, size=9.2, bold=False, color=INK):
-    run.font.name = FONT
-    rfonts = run._element.get_or_add_rPr().get_or_add_rFonts()
-    for key in ("w:eastAsia", "w:ascii", "w:hAnsi"):
-        rfonts.set(qn(key), FONT)
-    run.font.size = Pt(size)
-    run.font.bold = bold
-    run.font.color.rgb = RGBColor.from_string(color)
-
-
-def format_paragraph(paragraph, before=0, after=0, line=1.05, align=None):
-    fmt = paragraph.paragraph_format
-    fmt.space_before = Pt(before)
-    fmt.space_after = Pt(after)
-    fmt.line_spacing = line
-    if align is not None:
-        paragraph.alignment = align
-
-
-def add_paragraph(doc, text, size=9.2, bold=False, color=INK, before=0, after=2, line=1.05, align=None):
-    paragraph = doc.add_paragraph()
-    format_paragraph(paragraph, before, after, line, align)
-    set_run_font(paragraph.add_run(text), size, bold, color)
-    return paragraph
-
-
-def set_cell_shading(cell, fill):
-    tc_pr = cell._tc.get_or_add_tcPr()
-    shd = tc_pr.find(qn("w:shd"))
-    if shd is None:
-        shd = OxmlElement("w:shd")
-        tc_pr.append(shd)
-    shd.set(qn("w:fill"), fill)
-
-
-def set_cell_margins(cell, top=70, start=110, bottom=70, end=110):
-    tc_pr = cell._tc.get_or_add_tcPr()
-    tc_mar = tc_pr.first_child_found_in("w:tcMar")
-    if tc_mar is None:
-        tc_mar = OxmlElement("w:tcMar")
-        tc_pr.append(tc_mar)
-    for name, value in (("top", top), ("start", start), ("bottom", bottom), ("end", end)):
-        element = tc_mar.find(qn(f"w:{name}"))
-        if element is None:
-            element = OxmlElement(f"w:{name}")
-            tc_mar.append(element)
-        element.set(qn("w:w"), str(value))
-        element.set(qn("w:type"), "dxa")
-
-
-def set_cell_width(cell, width):
-    tc_pr = cell._tc.get_or_add_tcPr()
-    tc_w = tc_pr.find(qn("w:tcW"))
-    if tc_w is None:
-        tc_w = OxmlElement("w:tcW")
-        tc_pr.append(tc_w)
-    tc_w.set(qn("w:w"), str(width))
-    tc_w.set(qn("w:type"), "dxa")
-
-
-def set_table_geometry(table, widths, indent=TABLE_INDENT_DXA):
-    total = sum(widths)
-    table.autofit = False
-    table.alignment = WD_TABLE_ALIGNMENT.LEFT
-    tbl_pr = table._tbl.tblPr
-    tbl_w = tbl_pr.find(qn("w:tblW"))
-    if tbl_w is None:
-        tbl_w = OxmlElement("w:tblW")
-        tbl_pr.append(tbl_w)
-    tbl_w.set(qn("w:w"), str(total))
-    tbl_w.set(qn("w:type"), "dxa")
-    tbl_ind = tbl_pr.find(qn("w:tblInd"))
-    if tbl_ind is None:
-        tbl_ind = OxmlElement("w:tblInd")
-        tbl_pr.append(tbl_ind)
-    tbl_ind.set(qn("w:w"), str(indent))
-    tbl_ind.set(qn("w:type"), "dxa")
-    grid = table._tbl.tblGrid
-    for child in list(grid):
-        grid.remove(child)
-    for width in widths:
-        col = OxmlElement("w:gridCol")
-        col.set(qn("w:w"), str(width))
-        grid.append(col)
-    for row in table.rows:
-        for index, cell in enumerate(row.cells):
-            set_cell_width(cell, widths[index])
-            set_cell_margins(cell)
-            cell.vertical_alignment = WD_CELL_VERTICAL_ALIGNMENT.CENTER
-
-
-def set_table_borders(table, color=BORDER, size="6"):
-    tbl_pr = table._tbl.tblPr
-    borders = tbl_pr.first_child_found_in("w:tblBorders")
-    if borders is None:
-        borders = OxmlElement("w:tblBorders")
-        tbl_pr.append(borders)
-    for edge in ("top", "left", "bottom", "right", "insideH", "insideV"):
-        tag = f"w:{edge}"
-        element = borders.find(qn(tag))
-        if element is None:
-            element = OxmlElement(tag)
-            borders.append(element)
-        element.set(qn("w:val"), "single")
-        element.set(qn("w:sz"), size)
-        element.set(qn("w:space"), "0")
-        element.set(qn("w:color"), color)
-
-
-def add_section_heading(doc, text):
-    return add_paragraph(doc, text, size=10.8, bold=True, color=BLUE, before=4, after=1, line=1.0)
-
-
-def add_bullet(doc, label, detail):
-    paragraph = doc.add_paragraph(style="List Bullet")
-    format_paragraph(paragraph, before=0, after=1, line=1.03)
-    set_run_font(paragraph.add_run(f"{label}："), 8.8, True, NAVY)
-    set_run_font(paragraph.add_run(detail), 8.8, False, INK)
-
-
-def add_metadata_table(doc, config):
-    table = doc.add_table(rows=1, cols=4)
-    widths = [TABLE_WIDTH_DXA // 4] * 4
-    widths[-1] += TABLE_WIDTH_DXA - sum(widths)
-    values = [
-        ("版本", config["version"]),
-        ("日期", config["date"]),
-        ("开发周期", config["development_cycle"]),
-        ("报价有效期", f'{config["validity_days"]} 天'),
-    ]
-    for index, (label, value) in enumerate(values):
-        cell = table.cell(0, index)
-        set_cell_shading(cell, PALE_GRAY)
-        paragraph = cell.paragraphs[0]
-        format_paragraph(paragraph, after=0, line=1.0, align=WD_ALIGN_PARAGRAPH.CENTER)
-        set_run_font(paragraph.add_run(f"{label}："), 8.0, True, MUTED)
-        set_run_font(paragraph.add_run(str(value)), 8.2, True, NAVY)
-    set_table_geometry(table, widths)
-    set_table_borders(table, "E2E8F0", "4")
-
-
-def add_callout(doc, label, detail, fill=PALE_BLUE):
-    table = doc.add_table(rows=1, cols=1)
-    set_table_geometry(table, [TABLE_WIDTH_DXA])
-    set_table_borders(table, "9CC2E5", "7")
-    cell = table.cell(0, 0)
-    set_cell_shading(cell, fill)
-    paragraph = cell.paragraphs[0]
-    format_paragraph(paragraph, after=0, line=1.03)
-    set_run_font(paragraph.add_run(f"{label}："), 8.8, True, NAVY)
-    set_run_font(paragraph.add_run(detail), 8.8, False, INK)
-
-
-def add_quote_table(doc, config):
-    table = doc.add_table(rows=2, cols=3)
-    widths = [TABLE_WIDTH_DXA // 3] * 3
-    widths[-1] += TABLE_WIDTH_DXA - sum(widths)
-    headers = ["市场预估价（总价）", "吾码优惠报价（总价）", "开发周期"]
-    values = [config["market_price"], config["preferential_price"], config["development_cycle"]]
-    for index, header in enumerate(headers):
-        cell = table.cell(0, index)
-        set_cell_shading(cell, NAVY)
-        paragraph = cell.paragraphs[0]
-        format_paragraph(paragraph, after=0, line=1.0, align=WD_ALIGN_PARAGRAPH.CENTER)
-        set_run_font(paragraph.add_run(header), 8.7, True, WHITE)
-    for index, value in enumerate(values):
-        cell = table.cell(1, index)
-        set_cell_shading(cell, PALE_GOLD if index == 1 else PALE_GRAY)
-        paragraph = cell.paragraphs[0]
-        format_paragraph(paragraph, after=0, line=1.0, align=WD_ALIGN_PARAGRAPH.CENTER)
-        set_run_font(paragraph.add_run(str(value)), 12.0 if index == 1 else 10.5, True, GOLD if index == 1 else NAVY)
-    set_table_geometry(table, widths)
-    set_table_borders(table)
-
-
-def normalize_config(raw):
-    required = [
-        "system_name", "project_goal", "solution_items", "technical_route",
-        "deliverables", "market_price", "preferential_price",
-        "development_cycle", "boundary_note",
-    ]
-    missing = [name for name in required if not raw.get(name)]
-    if missing:
-        raise ValueError("Missing required fields: " + ", ".join(missing))
-    if not isinstance(raw["solution_items"], list) or not raw["solution_items"]:
-        raise ValueError("solution_items must be a non-empty list")
-    raw.setdefault("version", "v1.0.0")
-    raw.setdefault("date", date.today().isoformat())
-    raw.setdefault("validity_days", 15)
-    raw.setdefault("subtitle", "AI 深度融合 V8引擎 的低代码平台，官网：https://microi.net")
-    raw.setdefault("project_scope", "")
-    return raw
-
-
-def build_document(config, output):
-    doc = Document()
-    section = doc.sections[0]
-    section.page_width = Inches(8.27)
-    section.page_height = Inches(11.69)
-    section.top_margin = Inches(0.5)
-    section.bottom_margin = Inches(0.5)
-    section.left_margin = Inches(0.5)
-    section.right_margin = Inches(0.5)
-    section.header_distance = Inches(0.2)
-    section.footer_distance = Inches(0.2)
-
-    normal = doc.styles["Normal"]
-    normal.font.name = FONT
-    normal._element.rPr.rFonts.set(qn("w:eastAsia"), FONT)
-    normal.font.size = Pt(9.2)
-    normal.font.color.rgb = RGBColor.from_string(INK)
-
-    title = f'Microi吾码 {config["system_name"]} 解决方案与报价'
-    add_paragraph(doc, title, size=20.0, bold=True, color=NAVY, after=1, line=1.0, align=WD_ALIGN_PARAGRAPH.CENTER)
-    add_paragraph(doc, config["subtitle"], size=9.3, color=MUTED, after=4, line=1.0, align=WD_ALIGN_PARAGRAPH.CENTER)
-    add_metadata_table(doc, config)
-
-    add_section_heading(doc, "一、项目目标")
-    add_callout(doc, "目标", config["project_goal"])
-
-    add_section_heading(doc, "二、解决方案")
-    for item in config["solution_items"]:
-        if isinstance(item, str):
-            add_bullet(doc, "方案", item)
-        else:
-            add_bullet(doc, item.get("label", "方案"), item.get("detail", ""))
-
-    add_section_heading(doc, "三、核心技术路线")
-    add_callout(doc, "链路", config["technical_route"], fill=PALE_GRAY)
-
-    add_section_heading(doc, "四、交付范围")
-    add_paragraph(doc, config["deliverables"], size=8.7, after=1, line=1.03)
-    if config["project_scope"]:
-        add_paragraph(doc, config["project_scope"], size=8.3, color=MUTED, after=1, line=1.0)
-
-    add_section_heading(doc, "五、项目总价与周期")
-    add_quote_table(doc, config)
-
-    add_section_heading(doc, "六、说明与边界")
-    add_paragraph(doc, config["boundary_note"], size=8.1, color=MUTED, after=0, line=1.0)
-
-    footer = section.footer.paragraphs[0]
-    format_paragraph(footer, after=0, line=1.0, align=WD_ALIGN_PARAGRAPH.RIGHT)
-    set_run_font(footer.add_run(f'Microi吾码 | {config["version"]} | {config["date"]} | https://microi.net'), 7.2, False, MUTED)
-
-    doc.core_properties.title = title
-    doc.core_properties.subject = "Microi吾码系统解决方案与报价"
-    doc.core_properties.author = "Microi吾码"
-    output.parent.mkdir(parents=True, exist_ok=True)
-    doc.save(output)
-
-
-def main():
-    parser = argparse.ArgumentParser(description="Build a compact Microi solution quotation DOCX")
-    parser.add_argument("--input", required=True, help="UTF-8 JSON configuration file")
-    parser.add_argument("--output", required=True, help="Output DOCX path")
-    args = parser.parse_args()
-    with open(args.input, "r", encoding="utf-8") as handle:
-        config = normalize_config(json.load(handle))
-    output = Path(args.output).resolve()
-    build_document(config, output)
-    print(output)
-
-
-if __name__ == "__main__":
-    main()
+import argparse
+import json
+from datetime import date
+from pathlib import Path
+
+from docx import Document
+from docx.enum.table import WD_CELL_VERTICAL_ALIGNMENT, WD_TABLE_ALIGNMENT
+from docx.enum.text import WD_ALIGN_PARAGRAPH
+from docx.oxml import OxmlElement
+from docx.oxml.ns import qn
+from docx.shared import Inches, Pt, RGBColor
+
+
+NAVY = "17365D"
+BLUE = "2F75B5"
+PALE_BLUE = "EAF3F9"
+PALE_GRAY = "F4F6F8"
+PALE_GOLD = "FFF3D6"
+GOLD = "B45309"
+INK = "1F2937"
+MUTED = "64748B"
+WHITE = "FFFFFF"
+BORDER = "CBD5E1"
+FONT = "Microsoft YaHei"
+PAGE_WIDTH_DXA = 11909
+MARGIN_DXA = 720
+TABLE_INDENT_DXA = 120
+TABLE_WIDTH_DXA = PAGE_WIDTH_DXA - MARGIN_DXA * 2 - TABLE_INDENT_DXA
+
+
+def set_run_font(run, size=9.2, bold=False, color=INK):
+    run.font.name = FONT
+    rfonts = run._element.get_or_add_rPr().get_or_add_rFonts()
+    for key in ("w:eastAsia", "w:ascii", "w:hAnsi"):
+        rfonts.set(qn(key), FONT)
+    run.font.size = Pt(size)
+    run.font.bold = bold
+    run.font.color.rgb = RGBColor.from_string(color)
+
+
+def format_paragraph(paragraph, before=0, after=0, line=1.05, align=None):
+    fmt = paragraph.paragraph_format
+    fmt.space_before = Pt(before)
+    fmt.space_after = Pt(after)
+    fmt.line_spacing = line
+    if align is not None:
+        paragraph.alignment = align
+
+
+def add_paragraph(doc, text, size=9.2, bold=False, color=INK, before=0, after=2, line=1.05, align=None):
+    paragraph = doc.add_paragraph()
+    format_paragraph(paragraph, before, after, line, align)
+    set_run_font(paragraph.add_run(text), size, bold, color)
+    return paragraph
+
+
+def set_cell_shading(cell, fill):
+    tc_pr = cell._tc.get_or_add_tcPr()
+    shd = tc_pr.find(qn("w:shd"))
+    if shd is None:
+        shd = OxmlElement("w:shd")
+        tc_pr.append(shd)
+    shd.set(qn("w:fill"), fill)
+
+
+def set_cell_margins(cell, top=70, start=110, bottom=70, end=110):
+    tc_pr = cell._tc.get_or_add_tcPr()
+    tc_mar = tc_pr.first_child_found_in("w:tcMar")
+    if tc_mar is None:
+        tc_mar = OxmlElement("w:tcMar")
+        tc_pr.append(tc_mar)
+    for name, value in (("top", top), ("start", start), ("bottom", bottom), ("end", end)):
+        element = tc_mar.find(qn(f"w:{name}"))
+        if element is None:
+            element = OxmlElement(f"w:{name}")
+            tc_mar.append(element)
+        element.set(qn("w:w"), str(value))
+        element.set(qn("w:type"), "dxa")
+
+
+def set_cell_width(cell, width):
+    tc_pr = cell._tc.get_or_add_tcPr()
+    tc_w = tc_pr.find(qn("w:tcW"))
+    if tc_w is None:
+        tc_w = OxmlElement("w:tcW")
+        tc_pr.append(tc_w)
+    tc_w.set(qn("w:w"), str(width))
+    tc_w.set(qn("w:type"), "dxa")
+
+
+def set_table_geometry(table, widths, indent=TABLE_INDENT_DXA):
+    total = sum(widths)
+    table.autofit = False
+    table.alignment = WD_TABLE_ALIGNMENT.LEFT
+    tbl_pr = table._tbl.tblPr
+    tbl_w = tbl_pr.find(qn("w:tblW"))
+    if tbl_w is None:
+        tbl_w = OxmlElement("w:tblW")
+        tbl_pr.append(tbl_w)
+    tbl_w.set(qn("w:w"), str(total))
+    tbl_w.set(qn("w:type"), "dxa")
+    tbl_ind = tbl_pr.find(qn("w:tblInd"))
+    if tbl_ind is None:
+        tbl_ind = OxmlElement("w:tblInd")
+        tbl_pr.append(tbl_ind)
+    tbl_ind.set(qn("w:w"), str(indent))
+    tbl_ind.set(qn("w:type"), "dxa")
+    grid = table._tbl.tblGrid
+    for child in list(grid):
+        grid.remove(child)
+    for width in widths:
+        col = OxmlElement("w:gridCol")
+        col.set(qn("w:w"), str(width))
+        grid.append(col)
+    for row in table.rows:
+        for index, cell in enumerate(row.cells):
+            set_cell_width(cell, widths[index])
+            set_cell_margins(cell)
+            cell.vertical_alignment = WD_CELL_VERTICAL_ALIGNMENT.CENTER
+
+
+def set_table_borders(table, color=BORDER, size="6"):
+    tbl_pr = table._tbl.tblPr
+    borders = tbl_pr.first_child_found_in("w:tblBorders")
+    if borders is None:
+        borders = OxmlElement("w:tblBorders")
+        tbl_pr.append(borders)
+    for edge in ("top", "left", "bottom", "right", "insideH", "insideV"):
+        tag = f"w:{edge}"
+        element = borders.find(qn(tag))
+        if element is None:
+            element = OxmlElement(tag)
+            borders.append(element)
+        element.set(qn("w:val"), "single")
+        element.set(qn("w:sz"), size)
+        element.set(qn("w:space"), "0")
+        element.set(qn("w:color"), color)
+
+
+def add_section_heading(doc, text):
+    return add_paragraph(doc, text, size=10.8, bold=True, color=BLUE, before=4, after=1, line=1.0)
+
+
+def add_bullet(doc, label, detail):
+    paragraph = doc.add_paragraph(style="List Bullet")
+    format_paragraph(paragraph, before=0, after=1, line=1.03)
+    set_run_font(paragraph.add_run(f"{label}："), 8.8, True, NAVY)
+    set_run_font(paragraph.add_run(detail), 8.8, False, INK)
+
+
+def add_metadata_table(doc, config):
+    table = doc.add_table(rows=1, cols=4)
+    widths = [TABLE_WIDTH_DXA // 4] * 4
+    widths[-1] += TABLE_WIDTH_DXA - sum(widths)
+    values = [
+        ("版本", config["version"]),
+        ("日期", config["date"]),
+        ("开发周期", config["development_cycle"]),
+        ("报价有效期", f'{config["validity_days"]} 天'),
+    ]
+    for index, (label, value) in enumerate(values):
+        cell = table.cell(0, index)
+        set_cell_shading(cell, PALE_GRAY)
+        paragraph = cell.paragraphs[0]
+        format_paragraph(paragraph, after=0, line=1.0, align=WD_ALIGN_PARAGRAPH.CENTER)
+        set_run_font(paragraph.add_run(f"{label}："), 8.0, True, MUTED)
+        set_run_font(paragraph.add_run(str(value)), 8.2, True, NAVY)
+    set_table_geometry(table, widths)
+    set_table_borders(table, "E2E8F0", "4")
+
+
+def add_callout(doc, label, detail, fill=PALE_BLUE):
+    table = doc.add_table(rows=1, cols=1)
+    set_table_geometry(table, [TABLE_WIDTH_DXA])
+    set_table_borders(table, "9CC2E5", "7")
+    cell = table.cell(0, 0)
+    set_cell_shading(cell, fill)
+    paragraph = cell.paragraphs[0]
+    format_paragraph(paragraph, after=0, line=1.03)
+    set_run_font(paragraph.add_run(f"{label}："), 8.8, True, NAVY)
+    set_run_font(paragraph.add_run(detail), 8.8, False, INK)
+
+
+def add_quote_table(doc, config):
+    table = doc.add_table(rows=2, cols=3)
+    widths = [TABLE_WIDTH_DXA // 3] * 3
+    widths[-1] += TABLE_WIDTH_DXA - sum(widths)
+    headers = ["市场预估价（总价）", "吾码优惠报价（总价）", "开发周期"]
+    values = [config["market_price"], config["preferential_price"], config["development_cycle"]]
+    for index, header in enumerate(headers):
+        cell = table.cell(0, index)
+        set_cell_shading(cell, NAVY)
+        paragraph = cell.paragraphs[0]
+        format_paragraph(paragraph, after=0, line=1.0, align=WD_ALIGN_PARAGRAPH.CENTER)
+        set_run_font(paragraph.add_run(header), 8.7, True, WHITE)
+    for index, value in enumerate(values):
+        cell = table.cell(1, index)
+        set_cell_shading(cell, PALE_GOLD if index == 1 else PALE_GRAY)
+        paragraph = cell.paragraphs[0]
+        format_paragraph(paragraph, after=0, line=1.0, align=WD_ALIGN_PARAGRAPH.CENTER)
+        set_run_font(paragraph.add_run(str(value)), 12.0 if index == 1 else 10.5, True, GOLD if index == 1 else NAVY)
+    set_table_geometry(table, widths)
+    set_table_borders(table)
+
+
+def normalize_config(raw):
+    required = [
+        "system_name", "project_goal", "solution_items", "technical_route",
+        "deliverables", "market_price", "preferential_price",
+        "development_cycle", "boundary_note",
+    ]
+    missing = [name for name in required if not raw.get(name)]
+    if missing:
+        raise ValueError("Missing required fields: " + ", ".join(missing))
+    if not isinstance(raw["solution_items"], list) or not raw["solution_items"]:
+        raise ValueError("solution_items must be a non-empty list")
+    raw.setdefault("version", "v1.0.0")
+    raw.setdefault("date", date.today().isoformat())
+    raw.setdefault("validity_days", 15)
+    raw.setdefault("subtitle", "AI 深度融合 V8引擎 的低代码平台，官网：https://microi.net")
+    raw.setdefault("project_scope", "")
+    return raw
+
+
+def build_document(config, output):
+    doc = Document()
+    section = doc.sections[0]
+    section.page_width = Inches(8.27)
+    section.page_height = Inches(11.69)
+    section.top_margin = Inches(0.5)
+    section.bottom_margin = Inches(0.5)
+    section.left_margin = Inches(0.5)
+    section.right_margin = Inches(0.5)
+    section.header_distance = Inches(0.2)
+    section.footer_distance = Inches(0.2)
+
+    normal = doc.styles["Normal"]
+    normal.font.name = FONT
+    normal._element.rPr.rFonts.set(qn("w:eastAsia"), FONT)
+    normal.font.size = Pt(9.2)
+    normal.font.color.rgb = RGBColor.from_string(INK)
+
+    title = f'Microi吾码 {config["system_name"]} 解决方案与报价'
+    add_paragraph(doc, title, size=20.0, bold=True, color=NAVY, after=1, line=1.0, align=WD_ALIGN_PARAGRAPH.CENTER)
+    add_paragraph(doc, config["subtitle"], size=9.3, color=MUTED, after=4, line=1.0, align=WD_ALIGN_PARAGRAPH.CENTER)
+    add_metadata_table(doc, config)
+
+    add_section_heading(doc, "一、项目目标")
+    add_callout(doc, "目标", config["project_goal"])
+
+    add_section_heading(doc, "二、解决方案")
+    for item in config["solution_items"]:
+        if isinstance(item, str):
+            add_bullet(doc, "方案", item)
+        else:
+            add_bullet(doc, item.get("label", "方案"), item.get("detail", ""))
+
+    add_section_heading(doc, "三、核心技术路线")
+    add_callout(doc, "链路", config["technical_route"], fill=PALE_GRAY)
+
+    add_section_heading(doc, "四、交付范围")
+    add_paragraph(doc, config["deliverables"], size=8.7, after=1, line=1.03)
+    if config["project_scope"]:
+        add_paragraph(doc, config["project_scope"], size=8.3, color=MUTED, after=1, line=1.0)
+
+    add_section_heading(doc, "五、项目总价与周期")
+    add_quote_table(doc, config)
+
+    add_section_heading(doc, "六、说明与边界")
+    add_paragraph(doc, config["boundary_note"], size=8.1, color=MUTED, after=0, line=1.0)
+
+    footer = section.footer.paragraphs[0]
+    format_paragraph(footer, after=0, line=1.0, align=WD_ALIGN_PARAGRAPH.RIGHT)
+    set_run_font(footer.add_run(f'Microi吾码 | {config["version"]} | {config["date"]} | https://microi.net'), 7.2, False, MUTED)
+
+    doc.core_properties.title = title
+    doc.core_properties.subject = "Microi吾码系统解决方案与报价"
+    doc.core_properties.author = "Microi吾码"
+    output.parent.mkdir(parents=True, exist_ok=True)
+    doc.save(output)
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Build a compact Microi solution quotation DOCX")
+    parser.add_argument("--input", required=True, help="UTF-8 JSON configuration file")
+    parser.add_argument("--output", required=True, help="Output DOCX path")
+    args = parser.parse_args()
+    with open(args.input, "r", encoding="utf-8") as handle:
+        config = normalize_config(json.load(handle))
+    output = Path(args.output).resolve()
+    build_document(config, output)
+    print(output)
+
+
+if __name__ == "__main__":
+    main()

package/skills/microi-system-delivery/references/progressive-02-/350/207/252/345/212/250/345/214/226/346/265/213/350/257/225/345/277/205/351/241/273/350/246/206/347/233/226/347/232/204/345/235/221.md

@@ -2,7 +2,7 @@
 
 > 按需读取；本文件由 SKILL.md 的原章节无损拆分。
 
-<!-- microi-progressive:chunk id=microi-system-delivery-006 sha256=bc1fbdecb428b0a94d04d55d22e5c14f61354097cbaa2a059574f47fb41f5bdc -->
+<!-- microi-progressive:chunk id=microi-system-delivery-006 sha256=3c429fa01c7c8b077ccb8bceca59ad0274f7b83e7989e2f21a861dd0e54f11aa -->
 ## 自动化测试必须覆盖的坑
 
 ### 后端统一测试与发布门禁
@@ -24,7 +24,7 @@
   `MICROI_TEST_ALLOW_WRITES=YES`。只有用户明确授权时才可对真实租户执行；
   真实租户默认只做登录和只读烟测，写入必须限定到名称/说明明确为自动化
   测试用途的专用表，并使用唯一前缀、`finally` 清理和清理回读。
-- Full 的本地程序与依赖按 `../../workspace-conventions/SKILL.md` 的“本地测试程序与依赖生命周期”执行：优先复用健康的本地源码程序、隔离目录中的编译产物和同组既有依赖，以租户、数据库或命名空间隔离测试，不按任务重复创建 Docker/Compose。每次测试成功、失败、取消或因资源不足暂停时，都结束本次自有测试进程并收回新建临时容器，独立回读进程、端口和容器状态；既有共享服务保持原状。这些生命周期要求不减少 Full 的用例、断言或发布门禁。
+- Full 的本地程序与依赖按 `../../workspace-conventions/SKILL.md` 的“本地测试程序与依赖生命周期”执行：优先复用健康的本地源码程序、隔离目录中的编译产物和同组既有依赖，以租户、数据库或命名空间隔离测试，不按任务重复创建 Docker/Compose。每次测试成功、失败、取消或因资源不足暂停时，都结束本次自有测试进程并收回新建临时容器，独立回读进程、端口和容器状态；既有共享服务保持原状。这些生命周期要求不减少当前选定 Full 矩阵的用例、断言或发布门禁。
 - Full 至少覆盖完整 Release 构建、FormEngine 单条/批量/按条件 CRUD、
   查询和计数、ApiEngine GET/JSON POST、API 实际启动与健康检查、真实登录、
   匿名系统配置脱敏、清理回读、NuGet 漏洞/弃用审计。NuGet 全面升级后不能
@@ -41,6 +41,24 @@
   Redis/MongoDB 短暂故障、响应前重启和新旧版本共存。
   两节点默认是两个本机源码或编译产物程序进程连接同组依赖，不等于两套 Docker 环境；破坏性故障测试仅作用于明确归属的隔离资源，不能停止复用的共享数据库或缓存。
 
+### 按指定 MCP 选择发布测试矩阵
+
+测试范围以 `workspace-conventions/SKILL.md` 的“平台回归与独立应用测试归属”为准。常规发布先核实用户指定的 Profile、ApiBase、OsClient 和实际依赖，再冻结本次必测清单；不能从本机恰好存在的连接或历史 Full 清单推导额外兼容矩阵。
+
+| 依赖 | 常规发布范围 | 验收依据 |
+|---|---|---|
+| MySQL | 指定 MCP 实际使用的服务与版本 | 隔离数据的 CRUD、事务、升级兼容及清理回读 |
+| MongoDB | 指定 MCP 实际使用的版本 | 实际读写、索引及本次功能相关持久化；不默认同时要求旧版和新版 |
+| Redis | 指定 MCP 对应的实例与隔离命名空间 | 会话、缓存、TTL、锁或任务等本次链路，以及清理回读 |
+| MinIO 或 OSS/HDFS | 该租户当前生效的提供商 | 实际上传、下载字节/哈希、公开/私有访问权限与自有测试对象清理；路由单测不能代替真实文件闭环 |
+| SQL Server | 仅用户明确指定排查、修复或验收 SQL Server 问题时加入 | 对应版本、隔离连接与问题回归；常规发布标“不适用（未执行）” |
+
+- 通用编译、离线单元/组件、安全、登录、业务闭环和候选源码/产物哈希校验仍按变更范围执行；指定依赖测试不能替代这些质量要求。
+- 只有所选矩阵中的必测项才参与环境完整性与零失败、零跳过门禁。没有选择的 SQL Server 专项不属于失败、待办或需要再次申请的免测；不得报告为已通过。其他提供商或跨版本矩阵也只按明确的专项需求扩展。
+- 混合 MySQL/SQL Server 用例必须按提供商独立选择夹具与断言；不能要求两种连接同时存在才运行 MySQL，也不能按整类排除而漏掉仍必测的 MySQL 行。
+- 旧脚本若仍硬编码 SQL Server 必填、MongoDB 多版本齐备或全提供商清单，先按本规则适配矩阵选择和结果统计，再使用正式发布入口。禁止每轮要求用户重新批准 SQL Server 免测、只删除必填变量、吞掉 skipped/失败或绕过一键发布门禁。
+- 记录目标 MCP、所选依赖/版本、用例数量、实际结果、不适用边界、候选哈希及资源回收证据；已选必测环境不可用时仍如实停止。生产故障注入或新增 Docker 依赖继续需要对应授权。
+
 ### 登录与账号密码
 
 - E2E 必须支持提前录入测试账号密码：`PW_TEST_ACCOUNT`、`PW_TEST_PASSWORD`、`PW_LOGIN_ENGINE`。