feat(控制台): 接入指南扩展40项全量MCP工具与前端交互体验优化

[xiaolfeng]

特性概述

全面重构控制台 MCP 接入指南体系，将前端单一数据源与展示层完整对齐后端 8 大核心能力域共 40 项 Streamable MCP 工具（补齐 Preview 行级编辑、文件删除以及 Preview LPW 8 项节点增量编排工具族）；加固站点域名格式校验与下游链路安全，并集成实时预览平滑过渡动效、项目管理台账联动与安全增强。

核心能力与变更清单

• MCP 接入指南与数据源扩展：
  • 更新 web/src/lib/mcp-connect.ts，新增 preview_lpw 模块定义，补齐 preview_file_edit 与 preview_file_delete，收敛 40 项全量 MCP 工具单一数据源；
  • 扩展协作工作流为 8 个标准操作步骤，涵盖行级精准编辑微调与出版级 LPW 节点大纲编排指引；
  • 联动更新控制台接入指南（tool-catalog.tsx、plugin-install-panel.tsx）与公开落地页（start.tsx、tech-section.tsx）能力分类与工具总数文案，为 preview_lpw 配置专属图标映射。
• 站点域名与下游链路安全加固：
  • 服务端（internal/logic/settings.go）新增并导出 ValidateSiteDomain，严格拦截空格、换行符、Unicode 分隔符、命令行控制字符、账号凭据以及 ? 查询参数与 # 页面锚点，防止下游拼接生成异常的 Q&A 交互链接、Preview / Pages 深链；
  • internal/logic/qa_logic.go 的 UpdateQaConfig 配置写入分支接入统一的域名格式校验，杜绝绕过隐患；
  • 新增 settings_validation_test.go 单元测试，全面覆盖有效与各类恶意格式的拦截逻辑。
• 前端交互与预览沙盒体验增强：
  • 优化 Preview 沙盒实时更新过渡动效，消除硬核白屏并加固内部导航安全；
  • 优化项目管理台账全量过滤联动、抽屉动态资产状态，以及系统设置页 ESC 防误触；
  • 允许沙盒 iframe 弹出新窗口并安全放行 allow-popups。

破坏性变更与兼容性

• 是否包含破坏性变更：否。
• 依赖项与外部契约变化：未引入外部第三方依赖；全量 MCP 工具注册名与后端既有定义严格契约对齐。

运维与基础设施考量

• 配置 / 环境变量要求：无新增必填环境变量。
• 基础设施及 GitOps 影响：无。单二进制构建与多阶段 Docker 镜像打包流水线保持兼容。
• 注意事项：代码合入 master 分支后，由 CI/CD 自动执行测试门禁与发布流程。

验证与验收记录

• 测试覆盖与结果：
  • 前端单元测试：通过 pnpm --filter web test（35 个测试套件，171 项测试全绿）；
  • 前端工具集测试：通过 src/lib/mcp-connect.test.ts（20 项测试全部通过）；
  • 前端代码质量与规范：eslint 零错误，Prettier 格式校验全部通过，pnpm --filter web build 生产构建成功；
  • 后端质量门禁：通过 make check（包含版本连续性检查、go vet ./...、全包竞态测试 go test -race -count=1 ./...）。