psyclaw 0.30.0 → 0.30.2

package/docs/PsyClaw/344/275/277/347/224/250/347/231/275/347/232/256/344/271/{246_v0.29.15.md → 246_v0.30.1.md}

@@ -1,7 +1,7 @@
 # PsyClaw 使用白皮书
 
-**版本：v0.29.15**
-**发布日期：2026-09-08**
+**版本：v0.30.1**
+**发布日期：2026-09-09**
 **适用对象：社会科学研究者、教师和研究助理**
 
 PsyClaw
@@ -12,7 +12,7 @@ PsyClaw
 
 可复现研究实践 · 证据可追溯 · 人工判断优先
 
-2026 年 9 月 · v0.29.15 版
+2026 年 9 月 · v0.30.1 版
 
 # 关于本白皮书
 
@@ -42,7 +42,7 @@ PsyClaw
 
 附录：命令速查、提示词模板、目录约定与极短边界速览，供日常翻用。
 
-斜杠命令采用 Codex 风格：**单独命令**，或**命令 + 尾随自由文本**。确认方法用自然语言「可以」；人审在 Panel「核实」或唤醒选项中完成。
+斜杠命令采用 Codex 风格：**单独命令**，或**命令 + 尾随自由文本**。子分析节点可用「可以」确认；整体开跑须完整输入「我已审阅并批准本方案」。大段 `/crosscheck` / `/verify` 与 OA 全文下载均须先征得你同意；收尾人审在 Panel「核实」或唤醒选项中完成。
 
 文中「研究者可说」示例可直接改写后粘贴进 PsyClaw。
 
@@ -54,12 +54,12 @@ PsyClaw 与普通网页聊天机器人的差别在于：它在研究项目目录
 
 全流程一览：
 
-1. **建仓与摸底**：`/init` 或 `/init <目标>` 建立目录与 `psyclaw.md`；原始数据放入 `data/raw/`（只读）。
-2. **澄清与方案**：`Shift+Tab` 进入 analysis；`/plan` 查看方案，或 `/plan <目标>` 创建方案。回复「可以」确认方法，再用自然语言请它生成并运行脚本。
+1. **建仓与摸底**：首次 `/init` 或 `/init <目标>` 建立目录与 `psyclaw.md`；同一目录跨会话若已见规范结构，不必再 init。原始数据放入 `data/raw/`（只读）。
+2. **澄清与方案**：`Shift+Tab` 进入 analysis；`/plan` 查看方案，或 `/plan <目标>` 创建方案。对每个子分析回复「可以」或选项；全部选定后完整输入「我已审阅并批准本方案」再执行脚本。
 3. **委托与复现**：统计在本地成熟库或受信任 MCP 中完成；脚本落在 `analysis/scripts/`，结果落在 `analysis/results/`。
-4. **AI 核查与人审**：先 `/crosscheck`（过程：数据/引文存在/格式），再 `/verify`（实质：结果是否成立、方法与引文是否合理）；然后在 Panel「核实」或唤醒选项中完成人审。
-5. **交接与写作**：人审通过后 `/handoff` 写入 `analysis/HANDOFF.md`，再切到 academic；可用自然语言或 `/ars` 推进文献与初稿；定稿前再次两道 AI 核查 + 人审。
-6. **加压与评审**：定方案前用 `/brainstorm` / `/grill`；定稿前用 `/review` 收集模拟评审意见。
+4. **AI 核查与人审**：先征得同意再开 `/crosscheck`（过程）与 `/verify`（实质）；然后在 Panel「核实」或唤醒选项中完成人审。
+5. **交接与写作**：人审通过后 `/handoff` 写入 `analysis/HANDOFF.md`，再切到 academic；用更小节点推进（综述怎么做 → 展示什么 → 再检索/写稿）；定稿前再次两道 AI 核查 + 人审。意图模糊可用 `/grill`，缺想法可用 `/brainstorm`。
+6. **加压与评审**：定方案前用 `/brainstorm` / `/grill`；定稿前用 `/review` 收集模拟评审意见。OA 全文下载前须征得同意；失败或无 OA 时说明并给出 DOI。
 
 读完本白皮书，你应能按第五章配方跑通至少一条完整工作流，并知道何时打开 Panel 完成人审。对课题组而言，这意味着：新人可按同一配方接手项目；合作者可对照 `analysis/scripts/`、`analysis/results/` 与 `HANDOFF.md` 复核；写作阶段有明确的数字来源，而不是聊天窗口里散落的截图。
 
