clawprobe 二次开发 CLI 服务 · GitHub 开源 Demo · 跨平台桌面工作台
基于 Apache-2.0 协议开源,100% 纯 Python 3.9+ 标准库实现(0 第三方依赖)。无论是嵌入企业 CI/CD 发版合规门禁、二次开发内部安全平台,还是免命令行直接使用 Windows / macOS 原生桌面客户端,均可一套代码开箱即用。
一、 clawprobe CLI 命令行快速上手与 CI/CD 发版拦截
直接从官方 PyPI 安装最新版本(v1.3.5+),四步完成链路自检、鉴权登录、300s 三阶段活体检测与云端痕迹覆写销毁:
# 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
# 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
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>
- 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
| 退出码 (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 定制为内部专属合规工具:
原生窗口容器 · 告别旧版 Tk 空白缺陷
macOS 发行版采用原生 Cocoa + WKWebView Universal (arm64 + x86_64) 独立窗口;Windows 10/11 与源码模式自适应 Edge/Chrome --app= 原生应用窗口,本地 127.0.0.1 随机端口安全回环。
操作系统级安全钥匙串双向互通
自动将签名密钥加密存入 macOS Keychain (MACOS_KEYCHAIN) 或 Windows 凭据管理器 (WINDOWS_PASSWORD_VAULT),并与 ~/.clawnexus/credentials.json 双向同步,CLI 与桌面版免重复登录。
选包即检 + 端内扫码/卡密闭环 + 自助打包
内置原生文件选择器、30 秒抢跑快检、300 秒全量检测、微信/支付宝扫码及卡密 (CP-...) / 16位恢复码 (RCV-...) 激活;附带 build_macos_dmg.py 与 build_windows_exe.py 一键构建脚本。
# 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"])