psyclaw 0.29.12 → 0.29.13

package/README.md

@@ -4,7 +4,7 @@ PsyClaw 是面向社会科学研究的智能体工作台。它把研究项目、
 
 PsyClaw 自有代码使用 MIT 许可证；随 npm 包内置的 Academic Research Skills 位于 `vendor/ars`，保持上游署名并单独遵循 CC BY-NC 4.0，仅限非商业用途。
 
-当前版本：`0.29.12`。正式命令、用户配置目录和后续发布统一使用 `psyclaw`。
+当前版本：`0.29.13`。正式命令、用户配置目录和后续发布统一使用 `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.29.12
+npm install -g psyclaw@0.29.13
 ```
 
 如果本机 npm 配置把 registry 误写成带有 `~/` 的地址，请显式指定官方源：
 
 ```bash
-npm install -g psyclaw@0.29.12 --registry=https://registry.npmjs.org/
+npm install -g psyclaw@0.29.13 --registry=https://registry.npmjs.org/
 ```
 
 中国大陆网络较慢或无法访问官方源时：
 
 ```powershell
-npm install -g psyclaw@0.29.12 --registry=https://registry.npmmirror.com
+npm install -g psyclaw@0.29.13 --registry=https://registry.npmmirror.com
 ```
 
 或安装脚本：

package/dist/apps/panel/index.html

