psyclaw 0.28.1 → 0.28.3

package/README.md

@@ -4,7 +4,7 @@ PsyClaw 是面向社会科学研究的智能体工作台。它把研究项目、
 
 PsyClaw 自有代码使用 MIT 许可证；随 npm 包内置的 Academic Research Skills 位于 `vendor/ars`，保持上游署名并单独遵循 CC BY-NC 4.0，仅限非商业用途。
 
-当前版本：`0.28.1`。正式命令、用户配置目录和后续发布统一使用 `psyclaw`。
+当前版本：`0.28.3`。正式命令、用户配置目录和后续发布统一使用 `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.28.1
+npm install -g psyclaw@0.28.3
 ```
 
 如果本机 npm 配置把 registry 误写成带有 `~/` 的地址，请显式指定官方源：
 
 ```bash
-npm install -g psyclaw@0.28.1 --registry=https://registry.npmjs.org/
+npm install -g psyclaw@0.28.3 --registry=https://registry.npmjs.org/
 ```
 
 中国大陆网络较慢或无法访问官方源时：
 
 ```powershell
-npm install -g psyclaw@0.28.1 --registry=https://registry.npmmirror.com
+npm install -g psyclaw@0.28.3 --registry=https://registry.npmmirror.com
 ```
 
 PsyClaw 的 npm 发布包直接携带 Windows x64/arm64 版 `ripgrep` 和 `fd`，Windows 启动时直接使用包内可执行文件，不再联网下载。其他平台缺少这两个工具时仍由锁定的 Pi 原生工具管理器处理：代理环境走 GitHub 官方 API 与 Release，国内 npm registry 环境统一走国内镜像。
@@ -92,7 +92,7 @@ psyclaw brief
 | 创建项目能力 | `/create-skill`、`/create-hook`、`/create-rule`、`/create-subagent`（均先预览并确认） |
 | 运行自定义只读角色 | `/agents --agent <id> <task>` 或 `/agents --agents <id,...> <task>`（最多四个隔离 worker） |
 | 调用已加载 Skill | `/skill:<name>` |
-| 使用 PsyClaw ARS | `/ars doctor`，然后 `/ars full <task>` 或 `/ars start` |
+| 使用 PsyClaw ARS | `Shift+Tab` 进入 academic mode（底栏显示）；thinking level 改用 `Ctrl+Shift+Tab`；也可用 `/ars doctor` / `/ars full <task>` |
 | 管理 Plugin | `/plugin`；终端使用 `psyclaw plugin install|remove|list` |
 | 调用已配置 MCP | 模型通过 `psyclaw_mcp` 自动发现并调用 `.psyclaw/mcp/*.json` 中启用的服务器 |
 

package/agents/recommended/catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "psyclaw/recommended-agents/v1",
-  "documentVersion": "0.28.1",
+  "documentVersion": "0.28.3",
   "syncedAt": "2026-09-06",
   "sourceDocument": "bundled literature/review subagents",
   "sourceRef": "bundled",

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

