psyclaw 0.30.0 → 0.30.2

package/README.md

@@ -4,7 +4,7 @@ PsyClaw 是面向社会科学研究的智能体工作台。它把研究项目、
 
 PsyClaw 自有代码使用 MIT 许可证；随 npm 包内置的 Academic Research Skills 位于 `vendor/ars`，保持上游署名并单独遵循 CC BY-NC 4.0，仅限非商业用途。
 
-当前版本：`0.30.0`。正式命令、用户配置目录和后续发布统一使用 `psyclaw`。
+当前版本：`0.30.2`。正式命令、用户配置目录和后续发布统一使用 `psyclaw`。
 
 ## 发布流程
 
@@ -21,19 +21,19 @@ RELEASE_MESSAGE="release: describe the change" pnpm release:push
 需要 Node.js `>=22.19.0`。官方 npm 源：
 
 ```powershell
-npm install -g psyclaw@0.30.0
+npm install -g psyclaw@0.30.2
 ```
 
 如果本机 npm 配置把 registry 误写成带有 `~/` 的地址，请显式指定官方源：
 
 ```bash
-npm install -g psyclaw@0.30.0 --registry=https://registry.npmjs.org/
+npm install -g psyclaw@0.30.2 --registry=https://registry.npmjs.org/
 ```
 
 中国大陆网络较慢或无法访问官方源时：
 
 ```powershell
-npm install -g psyclaw@0.30.0 --registry=https://registry.npmmirror.com
+npm install -g psyclaw@0.30.2 --registry=https://registry.npmmirror.com
 ```
 
 或安装脚本：
@@ -46,7 +46,7 @@ PSYCLAW_CN=1 curl -fsSL https://exekiel179.github.io/psyclaw/install.sh | sh
 ```powershell
 # Windows PowerShell
 irm https://exekiel179.github.io/psyclaw/install.ps1 | iex
-# 可选：$env:PSYCLAW_CN = "1"；$env:PSYCLAW_VERSION = "0.30.0"
+# 可选：$env:PSYCLAW_CN = "1"；$env:PSYCLAW_VERSION = "0.30.2"
 ```
 
 检测到国内 npm registry（如 npmmirror）、`PSYCLAW_CN=1` 或 `PSYCLAW_GITHUB_MIRROR` 时，内置路径统一走国内可用路由：
@@ -108,7 +108,7 @@ psyclaw evidence add notes\source.md --level user
 | 打开科研面板 | 在对话中输入 `/panel` |
 | 查看或切换 Provider | 在对话中输入 `/provider` 或 `/provider <id>` |
 | 管理启动横幅宠物 | `/pet`、`/pet on`、`/pet off`（默认关闭） |
-| 管理 Skill | `/skill`（在管理页启用/安装） |
+| 管理 Skill | `/skill`（未安装→安装并默认启用；已启用→停用） |
 | 创建项目能力 | `/create-skill`、`/create-hook`、`/create-rule`、`/create-subagent`（附带需求文本） |
 | 运行只读 Subagent | `/agents` 浏览，或 `/agents <task>` 运行 |
 | 调用已加载 Skill | `/skill:<name>` |
@@ -189,13 +189,25 @@ rm -rf ~/.psyclaw
 
 ## 文档
 
-- [PsyClaw v0.26.0 使用白皮书](docs/PsyClaw使用白皮书_v0.26.0.md)
+### 使用（面向研究者）
+
+- [使用白皮书](docs/使用白皮书.md)（当前版同步说明；带版本号的副本见 `docs/PsyClaw使用白皮书_v*.md`）
+- [PsyClaw ARS 模式与保护边界](docs/PsyClaw-ARS模式.md)
+- [遥测（匿名产品遥测，默认开启，可关闭）](docs/telemetry.md)
+- [文档与交付物规范](docs/文档规范.md)（研究项目内目录约定）
+
+### 开发（面向贡献者 / 维护者）
+
+下列文件是仓库与实现契约，**不是**日常使用说明；贡献或改核心前再读：
+
 - [项目范围与里程碑](docs/开工纪要.md)
 - [架构蓝图](docs/架构蓝图.md)
 - [评测框架](docs/评测框架.md)
