psyclaw 0.28.0 → 0.28.1

package/README.md

@@ -4,7 +4,7 @@ PsyClaw 是面向社会科学研究的智能体工作台。它把研究项目、
 
 PsyClaw 自有代码使用 MIT 许可证；随 npm 包内置的 Academic Research Skills 位于 `vendor/ars`，保持上游署名并单独遵循 CC BY-NC 4.0，仅限非商业用途。
 
-当前版本：`0.28.0`。正式命令、用户配置目录和后续发布统一使用 `psyclaw`。
+当前版本：`0.28.1`。正式命令、用户配置目录和后续发布统一使用 `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.0
+npm install -g psyclaw@0.28.1
 ```
 
 如果本机 npm 配置把 registry 误写成带有 `~/` 的地址，请显式指定官方源：
 
 ```bash
-npm install -g psyclaw@0.28.0 --registry=https://registry.npmjs.org/
+npm install -g psyclaw@0.28.1 --registry=https://registry.npmjs.org/
 ```
 
 中国大陆网络较慢或无法访问官方源时：
 
 ```powershell
-npm install -g psyclaw@0.28.0 --registry=https://registry.npmmirror.com
+npm install -g psyclaw@0.28.1 --registry=https://registry.npmmirror.com
 ```
 
 PsyClaw 的 npm 发布包直接携带 Windows x64/arm64 版 `ripgrep` 和 `fd`，Windows 启动时直接使用包内可执行文件，不再联网下载。其他平台缺少这两个工具时仍由锁定的 Pi 原生工具管理器处理：代理环境走 GitHub 官方 API 与 Release，国内 npm registry 环境统一走国内镜像。

package/agents/recommended/catalog.json

@@ -0,0 +1,99 @@
+{
+  "schemaVersion": "psyclaw/recommended-agents/v1",
+  "documentVersion": "0.28.1",
+  "syncedAt": "2026-09-06",
+  "sourceDocument": "bundled literature/review subagents",
+  "sourceRef": "bundled",
+  "repositoryHint": "对齐 Claude Code：Subagent = md 提示合订本。外仓可后续以 GitHub 源加入 installPrep；当前内置 8 个无需安装。",
+  "items": [
+    {
+      "id": "landscape-mapper",
+      "name": "研究版图分析者",
+      "kind": "agent",
+      "pack": "literature",
+      "role": "researcher",
+      "stage": "文献多智能体",
+      "description": "梳理研究主题、年代分布、代表性论文和研究方向。",
+      "sourceRef": "bundled",
+      "bundled": true
+    },
+    {
+      "id": "methods-scout",
+      "name": "方法学分析者",
+      "kind": "agent",
+      "pack": "literature",
+      "role": "analyst",
+      "stage": "文献多智能体",
+      "description": "识别研究设计、测量与分析线索，区分元数据可判断与不可判断之处。",
+      "sourceRef": "bundled",
+      "bundled": true
+    },
+    {
+      "id": "evidence-critic",
+      "name": "证据批判者",
+      "kind": "agent",
+      "pack": "literature",
+      "role": "critic",
+      "stage": "文献多智能体",
+      "description": "检查证据强弱、偏倚、冲突与因果边界。",
+      "sourceRef": "bundled",
+      "bundled": true
+    },
+    {
+      "id": "gap-finder",
+      "name": "研究缺口分析者",
+      "kind": "agent",
+      "pack": "literature",
+      "role": "verifier",
+      "stage": "文献多智能体",
+      "description": "寻找尚未充分覆盖的问题、对象、情境和方法。",
+      "sourceRef": "bundled",
+      "bundled": true
+    },
+    {
+      "id": "theory-reviewer",
+      "name": "理论与贡献审稿人",
+      "kind": "agent",
+      "pack": "review",
+      "role": "critic",
+      "stage": "同行评审多智能体",
+      "description": "检查问题重要性、理论定位、创新性与主张—证据一致性。",
+      "sourceRef": "bundled",
+      "bundled": true
+    },
+    {
+      "id": "methods-reviewer",
+      "name": "研究设计审稿人",
+      "kind": "agent",
+      "pack": "review",
+      "role": "analyst",
+      "stage": "同行评审多智能体",
+      "description": "检查抽样、设计、测量、效度与因果推断边界。",
+      "sourceRef": "bundled",
+      "bundled": true
+    },
+    {
+      "id": "statistics-reviewer",
+      "name": "统计与可复现性审稿人",
+      "kind": "agent",
+      "pack": "review",
+      "role": "verifier",
+      "stage": "同行评审多智能体",
+      "description": "检查分析策略、效应量、置信区间与可复现信息（不重算统计）。",
+      "sourceRef": "bundled",
+      "bundled": true
+    },
+    {
+      "id": "ethics-editorial-reviewer",
+      "name": "伦理与编辑审稿人",
+      "kind": "agent",
+      "pack": "review",
+      "role": "writer",
+      "stage": "同行评审多智能体",
+      "description": "检查伦理、透明报告、引用表达与可读性。",
+      "sourceRef": "bundled",
+      "bundled": true
+    }
+  ],
+  "installPrep": []
+}

