draftgo-cli 3.0.33 → 3.0.38

package/resources/skill/scripts/draftgo_delete.py

@@ -1,149 +0,0 @@
-#!/usr/bin/env python3
-"""
-DraftGo Delete Script
-删除云端资源，并同步移除本地 index.json 条目和文件。
-
-用法：
-  python draftgo_delete.py pages           <id>
-  python draftgo_delete.py nav             <id>
-  python draftgo_delete.py db_meta         <id>
-  python draftgo_delete.py custom_scripts  <id>
-  python draftgo_delete.py docs            <id>
-  python draftgo_delete.py doc_categories  <id>
-  python draftgo_delete.py aihub           <id>
-"""
-import json, sys
-from pathlib import Path
-import urllib.request, urllib.error
-
-SCRIPT_DIR = Path(__file__).resolve().parent
-
-
-def find_project_root(start: Path) -> Path:
-    cur = start
-    for _ in range(10):
-        if (cur / ".draftgo").is_dir():
-            return cur
-        if cur.parent == cur:
-            break
-        cur = cur.parent
-    cwd = Path.cwd()
-    if (cwd / ".draftgo").is_dir():
-        return cwd
-    return start.parents[3] if len(start.parents) >= 4 else start
-
-
-DEFAULT_ROOT = find_project_root(SCRIPT_DIR)
-
-
-def load_config():
-    cfg_path = DEFAULT_ROOT / ".draftgo/config.json"
-    if not cfg_path.exists():
-        print("ERR: .draftgo/config.json not found, run /draftgo init first", file=sys.stderr)
-        sys.exit(1)
-    cfg = json.loads(cfg_path.read_text(encoding="utf-8"))
-    return cfg["server"].rstrip("/"), cfg["token"]
-
-
-def api_delete(server, token, path):
-    headers = {
-        "Authorization": f"Bearer {token}",
-        "Accept": "application/json",
-    }
-    req = urllib.request.Request(
-        f"{server}{path}",
-        method="DELETE",
-        headers=headers,
-    )
-    try:
-        with urllib.request.urlopen(req, timeout=15) as r:
-            return True, r.status, r.read().decode("utf-8", errors="replace")
-    except urllib.error.HTTPError as e:
-        return False, e.code, e.read().decode(errors="replace")
-    except Exception as e:
-        return False, None, str(e)
-
-
-def _load_index(rel_index):
-    new_path = DEFAULT_ROOT / ".draftgo" / rel_index
-    legacy_path = DEFAULT_ROOT / rel_index
-    path = new_path if new_path.exists() else legacy_path
-    if not path.exists():
-        print(f"ERR: {rel_index} not found", file=sys.stderr)
-        sys.exit(1)
-    return path, json.loads(path.read_text(encoding="utf-8"))
-
-
-def _remove_local_file(rel_path):
-    if not rel_path:
-        return
-    full = DEFAULT_ROOT / rel_path
-    if full.exists():
-        full.unlink()
-        print(f"  deleted local file: {rel_path}")
-
-
-# type → (api_prefix, index_rel, id_field, file_field)
-TYPE_MAP = {
-    "pages":          ("/api/pages",           "pages/index.json",                   "id", "html_file"),
-    "nav":            ("/api/navigations",      "navigations/index.json",             "id", "html_file"),
-    "db_meta":        ("/api/db-meta",          "db_meta/index.json",                 "id", None),
-    "custom_scripts": ("/api/scripts",          "custom_scripts/index.json",          "id", "code_file"),
-    "docs":           ("/api/docs/articles",    "docs/articles/index.json",           "id", "content_file"),
-    "doc_categories": ("/api/docs/categories",  "doc_categories/index.json",          "id", None),
-    "aihub":          ("/api/aihub",            "aihub/index.json",                   "id", None),
-}
-
-
-def delete_resource(type_name, resource_id):
-    if type_name not in TYPE_MAP:
-        print(f"ERR: unknown type '{type_name}'. Supported: {', '.join(TYPE_MAP)}", file=sys.stderr)
-        sys.exit(1)
-
-    api_prefix, index_rel, id_field, file_field = TYPE_MAP[type_name]
-    server, token = load_config()
-
-    # 1. 找到 index 条目
-    index_path, items = _load_index(index_rel)
-    item = next((it for it in items if str(it.get(id_field)) == str(resource_id)), None)
-    label = (
-        item.get("title") or item.get("name") or item.get("type") or item.get("slug") or resource_id
-        if item else resource_id
-    )
-
-    # 2. 调用 DELETE API
-    ok, status, body = api_delete(server, token, f"{api_prefix}/{resource_id}")
-    if not ok and status != 404:
-        print(f"  ERR [{label}] 删除失败: HTTP {status}: {body}")
-        sys.exit(1)
-
-    if status == 404:
-        print(f"  WARN [{label}] 云端不存在（id={resource_id}），仅清理本地")
-    else:
-        print(f"  OK [{label}] 已从云端删除（id={resource_id}）")
-
-    # 3. 删除本地文件
-    if item and file_field:
-        _remove_local_file(item.get(file_field))
-
-    # 4. 从 index 移除条目
-    new_items = [it for it in items if str(it.get(id_field)) != str(resource_id)]
-    if len(new_items) < len(items):
-        index_path.write_text(json.dumps(new_items, ensure_ascii=False, indent=2), encoding="utf-8")
-        print(f"  OK [{label}] 已从本地 index 移除")
-    else:
-        print(f"  WARN [{label}] 本地 index 中未找到 id={resource_id}")
-
-
-def main():
-    if len(sys.argv) < 3:
-        print(f"usage: draftgo_delete.py <{'|'.join(TYPE_MAP)}> <id>", file=sys.stderr)
-        sys.exit(1)
-
-    type_name = sys.argv[1]
-    resource_id = sys.argv[2]
-    delete_resource(type_name, resource_id)
-
-
-if __name__ == "__main__":
-    main()

