fionaadrelia7-Slave/caesar-bundle

## 🍰 可爱的小工具箱 🍰 你以为这只是一个简单的脚本？哦亲爱的，不是的！💅🏻 这个 bundle 是一个庞大的互联生态系统。点击下方来偷看一眼！👀

🎀 1. qb（终极命令桥接）

这不仅仅是一个简单的桥接；它是你浏览器的控制中心。它使用 JSON envelopes、CDP 和 IPC 与 qutebrowser 进行通信。

• qb CLI：发送命令的主可执行文件。
• qb-mcp-server.py：一个专用的 Model Context Protocol (MCP) 服务器，让你的 AI 能够直接命令浏览器。🤖
• qb_cdp_smoke & qb_cdp_smoke2：可爱的小型自动化冒烟测试，确保你的 CDP 连接完美运行。
• qb-skill：一个技能库安装程序，用于导入并索引你的 agent skills。

🧠 2. caesar-osint-skill（行动的大脑）

这就是神奇方法论所在的地方。把这个放进 Claude Code，你的 AI 瞬间就会成为一名大师级调查员。

• SKILL.md：教义规则手册，包含严格的 12 阶段 OSINT 方法论。
• references/：14 份详细的参考文档，作为 AI 的知识库。
• workflows/：4 个针对特定情报收集场景的自动化 JS workflows。
• caesar-vision/：一个专门的多模态子技能，专为审查和分类来自 porn-harvester 目录的缩略图而设计！📸

📓 3. caesar-suite（你的私人侦探笔记本）

管理案件绝对最佳的方式。它将所有内容组织到一个 DuckDB 数据库中，让你永远不会丢失任何一条发现。

• bin/caesar：用于管理案件、entities、edges 和事件的主 CLI 工具。
• misc/caesar-mcp-server.py：一个 MCP server，让你的 AI 能够直接读取和写入你的案件文件。
• misc/caesar-url-handler：直接从你的浏览器处理自定义的 caesar:// URL！
• src/ & docs/：支持整个套件的完整 Python 库（caesar_lib），具有漂亮的 Excalidraw 思维导图导出功能。🎨

✨ 4. qute-caesar（全场瞩目的明星）

我们不能仅仅使用一个普通的浏览器。我们拿来了 qutebrowser v3.7.0 并让它变得隐蔽且强大。

• patches/：一系列应用于浏览器源码的海量自定义补丁。它了解锁了标签页内终端、基于 Unix sockets 的 RPC、高级 stealth modes 以及闪电般的 FTS5 历史搜索。
• bin/qute-caesar：带有 CDP 自动回退功能的自定义启动器。
• bin/qute-tor：一个专门的启动器，通过 Tor 静默路由你的所有流量（当你需要成为一个幽灵时非常完美 👻）。

🎬 5. porn-harvester（异步归档器）

一个高度专业化的、异步的 multi-tube 视频归档器。它完全独立于 OSINT 套件运行，但又能完美地补充它。

• porn_harvester/：核心应用程序，利用 arq workers 和一个 Redis queue。
• Adapters：13 个自定义 tube adapters，用于安全地抓取和采集媒体。
• seeds.example.toml：你用于设置种子查询的可爱小模板。
• DuckDB Catalog：所有采集到的元数据都被整齐地存储在 DuckDB 中，caesar-vision 技能会使用它来执行 AI 缩略图审查。🍒

