h3factory 0.0.0-stage → 0.2.2

package/h3platform/api.py

@@ -0,0 +1,214 @@
+# -*- coding: utf-8 -*-
+"""氚云 HTTP 封装：/v1/functionnode、/v1/formdesign/save、/v1/schema、/OpenApi/Invoke"""
+import json
+import time
+import urllib.request
+import urllib.error
+
+from . import settings
+
+# 响应键大小写不一（web 接口 camelCase，OpenAPI PascalCase），统一不区分大小写取值
+def _ci(d, *keys):
+    if not isinstance(d, dict):
+        return None
+    for k in keys:
+        for kk, vv in d.items():
+            if kk.lower() == k.lower():
+                return vv
+    return None
+
+
+class H3Error(Exception):
+    def __init__(self, message, raw=None):
+        super().__init__(message)
+        self.raw = raw
+
+
+class H3:
+    def __init__(self, cfg=None):
+        if cfg is None:
+            cfg = settings.load_config()
+        self.base_url = cfg["baseUrl"].rstrip("/") + "/"
+        self.engine_code = cfg["engineCode"]
+        self.engine_secret = cfg["engineSecret"]
+        self.authorization = cfg["authorization"]
+        self.app_code = cfg.get("appCode", "")
+        self.app_name = cfg.get("appName", "")
+
+    def _call(self, url, payload=None, timeout=120, headers_extra=None,
+              method=None):
+        data = None
+        if payload is not None:
+            data = json.dumps(payload, ensure_ascii=False).encode("utf-8")
+        if method is None:
+            method = "POST" if data else "GET"
+        req = urllib.request.Request(url, data=data, method=method)
+        req.add_header("Content-Type", "application/json")
+        req.add_header("EngineCode", self.engine_code)
+        if headers_extra:
+            for k, v in headers_extra.items():
+                req.add_header(k, v)
+        try:
+            with urllib.request.urlopen(req, timeout=timeout) as resp:
+                body = resp.read().decode("utf-8", "replace")
+        except urllib.error.HTTPError as e:
+            raise H3Error(f"HTTP {e.code} on {url.split('?')[0]}", e.read().decode("utf-8", "replace"))
+        except urllib.error.URLError as e:
+            raise H3Error(f"network error: {e}")
+        if not body.strip():
+            raise H3Error(f"empty response from {url.split('?')[0]}")
+        try:
+            return json.loads(body)
+        except ValueError:
+            raise H3Error(f"non-JSON response from {url.split('?')[0]}: {body[:300]}")
+
+    # ---- web 接口（Authorization + EngineCode）----
+    def _web_headers(self):
+        return {"Authorization": self.authorization}
+
+    def _check_web(self, resp):
+        if resp is None:
+            raise H3Error("empty response")
+        ok = _ci(resp, "successful")
+        if ok is False or _ci(resp, "errorCode") is not None:
+            msg = _ci(resp, "errorMessage") or _ci(resp, "message") or "unknown error"
+            raise H3Error(msg, resp)
+        return _ci(resp, "returnData") if "returnData" in resp else resp
+
+    def save_form(self, schema_request):
+        """保存表单结构（建表）。schema_request 为 FormSchemaRequest 同构 dict。"""
+        url = self.base_url + "v1/formdesign/save"
+        resp = self._call(url, schema_request, headers_extra=self._web_headers())
+        return self._check_web(resp)
+
+    def get_schema(self, schema_code):
+        """读取已保存的表单结构（用于回读验证）。无此表单返回 None。"""
+        url = (self.base_url + "v1/schema?schemaCode=" + schema_code + "&timestamp=-1")
+        resp = self._call(url, headers_extra=self._web_headers())
+        ec = _ci(resp, "errorCode")
+        if ec and "isnull" in str(ec):
+            return None
+        if _ci(resp, "successful") is False:
+            raise H3Error(_ci(resp, "errorMessage") or "schema read failed", resp)
+        return _ci(resp, "returnData") or resp
+
+    def create_app(self, app_code, app_name):
+        url = self.base_url + "v1/functionnode"
+        payload = {"appCode": app_code, "code": app_code, "displayName": app_name,
+                   "icon": "ywfl;cpyf;yw-cpyf-agility", "iconColor": 0, "nodeType": 190}
+        resp = self._call(url, payload, headers_extra=self._web_headers())
+        return self._check_web(resp)
+
+    # ---- 表单分组（应用菜单分组；v1/functionnode，载荷逐字对照 UI，2026-09-09）----
+    def create_group(self, app_code, display_name, parent_code=None):
+        """建分组（nodeType=230）。顶层分组 parentCode=appCode（可省 = 顶层）。
+        UI 实证建组是两步：create 落一个 32hex 分组码（非表单编码格式），
+        随后必须 update 改名 —— 客户端 create 后要跟 update_group。返回 (code, objectId)。"""
+        payload = {"appCode": app_code, "parentCode": parent_code or app_code,
+                   "displayName": display_name, "nodeType": 230, "icon": ""}
+        resp = self._call(self.base_url + "v1/functionnode", payload,
+                          headers_extra=self._web_headers())
+        return self._node_keys(self._check_web(resp))
+
+    def update_group(self, app_code, group_code, object_id, display_name,
+                     parent_code=None):
+        """分组改名/落定（update 载荷 = create 全套字段 + code/objectId/summary）。"""
+        payload = {"appCode": app_code, "parentCode": parent_code or app_code,
+                   "displayName": display_name, "nodeType": 230, "icon": "",
+                   "code": group_code, "objectId": object_id, "summary": ""}
+        resp = self._call(self.base_url + "v1/functionnode/update", payload,
+                          headers_extra=self._web_headers())
+        return self._check_web(resp)
+
+    def move_node(self, code, parent_code):
+        """归组/移动：PUT v1/functionnode/sort。code=表单编码或分组码，
+        parentCode=目标分组码（表单置回顶层 = appCode）。"""
+        resp = self._call(self.base_url + "v1/functionnode/sort",
+                          {"code": code, "parentCode": parent_code},
+                          method="PUT", headers_extra=self._web_headers())
+        return self._check_web(resp)
+
+    @staticmethod
+    def _node_keys(resp):
+        """从 functionnode 响应取 (code, node_id)：兼容顶层或 ReturnData 嵌套、键大小写。
+        实证（2026-09-09）：create 响应 = {id: GUID, code: 32hex}；update 载荷要用
+        objectId 字段传同一个 GUID（UI 载荷同）。"""
+        d = resp
+        if isinstance(d, dict):
+            rd = None
+            for k, v in d.items():
+                if k.lower() == "returndata":
+                    rd = v
+            if isinstance(rd, dict):
+                d = rd
+        code, oid = _ci(d, "code"), _ci(d, "id") or _ci(d, "objectid")
+        if code and oid:
+            return code, oid
+        raise H3Error("functionnode 响应缺 code/id: %s" % str(resp)[:300], resp)
+
+    # ---- OpenAPI（EngineCode + EngineSecret，建数据用）----
+    def _open_headers(self):
+        return {"EngineCode": self.engine_code, "EngineSecret": self.engine_secret}
+
+    def openapi_invoke(self, action, schema_code=None, extra=None, timeout=120):
+        params = {"ActionName": action}
+        if schema_code:
+            params["SchemaCode"] = schema_code
+        if extra:
+            params.update(extra)
+        resp = self._call(self.base_url + "OpenApi/Invoke", params,
+                          timeout=timeout, headers_extra=self._open_headers())
+        ok = _ci(resp, "successful")
+        if ok is False:
+            raise H3Error(_ci(resp, "errorMessage") or "openapi failed", resp)
+        return _ci(resp, "returnData")
+
+    def create_biz_objects(self, schema_code, objs, is_submit=False, batch=50):
+        """批量创建表单数据，objs 为字段 dict 列表。"""
+        created, failed = 0, []
+        for i in range(0, len(objs), batch):
+            chunk = objs[i:i + batch]
+            try:
+                self.openapi_invoke("CreateBizObjects", schema_code, {
+                    "BizObjectArray": json.dumps(chunk, ensure_ascii=False),
+                    "IsSubmit": str(is_submit).lower(),
+                }, timeout=300)
+                created += len(chunk)
+            except H3Error as e:
+                failed.extend((i + j, obj) for j, obj in enumerate(chunk))
+                print(f"  batch {i // batch} failed: {e}")
+        return created, failed
+
+    def create_biz_object(self, schema_code, obj, is_submit=True, timeout=60):
+        """新增单条。BizObject 必须是 JSON 字符串（对照 h3yun-api skill 实测）。"""
+        return self.openapi_invoke("CreateBizObject", schema_code, {
+            "BizObject": json.dumps(obj, ensure_ascii=False),
+            "IsSubmit": is_submit,
+        }, timeout=timeout)
+
+    def load_biz_objects(self, schema_code, max_rows=1000, page_size=500):
+        """读回数据。Filter 树形 Matcher 格式（参照 云星辰 H3CloudClient 实测）。
+        ReturnData = {BizObjectArray:[{字段..., ObjectId}]}"""
+        all_rows, from_row = [], 0
+        while True:
+            filter_json = json.dumps({
+                "FromRowNum": from_row, "ToRowNum": from_row + page_size,
+                "RequireCount": False, "ReturnItems": [],
+                "SortByCollection": [],
+                "Matcher": {"Type": "And", "Matchers": []}}, ensure_ascii=False)
+            rd = self.openapi_invoke("LoadBizObjects", schema_code, {"Filter": filter_json})
+            if isinstance(rd, dict):
+                rows = _ci(rd, "bizobjectarray") or []
+            else:
+                rows = rd or []
+            all_rows.extend(rows)
+            if len(rows) < page_size or len(all_rows) >= max_rows or from_row + page_size >= 1000:
+                break
+            from_row += page_size
+        return all_rows
+
+    def load_biz_object(self, schema_code, object_id):
+        return self.openapi_invoke("LoadBizObject", schema_code, {"BizObjectId": object_id})
+
+    def remove_biz_object(self, schema_code, object_id):
+        return self.openapi_invoke("RemoveBizObject", schema_code, {"BizObjectId": object_id})