package/resources/skill/scripts/draftgo_init.py

@@ -1,80 +0,0 @@
-#!/usr/bin/env python3
-"""
-DraftGo Init Script
-初始化项目配置，并从云端拉取全量数据到本地。
-
-用法：
-  DRAFTGO_TOKEN=yyy python draftgo_init.py --server https://xxx [project_dir]
-"""
-import argparse, json, os, sys
-from pathlib import Path
-
-SCRIPT_DIR = Path(__file__).resolve().parent
-
-# 同目录下的 pull 模块
-sys.path.insert(0, str(SCRIPT_DIR))
-from draftgo_pull import find_project_root, pull_all, load_config  # noqa: E402
-
-DEFAULT_ROOT = find_project_root(SCRIPT_DIR)
-
-
-def main():
-    parser = argparse.ArgumentParser()
-    parser.add_argument("--server", required=True)
-    parser.add_argument("--token", required=False, help=argparse.SUPPRESS)
-    parser.add_argument(
-        "project_dir",
-        nargs="?",
-        default=None,
-        help="项目根目录（可选），默认自动推导",
-    )
-    args = parser.parse_args()
-
-    server = args.server.rstrip("/")
-    token = args.token or os.environ.get("DRAFTGO_TOKEN")
-    if not token:
-        parser.error("token is required: set DRAFTGO_TOKEN or pass --token")
-    root = Path(args.project_dir).resolve() if args.project_dir else DEFAULT_ROOT
-    dg_dir = root / ".draftgo"
-    dg_dir.mkdir(parents=True, exist_ok=True)
-
-    # 写入配置。重复初始化时保留用户明确启用的自动推送开关。
-    config_path = dg_dir / "config.json"
-    old_cfg = {}
-    if config_path.exists():
-        try:
-            old_cfg = json.loads(config_path.read_text(encoding="utf-8"))
-        except Exception:
-            pass
-    cfg = {
-        "server": server,
-        "token": token,
-        "lessons_on_push": old_cfg.get("lessons_on_push", True),
-        "auto_push": old_cfg.get("auto_push", False) is True,
-    }
-    config_path.write_text(
-        json.dumps(cfg, indent=2),
-        encoding="utf-8",
-    )
-
-    # .gitignore 保护敏感配置
-    gi = root / ".gitignore"
-    content = gi.read_text(encoding="utf-8") if gi.exists() else ""
-    if ".draftgo/config.json" not in content:
-        with gi.open("a", encoding="utf-8") as f:
-            f.write("\n.draftgo/config.json\n")
-
-    # 拉取全量数据
-    print("Pulling all resources from cloud...")
-    pull_all(server, token, root)
-
-    # 创建辅助目录
-    for d in ("lessons", "Task"):
-        (dg_dir / d).mkdir(parents=True, exist_ok=True)
-    print("  OK .draftgo/lessons/ .draftgo/Task/")
-
-    print(f"\nDone. server: {server}")
-
-
-if __name__ == "__main__":
-    main()