@@ -99,7 +99,7 @@ PsyClaw 与普通网页聊天机器人的差别在于：它在研究项目目录
 
 ## 1.1 你现在可以完成的事
 
-PsyClaw 0.29.15 是面向社会科学的研究智能体。安装并建仓之后，你通常可以做到：
+PsyClaw 0.30.1 是面向社会科学的研究智能体。安装并建仓之后，你通常可以做到：
 
 - **把研究问题变成可检查的项目**：目录、项目说明书、分析方案与进度都留在本地。
 - **用对话完成摸底与方案确认**：先看清数据与缺口，再确认主分析与敏感性分析。
@@ -114,7 +114,7 @@ PsyClaw 0.29.15 是面向社会科学的研究智能体。安装并建仓之后
 
 | 你想做的事 | 建议路径 |
 |---|---|
-| 问卷相关/回归，控制协变量 | analysis：`/plan` → 确认「可以」→ 脚本执行 → 两道核查 → 人审 → `/handoff` |
+| 问卷相关/回归，控制协变量 | analysis：`/plan` → 逐项确认 → 仪式句批准 → 脚本 → 同意后两道核查 → 人审 → `/handoff` |
 | 动数据前打磨研究问题 | chat/analysis：`/brainstorm` → `/grill` → 再定 `/plan` |
 | 已有结果，写结果部分与引言 | academic：读 `HANDOFF.md`；自然语言或 `/ars` 推进；定稿前再核查 |
 | 投稿前找表述漏洞 | academic：`/review` → 挑必改项 → `/crosscheck` + `/verify` → 人审 |
@@ -157,19 +157,19 @@ node --version
 官方 npm 源：
 
 ```bash
-npm install -g psyclaw@0.29.15
+npm install -g psyclaw@0.30.1
 ```
 
 若本机 npm registry 配置异常，可显式指定官方源：
 
 ```bash
-npm install -g psyclaw@0.29.15 --registry=https://registry.npmjs.org/
+npm install -g psyclaw@0.30.1 --registry=https://registry.npmjs.org/
 ```
 
 中国大陆网络较慢时：
 
 ```bash
-npm install -g psyclaw@0.29.15 --registry=https://registry.npmmirror.com
+npm install -g psyclaw@0.30.1 --registry=https://registry.npmmirror.com
 ```
 
 确认入口：
@@ -274,7 +274,7 @@ my-study/
 | 模式 | 你获得的能力 | 典型下一步 |
 |---|---|---|
 | chat | 轻量对话与资料整理，不强制研究流水线 | 摸底、澄清，或切到 analysis / academic |
-| analysis | 澄清 → 方案 → 脚本 → 两道 AI 核查 → 人审 → 报告 → 交接 | `/plan` → 自然语言执行 → `/crosscheck` → `/verify` → Panel → `/handoff` |
+| analysis | 澄清 → 逐项方案 → 仪式批准 → 脚本 → 同意后两道 AI 核查 → 人审 → 报告 → 交接 | `/plan` →「我已审阅并批准本方案」→ 脚本 → `/crosscheck` → `/verify` → Panel → `/handoff` |
 | academic | 文献、初稿、格式、评审；定稿前再核查 + 人审 | 读 `HANDOFF.md` 写结果；`/ars` 或自然语言推进；`/review` |
 
 `Shift+Tab` 在三者间循环。analysis 优先产出可运行结果，再做人审；academic 消费 `analysis/HANDOFF.md` 与 `analysis/results/`——缺数字时切回 analysis 补算，而不是在写作模式重选主方法。
@@ -289,11 +289,11 @@ my-study/
 
 本章按研究者日常任务组织。每个命令给出：**能做什么**、**怎么用**、**你会得到什么**。斜杠表面为 Codex 风格：`/命令` 或 `/命令` + 尾随自由文本。
 
-小提示：方法确认用自然语言「可以」；人审只在 Panel「核实」或唤醒选项中完成。`/crosscheck` 管过程，`/verify` 管实质——二者分工不同。
+小提示：子分析节点用「可以」确认；整体开跑须完整输入「我已审阅并批准本方案」。大段 `/crosscheck` / `/verify` 先问再开；人审只在 Panel「核实」或唤醒选项中完成。`/crosscheck` 管过程，`/verify` 管实质。
 
 ## 4.1 建仓：`/init [目标]`
 
