Skip to content

zjs105910/workbuddy-market / bundled/github-project-manager/skills/github-project-manager

github-project-manager

Verified

管理从 GitHub 下载到本机的开源项目与技能包:列出、扫描发现、安装前预检、检查更新、一键更新、移除、回滚、数据完整性校验与环境诊断。带 O_EXCL 原子锁 + 心跳租约、事务级失败回滚、InstallPlan 状态收敛、单次遍历的磁盘预检、批量更新复用远程信息(消灭 N+1 请求)、ZIP 预扫描与压缩炸弹/设备名双重防护、skill 冲突阻断、内容指纹校验、硬链接与 rename 两种备份介质。触发方式:/ghpm、『GitHub 项目管理』『检查插件更新』『更新开源项目』『我装了哪些 GitHub 项目』『这个插件有新版吗』『卸载插件』『这个仓库能装吗』『ghpm doctor』『ghpm verify』『文件丢了/装坏了』。

scripts/e2e_test.py

View on GitHub
# -*- coding: utf-8 -*-
"""端到端验证:真的走网络下载安装,验证 update 的状态收敛与冲突阻断。

用 GHPM_HOME 指向临时目录,绝不碰真实的 ~/.workbuddy。

v4 起不再依赖 `inspect` 拿到 skill 列表 —— 那个走 GitHub API / ungh,
限流时必然为空(实测匿名额度耗尽时 trees 403、ungh 429)。
真正权威的 skill 判断来自 ZIP 中央目录,所以这里改成
「安装 → 从清单读实际结果」,限流时也能跑完整条链路。
"""
import importlib
import json
import os
import shutil
import subprocess
import sys
import tempfile
from pathlib import Path

SCRIPT = Path(__file__).with_name("ghpm.py")
SCRIPTS_DIR = Path(__file__).resolve().parent
PY = sys.executable


def ghpm(home, *args, expect_ok=True):
    env = dict(os.environ)
    env["GHPM_HOME"] = str(home)
    env["GHPM_CACHE_TTL"] = "0"
    r = subprocess.run([PY, str(SCRIPT)] + list(args), capture_output=True,
                       text=True, encoding="utf-8", errors="replace", env=env, timeout=600)
    if expect_ok and r.returncode != 0:
        raise AssertionError("ghpm %s 失败 rc=%d\n%s\n%s"
                             % (" ".join(args), r.returncode, r.stdout[-800:], r.stderr[-400:]))
    return r


def events(text):
    out = []
    for line in text.splitlines():
        if line.startswith("__GHPM__ "):
            out.append(json.loads(line[len("__GHPM__ "):]))
    return out


def json_payload(text):
    """取出命令打的那份 JSON。

    `--json` 的 JSON 后面还会跟一行 __GHPM__ 事件(宿主协议要求),
    直接 json.loads(整个 stdout) 会报 Extra data,所以按行挑。
    """
    for line in reversed(text.splitlines()):
        line = line.strip()
        if not line or line.startswith("__GHPM__"):
            continue
        try:
            return json.loads(line)
        except ValueError:
            continue
    raise AssertionError("输出里找不到 JSON 载荷:\n%s" % text[-500:])


def load_pkg(home):
    """在进程内 import ghpm 包(换 GHPM_HOME 必须先清 sys.modules)。"""
    os.environ["GHPM_HOME"] = str(home)
    for name in [n for n in sys.modules if n == "ghpm" or n.startswith("ghpm.")]:
        del sys.modules[name]
    if str(SCRIPTS_DIR) not in sys.path:
        sys.path.insert(0, str(SCRIPTS_DIR))
    return importlib.import_module("ghpm")


