master-skill 0.10.1 → 0.12.0

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "master-skill",
       "description": "FoJin-powered Buddhist AI persona framework — source-grounded, boundary-aware, fidelity-tested, runtime-ready. 15 prebuilt masters across 印度/汉传/藏传/南传 plus compare, debate, and curriculum meta-skills.",
-      "version": "0.10.1",
+      "version": "0.12.0",
       "source": "./",
       "author": {
         "name": "xr843",

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "master-skill",
   "description": "FoJin-powered Buddhist AI persona framework — source-grounded, boundary-aware, fidelity-tested, runtime-ready. 15 prebuilt masters across 印度/汉传/藏传/南传 plus compare, debate, and curriculum meta-skills.",
-  "version": "0.10.1",
+  "version": "0.12.0",
   "author": {
     "name": "xr843",
     "email": "xr843@users.noreply.github.com"

package/.cursor-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "master-skill",
   "displayName": "Master Skill",
   "description": "FoJin-powered Buddhist AI persona framework — source-grounded, boundary-aware, fidelity-tested, runtime-ready. 15 prebuilt masters across 印度/汉传/藏传/南传.",
-  "version": "0.10.1",
+  "version": "0.12.0",
   "author": {
     "name": "xr843",
     "email": "xr843@users.noreply.github.com"

package/GEMINI.md

@@ -1,2 +1,2 @@
 @./SKILL.md
-@./prebuilt/compare/SKILL.md
+@./prebuilt/compare-masters/SKILL.md

package/README.md

@@ -15,7 +15,7 @@
 </p>
 
 <p align="center">
-  <sub><em>Secured by SHA-pinned GitHub Actions · npm provenance · OIDC Trusted Publishing — see <a href="SECURITY.md">SECURITY.md</a>.</em></sub>
+  <sub><em>Secured by SHA-pinned GitHub Actions · npm provenance · OIDC Trusted Publishing · CodeQL · cargo-audit · pip-audit — see <a href="SECURITY.md">SECURITY.md</a>.</em></sub>
 </p>
 
 <p align="center">
@@ -57,8 +57,8 @@
 
 - 无需安装、无需注册
 - 三种教学模式均可用：`/compare-masters` 多祖师对比、`/master-debate` 祖师辩论、`/master-curriculum` 学修路径（含跨传统）
-- 内置 FoJin 的 503 个数据源、678K+ 语义向量做实时经证检索
-- 每条回答附原典出处（CBETA 经号 / BDRC 藏文典籍号 / SuttaCentral 巴利经号）
+- 由 FoJin 的 10K+ 篇文本、678K+ 条语义向量做实时经证检索
+- 回答按各位祖师声明的格式附原典出处：汉传多为 CBETA 经号，藏传为 Toh / BDRC 编号，南传为 PTS / SuttaCentral 出处（南传与部分藏传来源本就没有逐段编号，引文契约里明文如此）
 
 **如果你不确定该找谁问，可以这样开始：**
 
@@ -83,48 +83,38 @@
 
 ## 效果示例
 
-下面是一次真实的 `/master-huineng`（慧能大师）问答——注意每个教义断言都附 CBETA 经证，且回答风格贴合祖师本人（直指、平实、善用譬喻）：
+下面是一次真实的 `/master-huineng`（慧能大师）回答，**原文照录，未作删改**（仅为显示折行）。它来自 2026-08-31 的全量评测——模型 `deepseek-v4-flash`，commit [`06b8142`](https://github.com/xr843/Master-skill/commit/06b814204082b3e4738185cf3eefa44ed149f9f0)，即[存档](eval/reports/0.11.0-06b8142-deepseek.json)中 `master-huineng` 的 index 1。判分为 PASS；文中 5 处引文都带经号，并由仓库的离线引文审计逐条解析到慧能声明的来源（T48n2008《六祖大师法宝坛经》、T08n0235《金刚经》）：
 
 ```text
-你：我想参禅但坐不住、念头太多，该怎么办？
+你：顿悟和渐修有什么区别？
 
 慧能大师：
-你说「坐不住」，是把坐姿当成了禅；你说「念头太多」，是把念头当成了
-敌人。这两样都不是禅。
 
-何名坐禅？外于一切善恶境界，心念不起，名为「坐」；内见自性不动，名
-为「禅」。坐不是腿的事，是心于境上不起执的事。
-  【《六祖大师法宝坛经·坐禅品》】→ https://fojin.app/texts/58
+且道：顿与渐，果是二法么？
 
-念头来了不必怕。「于诸境上心不染，曰无念」——不是要你没有念头，是念
-起而不随它跑、不被它粘住。如云过空，空不曾动。
-  【《六祖大师法宝坛经·定慧品》】→ https://fojin.app/texts/58
+法本无顿渐，因人有利钝。经云：“不悟即佛是众生，一念悟时众生是佛”——迷悟只
+在一念，故立顿名；又说“前念迷即凡夫，后念悟即佛”——转迷成悟，不假外求
+【《六祖坛经·般若品》，T48n2008】→ https://fojin.app/texts/58
 
-所以不要和念头打仗。你一对治，就又添一个念。但看念起念灭，知它无
-住，它自然歇。
+北宗神秀大师题偈：“身是菩提树，心如明镜台，时时勤拂拭，勿使惹尘埃。”——是
+渐渐扫除妄染之方便。六祖呈偈：“菩提本无树，明镜亦非台。本来无一物，何处
+惹尘埃。”——是直显自性本空，无一法可染
+【《六祖坛经·行由品》，T48n2008】→ https://fojin.app/texts/58。一者作意
+对治，一者直下承当。此二偈，正是顿渐之分野。
 
-如需深入学习，可在 FoJin (fojin.app) 查阅原典。
-```
+然顿渐非二法。定慧尚是一体——“定是慧体，慧是定用，即慧之时定在慧，即定之
+时慧在定”【《六祖坛经·定慧品》，T48n2008】→ https://fojin.app/texts/58，
+顿渐岂有两般？迷人渐修，悟人顿契，药对病施，法无高下
+【《六祖坛经·定慧品》，T48n2008】→ https://fojin.app/texts/58。
 
-> ⚠️ 以上为 **AI 合成内容**，依据《坛经》文献生成，不代表慧能大师亲口开示。多位法师并列回答的 `/compare-masters` 效果，可直接在 [fojin.app/chat](https://fojin.app/chat) 体验。
+更须知，六祖当年闻“应无所住而生其心”而自见本性
+【《金刚经》，T08n0235】→ https://fojin.app/texts/7。顿悟不是无心，是于
+境不住；渐修不是死坐，是念念自觉。归到究竟，只问一念回光，本心现前也未？
 
----
+如需深入学习，可在 FoJin (fojin.app) 查阅原典。
+```
 
-> **v0.6 更新（2026-05-02）**：Slash 命令命名空间整理——14 位法师斜杠命令统一加 `master-` 前缀。`/master-zhiyi`、`/master-huineng`、…。
-> - **目的**：当 Claude Code 已装 50+ skill 时，单词 slash 命令容易混入其他 skill 列表；前缀化让 14 位法师在 `/m<tab>` 补全时聚类，识别度大幅提升
-> - **未受影响**：`compare-masters` / `create-master` 两个 meta-skill 命令保持原样（避免 `/master-compare-masters` 重复前缀）；fojin.app/chat 网页端 dropdown 与 API 完全解耦，**`master_profiles.py` 不变**
-> - **NPX 安装**：`npx master-skill install zhiyi`（短）和 `install master-zhiyi`（全）皆可，安装目标统一为 `~/.claude/skills/master-<slug>/`
-> - 详情见 [CHANGELOG.md §0.6.0](CHANGELOG.md#060--2026-05-02)
->
-> **v0.5 更新（2026-05-02）**：第二轮跨传统扩展——藏传 / 南传各从 1 位扩至 3 位，共 **14 位**祖师。
-> - 藏传新增：阿底峡尊者（噶当派开祖 · Toh 4465《菩提道灯论》· 三士道）+ 宗喀巴大师（格鲁派创始人 · 三主要道 · 应成中观正见）
-> - 南传新增：觉音尊者（《清净道论》Visuddhimagga 论师顶峰）+ 马哈希尊者（缅甸内观 · 标记法 · ETHICS Tier B 特例）
-> - HARD-GATE 强化：马哈希尊者特别 `NO_ATTAINMENT_JUDGMENT`（AI 不得对个体作证果判定）
-> - ETHICS Tier A 表扩至 11 位，Tier B 特例新增马哈希（与阿姜查同款条款）
->
-> **v0.4 更新（2026-05-02）**：首轮跨传统扩展——新增藏传米拉日巴尊者（噶举派 · 大手印）与南传阿姜查（泰国森林禅林派）。引用体系扩展支持 BDRC（藏文典籍）与 SuttaCentral（巴利三藏）。HARD-GATE 新增 `no_esoteric_instruction` 与 `no_fabricated_quotes`。
->
-> **v0.3**：全面架构重构——CBETA 经文溯源、离线经文片段、自动化保真度测试、NPX 一键安装、cite.py/query.py 离线工具链、二阶段独立审查、HARD-GATE 铁律、多平台插件（Claude Code / Cursor / Codex / OpenCode / Gemini CLI 五端统一）、session-start hook 自动注入法师列表。
+> ⚠️ 以上为 **AI 合成内容**，依据《坛经》《金刚经》文献生成，不代表慧能大师亲口开示。多位法师并列回答的 `/compare-masters` 效果，可直接在 [fojin.app/chat](https://fojin.app/chat) 体验。
 
 ---
 
@@ -142,17 +132,17 @@ Master-skill 是由 [FoJin](https://fojin.app) 驱动的佛教 AI 祖师人格
 
 ## 特性
 
-- **预置十五位四大传统祖师**：1 位印度（龙树 · 中观）+ 8 位汉传（唯识、中观、禅、天台、华严、净土、跨宗派）+ 3 位藏传（阿底峡 · 噶当；宗喀巴 · 格鲁；米拉日巴 · 噶举）+ 3 位南传（觉音 · 上座部论师；马哈希 · 缅甸内观；阿姜查 · 泰国森林）—— 另含 `compare-masters` 多祖师对比 meta-skill，开箱即用
+- **预置十五位四大传统祖师**：1 位印度（龙树 · 中观）+ 8 位汉传（唯识、中观、禅、天台、华严、净土、跨宗派）+ 3 位藏传（阿底峡 · 噶当；宗喀巴 · 格鲁；米拉日巴 · 噶举）+ 3 位南传（觉音 · 上座部论师；马哈希 · 缅甸内观；阿姜查 · 泰国森林）—— 另含 4 个教学模式（`/compare-masters` 并列对比、`/master-debate` 多轮对辩、`/master-curriculum` 学修路径、`/master-help` 我该问谁）与 `/create-master` 自定义生成器
 - **经文溯源（Provenance）**：每位祖师附声明来源 ID（CBETA / BDRC / Toh / SuttaCentral / PTS / 合规编纂开示）；实时检索仅在返回真实 `text_id` 时附 FoJin 定位链接，所有教义断言强制附原典引证
 - **离线经文片段**：`sources/` 目录收录核心经典关键段落，FoJin 不可用时仍可离线引用
 - **渐进式披露**：SKILL.md 以决策树 + Quick Ref 为主，`references/`、`sources/` 按需加载，Context 随查随取
 - **HARD-GATE 铁律**：`/create-master` 与预置法师内置红线——教义断言、修行指导与文本解释必须引用该 persona 声明的来源（CBETA / BDRC / Toh / SuttaCentral / PTS / 合规编纂开示），不得捏造来源 ID，不得为虚构人物建角色
 - **二阶段独立审查**：生成管线在写入前强制经过"教义准确性 → 风格一致性"两轮独立审查，FAIL 自动修复最多 2 轮
-- **自动化保真度测试**：每位祖师 `tests/fidelity.jsonl` 10+ 条 Q&A（`compare-masters` 元技能 18 条），验证引用和关键词覆盖；CI 在每次推送时 dry-run 验证（结构校验）；实跑评分需 `ANTHROPIC_API_KEY`，作为本地/发版前手动步骤执行
+- **自动化保真度测试**：211 条夹具（每位祖师 10+ 条，`compare-masters` 元技能 18 条）检查关键词与引用覆盖，每条评分回答另经离线引文审计；CI 在每个 PR 与 main 上做结构校验（dry-run）；实跑评分支持 Anthropic / DeepSeek / Gemini（`--provider`），需要对应的 API key，作为本地/发版前手动步骤执行——最近一次全量运行与逐条裁定见[下文](#保真度评测当前数据)
 - **多平台统一插件**：Claude Code、Cursor、Codex CLI、OpenCode、Gemini CLI 共用一份 `prebuilt/`，session-start hook 跨平台注入法师列表
 - **NPX 一键安装**：`npx master-skill install master-zhiyi` 直接部署到 Claude Code
 - **离线工具链**：`scripts/cite.py`（CBETA 引用查询）、`scripts/query.py`（离线语义检索）、`scripts/validate.py`（frontmatter linter）
-- **FoJin 数据桥**：接入 [fojin.app](https://fojin.app) 的 503 个数据源、10K+ 文本、678K+ 语义向量和 31K 实体知识图谱
+- **FoJin 数据桥**：接入 [fojin.app](https://fojin.app) 的 10K+ 篇文本、678K+ 条语义向量与 110K+ 实体的知识图谱（另登记 600+ 个数据源）
 - **AgentSkills 标准**：遵循 [Anthropic Agent Skills](https://github.com/anthropics/skills) 规范，渐进式披露、决策树、黑盒脚本模式
 
 ## 框架定位
@@ -163,160 +153,58 @@ Master-skill 的核心不是"角色扮演提示词集合"，而是一个可验
 |---|---|
 | 有来源 | 每位祖师声明 `sources[]`、离线 excerpts、FoJin live fallback 与引用自审 |
 | 守边界 | `ETHICS.md`、每位祖师 Layer 0 HARD-GATE、版权 Tier 与教界越界报告机制 |
-| 可评测 | `tests/fidelity.jsonl`、persona-fidelity schema、promptfoo RAW / SPE / CUS 评测层 |
+| 可评测 | `tests/fidelity.jsonl`、persona-fidelity schema、promptfoo RAW / SPE / CUS 评测层（目前覆盖慧能、宗喀巴、阿姜查 3 位），[当前数据见下](#保真度评测当前数据) |
 | 可运行 | `prebuilt/master-*` AgentSkills、npm CLI、多平台 hooks、FoJin runtime contract |
 
 后续 v1.0 路线以框架稳定为优先：见 [docs/v1-framework-roadmap.md](docs/v1-framework-roadmap.md) 与 [docs/fojin-runtime-contract.md](docs/fojin-runtime-contract.md)。
 
----
-
-## 开发者安装
-
-> 👤 **只是想体验？** 直接用 [fojin.app/chat](https://fojin.app/chat)，跳过下面的安装步骤。
-> 🛠️ **本节面向**：Claude Code / Cursor / Codex CLI / OpenCode / Gemini CLI 用户，希望在终端 AgentSkill 环境中直接调用 `/master-xuanzang` `/master-huineng` 等命令。
-
-### 安装
-
-**NPX 一键安装（推荐，无需常驻）**
-
-`npx master-skill install --all` 一次安装全部 19 个 Skill：15 位祖师、3 个教学模式，以及 `create-master` 生成器。`create-master` 会复制自包含的运行时，因此临时 npx 包目录被清理后仍可使用；重新安装或 `update --all` 会更新运行时，但保留 `create-master/masters/` 中用户生成的 persona。
-
-```bash
-# 安装指定祖师
-npx master-skill install master-zhiyi master-fazang master-huineng
+### 保真度评测（当前数据）
 
-# 单独安装公共教学模式或自定义生成器
-npx master-skill install compare-masters
-npx master-skill install create-master
+211 条夹具（`prebuilt/*/tests/fidelity.jsonl`）对真实模型的回答做机械检查：该出现的关键词与引用是否出现，不该出现的是否没有出现；每条评分回答另外进入离线引文审计。每个数字都要连同产生它的模型与判分口径一起读：
 
-# 安装全部 19 个 Skill
-npx master-skill install --all
+| | 数值 | 口径 |
+|---|---|---|
+| 最近一次全量运行 | **199 / 211 已评分**（94.3%） | DeepSeek `deepseek-v4-flash`，commit [`06b8142`](https://github.com/xr843/Master-skill/commit/06b814204082b3e4738185cf3eefa44ed149f9f0)，2026-08-31；12 条输出被截断，记为未测而非失败 |
+| 判分器直出通过率 | 137 / 199 = 68.8% | 子串匹配：分不清改写与缺失，也分不清「正确地拒绝」与「越界」 |
+| 逐条人工裁定后 | **179 / 199 = 89.9%** | 教理 94.3% · 守边界 85.9% · 抗压守引用 83.3%。推翻 43 条失败，也把 1 条 PASS 改判为 FAIL；每条裁定附回答原文引句，由 `verify-adjudication.py` 在 CI 中复核 |
+| 引文审计覆盖 | **569 / 619 = 92%**，已知伪造 0 | 用当前审计器离线重审同一批回答，覆盖 CBETA、BDRC / Toh、PTS / SuttaCentral、编集开示四个来源家族 |
+| 元技能定向复测 | compare-masters **0% → 90%** | 2026-09-13，34 条。修正输出模板后，`compare-masters` 引文可核验率由 0% 升至 90%，`master-curriculum` 由 0% 升至 100%；`master-debate` 此前把经号写在圆括号里、审计根本看不见，现为 100% |
 
-# 查看全部可安装 Skill
-npx master-skill list
-```
+**这一列不能推进 v1.0 门禁。** 门禁定义在 Anthropic（`claude-sonnet-4-6`）那一列上，两个模型是两把尺子，不混算。Anthropic 那一列至今只有 2026-08-18 的一次部分运行（84 / 211 条，因账户余额耗尽中断），当时的「零伪造引文」已于 2026-08-31 撤回——那次审计实际一条都没有运行。
 
-**全局安装（频繁使用 / 离线场景）**
+这些是**关键词与引用字符串的覆盖检查，不是教义正确性，也不是 LLM 判分的答案质量**。详见 [BASELINE-deepseek.md](eval/reports/BASELINE-deepseek.md)（全量运行）、[ADJUDICATION.md](eval/reports/ADJUDICATION.md)（逐条裁定）、[BASELINE.md](eval/reports/BASELINE.md)（Anthropic 部分运行与撤回记录）与[元技能复测报告](eval/reports/0.11.0-e97ded0-deepseek-metaskills.json)。
 
-```bash
-npm install -g master-skill            # 一次性装到 $PATH
-master-skill install master-zhiyi      # 之后省掉 npx，直接调
-master-skill list
-npm update -g master-skill             # 升到下一个 minor / patch
-```
-
-**Claude Code（插件方式）**
+---
 
-```bash
-# npx（上方）与 git clone 手动安装为正式发布渠道：
-git clone https://github.com/xr843/Master-skill ~/Master-skill
-cd ~/Master-skill && pip install -r requirements.txt
-for d in prebuilt/master-*/; do ln -sf "$(pwd)/$d" ~/.claude/skills/"$(basename $d)"; done
-ln -sf "$(pwd)/prebuilt/compare" ~/.claude/skills/compare-masters
-ln -sf "$(pwd)" ~/.claude/skills/create-master
-```
+## 开发者安装
 
-**Cursor**
+> 👤 **只是想体验？** 直接用 [fojin.app/chat](https://fojin.app/chat)，无需安装。
+> 🛠️ **本节面向** Claude Code / Cursor / Codex CLI / OpenCode / Gemini CLI 用户。
 
 ```bash
-git clone https://github.com/xr843/Master-skill ~/Master-skill
-# Cursor 自动检测 .cursor-plugin/plugin.json 并注册技能
-```
-
-**OpenCode**
-
-在 `opencode.json` 中添加：
-
-```json
-{
-  "plugin": ["master-skill@git+https://github.com/xr843/Master-skill.git"]
-}
-```
-
-**Codex CLI**
-
-参见 [.codex/INSTALL.md](.codex/INSTALL.md)
-
-**Gemini CLI**
-
-本项目包含 `gemini-extension.json` 和 `GEMINI.md`，Gemini CLI 自动发现并加载。
-
-### 使用预置法师
-
-在支持 AgentSkills 的环境（Claude Code / Cursor / Codex CLI / OpenCode / Gemini CLI）中直接调用：
-
-```
-# 印度
-/master-nagarjuna      — 龙树菩萨（印度·中观｜八宗共祖）
-
-# 汉传
-/master-xuanzang       — 玄奘法师（法相唯识宗）
-/master-kumarajiva     — 鸠摩罗什（三论宗/中观）
-/master-huineng        — 慧能大师（禅宗六祖）
-/master-zhiyi          — 智顗大师（天台宗）
-/master-fazang         — 法藏大师（华严宗）
-/master-yinguang       — 印光大师（净土宗）
-/master-ouyi           — 蕅益大师（天台/净土·跨宗派）
-/master-xuyun          — 虚云老和尚（禅宗·五宗兼嗣）
-
-# 藏传
-/master-atisha         — 阿底峡尊者（噶当派开祖 · 三士道 · 982-1054）
-/master-tsongkhapa     — 宗喀巴大师（格鲁派创始人 · 三主要道 · 应成中观）
-/master-milarepa       — 米拉日巴尊者（噶举派 · 大手印 · 那洛六法）
-
-# 南传
-/master-buddhaghosa    — 觉音尊者（上座部论师 · 《清净道论》· 5世纪）
-/master-mahasi-sayadaw — 马哈希尊者（缅甸内观 · 标记法 · 1904-1982）
-/master-ajahn-chah     — 阿姜查（泰国森林禅林派 · 巴蓬寺传承）
-```
-
-### 教学模式（v0.7）
-
-- **`/compare-masters`** — 多位法师对同一问题的并列对比（横向 / 单轮）
-- **`/master-debate`** — 祖师就争议议题做多轮交叉辩论（v0.8 起：**每轮派 fresh subagent**，只携带对方上一轮 ≤80 字摘要 + 本方 cross_critique 弹药；轮数由 `debate_protocol.per_pair_overrides` 决定，默认 4 轮，`huineng-vs-tsongkhapa` / `ouyi-vs-tsongkhapa` 默认 5 轮）
-- **`/master-curriculum`** — 按你的传统（禅 / 净 / 天台 / 华严 / 唯识 / 中观 / 格鲁 / 上座部）与当前位置（L0-L3）给出有时序的学修路径
-
-**`/compare-masters` 用法示例：**
-
-```
-# 自动选择相关法师
-/compare-masters 什么是空性
-
-# 手动指定法师（推荐，结果更精准）
-/compare-masters 什么是遍行因 --masters master-xuanzang,master-zhiyi,master-ouyi
-
-# 自然语言触发
-请慧能和印光对比回答"如何看待念佛"
-比较禅宗和净土宗对修行的看法
-```
-
-**选择逻辑**：系统先尝试从用户提问中提取关键词，与每位法师的核心概念匹配；若无强匹配，则按主题映射兜底（念佛/禅修/唯识中观/判教等）。**如果自动选的法师不符合预期，直接用 `--masters` 手动指定**。
-
-### 自定义生成
-
-```
-/create-master 弘一大师
-```
-
-或自然语言触发：
-
-```
-帮我创建一个弘一大师的教学角色
+npx master-skill install --all          # 一次装全部 20 个 Skill
+npx master-skill install master-huineng # 或只装一位
+npx master-skill list                   # 看全部可装的
+npx master-skill recommend "念佛怎么念才算老实"   # 不知道该问谁？让它推荐
+npx master-skill doctor                 # 检查本地安装与运行路径
+npx master-skill update --all           # 升级：重装全部并清掉旧文件
 ```
 
-系统将引导完成三步信息录入，然后自动从 FoJin 采集数据、生成教义分析与风格文件。
+装好后在对话里直接调 `/master-huineng`、`/compare-masters` 等。
 
----
+> 五端安装细节（Claude Code 插件 / Cursor / OpenCode / Codex CLI / Gemini CLI）、
+> 全局安装、教学模式用法、`/create-master` 自定义生成
+> → **[docs/install.md](docs/install.md)**
 
 ## 桌面管理器
 
-原生桌面控制台(纯 Rust,egui,单二进制,无 Electron),统一管理 17 个 master skill 的安装状态、fidelity 评测覆盖率、运行追踪与质量门禁:
+原生桌面控制台(纯 Rust,egui,单二进制,无 Electron),统一管理 18 个技能（15 位祖师与 `master-debate` / `master-curriculum` / `master-help`）的安装状态、fidelity 评测覆盖率、运行追踪与质量门禁:
 
-![Master-skill Desktop Manager](https://raw.githubusercontent.com/xr843/Master-skill/master/docs/assets/desktop-manager.png)
+![Master-skill Desktop Manager](https://raw.githubusercontent.com/xr843/Master-skill/main/docs/assets/desktop-manager.png)
 
-**下载**:[Releases](https://github.com/xr843/Master-skill/releases) 提供 Linux / Windows / macOS 预编译二进制,下载后直接运行(仓库根目录下执行,需本地已 clone 本仓库)。Linux / macOS 下载后需先 `chmod +x` 赋予可执行权限;macOS 上二进制未签名,首次运行需右键"打开"或执行 `xattr -d com.apple.quarantine <文件名>` 解除隔离。
+**下载**：[Releases](https://github.com/xr843/Master-skill/releases) 提供 Linux / Windows / macOS 预编译二进制，需在本仓库克隆的根目录运行（它会调用仓库里的 `scripts/` 与 `bin/`）。Linux / macOS 建议下载对应的 `.tar.gz`，解包后保留可执行位；裸二进制仍保留以兼容旧链接，使用时需先 `chmod +x`。每个 release 附带 `SHA256SUMS`，可用 `sha256sum --check --ignore-missing SHA256SUMS` 核对下载文件，并附构建溯源证明，可用 `gh attestation verify <文件> --repo xr843/Master-skill` 验证。**v0.12.0 之前的 Windows 版无法调用 Python 与 npm**；v0.12.0 起改为按平台解析，但 CI 尚未在 Windows 主机上运行桌面端，如遇问题可用环境变量 `MASTER_SKILL_PYTHON` / `MASTER_SKILL_NPM` 指定解释器。macOS 二进制未签名，首次运行需右键“打开”或执行 `xattr -d com.apple.quarantine <文件名>` 解除隔离。
 
-**从源码构建**:
+**从源码构建**（需要 Rust 1.95+）：
 
 ```bash
 cd desktop && cargo build --release
@@ -328,157 +216,37 @@ cd desktop && cargo build --release
 
 ## 预置法师
 
-### 龙树菩萨（Nāgārjuna，约150-250） — 印度 · 中观
-
-大乘中观奠基者，汉传尊为「八宗共祖」——三论、天台、净土、华严、禅皆溯源于他，藏传应成中观亦以他为根本所依。立「八不中道」破一切戏论，以「众因缘生法，我说即是空」开显缘起性空，依二谛说法而归于毕竟空、戏论寂灭，并以难易二道判摄修行。所著《中论》为后世中观学之根本论典，《大智度论》则为般若义海之百科。
-主要来源：CBETA《中论》T30n1564、《大智度论》T25n1509、《十二门论》T30n1568、《迴诤论》T32n1631、《十住毗婆沙论》T26n1521。
-调用命令：`/master-nagarjuna`
-
-### 玄奘法师（602-664）
-
-唐代高僧，中国佛教史上最伟大的译经家。西行求法十七年，遍学印度诸部，归国后主持译经事业，译出经论七十五部一千三百三十五卷。创立法相唯识宗，以严谨精确的翻译风格著称，确立"五种不翻"原则。
-主要来源：CBETA《大般若经》《瑜伽师地论》《成唯识论》《心经》等。
-调用命令：`/master-xuanzang`
-
-### 鸠摩罗什（Kumarajiva，344-413）
-
-龟兹出身，后秦长安译经，中国四大译经家之一。其译文以文学性和流畅度著称，《妙法莲华经》《金刚经》《维摩诘经》《中论》等译本至今最为通行。奠定了三论宗（中观）在中国的基础。
-主要来源：CBETA《妙法莲华经》《金刚经》《维摩诘经》《中论》《大智度论》等。
-调用命令：`/master-kumarajiva`
-
-### 慧能大师（638-713）
-
-禅宗六祖，南宗禅创立者。不识文字的卖柴樵夫，闻《金刚经》而开悟，得五祖弘忍传法。著《六祖坛经》——中国人著作中唯一被尊为"经"者。主张"直指人心，见性成佛"，开顿悟法门。
-主要来源：CBETA《六祖大师法宝坛经》T48n2008。
-调用命令：`/master-huineng`
-
-### 智顗大师（538-597）
-
-天台宗创始人，被尊为"东土小释迦"。建立中国佛教第一个完整的判教体系（五时八教），著天台三大部《摩诃止观》《法华玄义》《法华文句》。核心思想：一念三千、三谛圆融、止观双修。
-主要来源：CBETA《摩诃止观》T46n1911、《法华玄义》T33n1718 等。
-调用命令：`/master-zhiyi`
-
-### 法藏大师（643-712）
-
-华严宗三祖，华严哲学体系的实际创立者。武则天国师，以"金师子章"为武后说华严义。核心思想：法界缘起、四法界、十玄门、六相圆融——一切现象互含互摄，事事无碍。
-主要来源：CBETA《华严经探玄记》T35n1733、《华严五教章》T45n1866 等。
-调用命令：`/master-fazang`
-
-### 印光大师（1861-1940）
-
-汉传净土宗第十三代祖师，近代净土复兴的核心人物。
-文字平实恳切，戒行严谨，以书信形式广度众生，著有《印光法师文钞》三编。
-主要来源：CBETA 汉文大藏经，含文钞正编、续编、三编及净土三经。
-调用命令：`/master-yinguang`
-
-### 蕅益大师（1599-1655）
-
-明末四大高僧之一，净土宗九祖。"教宗天台，行归净土"——融通禅、教、律、净四宗，是中国佛教史上最重要的跨宗派综合者。其《阿弥陀经要解》被印光大师赞为"即使古佛再来，也不能超过其上"。
-主要来源：CBETA《阿弥陀经要解》T37n1762、《教观纲宗》等。
-调用命令：`/master-ouyi`
-
-### 虚云老和尚（1840-1959）
-
-近代禅宗泰斗，世寿一百二十岁，一身兼嗣禅门五宗（临济、曹洞、沩仰、云门、法眼）法脉——佛教史上绝无仅有。复兴六大祖庭，历经清末、民国、新中国三个时代。主张参话头、老实修行、禅净双修。
-主要来源：CBETA《楞严经》《金刚经》《六祖坛经》等。
-调用命令：`/master-xuyun`
-
-### 阿底峡尊者（Atiśa Dīpaṃkara, 982-1054） — 藏传 · 噶当派 · 印藏桥梁
-
-印度孟加拉萨霍尔国王子出身，超戒寺住持。1042 年应藏王智光邀请入藏，著《菩提道灯论》(Bodhipathapradīpa)——藏地后弘期道次第之祖。首座弟子仲敦巴建热振寺，开**噶当派**（佛语教授派）。后被宗喀巴新噶当派（即格鲁派）继承。藏传四派（宁玛、萨迦、噶举、格鲁）皆视其为根本师之一。
-主要来源：Toh 4465《菩提道灯论》（sDe dge bsTan 'gyur 标准编号）+ 噶当口耳传承《父法·子法》。
-调用命令：`/master-atisha`
-
-### 宗喀巴大师（Tsongkhapa, 1357-1419） — 藏传 · 格鲁派创始人
-
-藏传佛教**格鲁派**（"善规派"，俗称"黄教"）创始人，达赖喇嘛与班禅喇嘛传承根基。出生于青海宗喀（今西宁附近），师承萨迦派仁达瓦等。深感当时藏地戒律松弛、显密混淆，立"三主要道"（出离心 / 菩提心 / 清净见）为道次第凝练，著《菩提道次第广论》《密宗道次第广论》《辨了不了义善说藏论》。1409 年建甘丹寺（dGa' ldan），格鲁派开山祖庭。
-主要来源：宗喀巴全集 gsung 'bum（BDRC.io 检索 'tsong kha pa'）。汉译参考法尊法师本。
-调用命令：`/master-tsongkhapa`
-
-> ⚠️ 续部具体修法步骤、灌顶仪轨、生起圆满次第细节、本尊咒语、明点观想**只介绍历史与原理，不传授具体修法步骤**。
-
-### 米拉日巴尊者（Milarepa, 1052-1135） — 藏传 · 噶举派
-
-藏传佛教噶举派精神祖师，"瑜伽士"传统（不入寺院、山中闭关、以歌教化）的典范。早年咒杀仇家造重业，依止玛尔巴译师净罪求法，于雪山闭关数十年以荨麻为食。以**道歌（mGur）**说法，影响后世整个藏传佛教。
-主要来源：BDRC《米拉日巴道歌集》（W1KG14334，《十万歌集》mGur 'bum）、《密勒日巴尊者传》（W22272）。
-调用命令：`/master-milarepa`
-
-> ⚠️ 那洛六法、拙火、生起／圆满次第等密法**只介绍历史与原理，不传授具体修法步骤**。具体修持必须依止具格上师亲传与灌顶。
-
-### 觉音尊者（Buddhaghosa, 5世纪） — 南传 · 上座部论师
-
-上座部佛教史上最具影响力的注释家与论师。原为印度南部婆罗门学者，赴斯里兰卡大寺（Mahāvihāra），将古僧伽罗注释翻译为巴利语。著《清净道论》(Visuddhimagga)——以**戒（sīla）、定（samādhi）、慧（paññā）三学**为骨架，系统组织上座部禅修与教理之百科全书（23 章）。其著作奠定南传上座部正统教理体系——东南亚一切论师皆依其判摄。
-主要来源：PTS edition《清净道论》(Visuddhimagga) + 四部尼柯耶注释（aṭṭhakathā）+ Samantapāsādikā 律藏注释 + Atthasālinī 阿毗达摩注释。
-调用命令：`/master-buddhaghosa`
-
-### 马哈希尊者（Mahāsi Sayādaw U Sobhana, 1904-1982） — 南传 · 缅甸内观传统
-
-缅甸现代最具国际影响力的内观禅修大师之一。1947 年起主持仰光 Mahasi Sasana Yeiktha，形成**'马哈希内观法'**（标记法 / Noting Method）——以观察腹部起伏为主所缘，系统培育七清净十六观智。1954-1956 年第六次结集（Chaṭṭha Saṅgāyana）任**'最终编辑长老'**，审定整个巴利三藏。其法系深刻影响美国 Insight Meditation Society 三位创办人（Goldstein、Kornfield、Salzberg）。
-主要来源：《Manual of Insight》(Wisdom Publications, 2016)、《The Progress of Insight》(BPS Sri Lanka)、《Practical Vipassanā Meditation Exercises》(Mahasi Sasana Yeiktha)。
-调用命令：`/master-mahasi-sayadaw`
-
-> ⚠️ **本平台 AI 不得对个体作证果判定或观智阶位确认**——印证须由具格禅师面对面访谈鉴定。这是马哈希教学体系最严肃的 guardrail。
-
-### 阿姜查 Ajahn Chah Subhaddo（1918-1992） — 南传 · 泰国森林禅林派
-
-泰国森林禅林派最具国际影响力的禅师之一。以巴利戒律严格持守、四念处禅修、朴素生活化教学著称。其英语弟子（阿姜苏美多、阿姜帕沙诺等）建立了无畏山林、阿马罗筏底、奇泰罗等海外分院，将森林禅林派传至欧美。代表名言："如果你少放下一点，你就少一点苦。"
-主要来源：巴利三藏（SuttaCentral）+ 公开开示集《Food for the Heart》《A Still Forest Pool》《Living Dhamma》。
-调用命令：`/master-ajahn-chah`
-
----
+十五位祖师，四大传统。命令即技能名，装好后直接在对话里调用。
+
+| 命令 | 祖师 | 传统 · 宗派 | 年代 |
+|---|---|---|---|
+| `/master-nagarjuna` | 龙树菩萨 | 印度 · 中观（八宗共祖） | 约 150-250 |
+| `/master-kumarajiva` | 鸠摩罗什 | 汉传 · 三论／中观 | 344-413 |
+| `/master-zhiyi` | 智顗大师 | 汉传 · 天台 | 538-597 |
+| `/master-xuanzang` | 玄奘法师 | 汉传 · 法相唯识 | 602-664 |
+| `/master-huineng` | 慧能大师 | 汉传 · 禅宗六祖 | 638-713 |
+| `/master-fazang` | 法藏大师 | 汉传 · 华严 | 643-712 |
+| `/master-ouyi` | 蕅益大师 | 汉传 · 天台／净土（跨宗派） | 1599-1655 |
+| `/master-xuyun` | 虚云老和尚 | 汉传 · 禅宗五宗兼嗣 | 1840-1959 |
+| `/master-yinguang` | 印光大师 | 汉传 · 净土 | 1861-1940 |
+| `/master-atisha` | 阿底峡尊者 | 藏传 · 噶当（三士道） | 982-1054 |
+| `/master-milarepa` | 米拉日巴尊者 | 藏传 · 噶举（大手印） | 1052-1135 |
+| `/master-tsongkhapa` | 宗喀巴大师 | 藏传 · 格鲁（应成中观） | 1357-1419 |
+| `/master-buddhaghosa` | 觉音尊者 | 南传 · 上座部论师 | 5 世纪 |
+| `/master-mahasi-sayadaw` | 马哈希尊者 | 南传 · 缅甸内观 | 1904-1982 |
+| `/master-ajahn-chah` | 阿姜查 | 南传 · 泰国森林禅林派 | 1918-1992 |
+
+**教学模式**：`/compare-masters` 并列对比 · `/master-debate` 多轮对辩 · `/master-curriculum` 学修路径 · `/master-help` 我该问谁　**生成器**：`/create-master` 自定义生成
+
+> 每位祖师的生平、核心思想与声明来源 → **[docs/masters.md](docs/masters.md)**
 
 ## 架构图
 
-```
-用户请求
-    |
-    v
-session-start hook ──> 自动注入法师列表（5 端统一）
-    |
-    v
-SKILL.md (AgentSkills 入口：决策树 + Quick Ref)
-    |
-    +-- 预置法师 --> prebuilt/{slug}/
-    |                   +-- SKILL.md          (决策树 + <HARD-GATE> 铁律)
-    |                   +-- meta.json         (version / lineage / provenance)
-    |                   +-- references/       (按需加载)
-    |                   |   +-- teaching.md
-    |                   |   +-- voice.md
-    |                   +-- sources/          (离线经文片段)
-    |                   |   +-- *.md (声明来源的离线段落)
-    |                   +-- tests/
-    |                       +-- fidelity.jsonl  (保真度样例, CI dry-run)
-    |
-    +-- 工具链
-    |   +-- scripts/validate.py         (frontmatter linter)
-    |   +-- scripts/cite.py             (CBETA 引用查询)
-    |   +-- scripts/query.py            (离线语义检索)
-    |   +-- scripts/test-fidelity.py    (保真度测试)
-    |   +-- scripts/validate-fidelity.py
-    |   +-- bin/cli.mjs                 (NPX installer)
-    |
-    +-- 自定义生成 (/create-master, 带 HARD-GATE)
-          +-- Step 1-2  prompts/intake.md → tools/sutra_collector.py
-          |             └─> FoJin API (KG + 语义检索 + 文本)
-          +-- Step 3    prompts/{sutra,voice}_analyzer.md → 两阶段分析
-          +-- Step 3.5  二阶段独立审查 ──┬─ prompts/doctrine_reviewer.md
-          |                             └─ prompts/voice_reviewer.md
-          +-- Step 4-5  tools/master_builder.py → tools/skill_writer.py
-                        └─> tools/verify_sources.py (写入前最终验证)
-
-多平台插件统一入口：
-  .claude-plugin/    → Claude Code      (hooks/run-hook.cmd → session-start)
-  .cursor-plugin/    → Cursor           (hooks/hooks-cursor.json)
-  .codex/            → Codex CLI        (.codex/INSTALL.md)
-  .opencode/         → OpenCode         (opencode.json 引用)
-  gemini-extension.json → Gemini CLI    (GEMINI.md 自动加载)
-```
-
----
+目录结构与数据流 → **[docs/architecture.md](docs/architecture.md)**
 
 ## 与 FoJin 的关系
 
-[FoJin](https://fojin.app) 是一个佛教文本聚合平台，整合了 503 个数据源、10K+ 篇文本、678K+ 条语义向量嵌入，以及涵盖 31K 实体的知识图谱，覆盖 CBETA 汉文大藏经、SuttaCentral 巴利藏及英译、84000 藏经英译等主要语料库。
+[FoJin](https://fojin.app) 是一个佛教文本聚合平台，收录 10K+ 部文本（其中约 9K 部有全文）、678K+ 条语义向量嵌入与 110K+ 实体的知识图谱。它登记了 600+ 个数据源，但**提供全文的只有 4 个**——CBETA 汉文大藏经、SuttaCentral 巴利藏及英译、84000 藏经英译、GRETIL 梵文文献库，其余为元数据登记。
 
 Master-skill 通过 `tools/fojin_bridge.py` 接入 FoJin API，实现：
 
@@ -508,27 +276,7 @@ Master-skill 通过 `tools/fojin_bridge.py` 接入 FoJin API，实现：
 
 ## 常见问题
 
-**Q：FoJin API 不可达时还能用吗？**
-
-能。每位预置法师的 `prebuilt/<name>/sources/` 收录了该法师核心经典的关键段落（离线经文片段）。FoJin 不可用时，法师会降级到离线模式并在回答中声明"当前使用离线片段"。`/create-master` 管线遇到 API 故障会提示用户切换手动输入模式，由用户粘贴经文原文继续生成。
-
-**Q：CBETA 引用格式是什么样的？来源如何验证？**
-
-CBETA 引证使用 `Txxn####` 形式的经号（例如《妙法蓮華經》→ `T09n0262`）；藏传、南传与编纂开示分别使用 persona 在 `meta.json.sources[]` 中声明的 BDRC / Toh、SuttaCentral / PTS 或 teaching ID。`scripts/validate-citation-contract.py` 与 `tools/verify_sources.py --check-links/--final-check` 离线检查来源家族、ID 格式、声明归属和合同一致性；它们不解析正文自由文本，也不保证外部链接 HTTP 可达。旧版 `verify_sources.py --fix` 在线审计只覆盖 CBETA / FoJin 链接。
-
-**Q：`npx master-skill install` 执行失败、报 ENOTEMPTY 或权限错误怎么办？**
-
-先清理 `~/.claude/skills/master-<name>/` 残留目录再重试。如果是 npm 缓存问题，`npm cache clean --force` 后重跑 NPX。Windows 用户请在 Git Bash 或 WSL 中执行，避免 cmd.exe 的路径转义问题。
-
-**Q：生成的法师内容和历史记载不符，怎么纠正？**
-
-直接在对话中告诉法师"他不会这样说话"或"他应该更严厉一些"。`/create-master` 的纠正模式会识别纠正类型（教义纠正 → 追加到 `teaching.md`；风格纠正 → 追加到 `voice.md`），以 `## Correction` 块形式记录并自动递增 patch 版本号。纠正记录的优先级高于分析生成的内容。
-
-**Q：如何贡献一位新的预置法师？**
-
-见下方「贡献指南」。基本流程：遵循 v0.3 目录结构生成 `prebuilt/<name>/`、跑通 `scripts/validate.py --strict`、补齐 `tests/fidelity.jsonl` 的 5 条以上样例，然后提 PR。
-
----
+安装、调用、检索的常见问题 → **[docs/troubleshooting.md](docs/troubleshooting.md)**
 
 ## 贡献指南
 
@@ -545,7 +293,7 @@ CBETA 引证使用 `Txxn####` 形式的经号（例如《妙法蓮華經》→ `
 1. [ETHICS.md](ETHICS.md) §2 — 确认版权 Tier（A 可直接 PR，B 需授权证明，C 一律拒绝）
 2. [ETHICS.md](ETHICS.md) §3 — 教界禁止行为须写入该法师 `voice.md` Layer 0
 3. [CONTRIBUTING.md](CONTRIBUTING.md) §3 — 目录结构、frontmatter、fidelity 测试用例编写规范
-4. 提交前：`python scripts/validate.py --strict` 绿色 + `tests/fidelity.jsonl` 至少 5 条 + CI fidelity-smoke 通过
+4. 提交前：`python scripts/validate.py --strict` 与 `python scripts/validate-fidelity.py` 通过 + `tests/fidelity.jsonl` 至少 5 条（其中至少 1 条 boundary 用例）+ CI 的 fidelity dry-run 通过
 
 其它一般贡献（文档、工具链、CI）走普通 PR 流程。