package/dist/apps/panel/index.html

@@ -17,7 +17,7 @@
   <div class="layout">
     <nav class="nav" aria-label="Panel 导航">
       <button class="active" data-view="project">项目文件</button>
-      <button data-view="ecosystem">Skill / Plugin / MCP</button>
+      <button data-view="ecosystem">Skill / Plugin / MCP / Agent</button>
       <button data-view="provider">Provider 与成本</button>
     </nav>
     <main class="main">
@@ -33,8 +33,8 @@
       </section>
 
       <section id="view-ecosystem" class="view">
-        <div class="page-head"><div><h1>Skill / Plugin / MCP 生态</h1><p>在同一页面管理研究 Skill、Pi Plugin 与 MCP。配置变更后使用 <code>/reload</code>。</p></div><button id="refresh-ecosystem" class="button">刷新</button></div>
-        <div class="controls" style="margin-bottom:12px"><input id="eco-search" placeholder="搜索名称或描述"><div class="segmented" aria-label="能力类型"><button class="active" data-eco-kind="all">全部</button><button data-eco-kind="skill">Skill</button><button data-eco-kind="plugin">Plugin</button><button data-eco-kind="mcp">MCP</button></div><select id="eco-kind" aria-label="更多类型"><option value="all">全部来源</option><option value="local">用户 Skill</option><option value="external">外部工具</option></select><select id="eco-status"><option value="all">全部状态</option><option value="enabled">已启用</option><option value="available">未启用</option></select></div>
+        <div class="page-head"><div><h1>Skill / Plugin / MCP / Agent 生态</h1><p>在同一页面管理研究 Skill、Pi Plugin、MCP 与 Subagent（对齐 Claude Code）。配置变更后使用 <code>/reload</code>。</p></div><button id="refresh-ecosystem" class="button">刷新</button></div>
+        <div class="controls" style="margin-bottom:12px"><input id="eco-search" placeholder="搜索名称或描述"><div class="segmented" aria-label="能力类型"><button class="active" data-eco-kind="all">全部</button><button data-eco-kind="skill">Skill</button><button data-eco-kind="plugin">Plugin</button><button data-eco-kind="mcp">MCP</button><button data-eco-kind="agent">Agent</button></div><select id="eco-kind" aria-label="更多类型"><option value="all">全部来源</option><option value="local">用户 Skill</option><option value="external">外部工具</option></select><select id="eco-status"><option value="all">全部状态</option><option value="enabled">已启用</option><option value="available">未启用</option></select></div>
         <div class="table-wrap"><table class="data"><thead><tr><th>名称</th><th>类型</th><th>来源</th><th>状态</th><th>操作</th></tr></thead><tbody id="ecosystem-body"><tr><td colspan="5">读取中...</td></tr></tbody></table></div>
       </section>
 
