光福寺智慧寺院小程序完整知识库

📱 项目基本信息

• 项目名称: 光福寺智慧寺院小程序
• 项目类型: WeChat Miniprogram (微信小程序)
• AppID: wxf3d2e1fe03b26d77
• 技术栈: TDesign + CloudBase
• 云环境: guangfu-temple-dev
• 基础模板: 电商模板二次开发

---

🔧 CLAUDE.md 核心开发准则

AI编程核心规则

1. 永远先搜索再实现 - 避免重复开发
2. 永远先验证库和API是否存在 - 防止假设错误
3. 永远选择最简单的解决方案 - 简洁优于复杂
4. 永远只实现当前明确需要的功能 - 避免过度设计
5. 永远遵循项目现有模式 - 保持一致性
6. 永远使用MCP工具而非编写脚本 - 利用现有工具链
7. 永远立即清理错误的代码和缓存 - 保持清洁

防止AI幻觉准则

1. 不要发明不存在的函数 - 必须验证API存在性
2. 不要假设API行为 - 查阅官方文档
3. 不要创造听起来合理的方法名 - 使用实际存在的方法
4. 不要推荐过时的包 - 检查版本和维护状态
5. 不要使用5年前的语法 - 采用现代语法
6. 不要猜测包名 - 确认正确的包名
7. 不要编造配置项 - 查阅真实配置文档

避免过度设计

1. 不要添加未被要求的功能 - 严格按需开发
2. 不要创建预防性抽象 - 等待真实需求
3. 不要考虑假设的未来需求 - 关注当前需求
4. 不要构建通用框架 - 解决具体问题
5. 不要过早优化 - 先实现后优化
6. 不要创建不必要的配置 - 简化配置项
7. 不要重新造轮子 - 使用现有解决方案

---

🚨 Context-7 MCP知识库

核心规则 - 违反即失败

1. 这是hooks+MCP系统 - 不是传统开发环境
2. 严禁文件监听 - 已有54个hooks处理所有监听需求
3. 严禁重复造轮子 - 必须使用现有tools/工具链
4. 基于Agent协作 - 通过Agent函数而非直接编码
5. 严禁创建新脚本 - 只能修改现有脚本
6. 必须验证真实结果 - 避免AI幻觉

MCP工具集概览

1. Task - Agent任务协作
2. WebSearch - 网络搜索
3. WebFetch - 网页内容获取
4. TodoWrite - 任务管理
5. Grep/Glob - 文件搜索
6. Read/Write/Edit - 文件操作
7. Bash - 命令执行

54个Hooks系统架构

• 文件监听hooks: 15个 - 监控代码变更
• 自动格式化hooks: 12个 - 代码风格统一
• 代码检查hooks: 10个 - 质量保证
• 测试运行hooks: 8个 - 自动化测试
• 部署hooks: 7个 - 自动部署流程

Agent协作模式

• Analyst - 需求分析
• Architect - 架构设计
• Dev - 开发实现
• QA - 质量保证
• PM - 项目管理

---

📋 项目架构 - Stories系统

核心Stories映射

• STORY-001: 禅境首页 - 智慧门户

  • 页面: pages/001/001.js, pages/home/home.js
  • QA门: STORY-001-zen-homepage.yml

• STORY-002: 祈福中心 - 数字祈愿

  • 页面: packages/blessing/blessing-cards/index.js
  • 页面: packages/blessing/adopt-tree/index.js
  • 页面: packages/blessing/merit-wall/index.js
  • QA门: STORY-002-blessing-center.yml

• STORY-003: 学习模块 - 佛法传播

  • 页面: pages/learning/daily-dharma/index.js
  • 页面: pages/learning/library/index.js
  • 页面: pages/learning/scriptures/index.js
  • 页面: pages/learning/teachings/index.js
  • QA门: STORY-003-learning-module.yml

• STORY-004: 结缘市集 - 法物请购

  • 页面: pages/cart/index.js
  • 页面: pages/goods/category/index.js
  • 页面: pages/goods/details/index.js
  • QA门: STORY-004-dharma-market.yml