-- [PsyClaw ARS 模式与保护边界](docs/PsyClaw-ARS模式.md)
-- [文档与交付物规范](docs/文档规范.md)
-- [遥测（匿名产品遥测，默认开启，可关闭）](docs/telemetry.md)
+- [技能与生态准入清单](docs/技能与生态准入清单.md)
+- [威胁模型](docs/威胁模型.md)
+- [AGENTS.md](AGENTS.md)（贡献行为约束）
+
+历史审计、分模块测评报告、会话复盘等仍在 `docs/` 下，按文件名识别；勿与使用白皮书混读。
 
 ## 边界
 

package/dist/src/adapters/pi/extension.js

@@ -1,6 +1,6 @@
 import { DefaultPackageManager, getAgentDir, SettingsManager } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
-import { appendApproval, approvalInputDigest, assertResearchDecision, bootstrapProject, resolveResearchDecision, runInstitutionalFulltext, runLiteratureReview, runExpertReview, runAnalysisDelegation, runWritingReview, runMetaAnalysis, createStageRunner, exportAcademicDocument, recordCitationUse, runParallelPeerReview } from "../../index.js";
+import { appendApproval, approvalInputDigest, assertResearchDecision, bootstrapProject, ensureProjectBinding, hasCanonicalWorkspace, resolveResearchDecision, runInstitutionalFulltext, runLiteratureReview, runExpertReview, runAnalysisDelegation, runWritingReview, runMetaAnalysis, createStageRunner, exportAcademicDocument, recordCitationUse, runParallelPeerReview } from "../../index.js";
 import { runPlanWithPi } from "../../orchestration/pi-executor.js";
 import { formatEffects, hasElevatedEffects, normalizeEffects, toolsForEffects } from "../../orchestration/effects.js";
 import { agentManagerRows } from "../../agents/recommended-personas.js";
@@ -32,7 +32,7 @@ import { arsRoot } from "../../ars/pi-panel-executor.js";
 import { ArsModeEditor, isArsModeEditorText } from "../../ars/mode-editor.js";
 import { MODE_STATUS, detectChatModeMismatch, formatChatModeMismatchNotice, nextSessionMode, parseSessionMode, sessionModePrompt, } from "../../session/modes.js";
 import { continuouslyWorkWarningText, isContinuouslyWorkEnabled, } from "../../session/continuously-work.js";
-import { assertHumanVerifyGate, formatVerifyChecklist, isNaturalPlanConfirm, ensureDefaultVerifyChecklist, loadVerifyChecklist } from "../../verify/checklist.js";
+import { assertHumanVerifyGate, formatVerifyChecklist, isNaturalPlanConfirm, isPlanRitualConfirm, PLAN_RITUAL_PHRASE, ensureDefaultVerifyChecklist, loadVerifyChecklist } from "../../verify/checklist.js";
 import { formatSessionHelp, formatSessionHelpBrief } from "../../session/help.js";
 import { openResearchWorkbench } from "../../panel/workbench.js";
 import { captureAgentError, initNodeObservability, readTelemetryPreference, shutdownObservability, trackGateWaiting, writeTelemetryPreference, } from "../../observability/index.js";
@@ -181,10 +181,10 @@ function academicGrillRequest(subject, mode) {
             : "持久化模式：review。追问完成后先展示拟更新摘要和受影响文件，并询问我是否写回；得到明确确认前不得修改项目文档。",
     ].join("\n");
 }