package/h3platform/h3console.py

@@ -0,0 +1,99 @@
+# -*- coding: utf-8 -*-
+"""氚云设计器控制台接口（新引擎真实建表端点）：
+POST {base}/Console/SheetDesigner/OnAction
+表单编码 x-www-form-urlencoded: PostData=<JSON字符串>"""
+import json
+import urllib.parse
+import urllib.request
+import urllib.error
+
+from . import settings
+
+
+class ConsoleError(Exception):
+    def __init__(self, message, raw=None):
+        super().__init__(message)
+        self.raw = raw
+
+
+class H3Console:
+    def __init__(self, cfg=None):
+        if cfg is None:
+            cfg = settings.load_config()
+        self.base_url = cfg["baseUrl"].rstrip("/") + "/"
+        self.authorization = cfg["authorization"]
+        self.engine_code = cfg["engineCode"]
+
+    def _call(self, post_json, headers_extra=None, timeout=120):
+        body = urllib.parse.urlencode(
+            {"PostData": json.dumps(post_json, ensure_ascii=False)}).encode("utf-8")
+        req = urllib.request.Request(self.base_url + "Console/SheetDesigner/OnAction",
+                                     data=body, method="POST")
+        req.add_header("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8")
+        req.add_header("Authorization", self.authorization)
+        req.add_header("EngineCode", self.engine_code)
+        if headers_extra:
+            for k, v in headers_extra.items():
+                req.add_header(k, v)
+        try:
+            with urllib.request.urlopen(req, timeout=timeout) as resp:
+                raw = resp.read().decode("utf-8", "replace")
+        except urllib.error.HTTPError as e:
+            raise ConsoleError(f"HTTP {e.code}", e.read().decode("utf-8", "replace"))
+        except urllib.error.URLError as e:
+            raise ConsoleError(f"network error: {e}")
+        if not raw.strip():
+            raise ConsoleError("empty response")
+        try:
+            return json.loads(raw)
+        except ValueError:
+            raise ConsoleError("non-JSON response: " + raw[:300])
+
+    def action(self, name, **extra):
+        """任意 OnAction 动作"""
+        payload = {"ActionName": name}
+        payload.update(extra)
+        return self._call(payload)
+
+    def load_form(self, sheet_code):
+        """设计器加载表单（完整设计态，含 SchemaStr/BizSheetStr 原文）"""
+        return self.action("LoadForm", id=sheet_code)
+
+
+def save_form_console(console, sheet_code, engine_code, app_code, parent_code,
+                      display_name, schema_dict, biz_dict,
+                      name_schema="", display_setting=1, pc_layout="1",
+                      pc_layout_config=('{"LayoutType":1,"TitleFontWeight":400,'
+                                        '"TitleWidth":84,"TitleAlign":"left","BorderShow":false}'),
+                      mobile_layout="1",
+                      mobile_layout_config=('{"LayoutType":1,"TitleFontWeight":400,'
+                                            '"TitleWidth":80,"TitleAlign":"left","BorderShow":false}'),
+                      node_type=200, icon="icon-cgfk", open_type=0,
+                      enable_data_acl=True, control_settings_str="[]",
+                      describe_image_list=(), summary="", extra_top=None):
+    """构造并调用设计器 SaveForm。schema_dict/biz_dict 为 dict，内部会序列化为字符串字段。"""
+    payload = {
+        "ActionName": "SaveForm",
+        "SheetCode": sheet_code,
+        "EngineCode": engine_code,
+        "AppCode": app_code,
+        "ParentCode": parent_code,
+        "DisplayName": display_name,
+        "DisplaySetting": display_setting,
+        "PCLayout": pc_layout,
+        "PCLayoutConfig": pc_layout_config,
+        "MobileLayout": mobile_layout,
+        "MobileLayoutConfig": mobile_layout_config,
+        "NodeType": node_type,
+        "Icon": icon,
+        "OpenType": open_type,
+        "IsBindBizService": False,
+        "SchemaStr": json.dumps(schema_dict, ensure_ascii=False),
+        "BizSheetStr": json.dumps(biz_dict, ensure_ascii=False),
+        "ControlSettingsStr": control_settings_str,
+        "DescribeImageList": list(describe_image_list),
+        "Summary": summary,
+    }
+    if extra_top:
+        payload.update(extra_top)
+    return console._call(payload)

