jvlib 0.0.1__tar.gz

jvlib-0.0.1/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: jvlib
+Version: 0.0.1
+Summary: AI-native browser automation toolkit: screenshot, PDF, element interaction
+Requires-Python: >=3.12
+Requires-Dist: playwright>=1.40.0
+Requires-Dist: typer>=0.26.3

jvlib-0.0.1/pyproject.toml

@@ -0,0 +1,24 @@
+[project]
+name = "jvlib"
+version = "0.0.1"
+description = "AI-native browser automation toolkit: screenshot, PDF, element interaction"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "typer>=0.26.3",
+    "playwright>=1.40.0",
+]
+
+[project.scripts]
+jvlib = "jvlib.cli:app"
+
+[pypi]
+username = "__token__"
+password = "pypi-AgEIcHlwaS5vcmcCJDNhZjhhZjhmLWYyOWUtNGRlYi1hNGQ5LTA2OTgwMzkwZTNmMwACKlszLCI0ZmFhNTgzYS04YjViLTQ4NTctOWU3ZC03NDk5OGQ3MDc4NDEiXQAABiASR65E2MG5ZZ7zSEP7WVZovZ5L7v-UGr8F1X2uo-Y0BA"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/jvlib"]

jvlib-0.0.1/src/jvlib/cli.py

@@ -0,0 +1,18 @@
+"""jv-ai CLI entry point."""
+
+import typer
+
+from jvlib.commands.web import web_app
+
+app = typer.Typer(help="jv-ai: AI-native browser automation toolkit")
+
+
+@app.callback()
+def main():
+    pass
+
+
+app.add_typer(web_app)
+
+if __name__ == "__main__":
+    app()

jvlib-0.0.1/src/jvlib/commands/web/__init__.py