@@ -65,8 +65,8 @@ function selectTree(button){document.querySelectorAll(".tree-item").forEach(item
 async function openFile(path,button){selectTree(button);$("viewer-path").textContent=path;$("viewer-kind").textContent="读取中";$("viewer-body").className="viewer-body empty";$("viewer-body").textContent="读取中...";try{const file=await json(`/api/project-file?path=${encodeURIComponent(path)}`);$("viewer-kind").textContent=file.format;$("viewer-body").className="viewer-body";$("viewer-body").innerHTML=file.format==="markdown"?`<article class="markdown">${renderMarkdown(file.content)}</article>`:`<pre class="raw">${esc(file.format==="json"?JSON.stringify(JSON.parse(file.content),null,2):file.content)}</pre>`}catch(error){$("viewer-body").className="viewer-body empty";$("viewer-body").textContent=error.message}}
 async function loadProject(){const files=await json("/api/project-files");state.files=files.files||[];renderTree();const goal=document.querySelector('[data-file="notes/goal.md"]')||document.querySelector("[data-file]");if(goal)goal.click()}
 
-async function loadEcosystem(){try{const[skills,plugins,mcps,enabled]=await Promise.all([json("/api/recommended-skills"),json("/api/recommended-plugins"),json("/api/recommended-mcps"),json("/api/enabled-capabilities")]);const skillSet=new Set((enabled.skills||[]).map(item=>item.id)),mcpSet=new Set((enabled.mcp||[]).map(item=>item.id));state.eco=[...(enabled.coreSkills||[]).map(item=>({...item,kind:"core",description:item.description||"PsyClaw 内置 Skill",sourceRef:"bundled",enabled:item.enabled,installed:true})),...(skills.items||[]).map(item=>({...item,kind:"skill",enabled:skillSet.has(item.id),installed:skillSet.has(item.id)})),...(plugins.items||[]).map(item=>({...item,kind:"plugin",enabled:Boolean(item.enabled),installed:Boolean(item.installed)})),...(enabled.localSkills||[]).map(item=>({...item,kind:"local",sourceRef:item.path||"用户目录",installed:true})),...(mcps.items||[]).map(item=>({...item,kind:"mcp",enabled:mcpSet.has(item.id),installed:mcpSet.has(item.id)})),...(skills.externalTools||[]).map(item=>({...item,kind:"external",enabled:false,installed:false}))];renderEcosystem()}catch(error){$("ecosystem-body").innerHTML=`<tr><td colspan="5">${esc(error.message)}</td></tr>`}}
-function renderEcosystem(){const query=$("eco-search").value.trim().toLowerCase(),sourceKind=$("eco-kind").value,status=$("eco-status").value,primaryKind=state.ecoKind;const primaryMatches=item=>primaryKind==="all"||(primaryKind==="skill"?(item.kind==="skill"||item.kind==="core"||item.kind==="local"):item.kind===primaryKind);const items=state.eco.filter(item=>primaryMatches(item)&&(sourceKind==="all"||item.kind===sourceKind)&&(status==="all"||(status==="enabled"?item.enabled:!item.enabled))&&`${item.name} ${item.description||""}`.toLowerCase().includes(query));$("ecosystem-body").innerHTML=items.map(item=>`<tr><td><div class="name">${esc(item.name)}</div><div class="subtle">${esc(item.description||"")}${item.kind==="plugin"&&item.scope?` · ${item.scope==="project"?"当前项目":"所有项目"}${item.filtered?" · 已限定资源范围":""}`:""}</div></td><td>${esc(item.kind==="core"?"Core Skill":item.kind==="local"?"用户 Skill":item.kind.toUpperCase())}</td><td>${/^https?:/.test(item.sourceRef||"")?`<a href="${esc(item.sourceRef)}" target="_blank" rel="noreferrer">来源</a>`:esc(item.sourceRef||"bundled")}</td><td><span class="tag ${item.enabled?"ok":item.configured?"warn":""}">${item.locked?"可用":item.enabled?(item.kind==="plugin"?"已安装":"已启用"):item.kind==="plugin"&&item.configured?"配置存在，文件缺失":item.kind==="external"?"可安装外部工具":"未启用"}</span></td><td>${item.locked?"—":item.kind==="plugin"&&item.local?"—":item.kind==="plugin"?`<button class="button small ${item.installed?"":"primary"}" onclick="installCapability('plugin','${esc(item.id)}')">${item.installed?"重新安装":"安装"}</button>`:item.kind==="external"?`<button class="button small primary" onclick="installCapability('external','${esc(item.id)}')">安装</button>`:item.enabled?`<button class="button small" onclick="toggleCapability('${item.kind}','${esc(item.id)}',false)">停用</button>`:item.kind==="local"?`<button class="button small primary" onclick="toggleCapability('local','${esc(item.id)}',true)">启用</button>`:`<button class="button small primary" onclick="installCapability('${item.kind}','${esc(item.id)}')">${item.kind==="core"?"启用":"安装"}</button>`}</td></tr>`).join("")||'<tr><td colspan="5">没有匹配项</td></tr>'}
+async function loadEcosystem(){try{const[skills,plugins,mcps,agents,enabled]=await Promise.all([json("/api/recommended-skills"),json("/api/recommended-plugins"),json("/api/recommended-mcps"),json("/api/recommended-agents"),json("/api/enabled-capabilities")]);const skillSet=new Set((enabled.skills||[]).map(item=>item.id)),mcpSet=new Set((enabled.mcp||[]).map(item=>item.id));state.eco=[...(enabled.coreSkills||[]).map(item=>({...item,kind:"core",description:item.description||"PsyClaw 内置 Skill",sourceRef:"bundled",enabled:item.enabled,installed:true})),...(skills.items||[]).map(item=>({...item,kind:"skill",enabled:skillSet.has(item.id),installed:skillSet.has(item.id)})),...(plugins.items||[]).map(item=>({...item,kind:"plugin",enabled:Boolean(item.enabled),installed:Boolean(item.installed)})),...(enabled.localSkills||[]).map(item=>({...item,kind:"local",sourceRef:item.path||"用户目录",installed:true})),...(mcps.items||[]).map(item=>({...item,kind:"mcp",enabled:mcpSet.has(item.id),installed:mcpSet.has(item.id)})),...(agents.items||[]).map(item=>({...item,kind:"agent",enabled:Boolean(item.enabled),installed:Boolean(item.installed),locked:Boolean(item.locked)})),...(skills.externalTools||[]).map(item=>({...item,kind:"external",enabled:false,installed:false}))];renderEcosystem()}catch(error){$("ecosystem-body").innerHTML=`<tr><td colspan="5">${esc(error.message)}</td></tr>`}}
+function renderEcosystem(){const query=$("eco-search").value.trim().toLowerCase(),sourceKind=$("eco-kind").value,status=$("eco-status").value,primaryKind=state.ecoKind;const primaryMatches=item=>primaryKind==="all"||(primaryKind==="skill"?(item.kind==="skill"||item.kind==="core"||item.kind==="local"):item.kind===primaryKind);const items=state.eco.filter(item=>primaryMatches(item)&&(sourceKind==="all"||item.kind===sourceKind)&&(status==="all"||(status==="enabled"?item.enabled:!item.enabled))&&`${item.name} ${item.description||""}`.toLowerCase().includes(query));$("ecosystem-body").innerHTML=items.map(item=>`<tr><td><div class="name">${esc(item.name)}</div><div class="subtle">${esc(item.description||"")}${item.kind==="plugin"&&item.scope?` · ${item.scope==="project"?"当前项目":"所有项目"}${item.filtered?" · 已限定资源范围":""}`:""}${item.kind==="agent"&&item.slashCommand?` · ${esc(item.slashCommand)}`:""}</div></td><td>${esc(item.kind==="core"?"Core Skill":item.kind==="local"?"用户 Skill":item.kind==="agent"?"Agent":item.kind.toUpperCase())}</td><td>${/^https?:/.test(item.sourceRef||"")?`<a href="${esc(item.sourceRef)}" target="_blank" rel="noreferrer">来源</a>`:esc(item.sourceRef||"bundled")}</td><td><span class="tag ${item.enabled?"ok":item.configured?"warn":""}">${item.locked?"内置可用":item.enabled?(item.kind==="plugin"?"已安装":"已启用"):item.kind==="plugin"&&item.configured?"配置存在，文件缺失":item.kind==="external"?"可安装外部工具":"未启用"}</span></td><td>${item.locked||item.kind==="agent"?"—":item.kind==="plugin"&&item.local?"—":item.kind==="plugin"?`<button class="button small ${item.installed?"":"primary"}" onclick="installCapability('plugin','${esc(item.id)}')">${item.installed?"重新安装":"安装"}</button>`:item.kind==="external"?`<button class="button small primary" onclick="installCapability('external','${esc(item.id)}')">安装</button>`:item.enabled?`<button class="button small" onclick="toggleCapability('${item.kind}','${esc(item.id)}',false)">停用</button>`:item.kind==="local"?`<button class="button small primary" onclick="toggleCapability('local','${esc(item.id)}',true)">启用</button>`:`<button class="button small primary" onclick="installCapability('${item.kind}','${esc(item.id)}')">${item.kind==="core"?"启用":"安装"}</button>`}</td></tr>`).join("")||'<tr><td colspan="5">没有匹配项</td></tr>'}
 async function toggleCapability(kind,id,enabled){await json("/api/recommendation-state",{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({kind:kind==="core"?"core-skill":kind==="skill"?"skills":kind==="local"?"local-skill":kind,id,enabled})});await loadEcosystem()}
 async function installCapability(kind,id){if(kind==="core"){await toggleCapability(kind,id,true);return}const scope=kind==="skill"||kind==="plugin"?(confirm("安装到系统目录？\n确定：所有项目使用；取消：仅当前项目使用。")?"user":"project"):undefined;if(!confirm(`确认安装 ${id}？${kind==="external"?"模型将按官方来源安装并验证。":"安装完成后需要 /reload。"}`))return;const result=await json("/api/install/execute",{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({kind,id,scope,approved:true,actor:"researcher"})});alert(result.message||(result.ok?"安装任务已处理。":"安装未完成"));await loadEcosystem()}
 [$("eco-search"),$("eco-kind"),$("eco-status")].forEach(control=>control.addEventListener("input",renderEcosystem));

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

@@ -2,7 +2,9 @@ import { DefaultPackageManager, getAgentDir, SettingsManager } from "@earendil-w
 import { Type } from "typebox";
 import { appendApproval, approvalInputDigest, asProject, assertResearchDecision, bootstrapProject, projectPaths, readApprovals, resolveResearchDecision, runOfflineBrief, runInstitutionalFulltext, runLiteratureReview, runExpertReview, runAnalysisDelegation, runWritingReview, runMetaAnalysis, createStageRunner, exportAcademicDocument, recordCitationUse, runParallelPeerReview, writeHandoff } from "../../index.js";
 import { runPlanWithPi } from "../../orchestration/pi-executor.js";
-import { customPersonaPlan, loadCustomPersonas, parseAgentsRequest } from "../../orchestration/personas.js";
+import { customPersonaPlan, parseAgentsRequest } from "../../orchestration/personas.js";
+import { elevatedEffects, formatEffects, hasElevatedEffects, normalizeEffects, toolsForEffects } from "../../orchestration/effects.js";
+import { agentManagerRows, loadSelectablePersonas } from "../../agents/recommended-personas.js";
 import { atomicWriteFile } from "../../project/jsonl.js";
 import { applyCreation, previewCreation, runArsMultiAgentBridge } from "../../index.js";
 import { loadUserRules, userRulesPrompt } from "../../rules/user-rules.js";
@@ -643,6 +645,46 @@ async function openPluginManager(ctx, rows) {
         missingMessage: "按 Enter 安装到当前项目。",
     })));
 }