@@ -337,23 +337,41 @@
     .help-grid {
       display: grid;
       grid-template-columns: repeat(3, minmax(0, 1fr));
-      gap: 12px;
-      margin-bottom: 22px;
+      gap: 14px;
+      margin-bottom: 28px;
     }
     .help-mode-card {
+      position: relative;
       border: 1px solid var(--border-subtle);
-      background: var(--bg-surface);
-      border-radius: var(--radius-md);
-      padding: 14px 16px;
-      box-shadow: var(--shadow-xs);
+      background: linear-gradient(165deg, #ffffff 0%, var(--brand-primary-light) 140%);
+      border-radius: 14px;
+      padding: 18px 18px 16px;
+      overflow: hidden;
+    }
+    .help-mode-card::before {
+      content: "";
+      position: absolute;
+      left: 0;
+      top: 0;
+      bottom: 0;
+      width: 3px;
+      background: var(--brand-primary);
     }
     .help-mode-card .mode-id {
       font-family: var(--font-mono);
-      font-size: 11px;
-      color: var(--accent);
-      letter-spacing: 0.04em;
+      font-size: 10px;
+      font-weight: 600;
+      color: var(--brand-primary);
+      letter-spacing: 0.08em;
       text-transform: uppercase;
-      margin-bottom: 6px;
+      margin-bottom: 8px;
+    }
+    .help-mode-card .mode-label {
+      font-size: 16px;
+      font-weight: 650;
+      color: var(--text-main);
+      letter-spacing: -0.02em;
+      margin: 0 0 8px;
     }
     .help-mode-card p {
       margin: 0;
@@ -361,56 +379,164 @@
       line-height: 1.55;
       color: var(--text-secondary);
     }
-    .help-block {
+    .help-hero {
+      display: flex;
+      align-items: flex-end;
+      justify-content: space-between;
+      gap: 16px;
       margin-bottom: 22px;
+      padding: 20px 22px;
+      border-radius: 16px;
+      border: 1px solid var(--brand-primary-border);
+      background:
+        radial-gradient(120% 80% at 100% 0%, rgba(13, 118, 110, 0.10), transparent 55%),
+        linear-gradient(180deg, #ffffff, #f8fafc);
     }
-    .help-block h2 {
-      margin: 0 0 10px;
-      font-size: 14px;
-      font-weight: 650;
+    .help-hero h1 {
+      margin: 0 0 6px;
+      font-size: 22px;
+      font-weight: 700;
+      letter-spacing: -0.03em;
       color: var(--text-main);
     }
+    .help-hero p {
+      margin: 0;
+      color: var(--text-muted);
+      font-size: 13px;
+      max-width: 42rem;
+      line-height: 1.5;
+    }
+    .help-kbd {
+      display: inline-flex;
+      align-items: center;
+      gap: 6px;
+      padding: 6px 10px;
+      border-radius: 999px;
+      border: 1px solid var(--border-subtle);
+      background: var(--bg-surface);
+      color: var(--text-secondary);
+      font-size: 11px;
+      font-family: var(--font-mono);
+      white-space: nowrap;
+    }
+    .help-block {
+      margin-bottom: 26px;
+    }
+    .help-block h2 {
+      margin: 0 0 12px;
+      font-size: 13px;
+      font-weight: 700;
+      letter-spacing: 0.04em;
+      text-transform: uppercase;
+      color: var(--text-muted);
+    }
     .help-steps {
       margin: 0;
-      padding-left: 1.2rem;
+      padding: 0;
+      list-style: none;
+      display: grid;
+      gap: 8px;
+    }
+    .help-steps li {
+      display: grid;
+      grid-template-columns: 28px 1fr;
+      gap: 12px;
+      align-items: start;
+      padding: 12px 14px;
+      border-radius: 12px;
+      border: 1px solid var(--border-subtle);
+      background: var(--bg-surface);
       color: var(--text-secondary);
       font-size: 13px;
-      line-height: 1.7;
+      line-height: 1.55;
+    }
+    .help-steps li::before {
+      content: attr(data-step);
+      width: 28px;
+      height: 28px;
+      border-radius: 9px;
+      display: grid;
+      place-items: center;
+      background: var(--brand-primary-light);
+      color: var(--brand-primary);
+      font-family: var(--font-mono);
+      font-size: 12px;
+      font-weight: 700;
     }
     .help-commands {
+      display: grid;
+      gap: 18px;
+    }
+    .help-cmd-group h3 {
+      margin: 0 0 8px;
+      font-size: 12px;
+      font-weight: 650;
+      color: var(--text-muted);
+      letter-spacing: 0.02em;
+    }
+    .help-cmd-list {
       display: grid;
       grid-template-columns: repeat(2, minmax(0, 1fr));
       gap: 8px;
     }
     .help-cmd {
-      display: flex;
-      gap: 10px;
-      align-items: baseline;
+      display: grid;
+      grid-template-columns: minmax(7.5rem, auto) 1fr;
+      gap: 12px;
+      align-items: center;
       border: 1px solid var(--border-subtle);
-      border-radius: var(--radius-sm);
-      padding: 10px 12px;
-      background: var(--bg-surface-subtle);
+      border-radius: 12px;
+      padding: 11px 13px;
+      background: var(--bg-surface);
+      transition: border-color 120ms ease, background 120ms ease;
+    }
+    .help-cmd:hover {
+      border-color: var(--brand-primary-border);
+      background: var(--brand-primary-light);
     }
     .help-cmd code {
       font-family: var(--font-mono);
       font-size: 12px;
-      color: var(--text-main);
+      font-weight: 600;
+      color: var(--brand-primary);
       white-space: nowrap;
     }
     .help-cmd span {
       font-size: 12.5px;
-      color: var(--text-muted);
-      line-height: 1.45;
+      color: var(--text-secondary);
+      line-height: 1.4;
     }
     .help-notes {
       margin: 0;
-      padding-left: 1.2rem;
+      padding: 14px 16px;
+      list-style: none;
+      display: grid;
+      gap: 8px;
+      border-radius: 14px;
+      border: 1px solid var(--border-subtle);
+      background: var(--bg-surface-subtle);
+    }
+    .help-notes li {
+      position: relative;
+      padding-left: 14px;
       color: var(--text-muted);
       font-size: 12.5px;
-      line-height: 1.65;
+      line-height: 1.55;
+    }
+    .help-notes li::before {
+      content: "";
+      position: absolute;
+      left: 0;
+      top: 0.55em;
+      width: 6px;
+      height: 6px;
+      border-radius: 50%;
+      background: var(--brand-primary);
+      opacity: 0.55;
     }
     @media (max-width: 960px) {
-      .help-grid, .help-commands { grid-template-columns: 1fr; }
+      .help-grid, .help-cmd-list { grid-template-columns: 1fr; }
+      .help-hero { flex-direction: column; align-items: flex-start; }
     }
 
     .button {
@@ -1561,9 +1687,9 @@
           <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="3" width="18" height="18" rx="2"/><path d="M3 9h18M9 21V9"/></svg>
           /plan 方案
         </button>
-        <button id="cmd-verify-btn" class="topbar-btn" title="关键字段人机核查清单 (/verify)">
+        <button id="cmd-verify-btn" class="topbar-btn" title="AI 核查清单；人审在此核实 (/crosscheck)">
           <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M22 11.08V12a10 10 0 1 1-5.93-9.14"/><polyline points="22 4 12 14.01 9 11.01"/></svg>
-          /verify 核查
+          /crosscheck
         </button>
       </div>
       <div class="local-badge">
@@ -1809,11 +1935,12 @@
       </section>
 
       <section id="view-help" class="view">
-        <div class="page-head">
+        <div class="help-hero">
           <div>
             <h1 id="help-title">使用速览</h1>
-            <p id="help-thinking">加载中…</p>
+            <p id="help-subtitle">三种模式 · AI 交叉核验 · 内置学术工作流</p>
           </div>
+          <div id="help-thinking" class="help-kbd">加载中…</div>
         </div>
         <div class="help-grid" id="help-modes"></div>
         <div class="help-block">
@@ -1821,7 +1948,7 @@
           <ol id="help-steps" class="help-steps"></ol>
         </div>
         <div class="help-block">
-          <h2>可用命令</h2>
+          <h2>常用命令</h2>
           <div id="help-commands" class="help-commands"></div>
         </div>
         <div class="help-block">
@@ -1834,11 +1961,11 @@
         <div class="page-head">
           <div>
             <h1>交叉核验清单</h1>
-            <p>分析前/后由模型提出项，人在此勾选。可跳过，但会标注「未经核对」。本地写入 <code>.psyclaw/verify-checklist.json</code>。</p>
+            <p>AI 用 <code>/crosscheck</code> 核查字段；<strong>analysis / academic 收尾必须在此点「核实」</strong>（或终端 <code>/crosscheck &lt;id&gt; human</code>）。AI 已核与跳过都不算通过。</p>
           </div>
           <div style="display:flex;gap:8px">
             <button id="refresh-checklist" class="button">刷新</button>
-            <button id="skip-checklist" class="button" title="其余未核项标为跳过/未经核对">跳过未核项</button>
+            <button id="skip-checklist" class="button" title="标为跳过；不解除 analysis/academic 人审门禁">跳过未核项</button>
           </div>
         </div>
         <div class="panel section">
@@ -1881,7 +2008,7 @@
             <div id="console-log" class="console-log">
               <div class="log-entry sys">
                 <div class="log-sys">
-                  💡 <strong>对话已就绪</strong>：与 PsyClaw 智能体及底层学术插件安全连接。支持 <code>/init</code>、<code>/plan</code>、<code>/grill</code>、<code>/verify</code> 等研究指令；随时探讨研究设想或分析数据。
+                  💡 <strong>对话已就绪</strong>：与 PsyClaw 智能体安全连接。支持 <code>/init</code>、<code>/plan</code>、<code>/grill</code>、<code>/crosscheck</code>（AI 核验）等指令。
                 </div>
               </div>
             </div>
@@ -1891,9 +2018,9 @@
                 <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="3" y="3" width="18" height="18" rx="2"/><path d="M3 9h18M9 21V9"/></svg>
                 /plan status
               </span>
-              <span class="chip" data-cmd="/verify list">
+              <span class="chip" data-cmd="/crosscheck list">
                 <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M9 11l3 3L22 4"/></svg>
-                /verify list
+                /crosscheck list
               </span>
               <span class="chip" data-cmd="/grill">
                 <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="10"/><path d="M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3"/></svg>
@@ -2035,16 +2162,31 @@ async function loadHelp() {
   try {
     const doc = await json("/api/help");
     $("help-title").textContent = doc.title || "使用速览";
+    $("help-subtitle").textContent = doc.subtitle || "";
     $("help-thinking").textContent = doc.thinking || "";
     $("help-modes").innerHTML = (doc.modes || []).map(mode => `
       <article class="help-mode-card">
-        <div class="mode-id">${esc(mode.label || mode.id)}</div>
+        <div class="mode-id">${esc(mode.hint || mode.id)}</div>
+        <div class="mode-label">${esc(mode.label || mode.id)}</div>
         <p>${esc(mode.blurb)}</p>
       </article>
     `).join("");
-    $("help-steps").innerHTML = (doc.steps || []).map(step => `<li>${esc(step)}</li>`).join("");
-    $("help-commands").innerHTML = (doc.commands || []).map(row => `
-      <div class="help-cmd"><code>${esc(row.cmd)}</code><span>${esc(row.blurb)}</span></div>
+    $("help-steps").innerHTML = (doc.steps || []).map((step, index) =>
+      `<li data-step="${index + 1}">${esc(step)}</li>`
+    ).join("");
+    const groups = new Map();
+    for (const row of (doc.commands || [])) {
+      const key = row.group || "其他";
+      if (!groups.has(key)) groups.set(key, []);
+      groups.get(key).push(row);
+    }
+    $("help-commands").innerHTML = [...groups.entries()].map(([group, rows]) => `
+      <div class="help-cmd-group">
+        <h3>${esc(group)}</h3>
+        <div class="help-cmd-list">
+          ${rows.map(row => `<div class="help-cmd"><code>${esc(row.cmd)}</code><span>${esc(row.blurb)}</span></div>`).join("")}
+        </div>
+      </div>
     `).join("");
     $("help-notes").innerHTML = (doc.notes || []).map(note => `<li>${esc(note)}</li>`).join("");
   } catch (error) {
@@ -2091,7 +2233,7 @@ async function loadChecklist() {
 
 $("refresh-checklist")?.addEventListener("click", loadChecklist);
 $("skip-checklist")?.addEventListener("click", async () => {
-  if (!confirm("将把所有未核项标为跳过，并写入「未经核对」。继续？")) return;
+  if (!confirm("将把未核/AI已核项标为跳过。注意：这不会解除 analysis/academic 收尾人审门禁。继续？")) return;
   await json("/api/crosscheck", {
     method: "POST",
     headers: { "content-type": "application/json" },

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

@@ -33,7 +33,7 @@ import { arsRoot } from "../../ars/pi-panel-executor.js";
 import { ArsModeEditor, isArsModeEditorText } from "../../ars/mode-editor.js";
 import { MODE_STATUS, nextSessionMode, parseSessionMode, sessionModePrompt, } from "../../session/modes.js";
 import { continuouslyWorkWarningText, isContinuouslyWorkEnabled, } from "../../session/continuously-work.js";
-import { formatVerifyChecklist, isNaturalPlanConfirm, loadVerifyChecklist, markVerifyItem, skipUnverifiedItems } from "../../verify/checklist.js";
+import { assertHumanVerifyGate, formatVerifyChecklist, isNaturalPlanConfirm, loadVerifyChecklist, markVerifyItem, skipUnverifiedItems } from "../../verify/checklist.js";
 import { formatSessionHelp, formatSessionHelpBrief } from "../../session/help.js";
 import { openResearchWorkbench } from "../../panel/workbench.js";
 const PARADIGMS = new Set([
@@ -1291,40 +1291,48 @@ export default function psyclawExtension(pi) {
                 return;
             }
             if (parts[0] === "skip") {
-                ctx.ui.notify(formatVerifyChecklist(await skipUnverifiedItems(ctx.cwd)), "warning");
+                ctx.ui.notify(`${formatVerifyChecklist(await skipUnverifiedItems(ctx.cwd))}\n注意：skip 不解除 analysis/academic 人审硬门禁。`, "warning");
                 return;
             }
             if (parts[0] === "kind") {
                 const kind = (parts[1] ?? "general");
                 pi.sendUserMessage([
-                    "交叉核验任务：请作为助手主动提出核对项，不要等用户自己去「申请确认」。",
+                    "交叉核验任务：请作为助手主动提出核对项并执行字段核查，不要等用户自己去「申请确认」。",
                     `核验类别：${kind}（citations=引文，format=格式，requirements=研究要求，stats=统计结果，general=综合）。`,
-                    "输出可勾选清单，并建议用户打开 /panel 核对页逐项确认；若用户跳过，必须在产物中标注「未经核对」。",
+                    "核查完成后用 /crosscheck <id> verified 记为 AI 已核（ai-checked），不得自称已过人审。",
+                    "analysis / academic 模式下，全文或分析收尾前必须请人在 Panel「核实」或 /crosscheck <id> human；跳过不算通过。",
                     "分析前与分析后都要有清单，不能默认跳过。",
                 ].join("\n"), ctx.isIdle() ? {} : { deliverAs: "followUp" });
-                ctx.ui.notify(`已启动 ${kind} 交叉核验；也可 /panel 打开核对清单。`, "info");
+                ctx.ui.notify(`已启动 ${kind} 交叉核验；人审请打开 /panel → 核对清单。`, "info");
                 return;
             }
             const id = parts[0];
-            const status = (parts[1] ?? "verified");
-            if (status !== "verified" && status !== "unverified" && status !== "flagged" && status !== "skipped") {
-                ctx.ui.notify("Usage: /crosscheck list | skip | kind <citations|format|requirements|stats> | <id> verified|unverified|flagged|skipped [备注]", "info");
+            const statusRaw = (parts[1] ?? "verified").toLowerCase();
+            const allowed = new Set(["verified", "ai-checked", "unverified", "flagged", "skipped", "human"]);
+            if (!allowed.has(statusRaw)) {
+                ctx.ui.notify("Usage: /crosscheck list | skip | kind <citations|format|requirements|stats> | <id> verified|ai-checked|human|unverified|flagged|skipped [备注]", "info");
                 return;
             }
             const notes = parts.slice(2).join(" ") || undefined;
-            const checklist = await markVerifyItem(ctx.cwd, id, status, notes);
-            ctx.ui.notify(formatVerifyChecklist(checklist), "info");
+            const source = statusRaw === "human" ? "human" : "ai";
+            const checklist = await markVerifyItem(ctx.cwd, id, statusRaw, notes, undefined, { source });
+            const tip = statusRaw === "human" || (statusRaw === "verified" && source === "human")
+                ? "已记为人审通过。"
+                : statusRaw === "verified" || statusRaw === "ai-checked"
+                    ? "已记为 AI 已核；analysis/academic 收尾前仍须人在 Panel 点「核实」或 /crosscheck <id> human。"
+                    : undefined;
+            ctx.ui.notify(tip ? `${formatVerifyChecklist(checklist)}\n${tip}` : formatVerifyChecklist(checklist), "info");
         }
         catch (error) {
             await notifyError(ctx, error);
         }
     };
     pi.registerCommand("crosscheck", {
-        description: "交叉核验：/crosscheck list|skip|kind <类型>|<id> verified|…",
+        description: "AI 交叉核验 + 人审：/crosscheck list|skip|kind|<id> verified|human|…",
         handler: async (args, ctx) => handleCrosscheck(args, ctx),
     });
     pi.registerCommand("verify", {
-        description: "交叉核验（同 /crosscheck）：模型提出项，人勾选或 skip 标注未经核对",
+        description: "同 /crosscheck；AI 核查后 analysis/academic 须人审",
         handler: async (args, ctx) => handleCrosscheck(args, ctx),
     });
     pi.registerCommand("help", {
@@ -1436,6 +1444,11 @@ export default function psyclawExtension(pi) {
                     return;
                 }
                 if (cmd === "handoff") {
+                    const gate = await assertHumanVerifyGate(ctx.cwd, "analysis-complete");
+                    if (!gate.ok) {
+                        ctx.ui.notify(gate.message, "error");
+                        return;
+                    }
                     const path = await syncHandoffFromAnalysisPlan(ctx.cwd, plan);
                     if (plan.status === "running") {
                         plan = advanceAnalysisPlan(plan, plan.scriptEntrypoint
@@ -1494,6 +1507,19 @@ export default function psyclawExtension(pi) {
                 ctx.ui.notify("已启动学术追问。完成后会先展示文档更新建议，并询问是否写回。", "info");
             },
         });
+    if (!legacyTestApi)
+        pi.registerCommand("brainstorm", {
+            description: "显式启动研究方向头脑风暴（逐题澄清）",
+            handler: async (args, ctx) => {
+                const subject = args.trim();
+                pi.sendUserMessage([
+                    "使用 academic-grill Skill 的头脑风暴入口，先提出 2-4 个有理论意义、可回答的研究方向，比较价值、可行性与边界并推荐一个。",
+                    "随后按研究者需要逐题澄清，每轮只问一个实质问题，同时给出推荐答案和主要取舍；不要直接替用户执行完整研究或写论文。",
+                    subject ? `本次头脑风暴主题：${subject}` : "请根据当前对话和项目材料确定头脑风暴主题；已有信息不要重复询问。",
+                ].join("\n"), ctx.isIdle() ? {} : { deliverAs: "followUp" });
+                ctx.ui.notify("已启动研究方向头脑风暴。完成后可用 /grill 继续严格压力测试。", "info");
+            },
+        });
     if (!legacyTestApi)
         pi.registerCommand("review", {
             description: "并发运行多角色模拟同行评审",
@@ -2215,11 +2241,11 @@ export default function psyclawExtension(pi) {
             executionMode: "sequential",
             async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
                 try {
-                    // Soft gate: missing /init or verify does not hard-block results.
+                    // Soft gate for missing /init only. Analysis/academic completion still requires human verify.
                     const project = await readActiveProject(ctx.cwd);
                     const softNote = project
                         ? undefined
-                        : "尚未 /init（软门禁）：继续执行；关键字段请 AI 核查并由人 /verify。建议先 /init 建仓。";
+                        : "尚未 /init（软门禁）：继续执行；收尾前须 AI /crosscheck 后人审。建议先 /init 建仓。";
                     const request = params.request.trim();
                     const combined = `${request} ${params.identifier ?? ""}`;
                     const explicitWorkflow = params.workflow?.trim();
@@ -2252,6 +2278,13 @@ export default function psyclawExtension(pi) {
                     }
                     if (publishIntent) {
                         try {
+                            const gate = await assertHumanVerifyGate(ctx.cwd, "academic-finalize");
+                            if (!gate.ok) {
+                                return {
+                                    content: [{ type: "text", text: gate.message }],
+                                    details: { workflow: "publish-manuscript", blocked: true, reason: "human-verify-gate" },
+                                };
+                            }
                             const result = await exportAcademicDocument(ctx.cwd);
                             return {
                                 content: [{ type: "text", text: JSON.stringify({