diff --git a/README.md b/README.md
index c26378a..7b116f0 100644
--- a/README.md
+++ b/README.md
@@ -1,88 +1,136 @@
+
+
# ARTEX
-**A**gentic **R**ed-**T**eam **E**xploration and e**X**ecution — AI 自主渗透测试系统，以 [Norma](https://github.com/Autumn-27/Norma) 为内核。
+AI 自主渗透测试系统（Go 后端 + Next.js 前端）
-独立 Go 模块（`github.com/Autumn-27/artex`，依赖 Norma），把存储 /
-agent / 安全边界 / 流量 / 报告与 shadcn/ui 前端关在自己模块里，保持 Norma 零依赖。
+🌐 **在线 Demo**： [https://artex-demo.vercel.app/](https://artex-demo.vercel.app/)
-## 运行
+
-**探索由真实 LLM agent 驱动，必须配置 provider**（无 key 时建任务只生成根/目标节点，引擎空闲、不探索）：
+---
+
+## 截图预览
+
+> 完整交互见[在线 Demo](https://artex-demo.vercel.app/)。
+
+| 仪表盘（总览 / Token 消耗 / 活动流） | 任务列表 |
+| :---: | :---: |
+|  |  |
+
+| 任务 · 执行过程（会话 / 工具调用） | 探索链路 |
+| :---: | :---: |
+|  |  |
+
+| 发现 | 资产 |
+| :---: | :---: |
+|  |  |
+
+| 流量录制 | 人在环路对话 |
+| :---: | :---: |
+|  |  |
+
+| Agent 管理 | LLM 配置 |
+| :---: | :---: |
+|  |  |
+
+| 拦截审批 | 后端日志 |
+| :---: | :---: |
+|  |  |
+
+
+---
+
+## 安装
+
+> 依赖数据库 **PostgreSQL**；探索需配置 **LLM**（`ANTHROPIC_API_KEY` 或 `OPENAI_API_KEY`，也可在 UI 里配）。
+
+### 方式一：一键安装脚本（推荐）
```bash
-export ANTHROPIC_API_KEY=sk-... # 或 OPENAI_API_KEY
-# 可选：ARTEX_LLM_PROVIDER / ARTEX_LLM_MODEL / ARTEX_LLM_BASE_URL
-# 可选：ARTEX_LLM_PROXY=socks5://127.0.0.1:1080 # LLM 出站代理(http/https/socks5)；
-# 也可在 UI 的 LLM 配置页填写；留空则回退 HTTP_PROXY/HTTPS_PROXY 环境变量
+git clone https://github.com/Autumn-27/ARTEX.git
+cd ARTEX
+./install.sh
```
-### 开发模式（热更新）
+脚本会：检测 / 自动安装 Docker → 让你选 **① 全部 Docker** 或 **② 本地编译运行**：
-后端与前端分开跑，前端 `next dev` 有 HMR、`/api` 反代到后端：
+- **① 全部 Docker**：填一个 Postgres 密码（可回车随机）→ 自动写 `.env` → `docker compose up -d`。
+- **② 本地运行**：选数据库（连已有 / 用 Docker 起一个）→ 生成 `config.json` → `go` 编译内嵌单二进制 → 启动。
+
+装好后打开 **http://localhost:8787**（首次进入 `/setup` 设置管理员密码）。
+
+### 方式二：Docker Compose（手动）
```bash
-./dev.sh # 后端(:8787) + 流量代理(:8788) + 前端 next dev(:5173) → http://localhost:5173
-# 或手动：
-go run ./cmd/artex -addr :8787 -proxy :8788 # 不内嵌前端；并发 work agent 数在「系统设置」里配置(默认3)
-cd web && npm run dev
+git clone https://github.com/Autumn-27/ARTEX.git
+cd ARTEX
+cp .env.example .env # 填 POSTGRES_PASSWORD、可选 ANTHROPIC_API_KEY
+docker compose up -d # 拉取 autumn27/artex 镜像 + postgres
+# → http://localhost:8787
```
-### 单二进制（前端内嵌，一个进程一个端口）
+镜像已含常用工具（ripgrep/curl/vim/npm/nmap…）；`./skills` 与 `./data` 以绑定挂载持久化。
-前端静态导出后用 `//go:embed` 打进二进制，前端页面 + `/api` 同端口，运行时无需 Node：
+### 方式三：下载预编译二进制（Releases）
+
+到 [Releases](https://github.com/Autumn-27/ARTEX/releases) 下载对应平台的 zip，解压后得到 `artex` + `skills/` + `config.example.json`：
```bash
-cd web && npm run build:static # 静态导出 → web/out
-cp -r web/out ../server/webui/dist # 拷进内嵌目录（已 gitignore）
-cd .. && go build -tags embedui -o artex ./cmd/artex
-./artex # 打开 http://localhost:8787
+cp config.example.json config.json # 填好 database 连接
+./artex # → http://localhost:8787
```
-> 不带 `-tags embedui` 的普通 `go build` / `go run` 不内嵌前端（走开发模式）。
-> `server/webui/dist/` 与产出的 `artex` 均已在 `.gitignore`，不进仓库。
-
-### 纯静态部署（可选，扔进 nginx）
-
-`web/out/` 是一个纯静态站点，可直接放进 nginx web 根目录；此时需把 `/api/*` 反代到 Go 后端（`:8787`）。
-
-构建：`go build ./...`、`cd web && npm run build`。测试：`go test ./...`。
-
-## 已实现（覆盖设计文档 P0–P6）
-
-**后端（Go）**
-
-- `graph/` — **双 SQLite 图**：资产图 `assets.db`（跨任务共享）+ 探索图 `task-.db`。
- node+edge + anchors（跨图承诺键）+ coverage（行级 CAS + 租约）；内容寻址稳定 ID +
- 幂等 upsert；URL 模板化；ATTACH 跨图；**资产 GC**（P5）。
-- `traffic/` — **go-mitmproxy 内嵌代理** + 可浏览文件树（host/method/模板/时间分桶/交换目录）
- + sqlite 旁路索引（分页查询）+ 内容寻址 blob 仓。全量、明文、只记目标 HTTP（§10）。
-- `guard/` — **安全边界**（P1）：scope-as-code（解析 Bash 实参 host/URL/CIDR，越界拒绝）、
- 破坏性/外泄门控、审计日志、**Observer 失败归因**（G5，PostToolUse 分类 blocked/error）。
- RoE 支持热改（mutex 保护，运行中收紧即时生效）。
-- `agent/` — **真实 LLM agent**（接 agent-core）：
- - **规划者**（P2）：事件驱动（图变化→去抖动→唤醒），读探索路线 + 工具查资产，**自行判断目标达成**
- （`list_goals`/`prove_goal`，把证明目标的发现连到目标节点并标 met，非规则判定），生成意图入 frontier。
- - **work agent**（P3）：claim 意图 → Bash 跑 Kali 工具（走代理）+ 图写回工具，Guard 门控，
- **tradecraft 记忆**（G4）。
- - **主 agent**（P3）：人在环路对话，注入 hint→规划者 / 直注高优意图。
- - **RoE 编译器**（P6）：自然语言授权 → scope 规则（LLM，含正则兜底）。
-- `report/` — **报告生成**（P5）：覆盖矩阵 + 证据链 → Markdown。
-- `server/` — 事件驱动引擎（**纯 LLM，无模拟**；无 provider 则空闲）+ JSON API（任务、资产、
- 探索图、frontier、覆盖、发现、流量、scope、审计、报告、chat、gc）。探索链路边由 agent 经工具织成。
-
-**前端（shadcn/ui + React + Next.js + Tailwind）** — 实时控制台：
-创建任务、统计卡 + 引擎模式徽章、发现、覆盖矩阵热力、资产图、意图队列、
-**人在环路对话**、**流量记录**、**安全边界（scope/RoE 编译/审计/失败归因）**、**报告**。
-
-## 测试
+### 方式四：从源码编译单二进制
+```bash
+# 1) 前端静态导出
+cd web && npm ci && npm run build:static && cd ..
+# 2) 拷进内嵌目录
+cp -r web/out server/webui/dist
+# 3) 编译（-tags embedui 才内嵌前端）
+CGO_ENABLED=0 go build -tags embedui -o artex ./cmd/artex
+./artex
```
-go test ./graph/ ./guard/ -v
+
+---
+
+## 配置
+
+**数据库**（`config.json`，或用环境变量 `ARTEX_PG_DSN` 覆盖）：
+
+```json
+{
+ "database": {
+ "host": "127.0.0.1", "port": 5432,
+ "user": "artex", "password": "yourpass",
+ "dbname": "artex", "sslmode": "disable"
+ }
+}
```
-覆盖：稳定 ID、模板化、幂等 upsert + 邻接、覆盖 CAS、frontier claim、scope 越界拦截、破坏性门控。
-## 后续 / 经 MCP 接入
+**LLM**：`export ANTHROPIC_API_KEY=sk-...`（或 `OPENAI_API_KEY`），也可在 UI 的「LLM 配置」页填写。
+可选：`ARTEX_LLM_PROVIDER` / `ARTEX_LLM_MODEL` / `ARTEX_LLM_BASE_URL` / `ARTEX_LLM_PROXY`。
-- **OAST 带外**（G2）、Kali 专用工具等经 MCP server 接入 work agent（`Worker.extraTools` 是接入点，
- `agent-core/mcp` 的 stdio/进程内 server 产出的 CoreTool 直接塞入）。
-- 真实工具执行需 Kali 环境 + 代理 CA 信任（`data/traffic/_ca`）。
+**并发**：每个任务的 work agent 数在「系统设置」里配置（默认 3）。
+
+**常用参数**：`./artex -addr :8787 -proxy :8788`（`-addr` 前端+API，`-proxy` 流量录制代理）。
+
+---
+
+## 开发
+
+```bash
+./dev.sh # 后端(:8787) + 流量代理(:8788) + 前端 next dev(:5173) → http://localhost:5173
+```
+
+- 后端：`go run ./cmd/artex`（不带 `-tags embedui` 则不内嵌前端）
+- 前端：`cd web && npm run dev`（`/api` 反代到后端，带热更新）
+- 测试：`go test ./...`
+- Mock 预览（无后端）：`cd web && NEXT_PUBLIC_MOCK=1 npm run dev`
+
+---
+
+## 许可
+
+仅供授权测试与研究使用。
diff --git a/screenshots/.gitkeep b/screenshots/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/screenshots/agents.png b/screenshots/agents.png
new file mode 100644
index 0000000..2654dbd
Binary files /dev/null and b/screenshots/agents.png differ
diff --git a/screenshots/assets.png b/screenshots/assets.png
new file mode 100644
index 0000000..226cfbe
Binary files /dev/null and b/screenshots/assets.png differ
diff --git a/screenshots/chat.png b/screenshots/chat.png
new file mode 100644
index 0000000..6cc4b2f
Binary files /dev/null and b/screenshots/chat.png differ
diff --git a/screenshots/dashboard.png b/screenshots/dashboard.png
new file mode 100644
index 0000000..e1176d7
Binary files /dev/null and b/screenshots/dashboard.png differ
diff --git a/screenshots/findings.png b/screenshots/findings.png
new file mode 100644
index 0000000..0443cde
Binary files /dev/null and b/screenshots/findings.png differ
diff --git a/screenshots/graph.png b/screenshots/graph.png
new file mode 100644
index 0000000..a813adc
Binary files /dev/null and b/screenshots/graph.png differ
diff --git a/screenshots/intercept.png b/screenshots/intercept.png
new file mode 100644
index 0000000..b9552cc
Binary files /dev/null and b/screenshots/intercept.png differ
diff --git a/screenshots/llm.png b/screenshots/llm.png
new file mode 100644
index 0000000..36fb79d
Binary files /dev/null and b/screenshots/llm.png differ
diff --git a/screenshots/logs.png b/screenshots/logs.png
new file mode 100644
index 0000000..ee33115
Binary files /dev/null and b/screenshots/logs.png differ
diff --git a/screenshots/sessions.png b/screenshots/sessions.png
new file mode 100644
index 0000000..d418b6c
Binary files /dev/null and b/screenshots/sessions.png differ
diff --git a/screenshots/tasks.png b/screenshots/tasks.png
new file mode 100644
index 0000000..36af78e
Binary files /dev/null and b/screenshots/tasks.png differ
diff --git a/screenshots/traffic.png b/screenshots/traffic.png
new file mode 100644
index 0000000..4fa09ba
Binary files /dev/null and b/screenshots/traffic.png differ
diff --git a/web/src/lib/mock/handler.ts b/web/src/lib/mock/handler.ts
index be09b2d..8b8ec99 100644
--- a/web/src/lib/mock/handler.ts
+++ b/web/src/lib/mock/handler.ts
@@ -72,8 +72,10 @@ function route(m: string, path: string, seg: string[], q: URLSearchParams, b: Re
const items = D.activityForTask();
return { items, cursor: items.length ? items[items.length - 1].seq : 0 };
}
- if (seg[0] === "exploration" && seg[1] === "activity" && seg.length === 3)
- return { detail: "（demo）此活动的完整工具输入/输出明细。" };
+ if (seg[0] === "exploration" && seg[1] === "activity" && seg.length === 3) {
+ const a = D.activity.find((x) => x.seq === Number(seg[2]));
+ return { detail: a?.detail ?? a?.summary ?? "" };
+ }
if (path === "/tokens/daily") return D.dailyTokens;
if (path === "/tokens/conversations") return D.convTokens;
@@ -115,8 +117,11 @@ function route(m: string, path: string, seg: string[], q: URLSearchParams, b: Re
const items = D.conversationMessages[Number(seg[1])] ?? [];
return { items, cursor: items.length ? items[items.length - 1].seq : 0, running: false };
}
- if (seg[0] === "conversations" && seg[2] === "messages" && seg.length === 4)
- return { detail: "（demo）该消息的完整明细。" };
+ if (seg[0] === "conversations" && seg[2] === "messages" && seg.length === 4) {
+ const msgs = D.conversationMessages[Number(seg[1])] ?? [];
+ const a = msgs.find((x) => x.seq === Number(seg[3]));
+ return { detail: a?.detail ?? a?.summary ?? "" };
+ }
if (seg[0] === "conversations" && seg[2] === "messages" && m === "POST") return { status: "ok" };
if (seg[0] === "conversations" && seg[2] === "stop") return { status: "stopped" };