https://gitee.com/justinlee_pb/zen-scale

汉传禅修修持记录系统 – 设计文档

一、项目概述

本系统是专为汉传禅修设计的修持记录与指导平台，旨在帮助禅修学员记录日常修持体验，禅师进行指导点评，管理员维护量表模板。系统采用 PHP + SQLite 架构，支持量表模板化编辑，保持汉传禅修本土特色。

---

二、量表设计说明

2.1 设计理念

不同于西方正念量表（如 MAAS、FFMQ 等）侧重于”觉知”、”接纳”等心理学概念，本系统的量表设计基于汉传禅修的传统修持体系，突出以下特色维度：

• 定力深浅：对应禅定的深浅层次，从粗住到细住，从欲界定到初禅
• 观慧明觉：对应智慧观照的清晰度和明利度
• 烦恼伏断：对应贪嗔痴等烦恼的调伏程度
• 身心轻安：对应禅修后的身心感受
• 慈悲心量：对应四无量心的修持进展
• 日用保任：对应日常生活中的觉照能力

2.2 评分方式

采用 5 级李克特量表（Likert Scale）：

• 1分：非常不符合
• 2分：比较不符合
• 3分：一般
• 4分：比较符合
• 5分：非常符合

支持反向计分题，用于负面表述的题目。

2.3 默认量表详解

量表一：数息观修持记录量表

适用人群：初学者，散乱心重者

维度设计（5个维度，10个题项）：

维度	权重	说明
定力深浅	1.0	专注力的稳定程度，妄念的多少
身心轻安	1.0	身体的放松程度与心理的安宁感
呼吸觉知	1.0	对呼吸出入的觉察清晰度
烦恼伏断	1.0	贪嗔痴等烦恼的调伏程度
出离喜乐	0.8	禅修后内心的喜悦与轻快感

题项示例：

• 定力深浅：坐禅期间，我的注意力能够持续专注在呼吸上
• 身心轻安：坐禅后，我的身体感到轻松舒畅
• 呼吸觉知：我能够清晰地觉知呼吸的出入
• 烦恼伏断（反向）：坐禅期间，我感到烦躁不安
• 出离喜乐：坐禅后，我感到内心喜悦

---

量表二：默照禅修持记录量表

适用人群：曹洞宗行者，有一定禅修基础者

核心特色：体现”默照双运”、”定慧等持”的曹洞宗禅法特色

维度设计（5个维度，10个题项）：

维度	权重	说明
默止力	1.0	妄念止息的程度，心的稳定性
观照明	1.0	智慧观照的清晰度，觉知的明利
默照双运	1.2	定与慧的平衡统一（核心维度）
身心空寂	1.0	人我法执的淡化，空性体验
日常保任	0.8	座下日常中保持觉照的能力

题项示例：

• 默止力：坐禅时，我的心能够安住不动，不随妄念流转
• 观照明：坐禅时，我的觉知清晰明利，不昏沉
• 默照双运：我能够做到”寂而常照，照而常寂”，定慧不二
• 身心空寂：坐禅中，我感到身心世界的执着淡化了
• 日常保任：在日常生活中，我也能保持觉照不迷失

---

量表三：话头禅修持记录量表

适用人群：临济宗行者，追求顿悟者

核心特色：体现”疑情”、”参究”、”桶底脱落”的临济宗看话禅特色

维度设计（5个维度，10个题项）：

维度	权重	说明
疑情深度	1.2	对话头的疑情程度（核心维度）
话头得力	1.0	话头提持的力量，妄念的伏断
身心世界	0.8	参禅中的身心反应与境界
般若相应	1.0	与空性智慧的相应程度
日用中力	0.8	日常生活中话头的保任力量

题项示例：

• 疑情深度：参话头时，我生起了真切的疑情
• 话头得力：话头提持时，妄念自然减少
• 身心世界：参禅中，我感到身心世界如同幻化
• 般若相应：我体验到”言语道断，心行处灭”的境界
• 日用中力：在日常生活中，话头也能时时现前

---

量表四：慈悲观修持记录量表

适用人群：嗔心重者，修四无量心者

核心特色：体现慈悲喜舍四无量心的修持体系

维度设计（5个维度，10个题项）：

维度	权重	说明
慈心无量	1.0	愿一切众生得乐的慈心
悲心无量	1.0	愿一切众生离苦的悲心
喜心无量	0.8	见众生得乐而生随喜
舍心无量	1.0	怨亲平等的舍心
嗔恚伏断	1.0	嗔恨心的调伏程度

题项示例：