-**能做什么**　搭建干净研究工作区：约定目录、`psyclaw.md` 与 `.psyclaw/` 状态目录。
+**能做什么**　首次搭建干净研究工作区：约定目录、`psyclaw.md` 与 `.psyclaw/` 状态目录。若目录已具备规范结构（`psyclaw.md` + `data/` `analysis/` `literature/` `paper/` `.psyclaw/`），跨会话不必再 init——系统会识别并复用。
 
 **怎么用**
 ```text
@@ -304,27 +304,31 @@ my-study/
 psyclaw init "睡眠质量与大学生学业倦怠的关系" --paradigm survey-observational
 ```
 
-**你会得到什么**　可立即放入数据、开始摸底的脚手架；尾随文本成为研究目标记录。
+**你会得到什么**　可立即放入数据、开始摸底的脚手架；尾随文本成为研究目标记录。再次执行时若已建仓，会提示「已检测到既有工作区」。
 
 ## 4.2 分析方案：`/plan [目标]`
 
-**能做什么**　查看或新建分析方案；创建时 soft-route 到捆绑的 analysis-plan 技能。
+**能做什么**　查看或新建分析方案；创建时 soft-route 到捆绑的 analysis-plan 技能。每个拟做分析会给出决策卡；全部选定后，用仪式批准句授权执行。
 
 **怎么用**
 ```text
 /plan
 /plan 社交支持是否与心理健康相关，以及哪些变量可能解释这种关系
 ```
-待确认时回复：
+对当前子分析决策卡回复：
 ```text
 可以
 ```
-确认后再用自然语言执行，例如：
+全部子项确认后，完整输入（不要省略）：
 ```text
-请按已确认方案生成 analysis/scripts/ 下的可复现脚本并运行；结果写入 analysis/results/。不要发明数字。
+我已审阅并批准本方案
+```
+然后系统才会进入脚本执行。也可用自然语言补充，例如：
+```text
+请按已批准方案生成 analysis/scripts/ 下的可复现脚本并运行；结果写入 analysis/results/。不要发明数字。
 ```
 
-**你会得到什么**　活跃 Plan 与可审的方法边界；单独 `/plan` 可随时查看状态。「可以」确认的是方法方案；分析完成后的人审仍走 Panel。
+**你会得到什么**　活跃 Plan、逐项选择记录与仪式批准痕迹；单独 `/plan` 可随时查看状态。「可以」只确认当前节点；「我已审阅并批准本方案」才授权开跑。分析完成后的收尾人审仍走 Panel。
 
 ## 4.3 分析交接：`/handoff`
 
@@ -339,7 +343,7 @@ psyclaw init "睡眠质量与大学生学业倦怠的关系" --paradigm survey-o
 
 ## 4.4 过程核对：`/crosscheck [焦点]`
 
-**能做什么**　过程性 AI 核对：数据/表格一致性、引文是否真实存在（如 DOI 可解析）、格式与报告要求、可复现痕迹。支持多视角合并。
+**能做什么**　过程性 AI 核对：数据/表格一致性、引文是否真实存在（如 DOI 可解析）、格式与报告要求、可复现痕迹。支持多视角合并。默认不自动开跑——助理应先征得你同意（消耗 token 较多）。
 
 **怎么用**
 ```text
@@ -352,7 +356,7 @@ psyclaw init "睡眠质量与大学生学业倦怠的关系" --paradigm survey-o
 
 ## 4.5 实质验证：`/verify [焦点]`
 
-**能做什么**　实质性 AI 验证：结果是否站得住、引文是否足以支撑主张、方法是否匹配设计、解释边界是否过当。
+**能做什么**　实质性 AI 验证：结果是否站得住、引文是否足以支撑主张、方法是否匹配设计、解释边界是否过当。同样须先征得同意再开。
 
 **怎么用**
 ```text
@@ -365,7 +369,7 @@ psyclaw init "睡眠质量与大学生学业倦怠的关系" --paradigm survey-o
 
 ## 4.6 选题澄清：`/brainstorm [主题]`
 
