psyclaw 0.30.4 → 0.30.6

package/README.md

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

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

@@ -16,13 +16,16 @@ 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";
 import { appendChoiceRecord } from "../../research/choice.js";
 import { enabledLocalSkillPaths, enabledLocalPromptPaths, readUserSkillState, scanLocalSkills, setLocalSkillEnabled, setLocalSkillsEnabled, skillNamesInPaths, userSkillId, } from "../../skills/user-skills.js";
 import { RuntimeMcpRegistry, setUserMcpConfigEnabled, } from "../../integrations/mcp-runtime.js";
-import { SecretInputComponent, ProviderPickerComponent, } from "../../tui/provider-picker.js";
+import { SecretInputComponent, TextInputComponent, ProviderPickerComponent, } from "../../tui/provider-picker.js";
+import { resolveProviderBaseUrl } from "../../core/provider-endpoint.js";
 import { isArsPiActive, isArsPiTurn, psyclawArsPatch, setArsPiSessionActive, } from "../../ars/profile.js";
 import { buildArsDoctorReport, ensurePdfEngineForExport } from "../../ars/doctor.js";
 import { formatAcademicSoftRouteInvocation, rankAcademicSoftRoutes, resolveAcademicSoftRoute, } from "../../ars/academic-router.js";
@@ -131,6 +134,48 @@ async function promptProviderKey(ctx, providerName, envName) {
     const result = await ctx.ui.custom((tui, theme, keybindings, done) => new SecretInputComponent(`配置 ${providerName}`, envName, tui, theme, keybindings, done));
     return result.type === "submit" ? result.value.trim() : undefined;
 }