package/h3platform/settings.py

@@ -0,0 +1,74 @@
+# -*- coding: utf-8 -*-
+"""工作区与配置路径解析。
+
+代码根 CODE_ROOT（npm 安装包目录）只读；工作区 WORKSPACE 是用户当前目录
+（或 H3FACTORY_HOME），存放 projects/ 和 config.json。这样全局安装后不会
+把业务数据写进 node_modules。
+"""
+import json
+import os
+
+CODE_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+
+
+class ConfigError(Exception):
+    """配置缺失或无法读取。"""
+
+
+def workspace_root():
+    env = os.environ.get("H3FACTORY_HOME")
+    if env:
+        return os.path.abspath(os.path.expanduser(env))
+    return os.getcwd()
+
+
+def projects_dir():
+    return os.path.join(workspace_root(), "projects")
+
+
+def project_dir(name):
+    return os.path.join(projects_dir(), name)
+
+
+def user_config_dir():
+    return os.path.join(os.path.expanduser("~"), ".h3factory")
+
+
+def config_candidates():
+    """按优先级列出配置文件路径：显式环境变量 > 工作区 > 用户目录。"""
+    env = os.environ.get("H3FACTORY_CONFIG")
+    if env:
+        yield os.path.abspath(os.path.expanduser(env))
+    yield os.path.join(workspace_root(), "config.json")
+    yield os.path.join(user_config_dir(), "config.json")
+
+
+def resolve_config_path():
+    for path in config_candidates():
+        if os.path.isfile(path):
+            return path
+    return None
+
+
+def default_config_path():
+    """init 的写入位置：H3FACTORY_CONFIG > 工作区 config.json。"""
+    env = os.environ.get("H3FACTORY_CONFIG")
+    if env:
+        return os.path.abspath(os.path.expanduser(env))
+    return os.path.join(workspace_root(), "config.json")
+
+
+def load_config(required=True):
+    path = resolve_config_path()
+    if path:
+        try:
+            with open(path, encoding="utf-8") as f:
+                return json.load(f)
+        except Exception as e:
+            raise ConfigError("读取配置失败 %s: %s" % (path, e))
+    if not required:
+        return {"appCode": ""}
+    raise ConfigError(
+        "缺 config.json —— 先运行 h3factory auth status --json 检查；"
+        "需要录入时用 h3factory auth set --json（stdin 写入）或 h3factory init，"
+        "也可设置 H3FACTORY_CONFIG 指向已有配置")

