Merge pull request #10 from xr843/feat/non-cli-onboarding

feat(onboarding): browser-first README + starter_questions for 8 masters

README.md

@@ -25,9 +25,10 @@
 </p>
 
 <p align="center">
+  <a href="#立即体验浏览器直接使用">浏览器体验</a> ·
   <a href="#声明">声明</a> ·
   <a href="#特性">特性</a> ·
-  <a href="#快速开始">安装</a> ·
+  <a href="#开发者安装">开发者安装</a> ·
   <a href="#预置法师">预置法师</a> ·
   <a href="#与-fojin-的关系">FoJin 集成</a> ·
   <a href="README_EN.md">English</a>
@@ -35,6 +36,34 @@
 
 ---
 
+## 立即体验（浏览器直接使用）
+
+> **大多数用户无需安装任何工具** —— 汉传佛教学习者、研究者、只想了解某位祖师思想的普通读者，都可以直接在浏览器里用。
+
+### 👉 [打开 fojin.app/chat](https://fojin.app/chat)
+
+在 AI 问答页面左下角点击「法师模式」，从 8 位汉传祖师中选一位即可开始对话。
+
+- 无需安装、无需注册
+- 所有 `/compare-masters` 多祖师对比功能同样可用
+- 内置 FoJin 的 503 个数据源、678K+ 语义向量做实时经证检索
+- 每条回答附 CBETA 经号原文出处
+
+**如果你不确定该找谁问，可以这样开始：**
+
+| 你的状况 | 推荐法师 |
+|---|---|
+| "妄念纷飞坐不住" | `/虚云` `/智顗`（参话头 / 止观） |
+| "读经文看不懂逻辑" | `/玄奘`（唯识严密分析） |
+| "学佛很久但无力感" | `/印光`（老实念佛） |
+| "想了解空性" | `/鸠摩罗什` `/慧能`（中观 / 禅直指） |
+| "想系统学华严 / 天台" | `/法藏` `/智顗`（判教与哲学体系） |
+| "在禅与净土之间犹豫" | `/蕅益`（跨宗派融通） |
+
+> 开发者、Claude Code / Cursor 用户可跳到下方 [开发者安装](#开发者安装) 小节，以 AgentSkill 形式在终端内使用。
+
+---
+
 > **v0.3 更新**：全面架构重构——CBETA 经文溯源（provenance frontmatter）、离线经文片段（sources/）、自动化保真度测试（fidelity.jsonl）、NPX 一键安装、cite.py/query.py 离线工具链。
 >
 > **v0.3 后续迭代**：`/create-master` 生成管线新增二阶段独立审查（教义准确性 → 风格一致性）、HARD-GATE 铁律（无 CBETA 引证不得写入）、多平台插件支持（Claude Code / Cursor / Codex / OpenCode / Gemini CLI 五端统一）、session-start hook 自动注入法师列表、8 位预置法师的 pressure tests 与 CI 验证流水线。
@@ -45,14 +74,6 @@
 
 ---
 
-## 在线体验
-
-无需安装任何工具，直接在浏览器中体验所有预置法师：
-
-**[fojin.app/chat](https://fojin.app/chat)** — 打开 AI 问答页面，左下角「法师模式」选择祖师即可开始对话。
-
----
-
 ## 声明
 
 本项目本着对佛教传统的尊重而建立。所有内容均依据佛教经典文献生成，不做教义评判，不代表任何宗派权威。生成内容仅供学习参考，如需正式修行指导，请亲近善知识。
@@ -76,7 +97,10 @@
 
 ---
 
-## 快速开始
+## 开发者安装
+
+> 👤 **只是想体验？** 直接用 [fojin.app/chat](https://fojin.app/chat)，跳过下面的安装步骤。
+> 🛠️ **本节面向**：Claude Code / Cursor / Codex CLI / OpenCode / Gemini CLI 用户，希望在终端 AgentSkill 环境中直接调用 `/xuanzang` `/huineng` 等命令。
 
 ### 安装
 

README_EN.md

@@ -28,9 +28,10 @@
 </p>
 
 <p align="center">
+  <a href="#try-it-now-browser-first">Browser</a> ·
   <a href="#seriousness-statement">Statement</a> ·
   <a href="#features">Features</a> ·
-  <a href="#quick-start">Install</a> ·
+  <a href="#developer-installation">Install</a> ·
   <a href="#pre-built-masters">Masters</a> ·
   <a href="#relationship-to-fojin">FoJin</a> ·
   <a href="README.md">中文</a>
@@ -38,6 +39,34 @@
 
 ---
 
+## Try It Now (Browser-First)
+
+> **Most users don't need to install anything.** Buddhist students, researchers, and curious readers can use every master directly in a web browser.
+
+### 👉 [Open fojin.app/chat](https://fojin.app/chat)
+
+On the AI Q&A page, open the **"法师模式"** (Master Mode) dropdown in the bottom-left and pick one of the 8 pre-built masters to start chatting.
+
+- No install, no signup
+- `/compare-masters` multi-master comparison works the same way
+- Live citation retrieval backed by FoJin's 503 sources and 678K+ semantic embeddings
+- Every answer carries a CBETA source ID
+
+**Not sure which master to ask?** Start here:
+
+| Your situation | Suggested master |
+|---|---|
+| "My mind is scattered, I can't sit still" | `/xuyun` `/zhiyi` (huatou / śamatha-vipaśyanā) |
+| "I can't follow the logic of the sutras" | `/xuanzang` (Yogācāra precision) |
+| "I've studied for years but feel stuck" | `/yinguang` (plain, sincere nianfo) |
+| "I want to understand emptiness" | `/kumarajiva` `/huineng` (Madhyamaka / direct pointing) |
+| "I want a systematic view of Huayan / Tiantai" | `/fazang` `/zhiyi` (classification and metaphysics) |
+| "I'm torn between Chan and Pure Land" | `/ouyi` (cross-tradition synthesis) |
+
+> Developers and Claude Code / Cursor users should skip to [Developer Installation](#developer-installation) to use the masters as terminal AgentSkills.
+
+---
+
 > **v0.3 Update**: Full architecture rebuild — CBETA provenance in frontmatter, offline source passages (`sources/`), automated fidelity tests (`fidelity.jsonl`), one-command NPX installer, and offline toolchain (`cite.py` / `query.py`).
 >
 > **Post-v0.3 iterations**: `/create-master` pipeline now enforces a two-stage independent review (doctrinal accuracy → voice consistency), HARD-GATE rules (no CBETA citation → no write), multi-platform plugin support across Claude Code / Cursor / Codex / OpenCode / Gemini CLI, a session-start hook that auto-injects the master list, plus pressure tests and CI validation for all 8 prebuilt masters.
@@ -54,14 +83,6 @@ This project is built out of respect for Buddhist traditions. All content is gen
 
 ---
 
-## Online Demo
-
-No installation required — try all pre-built masters directly in your browser:
-
-**[fojin.app/chat](https://fojin.app/chat)** — Open the AI Q&A page, select a master from the "法师模式" dropdown (bottom-left), and start chatting.
-
----
-
 ## Features
 
 - **8 pre-built Chinese Buddhist masters**: across Yogacara, Madhyamaka, Chan, Tiantai, Huayan, Pure Land, and cross-tradition — ready to use out of the box
@@ -79,7 +100,10 @@ No installation required — try all pre-built masters directly in your browser:
 
 ---
 
-## Quick Start
+## Developer Installation
+
+> 👤 **Just want to try it?** Use [fojin.app/chat](https://fojin.app/chat) in your browser and skip this section entirely.
+> 🛠️ **This section is for**: Claude Code / Cursor / Codex CLI / OpenCode / Gemini CLI users who want to invoke `/xuanzang`, `/huineng`, etc. directly as terminal AgentSkills.
 
 ### Installation
 

prebuilt/fazang/meta.json

@@ -79,5 +79,23 @@
       "毗卢遮那",
       "华严经"
     ]
-  }
+  },
+  "starter_questions": [
+    {
+      "q": "'事事无碍'听起来很玄，能举一个日常生活的例子吗？",
+      "why": "华严最高范畴的具象化，是初学最需要的台阶"
+    },
+    {
+      "q": "《华严经》八十卷太长读不下去，有没有一条精炼的入门路径？",
+      "why": "法藏《金师子章》《华严五教章》正是为此而作"
+    },
+    {
+      "q": "'十玄门'是十种角度还是十种修行方法？",
+      "why": "触及华严哲学体系的内部结构"
+    },
+    {
+      "q": "华严和天台都讲圆教，两家的'圆'有什么不同？",
+      "why": "这是法藏在与天台对话中反复处理的议题"
+    }
+  ]
 }

prebuilt/huineng/meta.json

@@ -69,5 +69,23 @@
       "菩提",
       "弘忍"
     ]
-  }
+  },
+  "starter_questions": [
+    {
+      "q": "六祖说'本来无一物'，但烦恼和身体明明还在，这不是自欺吗？",
+      "why": "直切禅门最容易被误解的核心悖论"
+    },
+    {
+      "q": "我想参禅但坐不住、念头太多，该怎么办？",
+      "why": "《坛经》中有针对妄念的直接对治方便"
+    },
+    {
+      "q": "'见性成佛'的'见'是看见吗？是悟吗？具体是什么体验？",
+      "why": "触及禅宗实修的核心目标，避免把'见性'变成概念游戏"
+    },
+    {
+      "q": "读经和参禅哪个更重要？六祖不识字怎么讲法？",
+      "why": "历史上反复被问的问题，直接听当事人的答案"
+    }
+  ]
 }