+async function promptProviderText(ctx, title, hint, initial = "") {
+    if (typeof ctx.ui.custom !== "function") {
+        throw new Error(`${title}：当前环境不支持交互输入。请在交互式终端运行 /provider。`);
+    }
+    const result = await ctx.ui.custom((tui, theme, keybindings, done) => new TextInputComponent(title, hint, tui, theme, keybindings, done, initial));
+    return result.type === "submit" ? result.value.trim() : undefined;
+}
+/** Interactive setup for the built-in `custom` OpenAI-compatible provider. */
+async function configureCustomProvider(ctx) {
+    const preset = PROVIDER_PRESETS.find((item) => item.id === "custom");
+    if (!preset)
+        throw new Error("内置 custom Provider 预设缺失");
+    if (!ctx.hasUI || typeof ctx.ui.custom !== "function") {
+        throw new Error("请在交互式终端运行 /provider，选择「自定义 OpenAI 兼容接口」，并填写 Base URL 与模型 ID");
+    }
+    const baseUrlRaw = await promptProviderText(ctx, "自定义 Provider · Base URL", "例如 https://api.example.com/v1（须为 http/https，不含凭据）");
+    if (baseUrlRaw === undefined)
+        return undefined;
+    let baseUrl = "";
+    try {
+        baseUrl = resolveProviderBaseUrl(baseUrlRaw);
+    }
+    catch (error) {
+        throw new Error(error instanceof Error ? error.message : "Base URL 无效");
+    }
+    if (!baseUrl)
+        throw new Error("自定义 Provider 必须填写 Base URL");
+    const modelId = await promptProviderText(ctx, "自定义 Provider · 模型 ID", "填写网关要求的模型名，例如 gpt-4o-mini 或 deepseek-chat");
+    if (modelId === undefined)
+        return undefined;
+    if (!modelId || !/^[A-Za-z0-9][A-Za-z0-9._:/-]{0,255}$/.test(modelId)) {
+        throw new Error("模型 ID 无效；请使用字母数字及 . _ : / -");
+    }
+    const key = await promptProviderKey(ctx, preset.name, preset.apiKeyEnv);
+    if (key === undefined)
+        return undefined;
+    const credential = await providerCredentialSource(preset);
+    if (!key && credential === "missing") {
+        throw new Error(`未找到 ${preset.apiKeyEnv}；请输入 API Key 后再继续`);
+    }
+    return { baseUrl, modelId, ...(key ? { apiKey: key } : {}) };
+}
 function parseModelRef(args) {
     const value = args.trim();
     const slash = value.indexOf("/");
@@ -758,6 +803,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);
@@ -1516,6 +1702,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: "学术模式：单独开启，或附带任务文本启动完整流程",
@@ -1604,7 +1802,7 @@ export default function psyclawExtension(pi) {
         });
     if (!legacyTestApi)
         pi.registerCommand("provider", {
-            description: "查看或切换模型 Provider",
+            description: "查看、配置或切换 Provider（含自定义 OpenAI 兼容接口）",
             handler: async (args, ctx) => {
                 try {
                     let requested = args.trim();
@@ -1616,7 +1814,7 @@ export default function psyclawExtension(pi) {
                     }
                     if (!requested) {
                         const current = ctx.model?.provider ?? "none";
-                        const available = new Map(PROVIDER_PRESETS.filter((preset) => preset.models.length > 0).map((preset) => [preset.id, preset]));
+                        const available = new Map(PROVIDER_PRESETS.filter((preset) => preset.models.length > 0 || preset.id === "custom").map((preset) => [preset.id, preset]));
                         for (const id of providers.keys())
                             if (!available.has(id))
                                 available.set(id, {
@@ -1629,13 +1827,15 @@ export default function psyclawExtension(pi) {
                                 });
                         if (!ctx.hasUI || typeof ctx.ui.custom !== "function") {
                             const lines = [...available].map(([id, preset]) => `${id}${id === current ? " *" : ""} — ${preset.name}`);
-                            ctx.ui.notify([`当前 Provider: ${current}`, ...lines, "", "切换：/provider <id>"].join("\n"), "info");
+                            ctx.ui.notify([`当前 Provider: ${current}`, ...lines, "", "切换：/provider <id>（自定义：/provider custom）"].join("\n"), "info");
                             return;
                         }
                         const selectedProvider = await pickProviderItem(ctx, "选择模型 Provider", [...available].map(([id, preset]) => ({
                             id,
                             label: preset.name,
-                            description: `${id} · ${providers.get(id)?.length ?? preset.models.length} 个模型`,
+                            description: id === "custom"
+                                ? "自建/第三方 OpenAI 兼容网关：填写 Base URL、模型 ID 与 API Key"
+                                : `${id} · ${providers.get(id)?.length ?? preset.models.length} 个模型`,
                             current: id === current,
                         })));
                         if (!selectedProvider)
@@ -1644,6 +1844,35 @@ export default function psyclawExtension(pi) {
                     }
                     if (!/^[A-Za-z0-9._:-]+$/.test(requested))
                         throw new Error("请使用 /provider 打开选择，或 /provider <provider-id>");
+                    if (requested === "custom") {
+                        const custom = await configureCustomProvider(ctx);
+                        if (!custom)
+                            return;
+                        const preset = PROVIDER_PRESETS.find((item) => item.id === "custom");
+                        await saveProviderConfig({
+                            ...preset,
+                            baseUrl: custom.baseUrl,
+                            models: [{ id: custom.modelId, name: custom.modelId }],
+                            ...(custom.apiKey ? { apiKey: custom.apiKey } : {}),
+                        });
+                        const refreshed = await Promise.race([
+                            ctx.modelRegistry.refresh().then(() => true),
+                            new Promise((resolve) => setTimeout(() => resolve(false), 5_000)),
+                        ]);
+                        if (!refreshed) {
+                            ctx.ui.notify("自定义 Provider 已保存；模型目录刷新超时，请重新启动 PsyClaw 后使用。", "warning");
+                            return;
+                        }
+                        const selected = ctx.modelRegistry.getAll().find((model) => model.provider === "custom" && model.id === custom.modelId);
+                        if (!selected)
+                            throw new Error(`自定义模型未出现在目录中：custom/${custom.modelId}；请检查 Base URL 后重试`);
+                        const changed = await pi.setModel(selected);
+                        if (!changed)
+                            throw new Error("未找到 custom 的可用凭据；请重新运行 /provider custom 并输入 API Key");
+                        await saveDefaultModel("custom", selected.id);
+                        ctx.ui.notify(`已切换并设为默认模型：custom/${selected.id}（${custom.baseUrl}）`, "info");
+                        return;
+                    }
                     const preset = PROVIDER_PRESETS.find((item) => item.id === requested);
                     let models = providers.get(requested) ?? [];
                     const modelChoices = models.length > 0 ? models : (preset?.models ?? []);