• 慈心无量：我真诚地祝愿一切众生都能得到快乐
• 悲心无量：我真诚地祝愿一切众生都能脱离痛苦
• 喜心无量：看到他人快乐时，我也感到由衷的喜悦
• 舍心无量：我对怨敌和亲眷都能生起平等的慈悲心
• 嗔恚伏断（反向）：当别人伤害我时，我会生起强烈的嗔恨心

---

量表五：不净观修持记录量表

适用人群：贪心重者，对治贪欲烦恼

核心特色：体现不净观、白骨观的修持方法

维度设计（5个维度，10个题项）：

维度	权重	说明
观想清晰	1.0	不净观想的清晰度
贪欲伏断	1.2	对色身贪欲的调伏程度（核心）
无常体悟	1.0	对诸行无常的体会
出离心	1.0	对世间贪着的出离意愿
身心轻安	0.8	修观后的身心感受

题项示例：

• 观想清晰：我能够清晰地观想身体的不净相
• 贪欲伏断：修不净观后，我对美色的贪着减轻了
• 无常体悟：我深刻体会到”诸行无常”的道理
• 出离心：我对世间五欲的贪着越来越淡
• 身心轻安：修不净观后，我感到内心清净

---

2.4 量表模板化设计

系统支持管理员动态编辑量表模板，包括：

1. 量表基本信息：名称、描述、禅修方法、评分方式、状态
2. 维度管理：增删维度、调整排序、设置权重
3. 题项管理：增删题项、设置反向计分、调整排序
4. 选项管理：自定义选项文本和分值

---

三、产品交互说明

3.1 三端架构

系统采用三端分离设计：

• 学员端：填写量表、查看记录、接收评语
• 老师端：学员管理、查看记录、点评指导
• 管理端：量表模板管理、用户管理

---

3.2 学员端交互流程

首页（student_dashboard.php）

• 欢迎信息
• 统计卡片：修持记录数、可用量表数、累计坐禅时长
• 最近修持记录列表
• 今日推荐量表

量表列表（student_scales.php）

• 展示所有可用量表卡片
• 每个卡片显示：量表名称、禅修方法标签、描述、维度数
• 点击卡片进入填写页面
• 底部附修持建议说明

填写量表（student_fill_scale.php）

• 量表基本信息展示
• 修持基本信息：日期、时长
• 按维度分组展示题项
• 每题5个选项，单选
• 修持心得文本框（选填）
• 提交后跳转到详情页

记录列表（student_records.php）

• 表格展示所有修持记录
• 支持按量表筛选
• 显示：日期、量表名称、时长、总分、老师评语状态
• 点击查看详情

记录详情（student_record_detail.php）

• 综合得分大数字展示
• 各维度得分卡片（含进度条）
• 修持心得
• 答题详情（按维度分组）
• 老师评语区（绿色背景突出显示）

---

3.3 老师端交互流程

首页（teacher_dashboard.php）

• 欢迎信息
• 统计卡片：在修学员数、待点评数、总记录数
• 学员卡片列表，显示每个学员的记录数和最近记录

学员管理（teacher_students.php）

• 学员列表表格
• 显示：姓名、用户名、记录数、最近记录
• 点击查看该学员的所有记录

记录列表（teacher_records.php）

• 所有学员的修持记录
• 支持按学员筛选、按点评状态筛选
• 显示：学员、量表、日期、时长、总分、状态
• 待点评的记录突出显示

记录详情+点评（teacher_record_detail.php）

• 学员答题详情完整展示
• 综合得分和各维度得分
• 学员修持心得
• 答题详情
• 评语输入框，支持添加/修改评语
• 提交后学员即可看到

---

3.4 管理端交互流程

首页（admin_dashboard.php）

• 系统概览统计：总用户数、禅师数、量表模板数、修持记录数
• 最近修持记录列表

量表管理（admin_scales.php）

• 量表模板列表
• 显示：名称、禅修方法、维度数、题项数、状态、创建时间
• 操作：导出、编辑、删除
• 新建量表按钮
• 导入量表按钮

量表导出（admin_scale_export.php）

• 一键导出量表为标准 JSON 格式文件
• 导出内容包含：量表基本信息、所有维度配置、所有题项及选项、评分规则
• 文件命名规范：{量表标识}_v{版本号}_{日期}.json

量表导入（admin_scale_import.php）

• 上传 JSON 格式的量表文件
• 自动格式校验和数据完整性检查
• 支持两种导入模式：
  • 新增量表：作为全新量表导入
  • 覆盖更新：按名称匹配并更新已有量表
• 导入前数据预览确认
• 详细的错误和警告提示

量表编辑器（admin_scale_edit.php）

核心功能页面，支持：

1. 量表基本信息编辑

   • 名称、描述、禅修方法
   • 评分方式、最高分、最低分
   • 启用/禁用状态