prebuilt/kumarajiva/meta.json

@@ -91,5 +91,23 @@
       "佛性",
       "大乘"
     ]
-  }
+  },
+  "starter_questions": [
+    {
+      "q": "'空'到底是在否定什么？是不是什么都没有？",
+      "why": "直接问中观最易被误解的核心，由《中论》译者回答最权威"
+    },
+    {
+      "q": "为什么龙树说'因缘所生法，我说即是空'？缘起和性空是同一件事吗？",
+      "why": "《中论》开篇根本偈，罗什译本是中文世界的标准"
+    },
+    {
+      "q": "'应无所住而生其心'——《金刚经》这句话该怎么理解？",
+      "why": "《金刚经》正是罗什译本，由译者本人解读最贴合"
+    },
+    {
+      "q": "中观所说的'二谛'（世俗谛 / 胜义谛）如何区分？学佛人如何在两谛之间行走？",
+      "why": "二谛是中观学派理解世界的基本坐标，直接源自罗什所传龙树学"
+    }
+  ]
 }

prebuilt/ouyi/meta.json

@@ -86,5 +86,23 @@
       "止观",
       "明末四大高僧"
     ]
-  }
+  },
+  "starter_questions": [
+    {
+      "q": "我学了禅、教、律、净几种法门，感觉互相矛盾，怎么融通？",
+      "why": "蕅益本人即是跨宗派综合的典范，此问是他的本职"
+    },
+    {
+      "q": "念佛是自力还是他力？'自性弥陀'与十万亿国土外的极乐是两回事吗？",
+      "why": "《弥陀要解》专门处理这个悖论，印光赞为'古佛再来不能超其上'"
+    },
+    {
+      "q": "如何判断自己的根器？应该修什么法门？",
+      "why": "《教观纲宗》正是蕅益为此写的根机判断工具书"
+    },
+    {
+      "q": "信、愿、行三资粮，哪一个最难？",
+      "why": "蕅益对'六信'的划分是净土宗最精密的分析"
+    }
+  ]
 }

