diff --git a/CLAUDE.md b/CLAUDE.md
index 539205c..e1cabf1 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -106,7 +106,7 @@
## Phase 3 完成状态(2026-10-13 收尾核对)
-**测试基线:后端 pytest 595 passed / 前端 vitest 153 passed**(Phase 3 起步 139,Task 9 平台设置页 +14;两端数字均已实跑核对,后端唯一 warning 仍为 starlette TestClient 弃用提示,无害)。`pnpm build`(vue-tsc --noEmit && vite build)零错误。后续回归以此为准。
+**测试基线:后端 pytest 595 passed / 前端 vitest 156 passed**(Phase 3 起步 139,Task 9 平台设置页 +14、终审修复通用 JSON 组 +3;两端数字均已实跑核对,后端唯一 warning 仍为 starlette TestClient 弃用提示,无害)。`pnpm build`(vue-tsc --noEmit && vite build)零错误。后续回归以此为准。
**交付形态**:`admin/` 子目录的 Vue3 + TS + Vite + Element Plus SPA(art-design-pro 模板,pnpm 管理),与后端同仓。本地起法:
@@ -120,7 +120,7 @@
- 仪表盘:平台总览 + 租户卡片墙(超管)/ 我的指标(租户管理员),时间窗切换。
- 租户管理(仅超管):列表 / 创建向导(消费出厂档案)/ 详情编辑 / 站点与域名子资源 / 停用复启。
- 会话与线索:列表(筛选 / 分页 / 租户切换)/ 详情消息流 / 推送日志 / 删除。
-- 配置中心:品牌(表单 / 本地简化预览 / 嵌入代码 / 头像上传)、提示词四件套与结构化词表、试金石面板、凭据(邮件 / 推送 / AI 表单 + SMTP 测试 + 推送探测)、版本历史(两版对比 / 回滚 / 组级重置出厂)。
+- 配置中心:品牌(表单 / 本地简化预览 / 嵌入代码 / 头像上传)、提示词四件套与结构化词表、试金石面板、凭据(邮件 / 推送 / AI 表单 + SMTP 测试 + 推送探测)、contact/engine/misc 三组通用 JSON 编辑(终审 I-1 补齐 spec §7.3 全组覆盖)、版本历史(两版对比 / 回滚 / 组级重置出厂)。
- 统计分析:卡片 / 转化漏斗 / 按日趋势 / 意向·来源·站点·国家分布(ECharts)/ 推送健康表;时间与租户筛选(口径同 stats.py docstring 口径表)。
- 平台设置(仅超管):自由 KV 表的推荐键表单(ai.* / smtp.*,键名是前端约定)+ 存储总览表格;保存 = 逐键 PUT(只提交脏键)。**当前仅存储与展示——resolver 的平台默认回退链未接线(页头注记),引擎不读取这些值**;密钥键掩码哨兵交互与凭据页同款(清除 / 恢复保持)。
@@ -140,11 +140,16 @@
- **TENANT_SOURCE=db 默认**(生产装配形态);`file` 为冷备/本地调试回退。
- **admin 域名反代区分**:`/api/platform/*` 前缀豁免租户 Host 解析——平台后台 API 可与租户聊天域名同源反代(按路径分流)或独立域名,两形态皆可;租户聊天面(`/`、`/static`、WS、`/api/public`、`/api/chat*`)仍严格按 Host 解析租户,未知 Host 404。
- **ADMIN_PASSWORD 默认值警示**(终审 I-4):lifespan 启动检测到 ADMIN_PASSWORD 仍是出厂默认(admin123)时打 WARNING 日志——生产部署必须设 ADMIN_PASSWORD 环境变量换掉,且超管首登立即改密(must_change_password 门强制)。
-- **Phase 4 清理单增补**(Phase 3 冒烟沉淀;Phase 3 清理单未结项 5/6/8/9/10 一并滚入):
+- **Phase 4 清理单增补**(Phase 3 冒烟沉淀 + 终审记档;Phase 3 清理单未结项 5/6/8/9/10 一并滚入):
1. `components.d.ts` 构建行尾漂移(长期收口 = 生成物出库或 EOL 规范钩子,现阶段靠手工还原)。
2. 推送探测 env 回退真址:租户 push URL 空槽时 `resolve_push_settings` 回退 env `PUSH_API_URL`(默认即真 UniService 生产址)——后台点「探测」会对真实服务发空批量 POST(`{"messages": []}`,按契约文档应为无操作,但属真实出站)。收口 = 部署设 stub 域或探测端点拒绝 env 回退 URL。
3. 生产反代需规划 admin 域的头像/品牌公开端点:`/api/public/*` 按租户 Host 解析,admin 域直挂必 404——开发期靠 Vite Host 改写代理,生产要么同源反代改 Host(单租户形态)要么前端改用租户域名绝对 URL。
4. `VITE_TENANT_PREVIEW_HOST` 单一预览域名:开发代理只指向一个租户 Host,切换租户时头像等公开资源预览不准(.env.development 已注记)。
+ 5. **resolver 平台默认回退链接入 platform_settings**(终审 I-3 记档):平台设置当前仅存储与展示(admin 页头有注记),引擎不读取——回退链接线是 Phase 4 的功能项。
+ 6. **email/test 与 push/test 速率限制**(终审 I-3 记档):两测试端点无限流,复用登录限流器模式收口。
+ 7. **锁屏功能已摘除入口**(终审 M-1):用户菜单项删除 + 全局组件 enabled:false 不再挂载(AES 存 localStorage + 公开模板默认密钥,防御价值为零);代码待 Phase 4 决定删否。
+ 8. **租户切换器 composable 收拢**(终审 M-3 不做记档):仪表盘/会话/配置三页各自内联实现同一模式,收拢归后续。
+ 9. **ECharts 按需收窄**(终审 M-4 不做记档):stats 的 charts.ts 全量注册,bundle 体积优化归后续。
## 文档索引
diff --git a/README.md b/README.md
index ba4b714..e29375e 100644
--- a/README.md
+++ b/README.md
@@ -9,8 +9,8 @@
- Host 路由:按域名解析租户,未知 Host 404;WS 通道租户化客户端 key 防串库,另有限流与每 IP 连接上限。
- 引擎行为:cc 区号补全判定树、多语言墙(中/西/葡借道/俄/阿)、dual-contact 分步双要、CC 强制墙、lead 邮件推送。
- 平台层:scrypt 认证 + 内存 token + 登录限流;租户管理(创建向导 / 站点 / 域名 / 停用);配置版本管线(整组替换 / 回滚 / 重置出厂 / 试金石);头像上传(魔数校验 + uuid 重命名);数据视图(会话 / 推送日志 / 删除,租户 scope 强制);统计(卡片 / 漏斗 / 趋势 / 分布 / 推送健康,逐库聚合禁 ATTACH);密钥掩码哨兵(`__SET__` 往返);DB 源生产装配(TENANT_SOURCE=db 默认 + bootstrap_platform.py 引导)。admin API 全在 `/api/platform` 前缀(Host 豁免、路由依赖守护),端点清单见 [CLAUDE.md](CLAUDE.md)。
-- 管理后台 SPA(Phase 3,`admin/` 目录,Vue3 + Element Plus + pnpm):登录 / 强制改密 / 角色化菜单(超管 vs 租户管理员);仪表盘(平台总览 + 租户卡片墙 / 我的指标);租户管理与站点域名;会话与线索(筛选 / 详情消息流 / 推送日志 / 删除);配置中心(品牌 + 本地预览 + 嵌入代码 + 头像上传 / 提示词词表 / 试金石 / 凭据掩码编辑 + SMTP 测试 + 推送探测 / 版本对比回滚重置);统计分析(ECharts 漏斗 / 趋势 / 分布 / 推送健康);平台设置(ai.* / smtp.* 推荐键 KV 表单 + 存储总览,现阶段仅存储不接引擎回退链)。
+- 管理后台 SPA(Phase 3,`admin/` 目录,Vue3 + Element Plus + pnpm):登录 / 强制改密 / 角色化菜单(超管 vs 租户管理员);仪表盘(平台总览 + 租户卡片墙 / 我的指标);租户管理与站点域名;会话与线索(筛选 / 详情消息流 / 推送日志 / 删除);配置中心(品牌 + 本地预览 + 嵌入代码 + 头像上传 / 提示词词表 / 试金石 / 凭据掩码编辑 + SMTP 测试 + 推送探测 / contact·engine·misc 通用 JSON 编辑 / 版本对比回滚重置);统计分析(ECharts 漏斗 / 趋势 / 分布 / 推送健康);平台设置(ai.* / smtp.* 推荐键 KV 表单 + 存储总览,现阶段仅存储不接引擎回退链)。
-**本地跑法**:后端 `PYTHONUTF8=1 .venv/Scripts/python -m uvicorn app.main:app --port 8018 --workers 1`;管理后台 `cd admin && pnpm install && pnpm dev`(Vite 代理 /api → 8018)。工作约定与测试基线(后端 pytest 595 / 前端 vitest 153)见 [CLAUDE.md](CLAUDE.md)。
+**本地跑法**:后端 `PYTHONUTF8=1 .venv/Scripts/python -m uvicorn app.main:app --port 8018 --workers 1`;管理后台 `cd admin && pnpm install && pnpm dev`(Vite 代理 /api → 8018)。工作约定与测试基线(后端 pytest 595 / 前端 vitest 156)见 [CLAUDE.md](CLAUDE.md)。
设计文档(spec):[docs/superpowers/specs/2026-10-12-unified-kefu-platform-design.md](docs/superpowers/specs/2026-10-12-unified-kefu-platform-design.md)
diff --git a/admin/.env.development b/admin/.env.development
index a88ef43..49c0be7 100644
--- a/admin/.env.development
+++ b/admin/.env.development
@@ -1,8 +1,31 @@
# 【开发】环境变量
+#
+# 说明:模板原把通用变量放 .env(全模式加载),但根 .gitignore 的
+# `.env` 规则会误伤 admin/.env——入库文件只有 .env.development /
+# .env.production 两份(Phase 3 终审 I-2 收口)。通用变量因此按
+# "两份都写"纪律维护:改通用项时两文件同步改。
+
+# 版本号(vite.config.ts 的 __APP_VERSION__ define)
+VITE_VERSION = 0.1.0
+
+# dev server 端口号(被占自动顺延)
+VITE_PORT = 3006
# 应用部署基础路径(如部署在子目录 /admin,则设置为 /admin/)
VITE_BASE_URL = /
+# 权限模式【 frontend 前端模式 / backend 后端模式 】
+VITE_ACCESS_MODE = frontend
+
+# 跨域请求时是否携带 Cookie(开启前需确保后端支持)
+VITE_WITH_CREDENTIALS = false
+
+# 是否打开路由信息
+VITE_OPEN_ROUTE_INFO = false
+
+# 锁屏加密密钥(锁屏入口已摘除——Phase 3 终审 M-1;密钥保留防遗留代码异常)
+VITE_LOCK_ENCRYPT_KEY = s3cur3k3y4adpro
+
# API 请求基础路径(开发环境使用 / 走 Vite 代理,见 vite.config.ts 的 server.proxy)
VITE_API_URL = /
diff --git a/admin/.env.production b/admin/.env.production
index 44972c8..cdc67d4 100644
--- a/admin/.env.production
+++ b/admin/.env.production
@@ -1,8 +1,28 @@
# 【生产】环境变量
+#
+# 说明:模板原把通用变量放 .env(全模式加载),但根 .gitignore 的
+# `.env` 规则会误伤 admin/.env——入库文件只有 .env.development /
+# .env.production 两份(Phase 3 终审 I-2 收口)。通用变量因此按
+# "两份都写"纪律维护:改通用项时两文件同步改。
+
+# 版本号(vite.config.ts 的 __APP_VERSION__ define)
+VITE_VERSION = 0.1.0
# 应用部署基础路径(如部署在子目录 /admin,则设置为 /admin/)
VITE_BASE_URL = /
+# 权限模式【 frontend 前端模式 / backend 后端模式 】
+VITE_ACCESS_MODE = frontend
+
+# 跨域请求时是否携带 Cookie(开启前需确保后端支持)
+VITE_WITH_CREDENTIALS = false
+
+# 是否打开路由信息
+VITE_OPEN_ROUTE_INFO = false
+
+# 锁屏加密密钥(锁屏入口已摘除——Phase 3 终审 M-1;密钥保留防遗留代码异常)
+VITE_LOCK_ENCRYPT_KEY = s3cur3k3y4adpro
+
# API 地址前缀(生产由反代把 /api 与 /static 指向后端,前端同源相对路径)
VITE_API_URL = /
diff --git a/admin/README.md b/admin/README.md
index a1f4676..8f58fc6 100644
--- a/admin/README.md
+++ b/admin/README.md
@@ -1,104 +1,3 @@
-
+# all-kefu 管理后台(admin SPA)
-
-
Art Design Pro
-A backend system template that combines design aesthetics with efficient development, helping you quickly build professional-grade applications
-
-
-
-
-
-[](./LICENSE) [](https://github.com/Daymychen/art-design-pro/stargazers) [](https://github.com/Daymychen/art-design-pro/network/members)
-
-
-
-
-## What makes this project special?
-
-**Interface Design**: Modern UI design with smooth interactions, focusing on user experience and visual design
-
-**Quick Start**: Clean architecture + comprehensive documentation, easy for backend developers to use
-
-**Rich Components**: Built-in high-quality components for data display, forms, and more to meet different business scenarios
-
-**Smooth Interactions**: Button clicks, theme switching, page transitions, chart animations - experience comparable to commercial products
-
-**Efficient Development**: Built-in practical APIs like useTable and ArtForm to significantly improve development efficiency
-
-**Clean Scripts**: Built-in one-click cleanup script to quickly remove demo data and get a ready-to-develop base project
-
-## Tech Stack
-
-Development Framework: Vue3, TypeScript, Vite, Element-Plus, Tailwind CSS
-
-Code Standards: Eslint, Prettier, Stylelint, Husky, Lint-staged, cz-git
-
-## Preview
-
-
-
-
-
-
-
-
-
-## Quick Access
-
-[Live Demo](https://www.artd.pro) | [Official Documentation](https://www.artd.pro/docs) | [Changelog](./CHANGELOG.en.md)
-
-## Installation & Setup
-
-```bash
-# Install dependencies
-pnpm install
-
-# If pnpm install fails, try using the command below
-pnpm install --ignore-scripts
-
-# Start local development environment
-pnpm dev
-
-# Build for production
-pnpm build
-```
-
-## Clean Version
-
-The project includes a cleanup script to quickly remove demo data and provide developers with a ready-to-develop base project
-
-```bash
-pnpm clean:dev
-```
-
-## Technical Support
-
-QQ Group: 1038930070 (Click the link to join the group chat)
-
-## Browser Compatibility
-
-Supports modern mainstream browsers including Chrome, Safari, Firefox, and more.
-
-## Contributing
-
-We sincerely welcome and appreciate the support of every contributor! Whether you have new ideas, feature suggestions, or code optimizations, you can participate in the following ways:
-
-Submit Pull Requests: Share your code and help the project grow.
-
-Create GitHub Issues: Provide bug feedback or new feature suggestions to help us improve together.
-
-Every contribution you make takes this project one step further! Come join our open source community!
-
-## Continuous Optimization & Extension
-
-The project maintains active updates, supports the latest frontend tech stack, is compatible with mainstream frameworks, and ensures long-term stability and extensibility. Community-driven feedback mechanisms allow your needs to be quickly integrated into project iterations.
-
-## Donation
-
-If you feel this project has reduced your development costs and solved problems in your work/life, you can support us through the following ways:
-
-
-
-## Star History
-
-[](https://www.star-history.com/#Daymychen/art-design-pro&Date)
+Vue3 + TS + Vite + Element Plus(art-design-pro 模板)。本地起法与工作约定见根目录 [CLAUDE.md](../CLAUDE.md) 的「Phase 3 完成状态」段(后端 8018 + `pnpm install && pnpm dev`)。
diff --git a/admin/README.zh-CN.md b/admin/README.zh-CN.md
deleted file mode 100644
index aad3c54..0000000
--- a/admin/README.zh-CN.md
+++ /dev/null
@@ -1,104 +0,0 @@
-
-
-
-Art Design Pro
-一款兼具设计美学与高效开发的后台系统模版,助你快速构建专业级应用
-
-
-
-
-
-[](./LICENSE) [](https://github.com/Daymychen/art-design-pro/stargazers) [](https://github.com/Daymychen/art-design-pro/network/members)
-
-
-
-
-## 这个项目有什么特别的呢?
-
-**界面设计**:现代化 UI 设计,流畅交互,以用户体验与视觉设计为核心
-
-**极速上手**:简洁架构 + 完整文档,后端开发者也能轻松使用
-
-**丰富组件**:内置数据展示、表单等多种高质量组件,满足不同业务场景的需求
-
-**丝滑交互**:按钮点击、主题切换、页面过渡、图表动画,体验媲美商业产品
-
-**高效开发**:内置 useTable、ArtForm 等实用 API,显著提升开发效率
-
-**精简脚本**:内置一键清理脚本,可快速清理演示数据,立即得到可开发的基础项目
-
-## 技术栈
-
-开发框架:Vue3、TypeScript、Vite、Element-Plus、Tailwind CSS
-
-代码规范:Eslint、Prettier、Stylelint、Husky、Lint-staged、cz-git
-
-## 预览
-
-
-
-
-
-
-
-
-
-## 快速访问
-
-[演示地址](https://www.artd.pro) | [官方文档](https://www.artd.pro/docs) | [更新日志](./CHANGELOG.md)
-
-## 安装运行
-
-```bash
-# 安装依赖
-pnpm install
-
-# 如果 pnpm install 安装失败,尝试使用下面的命令安装依赖
-pnpm install --ignore-scripts
-
-# 本地开发环境启动
-pnpm dev
-
-# 生产环境打包
-pnpm build
-```
-
-## 精简版本
-
-项目内置精简脚本,可快速移除项目中的演示数据,让开发者获得一个可快速开发的基础项目
-
-```bash
-pnpm clean:dev
-```
-
-## 技术支持
-
-QQ群:1038930070(点击链接加入群聊)
-
-## 兼容性
-
-支持 Chrome、Safari、Firefox 等现代主流浏览器。
-
-## 贡献
-
-我们真诚欢迎并感谢每一位贡献者的支持!无论您有新想法、功能建议还是代码优化,都可以通过以下方式参与:
-
-提交 Pull Request:分享您的代码,助力项目成长。
-
-创建 GitHub Issue:提出 bug 反馈或新功能建议,让我们一起完善。
-
-您的每一点贡献都让这个项目更进一步!快来加入我们的开源社区吧!
-
-## 持续优化与扩展
-
-项目保持活跃更新,支持最新前端技术栈,兼容主流框架,确保长期稳定性和扩展性。社区驱动的反馈机制,让你的需求快速融入项目迭代。
-
-## 捐赠
-
-如果你觉得这个项目为你减少了开发成本、化解了工作 / 生活里的难题,可以通过以下方式支持一下~
-
-
-
-## Star History
-
-[](https://www.star-history.com/#Daymychen/art-design-pro&Date)
diff --git a/admin/src/components/core/layouts/art-header-bar/widget/ArtUserMenu.vue b/admin/src/components/core/layouts/art-header-bar/widget/ArtUserMenu.vue
index c8a4a11..40fdc39 100644
--- a/admin/src/components/core/layouts/art-header-bar/widget/ArtUserMenu.vue
+++ b/admin/src/components/core/layouts/art-header-bar/widget/ArtUserMenu.vue
@@ -37,10 +37,8 @@
{{ $t('topBar.user.changePassword') }}
-
-
- {{ $t('topBar.user.lockScreen') }}
-
+
{{ $t('topBar.user.logout') }}
@@ -57,7 +55,6 @@
import { ElMessageBox } from 'element-plus'
import { useUserStore } from '@/store/modules/user'
import { useAuthStore } from '@/store/modules/auth'
- import { mittBus } from '@/utils/sys'
defineOptions({ name: 'ArtUserMenu' })
@@ -77,13 +74,6 @@
router.push(path)
}
- /**
- * 打开锁屏功能
- */
- const lockScreen = (): void => {
- mittBus.emit('openLockScreen')
- }
-
/**
* 用户登出确认
*/
diff --git a/admin/src/config/modules/component.ts b/admin/src/config/modules/component.ts
index bc709e0..dc0e244 100644
--- a/admin/src/config/modules/component.ts
+++ b/admin/src/config/modules/component.ts
@@ -43,7 +43,10 @@ export const globalComponentsConfig: GlobalComponentConfig[] = [
component: defineAsyncComponent(
() => import('@/components/core/layouts/art-screen-lock/index.vue')
),
- enabled: true
+ // 入口已摘除(Phase 3 终审 M-1):锁屏把真实密码 AES 存 localStorage
+ // 且密钥是公开模板默认值,防御价值为零——enabled: false 连全局挂载
+ // 也不注册;组件代码保留,Phase 4 决定删否。
+ enabled: false
},
{
name: '聊天窗口',
diff --git a/admin/src/config/modules/fastEnter.ts b/admin/src/config/modules/fastEnter.ts
index 4117136..60c37b3 100644
--- a/admin/src/config/modules/fastEnter.ts
+++ b/admin/src/config/modules/fastEnter.ts
@@ -46,18 +46,12 @@ const fastEnterConfig: FastEnterConfig = {
routeName: 'StatsOverview'
}
],
- // 快速链接
+ // 快速链接(登录项已删——终审 M-8:已登录态下无意义)
quickLinks: [
- {
- name: '登录',
- enabled: true,
- order: 1,
- routeName: 'Login'
- },
{
name: '修改密码',
enabled: true,
- order: 2,
+ order: 1,
routeName: 'ForceChangePassword'
}
]
diff --git a/admin/src/config/modules/headerBar.ts b/admin/src/config/modules/headerBar.ts
index a420e82..d1c908b 100644
--- a/admin/src/config/modules/headerBar.ts
+++ b/admin/src/config/modules/headerBar.ts
@@ -39,7 +39,9 @@ export const headerBarConfig: HeaderBarFeatureConfig = {
description: '全屏切换功能'
},
notification: {
- enabled: true,
+ // 入口已摘除(Phase 3 终审 M-2):模板通知中心是硬编码演示数据,
+ // 无真实数据源——enabled: false 隐藏铃铛;组件保留,接真数据源时再开。
+ enabled: false,
description: '通知中心,显示系统通知和消息'
},
chat: {
diff --git a/admin/src/views/config/center/JsonGroupPane.vue b/admin/src/views/config/center/JsonGroupPane.vue
new file mode 100644
index 0000000..ec4113d
--- /dev/null
+++ b/admin/src/views/config/center/JsonGroupPane.vue
@@ -0,0 +1,254 @@
+
+
+
+
+
+
+
+
+
+
+
+ -
+ {{ field.key }}
+ {{ field.desc }}
+
+
+
+
+
+
+
+
+ 保存(整组提交,热生效)
+
+
+
+
+
+
+
+
diff --git a/admin/src/views/config/center/__tests__/model.test.ts b/admin/src/views/config/center/__tests__/model.test.ts
index e8f9fec..a9845e9 100644
--- a/admin/src/views/config/center/__tests__/model.test.ts
+++ b/admin/src/views/config/center/__tests__/model.test.ts
@@ -38,11 +38,14 @@ import {
formatKB,
formatVersionTime,
initWallEdit,
+ JSON_GROUP_FIELDS,
+ jsonGroupDraft,
normalizeAiCredsGroup,
normalizeEmailCredsGroup,
normalizePromptsGroup,
normalizePushCredsGroup,
parsePatternEntry,
+ parseJsonGroupDraft,
promptByteInfo,
promptsOverCap,
rowToEntry,
@@ -705,3 +708,40 @@ describe('scopedConfigJson / snapshotGroupKeys(两版对比的范围视图)'
expect(snapshotGroupKeys(null)).toEqual([])
})
})
+
+describe('通用 JSON 组编辑(终审 I-1:contact/engine/misc)', () => {
+ it('jsonGroupDraft:组值 → 2 空格缩进等宽稿;null/undefined → 空对象', () => {
+ expect(jsonGroupDraft({ cc_completion: false })).toBe(
+ '{\n "cc_completion": false\n}'
+ )
+ expect(jsonGroupDraft(null)).toBe('{}')
+ expect(jsonGroupDraft(undefined)).toBe('{}')
+ })
+
+ it('parseJsonGroupDraft:语法错误 / 非对象顶层 → 带原因拒绝;对象通过', () => {
+ const bad = parseJsonGroupDraft('{ "a": ')
+ expect(bad.ok).toBe(false)
+ if (!bad.ok) expect(bad.error).toContain('JSON 语法错误')
+ const notObject = parseJsonGroupDraft('[1, 2]')
+ expect(notObject.ok).toBe(false)
+ if (!notObject.ok) expect(notObject.error).toContain('顶层须为 JSON 对象')
+ const ok = parseJsonGroupDraft('{"cc_completion": false}')
+ expect(ok.ok).toBe(true)
+ if (ok.ok) expect(ok.value).toEqual({ cc_completion: false })
+ })
+
+ it('JSON_GROUP_FIELDS:三组字段说明齐备(键与 DEFAULT_CONFIG 同名)', () => {
+ expect(Object.keys(JSON_GROUP_FIELDS).sort()).toEqual(['contact', 'engine', 'misc'])
+ expect(JSON_GROUP_FIELDS.contact.map((f) => f.key)).toEqual([
+ 'cc_completion',
+ 'email_light_ask',
+ 'template_languages'
+ ])
+ expect(JSON_GROUP_FIELDS.engine.map((f) => f.key)).toEqual([
+ 'rate_limit_per_hour',
+ 'ws_conn_limit',
+ 'context_seed_keys'
+ ])
+ expect(JSON_GROUP_FIELDS.misc.map((f) => f.key)).toEqual(['name_to_region_extras'])
+ })
+})
diff --git a/admin/src/views/config/center/index.vue b/admin/src/views/config/center/index.vue
index f4656d3..3faacc6 100644
--- a/admin/src/views/config/center/index.vue
+++ b/admin/src/views/config/center/index.vue
@@ -443,6 +443,28 @@
+
+
+
+
+ 重试
+
+
+
+
+
@@ -477,7 +499,9 @@
import PromptsPane from './PromptsPane.vue'
import WallPane from './WallPane.vue'
import CredsPane from './CredsPane.vue'
+ import JsonGroupPane from './JsonGroupPane.vue'
import VersionsPane from './VersionsPane.vue'
+ import type { JsonGroupKey } from './model'
import { confirmAndResetGroup } from './reset'
defineOptions({ name: 'ConfigCenter' })
@@ -495,7 +519,10 @@
{ key: 'brand', label: '品牌' },
{ key: 'prompts', label: '提示词' },
{ key: 'wall', label: '安全词表' },
+ { key: 'contact', label: '联系方式' },
{ key: 'creds', label: '凭据' },
+ { key: 'engine', label: '引擎' },
+ { key: 'misc', label: '杂项' },
{ key: 'versions', label: '版本' }
] as const
@@ -504,10 +531,23 @@
'brand',
'prompts',
'wall',
+ 'contact',
'creds',
+ 'engine',
+ 'misc',
'versions'
])
+ /** 通用 JSON 组(终审 I-1:contact/engine/misc 走 JsonGroupPane 一份实现) */
+ const JSON_GROUPS = new Set(['contact', 'engine', 'misc'])
+
+ /** 模板绑定用的收窄视图(JSON 组分支下恒为该三键之一) */
+ const activeJsonGroup = computed(() =>
+ JSON_GROUPS.has(activeGroup.value)
+ ? (activeGroup.value as JsonGroupKey)
+ : 'contact'
+ )
+
type GroupKey = (typeof GROUP_NAV)[number]['key']
const activeGroup = ref('brand')
diff --git a/admin/src/views/config/center/model.ts b/admin/src/views/config/center/model.ts
index f1f0da0..6e0541a 100644
--- a/admin/src/views/config/center/model.ts
+++ b/admin/src/views/config/center/model.ts
@@ -737,3 +737,65 @@ export function scopedConfigJson(
scope === COMPARE_SCOPE_ALL ? config : { [scope]: config[scope] }
return JSON.stringify(view, null, 2)
}
+
+// ---- 通用 JSON 组编辑(Phase 3 终审 I-1:contact / engine / misc) -------------------
+
+/** 走通用 JSON pane 的组(无密钥字段、结构低频变更——表单化收益低) */
+export type JsonGroupKey = 'contact' | 'engine' | 'misc'
+
+/** 组取值 → 编辑器初稿(null 组 = 空对象;2 空格缩进等宽展示) */
+export function jsonGroupDraft(
+ group: Record | null | undefined
+): string {
+ return JSON.stringify(group ?? {}, null, 2)
+}
+
+/** 编辑器解析结果:ok=false 时 error 带可直接展示的中文原因 */
+export type JsonDraftParse =
+ | { ok: true; value: Record }
+ | { ok: false; error: string }
+
+/** 编辑稿预检:JSON 语法 + 顶层须为对象(后端 _check_* 类型校验兜底) */
+export function parseJsonGroupDraft(text: string): JsonDraftParse {
+ let value: unknown
+ try {
+ value = JSON.parse(text)
+ } catch (error) {
+ const detail = error instanceof Error ? error.message : String(error)
+ return { ok: false, error: `JSON 语法错误——${detail}` }
+ }
+ if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+ return { ok: false, error: '顶层须为 JSON 对象({ ... })——整组替换语义' }
+ }
+ // typeof 收窄只到 object(无索引签名)——JSON.parse 产物必为普通对象,断言收形
+ return { ok: true, value: value as Record }
+}
+
+/** 三组的字段说明(pane 顶部展示;事实源 app/platform/defaults.py) */
+export const JSON_GROUP_FIELDS: Record<
+ JsonGroupKey,
+ Array<{ key: string; desc: string }>
+> = {
+ contact: [
+ { key: 'cc_completion', desc: 'bool——cc 区号补全判定树开关' },
+ { key: 'email_light_ask', desc: 'bool——dual-contact 分步双要的邮箱轻补' },
+ {
+ key: 'template_languages',
+ desc: 'string[]——邮件模板语言清单(运行期接线归 Phase 4,清理单 #8)'
+ }
+ ],
+ engine: [
+ { key: 'rate_limit_per_hour', desc: '正整数——聊天限流(次/小时/IP)' },
+ { key: 'ws_conn_limit', desc: '正整数——每 IP WebSocket 连接上限' },
+ {
+ key: 'context_seed_keys',
+ desc: '映射——产品字段 → 会话上下文种子键(如 product_name → app_product_name)'
+ }
+ ],
+ misc: [
+ {
+ key: 'name_to_region_extras',
+ desc: '映射——国名 → ISO 区域码扩展(resolve_region_code 消费)'
+ }
+ ]
+}
diff --git a/app/platform/routes/config_routes.py b/app/platform/routes/config_routes.py
index a02aa43..d637740 100644
--- a/app/platform/routes/config_routes.py
+++ b/app/platform/routes/config_routes.py
@@ -25,7 +25,7 @@
两端点不落库不 bump 版本,成败如实返回(400 只用于"未配置"预检);
- GET/PUT /api/platform/settings:PlatformSetting CRUD,仅超管。本阶段只落
存储与接口(value 以 JSON Text 直存,读回还原类型);resolver 的平台默认
- 回退链接入归 Phase 3。
+ 回退链接线归 Phase 4(当前仅存储,admin 平台设置页页头有注记)。
鉴权矩阵(spec §3):config 系 = require_tenant(slug)(租户全开——本租户
管理员可自助改配置);settings = require_super。409 门经 platform_user 连锁。
@@ -602,7 +602,7 @@ async def test_push(slug: str, request: Request,
return {"slug": slug, **await _probe_push(cfg)}
-# ---- 平台设置(仅超管;resolver 回退链接入归 Phase 3) -----------------------------
+# ---- 平台设置(仅超管;resolver 回退链接线归 Phase 4——当前仅存储) ------------------
def _decode_setting(raw: str):