psyclaw 0.28.1 → 0.28.2

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.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.28.1
+npm install -g psyclaw@0.28.2
 ```
 
 如果本机 npm 配置把 registry 误写成带有 `~/` 的地址，请显式指定官方源：
 
 ```bash
-npm install -g psyclaw@0.28.1 --registry=https://registry.npmjs.org/
+npm install -g psyclaw@0.28.2 --registry=https://registry.npmjs.org/
 ```
 
 中国大陆网络较慢或无法访问官方源时：
 
 ```powershell
-npm install -g psyclaw@0.28.1 --registry=https://registry.npmmirror.com
+npm install -g psyclaw@0.28.2 --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 | 输入 `ars` 后按 Tab（或 `ars: <task>`）；也可用 `/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.2",
   "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, enterArsModeEditorText, isArsModeEditorText } from "../../ars/mode-editor.js";
 const PARADIGMS = new Set([
     "survey-observational",
     "qualitative-thematic",
@@ -1152,6 +1153,18 @@ export default function psyclawExtension(pi) {
                 })}`,
             };
         });
+    if (!legacyTestApi && typeof pi.on === "function")
+        pi.on("session_start", (_event, ctx) => {
+            if (!ctx.hasUI || typeof ctx.ui.setEditorComponent !== "function")
+                return;
+            ctx.ui.setEditorComponent((tui, theme, keybindings) => {
+                const editor = new ArsModeEditor(tui, theme, keybindings);
+                editor.onArsModeChange = (active) => {
+                    ctx.ui.setStatus("ars", active ? "ARS" : undefined);
+                };
+                return editor;
+            });
+        });
     if (!legacyTestApi && typeof pi.on === "function")
         pi.on("input", (event, ctx) => {
             if (event.source === "extension")
@@ -1165,7 +1178,10 @@ export default function psyclawExtension(pi) {
         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()))
+            const text = event.text.trim();
+            const entersArs = isArsModeEditorText(text)
+                || /^\/(?:ars-[a-z0-9-]+|skill:(?:deep-research|academic-paper|academic-paper-reviewer|academic-pipeline))(?:\s|$)/i.test(text);
+            if (!entersArs)
                 return;
             if (!ctx.hasUI)
                 return { action: "handled" };
@@ -1451,22 +1467,37 @@ export default function psyclawExtension(pi) {
         });
     if (!legacyTestApi)
         pi.registerCommand("ars", {
-            description: "启动或管理 PsyClaw ARS 模式",
+            description: "进入 ARS 对话模式，或管理 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 → conversation mode (ars: + tint). No profile popup.
+                    if (!action) {
+                        if (!ctx.hasUI) {
+                            ctx.ui.notify("当前环境无编辑器；请改用 /ars start 或发送 ars: <任务>。", "info");
+                            return;
+                        }
+                        if (!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;
+                        }
+                        ctx.ui.setEditorText(enterArsModeEditorText(ctx.ui.getEditorText?.() ?? ""));
+                        ctx.ui.setStatus("ars", "ARS");
+                        return;
+                    }
                     if (action === "status") {
                         ctx.ui.notify([
                             `PsyClaw ARS profile v${PSYCLAW_ARS_PROFILE_VERSION}`,
-                            "模式：轻量 ARS（不要求 /init 或 /run）",
+                            "模式：轻量 ARS（输入 ars 后按 Tab，或以 ars: 前缀对话）",
                             `来源：${ARS_REPOSITORY_URL} @ ${ARS_UPSTREAM_REF} (${ARS_UPSTREAM_COMMIT.slice(0, 12)})`,
-                            "入口：/ars doctor，/ars start，/ars full <task>，/ars stop",
+                            "入口：ars: <task>，/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 技能已内置：输入 ars 后按 Tab，或以 /ars start、/ars full <task> 使用。", "info");
                         return;
                     }
                     if ((action === "start" || action === "full") && !isArsPiActive(ctx.sessionManager)) {
@@ -1484,11 +1515,14 @@ 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] 或直接输入 ars 后按 Tab", "info");
                         return;
                     }
-                    if (action === "doctor" || action === "full" || action === "start") {
-                        ctx.ui.notify(formatNatureArsFillerStatus(natureFillersFromCommandContext(ctx)), "info");
+                    if (action === "stop") {
+                        ctx.ui.setStatus("ars", undefined);
+                        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.