OPEN-SOURCE DEVELOPER HUB · 与 GitHub 仓库 100% 同步

clawprobe 二次开发 CLI 服务 · GitHub 开源 Demo · 跨平台桌面工作台

基于 Apache-2.0 协议开源,100% 纯 Python 3.9+ 标准库实现(0 第三方依赖)。无论是嵌入企业 CI/CD 发版合规门禁、二次开发内部安全平台,还是免命令行直接使用 Windows / macOS 原生桌面客户端,均可一套代码开箱即用。

GitHub: 876387/clawprobe (APK 活体分析 CLI) ↗ GitHub: 876387/clawprobe/desktop_client (跨平台桌面版源码) ↗ 构建/获取 macOS 桌面版 (.dmg) 构建/获取 Windows 桌面版 (.exe)
0 外部依赖
纯 Python 3.9+ 标准库 (ssl / hmac / http.client),零供应链风险
cas_24h 秒传
支持 300MB 流式上传,SHA-256 命中 24h 池时 0 字节秒进沙箱
HMAC-v2 + SPKI
全报文防重放规范签名 + 服务端公钥指纹钉扎防中间人
3 遍覆写销毁
--reclaim 自动触发云端工件物理清零并返回 SHA-256 销毁回执

一、 clawprobe CLI 命令行快速上手与 CI/CD 发版拦截

直接从官方 PyPI 安装最新版本(v1.3.5+),四步完成链路自检、鉴权登录、300s 三阶段活体检测与云端痕迹覆写销毁:

1. 零依赖安装与免密钥环境自检(PyPI 官方源)
# Option A: Isolated global CLI via pipx
pipx install clawprobe

# Option B: Standard pip install (Python 3.9+, 0 third-party dependencies)
pip install -U clawprobe

# Verify TLS 1.3 + SPKI link health (no API Key required)
clawprobe doctor
2. 配置访问凭据(自动锁定 0600 权限或读取环境变量)
# Option A: Environment variables (recommended for CI/CD runners)
export CLAW_API_KEY="cnx_live_your_key_id"
export CLAW_API_SECRET="sec_your_hmac_secret"

# Option B: Local persistent login (~/.clawnexus/credentials.json, chmod 0600)
clawprobe auth login --api-key cnx_live_your_key_id --secret sec_your_hmac_secret
clawprobe auth verify
3. 执行 300s 三阶段活体动态分析并导出 PDF + JSON + PCAP 证据包
clawprobe analyze ./app-release.apk \
  --attest-authorized \
  --mode privacy \
  --queue-timeout 900 \
  --out ./clawprobe-report.pdf \
  --json-out ./clawprobe-report.json \
  --bundle ./clawprobe-bundle.zip \
  --reclaim

# Query historical job or manually trigger 3-pass overwrite destruction:
clawprobe job <job_id> --out ./report.pdf --json-out ./report.json --bundle ./evidence-bundle.zip
clawprobe reclaim <job_id>
4. 集成至 GitHub Actions / GitLab CI 发版门禁(发现同意前抢跑自动返回 Exit Code 2 阻断发版)
- name: SiliRanch / ClawProbe Pre-Release APK Privacy Gate
  env:
    CLAW_API_KEY: ${{ secrets.CLAW_API_KEY }}
    CLAW_API_SECRET: ${{ secrets.CLAW_API_SECRET }}
  run: |
    pip install -U clawprobe
    clawprobe analyze app/build/outputs/apk/release/app-release.apk \
      --attest-authorized \
      --mode privacy \
      --fail-on-preconsent \
      --json-out ./compliance-report.json \
      --reclaim
