AI 驱动的全能安全平台(能力包 web/binary/crypto/forensics/misc × 场景轨 ctf/pentest/redteam/research/malware,覆盖 CTF / 渗透测试 SRC / 红队行动 / 逆向 Pwn / IoT 工控车联网研究 / 恶意样本分析),原生 Windows 优先,按能力自动降级 Docker/WSL2。
DESIGN.md— 功能导向参考手册,当前已实施功能的唯一真相源(一级=系统、二级=功能、速览+展开区渐进填充);未实施方向在docs/plans/,实施落地时决策回写它,代码向它对齐。docs/plans/— 方案目录:设计讨论收敛的待实施设计(一方案一文件),走「细化打磨 → 实施」路线;实施落地时决策才回写 DESIGN.md。- 各大文件夹的
CLAUDE.md— 该目录代码的接手指南(本文件末尾的维护约束)。
| 层 | 选型 |
|---|---|
| 核心/后端 | Python 3.11+ / FastAPI |
| 前端 | React + TypeScript + Vite SPA |
| 存储 | SQLite (WAL),经 core API 单一写入口 |
| LLM | 火山引擎 Ark 优先(OpenAI 兼容基类),模型路由 planner/executor/classifier |
启动平台.bat(项目根,双击即用):自动起后端scripts/serve.py(127.0.0.1:8420)并开浏览器。静态优先(desktop-app-shell M2):webui/dist/index.html存在 → 后端同源托管前端(8420 即 WebUI,不起 Vite);无产物 → 回退起前端 Vite(localhost:5173,仅 IPv6)的 dev 全流程(首次自动npm install)。端口已在监听则跳过,各服务独立窗口,日志看对应窗口。启动平台(窗口).bat:桌面窗口模式——pythonw 起serve.py --window(pywebview/WebView2,无控制台黑窗,日志落 logs/serve-window.log)。8420 在跑=attach 附窗(关窗只退自己,可多开),无服务=owner(关最后一窗=优雅停机并落任务现场快照);加载地址自动探测 dist 静态版 > Vite dev > 窗内指引。停止平台.bat:先对 8420 优雅停机(POST /api/admin/shutdown,shutdown 钩子给在跑会话落任务现场快照,等端口释放最多 15s),超时才按端口硬杀;5173 照旧硬杀。- 桌面打包(desktop-app-shell M3):
E:\Miniconda3\python.exe scripts\build_exe.py四步一键(干净 .build-venv 钉版依赖 + PyInstaller onedir + packs/tools/webui.dist 资源随包),产物dist/cyberstrike-pro/(~59MB)双击 exe 即弹窗;config/、workspaces/ 不随包首启自建,敏感凭据绝不进包。 - 启动类 .bat 为 UTF-8(无 BOM)+ CRLF,开头
chcp 65001自举(call 自身重读)以兼容双击时的 GBK 控制台;改动后必须保持 CRLF(LF 会导致 cmd 解析错乱)。
- 每个大文件夹(
core/、packs/、tools/、webui/、workspaces/、docs/及其一级子目录)必须有CLAUDE.md。 - 新建大文件夹时,必须同步创建其
CLAUDE.md(哪怕是占位)。 - 会话中对某文件夹做了实质功能修改(新增模块 / 重构 / 改接口),结束前必须更新该文件夹的
CLAUDE.md——文档更新与代码改动属于同一项工作。 CLAUDE.md只写"接手需要知道的"(职责、入口文件、关键约定、坑);设计推导和决策过程写进DESIGN.md,不重复。超过 80 行必须精简。- 所有文档语言一律中文。
- 黑板所有写操作必须经 core API 单一入口,禁止旁路直写存储。
- 不可信代码只允许在 Docker 容器执行;WSL 信任级 = 宿主机(见 DESIGN.md §7 执行网关)。
- 安全默认值,宁严勿松:未知样本默认按恶意处理(L3 沙箱 + fakenet)。
- Agent 无裸 shell,一切命令经
run(cmd, runtime)网关 + 服务端策略校验。