bluechips-zhao/DITING

LLM 驱动的自主渗透测试工作台 · Go + Next.js + PostgreSQL

当前发行版本：2.4.0。提供 Windows amd64 安装包和源码；完整应用容器部署不属于本版交付范围。

下载发行版 · 界面截图 · 开始使用

基于 ARTEX 改造，保留资产图、任务探索、多代理协作、流量证据和人工审批，增加预算、证据关系、报告版本、完整导出与加密备份恢复。前端参考 Amicro，支持深浅主题与移动端。仅用于拥有或明确获得授权的目标。

首次使用为空白业务状态。 源码和发行包不包含演示数据库、任务、资产、漏洞、对话、模型配置、API Key 或管理员密码。首次启动需要自己的 PostgreSQL、登录密码和模型配置。内置 Agent、工具定义、提示词、拦截规则是功能默认项，会自动初始化。

• 数据库初始化、环境检查和模型配置向导；保存模型不自动调用供应商。
• 运行凭据加密存储，独立凭据密钥随加密备份恢复。
• 登录失败限速、改密后旧会话失效及持续 SSE 鉴权。
• 首次业务列表为空，不包含模型密钥、运行数据库或演示记录。

升级与回退请阅读下方备份说明。

以下截图中的模拟记录仅展示界面，不会随安装导入。发布源码不提供运行时演示数据或模拟登录。

浅色工作台	深色工作台

登录页	手机工作台

• 任务与多代理：规划、执行、对话、报告代理；模板、目标、约束、运行状态、模型配置链与纠偏入口。
• 预算与收尾：token/工具预算、保守预留、耗尽后的收尾、有限默认轮次与无进展保护。
• 资产与范围：企业/任务资产、范围与拦截、筛选、完整 CSV/JSON 导出、批量挂接、ScopeSentry 同步。
• 发现与证据：请求/响应绑定、重复关系、复测、报告重生成作业、证据版本和历史报告。
• 会话与流量：搜索与完整历史导出；流量录制、HAR/CSV 和原始报文包导出。
• 系统与恢复：LLM、MCP、技能、自定义工具、通知、加密备份、恢复预览、隔离恢复和迁移状态。

约束提供代理上下文；工具拦截规则独立执行。token 预算是本地用量账本，不是供应商金额账单。

1. 从 Releases 下载 Windows amd64 zip，解压到新的目录。

2. 准备 PostgreSQL 16 或更新版本。可连接自己的数据库，或仅用 Docker 创建空库：

   docker run -d --name diting-postgres -p 127.0.0.1:5433:5432 -e POSTGRES_USER=diting -e POSTGRES_PASSWORD=YOUR_DATABASE_PASSWORD -e POSTGRES_DB=diting -v diting-pgdata:/var/lib/postgresql/data postgres:16

   将 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 中：

   .\start.bat -addr 127.0.0.1:8787 -proxy 127.0.0.1:8788

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 的结果以对应运行记录为准。

需要 Go 1.26.3 或更新版本、Node.js 22、npm 和 PostgreSQL。

git clone https://github.com/bluechips-zhao/DITING.git
cd DITING
.\build.bat
Copy-Item config.example.json config.json
# 编辑 config.json 后启动
.\start.bat -addr 127.0.0.1:8787 -proxy 127.0.0.1:8788

Windows 可分发 zip：

powershell -ExecutionPolicy Bypass -File scripts/package-release.ps1 -Version 2.4.0

打包脚本按固定文件清单组装，不复制配置、JWT 密钥、数据库、日志或工作区文件；输出到 dist/，拒绝覆盖已有同版本产物。

Linux/macOS 需要 Bash、rsync；打包还需 zip：

./build.sh --target linux/amd64
cp config.example.json config.json
# 编辑 config.json 后启动
./dist/artex-linux-amd64/artex -addr 127.0.0.1:8787 -proxy 127.0.0.1:8788