package/resources/skill/scripts/draftgo_pull.py

@@ -1,427 +0,0 @@
-#!/usr/bin/env python3
-"""
-DraftGo Pull Script
-从云端拉取数据到本地 .draftgo/ 目录，支持按类型增量拉取。
-
-用法：
-  python draftgo_pull.py pages          [page_id ...]
-  python draftgo_pull.py nav            [nav_id ...]
-  python draftgo_pull.py db_meta        [db_meta_id ...]
-  python draftgo_pull.py aihub          [aihub_id ...]
-  python draftgo_pull.py system_config  [config_key ...]
-  python draftgo_pull.py docs           [article_id ...]
-  python draftgo_pull.py doc_categories [category_id ...]
-  python draftgo_pull.py custom_scripts [script_id ...]
-  python draftgo_pull.py roles          [role_id ...]
-  python draftgo_pull.py users          [user_id ...]
-  python draftgo_pull.py --all
-"""
-import json, sys
-from pathlib import Path
-import urllib.request, urllib.error, urllib.parse
-
-SCRIPT_DIR = Path(__file__).resolve().parent
-
-
-def find_project_root(start: Path) -> Path:
-    cur = start
-    for _ in range(10):
-        if (cur / ".draftgo").is_dir():
-            return cur
-        if cur.parent == cur:
-            break
-        cur = cur.parent
-    # CWD 回退：脚本可能在中文路径下被调用，SCRIPT_DIR 解析失败时用 CWD
-    cwd = Path.cwd()
-    if (cwd / ".draftgo").is_dir():
-        return cwd
-    return start.parents[3] if len(start.parents) >= 4 else start
-
-
-DEFAULT_ROOT = find_project_root(SCRIPT_DIR)
-
-# ── 端点映射 ──
-ENDPOINTS = {
-    "pages":           "/api/pages/",
-    "navigations":     "/api/navigations",
-    "roles":           "/api/roles",
-    "users":           "/api/users",
-    "db_meta":         "/api/db-meta",
-    "aihub":           "/api/aihub",
-    "system_config":   "/api/system/config",
-    "doc_categories":  "/api/docs/categories?flat=true",
-    "docs":            "/api/docs/admin/articles",
-    "custom_scripts":  "/api/scripts/",
-}
-
-# ── 通用工具函数 ──
-
-def load_config(root=None):
-    root = root or DEFAULT_ROOT
-    cfg_path = root / ".draftgo/config.json"
-    if not cfg_path.exists():
-        print("ERR: .draftgo/config.json not found, run /draftgo init first", file=sys.stderr)
-        sys.exit(1)
-    cfg = json.loads(cfg_path.read_text(encoding="utf-8"))
-    return cfg["server"].rstrip("/"), cfg["token"]
-
-
-_UA = (
-    "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
-    "(KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36"
-)
-
-
-def fetch(server, token, path):
-    url = f"{server}{path}"
-    req = urllib.request.Request(
-        url,
-        headers={
-            "Authorization": f"Bearer {token}",
-            "User-Agent": _UA,
-            "Accept": "application/json",
-        },
-    )
-    try:
-        with urllib.request.urlopen(req, timeout=15) as r:
-            return json.loads(r.read())
-    except urllib.error.HTTPError as e:
-        print(f"  ✗ {path} → HTTP {e.code}", file=sys.stderr)
-        return None
-    except Exception as e:
-        print(f"  ✗ {path} → {e}", file=sys.stderr)
-        return None
-
-
-def unwrap(raw):
-    """Unwrap unified envelope: {code, data, message} → data."""
-    if isinstance(raw, dict) and "code" in raw and "data" in raw:
-        return raw["data"]
-    return raw
-
-
-def extract_items(raw):
-    raw = unwrap(raw)
-    if isinstance(raw, list):
-        return raw
-    if isinstance(raw, dict):
-        for key in ("items", "results"):
-            v = raw.get(key)
-            if isinstance(v, list):
-                return v
-        if isinstance(raw.get("data"), list):
-            return raw["data"]
-    return []
-
-
-def safe_slug(s):
-    return str(s).strip("/").replace("/", "_") or "root"
-
-
-def write_index(folder, items, preserve_existing=False, id_key="id"):
-    if preserve_existing:
-        index_path = folder / "index.json"
-        try:
-            existing = json.loads(index_path.read_text(encoding="utf-8"))
-            if not isinstance(existing, list):
-                existing = []
-        except (OSError, json.JSONDecodeError):
-            existing = []
-        replacements = {
-            str(item.get(id_key)): item for item in items if item.get(id_key) is not None
-        }
-        retained = []
-        seen = set()
-        for item in existing:
-            key = str(item.get(id_key)) if item.get(id_key) is not None else None
-            if key in replacements:
-                retained.append(replacements[key])
-                seen.add(key)
-            else:
-                retained.append(item)
-        items = retained + [
-            item for item in items
-            if item.get(id_key) is None or str(item.get(id_key)) not in seen
-        ]
-    folder.mkdir(parents=True, exist_ok=True)
-    (folder / "index.json").write_text(
-        json.dumps(items, ensure_ascii=False, indent=2), encoding="utf-8"
-    )
-
-
-# ── 各类型的 explode 逻辑 ──
-
-def explode_pages(out_dir, items, preserve_existing=False):
-    index = []
-    for p in items:
-        pid = p.get("id", "x")
-        fname = f"page_{pid}_{safe_slug(p.get('route', pid))}.html"
-        html = (p.get("value") or {}).get("html", "")
-        (out_dir / fname).write_text(html, encoding="utf-8")
-        meta = {k: v for k, v in p.items() if k != "value"}
-        meta["html_file"] = f".draftgo/pages/{fname}"
-        index.append(meta)
-    write_index(out_dir, index, preserve_existing)
-    return len(index)
-
-
-def explode_navigations(out_dir, items, preserve_existing=False):
-    index = []
-    for item in items:
-        iid = item.get("id", "x")
-        name_slug = safe_slug(item.get("code") or item.get("route") or iid)
-        fname = f"nav_{iid}_{name_slug}.html"
-        # 列表接口只返回导航元数据。详情拉取失败时不能以空内容覆盖本地导航。
-        if isinstance(item.get("html"), str):
-            (out_dir / fname).write_text(item["html"], encoding="utf-8")
-        else:
-            print(
-                f"  WARN nav_id={iid} 未取得 HTML，保留本地文件: {fname}",
-                file=sys.stderr,
-            )
-        meta = {k: v for k, v in item.items() if k != "html"}
-        meta["html_file"] = f".draftgo/navigations/{fname}"
-        index.append(meta)
-    write_index(out_dir, index, preserve_existing)
-    return len(index)
-
-
-def explode_docs(out_dir, items, preserve_existing=False):
-    index = []
-    for art in items:
-        aid = art.get("id", "x")
-        slug = safe_slug(art.get("slug") or art.get("title") or aid)
-        fname = f"article_{aid}_{slug}.html"
-        content = art.get("content") or ""
-        (out_dir / fname).write_text(content, encoding="utf-8")
-        meta = {k: v for k, v in art.items() if k != "content"}
-        meta["content_file"] = f".draftgo/docs/articles/{fname}"
-        index.append(meta)
-    write_index(out_dir, index, preserve_existing)
-    return len(index)
-
-
-def explode_scripts(out_dir, items, preserve_existing=False):
-    index = []
-    for sc in items:
-        sid = sc.get("id", "x")
-        slug = safe_slug(sc.get("slug") or sc.get("name") or sid)
-        fname = f"script_{sid}_{slug}.go"
-        # 列表接口不含 code；详情拉取失败时绝不能用空内容覆盖受管源码。
-        if "code" in sc:
-            (out_dir / fname).write_text(sc["code"], encoding="utf-8")
-        else:
-            print(f"  WARN script_id={sid} 未取得代码，保留本地文件: {fname}", file=sys.stderr)
-        meta = {k: v for k, v in sc.items() if k not in ("code", "language")}
-        meta["code_file"] = f".draftgo/custom_scripts/{fname}"
-        index.append(meta)
-    write_index(out_dir, index, preserve_existing)
-    return len(index)
-
-
-# ── 按类型拉取 ──
-
-def select_items(items, ids, id_key, type_name):
-    """筛选指定目标，并拒绝用空结果覆盖现有索引。"""
-    if not ids:
-        return items
-    wanted = [str(value) for value in ids]
-    found = {str(item.get(id_key)) for item in items if item.get(id_key) is not None}
-    missing = [value for value in wanted if value not in found]
-    if missing:
-        print(
-            f"  ERR {type_name} 云端未返回目标 {id_key}: {', '.join(missing)}",
-            file=sys.stderr,
-        )
-        return None
-    return [item for item in items if str(item.get(id_key)) in wanted]
-
-def pull_pages(server, token, root, ids=None):
-    raw = fetch(server, token, ENDPOINTS["pages"])
-    if raw is None:
-        return None
-    items = extract_items(raw)
-    items = select_items(items, ids, "id", "pages")
-    if items is None:
-        return None
-    if any(not isinstance(p.get("value"), dict) or not isinstance(p["value"].get("html"), str) for p in items):
-        print("  ERR pages 响应缺少 HTML，未写入本地缓存", file=sys.stderr)
-        return None
-    out = root / ".draftgo/pages"
-    out.mkdir(parents=True, exist_ok=True)
-    count = explode_pages(out, items, preserve_existing=bool(ids))
-    print(f"  OK pages ({count} items)")
-    return count
-
-
-def pull_navigations(server, token, root, ids=None):
-    raw = fetch(server, token, ENDPOINTS["navigations"])
-    if raw is None:
-        return None
-    items = extract_items(raw)
-    items = select_items(items, ids, "id", "navigations")
-    if items is None:
-        return None
-    hydrated = []
-    for item in items:
-        code = item.get("code")
-        if not code:
-            print(
-                f"  ERR nav_id={item.get('id', '?')} 缺少 code，未写入本地缓存",
-                file=sys.stderr,
-            )
-            return None
-        detail = unwrap(fetch(
-            server, token, f"/api/navigations/{urllib.parse.quote(str(code), safe='')}"
-        ))
-        if not isinstance(detail, dict) or not isinstance(detail.get("html"), str):
-            print(
-                f"  ERR nav_id={item.get('id', '?')} 未取得 HTML，未写入本地缓存",
-                file=sys.stderr,
-            )
-            return None
-        hydrated.append({**item, **detail})
-    out = root / ".draftgo/navigations"
-    out.mkdir(parents=True, exist_ok=True)
-    count = explode_navigations(out, hydrated, preserve_existing=bool(ids))
-    print(f"  OK navigations ({count} items)")
-    return count
-
-
-def pull_simple(server, token, root, type_name, ids=None):
-    """拉取仅需 index.json 的简单类型（db_meta, aihub, roles, users, system_config）。"""
-    raw = fetch(server, token, ENDPOINTS[type_name])
-    if raw is None:
-        return None
-    items = extract_items(raw)
-    id_key = "config_key" if type_name == "system_config" else "id"
-    items = select_items(items, ids, id_key, type_name)
-    if items is None:
-        return None
-    out = root / f".draftgo/{type_name}"
-    write_index(out, items, preserve_existing=bool(ids), id_key=id_key)
-    print(f"  OK {type_name} ({len(items)} items)")
-    return len(items)
-
-
-def pull_docs(server, token, root, ids=None):
-    raw = fetch(server, token, ENDPOINTS["docs"])
-    if raw is None:
-        return None
-    items = extract_items(raw)
-    items = select_items(items, ids, "id", "docs")
-    if items is None:
-        return None
-    hydrated = []
-    for it in items:
-        aid = it.get("id")
-        detail = unwrap(fetch(server, token, f"/api/docs/articles/{aid}")) if aid else None
-        if not isinstance(detail, dict) or not isinstance(detail.get("content"), str):
-            print(
-                f"  ERR article_id={aid or '?'} 未取得正文，未写入本地缓存",
-                file=sys.stderr,
-            )
-            return None
-        hydrated.append({**it, **detail})
-    out = root / ".draftgo/docs/articles"
-    out.mkdir(parents=True, exist_ok=True)
-    count = explode_docs(out, hydrated, preserve_existing=bool(ids))
-    print(f"  OK docs ({count} articles)")
-    return count
-
-
-def pull_doc_categories(server, token, root, ids=None):
-    raw = fetch(server, token, ENDPOINTS["doc_categories"])
-    if raw is None:
-        return None
-    items = extract_items(raw)
-    items = select_items(items, ids, "id", "doc_categories")
-    if items is None:
-        return None
-    out = root / ".draftgo/doc_categories"
-    write_index(out, items, preserve_existing=bool(ids))
-    print(f"  OK doc_categories ({len(items)} items)")
-    return len(items)
-
-
-def pull_custom_scripts(server, token, root, ids=None):
-    raw = fetch(server, token, ENDPOINTS["custom_scripts"])
-    if raw is None:
-        return None
-    items = extract_items(raw)
-    items = select_items(items, ids, "id", "custom_scripts")
-    if items is None:
-        return None
-    hydrated = []
-    for it in items:
-        script_id = it.get("id")
-        detail = unwrap(fetch(server, token, f"/api/scripts/{script_id}")) if script_id else None
-        if not isinstance(detail, dict) or not isinstance(detail.get("code"), str):
-            print(
-                f"  ERR script_id={script_id or '?'} 未取得代码，未写入本地缓存",
-                file=sys.stderr,
-            )
-            return None
-        hydrated.append({**it, **detail})
-    out = root / ".draftgo/custom_scripts"
-    out.mkdir(parents=True, exist_ok=True)
-    count = explode_scripts(out, hydrated, preserve_existing=bool(ids))
-    print(f"  OK custom_scripts ({count} scripts, code from details)")
-    return count
-
-
-# ── Handler 映射 ──
-
-PULL_HANDLERS = {
-    "pages":           pull_pages,
-    "nav":             lambda s, t, r, ids=None: pull_navigations(s, t, r, ids),
-    "navigations":     pull_navigations,
-    "db_meta":         lambda s, t, r, ids=None: pull_simple(s, t, r, "db_meta", ids),
-    "aihub":           lambda s, t, r, ids=None: pull_simple(s, t, r, "aihub", ids),
-    "roles":           lambda s, t, r, ids=None: pull_simple(s, t, r, "roles", ids),
-    "users":           lambda s, t, r, ids=None: pull_simple(s, t, r, "users", ids),
-    "system_config":   lambda s, t, r, ids=None: pull_simple(s, t, r, "system_config", ids),
-    "docs":            pull_docs,
-    "doc_categories":  pull_doc_categories,
-    "custom_scripts":  pull_custom_scripts,
-}
-
-
-def pull_all(server, token, root):
-    """拉取全部类型，供 init 复用。"""
-    results = [pull_pages(server, token, root), pull_navigations(server, token, root)]
-    for t in ("db_meta", "aihub", "roles", "users", "system_config"):
-        results.append(pull_simple(server, token, root, t))
-    results.extend([
-        pull_doc_categories(server, token, root),
-        pull_docs(server, token, root),
-        pull_custom_scripts(server, token, root),
-    ])
-    return None if any(result is None for result in results) else results
-
-
-def main():
-    if len(sys.argv) < 2:
-        print(f"usage: draftgo_pull.py {{{'|'.join(PULL_HANDLERS)}}}|--all [id ...]")
-        sys.exit(1)
-
-    mode = sys.argv[1]
-    server, token = load_config()
-    root = DEFAULT_ROOT
-
-    if mode == "--all":
-        if pull_all(server, token, root) is None:
-            sys.exit(1)
-        return
-
-    if mode not in PULL_HANDLERS:
-        print(f"unknown type: {mode}\navailable: {', '.join(PULL_HANDLERS)} or --all")
-        sys.exit(1)
-
-    ids = sys.argv[2:] or None
-    if PULL_HANDLERS[mode](server, token, root, ids) is None:
-        sys.exit(1)
-
-
-if __name__ == "__main__":
-    main()