@@ -0,0 +1,425 @@
+"""jv web 子命令：浏览器自动化工具."""
+
+import json
+from pathlib import Path
+
+import typer
+
+from jvlib.commands.web import client, utils
+from jvlib.commands.web.session import clear_session, get_session, set_session
+
+web_app = typer.Typer(name="web", help="浏览器自动化（WebBridge）")
+
+
+@web_app.callback()
+def web_main():
+    pass
+
+
+@web_app.command(name="status")
+def web_status():
+    """检查 WebBridge daemon 和扩展状态."""
+    st = client.check_status()
+    running = st.get("running", False)
+    connected = st.get("extension_connected", False)
+
+    if running and connected:
+        typer.echo(f"[OK] WebBridge 就绪")
+        typer.echo(f"  version: {st.get('version', 'unknown')}")
+        typer.echo(f"  extension: {st.get('extension_version', 'unknown')}")
+        typer.echo(f"  port: {st.get('port', 10086)}")
+        typer.echo(f"  session: {get_session()}")
+    elif running and not connected:
+        typer.echo("[WARN] Daemon 运行中，但浏览器扩展未连接")
+        typer.echo("  请检查浏览器扩展是否已启用并刷新页面")
+    else:
+        typer.echo("[ERR] WebBridge 未运行")
+        typer.echo("  请运行: ~/.kimi-webbridge/bin/kimi-webbridge start")
+        raise typer.Exit(1)
+
+
+@web_app.command(name="open")
+def web_open(
+    url: str = typer.Argument(..., help="要打开的 URL"),
+    name: str = typer.Option(None, "--name", "-n", help="自定义 session 名称（默认 jv-web）"),
+):
+    """新标签页打开网页."""
+    if name:
+        set_session(name)
+    resp = client.navigate(url, new_tab=True, group_title="jv web")
+    data = resp.get("data", {})
+    if data.get("success"):
+        typer.echo(f"[OK] 已打开: {data.get('url')}")
+        typer.echo(f"  tabId: {data.get('tabId')}")
+        typer.echo(f"  session: {get_session()}")
+    else:
+        typer.echo(f"[ERR] 打开失败: {utils.fmt_json(data)}", err=True)
+        raise typer.Exit(1)
+
+
+@web_app.command(name="nav")
+def web_nav(
+    url: str = typer.Argument(..., help="要导航到的 URL"),
+):
+    """当前标签页导航到指定 URL."""
+    resp = client.navigate(url, new_tab=False)
+    data = resp.get("data", {})
+    if data.get("success"):
+        typer.echo(f"[OK] 已导航: {data.get('url')}")
+    else:
+        typer.echo(f"[ERR] 导航失败: {utils.fmt_json(data)}", err=True)
+        raise typer.Exit(1)
+
+
+@web_app.command(name="snap")
+def web_snap(
+    raw: bool = typer.Option(False, "--raw", "-r", help="输出原始 JSON"),
+):
+    """获取当前页面结构快照（accessibility tree）."""
+    resp = client.snapshot()
+    data = resp.get("data", {})
+    url = data.get("url", "")
+    title = data.get("title", "")
+    tree = data.get("tree", "")
+
+    if raw:
+        typer.echo(utils.fmt_json(data))
+        return
+
+    typer.echo(f"URL: {url}")
+    typer.echo(f"Title: {title}")
+    if tree:
+        # tree 可能非常长，截断显示
+        tree_str = str(tree)
+        if len(tree_str) > 3000:
+            typer.echo(f"Tree: {tree_str[:3000]}... [truncated, {len(tree_str)} chars total]")
+        else:
+            typer.echo(f"Tree: {tree_str}")
+
+
+@web_app.command(name="click")
+def web_click(
+    selector: str = typer.Argument(..., help="CSS 选择器或 @e 引用"),
+):
+    """点击页面元素."""
+    resp = client.click(selector)
+    data = resp.get("data", {})
+    if data.get("success"):
+        typer.echo(f"[OK] 已点击: <{data.get('tag', 'unknown')}>")
+    else:
+        typer.echo(f"[ERR] 点击失败: {utils.fmt_json(data)}", err=True)
+        raise typer.Exit(1)
+
+
+@web_app.command(name="fill")
+def web_fill(
+    selector: str = typer.Argument(..., help="CSS 选择器或 @e 引用"),
+    text: str = typer.Argument(..., help="要填入的文本"),
+):
+    """在输入框/文本域填入内容."""
+    resp = client.fill(selector, text)
+    data = resp.get("data", {})
+    if data.get("success"):
+        typer.echo(f"[OK] 已填充: mode={data.get('mode', 'unknown')}")
+        return
+
+    # 失败时诊断原因
+    err_detail = _diagnose_selector(selector)
+    typer.echo(f"[ERR] 填充失败: {err_detail}", err=True)
+    raise typer.Exit(1)
+
+
+def _diagnose_selector(selector: str) -> str:
+    """诊断 selector 失败原因，返回具体错误信息."""
+    import json
+
+    # 1. 检查是否是 @e ref（WebBridge fill 对 @e 支持不稳定）
+    if selector.startswith("@e"):
+        # 尝试用 snapshot 看看这个 ref 是否存在
+        resp = client.snapshot()
+        snap_data = resp.get("data", {})
+        tree_str = str(snap_data.get("tree", ""))
+        if selector in tree_str:
+            return f"ref {selector} 存在于页面快照中，但 fill API 可能不支持 @e 引用。建议用 CSS 选择器替代，如: jv web eval \"document.querySelector('input').id\" 获取真实 id"
+        return f"ref {selector} 在当前页面快照中未找到"
+
+    # 2. 用 evaluate 探测元素
+    code = f"(()=>{{ const el=document.querySelector('{selector}'); if(!el) return 'not_found'; const tag=el.tagName.toLowerCase(); const editable=el.tagName==='INPUT'||el.tagName==='TEXTAREA'||el.isContentEditable; return {{tag, editable, type: el.type||null, id: el.id||null}}; }})()"
+    try:
+        resp = client.evaluate(code)
+        data = resp.get("data", {})
+        value = data.get("value")
+        if value == "not_found":
+            return f"元素未找到: {selector}"
+        if isinstance(value, dict):
+            if not value.get("editable"):
+                return f"元素存在但不可编辑: <{value.get('tag')}> (id={value.get('id')}, type={value.get('type')})"
+            return f"元素可编辑但 fill 失败: <{value.get('tag')}> (id={value.get('id')}, type={value.get('type')})"
+    except Exception:
+        pass
+
+    return f"未知错误，selector: {selector}"
+
+
+@web_app.command(name="eval")
+def web_eval(
+    code: str = typer.Argument(..., help="要执行的 JS 代码"),
+    raw: bool = typer.Option(False, "--raw", "-r", help="输出原始 JSON"),
+):
+    """在当前页面执行 JavaScript."""
+    resp = client.evaluate(code)
+    data = resp.get("data", {})
+    if raw:
+        typer.echo(utils.fmt_json(data))
+        return
+    typer.echo(f"type: {data.get('type', 'unknown')}")
+    value = data.get("value")
+    if isinstance(value, (dict, list)):
+        typer.echo(json.dumps(value, ensure_ascii=False, indent=2))
+    else:
+        typer.echo(f"value: {value}")
+
+
+@web_app.command(name="shot")
+def web_shot(
+    output: str = typer.Option(None, "--output", "-o", help="输出文件路径（默认桌面）"),
+    fmt: str = typer.Option("png", "--format", "-f", help="格式: png | jpeg"),
+    quality: int = typer.Option(None, "--quality", "-q", help="JPEG 质量 0-100"),
+    selector: str = typer.Option(None, "--selector", "-s", help="仅截取指定元素"),
+):
+    """截图并自动保存为文件（解决 base64 痛点）."""
+    from socket import timeout as SocketTimeout
+
+    try:
+        resp = client.screenshot(format_=fmt, quality=quality, selector=selector)
+    except SocketTimeout:
+        typer.echo("[ERR] 截图超时 (15s)", err=True)
+        typer.echo("  提示: 浏览器窗口可能在后台或被最小化，尝试将其切换到前台后重试", err=True)
+        typer.echo("   workaround: 使用 --selector 截取特定元素通常更稳定", err=True)
+        raise typer.Exit(1)
+
+    data = resp.get("data", {})
+
+    if "data" in data:
+        # base64 数据 → 自动解码保存
+        out_path = utils.pick_output_path(
+            Path(output) if output else None,
+            suffix=fmt,
+            default_name="screenshot",
+        )
+        utils.decode_base64_to_file(data["data"], out_path)
+        typer.echo(f"[OK] 截图已保存: {out_path}")
+        typer.echo(f"  size: {len(data['data'])} base64 chars")
+    elif "path" in data and data["path"]:
+        # daemon 已保存到路径
+        typer.echo(f"[OK] 截图已保存: {data['path']}")
+    else:
+        typer.echo(f"[ERR] 截图失败: {utils.fmt_json(data)}", err=True)
+        raise typer.Exit(1)
+
+
+@web_app.command(name="pdf")
+def web_pdf(
+    output: str = typer.Option(None, "--output", "-o", help="输出文件路径（默认桌面）"),
+    paper: str = typer.Option("a4", "--paper", "-p", help="纸张格式: a4 | letter | legal | a3 | tabloid"),
+    landscape: bool = typer.Option(False, "--landscape", "-l", help="横向模式"),
+):
+    """将当前页面保存为 PDF（自动解码 base64）."""
+    from socket import timeout as SocketTimeout
+
+    try:
+        resp = client.save_pdf(paper_format=paper, landscape=landscape)
+    except SocketTimeout:
+        typer.echo("[ERR] PDF 导出超时 (15s)", err=True)
+        typer.echo("  提示: 浏览器窗口可能在后台或被最小化，尝试将其切换到前台后重试", err=True)
+        raise typer.Exit(1)
+
+    data = resp.get("data", {})
+
+    if "data" in data:
+        out_path = utils.pick_output_path(
+            Path(output) if output else None,
+            suffix="pdf",
+            default_name="page",
+        )
+        utils.decode_base64_to_file(data["data"], out_path)
+        typer.echo(f"[OK] PDF 已保存: {out_path}")
+        typer.echo(f"  title: {data.get('pageTitle', 'unknown')}")
+    elif "path" in data and data["path"]:
+        typer.echo(f"[OK] PDF 已保存: {data['path']}")
+    else:
+        typer.echo(f"[ERR] PDF 保存失败: {utils.fmt_json(data)}", err=True)
+        raise typer.Exit(1)
+
+
+@web_app.command(name="tabs")
+def web_tabs(
+    raw: bool = typer.Option(False, "--raw", "-r", help="输出原始 JSON"),
+):
+    """列出当前 session 的所有标签页."""
+    resp = client.list_tabs()
+    data = resp.get("data", {})
+    tabs = data.get("tabs", [])
+
+    if raw:
+        typer.echo(utils.fmt_json(data))
+        return
+
+    if not tabs:
+        typer.echo("[empty] 没有打开的标签页")
+        return
+
+    typer.echo(f"Session: {get_session()} | 共 {len(tabs)} 个标签页")
+    for i, t in enumerate(tabs, 1):
+        active = "*" if t.get("active") else " "
+        typer.echo(f"  [{active}] {i}. {t.get('title', 'untitled')[:40]} ({t.get('url', '')[:60]})")
+
+
+@web_app.command(name="close")
+def web_close(
+    others: bool = typer.Option(False, "--others", "-o", help="关闭其他标签页，只保留当前页"),
+):
+    """关闭当前标签页（或关闭其他标签页）."""
+    if others:
+        resp = client.list_tabs()
+        data = resp.get("data", {})
+        tabs = data.get("tabs", [])
+        if len(tabs) <= 1:
+            typer.echo("[OK] 只有 1 个标签页，无需关闭")
+            return
+        # 找 active tab，没有就保留第一个
+        current_idx = 0
+        for i, t in enumerate(tabs):
+            if t.get("active"):
+                current_idx = i
+                break
+        current = tabs[current_idx]
+        closed = 0
+        for i, t in enumerate(tabs):
+            if i != current_idx:
+                client.find_tab(t["url"])
+                client.close_tab()
+                closed += 1
+        # 切回保留的标签页
+        client.find_tab(current["url"])
+        typer.echo(f"[OK] 已关闭 {closed} 个其他标签页")
+        return
+
+    resp = client.close_tab()
+    data = resp.get("data", {})
+    if data.get("success"):
+        typer.echo("[OK] 标签页已关闭")
+    else:
+        typer.echo(f"[ERR] 关闭失败: {utils.fmt_json(data)}", err=True)
+        raise typer.Exit(1)
+
+
+@web_app.command(name="wait")
+def web_wait(
+    selector: str = typer.Argument(None, help="要等待的 CSS 选择器（与 --navigation 二选一）"),
+    navigation: bool = typer.Option(False, "--navigation", "-n", help="等待页面导航完成（URL 变化）"),
+    timeout: float = typer.Option(10.0, "--timeout", "-t", help="最长等待秒数"),
+    interval: float = typer.Option(0.5, "--interval", "-i", help="轮询间隔秒数"),
+):
+    """等待元素出现或页面导航完成（替代玄学 sleep）."""
+    import time
+
+    if not selector and not navigation:
+        typer.echo("[ERR] 请指定 selector 或 --navigation", err=True)
+        raise typer.Exit(1)
+
+    if selector:
+        # 等待元素出现
+        code = f"(()=>{{ return !!document.querySelector('{selector}'); }})()"
+        t0 = time.time()
+        while time.time() - t0 < timeout:
+            resp = client.evaluate(code)
+            data = resp.get("data", {})
+            if data.get("value"):
+                elapsed = time.time() - t0
+                typer.echo(f"[OK] 元素已出现: {selector} ({elapsed:.2f}s)")
+                return
+            time.sleep(interval)
+        typer.echo(f"[TIMEOUT] 元素未出现: {selector} ( waited {timeout}s )", err=True)
+        raise typer.Exit(1)
+
+    if navigation:
+        # 等待页面加载完成 (readyState === 'complete')
+        code = "document.readyState"
+        t0 = time.time()
+        while time.time() - t0 < timeout:
+            resp = client.evaluate(code)
+            data = resp.get("data", {})
+            if data.get("value") == "complete":
+                elapsed = time.time() - t0
+                typer.echo(f"[OK] 页面加载完成 ({elapsed:.2f}s)")
+                return
+            time.sleep(interval)
+        typer.echo(f"[TIMEOUT] 页面未加载完成 ( waited {timeout}s )", err=True)
+        raise typer.Exit(1)
+
+
+@web_app.command(name="scroll")
+def web_scroll(
+    pixels: int = typer.Argument(..., help="滚动的像素数（正数向下，负数向上）"),
+):
+    """滚动页面指定像素."""
+    resp = client.evaluate(f"window.scrollBy(0, {pixels})")
+    data = resp.get("data", {})
+    if data.get("type") == "undefined":
+        direction = "向下" if pixels > 0 else "向上"
+        typer.echo(f"[OK] 已{direction}滚动 {abs(pixels)}px")
+    else:
+        typer.echo(f"[ERR] 滚动失败: {utils.fmt_json(data)}", err=True)
+        raise typer.Exit(1)
+
+
+@web_app.command(name="scroll-to")
+def web_scroll_to(
+    selector: str = typer.Argument(..., help="要滚动到的元素 CSS 选择器（不支持 @e ref，可用 click 替代）"),
+):
+    """滚动到指定元素位置（仅支持 CSS 选择器）."""
+    if selector.startswith("@e"):
+        typer.echo("[ERR] scroll-to 不支持 @e 引用，建议先用 'jv web click @eN' 点击元素（会自动滚动到视口）", err=True)
+        raise typer.Exit(1)
+    code = f"(()=>{{ const el=document.querySelector('{selector}'); if(el){{ el.scrollIntoView({{behavior:'smooth',block:'center'}}); return true; }} return false; }})()"
+    resp = client.evaluate(code)
+    data = resp.get("data", {})
+    if data.get("value"):
+        typer.echo(f"[OK] 已滚动到: {selector}")
+    else:
+        typer.echo(f"[ERR] 元素未找到: {selector}", err=True)
+        raise typer.Exit(1)
+
+
+@web_app.command(name="switch")
+def web_switch(
+    url: str = typer.Argument(..., help="要切换到的标签页 URL（完整或部分匹配）"),
+):
+    """切换到已打开的标签页."""
+    resp = client.find_tab(url)
+    data = resp.get("data", {})
+    if data.get("success"):
+        typer.echo(f"[OK] 已切换: {data.get('url', '')}")
+    else:
+        typer.echo(f"[ERR] 未找到标签页: {url}", err=True)
+        raise typer.Exit(1)
+
+
+@web_app.command(name="reset")
+def web_reset(
+    yes: bool = typer.Option(False, "--yes", "-y", help="跳过确认"),
+):
+    """关闭整个 session 的所有标签页并清除 session."""
+    if not yes:
+        confirm = typer.confirm(f"确定关闭 session '{get_session()}' 的所有标签页？")
+        if not confirm:
+            typer.echo("[cancel] 已取消")
+            raise typer.Exit(0)
+
+    resp = client.close_session()
+    data = resp.get("data", {})
+    closed = data.get("closed", 0)
+    typer.echo(f"[OK] 已关闭 {closed} 个标签页")
+    clear_session()
+    typer.echo("[OK] session 已重置")