+function agentManagerItems(rows) {
+    return rows.map((row) => ({
+        id: row.id,
+        name: row.name,
+        description: row.description,
+        status: row.status,
+        sourceRef: row.sourceRef,
+        details: [
+            `类别：${row.stage}`,
+            `角色：${row.role}`,
+            `来源：${row.source === "bundled" ? "内置 Subagent（类似 Claude Explore/Plan）" : "项目 .psyclaw/agents/custom"}`,
+            `运行：/agents --agent ${row.id} <只读研究任务>`,
+        ],
+    }));
+}
+async function openAgentManager(ctx, rows) {
+    return ctx.ui.custom((tui, theme, keybindings, done) => (new SkillManagerComponent(agentManagerItems(rows), tui, theme, keybindings, done, {
+        title: "Subagent（对齐 Claude Code）",
+        itemLabel: "Subagent",
+        footer: "↑/↓ 移动 · Enter 查看用法 · Esc 关闭 · 运行: /agents --agent <id> <任务>",
+        enterAction: "details",
+        toggleEnabled: false,
+        enabledText: "已可选用",
+        lockedMessage: "内置 Subagent 始终可用。运行：/agents --agent <id> <只读研究任务>",
+    })));
+}
+async function showAgentManager(ctx, statusOnly = false) {
+    const rows = await agentManagerRows(ctx.cwd);
+    if (!ctx.hasUI || typeof ctx.ui.custom !== "function" || statusOnly) {
+        ctx.ui.notify(rows.map((row) => `${row.status === "core" ? "◆" : "●"} ${row.id} — ${row.name}（${row.stage}）`).join("\n")
+            || "暂无 Subagent。可用 /create-subagent 创建（类似 Claude Code）。", "info");
+        return;
+    }
+    while (true) {
+        const action = await openAgentManager(ctx, await agentManagerRows(ctx.cwd));
+        if (action.type === "close")
+            return;
+        // Enter/Space only show inline notices; keep the manager open.
+    }
+}
 async function installRecommendedPlugin(ctx, row) {
     if (!row.installable)
         throw new Error(row.reason ?? `${row.name} 尚未提供可安装的 Plugin package`);
@@ -1848,7 +1890,7 @@ export default function psyclawExtension(pi) {
         pi.registerTool({
             name: "psyclaw_create",
             label: "Create project capability",
-            description: "Preview and, after an explicit UI confirmation, create one PsyClaw-native project Skill, declarative analysis Hook, additive Rule, or read-only Subagent persona.",
+            description: "Preview and, after an explicit UI confirmation, create one PsyClaw-native project Skill, declarative analysis Hook, additive Rule, or Subagent (Claude-style). Elevated subagent effects require confirmation at create and again at each /agents run.",
             parameters: Type.Object({
                 kind: Type.Union([Type.Literal("skill"), Type.Literal("hook"), Type.Literal("rule"), Type.Literal("subagent")]),
                 id: Type.String({ minLength: 1, maxLength: 64 }),
@@ -1859,6 +1901,12 @@ export default function psyclawExtension(pi) {
                 pattern: Type.Optional(Type.String({ maxLength: 500 })),
                 pathPrefix: Type.Optional(Type.String({ maxLength: 200 })),
                 role: Type.Optional(Type.Union([Type.Literal("planner"), Type.Literal("researcher"), Type.Literal("analyst"), Type.Literal("critic"), Type.Literal("writer"), Type.Literal("verifier")])),
+                allowedEffects: Type.Optional(Type.Array(Type.Union([
+                    Type.Literal("read"),
+                    Type.Literal("write"),
+                    Type.Literal("network"),
+                    Type.Literal("destructive"),
+                ]), { maxItems: 4 })),
             }),
             executionMode: "sequential",
             async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
@@ -1870,7 +1918,15 @@ export default function psyclawExtension(pi) {
                     if (!ctx.hasUI || typeof ctx.ui?.confirm !== "function") {
                         return { content: [{ type: "text", text: JSON.stringify({ ...preview, status: "preview-only", reason: "interactive confirmation unavailable" }, null, 2) }], details: preview };
                     }
-                    const approved = await ctx.ui.confirm(`创建 ${params.kind} “${preview.id}”？`, `目标：${preview.path}\nSHA-256：${preview.sha256}\n\n${preview.contents}`);
+                    const effects = request.kind === "subagent" ? normalizeEffects(request.allowedEffects) : ["read"];
+                    const elevated = request.kind === "subagent" && hasElevatedEffects(effects);
+                    const title = elevated
+                        ? `创建 Subagent “${preview.id}”（含提升权限）？`
+                        : `创建 ${params.kind} “${preview.id}”？`;
+                    const body = elevated
+                        ? `目标：${preview.path}\n声明 effects：${formatEffects(effects)}\n将开放工具：${toolsForEffects(effects).join(", ")}\nSHA-256：${preview.sha256}\n\n每次 /agents 运行仍会再次确认。凭据读取与绕过门禁仍被禁止。\n\n${preview.contents}`
+                        : `目标：${preview.path}\nSHA-256：${preview.sha256}\n\n${preview.contents}`;
+                    const approved = await ctx.ui.confirm(title, body);
                     if (!approved)
                         return { content: [{ type: "text", text: "Creation cancelled; no file was written." }], details: { status: "cancelled", preview } };
                     const result = await applyCreation(ctx.cwd, request, preview.sha256, true);
@@ -2121,12 +2177,22 @@ export default function psyclawExtension(pi) {
     // runner behind PSYCLAW_DEVELOPER_COMMANDS in published builds.
     if (!legacyTestApi)
         pi.registerCommand("agents", {
-            description: "运行经批准的只读研究 Agent",
+            description: "浏览或运行 Subagent（对齐 Claude Code）",
             handler: async (args, ctx) => {
+                const trimmed = args.trim();
+                if (!trimmed || trimmed === "status" || trimmed === "list") {
+                    try {
+                        await showAgentManager(ctx, trimmed === "status" || trimmed === "list");
+                    }
+                    catch (error) {
+                        await notifyError(ctx, error);
+                    }
+                    return;
+                }
                 const requested = parseAgentsRequest(args);
                 const objective = requested.objective;
                 if (!objective) {
-                    ctx.ui.notify("Usage: /agents [--agent <id>|--agents <id,...>] <bounded read-only research task>", "info");
+                    ctx.ui.notify("Usage: /agents [--agent <id>|--agents <id,...>] <task>\n无任务时直接运行 /agents 打开 Subagent 管理页。", "info");
                     return;
                 }
                 if (objective.length > 4_000) {
@@ -2151,13 +2217,60 @@ export default function psyclawExtension(pi) {
                     const runId = `pi_agent_${Date.now()}`;
                     let plan = researchTaskPlan(runId, objective);
                     if (requested.ids.length > 0) {
-                        const available = await loadCustomPersonas(ctx.cwd);
+                        const available = await loadSelectablePersonas(ctx.cwd);
                         const byId = new Map(available.map((persona) => [persona.id, persona]));
                         const selected = requested.ids.map((id) => byId.get(id));
                         const missing = requested.ids.filter((_id, index) => !selected[index]);
                         if (missing.length > 0)
-                            throw new Error(`Unknown or invalid custom subagent: ${missing.join(", ")}`);
-                        plan = customPersonaPlan(runId, objective, selected.filter((persona) => persona !== undefined));
+                            throw new Error(`Unknown or invalid subagent: ${missing.join(", ")}. Run /agents to list bundled and custom subagents.`);
+                        const personas = selected.filter((persona) => persona !== undefined);
+                        const unionEffects = normalizeEffects(personas.flatMap((persona) => persona.allowedEffects));
+                        const elevated = elevatedEffects(unionEffects);
+                        if (elevated.length > 0) {
+                            if (!ctx.hasUI || typeof ctx.ui.confirm !== "function") {
+                                throw new Error(`Subagent effects [${formatEffects(elevated)}] require interactive confirmation`);
+                            }
+                            const approved = await ctx.ui.confirm("批准 Subagent 提升权限？", `将启用：${formatEffects(elevated)}\n对应工具：${toolsForEffects(unionEffects).join(", ")}\n任务：${objective.slice(0, 400)}\n\n凭据读取、绕过门禁与外部发布仍被禁止。`);
+                            if (!approved) {
+                                ctx.ui.notify("已取消：未批准提升权限，未启动 Subagent。", "warning");
+                                return;
+                            }
+                        }
+                        plan = customPersonaPlan(runId, objective, personas);
+                        await mkdir(join(ctx.cwd, ".psyclaw", "plans"), { recursive: true });
+                        await atomicWriteFile(join(ctx.cwd, ".psyclaw", "plans", `${runId}.json`), `${JSON.stringify(plan, null, 2)}\n`);
+                        const eventLog = new RunEventLog(ctx.cwd, runId);
+                        const result = await runPlanWithPi(plan, {
+                            cwd: ctx.cwd,
+                            agentDir: join(ctx.cwd, ".psyclaw", "pi-agent"),
+                            ...(ctx.model?.provider === undefined ? {} : { provider: ctx.model.provider }),
+                            ...(ctx.model?.id === undefined ? {} : { model: ctx.model.id }),
+                            env: providerEnvironment(ctx.model?.provider),
+                            ...(elevated.length === 0 ? { tools: [] } : {}),
+                            allowWrites: unionEffects.includes("write"),
+                            allowNetwork: unionEffects.includes("network"),
+                            allowDestructive: unionEffects.includes("destructive"),
+                            root: ctx.cwd,
+                            pauseRequested: async () => {
+                                try {
+                                    await import("node:fs/promises").then(({ access }) => access(join(ctx.cwd, ".psyclaw", "runs", `${runId}.pause`)));
+                                    return true;
+                                }
+                                catch {
+                                    return false;
+                                }
+                            },
+                            onEvent: async (event) => { await eventLog.append(event); },
+                        });
+                        pi.appendEntry("psyclaw:agent-run", {
+                            runId,
+                            status: result.status,
+                            diagnostics: result.diagnostics,
+                            effects: unionEffects,
+                            recordedAt: new Date().toISOString(),
+                        });
+                        ctx.ui.notify(`Agent run ${result.status}: ${result.diagnostics.join("; ") || "verified"}`, result.status === "completed" ? "info" : "warning");
+                        return;
                     }
                     await mkdir(join(ctx.cwd, ".psyclaw", "plans"), { recursive: true });
                     await atomicWriteFile(join(ctx.cwd, ".psyclaw", "plans", `${runId}.json`), `${JSON.stringify(plan, null, 2)}\n`);
@@ -2168,7 +2281,6 @@ export default function psyclawExtension(pi) {
                         ...(ctx.model?.provider === undefined ? {} : { provider: ctx.model.provider }),
                         ...(ctx.model?.id === undefined ? {} : { model: ctx.model.id }),
                         env: providerEnvironment(ctx.model?.provider),
-                        ...(requested.ids.length > 0 ? { tools: [] } : {}),
                         root: ctx.cwd,
                         pauseRequested: async () => {
                             try {