aid 418aa57ea8 Day4: 超管端设计优化 + UGC绘本创作社区P0实现

一、超管端设计优化
- 文档管理SOP体系建立，docs目录重组
- 统一用户管理：跨租户全局视角，合并用户管理+公众用户
- 活动监管全模块重构：全部活动（统计卡片+阶段筛选+SuperDetail详情页）、报名数据/作品数据/评审进度（两层合一扁平列表）、成果发布（去Tab+统计+隐藏写操作）
- 菜单精简：移除评委管理/评审规则/通知管理
- Bug修复：租户编辑丢失隐藏菜单、pageSize限制、主色统一

二、UGC绘本创作社区P0
- 数据库：10张新表（user_works/user_work_pages/work_tags等）
- 子女账号独立化：Child升级为独立User，家长切换+独立登录
- 用户作品库：CRUD+发布审核，8个API
- AI创作流程：提交→生成→保存到作品库，4个API
- 作品广场：首页改造为推荐流，标签+搜索+排序
- 内容审核（超管端）：作品审核+作品管理+标签管理
- 活动联动：WorkSelector作品选择器
- 布局改造：底部5Tab（发现/创作/活动/作品库/我的）

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-27 22:20:25 +08:00

3.8 KiB

Raw Blame History

Chrome DevTools MCP 安装和配置说明

✅ 安装状态

chrome-devtools-mcp 已通过 pnpm 全局安装完成。

📝 配置步骤

✅ 已配置（推荐方式）

项目已配置使用包装脚本，确保使用正确的 Node.js 版本。配置文件位于 .cursor/mcp.json：

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "/Users/wwzh/Awesome/runfast/competition-management-system/.cursor/scripts/chrome-devtools-mcp.sh"
    }
  }
}

方法 1：在 Cursor 用户设置中配置（备选）

如果项目配置不工作，可以在 Cursor 用户设置中添加：

打开 Cursor
按 Cmd + Shift + P (macOS) 或 Ctrl + Shift + P (Windows/Linux) 打开命令面板
输入 "Preferences: Open User Settings (JSON)"
在 settings.json 文件中添加以下配置：

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "/Users/wwzh/Awesome/runfast/competition-management-system/.cursor/scripts/chrome-devtools-mcp.sh"
    }
  }
}

方法 2：使用 npx（需要修复 npm 缓存权限）

如果 npm 缓存权限问题已修复，可以使用：

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["chrome-devtools-mcp@latest"]
    }
  }
}

修复 npm 缓存权限（需要 sudo 权限）：

sudo chown -R $(whoami) ~/.npm

🔍 验证安装

安装完成后，重启 Cursor，然后在 Chat 中应该可以看到 Chrome DevTools MCP 相关的工具。

📚 使用说明

Chrome DevTools MCP 提供了以下功能：

浏览器导航和页面快照
控制台消息查看
网络请求监控
页面元素交互（点击、输入等）
截图功能

⚠️ 注意事项

Node.js 版本要求：建议使用 Node.js 22.12.0 或更高版本（当前版本：20.19.0 LTS）
Chrome 浏览器：需要安装最新版本的 Google Chrome
首次使用：可能需要登录配置，之后会保存登录状态

🔧 故障排除

问题：MCP 服务器启动失败

检查步骤：

验证包装脚本是否可执行：

cd /Users/wwzh/Awesome/runfast/competition-management-system
source ~/.nvm/nvm.sh
.cursor/scripts/chrome-devtools-mcp.sh --version

应该输出：0.10.2

检查 Node.js 版本：
```
source ~/.nvm/nvm.sh
node --version
```
应该显示：v20.19.0
检查配置文件：
```
cat .cursor/mcp.json
```
确认路径正确

手动测试运行：

source ~/.nvm/nvm.sh
node /Users/wwzh/Library/pnpm/global/5/.pnpm/chrome-devtools-mcp@0.10.2/node_modules/chrome-devtools-mcp/build/src/index.js --version

检查 Cursor 日志：
- 打开 Cursor
- 查看输出面板（View → Output）
- 选择 "MCP" 或 "Chrome DevTools" 查看错误信息
重启 Cursor IDE：配置更改后需要完全重启 Cursor

常见错误

错误：command not found

确保包装脚本路径正确
检查脚本是否有执行权限：chmod +x .cursor/scripts/chrome-devtools-mcp.sh

错误：Node.js version mismatch

确保使用 Node.js 20.19.0：nvm use 20.19.0
检查包装脚本中的 nvm 路径是否正确

错误：npm cache permission denied

如果使用 npx 方式，需要修复权限：
```
sudo chown -R $(whoami) ~/.npm
```

重新安装

如果问题持续存在：

# 1. 卸载旧版本
pnpm remove -g chrome-devtools-mcp

# 2. 清理缓存
pnpm store prune

# 3. 重新安装
source ~/.nvm/nvm.sh
pnpm add -g chrome-devtools-mcp@latest

# 4. 验证安装
pnpm list -g chrome-devtools-mcp

3.8 KiB Raw Blame History Unescape Escape