prebuilt/xuanzang/meta.json

@@ -88,5 +88,23 @@
       "瑜伽师地论",
       "唯识三十颂"
     ]
-  }
+  },
+  "starter_questions": [
+    {
+      "q": "阿赖耶识和人们常说的'第八识'是一回事吗？",
+      "why": "从唯识严密术语入手，建立基本框架"
+    },
+    {
+      "q": "为什么要安立阿赖耶识？如果没有它会出什么问题？",
+      "why": "触及唯识学的根本动机——解决业报相续与轮回主体问题"
+    },
+    {
+      "q": "'三性'（遍计所执/依他起/圆成实）如何判断一件事属于哪一性？",
+      "why": "唯识判摄现象的核心工具，由玄奘译典体系解说最准确"
+    },
+    {
+      "q": "因明学的'因三相'是什么？和现代逻辑有什么异同？",
+      "why": "玄奘将因明传入中国，此问直触其方法论贡献"
+    }
+  ]
 }

prebuilt/xuyun/meta.json

@@ -74,5 +74,23 @@
       "南华寺",
       "云门寺"
     ]
-  }
+  },
+  "starter_questions": [
+    {
+      "q": "参话头的'话头'是念那句话吗？还是观那句话？怎么起疑情？",
+      "why": "虚云一生推广参话头，这是他最擅长的教授"
+    },
+    {
+      "q": "末法时代参禅还有用吗？是不是应该改修净土？",
+      "why": "虚云主张禅净双修，此问直击他的立场"
+    },
+    {
+      "q": "禅堂里为什么要'跑香'？走路和开悟有什么关系？",
+      "why": "丛林制度的具体细节最适合问这位亲历中国禅堂百年传统的老人"
+    },
+    {
+      "q": "参禅时身心出现境界（轻安、幻相、疑团）如何对待？",
+      "why": "虚云对禅病与境界的辨识是百年实证经验"
+    }
+  ]
 }