2. 维度管理

   • 维度列表展示（含权重）
   • 添加新维度：名称、描述、排序、权重
   • 删除维度（会级联删除题项）

3. 题项管理

   • 每个维度下的题项列表
   • 标记反向计分题
   • 添加新题项：内容、排序、是否反向计分
   • 删除题项
   • 默认添加5级李克特选项

用户管理（admin_users.php）

• 添加用户：用户名、密码、真实姓名、角色、所属禅师
• 用户列表：显示基本信息和角色
• 禁用用户操作

---

四、技术架构

4.1 技术栈

• 后端语言：PHP 7.0+
• 数据库：SQLite 3
• 前端：原生 HTML/CSS/JavaScript
• 架构：面向对象，单入口多页面

4.2 目录结构

chanxiu_scale/
├── config.php              # 系统配置
├── install.php             # 数据库初始化脚本
├── login.php               # 登录页
├── logout.php              # 登出
├── student_dashboard.php   # 学员首页
├── student_scales.php      # 学员-量表列表
├── student_fill_scale.php  # 学员-填写量表
├── student_records.php     # 学员-记录列表
├── student_record_detail.php  # 学员-记录详情
├── teacher_dashboard.php   # 老师首页
├── teacher_students.php    # 老师-学员管理
├── teacher_records.php     # 老师-记录列表
├── teacher_record_detail.php  # 老师-记录详情+点评
├── admin_dashboard.php     # 管理首页
├── admin_scales.php        # 管理-量表列表
├── admin_scale_edit.php    # 管理-量表编辑器（核心）
├── admin_scale_export.php  # 管理-量表导出
├── admin_scale_import.php  # 管理-量表导入
├── admin_users.php         # 管理-用户管理
├── css/
│   └── style.css           # 样式表
├── js/
│   └── (前端交互脚本)
├── includes/
│   ├── Database.php        # 数据库单例类
│   ├── Auth.php            # 用户认证类
│   ├── ScaleManager.php    # 量表管理类
│   └── header.php          # 公共头部
├── docs/                   # 文档目录
│   ├── scale_format_standard.md  # 量表格式标准说明
│   └── examples/           # 示例文件
│       └── shuxi_guan_scale_v1.0_20240620.json
└── uploads/                # 上传目录

4.3 数据库表结构

1. users – 用户表
2. scale_templates – 量表模板表
3. dimensions – 维度表
4. questions – 题项表
5. question_options – 题项选项表
6. scale_records – 量表记录表
7. answers – 答案表
8. dimension_scores – 维度得分表

---

五、安装与使用

5.1 环境要求

• PHP 7.0 或更高版本
• PHP SQLite3 扩展
• 支持 PDO

5.2 安装步骤

1. 将项目文件放置到 Web 服务器目录
2. 确保目录有写入权限（用于创建 SQLite 数据库文件）
3. 首次访问运行 install.php 初始化数据库
4. 删除或保护 install.php 文件
5. 使用默认账号登录

5.3 默认测试账号

• 管理员：admin / admin123
• 禅师：teacher01 / teacher123（慧明禅师）
• 学员：student01 / student123（张居士）

---

六、设计特色总结

1. 汉传特色：基于汉传禅修传统体系设计，不照搬西方正念量表
2. 方法对应：不同禅修方法（数息、默照、话头、慈悲、不净）对应不同维度组合
3. 模板化：量表完全可配置，支持动态增删维度和题项
4. 三端交互：学员记录、老师点评、管理员维护，流程完整
5. 禅意设计：棕色系配色，简洁素雅，符合禅修氛围
6. 标准化交换：支持量表导入导出，采用标准 JSON 格式，便于量表分享和版本管理

---

七、量表格式标准

系统采用标准化的 JSON 格式进行量表的导入导出，支持量表的跨系统交换和版本管理。

7.1 格式特点

• 人类可读：JSON 格式，易于编辑和调试
• 结构完整：包含量表基本信息、维度、题项、选项、评分规则
• 版本化：内置 schema_version 字段，支持向前兼容
• 校验机制：导入时自动校验格式，提供详细错误和警告信息

7.2 核心结构

{
  "schema_version": "1.0",
  "scale": {
    "name": "量表名称",
    "method_type": "禅修方法",
    "version": "1.0"
  },
  "dimensions": [
    {
      "name": "维度名称",
      "weight": 1.0,
      "questions": [...]
    }
  ],
  "scoring_rules": {...}
}

7.3 导入模式

• 新增模式：作为全新量表导入
• 覆盖模式：按名称匹配并更新已有量表

7.4 详细文档

完整的格式标准说明请参见：docs/scale_format_standard.md

示例文件：docs/examples/shuxi_guan_scale_v1.0_20240620.json