jvlib-0.0.1/src/jvlib/commands/web/client.py

@@ -0,0 +1,110 @@
+"""jv web WebBridge HTTP 客户端 — 纯 Python，无 curl 依赖."""
+
+import json
+import subprocess
+from typing import Any
+from urllib.request import Request, urlopen
+from urllib.error import URLError
+
+import typer
+
+from jvlib.commands.web.session import get_session
+
+_DAEMON_URL = "http://127.0.0.1:10086/command"
+
+
+def _request(payload: dict, timeout: float = 30) -> dict:
+    """发送 HTTP 请求到 WebBridge daemon（纯 Python urllib）."""
+    from socket import timeout as SocketTimeout
+
+    payload["session"] = get_session()
+    data = json.dumps(payload, ensure_ascii=False).encode("utf-8")
+    req = Request(
+        _DAEMON_URL,
+        data=data,
+        headers={"Content-Type": "application/json"},
+        method="POST",
+    )
+    try:
+        with urlopen(req, timeout=timeout) as resp:
+            return json.loads(resp.read().decode("utf-8"))
+    except SocketTimeout:
+        typer.echo("[ERR] 请求超时，WebBridge 响应过慢", err=True)
+        raise typer.Exit(1)
+    except URLError as e:
+        typer.echo(f"[ERR] 连接 WebBridge 失败: {e}", err=True)
+        raise typer.Exit(1)
+    except json.JSONDecodeError as e:
+        typer.echo(f"[ERR] JSON 解析失败: {e}", err=True)
+        raise typer.Exit(1)
+
+
+def check_status() -> dict:
+    """检查 WebBridge 状态（通过 CLI 工具）."""
+    import os
+    bin_path = os.path.expanduser("~/.kimi-webbridge/bin/kimi-webbridge")
+    result = subprocess.run(
+        [bin_path, "status"],
+        capture_output=True,
+        text=True,
+        encoding="utf-8",
+        errors="replace",
+    )
+    if result.returncode != 0:
+        return {"running": False, "error": result.stderr}
+    try:
+        return json.loads(result.stdout)
+    except json.JSONDecodeError:
+        return {"running": False, "error": result.stdout}
+
+
+def navigate(url: str, new_tab: bool = False, group_title: str | None = None) -> dict:
+    args = {"url": url, "newTab": new_tab}
+    if group_title:
+        args["group_title"] = group_title
+    return _request({"action": "navigate", "args": args})
+
+
+def find_tab(url: str, active: bool = False) -> dict:
+    return _request({"action": "find_tab", "args": {"url": url, "active": active}})
+
+
+def snapshot() -> dict:
+    return _request({"action": "snapshot", "args": {}})
+
+
+def click(selector: str) -> dict:
+    return _request({"action": "click", "args": {"selector": selector}})
+
+
+def fill(selector: str, value: str) -> dict:
+    return _request({"action": "fill", "args": {"selector": selector, "value": value}})
+
+
+def evaluate(code: str) -> dict:
+    return _request({"action": "evaluate", "args": {"code": code}})
+
+
+def screenshot(format_: str = "png", quality: int | None = None, selector: str | None = None) -> dict:
+    args: dict[str, Any] = {"format": format_}
+    if quality is not None:
+        args["quality"] = quality
+    if selector:
+        args["selector"] = selector
+    return _request({"action": "screenshot", "args": args}, timeout=15)
+
+
+def save_pdf(paper_format: str = "a4", landscape: bool = False) -> dict:
+    return _request({"action": "save_as_pdf", "args": {"paper_format": paper_format, "landscape": landscape}}, timeout=15)
+
+
+def list_tabs() -> dict:
+    return _request({"action": "list_tabs", "args": {}})
+
+
+def close_tab() -> dict:
+    return _request({"action": "close_tab", "args": {}})
+
+
+def close_session() -> dict:
+    return _request({"action": "close_session", "args": {}})

