kits.chat 迭代版本文档：v12.0.2

• 发布日期：2026-04-23
• 范围：kits-chat（前端）/ kits-api（后端）/ deploy（Docker 部署）

变更日志

功能新增

• JSON 格式化支持“宽松 JSON”解析：兼容单引号字符串、`#` 注释、对象 key 无引号等输入
• 新增 Docker Compose 部署目录（`deploy/`）：Caddy 自动 HTTPS + `/api` 反代 + mysql/redis（可选 mongo）

功能修改

• Header 搜索框交互升级：聚焦态更突出，增加清空按钮与快捷提示
• 前端版本号更新至 `12.0.2`

Bug 修复

• 部署/文档脱敏：移除仓库内硬编码服务器信息与登录方式，避免对外泄露

体验优化

• JSON 工具编辑体验增强：行号输入框、历史/草稿与弹窗布局适配（最大化场景）

AI 动作全过程（可审计版）

- 将 DevLog 与 release 文档视为对外内容，优先做敏感信息扫描与脱敏 - 将线上部署细节收敛到私有文档 `docs/deploy.private.md`（必须忽略，禁止提交） - 在变更固化后再执行构建与部署，避免重复上线

- 获取变更：读取 git 状态与 diff，归类为前端交互/JSON 工具/部署资产/文档安全 - 安全扫描：对 `release/`、`kits-chat/src/data/changelog.json`、`deploy/` 等目录做敏感信息模式扫描；发现 `deploy/README.md` 存在硬编码登录方式后进行脱敏改写 - 文档产出：补齐 `release/v12.0.2.md`、更新 `release/CHANGELOG.md`、同步 DevLog 数据源 - 构建验证：前端 `npm ci && npm run build`；后端做基础语法/依赖校验（按环境可用性执行） - 版本管理：使用 git-version-manager 的流程标准审查与提交（含敏感信息阻断）

• 接受指令：执行“发布 + 部署”一体化流程（发布文档→DevLog→git 版本管理→构建→Docker 部署）
• 评估与思考：
• 工具调用与执行修改（摘要）：

完成效率

• 开发用时：N/A（当前环境无统一计时器；可按终端命令日志复核）
• 测试用时：前端构建验证已完成（`npm ci` 29s；`vite build` 2.56s）
• Token 消耗：N/A（当前会话未暴露可校验的 token 统计来源）

涉及文件（摘要）

• 前端：Header、ToolModal/ToolPanel、JSON 工具、通用组件与 utils
• 后端：新增 Dockerfile（容器化运行）
• 部署：新增 `deploy/`（compose、Caddyfile、镜像构建）
• 文档：`release/CHANGELOG.md`、本文件、以及对外脱敏后的部署说明

构建与部署（不含敏感信息）

前端构建

cd kits-chat
npm ci
npm run build

Docker 部署（更新发布）

在服务器部署目录（私有信息见 `docs/deploy.private.md`）：

cd <deploy-dir>/deploy
cp .env.example .env
vi .env
docker compose --env-file .env up -d --build
docker compose ps

验收（以实际域名为准）：

curl -fsS -o /dev/null -w "%{http_code}\n" https://<domain>/
curl -fsS -o /dev/null -w "%{http_code}\n" https://<domain>/api/health