-**能做什么**　显式启动研究方向头脑风暴：提出若干有理论意义、可回答的方向，比较价值与可行性，并推荐一个。
+**能做什么**　显式启动研究方向头脑风暴：提出若干有理论意义、可回答的方向，比较价值与可行性，并推荐一个。适合想法尚少、需要打开选题空间时。
 
 **怎么用**
 ```text
@@ -508,7 +512,7 @@ psyclaw init "睡眠质量与大学生学业倦怠的关系" --paradigm survey-o
 
 # 第五章　四条可复现工作流
 
-以下四条流程可按编号照做。示例主题可替换；配方骨架保持不变：建仓 → 方案 → 可复现执行 → 过程核对 → 实质验证 → 人审 → 交接/定稿。每一步都写出**期望产出**，便于你对照「这一步是否真的完成」。
+以下四条流程可按编号照做。示例主题可替换；配方骨架保持不变：建仓 → 逐项方案 → 仪式批准 → 可复现执行 →（征得同意后）过程核对 → 实质验证 → 人审 → 交接/定稿。每一步都写出**期望产出**，便于你对照「这一步是否真的完成」。
 
 建议第一次完整跟做 5.1（问卷分析到交接），再按需要选用 5.2（文献与初稿）、5.3（动数据前加压）或 5.4（定稿核验）。四条配方可以串联：5.3 加压 → 5.1 分析交接 → 5.2 写稿 → 5.4 定稿前核验。
 
@@ -521,7 +525,7 @@ psyclaw init "睡眠质量与大学生学业倦怠的关系" --paradigm survey-o
 
 ```bash
 mkdir sleep-burnout-study && cd sleep-burnout-study
-npm install -g psyclaw@0.29.15   # 若尚未安装
+npm install -g psyclaw@0.30.1   # 若尚未安装
 psyclaw
 ```
 
@@ -548,23 +552,26 @@ psyclaw
 /plan 睡眠质量与学业倦怠的相关及回归，控制年级与性别
 ```
 
-或对推荐方案直接回复 `可以`。
+或对当前决策卡回复 `可以`。全部子项选定后，完整输入：
 
-**期望产出**：活跃 Plan；可用单独 `/plan` 查看状态。
+```text
+我已审阅并批准本方案
+```
 
-5. 自然语言执行：
+**期望产出**：活跃 Plan，且状态显示已记录仪式批准。
+
+5. 自然语言执行（仪式批准后）：
 
 ```text
-请按已确认方案在 analysis/scripts/ 生成可复现脚本并运行；结果写入 analysis/results/。不要发明数字。
+请按已批准方案在 analysis/scripts/ 生成可复现脚本并运行；结果写入 analysis/results/。不要发明数字。
 ```
 
 **期望产出**：脚本与结果摘要或表图路径。若缺 Python/R，系统应说明需要什么。
 
-6. 输入：
+6. 先同意再开两道 AI 核查：
 
 ```text
-/crosscheck 样本量、主效应、效应量与区间、表文一致性
-/verify 主结果是否成立、方法是否匹配相关/回归设计、解释有无过当
+可以，请 /crosscheck 样本量、主效应、效应量与区间、表文一致性；再 /verify 主结果是否成立、方法是否匹配相关/回归设计、解释有无过当
 ```
 
 **期望产出**：相关项变为 `ai-checked`。此时打开 Panel 做人审，再宣称分析完成。
@@ -591,11 +598,17 @@ psyclaw
 **目标**：在已有分析交接或明确文献任务时，推进综述与初稿，并用模拟评审找漏洞。  
 **完成后你手中应有**：可核验的文献笔记或引言骨架、`paper/` 下初稿，以及一份你已筛选过的 `/review` 意见清单。
 
-1. 进入已建仓项目，`Shift+Tab` 到 academic（或 `/ars`）。
+1. 进入已建仓项目，`Shift+Tab` 到 academic（或 `/ars`）。若研究问题仍模糊，先提醒自己用 `/grill`；若缺想法，先 `/brainstorm`。
 
 2. 输入 `/ars doctor`，按提示处理缺失项。
 
