zgsfsec/Full-Chain-Sentinel-System

知攻善防实验室，基于 pi agent harness 改造的授权渗透测试 Agent，带中文 Web 控制台与容器化作业环境。

本项目是攻击性安全工具，只能用于你已获得书面授权的目标。

• 未经授权对他人系统做渗透测试、漏洞扫描、口令破解或入侵，在中国大陆及多数司法辖区属于违法行为（参见《网络安全法》第二十七条，《刑法》第二百八十五条、第二百八十六条、第二百八十七条之二；本段不构成法律意见）。
• 首次进入控制台必须勾选「我承诺只用于授权合法的渗透测试」，承诺与声明的哈希保存在本机配置目录，声明更新或换账号会重新确认。
• Agent 的行为难以完全管控：自动执行模式下模型可以运行任意命令。因使用本项目造成的业务中断、数据损坏、越权访问或其他后果，由使用者自行承担，作者与贡献者不承担任何责任。
• 请在授权范围内、隔离环境中使用；对生产系统测试前先取得书面授权并约定时间窗。

本项目以 MIT 许可发布，不附带任何担保。

• 方法论驱动的渗透流程：侦察 → 枚举 → 漏洞映射 → 验证 → 利用 → 后渗透 → 报告，系统提示强调授权范围、证据留痕与最小侵入。
• 中文 Web 控制台（packages/web）：流式对话与思考过程、工具执行卡片、会话树、文件与子代理弹窗、项目选择。
• 三档执行模式：审批模式（默认，每条 bash 命令可编辑后放行或拒绝）、自动执行、AI 审批（守门员模型逐条判定 ALLOW / BLOCK，判定失败或超时一律放行）。审批链覆盖 bash 与安卓 shell 命令（droid_shell）；frida、抓包、APK 分析与文件面板直接调用容器，不过审批门。
• 容器化作业环境：每个项目一个 Kali 容器，内置侦察、枚举、Web 利用、口令与内网工具；容器网络模式在「设置 → 环境」切换（默认 host）。
• 漏洞中枢：vuln_submit 提交已验证漏洞，必填 CVSS 分数，原始数据包逐字保存，操作员复核留时间线，可按项目导出 Markdown 报告。
• 业务建模与 POC 库：把目标站点还原成 OpenAPI 3.0 文档；Nuclei POC 订阅、检索与引用。
• 安卓设备插件：root 测试机安装自研 DroidBridge APK 主动反连，提供 shell、文件上下行、截屏、logcat、tcpdump 抓包、frida 动态调试与 APK 静态分析。
• OpenAI 兼容端点：支持 vLLM、one-api、new-api 等自建端点，界面直接配置。
• 会话即审计：复用 pi 的 JSONL 会话树，命令、输出与模型决策完整留痕。

要求 Node.js >= 22.19.0。

npm install --ignore-scripts
npm run build:offline  # 后端各包与 coding-agent（不联网，模型目录已入库）
npm run build:web      # Web 控制台与前端资源
npm run start:web

npm run build 只构建后端各包，控制台需要额外的 npm run build:web。

启动后日志里会打印本次的入口地址，形如 http://<地址>:<端口>/<随机串>。默认监听 0.0.0.0，随机入口串与 cookie 校验用于挡扫描器：没有入口串的请求一律返回普通 404，入口串每次启动都变。请在日志里取完整地址访问。

首次访问的流程：

1. 设置控制台密码（scrypt 哈希，保存在本机配置目录）。
2. 阅读并勾选授权使用承诺。
3. 在左侧「模型设置」配置端点（Base URL / API Key / 模型 ID）。

启动参数与环境变量：

CLI 同样可用：

./pi-test.sh --no-env      # 从源码运行 sentinel CLI

