@microi.net/cli 4.6.2

package/dist/microi.skills/microi-solution-quotation/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: microi-solution-quotation
+description: Create or revise compact professional Microi吾码 system solution and quotation Word documents. Use when a user asks for a Microi吾码 解决方案、项目建议书、技术路线、实施周期、市场预估价、优惠报价或一页式 DOCX 报价，尤其适用于低代码、V8引擎、PC/UniApp/微信小程序、物联网和系统集成项目。
+---
+
+# Microi吾码解决方案与报价
+
+生成客户可直接查看或发送的 `.docx` 方案报价。先基于真实需求和资料确定技术边界，再用紧凑商务版式呈现价值、技术路线、总价、周期和限制条件。
+
+## 工作流程
+
+1. 读取需求、PDF、截图、现有 Word 和项目资料；不把尚未确认的硬件协议、第三方接口或平台能力写成已具备。
+2. 提炼项目目标、核心范围、Microi吾码实现方式、关键技术路线、交付物、风险与前置条件。
+3. 确定项目名称、版本、日期、开发周期、市场预估价、优惠报价和报价有效期。用户已给值时必须原样采用。
+4. 使用 `scripts/build_solution_quote.py` 生成 Word；复杂项目可按同一视觉规范扩展。
+5. 把 DOCX 渲染为 PNG，检查页数、字体、表格、换行和溢出；修正后再交付。缺少 LibreOffice/soffice 时做结构检查，并在交付说明中明确未完成视觉渲染。
+
+## 固定版式
+
+- 页面：A4 纵向。
+- 页边距：Word“窄”，上、下、左、右均为 `0.5 in / 1.27 cm / 720 DXA`。
+- 布局：紧凑、商务、可快速扫读。小项目默认一页；不要用缩小到 9pt 以下正文的方式硬塞内容。
+- 字体：中文优先 `Microsoft YaHei`，正文 9-10pt；标题 20-22pt；章节标题 10.5-12pt。
+- 大标题：`Microi吾码 {系统名称} 解决方案与报价`。
+- 副标题必须为：`AI 深度融合 V8引擎 的低代码平台，官网：https://microi.net`。
+- 标题下方放置版本、日期、开发周期、报价有效期；默认版本 `v1.0.0`，默认有效期 15 天。
+- 使用克制的吾码蓝色系；表格必须固定 DXA 宽度并设置单元格内边距，禁止依赖自动调整。
+- 页脚可放版本、日期和官网，不重复正文报价。
+
+## 内容结构
+
+按项目规模裁剪，但至少包含：
+
+1. 项目目标：1 段说明客户要解决的问题和最终结果。
+2. 解决方案：3-5 个具体范围，明确 Microi 表单引擎、V8 接口/事件、权限、PC 或移动端、第三方/硬件集成的分工。
+3. 技术路线：用一行可读链路表达核心数据流；物联网项目必须区分“手机本地直连”和“公网云控”。
+4. 交付范围：源代码/低代码元数据、接口、部署配置、联调、测试和简要操作说明。
+5. 总价与周期：只展示市场预估总价、优惠总价和开发周期，不列模块价格明细。
+6. 商务与技术边界：列出需求变更、第三方费用、硬件/云资源、协议资料、样机、账号资质等前置条件。
+
+## 报价规则
+
+- 不生成模块级价格表，不把各功能拆分报价。
+- 同时展示：`市场预估价`、`优惠报价`、`开发周期`。
+- 优惠报价应比市场预估价低；所有金额使用人民币并明确“总价”。
+- 用户未提供价格时，可根据范围给出合理市场预估并标注为参考；硬件改造、协议逆向和第三方服务等不确定成本必须排除或写为“另行评估”。
+- 不猜测含税状态、付款比例、质保年限或合同条款；用户未指定时写“以正式合同/确认需求清单为准”。
+
+## Microi吾码技术表达
+
+- 后台管理：优先使用表单引擎、菜单/权限和低代码元数据。
+- 业务逻辑：使用 V8 接口引擎、表单事件、定时任务和缓存，不把项目专属逻辑写入平台通用层。
+- 移动端：根据需求选择 UniApp/H5/微信小程序，并通过 HTTPS 调用后端接口。
+- 物联网：推荐 `小程序 -> HTTPS -> Microi V8 API -> MQTT/TLS -> 网关 -> 设备协议`；保留设备本地安全联锁、离线保护和操作审计。
+- 权限：菜单权限与接口业务权限同时设计；设备/客户数据必须做归属与行级校验。
+
+## 生成脚本
+
+准备 UTF-8 JSON 配置并运行：
+
+```powershell
+uv run --with python-docx -- python microi.skills/microi-solution-quotation/scripts/build_solution_quote.py `
+  --input .tmp/solution-quote.json `
+  --output "AI-Project/客户/项目/Microi吾码系统解决方案与报价.docx"
+```
+
+JSON 常用字段：`system_name`、`project_goal`、`solution_items`、`technical_route`、`deliverables`、`market_price`、`preferential_price`、`development_cycle`、`version`、`date`、`validity_days`、`boundary_note`。
+
+## 工作区与交付检查
+
+- 临时脚本、JSON、渲染图和 QA 产物必须写入仓库根目录 `.tmp/`，禁止创建根目录 `tmp/`。
+- 用户认为提取结果有长期价值时，将其整理到用户指定的项目目录，不留在临时目录。
+- 大标题、副标题、版本、日期、周期、市场预估价和优惠报价全部存在。
+- 没有模块明细价格，没有占位符，没有把未确认能力写成已交付。
+- 小项目只有一页；无截断、重叠、孤行、超宽表格和过小字体。
+- 最终回复仅链接正式 DOCX，不链接临时 JSON、生成脚本、PNG 或 PDF QA 文件。

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

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

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

@@ -0,0 +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()