-3. 输入：
+3. 先拆节点确认，再执行。例如先说：
+
+```text
+请先说明本综述打算怎么做（数据库/纳入边界/冲突证据怎么呈现），并列出将向我展示的产物清单。等我确认后再检索。
+```
+
+确认后再输入：
 
 ```text
 /ars 社交支持与研究生抑郁：有界文献梳理并形成引言草稿骨架
@@ -627,7 +640,7 @@ psyclaw
 
 **期望产出**：多角色模拟评审意见；你挑选必改项后再修订。
 
-7. 定稿前接 5.4：`/crosscheck` + `/verify` + Panel 人审。
+7. 定稿前接 5.4：征得同意后 `/crosscheck` + `/verify` + Panel 人审。
 
 ## 5.3 压力测试研究方案：先澄清加压，再定分析
 
@@ -659,7 +672,7 @@ psyclaw
 
 **期望产出**：带边界披露的 Plan。
 
-4. 再按 5.1：自然语言确认与执行 → `/crosscheck` + `/verify` → Panel 人审 → `/handoff`。
+4. 再按 5.1：子节点「可以」→「我已审阅并批准本方案」→ 脚本 →（同意后）`/crosscheck` + `/verify` → Panel 人审 → `/handoff`。
 
 ## 5.4 定稿前核验：过程 + 实质 + 人审
 
@@ -711,7 +724,7 @@ psyclaw
 | `/verify`（实质：结果成立性、引文与方法合理性、解释边界） | AI | 实质问题清单，`ai-checked` | 还需人审 |
 | Panel「核实」或唤醒选项中的人审 | 你 | 人审通过记录 | 是（在门禁要求范围内） |
 
-推荐节奏：分析前用「可以」确认方案；分析后先 `/crosscheck`，再 `/verify`，最后 Panel 核实；写作定稿同样走过程 + 实质 + 人审。跳过（skip）的项不会被当作完成证据。
+推荐节奏：分析中对每个子节点用「可以」确认，整体开跑输入「我已审阅并批准本方案」；分析后先征得同意再 `/crosscheck`，再 `/verify`，最后 Panel 核实；写作定稿同样走过程 + 实质 + 人审。跳过（skip）的项不会被当作完成证据。
 
 ## 6.3 唤醒选项
 
@@ -721,7 +734,7 @@ psyclaw
 
 完成 analysis 交接与 academic 定稿前，走完「两道 AI 核查 + 人审」后，`/handoff` 与最终化才能通过。你得到的是可审计的收尾状态：哪些已核、哪些由你核实、还有哪些阻塞——而不是一句无法回溯的「做完了」。
 
-对人审节奏的实用建议：分析前把估计目标与排除规则说清楚（可用「可以」确认方案）；分析后重点核实 N、主效应与不确定性、表文一致、方法与脚本一致；写作定稿重点核实引文支撑与解释边界。每一次核实都在为未来的自己与合作者节省时间。
+对人审节奏的实用建议：分析前把估计目标与排除规则说清楚（子节点「可以」+ 仪式批准句）；分析后重点核实 N、主效应与不确定性、表文一致、方法与脚本一致；写作定稿重点核实引文支撑与解释边界；OA 全文下载前先同意，失败时看说明与 DOI。每一次核实都在为未来的自己与合作者节省时间。
 
 # 第七章　证据与研究规范
 
@@ -740,7 +753,7 @@ psyclaw
 
 ## 7.2 数据与隐私
 
-原始/敏感资料先去标识、最小化字段，再决定是否进入模型上下文。`data/raw/`（及兼容的 `.psyclaw/data/raw/`）保持只读，使你始终保有「从原始数据重来」的能力。机构订阅全文走合法访问；合法 PDF 放入 `literature/pdfs/` 后，写作阶段的引文核验更顺畅。
+原始/敏感资料先去标识、最小化字段，再决定是否进入模型上下文。`data/raw/`（及兼容的 `.psyclaw/data/raw/`）保持只读，使你始终保有「从原始数据重来」的能力。机构订阅全文走合法访问；开放获取（OA）PDF 会优先尝试，但下载前须征得你同意——若无 OA 或下载失败，系统会说明原因并给出 DOI，请你自行合法获取后放入 `literature/pdfs/`。写作阶段的引文核验更顺畅。
 
 ## 7.3 能力扩展时的信任习惯
 
@@ -779,10 +792,16 @@ A：先完成第二章安装与五分钟摸底，再按第五章 5.1 跑通「
 A：AI `/crosscheck` / `/verify` 把相关项标为已核；交接与定稿还须你在 Panel「核实」或唤醒选项中完成人审。两道 AI 核查帮你找问题；人审是你对关键主张负责的一步。
 
 **Q：`/crosscheck` 和 `/verify` 有何差别？**  
-A：前者侧重过程（数据/表一致、引文是否存在、格式与可复现痕迹）；后者侧重实质（结果是否站得住、方法与引文是否合理、解释是否过当）。建议都做，再人审。
+A：前者侧重过程（数据/表一致、引文是否存在、格式与可复现痕迹）；后者侧重实质（结果是否站得住、方法与引文是否合理、解释是否过当）。二者默认不自动开跑——先征得你同意再开。建议都做，再人审。
+
+**Q：已经 `/init` 过，新开对话还要再 init 吗？**  
+A：不必。只要同一目录仍有规范结构（`psyclaw.md` 与约定目录），跨会话可直接继续；重复 `/init` 会提示已检测到既有工作区。
+
+**Q：回复「可以」会不会直接跑脚本？**  
+A：不会。「可以」只确认当前子分析决策卡；整体开跑须完整输入「我已审阅并批准本方案」。
 
 **Q：捆绑的 ARS / Nature / analysis-plan 还要再装吗？**  
-A：不必。它们已随 `psyclaw@0.29.15` 提供；日常用自然语言 soft-route 即可。可选增强（如 WebBridge、风格蒸馏）按需启用。
+A：不必。它们已随 `psyclaw@0.30.1` 提供；日常用自然语言 soft-route 即可。可选增强（如 WebBridge、风格蒸馏）按需启用。
 
 **Q：如何续接昨天的工作？**  
 A：在项目目录运行 `psyclaw --continue`（或 `-c`）。关键背景写入 `psyclaw.md` 后，续接成本更低。
@@ -794,11 +813,11 @@ A：通过门禁表示通过当前产品合同检查。正式研究仍须研究
 
 | 命令 | 能力一句话 |
 |---|---|
-| `/init [目标]` | 初始化工作区；尾随文本为研究目标 |
-| `/plan [目标]` | 查看或新建分析方案；确认用「可以」；执行用自然语言 |
+| `/init [目标]` | 初始化工作区（已有规范结构时可跨会话复用，不必重复） |
+| `/plan [目标]` | 查看或新建分析方案；子节点用「可以」；整体开跑输入「我已审阅并批准本方案」 |
 | `/handoff` | 人审通过后写入 `analysis/HANDOFF.md` |
-| `/crosscheck [焦点]` | 过程性 AI 核对（数据/引文存在/格式/可复现痕迹） |
-| `/verify [焦点]` | 实质性 AI 验证（结果成立性、引文与方法合理性） |
+| `/crosscheck [焦点]` | 过程性 AI 核对（须先征得同意再开） |
+| `/verify [焦点]` | 实质性 AI 验证（须先征得同意再开） |
 | `/brainstorm [主题]` | 研究方向头脑风暴与澄清 |
 | `/grill [主题]` | 研究方案压力测试 |
 | `/review [说明]` | 多角色模拟同行评审 |
@@ -836,13 +855,17 @@ A：通过门禁表示通过当前产品合同检查。正式研究仍须研究
 **确认执行**
 
 ```text