## 💌 魔法是如何连接的 💌 这是关于架构如何流转的绝对内幕！☕️ ``` graph TD %% 🧠 AI Intelligence Layer subgraph LayerAI [🧠 AI Intelligence Layer] A[🌸 Claude Code Agent] SKILL[📜 caesar-osint-skill] VISION[📸 caesar-vision] WORKFLOWS[⚙️ Automated JS Workflows] A -.->|Loads| SKILL A -.->|Loads| VISION A -.->|Executes| WORKFLOWS end %% 🌉 Command & Control Bridge subgraph LayerBridge [🌉 Command & Control Bridge] MCP_QB[🔌 qb-mcp-server.py] MCP_CAESAR[🔌 caesar-mcp-server.py] QB[🎀 qb CLI] CAESAR_CLI[🎀 caesar CLI] A -->|MCP Protocol| MCP_QB A -->|MCP Protocol| MCP_CAESAR MCP_QB -->|Triggers| QB MCP_CAESAR -->|Triggers| CAESAR_CLI end %% 📓 OSINT & Case Management Layer subgraph LayerData [📓 Data & Case Management] SUITE[📓 caesar-suite Python Lib] DUCK_CASE[(🦆 Case DuckDB)] EXCALI[🎨 Excalidraw Mindmap] CAESAR_CLI -->|Calls| SUITE SUITE -->|Read and Write| DUCK_CASE SUITE -.->|Generates| EXCALI end %% 🌐 Browser & Stealth Layer subgraph LayerBrowser [🌐 Browser & Stealth Layer] QUTE[✨ qute-caesar Patched] TOR[👻 qute-tor Tor Routed] FTS[🔍 FTS5 History Index] QB -->|CDP and caesar-rpc| QUTE QB -->|CDP and caesar-rpc| TOR QUTE -->|Writes| FTS TOR -->|Writes| FTS end %% 🎬 Harvester Layer subgraph LayerHarvester [🎬 Video Harvesting Pipeline] PH[🎬 porn-harvester] ARQ[⚙️ arq Workers] REDIS[(🔴 Redis Queue)] DUCK_MEDIA[(🍒 Catalog DuckDB)] ADAPTERS[🔌 13 Tube Adapters] PH -->|Enqueues Tasks| REDIS REDIS -->|Dispatches| ARQ ARQ -->|Uses| ADAPTERS ADAPTERS -->|Saves Metadata| DUCK_MEDIA end %% ✨ Cross-layer Interactions VISION -.->|Queries Thumbnails| DUCK_MEDIA SKILL -.->|Defines Rules for| QUTE ``` - **`qb`** 控制着浏览器。当与 `qute-caesar` 搭配使用时，它真正大放异彩，并获得了超快的 `caesar-rpc` 路径。 - **`caesar-suite`** 将你所有的内幕（发现、证据、entities）在 DuckDB 中保持得整整齐齐。 - **`caesar-osint skill`** 是大脑。把它放进你的 Claude Code skills 目录中！👩🏻‍💻 - **`qute-caesar`** 是隐蔽的浏览器。 - **`porn-harvester`** 是独立的异步 worker。它的目录由 `caesar-vision` 技能审查！✨ ## 🛠️ 让我们把它设置好！（分步指南） 🛠️ 拿杯咖啡 ☕️，打开你的终端，让我们开始安装一切吧！ - [ ] **第 1 步：基础：浏览器优先** 🌐 让我们安装打过补丁的浏览器，以解锁所有隐蔽功能。 cd qute-caesar ./install.sh ~/projects/qutebrowser-caesar # 按照 qute-caesar/README.md 中的构建步骤操作！ install -Dm755 bin/qute-caesar ~/.local/bin/qute-caesar - [ ] **第 2 步：桥梁：`qb` CLI** 🌉 现在我们设置与浏览器通信的工具。 cd ../qb install -Dm755 qb ~/.local/bin/qb install -Dm755 qb_cdp_smoke ~/.local/bin/qb_cdp_smoke install -Dm755 qb_cdp_smoke2 ~/.local/bin/qb_cdp_smoke2 install -Dm755 qb-mcp-server.py ~/.local/bin/qb-mcp-server.py # 验证它是否能工作！✨ qb --help - [ ] **第 3 步：笔记本：`caesar-suite`** 📓 是时候整理我们的案件文件了！ cd ../caesar-suite ln -sf "$(pwd)/bin/caesar" ~/.local/bin/caesar install -Dm755 misc/caesar-mcp-server.py ~/.local/bin/caesar-mcp-server.py install -Dm755 misc/caesar-url-handler ~/.local/bin/caesar-url-handler install -Dm644 misc/caesar-handler.desktop ~/.local/share/applications/caesar-handler.desktop # 轻轻地更新你的桌面数据库~ 🌸 update-desktop-database ~/.local/share/applications/ 2>/dev/null || true # 链接 python 库！ mkdir -p ~/.local/lib/python ln -sf "$(pwd)/src/caesar_lib" ~/.local/lib/python/caesar_lib - [ ] **第 4 步：大脑：AI Skills** 🧠 让你的 Claude Code 变得超级聪明！ mkdir -p ~/.claude/skills/caesar-osint ~/.claude/skills/caesar-vision ~/.claude/workflows cp -r caesar-osint-skill/SKILL.md caesar-osint-skill/references ~/.claude/skills/caesar-osint/ cp -r caesar-osint-skill/caesar-vision/* ~/.claude/skills/caesar-vision/ cp caesar-osint-skill/workflows/*.js ~/.claude/workflows/ - [ ] **第 5 步：可选：`porn-harvester`** 🍒 仅在你需要视频编目和视觉 pipeline 时才需要！ cd ../porn-harvester uv sync # 使用 uv 顺利安装依赖项 ✨ cp seeds.example.toml seeds.toml # 是时候自定义你的 seeds 了！ # 编辑你的 seeds.toml，然后启动 worker！ make worker & ## 🧪 冒烟测试（成功了吗？） 🧪 让我们做一个快速的氛围检查，确保一切都完美运行！ ``` # 在后台启动 browser！ qute-caesar --temp-basedir & # 测试 bridge qb cdp-smoke qb open https://example.com qb dom-query h1 qb screenshot /tmp/test_cute.png 📸 # 启动一个 cute little demo case！ caesar case new --slug demo --title "smoke test" caesar entity add --case demo --type person --name "Test Subject" caesar mindmap render --case demo --out /tmp/demo.excalidraw 🎨 ``` ## 🔒 隐私与安全检查 🔒 以下是在分享前进行脱敏处理的内容： 1. 🏡 **路径**：所有硬编码的 home 路径都被替换为安全的 `Path.home()` 或 `~`。 2. 🕵🏻‍♀️ **身份**：将 `SKILL.md` 中的身份引用中和为仅仅是 `Operator`。 3. 🔑 **机密**：绝对没有发布任何 `.git` 历史、DB 文件、env variables 或 keys！ 4. 🍒 **采集器**：不包含任何 caches、logs 或媒体文件。只有一个经过净化的 `seeds.example.toml` 模板！ 5. 🤖 **署名**：Patch commits 保留了一个可爱的中性 `Co-Authored-By: Claude` 尾注。 如果你 ever 想去掉 Claude 的共同作者标签，只需运行以下命令： ``` cd qute-caesar/patches sed -i '/^Co-Authored-By: Claude/d' *.patch ``` ## 📜 兼容性与许可证 📜 **它在哪里运行？** - 🐧 **Linux**（在 Arch / CachyOS 上测试，Kernel 7.x） - 🐍 **Python** 3.10+（对于 `qb`）和 3.11+（对于 `caesar-suite`） - 🌐 在 Linux 和 macOS 上完美运行！（Windows 未测试，抱歉宝贝们 🥺）。 **许可证：** - *qutebrowser patches* -> GPL-3.0-or-later - *qb* -> GPLv3 spirit - *caesar-suite* -> Source-available - *porn-harvester* -> Source-available（在运行此工具之前，请核实当地法律！⚖️） 祝你调查愉快，保持隐蔽，并且保持可爱！💕✨

标签：AI辅助, ESC4, OSINT, Python, 实时处理, 搜索引擎查询, 数据泄露, 无后门, 浏览器自动化, 逆向工具