@microi.net/cli 5.9.3 → 5.9.5

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/SKILL.md

@@ -35,14 +35,14 @@ Manifest 使用 `tables[].formBanner`；未显式配置时仍按字段类型选
 模块引擎或 `sys_menu`。逐步建模在字段完成后调用 `microi_configure_form_banner` 回读验收。
 
 <!-- microi-progressive:begin -->
-<!-- microi-progressive:chunk id=microi-system-delivery-000 sha256=bdbc78e88e50c53a3bd29eeb76ce34e3fed8eec5f4ba16371417d2aeee9c2fbe -->
+<!-- microi-progressive:chunk id=microi-system-delivery-000 sha256=04f08fdc316d253f167e26923066e134763ab129dd830f833c762214613c607f -->
 ## 交付总原则
 
 1. **先事实源，后建模**：先读需求文档、截图、现有蓝图、数据库结构和菜单结构，形成业务蓝图；不要边猜边建表、边猜边写接口。
 2. **先平台能力，后临时绕路**：能用 MCP/平台 API 修改元数据、字段、菜单、事件、接口引擎、数据源、任务调度，就不要新建临时 `_fix_*`、`_mcp_*` 接口引擎绕过平台能力。MCP 缺能力时优先补 MCP/后端，再补 Skill。
 3. **平台通用层禁止项目定制**：Microi.Server、Microi.Client、MCP、VS Code 插件、microi.skills 中不得写某个项目专属文案、专属上传限制、专属业务规则。项目规则应在租户表、接口引擎、业务配置、前端项目或业务蓝图中。
 4. **本地改完必须远端验收**：V8 文件、表单事件、菜单按钮、数据源、工作流、页面配置等不能只改本地文件。必须写入远端数据库，并通过 HTTP 或平台工具回读确认。
-5. **测试不等于接口能通**：交付前必须跑构建、接口契约、真实登录、核心写流程、截图、人眼复核、网络 404/5xx 守卫、远端同步状态。
+5. **测试不等于接口能通**：交付前必须跑构建、接口契约、真实登录、核心写流程、截图、人眼复核、网络 404/5xx 守卫、远端同步状态。依赖默认按 `workspace-conventions` 的“平台回归与独立应用测试归属”使用当前 MCP 实际 MongoDB 版本与 HDFS 提供商；明确的兼容任务才扩展矩阵，未执行项如实记录。
 6. **生产数据谨慎优先**：涉及真实会员、余额、积分、订单、库存、卡券、收益、佣金、分润等资金/资产数据时，先确认服务器、租户、目标表、筛选条件和影响范围，再执行 MCP、接口引擎或 SQL 写操作。除用户明确要求清理/重置或必须修复错误数据外，不得擅自批量改真实数据。
 7. **默认按分布式交付**：任何后端能力都假设会有至少两个节点连接同一数据库和 Redis，并经历滚动升级、重复投递与节点硬重启。定时任务/消费者使用分布式租约且业务本身幂等；会话、票据和任务状态使用共享存储；新旧版本并存时采用“先扩展、后迁移、再收缩”。只在单节点验证通过不能视为完整交付。
 8. **业务逻辑默认接口引擎、元数据升级默认应用商城**：先用低代码 CRUD/事件，再用接口引擎；只缺底层原子能力时先扩展 V8，只有协议/鉴权/密钥隔离/运行时内核才进入 C#。表、字段、Tab、菜单、权限、引擎、页面和任务等可打包资源不得新增 `Microi.Upgrade` 定制类；官方开发者通过 `microi_itdos` 发布官方应用后再由目标租户 MCP 更新，无官方权限时只升级自己的租户。

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=4b999e29e04c192319690a886ba25bb8952d5cc1910db8fa151b583d599b2be5 -->
+<!-- microi-progressive:chunk id=microi-system-delivery-006 sha256=1dd7c9face286616c392ece855acac7d1a3358afbad904a4ff6da5f10c0a8e01 -->
 ## 自动化测试必须覆盖的坑
 
 ### 后端统一测试与发布门禁
@@ -24,6 +24,7 @@
   `MICROI_TEST_ALLOW_WRITES=YES`。只有用户明确授权时才可对真实租户执行；
   真实租户默认只做登录和只读烟测，写入必须限定到名称/说明明确为自动化
   测试用途的专用表，并使用唯一前缀、`finally` 清理和清理回读。
+- Full 的本地程序与依赖按 `../../workspace-conventions/SKILL.md` 的“本地测试程序与依赖生命周期”执行：优先复用健康的本地源码程序、隔离目录中的编译产物和同组既有依赖，以租户、数据库或命名空间隔离测试，不按任务重复创建 Docker/Compose。每次测试成功、失败、取消或因资源不足暂停时，都结束本次自有测试进程并收回新建临时容器，独立回读进程、端口和容器状态；既有共享服务保持原状。这些生命周期要求不减少 Full 的用例、断言或发布门禁。
 - Full 至少覆盖完整 Release 构建、FormEngine 单条/批量/按条件 CRUD、
   查询和计数、ApiEngine GET/JSON POST、API 实际启动与健康检查、真实登录、
   匿名系统配置脱敏、清理回读、NuGet 漏洞/弃用审计。NuGet 全面升级后不能
@@ -38,6 +39,7 @@
 - 即使 Full 通过，涉及定时任务、消息消费、共享缓存、迁移或滚动发布时，
   仍需两个节点连接同一 Redis/数据库，覆盖重复投递、锁持有者退出、
   Redis/MongoDB 短暂故障、响应前重启和新旧版本共存。
+  两节点默认是两个本机源码或编译产物程序进程连接同组依赖，不等于两套 Docker 环境；破坏性故障测试仅作用于明确归属的隔离资源，不能停止复用的共享数据库或缓存。
 
 ### 登录与账号密码