bluechips-zhao / DITING

# 谛听 DITING
LLM 驱动的自主渗透测试工作台 · Go + Next.js + PostgreSQL
当前公开版本：**2.5.0**。本版提供 Windows amd64 安装包，以及应用与 PostgreSQL 的 Docker Desktop Linux amd64 离线镜像和部署包。首次安装为空白业务状态；界面截图中的合成记录不会导入安装。
下载发行版 · 界面截图 · 开始使用
基于 ARTEX 改造，保留资产图、任务探索、多代理协作、流量证据和人工审批，增加预算、证据关系、报告版本、完整导出与加密备份恢复。前端参考 Amicro，支持深浅主题与移动端。仅用于拥有或明确获得授权的目标。
**首次使用为空白业务状态。** 源码和发行包不包含演示数据库、任务、资产、漏洞、对话、模型配置、API Key 或管理员密码。首次启动需要自己的 PostgreSQL、登录密码和模型配置。内置 Agent、工具定义、提示词、拦截规则是功能默认项，会自动初始化。
## 界面预览
以下截图中的模拟记录仅展示界面，**不会随安装导入**。发布源码不提供运行时演示数据或模拟登录。
| 浅色工作台 | 深色工作台 |
| --- | --- |
| | |
| 登录页 | 手机工作台 |
| --- | --- |
| | |
## 主要功能
- **任务与多代理**：规划、执行、对话、报告代理；模板、目标、约束、运行状态、模型配置链与纠偏入口。
- **预算与收尾**：token/工具预算、保守预留、耗尽后的收尾、有限默认轮次与无进展保护。
- **资产与范围**：企业/任务资产、范围与拦截、筛选、完整 CSV/JSON 导出、批量挂接、ScopeSentry 同步。
- **发现与证据**：请求/响应绑定、重复关系、复测、报告重生成作业、证据版本和历史报告。
- **会话与流量**：搜索与完整历史导出；流量录制、HAR/CSV 和原始报文包导出。
- **系统与恢复**：LLM、MCP、技能、自定义工具、通知、加密备份、恢复预览、隔离恢复和迁移状态。
约束提供代理上下文；工具拦截规则独立执行。token 预算是本地用量账本，不是供应商金额账单。
## 开始使用
### Windows 发行包
1. 从 Releases 下载 Windows amd64 zip，解压到新的目录。
2. 准备 PostgreSQL 16 或更新版本。可连接自己的数据库，或仅用 Docker 创建空库：
 [code] 
 将 `YOUR_DATABASE_PASSWORD` 换成自己的强密码。
3. 2.4.0 起可直接运行 `start.bat`，在本机数据库向导填写连接信息。也可复制 `config.example.json` 为 `config.json` 手动配置；示例为 `127.0.0.1:5433`、用户/数据库 `diting`，密码必须自行填写。`skill_dir` 留空使用程序旁的 `skills/`。
4. 运行 `start.bat`，或在 PowerShell 中：
 [code] 
5. 打开 本地工作台。2.4.0 起数据库未配置或连接失败时显示本机向导；连接测试不创建数据库、不改动配置，保存成功后同一进程进入密码初始化。设置至少 8 位登录密码，随后完成环境检查和模型配置；模型保存不发起供应商请求。可稍后从「系统配置 → 初始化与环境检查」返回向导，再创建企业、资产、任务或对话。
数据库初始化向导（隔离验收实例，无业务数据或凭据）：
向导仅绑定回环地址，并检查本机来源、Host、Origin 和一次性启动令牌。文件配置修改保留原文件备份；已有配置 JSON 无效时拒绝覆盖。`ARTEX_PG_DSN` 已设置时，只允许重试该连接，不保存会被环境变量覆盖的文件配置。默认应用监听为 `127.0.0.1:8787`；需要其他监听地址时显式指定 `-addr`。
发行包内部可执行文件名保留 `artex.exe`，产品品牌为 DITING。启动脚本也支持源码构建的 `diting.exe`。原有 `ARTEX_*` 环境变量保留兼容名称，`ARTEX_PG_DSN` 优先于配置文件；如之前设置过，请确认它指向预期数据库。
本次首发提供 Windows amd64 包。其他平台可从源码编译；跨平台 CI 的结果以对应运行记录为准。
### 应用与数据库 Docker 部署（2.5.0）
已在 Windows Docker Desktop 的 Linux amd64 引擎实际验证空卷安装、登录、持久化重建、升级、加密备份与隔离恢复；本版通过 GitHub Release 提供离线镜像，不提供容器镜像仓库地址；独立 Linux 宿主机、macOS 和其他架构未在本版实际验收。使用 Docker Desktop 的 Linux 引擎或 Linux Docker Engine，可从源码构建：
 [code] 
从 2.5.0 发行页 下载 Docker 部署 ZIP、应用镜像 TAR 和 PostgreSQL 镜像 TAR。将部署包解压，在含 `docker-compose.yml` 的目录运行；镜像路径按实际保存位置填写：
 [code] 
此方式不需要构建或下载已提供的镜像；首次安装仍需用户自行设置密码。镜像不包含数据库、业务数据或模型凭据。Docker 部署包与两个镜像归档均需保留；备份工具的宿主机 Python 依赖需另行安装，不承诺该依赖安装过程离线可用。
打开 `http://127.0.0.1:8787` 初始化登录密码和模型。数据库自动创建空库；模型、任务、企业、资产、发现和对话均不预置。Compose 将 PostgreSQL 固定为 16.15，等待数据库健康后启动应用，应用健康检查也验证数据库连接。数据库不发布宿主端口；应用与录制代理仅映射本机 `8787/8788`，可通过 `.env` 更改端口。
应用使用 UID/GID 10001 运行。`ARTEX_HOME=/var/lib/diting/runtime` 保存配置、`jwt.key` 与 `secrets.key`；工作区在独立 `/var/lib/diting/data` 卷，避免密钥出现在可浏览工作区。技能及工具用户目录分别持久化，首次空技能卷从镜像初始化，重建后保留用户修改。`ARTEX_HOME` 必须使用绝对路径；Windows 未设置时保留原程序目录行为，`ARTEX_CONFIG` 仍可单独指定配置文件。
固定项目名 `-p diting` 保证重建继续使用同一批卷。`docker compose -p diting down` 保留卷；不要在升级时加 `-v`。容器中的更新入口只用于检查版本；应用升级应先停机完整备份，再构建或载入目标镜像并重建应用。回退旧版需要恢复升级前完整备份到新库和新卷。Docker 备份恢复操作说明介绍完整操作及限制。验收使用隔离测试数据，没有真实模型或目标调用。
遇到部署故障时，先查看服务状态和近期日志：
 [code] 
- 构建依赖下载超时：检查宿主机及容器访