feat: add nginx config generator (#170)

* refactor: modularize workspace setup flow

* update docs

* feat: add nginx config generator

* fix: reuse repo credentials in workspace setup

* fix: streamline workspace token prompt

* fix: tighten cli help and prompts

* fix: align remaining cli help and prompts

* fix: tighten repo-scoped github credentials

* fix: finalize setup alias defaults

* fix: keep setup alias dry-run wording stable

Author: RexWzh

.gitignore

@@ -1,8 +1,8 @@
 ##### user defined ######
 *.jsonl
-playground/
-Playground/
-workspace/
+/playground/
+/Playground/
+/workspace/
 
 
 ##### seperated line ######

AGENTS.md

@@ -15,7 +15,7 @@ src/chattool/
 ├── client/     # 统一 CLI 主入口（chattool）
 ├── llm/        # LLM 路由、Chat 对象
 ├── config/     # 环境变量管理（chatenv）
-├── tools/      # 工具箱（dns、lark、image、network 等）
+├── tools/      # 工具箱（dns、lark、image、network、nginx 等）
 ├── mcp/        # MCP 入口与编排（工具实现下放到 tools/*/mcp.py）
 ├── setup/      # 环境安装脚本
 ├── serve/      # 服务端（截图、证书分发等）
@@ -37,7 +37,7 @@ mkdocs serve --no-livereload # 本地预览文档
 - 必要参数缺失时自动触发 interactive 模式
 - `-i` 强制开启交互，`-I` 强制关闭（参数不全则报错）
 - 参数默认值从环境变量读取，敏感值在提示中自动 mask
-- 所有 CLI 交互统一走 `utils/tui.py`
+- 所有 CLI 交互统一走 `src/chattool/interaction/`
 - 进入 interactive 后，补全当前任务相关的关键参数
 - interactive 展示的默认值必须与实际执行一致
 - `-i` 进入当前命令交互流程，`-I` 完全禁用交互
@@ -49,7 +49,7 @@ mkdocs serve --no-livereload # 本地预览文档
 - setup 命令记录关键阶段日志（开始、依赖检测、安装执行、配置写入、失败原因）
 - 出错时同时保留用户可读错误输出与 logger 错误记录
 - 若 setup 流程涉及 `sudo` 命令，必须提供显式 `--sudo` 开关；未指定 `--sudo` 时，无论非交互还是交互未确认，都只打印建议命令，由用户自行处理
-- setup 类命令若同时支持显式参数、`-e/--env`、已有工具配置、环境变量与 typed `.env`，统一优先级必须为：`显式参数 > -e/--env > 工具默认配置位置 > 系统环境变量 > typed .env`
+- setup 类命令若同时支持显式参数、`-e/--env`、已有工具配置、环境变量与 ChatTool `.env`，统一优先级必须为：`显式参数 > -e/--env > 工具默认配置位置 > 系统环境变量 > ChatTool .env > 默认值`
 
 ### 工具结构
 

CHANGELOG.md

@@ -8,6 +8,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ### Fixed
 - `chattool setup` 中通过 npm 执行安装或检查时，现会先打印真实的 `npm ...` 命令，方便用户确认当前实际在执行什么
+- `chattool pypi init` 在交互终端里省略包名时，现会自动进入交互式补参；显式 `-I` 关闭交互时才保持缺参报错
+- `chattool setup workspace` 在交互式启用 ChatTool / RexBlog 模块时，现会分别提示是否配置 GitHub token；默认值优先读取当前仓库 git credential，并以 mask 形式展示，便于直接复用到目标仓库
 - `chatenv init` / `chatenv new` 更新 active typed env 后，`chatenv cat` 与运行时配置加载现在会优先读取 `envs/<Config>/.env`，不再被已有 shell 环境变量意外覆盖，避免交互里刚保存的新值看起来“没有生效”
 - `chatenv new` 现在收紧为纯 profile 创建语义：无论直接传 profile 名还是交互式补参，都只写入 `envs/<Config>/<profile>.env`，不再顺手覆盖当前 active `.env`
 - `chatskill install` / `chattool skill install` 现在在交互终端里缺少 skill 名时会进入选择页，而不是直接因缺参数中断；非交互环境仍保持显式报错
@@ -26,6 +28,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 - `chattool docker nas` 新增 NAS 静态文件服务模板，生成 compose 与 env 示例占位模板；镜像、路径、端口与 URL 前缀需由用户显式填写或通过 `--set` 覆盖
 - 新增 `chattool setup docker`，用于检查 Docker / Docker Compose / docker 组状态；涉及 `sudo` 的建议命令默认只打印，显式传入 `--sudo` 后才允许在确认后执行
 - `chattool setup playground` 现支持 `--language zh|en`；默认生成中文的 `AGENTS.md`、`CHATTOOL.md`、`MEMORY.md` 和相关 README，也可显式切到英文模板
+- 新增 `chattool nginx`，用于按模板生成常见的 Nginx 配置片段；当前收口为配置导向的最小模板集：基础 `proxy_pass`、HTTPS 入口反代、WebSocket 转发、静态目录站点和重定向，并支持 `-i` 交互式补齐必要参数
 
 ### Changed
 - `chattool setup workspace` / `chattool setup playground` 的任务集汇报结构现统一为 `reports/MM-DD-<set-name>/`：集合目录下直接维护 `TASKSET.md`、`progress.md` 与各子任务目录，不再额外套一层 `task-sets/` 或 `tasks/`

DEVELOP.md

@@ -4,6 +4,7 @@
 
 - 统一入口：`src/chattool/client/`
 - 核心能力：`src/chattool/tools/`
+- 模板型工具优先复用现有生成器风格，例如 `chattool docker`、`chattool nginx`
 - 协议入口：`src/chattool/mcp/`（实现下放 `tools/*/mcp.py`）
 - 环境安装：`src/chattool/setup/`
 - 远程服务：`src/chattool/serve/`
@@ -13,9 +14,13 @@
 
 - 新能力先落 `tools/<name>/`，再接入 `client/mcp/serve`。
 - CLI 统一 `-i/-I` 与缺参自动交互规则。
-- 所有 CLI 交互统一走 `utils/tui.py`。
+- 所有 CLI 交互统一走 `src/chattool/interaction/`。
 - 进入 interactive 后，补全当前任务相关的关键参数。
 - prompt 默认值必须与实际执行一致，敏感值默认脱敏。
+- 任何新增或修改的 CLI 都必须统一满足这些规则，不能只让当前命令局部符合。
+- 若交互先做分类/模板选择，再逐项补参，文档、测试和实现顺序必须一致。
+- CLI 顶层 import 保持最小化，执行期才需要的实现优先下沉到命令函数或局部 helper。
+- 一级命令 help 也要校对：语言风格统一、描述不超出实际能力、group 子命令要带 short help。
 - setup 命令必须记录关键阶段日志。
 - 入口层只做编排，不承载业务实现。
 
@@ -25,11 +30,12 @@
 - 环境变量：更新 `docs/configuration.md`
 - 开发规范：更新 `docs/development-guide/`
 - 导航变更：同步更新 `mkdocs.yml`
+- 新工具落地后，同步更新 `README.md` / `README_en.md` / `AGENTS.md`
 
 ## 配置机制
 
-- 默认优先级统一为：`显式参数 > environment variable > envs/<Config>/.env > default`
-- 对支持 `-e/--env` 的命令，统一为：`显式参数 > -e/显式 env > environment variable > envs/<Config>/.env > default`
+- 默认优先级统一为：`显式参数 > 配置（若存在） > environment variable > ChatTool .env > default`
+- 对支持 `-e/--env` 的命令，统一为：`显式参数 > -e/显式 env > 配置（若存在） > environment variable > ChatTool .env > default`
 - profile 固定保存在 `envs/<Config>/<profile>.env`
 - 新命令需要临时切换配置时，优先复用 `-e/--env`，不要再新增一套临时环境变量语义
 

README.md

@@ -109,6 +109,16 @@ chattool dns ddns home.example.com --monitor
 chattool dns cert-update -d example.com -e admin@example.com
 ```
 
+### Nginx 配置生成 (`chattool nginx`)
+
+```bash
+chattool nginx --list
+chattool nginx proxy-pass --set SERVER_NAME=app.example.com --set PROXY_PASS=http://127.0.0.1:8080
+chattool nginx websocket-proxy ./websocket.conf --set SERVER_NAME=ws.example.com --set PROXY_PASS=http://127.0.0.1:3000
+chattool nginx static-root ./nas.conf --set SERVER_NAME=share.example.com --set ROOT_DIR=/storage/nas
+chattool nginx -i  # 交互式选择模板并逐项填写
+```
+
 ### AI 绘图 (`chattool image`)
 
 ```bash
@@ -130,6 +140,7 @@ chattool explore arxiv get 1706.03762 -v
 | 工具 | 命令 | 说明 |
 |------|------|------|
 | 网络扫描 | `chattool network` | 扫描局域网主机和端口 |
+| Nginx 配置 | `chattool nginx` | 按模板生成常见的反向代理、路径转发和静态目录配置 |
 | PyPI 工具 | `chattool pypi` | 创建、构建、校验、上传与探测 Python 包 |
 | MCP 服务 | `chattool mcp start` | 标准 MCP Server，供 Claude/Cursor 调用 |
 | 环境安装 | `chattool setup codex/claude/opencode/lark-cli/docker` | 安装或检查常用 CLI / Docker 环境，并在确认后执行建议的系统命令 |

README_en.md

@@ -157,11 +157,21 @@ chattool image siliconflow list-models
 chattool image siliconflow generate "a cute dog" -o dog.png
 ```
 
-### 6. Other Tools
+### 6. Nginx Config Generation (`chattool nginx`)
+
+```bash
+chattool nginx --list
+chattool nginx proxy-pass --set SERVER_NAME=app.example.com --set PROXY_PASS=http://127.0.0.1:8080
+chattool nginx websocket-proxy ./websocket.conf --set SERVER_NAME=ws.example.com --set PROXY_PASS=http://127.0.0.1:3000
+chattool nginx -i
+```
+
+### 7. Other Tools
 
 | Tool | Command | Description |
 |------|---------|-------------|
 | Network Scan | `chattool network scan` | Scan LAN for active hosts and SSH ports |
+| Nginx Config | `chattool nginx` | Generate template-based reverse proxy and static site configs |
 | MCP Server | `chattool mcp info` / `chattool mcp inspect` | Inspect MCP server capabilities (JSON supported) |
 | Screenshot | `chattool serve capture` | Local webpage screenshot service |
 | Cert Mgmt | `chattool serve cert` / `chattool client cert` | SSL certificate distribution |

cli-tests/index.md

@@ -31,6 +31,8 @@ cli-tests/
 │   └── test_chattool_mcp_basic.md
 ├── network/
 │   └── test_chattool_network_basic.md
+├── nginx/
+│   └── test_chattool_nginx_render_basic.md
 ├── pypi/
 │   ├── test_chattool_pypi_basic.md
 │   └── test_chattool_pypi_probe.md

cli-tests/nginx/test_chattool_nginx_render_basic.md

@@ -0,0 +1,82 @@
+# test_chattool_nginx_render_basic
+
+测试 `chattool nginx` 的真实基础链路，覆盖通用反代、WebSocket 转发、静态目录模板与文件输出。
+
+## 元信息
+
+- 命令：`chattool nginx [template] [output_file] [--set KEY=VALUE]`
+- 目的：验证 Nginx 配置模板可直接从真实 CLI 产出。
+- 标签：`cli`
+- 前置条件：无第三方服务依赖。
+- 环境准备：准备临时输出目录。
+- 回滚：删除生成的配置文件。
+
+## 用例 1：stdout 输出通用 HTTP 反代模板
+
+- 初始环境准备：
+  - 无
+- 相关文件：
+  - 无
+
+预期过程和结果：
+1. 执行 `chattool nginx proxy-pass --set SERVER_NAME=app.example.com --set PROXY_PASS=http://127.0.0.1:8080`，预期 stdout 包含 `server_name app.example.com;` 与 `proxy_pass http://127.0.0.1:8080;`。
+
+参考执行脚本（伪代码）：
+
+```sh
+chattool nginx proxy-pass --set SERVER_NAME=app.example.com --set PROXY_PASS=http://127.0.0.1:8080
+```
+
+## 用例 2：写入 WebSocket 转发模板文件
+
+- 初始环境准备：
+  - 准备临时目录。
+- 相关文件：
+  - `<tmp>/websocket.conf`
+
+预期过程和结果：
+1. 执行 `chattool nginx websocket-proxy <tmp>/websocket.conf --set SERVER_NAME=ws.example.com --set PROXY_PASS=http://127.0.0.1:3000 --force`，预期输出文件被创建。
+2. 预期文件中包含 `proxy_http_version 1.1;`、`proxy_set_header Upgrade $http_upgrade;` 和 `proxy_set_header Connection "upgrade";`。
+
+参考执行脚本（伪代码）：
+
+```sh
+chattool nginx websocket-proxy /tmp/websocket.conf --set SERVER_NAME=ws.example.com --set PROXY_PASS=http://127.0.0.1:3000 --force
+```
+
+## 用例 3：写入静态目录模板文件
+
+- 初始环境准备：
+  - 准备临时目录。
+- 相关文件：
+  - `<tmp>/nas.conf`
+
+预期过程和结果：
+1. 执行 `chattool nginx static-root <tmp>/nas.conf --set SERVER_NAME=share.example.com --set ROOT_DIR=/storage/nas --force`，预期输出文件被创建。
+2. 预期文件中包含 `root /storage/nas;`、`autoindex on;` 和 `charset utf-8;`。
+
+参考执行脚本（伪代码）：
+
+```sh
+chattool nginx static-root /tmp/nas.conf --set SERVER_NAME=share.example.com --set ROOT_DIR=/storage/nas --force
+```
+
+## 用例 4：生成 HTTP 到 HTTPS 跳转模板
+
+- 初始环境准备：
+  - 无
+- 相关文件：
+  - 无
+
+预期过程和结果：
+1. 执行 `chattool nginx redirect --set SERVER_NAME="example.com www.example.com"`，预期 stdout 中包含 `return 301 https://$host$request_uri;`。
+
+参考执行脚本（伪代码）：
+
+```sh
+chattool nginx redirect --set SERVER_NAME="example.com www.example.com"
+```
+
+## 清理 / 回滚
+
+- 删除生成的配置文件。

cli-tests/nginx/test_chattool_nginx_render_basic.py

@@ -0,0 +1,80 @@
+from pathlib import Path
+
+import pytest
+from click.testing import CliRunner
+
+from chattool.client.main import cli
+
+
+pytestmark = [pytest.mark.e2e]
+
+
+def test_chattool_nginx_basic(tmp_path: Path):
+    runner = CliRunner()
+
+    result = runner.invoke(
+        cli,
+        [
+            "nginx",
+            "proxy-pass",
+            "--set",
+            "SERVER_NAME=app.example.com",
+            "--set",
+            "PROXY_PASS=http://127.0.0.1:8080",
+        ],
+    )
+    assert result.exit_code == 0
+    assert "server_name app.example.com;" in result.output
+    assert "proxy_pass http://127.0.0.1:8080;" in result.output
+
+    ws_file = tmp_path / "websocket.conf"
+    result = runner.invoke(
+        cli,
+        [
+            "nginx",
+            "websocket-proxy",
+            str(ws_file),
+            "--set",
+            "SERVER_NAME=ws.example.com",
+            "--set",
+            "PROXY_PASS=http://127.0.0.1:3000",
+            "--force",
+        ],
+    )
+    assert result.exit_code == 0
+    ws_content = ws_file.read_text(encoding="utf-8")
+    assert 'proxy_set_header Connection "upgrade";' in ws_content
+    assert "proxy_http_version 1.1;" in ws_content
+    assert "proxy_set_header Upgrade $http_upgrade;" in ws_content
+
+    nas_file = tmp_path / "nas.conf"
+    result = runner.invoke(
+        cli,
+        [
+            "nginx",
+            "static-root",
+            str(nas_file),
+            "--set",
+            "SERVER_NAME=share.example.com",
+            "--set",
+            "ROOT_DIR=/storage/nas",
+            "--force",
+        ],
+    )
+    assert result.exit_code == 0
+    nas_content = nas_file.read_text(encoding="utf-8")
+    assert "root /storage/nas;" in nas_content
+    assert "autoindex on;" in nas_content
+    assert "charset utf-8;" in nas_content
+
+    result = runner.invoke(
+        cli,
+        [
+            "nginx",
+            "redirect",
+            "--set",
+            "SERVER_NAME=example.com www.example.com",
+        ],
+    )
+    assert result.exit_code == 0
+    assert "return 301 https://$host$request_uri;" in result.output

cli-tests/pypi/test_chattool_pypi_basic.md

@@ -21,7 +21,7 @@
 预期过程和结果：
   1. 执行 `chattool pypi init mychat --project-dir <tmp>/mychat`，预期生成 `pyproject.toml`、`README.md`、`LICENSE`、`src/mychat/__init__.py`、`tests/conftest.py`、`tests/test_version.py`。
   2. 生成的 `pyproject.toml` 默认写入 `requires-python = ">=3.9"`。
-  3. 当缺少包名时，`chattool pypi init` 应直接报错提示需要传入包名或 `--project-dir`，不进入交互式补参。
+  3. 在交互终端里缺少包名时，`chattool pypi init` 应自动进入交互式补参；显式 `-I` 关闭交互时才报错。
 
 参考执行脚本（伪代码）：