tkunity 2026.10.31__py3-none-any.whl

tkunity/editor.py

@@ -0,0 +1,702 @@
+# -*- coding: utf-8 -*-
+"""Unity 风格图形编辑器（纯 tkinter，无第三方依赖）。
+
+布局：
+    左侧  零件库 + 物体列表
+    中间  可拖拽/缩放的网格画布（场景区）
+    右侧  动态属性面板
+顶部工具栏：新建 / 打开 / 保存 / 另存为 / 预览 / 导出APK / 关于
+"""
+from __future__ import annotations
+
+import os
+import tkinter as tk
+from tkinter import colorchooser, filedialog, messagebox
+
+from . import __version__, __author__, __author_email__, __license__
+from . import export, pyu
+from .components import ADDABLE_COMPONENTS, COMPONENT_SCHEMAS, PARTS
+
+__all__ = ["launch_editor", "GRID"]
+
+GRID = 20
+PART_SIZES = {"矩形": (80, 60), "椭圆": (80, 60), "文本": (160, 40),
+              "图片": (120, 120), "点击触发器": (80, 60), "定时器": (80, 60)}
+BG_OUTSIDE = "#b9bec9"
+
+
+class EditorApp(object):
+    """编辑器主窗口。"""
+
+    def __init__(self, root, file=None):
+        self.root = root
+        self.project = pyu.new_project("未命名项目")
+        self.current_path = None
+        self.selection = None          # 选中的 entity id
+        self.pending_part = None       # 待放置的零件名（点画布放置）
+        self._photos = {}              # 资源名 -> PhotoImage
+        self._item_ids = {}            # eid -> canvas item id 列表
+        self._drag = None              # {"eid", "mode"(move/resize), "ox","oy","sx","sy"}
+        self._prop_vars = {}           # 属性面板当前 widget 的 var 收集
+        self._prop_widgets = []
+
+        root.title("tkunity 编辑器 v%s - oiiaio-web" % __version__)
+        root.geometry("1280x760")
+        root.minsize(960, 560)
+
+        self._build_toolbar()
+        self._build_body()
+        self._build_statusbar()
+        root.bind("<Delete>", lambda e: self.delete_selection())
+        root.protocol("WM_DELETE_WINDOW", self._quit)
+
+        if file:
+            self.open_path(file)
+
+    # ---------------------------------------------------------- UI 构建
+    def _build_toolbar(self):
+        bar = tk.Frame(self.root, bd=0, relief=tk.FLAT)
+        bar.pack(side=tk.TOP, fill=tk.X, padx=6, pady=6)
+        btns = [
+            ("新建", self.new_project),
+            ("打开", self.open_project),
+            ("保存", self.save_project),
+            ("另存为", self.save_project_as),
+            ("|", None),
+            ("预览", self.preview),
+            ("导出APK", self.export_apk),
+            ("|", None),
+            ("关于", self.about),
+        ]
+        for text, cmd in btns:
+            if text == "|":
+                tk.Frame(bar, width=2, bg="#cccccc").pack(side=tk.LEFT, padx=6, fill=tk.Y)
+            else:
+                tk.Button(bar, text=text, command=cmd, padx=10, pady=2,
+                          relief=tk.RAISED, bd=1).pack(side=tk.LEFT, padx=2)
+
+    def _build_body(self):
+        body = tk.Frame(self.root)
+        body.pack(side=tk.TOP, fill=tk.BOTH, expand=True, padx=6)
+
+        # 左：零件库 + 物体列表
+        left = tk.Frame(body, width=180)
+        left.pack(side=tk.LEFT, fill=tk.Y, padx=(0, 6))
+        left.pack_propagate(False)
+        tk.Label(left, text="零件库", font=("Helvetica", 12, "bold")).pack(anchor="w", pady=(0, 4))
+        tk.Label(left, text="点选后在画布上单击放置\n双击放到画布中心",
+                 fg="#666666", justify="left", font=("Helvetica", 9)).pack(anchor="w")
+        self.parts_list = tk.Listbox(left, height=7, exportselection=False)
+        for name, _ in PARTS:
+            self.parts_list.insert(tk.END, name)
+        self.parts_list.pack(fill=tk.X)
+        self.parts_list.bind("<<ListboxSelect>>", self._on_parts_select)
+        self.parts_list.bind("<Double-Button-1>", self._on_parts_double)
+
+        tk.Label(left, text="物体列表", font=("Helvetica", 12, "bold")).pack(anchor="w", pady=(10, 4))
+        self.objects_list = tk.Listbox(left, exportselection=False)
+        self.objects_list.pack(fill=tk.BOTH, expand=True)
+        self.objects_list.bind("<<ListboxSelect>>", self._on_objects_select)
+
+        # 中：网格画布
+        center = tk.Frame(body)
+        center.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
+        self.canvas = tk.Canvas(center, bg=BG_OUTSIDE, highlightthickness=0)
+        vbar = tk.Scrollbar(center, orient=tk.VERTICAL, command=self.canvas.yview)
+        hbar = tk.Scrollbar(center, orient=tk.HORIZONTAL, command=self.canvas.xview)
+        self.canvas.configure(xscrollcommand=hbar.set, yscrollcommand=vbar.set)
+        vbar.pack(side=tk.RIGHT, fill=tk.Y)
+        hbar.pack(side=tk.BOTTOM, fill=tk.X)
+        self.canvas.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
+        self.canvas.bind("<Button-1>", self._on_canvas_press)
+        self.canvas.bind("<B1-Motion>", self._on_canvas_drag)
+        self.canvas.bind("<ButtonRelease-1>", self._on_canvas_release)
+
+        # 右：属性面板
+        right = tk.Frame(body, width=270, bg="#f4f5f7")
+        right.pack(side=tk.LEFT, fill=tk.Y, padx=(6, 0))
+        right.pack_propagate(False)
+        tk.Label(right, text="属性面板", font=("Helvetica", 12, "bold"),
+                 bg="#f4f5f7").pack(anchor="w", pady=(0, 4))
+        self.prop_canvas = tk.Canvas(right, bg="#f4f5f7", highlightthickness=0)
+        prop_scroll = tk.Scrollbar(right, orient=tk.VERTICAL, command=self.prop_canvas.yview)
+        self.prop_frame = tk.Frame(self.prop_canvas, bg="#f4f5f7")
+        self.prop_canvas.configure(yscrollcommand=prop_scroll.set)
+        prop_scroll.pack(side=tk.RIGHT, fill=tk.Y)
+        self.prop_canvas.pack(fill=tk.BOTH, expand=True)
+        self.prop_canvas.create_window((0, 0), window=self.prop_frame, anchor="nw")
+        self.prop_frame.bind("<Configure>",
+                             lambda e: self.prop_canvas.configure(scrollregion=self.prop_canvas.bbox("all")))
+
+    def _build_statusbar(self):
+        self.status = tk.Label(self.root, text="就绪", anchor="w", fg="#444444",
+                               font=("Helvetica", 9), bd=1, relief=tk.SUNKEN)
+        self.status.pack(side=tk.BOTTOM, fill=tk.X)
+
+    def _set_status(self, text):
+        self.status.config(text=text)
+
+    # ---------------------------------------------------------- 项目操作
+    def new_project(self):
+        self.project = pyu.new_project("未命名项目")
+        self.current_path = None
+        self.selection = None
+        self.pending_part = None
+        self._photos.clear()
+        self.redraw_all()
+        self._refresh_objects_list()
+        self._clear_props()
+        self._set_status("已新建项目")
+
+    def open_project(self):
+        path = filedialog.askopenfilename(
+            title="打开 tkunity 项目", defaultextension=".pyu",
+            filetypes=[("tkunity 项目", "*.pyu"), ("所有文件", "*.*")])
+        if path:
+            self.open_path(path)
+
+    def open_path(self, path):
+        try:
+            self.project = pyu.load(path)
+        except Exception as exc:
+            messagebox.showerror("打开失败", "无法读取 %s\n%s" % (path, exc))
+            return
+        self.current_path = path
+        self.selection = None
+        self.pending_part = None
+        self._photos.clear()
+        self.redraw_all()
+        self._refresh_objects_list()
+        self._clear_props()
+        self._set_status("已打开: %s" % path)
+
+    def save_project(self):
+        if self.current_path:
+            self._write_pyu(self.current_path)
+        else:
+            self.save_project_as()
+
+    def save_project_as(self):
+        path = filedialog.asksaveasfilename(
+            title="保存 tkunity 项目", defaultextension=".pyu",
+            initialfile=self.project["meta"].get("name", "game") + ".pyu",
+            filetypes=[("tkunity 项目", "*.pyu"), ("所有文件", "*.*")])
+        if path:
+            self._write_pyu(path)
+
+    def _write_pyu(self, path):
+        try:
+            pyu.save(self.project, path)
+        except Exception as exc:
+            messagebox.showerror("保存失败", str(exc))
+            return
+        self.current_path = path
+        self._set_status("已保存: %s" % path)
+
+    def preview(self):
+        win = tk.Toplevel(self.root)
+        win.title("预览 - %s" % self.project["meta"].get("name", "游戏"))
+        from .runtime import Scene
+        try:
+            scene = Scene(win, self.project)
+        except Exception as exc:
+            messagebox.showerror("预览失败", str(exc))
+            win.destroy()
+            return
+        scene.canvas.pack(fill="both", expand=True)
+        scene.start()
+        tk.Button(win, text="关闭预览", command=lambda: (scene.stop(), win.destroy())).pack()
+        win.protocol("WM_DELETE_WINDOW", lambda: (scene.stop(), win.destroy()))
+
+    def export_apk(self):
+        outdir = filedialog.askdirectory(title="选择导出目录（将生成 Android 工程）")
+        if not outdir:
+            return
+        target = os.path.join(outdir, "android_" + self.project["meta"].get("name", "game"))
+        try:
+            files = export.build(self.project, target)
+        except Exception as exc:
+            messagebox.showerror("导出失败", str(exc))
+            return
+        messagebox.showinfo("导出成功",
+                            "已生成 %d 个文件到:\n%s\n\n"
+                            "下一步：设置 ANDROID_HOME 后运行 build_apk.bat / build_apk.sh" % (len(files), target))
+        self._set_status("已导出 Android 工程: %s" % target)
+
+    def about(self):
+        messagebox.showinfo(
+            "关于 tkunity",
+            "tkunity v%s\n%s\n\n"
+            "Apache License 2.0\n"
+            "Copyright 2026 %s <%s>\n\n"
+            "纯 Python 标准库实现（无 pygame / 无任何第三方依赖）\n"
+            "支持把 .pyu 游戏导出为 Android APK 工程" %
+            (__version__, "Unity 风格 2D 游戏编辑器与运行时", __author__, __author_email__))
+
+    def _quit(self):
+        self.root.destroy()
+
+    # ---------------------------------------------------------- 画布渲染
+    @property
+    def scene_w(self):
+        return int(self.project["meta"].get("scene_width", 960))
+
+    @property
+    def scene_h(self):
+        return int(self.project["meta"].get("scene_height", 640))
+
+    def redraw_all(self):
+        self.canvas.delete("all")
+        self._item_ids.clear()
+        self.canvas.configure(scrollregion=(0, 0, self.scene_w, self.scene_h))
+        self.canvas.create_rectangle(0, 0, self.scene_w, self.scene_h,
+                                     fill=self.project["meta"].get("background", "#1e1e2e"),
+                                     outline="#888888", width=1, tags=("scene",))
+        self._draw_grid()
+        entities = sorted(self.project["entities"], key=lambda e: self._layer_of(e))
+        for entity in entities:
+            self._draw_entity(entity)
+        self._draw_selection()
+
+    def _layer_of(self, entity):
+        return entity.get("components", {}).get("Transform", {}).get("layer", 0)
+
+    def _draw_grid(self):
+        for x in range(0, self.scene_w + 1, GRID):
+            self.canvas.create_line(x, 0, x, self.scene_h, fill="#3a3a3a",
+                                    tags=("grid",))
+        for y in range(0, self.scene_h + 1, GRID):
+            self.canvas.create_line(0, y, self.scene_w, y, fill="#3a3a3a",
+                                    tags=("grid",))
+
+    def _draw_entity(self, entity):
+        eid = entity["id"]
+        comps = entity.get("components", {})
+        t = comps.get("Transform", {})
+        x, y = int(t.get("x", 0)), int(t.get("y", 0))
+        w, h = int(t.get("width", 80)), int(t.get("height", 60))
+        ids = []
+        sprite = comps.get("Sprite", {})
+        shape = sprite.get("shape", "rect")
+        fill = sprite.get("fill", "")
+        outline = sprite.get("outline", "")
+
+        if shape == "image":
+            photo = self._get_photo(sprite.get("image", ""))
+            if photo:
+                ids.append(self.canvas.create_image(x + w // 2, y + h // 2,
+                                                    image=photo, tags=("ent%d" % eid,)))
+        elif shape == "oval":
+            ids.append(self.canvas.create_oval(x, y, x + w, y + h, fill=fill,
+                                               outline=outline, width=2, tags=("ent%d" % eid,)))
+        else:
+            ids.append(self.canvas.create_rectangle(x, y, x + w, y + h, fill=fill,
+                                                    outline=outline, width=2, tags=("ent%d" % eid,)))
+        label = comps.get("Label")
+        if label and label.get("text"):
+            font = ("Helvetica", int(label.get("font_size", 18)),
+                    "bold" if label.get("bold") else "normal")
+            ids.append(self.canvas.create_text(x + w // 2, y + h // 2,
+                                               text=label.get("text", ""), font=font,
+                                               fill=label.get("color", "#000000"),
+                                               tags=("ent%d" % eid,)))
+        # 物体名小标签（左上角）
+        ids.append(self.canvas.create_text(x + 2, y - 2, text=entity.get("name", ""),
+                                           anchor="sw", font=("Helvetica", 8),
+                                           fill="#e8e8e8", tags=("ent%d" % eid,)))
+        self._item_ids[eid] = ids
+
+    def _get_photo(self, asset_name):
+        if not asset_name:
+            return None
+        if asset_name in self._photos:
+            return self._photos[asset_name]
+        b64 = self.project.get("assets", {}).get(asset_name)
+        if not b64:
+            return None
+        try:
+            photo = tk.PhotoImage(data=b64)
+        except Exception:
+            return None
+        self._photos[asset_name] = photo
+        return photo
+
+    def _draw_selection(self):
+        self.canvas.delete("sel")
+        if self.selection is None:
+            return
+        entity = self._find(self.selection)
+        if entity is None:
+            return
+        t = entity.get("components", {}).get("Transform", {})
+        x, y = int(t.get("x", 0)), int(t.get("y", 0))
+        w, h = int(t.get("width", 80)), int(t.get("height", 60))
+        self.canvas.create_rectangle(x - 3, y - 3, x + w + 3, y + h + 3,
+                                     outline="#00c853", width=2, tags=("sel",))
+        # 右下角缩放把手
+        self.canvas.create_rectangle(x + w - 6, y + h - 6, x + w + 4, y + h + 4,
+                                     fill="#00c853", outline="#00c853", tags=("sel",))
+
+    def redraw_entity(self, entity):
+        eid = entity["id"]
+        for iid in self._item_ids.get(eid, []):
+            try:
+                self.canvas.delete(iid)
+            except Exception:
+                pass
+        self._item_ids[eid] = []
+        self._draw_entity(entity)
+        self._draw_selection()
+
+    # ---------------------------------------------------------- 交互
+    def _on_parts_select(self, event):
+        sel = self.parts_list.curselection()
+        self.pending_part = PARTS[sel[0]][0] if sel else None
+        if self.pending_part:
+            self._set_status("请点击画布放置「%s」（点已选中物体则为其添加组件）" % self.pending_part)
+
+    def _on_parts_double(self, event):
+        idx = self.parts_list.nearest(event.y)
+        if idx is None or idx < 0:
+            return
+        name = PARTS[idx][0]
+        self._place_part(name, self.scene_w // 2 - PART_SIZES[name][0] // 2,
+                         self.scene_h // 2 - PART_SIZES[name][1] // 2)
+
+    def _place_part(self, part_name, x, y):
+        comps = dict(PARTS[[p[0] for p in PARTS].index(part_name)][1])
+        if part_name in ("点击触发器", "定时器"):
+            if self.selection is not None and self._find(self.selection) is not None:
+                comp_key = "TapHandler" if part_name == "点击触发器" else "Timer"
+                entity = self._find(self.selection)
+                if comp_key not in entity["components"]:
+                    from .components import new_component
+                    entity["components"][comp_key] = new_component(comp_key)
+                    self.redraw_entity(entity)
+                    self._refresh_props()
+                self.pending_part = None
+                self._set_status("已为「%s」添加%s" % (entity.get("name"), comp_key))
+                return
+        size = PART_SIZES[part_name]
+        count = sum(1 for e in self.project["entities"] if e.get("name", "").startswith(part_name))
+        entity = pyu.add_entity(self.project, name="%s%d" % (part_name, count + 1),
+                                components=comps, transform={"x": x, "y": y,
+                                                             "width": size[0], "height": size[1]})
+        self._draw_entity(entity)
+        self._refresh_objects_list()
+        self.select(entity["id"])
+        self.pending_part = None
+        self._set_status("已放置「%s」" % entity["name"])
+
+    def _on_canvas_press(self, event):
+        x, y = self.canvas.canvasx(event.x), self.canvas.canvasy(event.y)
+        if self.pending_part:
+            sx = int(x // GRID) * GRID
+            sy = int(y // GRID) * GRID
+            self._place_part(self.pending_part, sx, sy)
+            return
+        eid = self._hit_test(x, y)
+        if eid is None:
+            self.select(None)
+            return
+        self.select(eid)
+        entity = self._find(eid)
+        t = entity["components"]["Transform"]
+        # 缩放把手命中？
+        if abs(x - (t["x"] + t["width"])) < 12 and abs(y - (t["y"] + t["height"])) < 12:
+            self._drag = {"eid": eid, "mode": "resize",
+                          "ox": t["width"], "oy": t["height"], "sx": x, "sy": y}
+        else:
+            self._drag = {"eid": eid, "mode": "move",
+                          "ox": t["x"], "oy": t["y"], "sx": x, "sy": y}
+
+    def _on_canvas_drag(self, event):
+        if not self._drag:
+            return
+        x, y = self.canvas.canvasx(event.x), self.canvas.canvasy(event.y)
+        d = self._drag
+        entity = self._find(d["eid"])
+        if entity is None:
+            self._drag = None
+            return
+        t = entity["components"]["Transform"]
+        if d["mode"] == "move":
+            nx = d["ox"] + (x - d["sx"])
+            ny = d["oy"] + (y - d["sy"])
+            nx = int(round(nx / GRID) * GRID)
+            ny = int(round(ny / GRID) * GRID)
+            t["x"], t["y"] = nx, ny
+        else:
+            nw = max(8, d["ox"] + (x - d["sx"]))
+            nh = max(8, d["oy"] + (y - d["sy"]))
+            t["width"], t["height"] = int(round(nw / GRID) * GRID) or 8, int(round(nh / GRID) * GRID) or 8
+        self.redraw_entity(entity)
+        self._refresh_props()
+
+    def _on_canvas_release(self, event):
+        self._drag = None
+
+    def _hit_test(self, x, y):
+        entities = sorted(self.project["entities"], key=self._layer_of, reverse=True)
+        for entity in entities:
+            t = entity.get("components", {}).get("Transform", {})
+            if (t.get("x", 0) <= x <= t.get("x", 0) + t.get("width", 0) and
+                    t.get("y", 0) <= y <= t.get("y", 0) + t.get("height", 0)):
+                return entity["id"]
+        return None
+
+    def _find(self, eid):
+        for entity in self.project["entities"]:
+            if entity["id"] == eid:
+                return entity
+        return None
+
+    def select(self, eid):
+        self.selection = eid
+        self._draw_selection()
+        self._refresh_props()
+        self._sync_objects_list()
+
+    def delete_selection(self):
+        if self.selection is None:
+            return
+        entity = self._find(self.selection)
+        if entity is None:
+            self.selection = None
+            return
+        self.project["entities"].remove(entity)
+        for iid in self._item_ids.pop(entity["id"], []):
+            try:
+                self.canvas.delete(iid)
+            except Exception:
+                pass
+        self._photos.pop(entity.get("components", {}).get("Sprite", {}).get("image", ""), None)
+        self.selection = None
+        self._refresh_objects_list()
+        self._clear_props()
+        self._set_status("已删除「%s」" % entity["name"])
+
+    def duplicate_selection(self):
+        if self.selection is None:
+            return
+        src = self._find(self.selection)
+        if src is None:
+            return
+        import copy
+        comps = copy.deepcopy(src["components"])
+        t = comps["Transform"]
+        t["x"] = t.get("x", 0) + GRID
+        t["y"] = t.get("y", 0) + GRID
+        entity = pyu.add_entity(self.project, name=src["name"] + "_副本", components=comps)
+        self._draw_entity(entity)
+        self._refresh_objects_list()
+        self.select(entity["id"])
+        self._set_status("已复制「%s」" % src["name"])
+
+    # ---------------------------------------------------------- 列表同步
+    def _refresh_objects_list(self):
+        self.objects_list.delete(0, tk.END)
+        for entity in sorted(self.project["entities"], key=lambda e: e["id"]):
+            self.objects_list.insert(tk.END, "%s" % entity.get("name", "?"))
+        self._sync_objects_list()
+
+    def _sync_objects_list(self):
+        for i, entity in enumerate(sorted(self.project["entities"], key=lambda e: e["id"])):
+            if entity["id"] == self.selection:
+                self.objects_list.selection_clear(0, tk.END)
+                self.objects_list.selection_set(i)
+                self.objects_list.see(i)
+                return
+
+    def _on_objects_select(self, event):
+        sel = self.objects_list.curselection()
+        if not sel:
+            return
+        entities = sorted(self.project["entities"], key=lambda e: e["id"])
+        self.select(entities[sel[0]]["id"])
+
+    # ---------------------------------------------------------- 属性面板
+    def _clear_props(self):
+        for w in self._prop_widgets:
+            try:
+                w.destroy()
+            except Exception:
+                pass
+        self._prop_widgets = []
+        self._prop_vars = {}
+
+    def _refresh_props(self):
+        self._clear_props()
+        entity = self._find(self.selection) if self.selection is not None else None
+        if entity is None:
+            tk.Label(self.prop_frame, text="未选中物体", bg="#f4f5f7", fg="#888888").pack(anchor="w", pady=6)
+            return
+
+        f = self.prop_frame
+
+        def section(text):
+            tk.Label(f, text=text, bg="#dfe3ea", fg="#222222", anchor="w",
+                     font=("Helvetica", 10, "bold")).pack(fill=tk.X, pady=(6, 2))
+
+        def row(key, label, var, widget_builder, field_spec):
+            line = tk.Frame(f, bg="#f4f5f7")
+            line.pack(fill=tk.X, pady=1)
+            tk.Label(line, text=label, bg="#f4f5f7", width=12, anchor="w",
+                     font=("Helvetica", 9)).pack(side=tk.LEFT)
+            widget_builder(line, var, field_spec)
+            self._prop_widgets.append(line)
+
+        # 基本信息
+        section("物体")
+        name_var = tk.StringVar(value=entity.get("name", ""))
+        self._prop_vars[("name", None)] = name_var
+        row("name", "名称", name_var,
+            lambda l, v, s: tk.Entry(l, textvariable=v, width=14).pack(side=tk.LEFT), None)
+
+        for comp_name in ["Transform"] + [c for c in ADDABLE_COMPONENTS if c in entity["components"]]:
+            section(comp_name)
+            schema = COMPONENT_SCHEMAS[comp_name]["fields"]
+            comp = entity["components"][comp_name]
+            for key, spec in schema.items():
+                value = comp.get(key, spec.get("default"))
+                var = tk.StringVar()
+                if isinstance(value, bool):
+                    var.set("1" if value else "0")
+                else:
+                    var.set(str(value))
+                self._prop_vars[(comp_name, key)] = var
+
+                if spec["type"] in ("int", "float", "text"):
+                    if spec.get("multiline"):
+                        line = tk.Frame(f, bg="#f4f5f7")
+                        line.pack(fill=tk.X, pady=1)
+                        tk.Label(line, text=spec.get("hint", key), bg="#f4f5f7", width=12,
+                                 anchor="w", font=("Helvetica", 9)).pack(side=tk.LEFT, anchor="n")
+                        txt = tk.Text(line, height=3, width=20, font=("Helvetica", 9))
+                        txt.insert("1.0", str(value))
+                        txt.pack(side=tk.LEFT)
+                        self._prop_widgets.append(line)
+                        self._prop_vars[(comp_name, key)] = txt  # Text 对象直接存
+                    else:
+                        row((comp_name, key), spec.get("hint", key), var,
+                            lambda l, v, s: tk.Entry(l, textvariable=v, width=14).pack(side=tk.LEFT), spec)
+                elif spec["type"] == "choice":
+                    row((comp_name, key), spec.get("hint", key), var,
+                        lambda l, v, s: tk.OptionMenu(l, v, *s["options"]).pack(side=tk.LEFT), spec)
+                elif spec["type"] == "bool":
+                    def mk_check(l, v, s):
+                        cv = tk.BooleanVar(value=(v.get() == "1"))
+                        tk.Checkbutton(l, variable=cv, command=lambda: v.set("1" if cv.get() else "0"),
+                                       bg="#f4f5f7").pack(side=tk.LEFT)
+                    row((comp_name, key), spec.get("hint", key), var, mk_check, spec)
+                elif spec["type"] == "color":
+                    def mk_color(l, v, s):
+                        def pick():
+                            _, hexcolor = colorchooser.askcolor(color=v.get() or s["default"])
+                            if hexcolor:
+                                v.set(hexcolor)
+                                swatch.config(bg=hexcolor)
+                        swatch = tk.Button(l, text=v.get() or s["default"], command=pick,
+                                           bg=v.get() or s["default"], width=8, relief=tk.GROOVE)
+                        swatch.pack(side=tk.LEFT)
+                    row((comp_name, key), spec.get("hint", key), var, mk_color, spec)
+                elif spec["type"] == "file":
+                    def mk_file(l, v, s):
+                        def browse():
+                            path = filedialog.askopenfilename(
+                                title="选择图片 (PNG/GIF)",
+                                filetypes=[("图片", "*.png *.gif"), ("所有文件", "*.*")])
+                            if path:
+                                try:
+                                    asset = pyu.embed_image(self.project, path)
+                                except Exception as exc:
+                                    messagebox.showerror("图片", str(exc))
+                                    return
+                                v.set(asset)
+                                ent = self._find(self.selection)
+                                ent["components"]["Sprite"]["image"] = asset
+                                self.redraw_entity(ent)
+                        tk.Entry(l, textvariable=v, width=14).pack(side=tk.LEFT)
+                        tk.Button(l, text="浏览", command=browse, font=("Helvetica", 8)).pack(side=tk.LEFT)
+                    row((comp_name, key), spec.get("hint", key), var, mk_file, spec)
+
+        # 操作按钮
+        section("操作")
+        ops = tk.Frame(f, bg="#f4f5f7")
+        ops.pack(fill=tk.X, pady=4)
+        tk.Button(ops, text="应用", command=self.apply_props, bg="#00c853", fg="white",
+                  font=("Helvetica", 10, "bold")).pack(side=tk.LEFT, padx=2)
+        tk.Button(ops, text="复制", command=self.duplicate_selection).pack(side=tk.LEFT, padx=2)
+        tk.Button(ops, text="删除", command=self.delete_selection, fg="#d32f2f").pack(side=tk.LEFT, padx=2)
+
+        add_row = tk.Frame(f, bg="#f4f5f7")
+        add_row.pack(fill=tk.X, pady=(8, 2))
+        add_var = tk.StringVar(value=ADDABLE_COMPONENTS[0])
+        tk.OptionMenu(add_row, add_var, *ADDABLE_COMPONENTS).pack(side=tk.LEFT)
+        tk.Button(add_row, text="添加组件", command=lambda: self.add_component(add_var.get())).pack(side=tk.LEFT, padx=4)
+        self._prop_vars["_add"] = add_var
+
+    def add_component(self, comp_name):
+        entity = self._find(self.selection)
+        if entity is None or comp_name in entity["components"]:
+            return
+        from .components import new_component
+        entity["components"][comp_name] = new_component(comp_name)
+        self.redraw_entity(entity)
+        self._refresh_props()
+        self._set_status("已添加 %s" % comp_name)
+
+    def remove_component(self, comp_name):
+        entity = self._find(self.selection)
+        if entity is None or comp_name == "Transform":
+            return
+        if comp_name in entity["components"]:
+            del entity["components"][comp_name]
+            self.redraw_entity(entity)
+            self._refresh_props()
+
+    def apply_props(self):
+        entity = self._find(self.selection)
+        if entity is None:
+            return
+        from .components import validate_component
+        # 名称
+        if ("name", None) in self._prop_vars:
+            entity["name"] = self._prop_vars[("name", None)].get() or "未命名"
+        changed = False
+        for key_item, var in self._prop_vars.items():
+            if not isinstance(key_item, tuple) or len(key_item) != 2:
+                continue
+            comp_name, key = key_item
+            comp = entity["components"].get(comp_name)
+            if comp is None:
+                continue
+            schema = COMPONENT_SCHEMAS[comp_name]["fields"][key]
+            if schema["type"] == "bool":
+                comp[key] = (var.get() == "1")
+                changed = True
+            elif schema["type"] in ("int", "float"):
+                ok, fixed, err = validate_component(comp_name, {key: var.get()})
+                if ok:
+                    comp[key] = fixed[key]
+                    changed = True
+                else:
+                    messagebox.showerror("属性错误", err)
+                    return
+            elif isinstance(var, tk.Text):
+                comp[key] = var.get("1.0", "end").rstrip("\n")
+                changed = True
+            else:
+                comp[key] = var.get()
+                changed = True
+        if changed:
+            self.redraw_entity(entity)
+            self._refresh_objects_list()
+        self._set_status("已应用属性")
+
+
+def launch_editor(file=None):
+    """启动编辑器（GUI）。"""
+    root = tk.Tk()
+    EditorApp(root, file)
+    root.mainloop()