jvlib-0.0.1/src/jvlib/commands/web/session.py

@@ -0,0 +1,31 @@
+"""jv web session 管理."""
+
+from pathlib import Path
+
+_STATE_FILE = Path.home() / ".jv" / "web_session"
+
+
+def _ensure_dir() -> None:
+    _STATE_FILE.parent.mkdir(parents=True, exist_ok=True)
+
+
+def get_session() -> str:
+    """获取当前 session 名称（默认 jv-web）."""
+    _ensure_dir()
+    if _STATE_FILE.exists():
+        text = _STATE_FILE.read_text(encoding="utf-8").strip()
+        if text:
+            return text
+    return "jv-web"
+
+
+def set_session(name: str) -> None:
+    """设置当前 session 名称."""
+    _ensure_dir()
+    _STATE_FILE.write_text(name, encoding="utf-8")
+
+
+def clear_session() -> None:
+    """清除 session 状态."""
+    if _STATE_FILE.exists():
+        _STATE_FILE.unlink()

jvlib-0.0.1/src/jvlib/commands/web/utils.py

@@ -0,0 +1,28 @@
+"""jv web 工具函数."""
+
+import base64
+import json
+from pathlib import Path
+
+
+def decode_base64_to_file(data: str, path: Path) -> Path:
+    """解码 base64 数据并写入文件."""
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_bytes(base64.b64decode(data))
+    return path
+
+
+def fmt_json(data: dict) -> str:
+    """紧凑 JSON 字符串（避免换行膨胀）."""
+    return json.dumps(data, ensure_ascii=False, separators=(",", ":"))
+
+
+def pick_output_path(suggested: Path | None, suffix: str, default_name: str = "webbridge") -> Path:
+    """确定输出文件路径."""
+    if suggested:
+        return suggested
+    # 默认保存到桌面
+    desktop = Path.home() / "Desktop"
+    ts = __import__("time").time()
+    name = f"{default_name}_{int(ts)}.{suffix}"
+    return desktop / name