package/h3verify/verify.py

@@ -0,0 +1,217 @@
+# -*- coding: utf-8 -*-
+"""LoadForm 只读回读校验：把"期望"（loader 构建的控件结构）与线上表单比对。
+不 SaveForm，可安全重复运行。核对项：
+  - 字段数 / 缺字段 / 额外字段
+  - 每字段 DisplayRule 隐藏条件文本（期望 vs 线上）
+  - 一行多列（type 102）行节点数（layout 里 list 组的个数）
+  - NameSchema
+报告 dict 供 cli.py 输出（stdout + logs/verify_report.txt UTF-8）。"""
+import json
+import time
+
+MAX_SHOW = 10
+
+
+def ci(d, name):
+    """dict 大小写不敏感取值（LoadForm 用 PascalCase，SaveForm 用 camelCase）"""
+    for k in d:
+        if k.lower() == name.lower():
+            return d[k]
+    return None
+
+
+def walk_items(node):
+    """递归收集控件/行节点 dict（含一行多列行节点内 columns/childControls 子项）"""
+    out = []
+    if isinstance(node, dict):
+        if ci(node, "Options") is not None or ci(node, "type") is not None \
+                or ci(node, "Key") is not None:
+            out.append(node)
+        for v in node.values():
+            out.extend(walk_items(v))
+    elif isinstance(node, list):
+        for v in node:
+            out.extend(walk_items(v))
+    return out
+
+
+def _parse_dmc(rd):
+    dmc = rd.get("DesignModeContent")
+    dmc = json.loads(dmc) if isinstance(dmc, str) else dmc
+    return dmc
+
+
+def collect_live(rd):
+    """DesignModeContent → (by_code{key: Options}, rows[行节点], names)"""
+    items = walk_items(_parse_dmc(rd))
+    by_code, rows = {}, []
+    for d in items:
+        o = ci(d, "Options") or ci(d, "options") or {}
+        ty = ci(d, "type")
+        cols = ci(d, "columns") or ci(d, "childControls")
+        # 子表(104)节点虽有 columns，但整行占表单底，不算一行多列(102)行组
+        if ty == 102 or (cols is not None and ci(d, "Key") is None and ty != 104):
+            rows.append(d)
+            continue
+        key = ci(o, "DataField") or ci(d, "Key")
+        if key:
+            by_code.setdefault(key, o)
+    return by_code, rows
+
+
+def expected_rules(form):
+    """loader 产物 → {code: 期望 DisplayRule 文本}（空串=常显）。
+    布局项（分组标题/描述）没有 DataField，回读设计树按 key 收集 —— 同样登记。
+    子表：子表主编码（key=child schema code）与其每列 dotted code
+    （code.列key）作为普通期望字段 —— LoadForm 设计树中 104 节点以
+    options.DataField 收集，与主字段同路径比对。"""
+    expect = {}
+    for c in list(form["fields"]) + list(form.get("extras") or []):
+        r = (c.get("Options") or {}).get("DisplayRule")
+        expect[c["Key"]] = r.get("Rule") if isinstance(r, dict) else ""
+    for s in form.get("subs") or []:
+        code = s.get("code")
+        if not code:
+            continue      # 未建表（registry 无 subs 编码）时只比主字段
+        expect.setdefault(code, "")
+        for col in s["cols"]:
+            expect.setdefault("%s.%s" % (code, col["Key"]), "")
+    return expect
+
+
+def expected_layout_rows(form):
+    """layout 里一行多列（list）组数；单控件整行不计行组"""
+    return sum(1 for g in form.get("layout", []) if isinstance(g, list))
+
+
+def _af_rule(ctl):
+    """控件/裸 Options 的 AssociationFilter 规则文本（联动下拉）。Options 侧是
+    {Rule: ..} 字典（FormLayout/回读），宽容处理裸字符串与 RuleText。
+    两种入参形态：{Key, Options{...}}（期望侧）或 裸 Options（live_by_code 侧）。"""
+    o = ctl if isinstance(ctl, dict) and "Options" not in ctl else (ctl or {}).get("Options")
+    if not isinstance(o, dict):
+        return ""
+    af = o.get("AssociationFilter")
+    if isinstance(af, dict):
+        for k in ("Rule", "RuleText"):
+            if k in af:
+                return af[k] or ""
+        return ""
+    return af or ""
+
+
+def _norm_rule(s):
+    """规则文本规整比对：去 NBSP/空白漂移。UI 重存会在规则串头尾、AND 两侧、
+    函数逗号后插 NBSP、给 ==/!= 加空格（2026-09-09 实证）——语义比对前规整。"""
+    return "".join(str(s or "").replace(" ", " ").split())
+
+
+def _settings_of(controls):
+    """期望侧：位置控件的 ControlSettings（控件 dict 上的独立键）→ {key: {k: 文本}}"""
+    out = {}
+    for c in controls:
+        cs = c.get("ControlSettings")
+        if cs:
+            out[c["Key"]] = {str(k): str(v) for k, v in cs.items()}
+    return out
+
+
+def _live_settings(rd):
+    """线上侧：LoadForm ReturnData.ControlSettings（**首字母大写**：Key/DataField/
+    Options；SaveForm 收的是小写 key/dataField/options）→ {key: {k: 文本}}"""
+    out = {}
+    for e in (rd.get("ControlSettings") or []):
+        if not isinstance(e, dict):
+            continue
+        k = ci(e, "Key") or ci(e, "DataField")
+        o = ci(e, "Options") or {}
+        if k:
+            out[k] = {str(kk): str(vv) for kk, vv in o.items()}
+    return out
+
+
+def compare(form, rd):
+    """form = loader 产物；rd = LoadForm ReturnData → 核对结果 dict"""
+    expect = expected_rules(form)
+    live_by_code, rows = collect_live(rd)
+    miss, extra, bad, badf = [], [], [], []
+    for code in expect:
+        if code not in live_by_code:
+            miss.append(code)
+            continue
+        o = live_by_code[code]
+        r = o.get("DisplayRule") or {}
+        got = r.get("Rule") if isinstance(r, dict) else ""
+        if (expect[code] or "") != (got or ""):
+            bad.append((code, expect[code], got))
+    # 联动下拉 AssociationFilter：期望带规则的才比；规则有 NBSP/空白漂移，
+    # 规整（去全部空白）后语义比对；线上重存后整条丢失也视为不符
+    for c in form["fields"]:
+        exp = _norm_rule(_af_rule(c))
+        if not exp:
+            continue
+        got = _norm_rule(_af_rule(live_by_code.get(c["Key"])))
+        if exp != got:
+            badf.append((c["Key"], exp, got))
+    for code in live_by_code:
+        # 系统拥有者字段（OwnerId/OwnerDeptId）经 UI 布局加入，属正常存在，不算额外
+        if code not in expect and code not in ("_id", "ObjectId",
+                                               "OwnerId", "OwnerDeptId"):
+            extra.append(code)
+    # 位置控件设置（ControlSettingsStr）：期望有才比，逐键比文本
+    exp_set = _settings_of(form["fields"])
+    live_set = _live_settings(rd)
+    badset = []
+    for k, want in exp_set.items():
+        got_s = live_set.get(k)
+        if got_s is None:
+            badset.append((k, want, None))
+            continue
+        for kk, vv in want.items():
+            if got_s.get(kk) != vv:
+                badset.append(("%s.%s" % (k, kk), vv, got_s.get(kk)))
+    row_sizes = [len(ci(d, "columns") or ci(d, "childControls") or []) for d in rows]
+    n_expect_rows = expected_layout_rows(form)
+    name_live = rd.get("NameSchema")
+    # extra（线上比定义多的字段）只提示不判失败：用户在界面加字段是常态，定义可随后同步
+    ok = (not miss and not bad and not badf and not badset
+          and len(rows) == n_expect_rows)
+    return {"ok": ok,
+            "fields_expect": len(expect), "fields_live": len(live_by_code),
+            "miss": miss, "extra": extra[:MAX_SHOW], "bad": bad[:MAX_SHOW],
+            "badf": badf[:MAX_SHOW], "badset": badset[:MAX_SHOW],
+            "rows_expect": n_expect_rows, "rows_live": len(rows),
+            "row_sizes": row_sizes,
+            "name_expect": form.get("name_schema", ""), "name_live": name_live}
+
+
+def format_report(tag, code, form, rd):
+    """核对结果 → 多行文本（PASS/FAIL + 明细），可写日志或直出"""
+    r = compare(form, rd)
+    lines = ["== %s %s ==" % (tag, code)]
+    subs = form.get("subs") or []
+    n_sub = len(subs)
+    n_scol = sum(len(s["cols"]) for s in subs)
+    lines.append("字段: 期望 %d 实得 %d | 规则: 不符 %d%s%s | 行组(102): 期望 %d 实得 %d (%s)%s"
+                 % (r["fields_expect"], r["fields_live"], len(r["bad"]),
+                    (" | 联动过滤: 不符 %d" % len(r["badf"])) if r["badf"] else "",
+                    (" | 位置设置: 不符 %d" % len(r["badset"])) if r["badset"] else "",
+                    r["rows_expect"], r["rows_live"], r["row_sizes"],
+                    (" | 子表: %d(列%d)" % (n_sub, n_scol)) if n_sub else ""))
+    if r["miss"]:
+        lines.append("缺字段(%d): %s" % (len(r["miss"]), r["miss"][:MAX_SHOW]))
+    if r["extra"]:
+        lines.append("INFO 线上多出字段（UI 后加，定义未同步）: %s" % r["extra"])
+    for k, e, g in r["bad"][:MAX_SHOW]:
+        lines.append("规则不符 %s\n    期望 %s\n    实得 %s" % (k, e, g))
+    for k, e, g in r["badf"][:MAX_SHOW]:
+        lines.append("联动过滤不符 %s\n    期望 %s\n    实得 %s" % (k, e, g))
+    for k, e, g in r["badset"][:MAX_SHOW]:
+        if g is None:
+            lines.append("位置设置缺失 %s（期望 %s；线上无此控件的 ControlSettings）" % (k, e))
+        else:
+            lines.append("位置设置不符 %s\n    期望 %s\n    实得 %s" % (k, e, g))
+    if r["name_expect"] and r["name_live"] != r["name_expect"]:
+        lines.append("NameSchema 期望 %s 实得 %s" % (r["name_expect"], r["name_live"]))
+    lines.append("核对结果: %s" % ("PASS" if r["ok"] else "FAIL"))
+    return "\n".join(lines)

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "h3factory",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.2",
+  "description": "氚云（H3Yun）表单工厂：需求 → 表单定义 → 建表 → 只读核对 → 代码骨架",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xiangduo10146814/h3factory.git"
+  },
+  "homepage": "https://github.com/xiangduo10146814/h3factory#readme",
+  "bugs": {
+    "url": "https://github.com/xiangduo10146814/h3factory/issues"
+  },
+  "keywords": [
+    "h3yun",
+    "氚云",
+    "low-code",
+    "ai-agent",
+    "claude-code",
+    "cli"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "bin": {
+    "h3factory": "bin/h3factory.js"
+  },
+  "files": [
+    "bin/",
+    "scripts/postinstall.js",
+    "cli.py",
+    "h3platform/",
+    "h3design/",
+    "h3verify/",
+    "templates/",
+    "docs/",
+    "skills/",
+    "projects/demo/",
+    "config.example.json",
+    "README.md",
+    "!**/__pycache__/",
+    "!**/*.pyc"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js",
+    "prepare": "node scripts/postinstall.js --quiet",
+    "pack:check": "npm pack --dry-run"
+  },
+  "engines": {
+    "node": ">=16"
+  }
+}

package/projects/demo/dicts.json

@@ -0,0 +1,10 @@
+{
+  "大类别": [
+    { "code": "SJ", "name": "塑胶件" },
+    { "code": "DZ", "name": "电子料" },
+    { "code": "WJ", "name": "五金件" },
+    { "code": "CP", "name": "成品" },
+    { "code": "FL", "name": "辅料" }
+  ],
+  "启用状态": ["启用", "停用"]
+}