@@ -21,6 +21,7 @@ import { enabledLocalSkillPaths, enabledLocalPromptPaths, readUserSkillState, sc
 import { RuntimeMcpRegistry, setUserMcpConfigEnabled, } from "../../integrations/mcp-runtime.js";
 import { SecretInputComponent, ProviderPickerComponent, } from "../../tui/provider-picker.js";
 import { ARS_REPOSITORY_URL, ARS_UPSTREAM_COMMIT, ARS_UPSTREAM_REF, PSYCLAW_ARS_PROFILE_VERSION, detectNatureArsFillers, formatNatureArsFillerStatus, isArsPiActive, isArsPiTurn, psyclawArsPatch, } from "../../ars/profile.js";
+import { ArsModeEditor, ARS_MODE_STATUS, isArsModeEditorText } from "../../ars/mode-editor.js";
 const PARADIGMS = new Set([
     "survey-observational",
     "qualitative-thematic",
@@ -1117,6 +1118,36 @@ export default function psyclawExtension(pi) {
     const developerCommands = process.env.PSYCLAW_DEVELOPER_COMMANDS === "1";
     const legacyTestApi = typeof pi.registerTool !== "function";
     const runtimeMcps = new RuntimeMcpRegistry();
+    let arsModeEditor;
+    let arsUiContext;
+    const applyArsUiMode = (active, opts) => {
+        arsModeEditor?.setConversationMode(active);
+        arsUiContext?.ui.setStatus("ars", active ? ARS_MODE_STATUS : undefined);
+        if (opts?.syncSession === false || !arsUiContext)
+            return;
+        const sessionActive = isArsPiActive(arsUiContext.sessionManager);
+        if (active && !sessionActive) {
+            pi.sendUserMessage("/ars-pi-start", {
+                ...(!arsUiContext.isIdle() ? { deliverAs: "followUp" } : {}),
+                expandPromptTemplates: true,
+            });
+        }
+        else if (!active && sessionActive) {
+            pi.sendUserMessage("/ars-pi-stop", {
+                ...(!arsUiContext.isIdle() ? { deliverAs: "followUp" } : {}),
+                expandPromptTemplates: true,
+            });
+        }
+    };
+    if (!legacyTestApi && typeof pi.registerShortcut === "function") {
+        pi.registerShortcut("shift+tab", {
+            description: "Toggle academic mode",
+            handler: () => {
+                const next = !(arsModeEditor?.isConversationMode() ?? isArsPiActive(arsUiContext?.sessionManager));
+                applyArsUiMode(next);
+            },
+        });
+    }
     if (!legacyTestApi && typeof pi.on === "function")
         pi.on("resources_discover", async (event) => {
             const enabled = await enabledRecommendedSkillPaths(event.cwd);
@@ -1152,6 +1183,27 @@ export default function psyclawExtension(pi) {
                 })}`,
             };
         });
+    if (!legacyTestApi && typeof pi.on === "function")
+        pi.on("session_start", (_event, ctx) => {
+            arsUiContext = ctx;
+            if (!ctx.hasUI || typeof ctx.ui.setEditorComponent !== "function")
+                return;
+            ctx.ui.setEditorComponent((tui, theme, keybindings) => {
+                const editor = new ArsModeEditor(tui, theme, keybindings);
+                arsModeEditor = editor;
+                editor.onArsModeChange = (active) => {
+                    ctx.ui.setStatus("ars", active ? ARS_MODE_STATUS : undefined);
+                };
+                editor.onToggleConversationMode = () => {
+                    applyArsUiMode(!editor.isConversationMode());
+                };
+                const restore = isArsPiActive(ctx.sessionManager);
+                editor.setConversationMode(restore);
+                if (restore)
+                    ctx.ui.setStatus("ars", ARS_MODE_STATUS);
+                return editor;
+            });
+        });
     if (!legacyTestApi && typeof pi.on === "function")
         pi.on("input", (event, ctx) => {
             if (event.source === "extension")
@@ -1161,18 +1213,6 @@ export default function psyclawExtension(pi) {
             ctx.ui.notify("PsyClaw 已统一隐藏底层登录命令。请使用 /provider 配置、切换或更新模型凭据。", "info");
             return { action: "handled" };
         });
-    if (!legacyTestApi && typeof pi.on === "function")
-        pi.on("input", async (event, ctx) => {
-            if (event.source === "extension" || isArsPiActive(ctx.sessionManager))
-                return;
-            if (!/^\/(?:ars-[a-z0-9-]+|skill:(?:deep-research|academic-paper|academic-paper-reviewer|academic-pipeline))(?:\s|$)/i.test(event.text.trim()))
-                return;
-            if (!ctx.hasUI)
-                return { action: "handled" };
-            const approved = await ctx.ui.confirm("启用 ARS？", `来源：${ARS_REPOSITORY_URL} @ ${ARS_UPSTREAM_REF}\n许可：CC BY-NC 4.0，仅限非商业用途。关键研究阶段仍会请求确认。`);
-            if (!approved)
-                return { action: "handled" };
-        });
     if (!legacyTestApi && typeof pi.on === "function")
         pi.on("tool_call", async (event, ctx) => {
             const run = await readControlledRun(ctx.cwd);
@@ -1451,29 +1491,35 @@ export default function psyclawExtension(pi) {
         });
     if (!legacyTestApi)
         pi.registerCommand("ars", {
-            description: "启动或管理 PsyClaw ARS 模式",
+            description: "切换 academic mode，或管理 doctor/start/full/stop",
             handler: async (args, ctx) => {
                 try {
-                    const [action = "status", ...rest] = args.trim().split(/\s+/).filter(Boolean);
+                    const [action, ...rest] = args.trim().split(/\s+/).filter(Boolean);
+                    // Bare /ars → sticky academic mode (same as Shift+Tab on). No profile popup.
+                    if (!action) {
+                        if (!ctx.hasUI) {
+                            ctx.ui.notify("当前环境无编辑器；请改用 Shift+Tab 或 /ars start。", "info");
+                            return;
+                        }
+                        arsUiContext = ctx;
+                        applyArsUiMode(true);
+                        return;
+                    }
                     if (action === "status") {
                         ctx.ui.notify([
                             `PsyClaw ARS profile v${PSYCLAW_ARS_PROFILE_VERSION}`,
-                            "模式：轻量 ARS（不要求 /init 或 /run）",
+                            "模式：academic mode（Shift+Tab 切换；开启后直接对话）",
+                            "Thinking：Ctrl+Shift+Tab（Shift+Tab 已让给 academic mode）",
                             `来源：${ARS_REPOSITORY_URL} @ ${ARS_UPSTREAM_REF} (${ARS_UPSTREAM_COMMIT.slice(0, 12)})`,
-                            "入口：/ars doctor，/ars start，/ars full <task>，/ars stop",
+                            "入口：Shift+Tab，/ars doctor，/ars start，/ars full <task>，/ars stop",
                             formatNatureArsFillerStatus(natureFillersFromCommandContext(ctx)),
                         ].join("\n"), "info");
                         return;
                     }
                     if (action === "install") {
-                        ctx.ui.notify("ARS 可直接使用：运行 /ars start 或 /ars full <task>。", "info");
+                        ctx.ui.notify("ARS 与 Nature/compose 技能已内置：按 Shift+Tab 进入 academic mode。", "info");
                         return;
                     }
-                    if ((action === "start" || action === "full") && !isArsPiActive(ctx.sessionManager)) {
-                        const approved = await ctx.ui.confirm("启用 ARS？", `来源：${ARS_REPOSITORY_URL} @ ${ARS_UPSTREAM_REF}\n许可：CC BY-NC 4.0，仅限非商业用途。关键研究阶段仍会请求确认。`);
-                        if (!approved)
-                            return;
-                    }
                     const upstreamCommand = action === "doctor"
                         ? "/ars-pi-doctor"
                         : action === "start"
@@ -1484,11 +1530,19 @@ export default function psyclawExtension(pi) {
                                     ? `/ars-full${rest.length > 0 ? ` ${rest.join(" ")}` : ""}`
                                     : undefined;
                     if (!upstreamCommand) {
-                        ctx.ui.notify("Usage: /ars [status|doctor|start|full <task>|stop]", "info");
+                        ctx.ui.notify("Usage: /ars [status|doctor|start|full <task>|stop] 或按 Shift+Tab 切换 academic mode", "info");
                         return;
                     }
-                    if (action === "doctor" || action === "full" || action === "start") {
-                        ctx.ui.notify(formatNatureArsFillerStatus(natureFillersFromCommandContext(ctx)), "info");
+                    if (action === "start") {
+                        arsUiContext = ctx;
+                        applyArsUiMode(true, { syncSession: false });
+                    }
+                    if (action === "stop") {
+                        arsUiContext = ctx;
+                        applyArsUiMode(false, { syncSession: false });
+                        if (ctx.hasUI && isArsModeEditorText(ctx.ui.getEditorText?.() ?? "")) {
+                            ctx.ui.setEditorText("");
+                        }
                     }
                     // A queued prompt does not get a fresh system prompt in Pi. Wait so the
                     // upstream wrapper can activate ARS and inject its compatibility note.