hellob1889/Pandaone-AI-Agent

AI Agent 通过 pandaone write 提交审计 → Pandaone 签发带签名的合规凭证 → 写入完成
🧑‍💼 Pandaone is your codebase's personal manager. / Pandaone 是你代码库的专属经理。
Every AI agent is an employee working in your company — your codebase. Without a personal manager, employees do what they want — edit files, push commits, break production — and you have no idea what they did, when, or why.
**Pandaone is the personal manager you hired to protect your code.** Every AI agent — Claude, Cursor, Trae, or any tool you adopt tomorrow — must report to Pandaone first. Nothing gets written, nothing gets committed, nothing gets deployed until Pandaone approves it with a signed, auditable receipt:
Without a personal manager, your agents move money — er, code — without receipts:
**The left column is how most AI-agent-driven codebases look today.**
**The right column is how yours will look with one command:**
Your personal manager is on duty 24/7 — **before, during, and after every code change**. Every AI agent — Claude, Cursor, Trae — operates under one auditable protocol. **No exceptions. No bypass.**
> **AI Agent 代码审计门禁** — 让每一次代码改动都留下合规、可追溯的证据链。
-success)
English | 中文
---
中文 / Chinese
是什么？ / What is it?
Pandaone 是一个 **7 层防御体系**，强制 AI Agent（或任何开发者）写代码前必须经过审计：
任何受保护文件的修改都必须通过 pandaone write 命令，留下 reason / problem / approach 三段式审计记录。
**适用场景 / Use Cases**：
- 🤖 AI Agent 开发：防止 Agent 绕过审查直接改代码
- 🏢 企业合规：满足 SOC2 / ISO 27001 等代码变更审计要求
- 👥 团队协作：所有 PR 必须有审计记录才能合入
核心特性 / Core Features
- **17 种文本格式 + 24 种二进制格式保护**（.py / .md / .json / .yml / .env / .png / .pdf / ...）
- **7 层防御体系** / **7-Layer Defense System** (see Defense Layers)
- **MCP Server 原生支持** — Claude / Cursor / Trae 等 AI IDE 直连
- **13 种审计日志导出格式**（Excel / Word / PDF / SQLite / ...）
- **纯 Python** — Windows / macOS / Linux 通吃，**无 C 扩展**
- **右键菜单集成** — 一行命令在 3 大平台安装原生右键菜单（HKCU / Quick Action / Nautilus + Dolphin）
- **i18n 国际化** — zh-CN / en 双语 CLI 自动检测 + --lang 强制 + 持久化偏好
快速开始 / Quick Start
安装 / Installation
**方式 A：从 PyPI 安装（最简单）**
**方式 B：从源码一键安装（推荐开发者使用，含最新 i18n + CI lint）**
**安装脚本自动做 / Install script auto-handles**：
1. 检测 Python ≥ 3.10
2. 探测 git（不在 PATH 时尝试常见安装路径）
3. 卸载 site-packages 里可能存在的老 pandaone 版本（避免版本冲突）
4. pip install -e . 本地源码 editable 安装
5. 验证 pandaone 可用（python -m pandaone --version）
6. 调用 doctor.py --fix --persist-path 自动修复剩余问题（依赖、setuptools、指纹、PATH 持久化到 HKCU）
30 秒上手（第一次用请先看这里）/ 30-Second Start
> ⚠️ **包名提醒**：本包在 PyPI 上的名字是 **pandaone-guard**。
> 旧名 **pandax-guard 已弃用**（停在 0.7.4，不再更新，也不再修 bug）——如果你之前装过它，请先卸载：
> pip uninstall pandax-guard && pip install pandaone-guard
MCP 配置（/ claude_desktop_config.json、Cursor MCP 配置）：
然后直接对 AI 说一句话就够了：
> 把 main.py 里的 hi 改成 hello，说明你为什么改。
AI 会**被迫**走审计通道（pandaone_write）：必须填「原因 / 解决什么问题 / 采用什么方法」三件套。合规的改动才被写入 + 自动 git commit + 留痕；不合规的改动被拒绝，同样留痕。
想先手动挡住 AI 的写操作？pandaone lock --root . 把受保护文件设为只读（OS 级，绕过不了）；pandaone unlock --root . 还原。**注意：请以普通用户运行，root 下 OS 权限位对其无效。**
环境诊断（任何时候都能跑）/ Environment Diagnostics (run anytime)
检测 9 个项目 + **自动修复 13 类问题**（pip / git / pandaone 装在 site-packages / pandaone.exe PATH / 指纹污染 / setuptools / 5 个运行时依赖）。
**--fix --persist-path 会做什么**：
- 卸载 site-packages 老版本 → 重装本地源码
- 删除污染的 ~/.pandaone_fp.txt
- 自动 pip install 缺失的运行时依赖
- Windows：用 setx PATH "%PATH%; " 持久化到 HKCU\Environment\Path（新开的 PowerShell 自动看到）
- macOS / Linux：追加 export PATH="..." 到 ~/.bashrc / ~/.zshrc
初始化项目 / Initialize Project
写代码（合规路径）/ Write Code (Compliant Path)
查看审计日志 / View Audit Log
审计历史：每条变更带 reason / problem / approach 三段式凭证
项目状态仪表盘 / Project Status Dashboard
终端版：项目状态 + 最近审计表（CLI 一行命令）
显示 / Displays：项目路径、配置摘要、L1 锁定状态、二进制快照、最近审计、版本指纹等。
Project path, configuration summary, L1 lock state, binary snapshots, recent audits, version fingerprints, etc.
**🆕 Web 实时仪表盘 / Web Real-time Dashboard**:
Web 版：15 条审计记录 · 11 APPROVED / 4 REJECTED · claude-code / cursor / trae 三方协作实时推送