clawprobe 标准进程退出码规范(与 GitHub README 严格一致,供自动化流水线判读)
退出码 (Exit Code) 状态标识 触发条件与二次开发自动化处理建议
0 SUCCESS APK 静态指纹解析与 300s 三阶段动态分析完成,PDF / JSON / ZIP 已落盘 -> 流水线放行。
1 USAGE_OR_AUTH_ERROR 参数缺失、未显式传入 --attest-authorized 合法授权声明,或 API Key / HMAC 签名校验未通过。
2 PRECONSENT_ALERT 启用 --fail-on-preconsent 时,在 Stage 1 (0~60s 同意前) 检出抢跑联网 -> 自动阻断不合规包上架发版!
3 QUOTA_EXCEEDED 账户检测配额耗尽 (ERR_QUOTA_EXCEEDED) 或超出套餐绑定包名上限 -> 触发企业企微/飞书续费告警。
4 NETWORK_OR_QUEUE_TIMEOUT 网络不可达、SPKI 证书指纹不匹配或超出 --queue-timeout 排队窗口 -> 自动指数退避重试。

二、 开源跨平台桌面版工作台(Windows 10/11 & macOS 12+ GUI Demo)

仓库内置完整的单文件桌面工作台参考实现(desktop_client/clawprobe_desktop.py,Apache-2.0),既可供非命令行运营/代办人员直接使用,又可被技术团队一键 Fork 定制为内部专属合规工具:

DESKTOP · NATIVE WINDOW

原生窗口容器 · 告别旧版 Tk 空白缺陷

macOS 发行版采用原生 Cocoa + WKWebView Universal (arm64 + x86_64) 独立窗口;Windows 10/11 与源码模式自适应 Edge/Chrome --app= 原生应用窗口,本地 127.0.0.1 随机端口安全回环。

DESKTOP · SYSTEM KEYCHAIN

操作系统级安全钥匙串双向互通

自动将签名密钥加密存入 macOS Keychain (MACOS_KEYCHAIN) 或 Windows 凭据管理器 (WINDOWS_PASSWORD_VAULT),并与 ~/.clawnexus/credentials.json 双向同步,CLI 与桌面版免重复登录。

DESKTOP · FULL WORKFLOW

选包即检 + 端内扫码/卡密闭环 + 自助打包

内置原生文件选择器、30 秒抢跑快检、300 秒全量检测、微信/支付宝扫码及卡密 (CP-...) / 16位恢复码 (RCV-...) 激活;附带 build_macos_dmg.py 与 build_windows_exe.py 一键构建脚本。

桌面版启动与二次开发本地打包命令(同步自 desktop_client/README.md):
# Method 1: Launch Desktop GUI directly after `pip install -U clawprobe`
clawprobe desktop
# Or standalone entry point:
clawprobe-desktop

# Method 2: Run single-file cross-platform source directly (ideal for secondary customization)
git clone https://github.com/876387/clawprobe.git
cd clawprobe
python3 desktop_client/clawprobe_desktop.py

# Method 3: Package standalone macOS Universal .dmg or Windows x64 .exe
python3 desktop_client/build_macos_dmg.py      # -> desktop_client/dist/ClawProbe-Desktop-macOS.dmg
python desktop_client/build_windows_exe.py    # -> desktop_client/dist/ClawProbe-Desktop-Win64.exe

三、 Python 二次开发接口与结构化 JSON 样卷锚点规范

技术团队可直接 import clawprobe 内置的 ClawNexusClient,消费标准化的 report.json(含 static_apk_profile、anchored_technical_synthesis 与 layer1_deterministic_network_ledger)对接内部工单大盘:

import json
import subprocess

# Invoke zero-dependency clawprobe in headless mode and parse structured JSON output
proc = subprocess.run(
    [
        "clawprobe", "analyze", "./target.apk",
        "--attest-authorized",
        "--mode", "privacy",
        "--fail-on-preconsent",
        "--json-out", "./out_report.json",
        "--reclaim",
    ],
    capture_output=True,
    text=True,
)

report = json.loads(open("./out_report.json", encoding="utf-8").read())
summary = report["layer1_deterministic_network_ledger"]["summary"]
print("APK SHA-256:", report["static_apk_profile"]["apk_sha256"])
print("Stage-1 Pre-Consent Flows:", summary["pre_consent_flow_count"])
print("Anchored Findings:", report["anchored_technical_synthesis"]["verified_anchored_findings"])