-/** Lightweight ideation path — never routes through academic-grill / /grill. */
+/** Lightweight ideation path for research directions. */
 function academicBrainstormRequest(subject) {
     return [
-        "这是 /brainstorm，不是 /grill：不要加载 academic-grill Skill，不要进入逐题压力测试或研究规格访谈。",
+        "这是 /brainstorm：做选题向头脑风暴。不要加载 academic-grill，不要进入逐题压力测试或研究规格访谈。",
         subject
             ? `头脑风暴主题：${subject}`
             : "根据当前对话与项目材料确定头脑风暴主题；已有信息不要重复询问。",
@@ -193,12 +193,12 @@ function academicBrainstormRequest(subject) {
         "2. 简要比较各自的价值、可行性、数据需求与推断边界。",
         "3. 明确推荐其中一个，并说明推荐理由与主要取舍。",
         "4. 最多再问 1-2 个真正影响选题的澄清问题（可一次给出）；不要展开完整的设计/测量/估计量审讯。",
-        "不要执行分析、不要写论文、不要伪造文献或结果。若用户接下来需要严格压力测试，请提示他们另用 /grill。",
+        "不要执行分析、不要写论文、不要伪造文献或结果。",
     ].join("\n");
 }
 async function readActiveProject(root) {
     try {
-        const project = await readProject(root);
+        const { project } = await ensureProjectBinding({ root });
         return {
             projectId: project.id,
             runId: `project_${project.id}`,
@@ -410,17 +410,21 @@ async function skillManagerRows(root, state) {
 }
 async function mcpManagerRows(root, state, runtime) {
     const { items, installPrep } = await recommendedItems("mcp");
+    const userEntries = await runtime.listUserConfigs(root);
+    const configuredIds = new Set(userEntries.map((entry) => entry.id));
     const recommendedRows = items.map((item) => {
         const id = String(item.id ?? "");
         const plan = installPrep.find((candidate) => candidate.id === id);
         const dependencies = Array.isArray(plan?.dependencies)
             ? plan.dependencies.filter((value) => typeof value === "string")
             : [];
+        const installed = configuredIds.has(id);
         return {
             id,
             name: String(item.name ?? id),
             description: String(item.description ?? ""),
             ...(typeof item.sourceRef === "string" ? { sourceRef: item.sourceRef } : {}),
+            installed,
             enabled: state.mcp.includes(id),
             source: "recommended",
             details: [
@@ -433,10 +437,11 @@ async function mcpManagerRows(root, state, runtime) {
     // Merge user-configured MCP servers (`.psyclaw/mcp/*.json` and
     // `~/.psyclaw/mcp/*.json`) so the management page shows them too, even when
     // disabled.  User rows win over a same-id recommended row.
-    const userRows = (await runtime.listUserConfigs(root)).map((entry) => ({
+    const userRows = userEntries.map((entry) => ({
         id: entry.id,
         name: entry.name,
         description: `用户配置：${entry.command}`,
+        installed: true,
         enabled: entry.enabled,
         source: "user",
         userEntry: entry,
@@ -508,7 +513,7 @@ function mcpManagerItems(rows) {
         id: row.id,
         name: row.name,
         description: row.description,
-        status: row.enabled ? "enabled" : "disabled",
+        status: row.enabled ? "enabled" : row.installed ? "disabled" : "missing",
         configuredEnabled: row.enabled,
         ...(row.sourceRef === undefined ? {} : { sourceRef: row.sourceRef }),
         details: row.details,
@@ -518,10 +523,10 @@ async function openMcpManager(ctx, rows) {
     return ctx.ui.custom((tui, theme, keybindings, done) => (new SkillManagerComponent(mcpManagerItems(rows), tui, theme, keybindings, done, {
         title: "MCP 管理",
         itemLabel: "MCP",
-        footer: "↑/↓ 移动 · Space 开启/关闭 · a 全部开启 · d 全部关闭 · Enter 交给模型安装并配置 · Esc 关闭",
-        enterAction: "install",
-        enabledText: "已开启；Enter 可让当前模型重新安装或修复推荐配置",
-        disabledText: "已关闭",
+        footer: "↑/↓ 移动 · Space/Enter 安装或启停 · a 全部开启 · d 全部关闭 · Esc 关闭",
+        enabledText: "已开启；再次点击可关闭",
+        disabledText: "已安装，当前未启用；点击可开启",
+        missingMessage: "尚未安装；点击交给模型安装并默认启用",
     })));
 }
 function pluginManagerItems(rows) {
@@ -643,7 +648,7 @@ function modelMcpInstallTask(root, row, plan) {
         "用户已经通过 MCP 管理页明确授权本次安装。你可以直接联网、克隆或下载来源、使用所需包管理器安装依赖、执行安装命令，并写入与该 MCP 有关的项目或用户级运行配置；不要再次要求用户批准这些安装步骤。",
         "请先阅读来源仓库的实际安装与启动说明，再根据当前操作系统和宿主环境完成可运行的 stdio/HTTP MCP 配置。目录中的版本、命令和依赖只作参考，不得因为哈希、许可证、依赖或本地数据策略检查而中止安装。",
         "安装完成后实际启动一次服务器或执行等价的最小连通性检查，确认启动命令和工作目录有效。不要输出、复制或提交 API Key、令牌及其他凭据。",
-        `成功后确保 .psyclaw/recommendations.json 的 mcp 列表包含 ${JSON.stringify(row.id)}，说明写入了哪些配置，并提醒用户执行 /reload。若安装命令本身失败，直接诊断并修复；只有遇到必须由用户提供的凭据或外部软件许可证时才向用户说明。`,
+        "成功后确保 .psyclaw/recommendations.json 的 mcp 列表包含该 id（安装时已默认写入启用），说明写入了哪些配置，并提醒用户执行 /reload。若安装命令本身失败，直接诊断并修复；只有遇到必须由用户提供的凭据或外部软件许可证时才向用户说明。",
     ].join("\n");
 }
 async function queueModelMcpInstall(pi, ctx, row, plan) {
@@ -651,7 +656,7 @@ async function queueModelMcpInstall(pi, ctx, row, plan) {
         throw new Error(`推荐 MCP 没有来源网址: ${row.id}`);
     await setRecommendedMcpEnabled(ctx.cwd, row.id, true);
     pi.sendUserMessage(modelMcpInstallTask(ctx.cwd, row, plan), ctx.isIdle() ? {} : { deliverAs: "followUp" });
-    ctx.ui.notify(`已将 ${row.name} 的下载、安装和配置任务交给当前模型。模型完成并确认可启动后，请执行 /reload。`, "info");
+    ctx.ui.notify(`已将 ${row.name} 的下载、安装和配置任务交给当前模型（默认启用）。完成后请执行 /reload。`, "info");
 }
 async function showMcpManager(pi, ctx, runtime) {
     const catalog = await recommendedItems("mcp");
@@ -708,7 +713,7 @@ function modelSkillInstallTask(root, row, scope) {
             ? "这是多 Skill 套件：目标目录自身无需 SKILL.md，但其子目录必须包含一个或多个有效 SKILL.md。保留套件内共享目录和相对路径，不得包含 .git、符号链接或凭据。"
             : "目标目录最终必须直接包含有效 SKILL.md（YAML frontmatter 至少包含 name 和 description），不得包含 .git、符号链接、凭据或二进制大文件。",
         "如果仓库包含多个 Skill，只安装与此推荐项相符的部分；如果它不是 Skill 或无法合理适配，停止并说明原因，不要伪造 SKILL.md。",
-        "安装完成后检查目标目录结构，并提醒用户执行 /skill 启用该项，再执行 /reload。",
+        "安装完成后检查目标目录结构。该项已在推荐状态中默认启用；完成后执行 /reload 即可加载，无需再手动启用。",
     ].join("\n");
 }
 async function chooseSkillScope(ctx) {
@@ -721,20 +726,27 @@ async function chooseSkillScope(ctx) {
         return "user";
     return undefined;
 }
+async function markRecommendedSkillDesired(root, requestedId, scope) {
+    const id = normalizeRecommendedSkillId(requestedId);
+    const state = await readRecommendationState(root);
+    const current = new Set(state.skills);
+    current.add(id);
+    state.skills = [...current];
+    state.skillScopes = { ...(state.skillScopes ?? {}), [id]: scope };
+    await saveRecommendationState(root, state);
+}
 async function queueModelSkillInstall(pi, ctx, row) {
     if (!row.sourceRef)
         throw new Error(`推荐 Skill 没有来源网址: ${row.id}`);
     const scope = await chooseSkillScope(ctx);
     if (!scope)
         return;
-    const approved = await ctx.ui.confirm("交给当前模型安装 Skill？", `${row.name}\n来源：${row.sourceRef}\n安装位置：${skillScopeLabel(scope)}\n目标目录：${recommendedSkillTarget(ctx.cwd, row.id, scope)}\n模型将检查仓库并使用文件与命令工具完成安装。`);
+    const approved = await ctx.ui.confirm("交给当前模型安装 Skill？", `${row.name}\n来源：${row.sourceRef}\n安装位置：${skillScopeLabel(scope)}\n目标目录：${recommendedSkillTarget(ctx.cwd, row.id, scope)}\n模型将检查仓库并使用文件与命令工具完成安装；安装后默认启用。`);
     if (!approved)
         return;
-    const state = await readRecommendationState(ctx.cwd);
-    state.skillScopes = { ...(state.skillScopes ?? {}), [row.id]: scope };
-    await saveRecommendationState(ctx.cwd, state);
+    await markRecommendedSkillDesired(ctx.cwd, row.id, scope);
     pi.sendUserMessage(modelSkillInstallTask(ctx.cwd, row, scope), ctx.isIdle() ? {} : { deliverAs: "followUp" });
-    ctx.ui.notify(`已将 ${row.name} 的安装任务交给当前模型，目标为${skillScopeLabel(scope)}。安装完成后请在 /skill 中启用，再执行 /reload。`, "info");
+    ctx.ui.notify(`已将 ${row.name} 的安装任务交给当前模型（默认启用），目标为${skillScopeLabel(scope)}。完成后请执行 /reload。`, "info");
 }
 async function showSkillManager(pi, ctx) {
     if (!ctx.hasUI || typeof ctx.ui.custom !== "function") {
@@ -1049,29 +1061,72 @@ export default function psyclawExtension(pi) {
                     };
                 }
             }
-            // Natural-language plan confirm: reply「可以」instead of forcing /plan confirm.
-            if (mode === "analysis" && isNaturalPlanConfirm(trimmed)) {
+            // Plan confirmations: soft「可以」= per-node / method acknowledge; ritual phrase = authorize execute.
+            if (mode === "analysis" && (isPlanRitualConfirm(trimmed) || isNaturalPlanConfirm(trimmed))) {
                 const plan = await readActiveAnalysisPlan(ctx.cwd);
                 if (plan && (plan.status === "awaiting-confirm" || plan.status === "ready" || plan.status === "reviewing")) {
                     const method = plan.confirmedMethod || plan.primaryAnalysis || plan.proposedMethods[0] || "按当前方案执行";
+                    const pendingChoices = (plan.analysisChoices ?? []).filter((row) => !row.selected);
+                    const ritual = isPlanRitualConfirm(trimmed);
+                    if (!ritual) {
+                        // Soft acknowledge only — never jump to run-now.
+                        let next = plan.status === "awaiting-confirm" && !plan.confirmedMethod
+                            ? advanceAnalysisPlan(plan, { type: "confirm", method, backend: "local-script" })
+                            : plan;
+                        next = await writeAnalysisPlan(ctx.cwd, next);
+                        const needChoices = pendingChoices.length > 0
+                            ? `仍有 ${pendingChoices.length} 项子分析待选；请先逐项确认。`
+                            : `方法已记下。要开始执行，请完整输入：「${PLAN_RITUAL_PHRASE}」`;
+                        ctx.ui.notify(`${formatAnalysisPlanStatus(next)}\n${needChoices}`, "info");
+                        return {
+                            action: "transform",
+                            text: [
+                                "/skill:analysis-plan",
+                                "",
+                                `User soft-acknowledged ("${trimmed}"). Do NOT run scripts yet.`,
+                                `Confirmed method so far: ${next.confirmedMethod ?? method}`,
+                                pendingChoices.length > 0
+                                    ? `Pending per-analysis choices: ${pendingChoices.map((row) => row.id).join(", ")}. Present the next undecided choice card and wait.`
+                                    : `All listed choices are decided (or none yet). Ask the user to type exactly: ${PLAN_RITUAL_PHRASE}`,
+                                "Do not start /crosscheck or /verify until the user explicitly agrees to open that block.",
+                            ].join("\n"),
+                        };
+                    }
+                    if (pendingChoices.length > 0) {
+                        ctx.ui.notify(`${formatAnalysisPlanStatus(plan)}\n仪式句已收到，但还有 ${pendingChoices.length} 项子分析未确认，请先逐项选完。`, "warning");
+                        return {
+                            action: "transform",
+                            text: [
+                                "/skill:analysis-plan",
+                                "",
+                                `User typed the ritual phrase but ${pendingChoices.length} analysis choice(s) remain undecided.`,
+                                "Present the next undecided choice card and wait. Do not execute.",
+                            ].join("\n"),
+                        };
+                    }
                     let next = plan.status === "awaiting-confirm"
                         ? advanceAnalysisPlan(plan, { type: "confirm", method, backend: "local-script" })
                         : plan;
+                    next = advanceAnalysisPlan(next, { type: "ritual-approve", text: PLAN_RITUAL_PHRASE });
                     if (next.status === "reviewing" || next.status === "awaiting-confirm") {
                         next = advanceAnalysisPlan(next, { type: "review" });
                     }
                     next = advanceAnalysisPlan(next, { type: "run-now" });
                     next = await writeAnalysisPlan(ctx.cwd, next);
-                    ctx.ui.notify(`${formatAnalysisPlanStatus(next)}\n已按自然语言确认并开始执行。`, "info");
+                    if (next.status !== "running") {
+                        ctx.ui.notify(`${formatAnalysisPlanStatus(next)}\n未能进入执行（检查子项确认与仪式批准）。`, "warning");
+                        return { action: "handled" };
+                    }
+                    ctx.ui.notify(`${formatAnalysisPlanStatus(next)}\n已记录仪式批准并开始执行。`, "info");
                     return {
                         action: "transform",
                         text: [
                             "/skill:analysis-plan",
                             "",
-                            `User confirmed with natural language ("${trimmed}"). Execute plan ${next.id} now.`,
+                            `User completed plan ritual ("${PLAN_RITUAL_PHRASE}"). Execute plan ${next.id} now.`,
                             `Confirmed method: ${next.confirmedMethod ?? method}`,
-                            next.approvalMode === "auto" ? "approvalMode=auto: label outputs as 未经人审批." : "Human confirmed this step.",
-                            "Before and after analysis, open Panel checklist or /crosscheck; skipping must mark 未经核对.",
+                            next.approvalMode === "auto" ? "approvalMode=auto: label outputs as 未经人审批." : "Human ritual approval recorded.",
+                            "Do NOT auto-start /crosscheck or /verify. After scripts finish, ask whether to open those blocks; only proceed if the user agrees.",
                         ].join("\n"),
                     };
                 }
@@ -1079,7 +1134,11 @@ export default function psyclawExtension(pi) {
             const wantsStats = mode === "analysis" && Boolean(resolveStatsIntent(trimmed));
             const wantsAcademic = mode === "academic" && Boolean(resolveAcademicSoftRoute(trimmed));
             if ((wantsStats || wantsAcademic) && !(await readActiveProject(ctx.cwd))) {
-                if (!ctx.hasUI) {
+                if (await hasCanonicalWorkspace(ctx.cwd)) {
+                    // Heal binding silently — prior /init layout already present.
+                    await ensureProjectBinding({ root: ctx.cwd }).catch(() => undefined);
+                }
+                else if (!ctx.hasUI) {
                     return {
                         action: "transform",
                         text: [
@@ -1089,13 +1148,15 @@ export default function psyclawExtension(pi) {
                         ].join("\n"),
                     };
                 }
-                const choice = await ctx.ui.select("尚未 /init。统计/写作建议先建仓，否则交接与核对清单不完整。", ["先执行 /init", "本次继续（稍后 init）", "取消"], { timeout: 120_000 });
-                if (choice === "取消" || choice === undefined)
-                    return { action: "handled" };
-                if (choice === "先执行 /init") {
-                    return { action: "transform", text: `/init\n\n（用户选择先初始化，完成后再继续：${trimmed}）` };
+                else {
+                    const choice = await ctx.ui.select("尚未 /init。统计/写作建议先建仓，否则交接与核对清单不完整。", ["先执行 /init", "本次继续（稍后 init）", "取消"], { timeout: 120_000 });
+                    if (choice === "取消" || choice === undefined)
+                        return { action: "handled" };
+                    if (choice === "先执行 /init") {
+                        return { action: "transform", text: `/init\n\n（用户选择先初始化，完成后再继续：${trimmed}）` };
+                    }
+                    ctx.ui.notify("继续本次请求；建议随后 /init。关键结果请做交叉核验。", "warning");
                 }
-                ctx.ui.notify("继续本次请求；建议随后 /init。关键结果请做交叉核验。", "warning");
             }
             if (mode === "academic") {
                 const match = resolveAcademicSoftRoute(event.text);
@@ -1156,7 +1217,17 @@ export default function psyclawExtension(pi) {
         handler: async (args, ctx) => {
             try {
                 const parsed = parseInitArgs(args);
+                const already = await hasCanonicalWorkspace(ctx.cwd);
+                const hadProject = Boolean(await readActiveProject(ctx.cwd).catch(() => null));
                 const project = await bootstrapProject({ root: ctx.cwd, ...parsed });
+                if (already || hadProject) {
+                    ctx.ui.notify([
+                        `已检测到既有工作区，无需重新建仓：${project.id}`,
+                        "规范目录与 psyclaw.md 已存在；跨会话可直接继续 analysis / academic。",
+                        "Shift+Tab：chat → analysis → academic · 输入 /help 查看速览。",
+                    ].join("\n"), "info");
+                    return;
+                }
                 ctx.ui.notify([
                     `工作仓库已初始化：${project.id}`,
                     "已创建 data/raw|clean、analysis/、literature/、paper/、psyclaw.md、.psyclaw/",
@@ -1191,9 +1262,9 @@ export default function psyclawExtension(pi) {
                 "3) 格式与报告要求：APA/三线表/必备报告字段、清单项是否齐；",
                 "4) 过程产物：脚本入口、中间文件、可复现痕迹是否齐全。",
                 "执行方式：派出至少两个独立审查视角（例如：数据一致性；引文存在性；格式/报告合同），各自给出发现后再合并为一份报告；标出一致项与冲突项。",
-                "不得自称已过人审。人审由系统在交接/定稿门禁自动要求，经 Panel「核实」或唤醒选项完成。",
+                "不得自称已过人审。不要在用户未明确同意前自动启动本核对。人审由系统在交接/定稿门禁自动要求，经 Panel「核实」或唤醒选项完成。",
             ].join("\n"), ctx.isIdle() ? {} : { deliverAs: "followUp" });
-            ctx.ui.notify(`已启动过程性 /crosscheck（焦点：${focus}）。人审由收尾门禁自动要求。`, "info");
+            ctx.ui.notify(`已启动过程性 /crosscheck（焦点：${focus}）。大段核对应先征得用户同意。`, "info");
         }
         catch (error) {
             await notifyError(ctx, error);
@@ -1320,11 +1391,11 @@ export default function psyclawExtension(pi) {
         });
     if (!legacyTestApi)
         pi.registerCommand("brainstorm", {
-            description: "研究方向头脑风暴：提出并比较可选问题，不做压力测试",
+            description: "研究方向头脑风暴：提出并比较可选问题",
             handler: async (args, ctx) => {
                 const subject = args.trim();
                 pi.sendUserMessage(academicBrainstormRequest(subject), ctx.isIdle() ? {} : { deliverAs: "followUp" });
-                ctx.ui.notify("已启动研究方向头脑风暴（不经过 /grill）。若要严格压力测试，请另开 /grill。", "info");
+                ctx.ui.notify("已启动研究方向头脑风暴。", "info");
             },
         });
     if (!legacyTestApi)
@@ -2272,6 +2343,7 @@ export default function psyclawExtension(pi) {
                 reason: Type.String({ description: "One-line reason this source is cited at this position (e.g. 支持：社会支持缓冲压力假说)" }),
                 context: Type.String({ description: "The sentence/context in the manuscript where the citation appears" }),
                 section: Type.Optional(Type.String({ description: "Manuscript section, e.g. 1 引言" })),
+                downloadOa: Type.Optional(Type.Boolean({ description: "Set true only after the researcher explicitly approved downloading the open-access PDF" })),
             }),
             executionMode: "sequential",
             async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
@@ -2287,8 +2359,18 @@ export default function psyclawExtension(pi) {
                         reason: params.reason,
                         context: params.context,
                         ...(params.section === undefined || !params.section.trim() ? {} : { section: params.section }),
+                        ...(params.downloadOa === true ? { downloadOa: true } : {}),
                     });
                     const ref = result.reference;
+                    const fulltextNext = result.record.verified && result.fulltext?.status === "downloaded"
+                        ? `引用已双源核验，开放全文已保存到 ${result.fulltext.localPath}。`
+                        : result.fulltext?.status === "approval-required"
+                            ? `引用已双源核验，发现开放全文候选。请先征得用户同意，再以 downloadOa=true 重新调用本工具下载到 ${result.fulltext.localPath}（候选：${result.fulltext.sourceUrl ?? "OA URL"}）。`
+                            : result.fulltext?.status === "manual-download-required"
+                                ? `该引用的题录已登记，但未找到开放 PDF。请通过 ${result.fulltext.doiUrl} 使用你的合法访问权限下载，并保存到 ${result.fulltext.localPath}；完成前不得将依赖全文的主张写入正文。`
+                                : result.fulltext?.status === "download-failed"
+                                    ? `开放全文下载失败：${result.fulltext.reason ?? "未知原因"}。请通过 ${result.fulltext.doiUrl} 自行合法获取并保存到 ${result.fulltext.localPath}。`
+                                    : "该 DOI 或全文未能完成核验；请在最终交付前补核验或替换来源。";
                     return {
                         content: [{ type: "text", text: JSON.stringify({
                                     schemaVersion: "psyclaw/citation-use/v1",
@@ -2299,11 +2381,7 @@ export default function psyclawExtension(pi) {
                                     referenceTitle: ref?.title ?? null,
                                     archived: ref !== null,
                                     fulltext: result.fulltext,
-                                    next: result.record.verified && result.fulltext?.status === "downloaded"
-                                        ? `引用已双源核验，开放全文已保存到 ${result.fulltext.localPath}。`
-                                        : result.fulltext?.status === "manual-download-required"
-                                            ? `该引用的题录已登记，但未找到开放 PDF。请通过 ${result.fulltext.doiUrl} 使用你的合法访问权限下载，并保存到 ${result.fulltext.localPath}；完成前不得将依赖全文的主张写入正文。`
-                                            : "该 DOI 或全文未能完成核验；请在最终交付前补核验或替换来源。",
+                                    next: fulltextNext,
                                 }, null, 2) }],
                         details: { citationId: result.record.citationId, doi: result.record.doi, verified: result.record.verified },
                     };