-可以。请把确认的方法写入方案，在 analysis/scripts/ 生成可复现脚本并运行；结果写入 analysis/results/。不要发明数字。
+我已审阅并批准本方案
+```
+
+```text
+请按已批准方案在 analysis/scripts/ 生成可复现脚本并运行；结果写入 analysis/results/。不要发明数字。
 ```
 
-**分析后核验（过程 + 实质）**
+**分析后核验（过程 + 实质；先征得同意）**
 
 ```text
-请先 /crosscheck 样本量、主效应、效应量与置信区间、表文一致性、方法与脚本一致性；再 /verify 结果是否成立、解释有无过当。完成后暂停并等待人审。
+可以，请先 /crosscheck 样本量、主效应、效应量与置信区间、表文一致性、方法与脚本一致性；再 /verify 结果是否成立、解释有无过当。完成后暂停并等待人审。
 ```
 
 **人审与交接**
@@ -888,20 +911,20 @@ A：通过门禁表示通过当前产品合同检查。正式研究仍须研究
 安装备忘：
 
 ```bash
-npm install -g psyclaw@0.29.15
+npm install -g psyclaw@0.30.1
 psyclaw --help
 ```
 
-运行要求：Node.js `>=22.19.0`。产品版本：**v0.29.15**。发布日期：2026-09-08。
+运行要求：Node.js `>=22.19.0`。产品版本：**v0.30.1**。发布日期：2026-09-09。
 
 # 附录 D　边界速览（选读）
 
 以下内容帮助设定合理预期（全文仅此一处集中说明）：
 
 1. 统计计算委托成熟库或受信任 MCP；核心不内置统计算法，也不编造数值。
-2. `/crosscheck` 与 `/verify` 分工不同；人审走 Panel「核实」/唤醒选项，不是用户斜杠。
-3. 「可以」确认方法方案；`/handoff` 与定稿门禁认人审通过，`ai-checked` 与 skip 不够。
-4. DOI 证明文献可定位，不自动证明当前主张；模拟 `/review` 不等于期刊接收。
+2. `/crosscheck` 与 `/verify` 分工不同，且默认先征得同意再开；人审走 Panel「核实」/唤醒选项，不是用户斜杠。
+3. 「可以」只确认当前子节点；整体开跑须完整输入「我已审阅并批准本方案」。`/handoff` 与定稿门禁认人审通过，`ai-checked` 与 skip 不够。
+4. DOI 证明文献可定位，不自动证明当前主张；OA 全文下载前须同意，失败或无 OA 须说明并给 DOI。模拟 `/review` 不等于期刊接收。
 5. 通过产品门禁 ≠ 结论真实、因果成立或可投稿；正式研究仍须复核、方法学审查与适用伦理程序。
 6. 应用层门禁不是操作系统级沙箱；高敏感数据与不可逆发布需更强隔离与制度审批。
-7. 斜杠为 Codex 风格（单独命令或命令 + 尾随自由文本），无子命令树。
+7. 斜杠为 Codex 风格（单独命令或命令 + 尾随自由文本），无子命令树。已建仓目录跨会话不必重复 `/init`。

package/docs//344/275/277/347/224/250/347/231/275/347/232/256/344/271/246.md

@@ -1,3 +1,3 @@
 # PsyClaw 使用白皮书
 
-当前使用说明、安装方式和命令接口请阅读 [PsyClaw使用白皮书_v0.29.15.md](PsyClaw使用白皮书_v0.29.15.md)。同步提供 Word 版：[PsyClaw使用白皮书_v0.29.15.docx](PsyClaw使用白皮书_v0.29.15.docx)。
+当前使用说明、安装方式和命令接口请阅读 [PsyClaw使用白皮书_v0.30.1.md](PsyClaw使用白皮书_v0.30.1.md)。同步提供 Word 版：[PsyClaw使用白皮书_v0.30.1.docx](PsyClaw使用白皮书_v0.30.1.docx)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "psyclaw",
-  "version": "0.30.0",
+  "version": "0.30.2",
   "description": "A standalone, evidence-grounded social-science research agent with research contracts, evidence gates, and recoverable workflows",
   "type": "module",
   "license": "MIT",
@@ -32,7 +32,7 @@
     "scripts/psyclaw.mjs",
     "scripts/rebrand-pi.mjs",
     "docs/使用白皮书.md",
-    "docs/PsyClaw使用白皮书_v0.29.15.md"
+    "docs/PsyClaw使用白皮书_v0.30.1.md"
   ],
   "engines": {
     "node": ">=22.19.0"

package/skills/core/academic-grill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: academic-grill
-description: Stress-test an academic research question, proposal, study design, analysis plan, manuscript claim, review protocol, or AI research project through a one-question-at-a-time interview until its consequential decisions, evidence boundaries, and reporting commitments are explicit. Use when the user invokes /grill or asks for rigorous academic questioning. Do not use for /brainstorm — brainstorm is a separate lightweight ideation path.
+description: Stress-test an academic research question, proposal, study design, analysis plan, manuscript claim, review protocol, or AI research project through a one-question-at-a-time interview until its consequential decisions, evidence boundaries, and reporting commitments are explicit. Use when the user invokes /grill or asks for rigorous academic questioning. For open-ended ideation without pressure-testing, use /brainstorm instead.
 license: MIT
 ---
 

package/skills/core/analysis-plan/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: analysis-plan
-description: Soft-takeover stats planning in analysis mode — light EDA, per-analysis human choices, natural-language confirm, optional auto mode, then local scripts (MCP only when needed).
+description: Soft-takeover stats planning in analysis mode — light EDA, per-analysis human choices, typed ritual approval before execute, optional auto mode, then local scripts (MCP only when needed).
 license: MIT
 ---
 
@@ -16,12 +16,16 @@ Use this skill only in **analysis** mode. Do not start academic/ARS writing from
    - Options: **first option must be a concrete new method**; you may add alternatives; put「已经足够，先执行已选」**last**, never as the default recommendation
    - Your recommendation with rationale
    - Wait for the user to pick (or say「可以」to accept the recommendation) before adding the next analysis
-3. **Soft confirm** — Prefer natural language: ask the user to reply **「可以 / 确认」**. Do **not** insist on typing `/plan confirm`. Soft confirm ≠ ARS checkpoint ≠ hard awaiting-human.
-4. **Auto mode** — If the user said `/plan auto`, proceed without waiting, but every report/script summary must state **「未经人审批」**.
-5. **Pre-analysis crosscheck** — Before running scripts, propose checklist items (design/estimand, method choice, missingness). Prefer Panel `/panel` checklist; `/crosscheck` works in-terminal. Skipping is allowed only with **「未经核对」** labels.
+   - Soft「可以 / 确认」only settles the current card — it does **not** authorize scripts
+3. **Overall ritual approval (required unless `/plan auto`)** — After every listed choice is decided, ask the user to type exactly:
+
+   `我已审阅并批准本方案`
+
+   Record that sentence as the approval ritual. Do not treat short tokens (可以 / ok / 继续) as execute authorization.
+4. **Auto mode** — If the user said `/plan auto`, proceed without ritual, but every report/script summary must state **「未经人审批」**.
+5. **Crosscheck / verify (human-gated)** — Do **not** start `/crosscheck` or `/verify` automatically. After scripts (or before a costly pass), ask whether to open that block; only run it after an explicit yes. Skipping must mark **「未经核对」**.
 6. **Execute** — Local reproducible scripts under `analysis/scripts/` by default; MCP only for special backends or explicit request.
-7. **Post-analysis crosscheck** — After results: N, effects+CI, table–text, method–script match, claim language. Same Panel/skip rules.
-8. **Handoff** — Update `analysis/HANDOFF.md` before academic mode.
+7. **Handoff** — Update `analysis/HANDOFF.md` before academic mode. Final Panel「核实」remains required for completion.
 
 ## Volume rule
 
@@ -29,11 +33,11 @@ Never tell the user “分析方法已经足够了” as a closing statement. If
 
 ## Persistence
 
-Keep state in `analysis/plans/` (`/plan new|status|auto|human|run|defer|handoff`). Natural-language「可以」confirms and runs when a plan is awaiting confirm.
+Keep state in `analysis/plans/` (`/plan new|status|auto|human|run|defer|handoff`). Soft「可以」acknowledges a node; the typed ritual authorizes run when `approvalMode=human`.
 
 ## Boundaries
 
 - Never overwrite `data/raw`.
 - No novel stats algorithms in PsyClaw core.
 - Do not merge with ARS planning.
-- Model **initiates** crosschecks; humans mark items — do not expect users to invent `/verify` ids themselves.
+- Model **proposes** crosschecks after asking; humans mark items — do not expect users to invent `/verify` ids themselves.

package/skills/recommended/catalog.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "psyclaw/recommended-skills/v1",
-  "documentVersion": "0.8.0",
-  "syncedAt": "2026-09-08",
+  "documentVersion": "0.8.1",
+  "syncedAt": "2026-09-09",
   "sourceDocument": "学术AI_Skill分享资料.pdf",
   "sourceRef": "local-user-curated",
   "items": [
@@ -66,6 +66,15 @@
       "description": "按开放来源、官方接口和用户授权会话尝试获取论文全文。",
       "sourceRef": "https://github.com/Rimagination/scansci-pdf"
     },
+    {
+      "id": "paper2local",
+      "name": "paper2local",
+      "kind": "skill",
+      "stage": "全文获取",
+      "description": "把 DOI / URL / arXiv 等已选文献下载到本地目录（PsyClaw 默认 literature/pdfs）。无 Zotero、无 MinerU、仅标准库下载。",
+      "sourceRef": "https://github.com/Exekiel179/paper2local",
+      "installHint": "安装仓库根目录完整 Skill（SKILL.md + scripts/）。不要安装 Timisic/paper2zotero-skill 全量依赖栈。"
+    },
     {
       "id": "scholarbridge",
       "name": "ScholarBridge",