kyc001/zj-cyber-workbench

真君（ZJ）是一款面向 Windows 的多智能体网络安全运维工作台。项目在 Z3r0 的 FastAPI、React、多 Agent Runtime、证据模型和 Timeline 基础上，增加 Incident、授权范围、风险策略、人工审批、远程运维、变更回滚和 独立验证能力，并通过 Electron 交付桌面产品。 当前仓库处于工程基线阶段：上游代码已迁移，桌面壳、运维领域契约和 SQLite 便携持久化已建立，但业务 API、SSH Transport、Sidecar 正式打包和 正式 Agent Prompt 仍需按团队分工实现。 不要把当前骨架误认为可对生产环境执行变更的正式版本。 ## 架构 ``` Electron Main / Preload / React Renderer | loopback REST + WebSocket | ZJ Core (FastAPI + Agent Runtime) | | | Evidence Policy Execution | | | Timeline Approval SSH / Windows / Portable Tools ``` ## 工作区 - `core/`, `service/`, `model/`, `schema/`, `router/`, `handler/`: 已迁移并适配的 Z3r0 控制面。 - `web/`: 已迁移的 React 工作台；B 负责桌面产品体验及剩余的品牌重塑。 - `desktop/`: Electron Main/Preload 和 sidecar 生命周期骨架。 - `toolpacks/`: 便携的、manifest 驱动的运维和安全工具（由 C 实现）。 - `tests/`: 共享的契约和策略测试；每个所有者在此添加模块测试。 - `docs/role-a-lead.md`: A/组长的职责、关键路径与实施顺序。 - `docs/upstream-migration.md`: 上游逐文件扫描方法、迁移结论和风险。 - `docs/team-handoff.md`: A/B/C/D 接口冻结与交接规则。 - `docs/no-docker-portable-architecture.md`: 无 Docker 与 Portable EXE 的覆盖性架构决策。 - `docs/development-environment.md`: Windows 开发、验证和本地文件规则。 ## 开发 所需基线：Windows 10/11 x64, Node.js 22.12+, pnpm 10, Python 3.12, 和 uv。本项目有意不使用 Docker。 ``` ./scripts/dev.ps1 doctor ./scripts/dev.ps1 install ./scripts/dev.ps1 test ``` 开发服务是特意分开的： ``` ./scripts/dev.ps1 backend ./scripts/dev.ps1 web ./scripts/dev.ps1 desktop ``` 后端使用嵌入式 SQLite 和本地 LightRAG 存储。将 provider secrets 放入基于 `.env.example` 建立的、被 git 忽略的 `.env` 文件中。首次启动会创建 `.zj/config.json`； 切勿提交 `.env`、`.zj/`、数据库、日志或 artifacts。原有的 `/Z3r0/` 检出已被完全忽略。 ## 团队归属 | 负责人 | 边界 | | --- | --- | | A | Runtime, Incident, Scope, Policy, Approval, state, persistence, API, Timeline | | B | Electron, React workspace, sidecar UX, terminal UI, packaging | | C | Transport, SSH/SFTP, PowerShell, portable process execution, Toolpack | | D | Agent prompts, context, evaluations, cross-module tests, reports, release quality | ## 致谢 ZJ 部分基于 [Z3r0](https://github.com/yv1ing/Z3r0) 的架构和源代码，该项目最初由 yv1ing 创建，并 在 MIT 许可证下分发。ZJ 是一个独立的衍生项目； 不暗示有任何上游认可。

标签：AI合规, AV绕过, Electron, FastAPI, MITM代理, PE 加载器, 多智能体, 库, 应急响应, 网络安全运维, 远程运维, 逆向工具