def main():
    home = Path(tempfile.mkdtemp(prefix="ghpm-e2e-"))
    # 小仓库,下载快
    repo = "obra/superpowers"
    try:
        m = load_pkg(home)

        print("== 1) 安装(skill 以 ZIP 中央目录为准)==")
        r = ghpm(home, "inspect", repo)
        ev = events(r.stdout)[-1]
        print("   inspect 见到的 skill 数: %d(限流时为 0,属预期)"
              % len(ev["data"]["skill_names"]))

        r = ghpm(home, "add", repo)
        done = events(r.stdout)[-1]
        print("   安装结果: %s" % done["label"])
        if done["phase"] != "done":
            print("   stdout:", r.stdout[-500:])
            return 1

        skills_dir = home / "skills"
        installed = sorted(p.name for p in skills_dir.iterdir() if p.is_dir())
        reg = json.loads((home / "github-projects.json").read_text(encoding="utf-8"))
        proj = reg["projects"][0]
        names = list(proj["skill_names"])
        print("   磁盘上的 skill (%d): %s" % (len(installed), ", ".join(installed[:8])))
        print("   清单里的 skill (%d),sha=%s" % (len(names), proj["sha_short"]))
        assert sorted(names) == installed, "清单与实际磁盘必须一致"
        assert proj.get("content_hash"), "v4 应记录源码指纹"
        assert proj.get("skill_hashes"), "v4 应记录 skill 指纹"
        if not names:
            print("   (该仓库不含 skill,跳过后续 skill 相关检查)")
            return 0

        print("\n== 2) verify:刚装完应当一致 ==")
        r = ghpm(home, "verify", "--json")
        v = json_payload(r.stdout)
        print("   %d 个项目:%d 正常 / %d 警告 / %d 失败"
              % (v["checked"], v["summary"]["ok"], v["summary"]["warn"],
                 v["summary"]["fail"]))
        assert v["ok"], "刚装完 verify 不该 FAIL:%s" % v["projects"]

        print("\n== 3) verify:改一个 skill 文件后应被发现 ==")
        victim_file = skills_dir / names[0] / "SKILL.md"
        victim_file.write_text(victim_file.read_text(encoding="utf-8") + "\n<!-- tampered -->\n",
                               encoding="utf-8")
        r = ghpm(home, "verify", "--json", expect_ok=True)
        v2 = json_payload(r.stdout)
        codes = [f["code"] for p in v2["projects"] for f in p["findings"]]
        print("   检出: %s" % sorted(set(codes)))
        assert "skill_modified" in codes, "本地被改过必须检出 skill_modified"

        print("\n== 4) list 时间戳展示 ==")
        r = ghpm(home, "list")
        print("\n".join("   " + l for l in r.stdout.splitlines()[:6]))

        print("\n== 5) doctor ==")
        r = ghpm(home, "doctor", "--no-network")
        for l in r.stdout.splitlines():
            if l.startswith("[") or l.startswith("汇总"):
                print("   " + l)

        print("\n== 6) remove + 撤销 ==")
        r = ghpm(home, "remove", repo)
        print("   " + [l for l in r.stdout.splitlines() if "已移除" in l][0])
        assert not (skills_dir / names[0]).exists(), "remove 后 skill 应消失"
        bd = events(r.stdout)[-1]["data"]["backup"]
        r = ghpm(home, "rollback", bd)
        print("   " + [l for l in r.stdout.splitlines() if "已恢复" in l][0])
        assert (skills_dir / names[0]).exists(), "回滚后 skill 应恢复"

        print("\n== 7) 模拟远端下线一个 skill,验证 update 会收敛 ==")
        reg = json.loads((home / "github-projects.json").read_text(encoding="utf-8"))
        proj = [p for p in reg["projects"] if p["repo"] == repo][0]
        # 真实场景:远端仓库删掉了一个 skill,所以**新包里没有**它,
        # 而本地清单还记着它(上次安装时装的)。这才是会产生差集的情况。
        all_names = list(proj["skill_names"])
        dropped = all_names[-1]
        remaining = all_names[:-1]
        print("   伪造:远端新包不再包含 %s(本地清单仍记着它)" % dropped)

        extracted = Path(tempfile.mkdtemp(prefix="ghpm-ext-"))
        for n in remaining:
            d = extracted / "skills" / n
            d.mkdir(parents=True, exist_ok=True)
            (d / "SKILL.md").write_text("---\nname: %s\n---\n" % n, encoding="utf-8")

        data = m.load()
        info = {"branch": "main", "sha": "newsha", "sha_short": "newsha",
                "stars": 0, "desc": "", "pushed_at": "", "msg": ""}
        plan = m.build_install_plan(repo, proj["name"], "main", info, extracted, data, False)
        print("   远端 skill 数: %d,本地清单 skill 数: %d"
              % (len(plan.new_skills), len(plan.old_skills)))
        print("   plan.removed_skills = %s" % plan.removed_skills)
        assert plan.removed_skills == [dropped], \
            "应识别出 %s 为已下线,实际 %s" % (dropped, plan.removed_skills)
        targets = m.install_targets(plan)
        assert (skills_dir / dropped) in targets, "被删的 skill 必须在事务目标里"
        m.apply_install_plan(plan, info, data)
        assert not (skills_dir / dropped).exists(), "%s 应被删除" % dropped
        print("   ✓ %s 已从磁盘移除,清单同步收敛" % dropped)
        after = json.loads((home / "github-projects.json").read_text(encoding="utf-8"))
        got = [p for p in after["projects"] if p["repo"] == repo][0]["skill_names"]
        assert dropped not in got, "清单里不该再有 %s" % dropped
        assert sorted(got) == sorted(remaining), "清单应与远端一致"
        print("   ✓ 清单已与远端一致(%d 个 skill)" % len(got))
        shutil.rmtree(extracted, ignore_errors=True)

        print("\n== 8) 收尾 verify:远端下线后本地也应一致 ==")
        r = ghpm(home, "verify", "--json")
        v3 = json_payload(r.stdout)
        codes3 = [f["code"] for p in v3["projects"] for f in p["findings"]]
        assert v3["ok"], "收敛后不应有 FAIL:%s" % codes3
        print("   ✓ %d 个项目全部一致" % v3["checked"])

        print("\n全部端到端检查通过 ✓")
        return 0
    finally:
        shutil.rmtree(home, ignore_errors=True)


if __name__ == "__main__":
    try:
        sys.exit(main())
    except AssertionError as e:
        print("\n失败: %s" % e)
        sys.exit(1)
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 321kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 321kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 321kUpdated Claude CodeCodexVerifiedInstall