• STORY-005: 用户中心 - 修行档案

  • 页面: pages/usercenter/index.js
  • 页面: pages/usercenter/achievements/index.js
  • QA门: STORY-005-user-center.yml

• STORY-100: 云开发集成

  • QA门: STORY-100-cloud-integration.yml

• STORY-101: Hooks系统架构

• STORY-102: MCP工具集成

保护路径 - 核心架构文件

miniprogram/services/    # API服务层
miniprogram/utils/       # 工具函数
miniprogram/config/      # 配置文件
miniprogram/app.js       # 应用入口
miniprogram/project.config.json
.bmad-core/              # BMAD方法论核心
tools/mcp/               # MCP工具集
CLAUDE.md                # 开发准则

---

🔌 MCP工具集成配置

可用MCP服务器

• context-7: 历史开发知识库 + Agent共享资源库
• agent-collaboration: Agent协作系统
• figma-developer: Figma设计集成
• github: GitHub API集成
• playwright: 自动化测试
• superdesign: 设计系统集成
• windows: Windows系统集成

MCP集成配置

• 配置文件: .claude-code/mcp-settings.json
• 使用阶段: PRE-07
• 云端同步: 腾讯云开发环境 guangfu-temple-dev

---

🏯 寺院特色功能模块

底部导航栏（5个固定Tab）

1. 禅境（首页） - 时令显示、今日法会、快捷入口
2. 探索（导览） - 智能地图、12大殿标记、实时导航
3. 祈愿（祈福） - 供灯祈福、功德记录、超度服务
4. 结缘（市集） - 法物请购、善款捐赠、结缘服务
5. 心境（我的） - 修行档案、成就系统、个人设置

核心功能特色

• 佛教学习: 经文、每日法语、冥想指导
• 寺院服务: 祈福预约、捐赠记录、义工报名
• 社区功能: 活动预约、禅修共修、法会直播
• 电商功能: 法物请购、收养服务、素斋预订
• 用户中心: 修行追踪、成就勋章、修行统计

---

🛠️ 技术架构详解

数据流架构

1. Mock/Real数据切换: config/index.js 中 useMock 标志控制
2. 服务层: 所有API调用通过 services/ 模块
3. CloudBase集成: 使用 @cloudbase/wx-cloud-client-sdk
4. 模型层: model/ 目录中的业务逻辑抽象

开发命令

npm install                    # 安装依赖
npm run lint                   # 代码检查
npm run lint -- --fix         # 修复代码问题
npm run check                  # 质量检查
npm run changelog              # 生成更新日志

部署流程

1. 切换 useMock 为 false (生产环境)
2. 配置CloudBase环境ID (app.js)
3. 在微信开发者工具中构建npm包
4. 使用微信开发者工具预览和发布

---

📚 微信开发者工具错误检测

问题诊断

• 问题: 自动化脚本报告成功但实际有3044个错误
• 根因: 脚本只检查UI文本，未连接真实错误数据

解决方案

// 正确的错误获取方法
async getRealErrors() {
    const result = await this.bridge.getConsoleErrors();
    const bridgeErrors = result.errors || [];
    return bridgeErrors;
}

端口配置

• 微信开发者工具端口: 33157 (不是45967)
• CLI自动发现: cli.bat auto --auto-port 33157

---

🎯 快速开始指南

新Agent第一步

1. 阅读 CLAUDE.md - 核心开发准则
2. 查看 /hooks 列表 - 了解54个hooks功能
3. 熟悉 tools/ 目录 - 掌握工具链
4. 使用 TodoWrite - 规划任务管理

项目特定规则

• 开发模式: Mock数据优先
• 命令前缀: 使用 / 调用命令
• 文件修改: 通过hooks系统，禁止直接文件监听
• 脚本创建: 严禁创建新脚本，只能改进现有工具

---

记住：先搜索，后实现。先验证，后声称。先协作，后独立。永不创建新脚本，只改进现有工具。