psyclaw 0.30.5 → 0.30.7

package/README.md

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

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

@@ -16,6 +16,8 @@ import { dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { coreSkillNames, enabledRecommendedSkillPaths, normalizeRecommendedSkillId, readRecommendationState, readRecommendedCatalog, recommendedSkillTarget, saveRecommendationState, validateModelInstalledRecommendedSkill, } from "../../skills/recommended.js";
 import { SkillManagerComponent } from "../../tui/skill-manager.js";
+import { BiosignalWizardComponent } from "../../tui/biosignal-wizard.js";
+import { readBiosignalPackCatalog, resolveBiosignalInstallPlan, } from "../../skills/biosignal-pack.js";
 import { WakeOptionsComponent } from "../../tui/wake-options.js";
 import { applyWakeVerifySync, buildWakePrompt, createWakeVerifyChecklist, formatWakeResult, labelsFor, waitForPanelWakeAnswer, } from "../../wake-options/runtime.js";
 import { panelHub } from "../../panel/hub.js";
@@ -36,7 +38,37 @@ import { continuouslyWorkWarningText, isContinuouslyWorkEnabled, } from "../../s
 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, trackSkillInstall, withAgentSpan, writeTelemetryPreference, } from "../../observability/index.js";
+import { captureAgentError, extractPiGeneration, finishAgentSpan, initNodeObservability, lastPiGeneration, readTelemetryPreference, shutdownObservability, startAgentSpan, trackGateWaiting, trackLlmGeneration, trackSkillInstall, withAgentSpan, writeTelemetryPreference, } from "../../observability/index.js";
+function ctxProviderModel(ctx) {
+    const provider = typeof ctx.model?.provider === "string" ? ctx.model.provider : undefined;
+    const model = typeof ctx.model?.id === "string" ? ctx.model.id : undefined;
+    return {
+        ...(provider === undefined ? {} : { provider }),
+        ...(model === undefined ? {} : { model }),
+    };
+}
+function piTurnSpanAttributes(extras = {}) {
+    return {
+        phase: "pi_turn",
+        ...(extras.provider ? { provider: extras.provider.slice(0, 80) } : {}),
+        ...(extras.model ? { model: extras.model.slice(0, 120) } : {}),
+    };
+}
+async function emitPiTurnGeneration(generation, extras) {
+    if (!generation)
+        return false;
+    const provider = generation.provider ?? extras.provider;
+    const model = generation.model ?? extras.model;
+    await trackLlmGeneration({
+        ...generation,
+        ...(provider === undefined ? {} : { provider }),
+        ...(model === undefined ? {} : { model }),
+        ...(extras.latencyMs === undefined ? {} : { latencyMs: extras.latencyMs }),
+        surface: "cli",
+        spanName: "pi-turn",
+    });
+    return true;
+}
 /** Codex-style slash surface: bare command, or command + trailing free text. No subcommand trees. */
 function parseInitArgs(args) {
     const goal = args.trim();
@@ -801,6 +833,147 @@ async function queueModelSkillInstall(pi, ctx, row) {
         ctx.ui.notify(`已将 ${row.name} 的安装任务交给当前模型（默认启用），目标为${skillScopeLabel(scope)}。完成后请执行 /reload。`, "info");
     });
 }