后端 go run ./cmd/artex；另一终端进入 web，执行 npm ci、npm run dev -- --port 5173。前端 API 默认反代后端 8787。未配置模型时没有预置模型，也不会自动调用供应商。开发指南 记录代码入口与配置优先级。

• 业务和模型凭据保存在自己的 PostgreSQL；工作区与录制文件在应用数据目录。JWT 签名密钥首次运行随机生成。
• 不提交或转发 config.json、.env、jwt.key、secrets.key、data/、日志、抓包和备份；源码忽略规则覆盖这些文件。
• 制作一致备份前停止任务、应用和代理；恢复使用新的空数据库与新的数据目录。
• 2.4.0将模型密钥、搜索密钥、代理地址、模型入口、通知配置及 MCP 参数/环境/入口加密存入数据库，独立密钥为程序目录中的 secrets.key（打包程序所在目录；go run 时为当前工作目录）。ARTEX_CONFIG 只决定配置 JSON 的位置，不改变密钥位置。已有明文凭据在启动时事务迁移；缺失、损坏或错误的密钥会中止启动，保留数据库和原文件。
• 加密密钥独立于 jwt.key；改密码不会更换凭据加密密钥。备份必须使用 -IncludeLocalCredentials -EncryptionKey .\secrets.key 一起封装原密钥，或用 -KeyStoredSeparately 明确声明已另行备份。包含密钥时工具会验证它能解密数据库凭据。恢复后将 local/secrets.key 放回程序目录，不能放入可浏览的工作区。
• 加密保护数据库静态凭据；应用运行时仍需解密使用。本地数据库连接配置和运行日志不属于上述数据库字段加密范围，仍需保管配置目录。
• 从 2.3.x 升级至 2.4.0 前，先用旧版本备份工具制作完整加密备份，并保留旧程序、数据库连接配置和 JWT 密钥。2.4.0 会加密旧数据库中的凭据；2.3.x 不能直接读取这些密文。因此退回 2.3.x 时，需要恢复升级前的数据库与工作区备份，不能只替换旧二进制。恢复使用新的空库和新目录，保留原数据库以便核对。
• 连接已有数据库会保留原有记录并执行幂等迁移。“首次为空白”指新建数据库，不会清空旧数据库。
• 下载包可与发行页 SHA256SUMS 对比：Get-FileHash .\artex-2.4.0-windows-amd64.zip -Algorithm SHA256。

遵守 AGPL-3.0，保留 ARTEX 源码来源及版权。修改后通过网络向其他用户提供服务时，按许可证提供对应源码。

字体和前端模板许可见 第三方说明。UI 参考 Amicro，产品布局与流程按 DITING 调整。

常规回归使用本机模拟供应商，不调用真实 LLM。每次运行创建新的隔离 PostgreSQL 数据库，设置 ARTEX_PG_DSN 后执行 go test -p 1 -count=1 ./... 和 go vet ./...；不得连接正在使用的业务数据库。共享数据库的各包顺序执行，避免启动迁移与夹具清理互相干扰。

前端在 web/ 执行 npm test、npx tsc --noEmit 和 npm run build:static。PR 工作流额外检查发行包的私有文件排除和嵌入前端的首次安装；Windows 作业验证守护启动脚本的升级、重启和回滚。工作流不发布版本。

打包后运行 python scripts/check-package.py <发行包.zip>。空库检查通过 DITING_FRESH_PG_DSN 明确指定全新隔离数据库，再执行 python scripts/run-fresh-install.py <程序路径> <版本号>；脚本复制程序到临时目录、移除继承的模型密钥，检查密码初始化、接口鉴权与空业务列表，然后停止测试程序。数据库向导回归另用全新本地测试库（名字须为 diting_setup_<唯一后缀>），设置 DITING_SETUP_PG_DSN，执行 python scripts/run-setup-install.py <程序路径>。它验证缺失配置、失败/成功连接测试、同进程启动、密码初始化、环境鉴权、空业务状态和模型保存/激活，使用不可用的本机模型入口，不发送模型测试请求。真实模型验收独立人工执行并设置预算。