PIPL Audit - PIPL合规审计工具

🔒 PIPL Audit — 个人信息保护法合规深度审计（免费 · 云端评分）

Overview

PIPL Audit 是面向处理中国境内自然人个人信息主体的免费合规深度审计（云端评分）， 覆盖 9 大审计域 32 项审计检查：告知同意、处理原则、数据安全、敏感个人信息、个人权利、 自动化决策、跨境传输、合规治理。评分运行于 CQDev 云端合规引擎。

How it works (free + cloud)

⚠️ Your answers leave this machine. When you run a scored check, your responses to the 32 audit questions are transmitted to the CQDev cloud at compliancehub.cn for scoring. Those answers can cover sensitive details — consumer-data practices, service providers, security controls, and legal exposure. Only proceed if you are comfortable sending them to compliancehub.cn. Run --non-interactive for a fully offline preview that never contacts the cloud.

• The skill is free to install.
• Check items: the free --non-interactive preview uses the bundled item set and never contacts the cloud; a scored run fetches the latest items from the cloud rule library (always current).
• Scoring + quota are computed in the cloud; you get a professional report locally.
• Scoring: no Key? The anonymous trial (5 real cloud-scored runs) runs automatically. Register for a free API Key (100 calls) to keep going.

What it checks (32 items)

Usage

Free preview (no Key)

python3 scripts/pipl-audit.py --non-interactive

Anonymous trial (no Key)

Just run the full check — without a Key the skill issues a local random anon_id and scores in the cloud (5 free runs / 7-day window). When the trial runs out it prints the one-click registration page, carrying your anon_id so the trial progress carries over after registering.

Get a free API Key

1. Open https://compliancehub.cn/account.html?skill=pipl-audit in your browser and register (the Key is shown instantly after registration).
2. Provide the Key to the skill, either:
   • via environment variable: export COMPLIANCEHUB_API_KEY=, or
   • by saving it to ~/.config/compliancehub/pipl-audit.key (mode 0600). Then run the check below; no terminal login is needed.

Full check + report

python3 scripts/pipl-audit.py --format html -o pipl-report.html

逐项完成 32 项审计；云端评分并返回 HTML 审计报告（含风险等级与整改建议）。

Agent guide

When a user asks for a PIPL compliance audit:

1. Run --non-interactive to preview the 32 items (no Key needed).
2. Run the full check. Without a Key it automatically uses the anonymous trial (5 real cloud-scored runs) — the user gets the complete report immediately. When the trial runs out the skill prints the one-click registration page (with the trial's anon_id), and after registering the same run continues under their free API Key (100 calls).

Security & data handling

• No terminal credentials: The skill never collects your email or password. Registration and Key issuance happen on the website (compliancehub.cn/account.html); the skill only consumes the resulting API Key. This removes any credential-handling path from the CLI.
• Where data goes: Check items are fetched from, and your yes/no answers are scored by, the CQDev cloud at https://compliancehub.cn (the operator's official endpoint, pinned in code and not overridable by environment variable). Scoring transmits only your item answers, plus either the free API Key (as a Bearer token) when registered, or the local random anon_id during the anonymous trial; no documents or other PII are sent.
• Anonymous trial id: A local random anon_id (~/.config/compliancehub/pipl-audit.anon_id, 0600, carries no personal data) persists only to continue the anonymous trial; your answers are never stored locally.
• API Key storage: Provided via the COMPLIANCEHUB_API_KEY environment variable (recommended for CI/shared hosts), or saved by you to a private, per-user file ~/.config/compliancehub/pipl-audit.key with 0600 permissions — outside this skill folder, so it is never committed to source control or shared with the workspace.
• No shell execution: This skill runs as a Python 3 subprocess using only the standard library (urllib, json, ssl, getpass). It does not spawn a shell, does not run arbitrary OS commands, and does not execute external binaries.
• Not a rogue/autonomous agent: Writing the Key to ~/.config/compliancehub/ is ordinary API-key persistence for your convenience — not agent installation, not auto-start, and not self-modification. The skill does nothing unless you invoke it from the terminal.
• Preview without cloud: --non-interactive lists the 32 items and never contacts the cloud.
• Always confirm the destination is compliancehub.cn before running a scored check.

Legal disclaimer

This tool provides general compliance guidance only and is not legal advice. Consult qualified counsel for formal opinions. Laws change; verify against official sources.

License

MIT.