prebuilt/yinguang/meta.json

@@ -87,5 +87,23 @@
       "一函遍复",
       "印光"
     ]
-  }
+  },
+  "starter_questions": [
+    {
+      "q": "我业障很重，妄念不断，念佛真的能往生吗？",
+      "why": "《文钞》里被问了几万次的问题，印光的答案朴实有力"
+    },
+    {
+      "q": "念佛到底要念多少声？需要追求'一心不乱'吗？",
+      "why": "印光反复强调不要误解《阿弥陀经》此句，这是净土宗最常见的误区"
+    },
+    {
+      "q": "我怎么判断自己念佛是不是用对了方法？",
+      "why": "印光提出的'摄耳谛听'是具体可检的方法，由他本人讲最贴切"
+    },
+    {
+      "q": "家人反对我念佛学佛，该怎么办？",
+      "why": "《文钞》是书信体，最擅长处理学佛人的生活处境"
+    }
+  ]
 }

prebuilt/zhiyi/meta.json

@@ -82,5 +82,23 @@
       "小释迦",
       "圆融"
     ]
-  }
+  },
+  "starter_questions": [
+    {
+      "q": "'一念三千'是什么意思？一念真的能含三千世界吗？",
+      "why": "天台最著名也最难的核心教义，由创始者解释最准"
+    },
+    {
+      "q": "我想系统学佛但不知从哪部经开始，天台'五时八教'能帮我排序吗？",
+      "why": "判教体系的现实用途——给学人提供学习路线图"
+    },
+    {
+      "q": "止观双修具体怎么下手？应该先修止还是先修观？",
+      "why": "《摩诃止观》是这方面最系统的教科书"
+    },
+    {
+      "q": "《法华经·方便品》说'唯有一佛乘'，但前面又说三乘，这是否矛盾？",
+      "why": "天台以'开权显实'化解此矛盾，是其核心方法论"
+    }
+  ]
 }