清理已删除的模板242相关文档和引用
- 删除 template-242-overview.md 文档(模板242已被删除) - 更新 CLAUDE.md: * 修改角色定位为AI智能抽背助手开发助手 * 删除所有对模板242和工作空间223的引用 * 删除Next.js管理后台使用示例 * 删除Next.js管理后台BMAD安装示例 * 删除Next.js管理后台项目信息 * 更新模板概述文档表格,只保留模板244 - 更新 README.md: * 修改项目定位,移除对模板242的引用 * 删除Next.js管理后台项目进展部分 * 更新配置清单说明 现在文档完全聚焦于AI智能抽背助手项目(模板244,工作空间226) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
88
CLAUDE.md
88
CLAUDE.md
@@ -9,10 +9,8 @@ You are Next.js 管理后台开发助手, a specialized AI assistant.
|
||||
|
||||
## Your Capabilities
|
||||
|
||||
- 专门帮助开发Next.js管理后台的AI助手,熟悉React、Next.js、TypeScript、Tailwind CSS、Prisma等技术栈
|
||||
- 负责多个工作空间和模板的开发工作:
|
||||
- 工作空间223的模板242(Next.js管理后台)
|
||||
- 工作空间226的模板244(AI智能抽背助手Web应用)
|
||||
- 专门帮助开发AI智能抽背助手Web应用的AI助手,熟悉微信小程序开发、AI集成、教育科技应用等技术栈
|
||||
- 负责工作空间226的模板244(AI智能抽背助手Web应用)开发工作
|
||||
- 帮助用户构建包含前台、管理后台、API的完整全栈应用
|
||||
- You can access the conversation history for context
|
||||
- You provide helpful, accurate, and friendly responses
|
||||
@@ -24,7 +22,6 @@ You are Next.js 管理后台开发助手, a specialized AI assistant.
|
||||
使用 D8D MCP 管理多个开发容器:
|
||||
|
||||
**可用模板:**
|
||||
- 模板 242: Next.js 管理后台模板(工作空间223)
|
||||
- 模板 244: AI智能抽背助手Web应用(工作空间226)🆕
|
||||
|
||||
**常用命令(模板244 - AI智能抽背助手):**
|
||||
@@ -45,24 +42,6 @@ mcp__d8d__d8d_exec_dev_container_command(item_id=244, item_type="template", work
|
||||
mcp__d8d__d8d_get_dev_container_conversation_history(item_id=244, item_type="template", workspace_id=226)
|
||||
```
|
||||
|
||||
**常用命令(模板242 - Next.js管理后台):**
|
||||
```bash
|
||||
# 启动开发容器
|
||||
mcp__d8d__d8d_start_dev_container(item_id=242, item_type="template")
|
||||
|
||||
# 检查容器状态
|
||||
mcp__d8d__d8d_get_dev_container_status(item_id=242, item_type="template")
|
||||
|
||||
# 停止开发容器
|
||||
mcp__d8d__d8d_stop_dev_container(item_id=242, item_type="template")
|
||||
|
||||
# 在容器中执行命令
|
||||
mcp__d8d__d8d_exec_dev_container_command(item_id=242, item_type="template", command="命令")
|
||||
|
||||
# 获取容器对话历史
|
||||
mcp__d8d__d8d_get_dev_container_conversation_history(item_id=242, item_type="template")
|
||||
```
|
||||
|
||||
**子代理交互 (核心工具):**
|
||||
```bash
|
||||
# 调用模板244容器内的 Claude 子代理 (AI智能抽背助手开发)
|
||||
@@ -73,21 +52,13 @@ mcp__d8d__d8d_invoke_dev_container_subagent(
|
||||
message="你的问题或指令",
|
||||
backgroundMode=true/false # true:后台模式(推荐), false:前台模式
|
||||
)
|
||||
|
||||
# 调用模板242容器内的 Claude 子代理 (Next.js管理后台开发)
|
||||
mcp__d8d__d8d_invoke_dev_container_subagent(
|
||||
item_id=242,
|
||||
item_type="template",
|
||||
message="你的问题或指令",
|
||||
backgroundMode=true/false
|
||||
)
|
||||
```
|
||||
|
||||
**使用说明:**
|
||||
- 推荐使用 `backgroundMode=true` 后台模式
|
||||
- 超时时使用 `taskId` 查询结果
|
||||
- 保持 `session_id` 和 `assistant_message_uuid` 可继续对话
|
||||
- 模板244需要指定 `workspace_id=226`,模板242不需要(工作空间223为默认)
|
||||
- 模板244需要指定 `workspace_id=226`
|
||||
|
||||
### 容器内 BMAD 官方技能系统
|
||||
|
||||
@@ -127,14 +98,6 @@ mcp__d8d__d8d_invoke_dev_container_subagent(
|
||||
message="bmad-技能名称", # 技能触发命令
|
||||
backgroundMode=true # 推荐使用后台模式
|
||||
)
|
||||
|
||||
# 模板242(Next.js管理后台)- 不需要 workspace_id
|
||||
mcp__d8d__d8d_invoke_dev_container_subagent(
|
||||
item_id=242, # 模板 ID
|
||||
item_type="template", # 固定值
|
||||
message="bmad-技能名称", # 技能触发命令
|
||||
backgroundMode=true # 推荐使用后台模式
|
||||
)
|
||||
```
|
||||
|
||||
**使用示例(AI智能抽背助手 - 模板244):**
|
||||
@@ -167,33 +130,6 @@ mcp__d8d__d8d_invoke_dev_container_subagent(
|
||||
)
|
||||
```
|
||||
|
||||
**使用示例(Next.js管理后台 - 模板242):**
|
||||
```bash
|
||||
# 示例 1: 调用子代理使用 bmad-help 技能获取智能建议
|
||||
mcp__d8d__d8d_invoke_dev_container_subagent(
|
||||
item_id=242,
|
||||
item_type="template",
|
||||
message="bmad-help",
|
||||
backgroundMode=true
|
||||
)
|
||||
|
||||
# 示例 2: 调用子代理使用 bmad-quick-spec 快速定义变更
|
||||
mcp__d8d__d8d_invoke_dev_container_subagent(
|
||||
item_id=242,
|
||||
item_type="template",
|
||||
message="bmad-quick-spec",
|
||||
backgroundMode=true
|
||||
)
|
||||
|
||||
# 示例 3: 调用子代理使用 bmad-dev-story 实施开发
|
||||
mcp__d8d__d8d_invoke_dev_container_subagent(
|
||||
item_id=242,
|
||||
item_type="template",
|
||||
message="bmad-dev-story",
|
||||
backgroundMode=true
|
||||
)
|
||||
```
|
||||
|
||||
**重要提示**:
|
||||
- ❌ **不要**直接在外层环境调用 BMAD 技能 (它们不存在于外层)
|
||||
- ✅ **必须**通过 D8D 子代理在容器内调用 (BMAD 安装在容器内)
|
||||
@@ -261,14 +197,6 @@ mcp__d8d__d8d_invoke_dev_container_subagent(
|
||||
message="请在容器中执行: npx bmad-method install --modules bmm --tools claude-code --communication-language chinese --document-output-language chinese --yes",
|
||||
backgroundMode=false
|
||||
)
|
||||
|
||||
# 模板242(Next.js管理后台)- 不需要 workspace_id
|
||||
mcp__d8d__d8d_invoke_dev_container_subagent(
|
||||
item_id=242,
|
||||
item_type="template",
|
||||
message="请在容器中执行: npx bmad-method install --modules bmm --tools claude-code --communication-language chinese --document-output-language chinese --yes",
|
||||
backgroundMode=false
|
||||
)
|
||||
```
|
||||
|
||||
**官方 BMAD 安装内容包括:**
|
||||
@@ -280,7 +208,6 @@ mcp__d8d__d8d_invoke_dev_container_subagent(
|
||||
|
||||
**💡 推荐项目**:
|
||||
- 🆕 **模板244(AI智能抽背助手)**: 工作空间226,已安装需求文档,准备启动 BMAD PRD 流程
|
||||
- 模板242(Next.js管理后台): 工作空间223,可按需安装 BMAD
|
||||
|
||||
## 🎓 技能优先策略 (Skills-First Approach)
|
||||
|
||||
@@ -348,13 +275,6 @@ npx skills remove <skill-name>
|
||||
- **需求文档**: 已传输到容器 `/mnt/code/226-244-template-6/ai-tutor-requirements.md` (564行)
|
||||
- **项目信息文档**: `/mnt/code/226-244-template-6/PROJECT_INFO.md`
|
||||
|
||||
#### 🛠️ Next.js管理后台(模板项目)
|
||||
- **工作空间**: AI Agent Workspace (ID: 223)
|
||||
- **模板**: Next.js 管理后台模板 (ID: 242)
|
||||
- **容器访问地址**:
|
||||
- VSCode: `d8d-ai-vscode-23964-223-242-template-6-group.dev.d8d.fun`
|
||||
- 应用端口: `d8d-ai-vscode-8080-223-242-template-6-group.dev.d8d.fun`
|
||||
|
||||
## Project Documentation
|
||||
|
||||
### 模板概述文档
|
||||
@@ -363,7 +283,7 @@ npx skills remove <skill-name>
|
||||
|
||||
| 模板 | 概述文档 | 说明 |
|
||||
|------|---------|------|
|
||||
| 模板 242 | [template-242-overview.md](docs/template-242-overview.md) | Next.js 管理后台 - React + Next.js + Tailwind + Prisma |
|
||||
| 模板 244 | [template-244-overview.md](docs/template-244-overview.md) | AI智能抽背助手 - 微信小程序 + AI + 记忆曲线 |
|
||||
|
||||
**使用建议:**
|
||||
1. 在操作模板前,先阅读对应的概述文档了解项目结构
|
||||
|
||||
21
README.md
21
README.md
@@ -4,10 +4,9 @@
|
||||
|
||||
## 🎯 项目定位
|
||||
|
||||
这是一个 **AI 助手开发项目仓库**,目前包含两个主要项目:
|
||||
这是一个 **AI 助手开发项目仓库**,当前主要项目:
|
||||
|
||||
1. **Next.js 管理后台模板**(模板 242)- 工作空间 223
|
||||
2. **AI 智能抽背助手 Web 应用**(模板 244)- 工作空间 226 🆕
|
||||
1. **AI 智能抽背助手 Web 应用**(模板 244)- 工作空间 226 🆕
|
||||
|
||||
---
|
||||
|
||||
@@ -48,19 +47,6 @@
|
||||
|
||||
---
|
||||
|
||||
### 🛠️ Next.js 管理后台(模板项目)
|
||||
|
||||
**状态**: ✅ 已完成基础配置
|
||||
|
||||
**工作空间**: 223
|
||||
**模板**: 242
|
||||
|
||||
**技术栈**: Next.js + React + Tailwind CSS + Prisma
|
||||
|
||||
**详细文档**: [docs/template-242-overview.md](docs/template-242-overview.md)
|
||||
|
||||
---
|
||||
|
||||
## ✨ 模板特性
|
||||
|
||||
### 📦 开箱即用
|
||||
@@ -128,6 +114,9 @@ cp ai-assistant-starter/README.md my-project/
|
||||
cp ai-assistant-starter/.gitignore my-project/
|
||||
|
||||
# 2. 根据你的项目修改配置
|
||||
# - 修改 CLAUDE.md:更新为你的助手名称和职责
|
||||
# - 修改 README.md:更新项目说明
|
||||
# - 修改模板ID和工作空间ID
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
@@ -1,304 +0,0 @@
|
||||
# 模板 242: Next.js 管理后台 - 概述
|
||||
|
||||
## 📋 基本信息
|
||||
|
||||
| 属性 | 值 |
|
||||
|------|-----|
|
||||
| **模板名称** | Next.js 管理后台模板 |
|
||||
| **模板 ID** | 242 |
|
||||
| **工作空间 ID** | 223 (AI Agent Workspace) |
|
||||
| **容器访问** | `d8d-ai-vscode-23964-223-242-template-6-group.dev.d8d.fun` |
|
||||
| **应用端口** | `d8d-ai-vscode-8080-223-242-template-6-group.dev.d8d.fun` |
|
||||
|
||||
---
|
||||
|
||||
## 🎯 项目定位
|
||||
|
||||
这是一个**通用的 Next.js 全栈管理后台开发模板**,用于快速构建包含以下功能的完整应用系统:
|
||||
|
||||
- ✅ **前台用户界面** - 面向终端用户的 Web 界面
|
||||
- ✅ **管理后台** - 系统管理、数据统计、内容管理
|
||||
- ✅ **API 服务** - RESTful API / GraphQL
|
||||
- ✅ **数据库集成** - PostgreSQL + Prisma ORM
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ 技术栈
|
||||
|
||||
### 前端框架
|
||||
- **Next.js 14+** - React 框架,支持 App Router
|
||||
- **React 19** - UI 库
|
||||
- **TypeScript** - 类型安全
|
||||
- **Tailwind CSS** - 样式框架
|
||||
|
||||
### 后端 & 数据库
|
||||
- **Next.js API Routes** - 服务端 API
|
||||
- **Prisma ORM** - 数据库 ORM
|
||||
- **PostgreSQL** - 关系型数据库
|
||||
|
||||
### 开发工具
|
||||
- **ESLint** - 代码检查
|
||||
- **Prettier** - 代码格式化
|
||||
- **Git** - 版本控制
|
||||
|
||||
---
|
||||
|
||||
## 📁 项目结构
|
||||
|
||||
```
|
||||
template-242/
|
||||
├── app/ # Next.js App Router 目录
|
||||
│ ├── (auth)/ # 认证路由组
|
||||
│ │ ├── login/ # 登录页面
|
||||
│ │ └── register/ # 注册页面
|
||||
│ ├── (dashboard)/ # 后台路由组
|
||||
│ │ ├── layout.tsx # 后台布局
|
||||
│ │ ├── page.tsx # 后台首页
|
||||
│ │ ├── users/ # 用户管理
|
||||
│ │ └── settings/ # 系统设置
|
||||
│ ├── (public)/ # 前台路由组
|
||||
│ │ ├── page.tsx # 前台首页
|
||||
│ │ └── about/ # 关于页面
|
||||
│ ├── api/ # API 路由
|
||||
│ │ ├── auth/ # 认证 API
|
||||
│ │ ├── users/ # 用户 API
|
||||
│ │ └── trpc/ # tRPC API (可选)
|
||||
│ ├── layout.tsx # 根布局
|
||||
│ └── page.tsx # 根页面
|
||||
├── components/ # 共享组件
|
||||
│ ├── ui/ # UI 组件 (shadcn/ui)
|
||||
│ ├── forms/ # 表单组件
|
||||
│ └── layouts/ # 布局组件
|
||||
├── lib/ # 工具库
|
||||
│ ├── prisma.ts # Prisma 客户端
|
||||
│ ├── auth.ts # 认证工具
|
||||
│ └── utils.ts # 通用工具
|
||||
├── prisma/ # Prisma 配置
|
||||
│ ├── schema.prisma # 数据库模型
|
||||
│ └── migrations/ # 迁移文件
|
||||
├── public/ # 静态资源
|
||||
│ ├── images/ # 图片
|
||||
│ └── fonts/ # 字体
|
||||
├── styles/ # 样式文件
|
||||
│ └── globals.css # 全局样式
|
||||
├── types/ # TypeScript 类型定义
|
||||
├── .env.local # 环境变量
|
||||
├── next.config.js # Next.js 配置
|
||||
├── tailwind.config.ts # Tailwind 配置
|
||||
├── tsconfig.json # TypeScript 配置
|
||||
└── package.json # 项目依赖
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 快速开始
|
||||
|
||||
### 1. 启动开发容器
|
||||
|
||||
```bash
|
||||
# 使用 D8D MCP 启动容器
|
||||
mcp__d8d__d8d_start_dev_container(item_id=242, item_type="template")
|
||||
```
|
||||
|
||||
### 2. 检查容器状态
|
||||
|
||||
```bash
|
||||
mcp__d8d__d8d_get_dev_container_status(item_id=242, item_type="template")
|
||||
```
|
||||
|
||||
### 3. 访问应用
|
||||
|
||||
- **VSCode**: https://d8d-ai-vscode-23964-223-242-template-6-group.dev.d8d.fun
|
||||
- **应用**: http://d8d-ai-vscode-8080-223-242-template-6-group.dev.d8d.fun
|
||||
|
||||
### 4. 安装依赖 (首次运行)
|
||||
|
||||
```bash
|
||||
# 通过子代理在容器中执行
|
||||
mcp__d8d__d8d_invoke_dev_container_subagent(
|
||||
item_id=242,
|
||||
item_type="template",
|
||||
message="npm install",
|
||||
backgroundMode=false
|
||||
)
|
||||
```
|
||||
|
||||
### 5. 配置数据库
|
||||
|
||||
```bash
|
||||
# 初始化 Prisma
|
||||
mcp__d8d__d8d_invoke_dev_container_subagent(
|
||||
item_id=242,
|
||||
item_type="template",
|
||||
message="npx prisma generate && npx prisma db push",
|
||||
backgroundMode=false
|
||||
)
|
||||
```
|
||||
|
||||
### 6. 启动开发服务器
|
||||
|
||||
```bash
|
||||
mcp__d8d__d8d_invoke_dev_container_subagent(
|
||||
item_id=242,
|
||||
item_type="template",
|
||||
message="npm run dev",
|
||||
backgroundMode=true
|
||||
)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎨 核心功能
|
||||
|
||||
### 用户认证
|
||||
- ✅ 登录/注册
|
||||
- ✅ 密码重置
|
||||
- ✅ 会话管理
|
||||
- ✅ 权限控制
|
||||
|
||||
### 用户管理
|
||||
- ✅ 用户列表
|
||||
- ✅ 用户详情
|
||||
- ✅ 角色管理
|
||||
- ✅ 权限分配
|
||||
|
||||
### 数据管理
|
||||
- ✅ CRUD 操作
|
||||
- ✅ 数据导入/导出
|
||||
- ✅ 批量操作
|
||||
- ✅ 数据验证
|
||||
|
||||
### 系统设置
|
||||
- ✅ 系统配置
|
||||
- ✅ 日志查看
|
||||
- ✅ 数据备份
|
||||
- ✅ 性能监控
|
||||
|
||||
---
|
||||
|
||||
## 🔌 可用技能
|
||||
|
||||
### 全局技能 (已安装)
|
||||
- vercel-react-best-practices
|
||||
- nextjs-app-router-patterns
|
||||
- typescript-advanced-types
|
||||
- tailwind-design-system
|
||||
- prisma-database-setup
|
||||
- prisma-client-api
|
||||
- kpi-dashboard-design
|
||||
- fullstack-developer
|
||||
- typescript-react-reviewer
|
||||
|
||||
### 本地技能 (.claude/skills/)
|
||||
- docx - Word 文档处理
|
||||
- pptx - PowerPoint 处理
|
||||
- pdf - PDF 处理和 OCR
|
||||
- xlsx - Excel 表格处理
|
||||
- new-conversation - 新对话创建
|
||||
- skill-creator - 技能创建指南
|
||||
- mcp-builder - MCP 服务器构建
|
||||
- mcp-container-install-bmad - BMAD 安装
|
||||
|
||||
---
|
||||
|
||||
## 📖 开发指南
|
||||
|
||||
### 使用子代理进行开发
|
||||
|
||||
**推荐工作流**:
|
||||
```bash
|
||||
# 调用子代理执行开发任务
|
||||
mcp__d8d__d8d_invoke_dev_container_subagent(
|
||||
item_id=242,
|
||||
item_type="template",
|
||||
message="创建一个用户列表页面,包含搜索、分页和批量删除功能",
|
||||
backgroundMode=true
|
||||
)
|
||||
|
||||
# 如果使用 BMAD 工作流
|
||||
mcp__d8d__d8d_invoke_dev_container_subagent(
|
||||
item_id=242,
|
||||
item_type="template",
|
||||
message="bmad-quick-spec", # 快速定义变更
|
||||
backgroundMode=true
|
||||
)
|
||||
```
|
||||
|
||||
### 技能优先策略
|
||||
|
||||
在开发前先查询是否有相关技能:
|
||||
|
||||
```bash
|
||||
# 搜索相关技能
|
||||
npx skills find <关键词>
|
||||
|
||||
# 查看已安装技能
|
||||
npx skills list -g
|
||||
```
|
||||
|
||||
### 代码规范
|
||||
|
||||
- 使用 TypeScript 类型定义
|
||||
- 遵循 ESLint 规则
|
||||
- 使用 Prettier 格式化
|
||||
- 组件命名使用 PascalCase
|
||||
- 文件命名使用 kebab-case
|
||||
|
||||
---
|
||||
|
||||
## 🔗 相关链接
|
||||
|
||||
- **Gitea 仓库**: https://gitea.d8d.fun/d8dfun/nextjs-admin-assistant
|
||||
- **D8D 工作空间**: 223
|
||||
- **技能市场**: https://skills.sh/
|
||||
- **Next.js 文档**: https://nextjs.org/docs
|
||||
- **Prisma 文档**: https://www.prisma.io/docs
|
||||
|
||||
---
|
||||
|
||||
## 🆘 故障排查
|
||||
|
||||
### 容器无法启动
|
||||
```bash
|
||||
# 检查容器状态
|
||||
mcp__d8d__d8d_get_dev_container_status(item_id=242, item_type="template")
|
||||
|
||||
# 重启容器
|
||||
mcp__d8d__d8d_restart_dev_container(item_id=242, item_type="template")
|
||||
```
|
||||
|
||||
### 依赖安装失败
|
||||
```bash
|
||||
# 清理缓存重新安装
|
||||
mcp__d8d__d8d_invoke_dev_container_subagent(
|
||||
item_id=242,
|
||||
item_type="template",
|
||||
message="rm -rf node_modules package-lock.json && npm install",
|
||||
backgroundMode=false
|
||||
)
|
||||
```
|
||||
|
||||
### 数据库连接错误
|
||||
```bash
|
||||
# 检查环境变量
|
||||
mcp__d8d__d8d_invoke_dev_container_subagent(
|
||||
item_id=242,
|
||||
item_type="template",
|
||||
message="cat .env.local",
|
||||
backgroundMode=false
|
||||
)
|
||||
|
||||
# 重新生成 Prisma Client
|
||||
mcp__d8d__d8d_invoke_dev_container_subagent(
|
||||
item_id=242,
|
||||
item_type="template",
|
||||
message="npx prisma generate",
|
||||
backgroundMode=false
|
||||
)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**最后更新**: 2026-03-28
|
||||
**维护者**: d8dfun
|
||||
**AI 助手**: @nextjs-admin
|
||||
Reference in New Issue
Block a user