本仓库沿用上游 pi monorepo 的分包结构（包名仍是上游的 @earendil-works/*，改名单独进行）：

./test.sh                   # 全部非 e2e 测试
npm run check               # biome + 依赖/导入/入口图检查 + tsc + webui + 浏览器冒烟
npm run build:offline       # 全量构建，不联网、不重生成模型目录

本仓库不跑 CI（只保留发布流程）：提交前请自己跑 npm run check 和 ./test.sh。

单测从包根目录跑：

node "$(git rev-parse --show-toplevel)/node_modules/vitest/dist/cli.js" --run test/<name>.test.ts

packages/ai/src/providers/data/ 是 generate-models 的产物，已固定在版本库里：模型 id 的类型联合体直接由它推导，固定它之后 tsc 和测试不会随厂商轮换模型而漂移（全新克隆也能离线做类型检查）。要更新目录时跑 npm run generate:models（需联网）并提交改动——刷新会改到 .manifest.json 的 generatedAt 时间戳，属正常。发布流程仍会实时刷新，发布产物里的目录是最新的。

作业容器：

docker build -t sentinel:latest docker/

基础镜像与 apt/pip/npm/go 软件源可在控制台「设置 → 环境」配置，也可以在命令行用 --build-arg 覆盖。

控制台：Docker 是硬依赖。每个项目一个 Kali 容器（sentinel:latest），Agent 的 bash 命令在容器内执行（docker exec），项目目录 bind mount 进 /work，容器以 root 运行。容器网络默认 host（容器直接用宿主机网络栈，反向 shell、payload 服务、本地靶场、内网与 VPN 才是真实的），可在「设置 → 环境 → 容器网络」切到 bridge；两种模式都保留 NET_RAW，NET_ADMIN 只在 bridge 模式授予。Docker 检查有阻断项时控制台拒绝 prompt、compact 与持续目标。

但容器只约束命令，不是整体沙箱：控制台与 Agent 进程本身以启动者的用户身份跑在宿主机上，只有命令进容器。

• 审批链只覆盖 bash 与安卓 shell（droid_shell），子代理的 bash 走同一条链；read/edit/write、文件面板、MCP 工具、codemode，以及 frida、抓包、APK 分析等直接调用容器的工具都不过门。工程任务的 bash 另有一套正则黑名单、20 秒超时与 40 条预算，同样不走审批门。
• read/edit/write 直接读写宿主机文件系统，项目目录只是相对路径的基准，绝对路径不受限制；MCP 的 stdio 服务器是宿主机子进程。
• AI 审批（守门员）只判六类破坏性操作，判定失败、超时或无法解析一律放行（fail-open），不是沙箱、也不做数据防泄漏。
• 容器以 root 运行，没有资源上限，也没有 cap-drop / seccomp / read-only；同一项目的所有会话与并发任务共用一个容器。
• 控制台会加载项目目录下的 settings.json、.pi/extensions、AGENTS.md、mcp.json，且没有项目信任确认步骤——不要把来源不可信的工作目录设为项目。

完整边界与配置见 packages/web/README.md。

CLI：沿用 pi 的权限模型，无内建沙箱，工具以当前用户权限在宿主机执行；需要隔离就把 CLI 整个跑进容器（containerization.md 是上游文档，命令与路径名仍是 pi）。

自动执行模式下模型可运行任意命令，持续目标在自动执行下也没有危险命令黑名单，请仅在授权目标与隔离环境中使用；需要无人值守又不愿全放行时用 AI 审批。控制台的登录、随机入口串与授权承诺只用于防误用与防扫描，不构成隔离。

安全问题请通过仓库 Issue 反馈，不要在公开 Issue 里附可直接利用的细节。

本项目是 pi 的衍生作品（fork），不是上游官方项目，与上游团队无关。

上游代码以 MIT 许可发布，版权归 Mario Zechner，许可全文见 LICENSE；本仓库保留该许可与版权声明，并在此基础上加入渗透测试相关的系统提示、Web 控制台、容器化作业环境与安卓设备插件。

• 上游仓库：https://github.com/earendil-works/pi
• 本项目新增部分的版权归本项目作者，同样以 MIT 发布。
• 例外：packages/coding-agent/examples/extensions/doom-overlay/doom/ 是 GPLv2 的 DOOM 编译产物及其对应源码，不属于 MIT，详见 THIRD_PARTY_NOTICES.md。

渗透测试场景在安全服务工作中，通常分为三种 1.Web 渗透 2.微信小程序渗透 3.APP 渗透 至此，我们全链路打通，一个平台畅游所有任务 三端是怎么打通的呢？ 我们要知道我们渗透测试测的是什么？很多人都不明白道理，我们渗透测试过程，90% 的针对服务器后端进行测试的，后端想给我们前端展示，所以想打通三端也只是不同载体的问题。 比如 Web 前端载体就是浏览器， 微信小程序的前端载体就是微信小程序容器 APP 的前端载体就是一些 UI 框架 所以，本质上 Web、小程序、APP，都是一样的。

简单说几个场景怎么用吧， 1.Web 测试 直接输入框使用即可 2.微信小程序 选择预设 Agent 然后自己在 Tscan 这类工具中把微信小程序反编译，点击左下角“附件”上传即可。 3.APP 在左侧安卓设备中配置好你的安卓机器，然后在你的安卓里面安装好对应 APP，然后在对话框中选择“安卓”即可 因为本人想法是更少的工具和上下文，所以，你如果不开“安卓”这个按钮的话，他是不会插入安卓相关的工具调用的、也不会插入相关 prompt

你需要有一台 root 后的设备（虚拟机亦可），并且安装配套的 app 即可

关于手机 root，这里就不再讲解，有兴趣可以去酷安社区逛逛,安卓机为反连主平台，所以你可以将主程序部署在公网服务器。

适用于批量测试环节，指挥官架构，适用于多任务指挥，这个还是测试阶段，自行玩一玩吧。

建议在设置->模型里面再配置一个小模型，比如 qwen,Hook所有 Bash 调用过程，建议用千问的 API 按量付费，不可以用 CodingPlan 模型，因为 CodingPlan 会有速率限制。

https://www.qianwenai.com/models/qwen-flash

采用小模型监管大模型，最大程度上尽量避免对生产环境造成影响。

你可以做一些自己的 Nuclei 的 POC 订阅服务，放进“设置->POC订阅”里面，这种应用场景主要是打 nday ，本来没打算加 Nuclei 固定 POC 的功能的，但是考虑到像 jeecg boot 、若依这种开发框架，的 api 路由自定义功能，还是加了吧。

你只需要在你的远程服务器上定时的把Nuclei 的所有 POC 打包成 zip，然后远程同步即可。

也可以直接同步 Nuclei 官方的 POC

加群的，一定要在“打招呼内容”备注“全链哨兵”。