+function modelBiosignalPackInstallTask(root, plan, skillRows, mcpRows, mcpPlans, skillScope) {
+    const skillLines = plan.skillIds.map((id) => {
+        const row = skillRows.find((candidate) => candidate.id === id);
+        const target = recommendedSkillTarget(root, id, skillScope);
+        return [
+            `- Skill ${row?.name ?? id} (${id})`,
+            `  来源：${row?.sourceRef ?? "未提供"}`,
+            ...(row?.installHint ? [`  入口提示：${row.installHint}`] : []),
+            `  目标目录：${target}`,
+            row?.collection
+                ? "  形态：多 Skill 套件（子目录含 SKILL.md）"
+                : "  形态：叶子 Skill（目标目录直接含 SKILL.md）",
+        ].join("\n");
+    });
+    const mcpLines = plan.mcpIds.map((id) => {
+        const row = mcpRows.find((candidate) => candidate.id === id);
+        const prep = mcpPlans.find((candidate) => candidate.id === id);
+        return [
+            `- MCP ${row?.name ?? id} (${id})`,
+            `  来源：${row?.sourceRef ?? "未提供"}`,
+            `  参考命令：${typeof prep?.command === "string" ? prep.command : "请阅读来源仓库安装说明"}`,
+            `  建议配置：${typeof prep?.target === "string" ? prep.target : `.psyclaw/mcp/${id}.json`}`,
+        ].join("\n");
+    });
+    return [
+        "安装并配置「生理信号分析」能力包。",
+        `研究域：${plan.domainNames.join("、")}（${plan.domainIds.join(", ")}）`,
+        `当前项目：${root}`,
+        `Skill 安装位置：${skillScopeLabel(skillScope)}。`,
+        "用户已通过 /biosignal 向导明确授权本次打包安装。你可以直接联网、克隆或下载来源、使用所需包管理器安装依赖、执行安装命令，并写入与清单有关的项目或用户级配置；不要再次要求用户批准这些安装步骤。",
+        "不要写入 data/raw、.git、凭据或符号链接目标。不要把模型口头声称当作完成证据；每个条目安装后检查目标目录或 MCP 配置是否存在。",
+        "",
+        "MCP 清单：",
+        ...(mcpLines.length > 0 ? mcpLines : ["（无）"]),
+        "",
+        "Skill 清单：",
+        ...(skillLines.length > 0 ? skillLines : ["（无）"]),
+        "",
+        "目录中的版本、命令和依赖只作参考；请先阅读各来源仓库的实际安装说明再落地。各项已在推荐状态中默认启用；全部完成后执行 /reload，并提醒用户：Shift+Tab 切到 analysis，用自然语言描述数据与分析目标即可开始。",
+        "若某一条目安装命令本身失败，直接诊断并修复；只有遇到必须由用户提供的凭据或外部软件许可证时才向用户说明。",
+    ].join("\n");
+}
+async function markBiosignalPackDesired(root, plan, skillScope) {
+    const state = await readRecommendationState(root);
+    const skills = new Set(state.skills);
+    const mcp = new Set(state.mcp);
+    const skillScopes = { ...(state.skillScopes ?? {}) };
+    for (const id of plan.skillIds) {
+        const normalized = normalizeRecommendedSkillId(id);
+        skills.add(normalized);
+        skillScopes[normalized] = skillScope;
+    }
+    for (const id of plan.mcpIds)
+        mcp.add(id);
+    state.skills = [...skills];
+    state.mcp = [...mcp];
+    state.skillScopes = skillScopes;
+    await saveRecommendationState(root, state);
+}
+async function queueBiosignalPackInstall(pi, ctx, plan, runtime) {
+    if (plan.mcpIds.length === 0 && plan.skillIds.length === 0) {
+        ctx.ui.notify("所选研究域没有需要安装的 MCP 或 Skill。", "info");
+        return;
+    }
+    const skillScope = plan.skillIds.length > 0 ? await chooseSkillScope(ctx) : "project";
+    if (plan.skillIds.length > 0 && !skillScope)
+        return;
+    const scope = skillScope ?? "project";
+    const skillCatalog = await readRecommendedCatalog();
+    const mcpCatalog = await recommendedItems("mcp");
+    const missingSkills = plan.skillIds.filter((id) => {
+        const item = skillCatalog.items.find((candidate) => normalizeRecommendedSkillId(String(candidate.id ?? "")) === normalizeRecommendedSkillId(id));
+        return !item || typeof item.sourceRef !== "string" || !/^https:\/\//.test(item.sourceRef);
+    });
+    if (missingSkills.length > 0) {
+        throw new Error(`能力包 Skill 缺少可安装来源：${missingSkills.join(", ")}`);
+    }
+    const skillRows = plan.skillIds.map((id) => {
+        const item = skillCatalog.items.find((candidate) => normalizeRecommendedSkillId(String(candidate.id ?? "")) === normalizeRecommendedSkillId(id));
+        return {
+            id: normalizeRecommendedSkillId(id),
+            name: String(item.name ?? id),
+            description: String(item.description ?? ""),
+            sourceRef: String(item.sourceRef),
+            ...(typeof item.installHint === "string" ? { installHint: item.installHint } : {}),
+            collection: item.skillLayout === "collection",
+            installed: false,
+            enabled: true,
+            scope,
+            blocked: false,
+            source: "recommended",
+        };
+    });
+    const mcpRows = await mcpManagerRows(ctx.cwd, await readRecommendationState(ctx.cwd), runtime);
+    const selectedMcp = plan.mcpIds.map((id) => {
+        const row = mcpRows.find((candidate) => candidate.id === id);
+        if (!row?.sourceRef)
+            throw new Error(`能力包 MCP 缺少来源网址：${id}`);
+        return row;
+    });
+    const summary = [
+        `研究域：${plan.domainNames.join("、")}`,
+        plan.mcpIds.length > 0 ? `MCP：${plan.mcpIds.join(", ")}` : "MCP：无",
+        plan.skillIds.length > 0 ? `Skill：${plan.skillIds.join(", ")}` : "Skill：无",
+        plan.skillIds.length > 0 ? `Skill 安装位置：${skillScopeLabel(scope)}` : "",
+    ].filter(Boolean).join("\n");
+    const approved = await ctx.ui.confirm("交给当前模型安装生理信号能力包？", `${summary}\n\n模型将按现有 /mcp 与 /skill 约定完成下载与配置；安装后默认启用。`);
+    if (!approved)
+        return;
+    await markBiosignalPackDesired(ctx.cwd, plan, scope);
+    pi.sendUserMessage(modelBiosignalPackInstallTask(ctx.cwd, plan, skillRows, selectedMcp, mcpCatalog.installPrep, scope), ctx.isIdle() ? {} : { deliverAs: "followUp" });
+    ctx.ui.notify("已将生理信号能力包安装任务交给当前模型。完成后请执行 /reload，并 Shift+Tab 切到 analysis 使用。", "info");
+}
+async function showBiosignalPack(pi, ctx, runtime) {
+    const catalog = await readBiosignalPackCatalog();
+    if (!ctx.hasUI || typeof ctx.ui.custom !== "function") {
+        const lines = [
+            "生理信号分析能力包（无交互 UI 时仅列出研究域）：",
+            ...catalog.domains.map((domain) => `- ${domain.id}: ${domain.name} — ${domain.description}`),
+            "请在交互式终端运行 /biosignal 完成选型与安装。",
+        ];
+        ctx.ui.notify(lines.join("\n"), "info");
+        return;
+    }
+    const result = await ctx.ui.custom((tui, theme, keybindings, done) => (new BiosignalWizardComponent(catalog.domains.map((domain) => ({
+        id: domain.id,
+        name: domain.name,
+        description: domain.description,
+    })), (domainIds) => {
+        const plan = resolveBiosignalInstallPlan(catalog, domainIds);
+        return {
+            domainNames: plan.domainNames,
+            mcpIds: plan.mcpIds,
+            skillIds: plan.skillIds,
+        };
+    }, tui, theme, keybindings, done)));
+    if (result.type === "close")
+        return;
+    const plan = resolveBiosignalInstallPlan(catalog, result.domainIds);
+    await queueBiosignalPackInstall(pi, ctx, plan, runtime);
+}
 async function showSkillManager(pi, ctx) {
     if (!ctx.hasUI || typeof ctx.ui.custom !== "function") {
         const state = await readRecommendationState(ctx.cwd);
@@ -976,6 +1149,9 @@ export default function psyclawExtension(pi) {
     let arsModeEditor;
     let arsUiContext;
     let sessionMode = "chat";
+    let turnStartedAt;
+    let llmTurnSpan;
+    let capturedTurnGeneration = false;
     const applySessionMode = (mode, opts) => {
         sessionMode = mode;
         arsModeEditor?.setMode(mode);
@@ -1020,9 +1196,55 @@ export default function psyclawExtension(pi) {
         });
     if (!legacyTestApi && typeof pi.on === "function")
         pi.on("session_shutdown", () => {
+            finishAgentSpan(llmTurnSpan);
+            llmTurnSpan = undefined;
             runtimeMcps.close();
             void shutdownObservability();
         });
+    if (!legacyTestApi && typeof pi.on === "function")
+        pi.on("agent_start", () => {
+            capturedTurnGeneration = false;
+        });
+    if (!legacyTestApi && typeof pi.on === "function")
+        pi.on("turn_start", async (event, ctx) => {
+            finishAgentSpan(llmTurnSpan);
+            turnStartedAt = typeof event.timestamp === "number" && Number.isFinite(event.timestamp)
+                ? event.timestamp
+                : Date.now();
+            llmTurnSpan = await startAgentSpan("cli.llm_call", piTurnSpanAttributes(ctxProviderModel(ctx)));
+        });
+    if (!legacyTestApi && typeof pi.on === "function")
+        pi.on("turn_end", async (event, ctx) => {
+            const fallback = ctxProviderModel(ctx);
+            const generation = extractPiGeneration({ type: "message", message: event.message });
+            const latencyMs = turnStartedAt === undefined ? undefined : Math.max(0, Date.now() - turnStartedAt);
+            const provider = generation?.provider ?? fallback.provider;
+            const model = generation?.model ?? fallback.model;
+            finishAgentSpan(llmTurnSpan, piTurnSpanAttributes({
+                ...(provider === undefined ? {} : { provider }),
+                ...(model === undefined ? {} : { model }),
+            }));
+            llmTurnSpan = undefined;
+            if (await emitPiTurnGeneration(generation, { ...fallback, ...(latencyMs === undefined ? {} : { latencyMs }) })) {
+                capturedTurnGeneration = true;
+                turnStartedAt = undefined;
+            }
+        });
+    if (!legacyTestApi && typeof pi.on === "function")
+        pi.on("agent_end", async (event, ctx) => {
+            const fallback = ctxProviderModel(ctx);
+            finishAgentSpan(llmTurnSpan, piTurnSpanAttributes(fallback));
+            llmTurnSpan = undefined;
+            const latencyMs = turnStartedAt === undefined ? undefined : Math.max(0, Date.now() - turnStartedAt);
+            turnStartedAt = undefined;
+            if (capturedTurnGeneration) {
+                capturedTurnGeneration = false;
+                return;
+            }
+            capturedTurnGeneration = false;
+            const generation = lastPiGeneration([event]);
+            await emitPiTurnGeneration(generation, { ...fallback, ...(latencyMs === undefined ? {} : { latencyMs }) });
+        });
     if (!legacyTestApi && typeof pi.on === "function")
         pi.on("before_agent_start", async (event, ctx) => {
             if (!(await readActiveProject(ctx?.cwd ?? process.cwd())))
@@ -1559,6 +1781,18 @@ export default function psyclawExtension(pi) {
                 }
             },
         });
+    if (!legacyTestApi)
+        pi.registerCommand("biosignal", {
+            description: "生理信号分析能力包：选型研究域并安装 MCP/Skill",
+            handler: async (_args, ctx) => {
+                try {
+                    await showBiosignalPack(pi, ctx, runtimeMcps);
+                }
+                catch (error) {
+                    await notifyError(ctx, error);
+                }
+            },
+        });
     if (!legacyTestApi)
         pi.registerCommand("ars", {
             description: "学术模式：单独开启，或附带任务文本启动完整流程",