psyclaw 0.29.18 → 0.29.20

package/docs//344/275/277/347/224/250/347/231/275/347/232/256/344/271/246.md

@@ -0,0 +1,3 @@
+# PsyClaw 使用白皮书
+
+当前使用说明、安装方式和命令接口请阅读 [PsyClaw使用白皮书_v0.29.15.md](PsyClaw使用白皮书_v0.29.15.md)。同步提供 Word 版：[PsyClaw使用白皮书_v0.29.15.docx](PsyClaw使用白皮书_v0.29.15.docx)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "psyclaw",
-  "version": "0.29.18",
+  "version": "0.29.20",
   "description": "A standalone, evidence-grounded social-science research agent with research contracts, evidence gates, and recoverable workflows",
   "type": "module",
   "license": "MIT",
@@ -30,7 +30,9 @@
     "vendor/academic-paper-skills",
     "vendor/windows",
     "scripts/psyclaw.mjs",
-    "scripts/rebrand-pi.mjs"
+    "scripts/rebrand-pi.mjs",
+    "docs/使用白皮书.md",
+    "docs/PsyClaw使用白皮书_v0.29.15.md"
   ],
   "engines": {
     "node": ">=22.19.0"

package/scripts/rebrand-pi.mjs

@@ -423,6 +423,74 @@ async function applySettingsPatches(settingsManagerPath) {
   return applied;
 }
 
+export const FOOTER_PATCHES = [
+  {
+    old: `        else {
+            contextPercentStr = contextPercentDisplay;
+        }
+        statsParts.push(contextPercentStr);
+        if (areExperimentalFeaturesEnabled()) {`,
+    next: `        else {
+            contextPercentStr = contextPercentDisplay;
+        }
+        statsParts.push(contextPercentStr);
+        const modeStatus = this.footerData.getExtensionStatuses().get("mode");
+        if (modeStatus) {
+            statsParts.push(sanitizeStatusText(modeStatus));
+        }
+        if (areExperimentalFeaturesEnabled()) {`,
+  },
+  {
+    old: `        // Add extension statuses on a single line, sorted by key alphabetically
+        const extensionStatuses = this.footerData.getExtensionStatuses();
+        if (extensionStatuses.size > 0) {
+            const sortedStatuses = Array.from(extensionStatuses.entries())
+                .sort(([a], [b]) => a.localeCompare(b))
+                .map(([, text]) => sanitizeStatusText(text));
+            const statusLine = sortedStatuses.join(" ");
+            // Truncate to terminal width with dim ellipsis for consistency with footer style
+            lines.push(truncateToWidth(statusLine, width, theme.fg("dim", "...")));
+        }`,
+    next: `        // Add extension statuses on a single line, sorted by key alphabetically
+        const extensionStatuses = this.footerData.getExtensionStatuses();
+        if (extensionStatuses.size > 0) {
+            const sortedStatuses = Array.from(extensionStatuses.entries())
+                .filter(([key]) => key !== "mode")
+                .sort(([a], [b]) => a.localeCompare(b))
+                .map(([, text]) => sanitizeStatusText(text));
+            if (sortedStatuses.length > 0) {
+                const statusLine = sortedStatuses.join(" ");
+                // Truncate to terminal width with dim ellipsis for consistency with footer style
+                lines.push(truncateToWidth(statusLine, width, theme.fg("dim", "...")));
+            }
+        }`,
+  },
+];
+
+export function applyFooterPatchesToContent(content) {
+  let patched = content;
+  let appliedCount = 0;
+  const isCrlf = content.includes("\r\n");
+  for (const { old, next } of FOOTER_PATCHES) {
+    const targetOld = isCrlf ? old.replace(/\r?\n/g, "\r\n") : old;
+    const targetNext = isCrlf ? next.replace(/\r?\n/g, "\r\n") : next;
+    if (patched.includes(targetOld)) {
+      patched = patched.replace(targetOld, targetNext);
+      appliedCount++;
+    }
+  }
+  return { content: patched, applied: appliedCount > 0, appliedCount };
+}
+
+async function applyFooterPatches(footerPath) {
+  const content = await readFile(footerPath, "utf8");
+  const result = applyFooterPatchesToContent(content);
+  if (result.applied) {
+    await atomicReplace(footerPath, result.content, true);
+  }
+  return result.appliedCount;
+}
+
 const MANAGED_TOOL_DOWNLOAD_GUARD = `    // PsyClaw supplies Node-based find/grep fallbacks. Keep PATH tools when
     // present, but never fetch optional binaries from GitHub during startup.
     return undefined;`;
@@ -448,16 +516,18 @@ export async function rebrandPiRuntime(options = {}) {
   const settingsManagerPath = join(pkgDir, "dist", "core", "settings-manager.js");
   const slashCommandsPath = join(pkgDir, "dist", "core", "slash-commands.js");
   const toolsManagerPath = join(pkgDir, "dist", "utils", "tools-manager.js");
+  const footerPath = join(pkgDir, "dist", "modes", "interactive", "components", "footer.js");
 
   const pkgResult = await patchPackageJson(pkgPath);
   const applied = await applyModePatches(modePath);
   const settingsApplied = await applySettingsPatches(settingsManagerPath);
+  const footerApplied = await applyFooterPatches(footerPath);
   const commandApplied = await applySlashCommandPatches(slashCommandsPath);
   const managedToolsRestored = await restoreManagedToolManager(toolsManagerPath);
 
   if (!options.quiet) {
     process.stdout.write(
-      `psyclaw rebrand: piConfig ${pkgResult.applied ? "applied" : "already set"} · ${applied.length > 0 ? `patched ${applied.length} display string(s)` : "display strings already patched"} · ${settingsApplied.length > 0 ? `patched ${settingsApplied.length} setting default(s)` : "settings already patched"} · ${commandApplied.length > 0 ? `hidden ${commandApplied.length} Pi command(s)` : "Pi commands already filtered"} · ${managedToolsRestored ? "restored managed-tool downloads" : "managed-tool downloads unchanged"} (${pkgDir})\n`,
+      `psyclaw rebrand: piConfig ${pkgResult.applied ? "applied" : "already set"} · ${applied.length > 0 ? `patched ${applied.length} display string(s)` : "display strings already patched"} · ${settingsApplied.length > 0 ? `patched ${settingsApplied.length} setting default(s)` : "settings already patched"} · ${footerApplied > 0 ? `patched ${footerApplied} footer component(s)` : "footer already patched"} · ${commandApplied.length > 0 ? `hidden ${commandApplied.length} Pi command(s)` : "Pi commands already filtered"} · ${managedToolsRestored ? "restored managed-tool downloads" : "managed-tool downloads unchanged"} (${pkgDir})\n`,
     );
     if (applied.length > 0) {
       for (const label of applied) {
@@ -469,6 +539,9 @@ export async function rebrandPiRuntime(options = {}) {
         process.stdout.write(`  - ${label}…\n`);
       }
     }
+    if (footerApplied > 0) {
+      process.stdout.write(`  - mode status inline with context auto indicator…\n`);
+    }
     if (commandApplied.length > 0) {
       for (const label of commandApplied) {
         process.stdout.write(`  - ${label}…\n`);

package/skills/recommended/catalog.json

@@ -103,8 +103,10 @@
       "name": "Journal Frontier Radar",
       "kind": "skill",
       "stage": "文献前沿",
-      "description": "基于期刊文章清单开展可追溯的前沿追踪、主题映射、关键词分析和未解决问题发现。",
+      "description": "基于期刊文章清单开展可追溯的前沿追踪、主题映射、关键词分析和未解决问题发现。前置依赖：Kimi WebBridge（须先安装并 `kimi-webbridge status` 确认 extension_connected）。",
       "sourceRef": "https://github.com/kingfly51/journal-frontier-radar",
+      "prerequisites": ["kimi-webbridge"],
+      "requiresExternalTools": ["kimi-webbridge"],
       "installHint": "安装仓库中的 skills/journal-frontier-radar 完整目录，包含 SKILL.md 及其脚本。启用前须先安装推荐外部工具 Kimi WebBridge（官方 daemon + Chrome/Edge 扩展），并用 `kimi-webbridge status` 确认 extension_connected: true；不要把本机 Downloads 解压扩展当 PsyClaw Plugin 安装。"
     },
     {
@@ -204,7 +206,7 @@
       "kind": "external-tool",
       "installable": true,
       "stage": "浏览器桥接",
-      "description": "月之暗面官方本机浏览器桥：daemon（127.0.0.1:10086）+ Chrome/Edge 扩展。让 Agent 操作用户真实浏览器与登录态，供 Journal Frontier Radar 等文献调研 Skill 联网检索；不是 PsyClaw Plugin，也不是可 clone 进 .psyclaw 的 Skill 包。",
+      "description": "月之暗面官方本机浏览器桥：daemon（127.0.0.1:10086）+ Chrome/Edge 扩展。让 Agent 操作用户真实浏览器与登录态；Journal Frontier Radar 的前置依赖。不是 PsyClaw Plugin，也不是可 clone 进 .psyclaw 的 Skill 包。",
       "sourceRef": "https://www.kimi.com/zh-cn/features/webbridge",
       "installHint": "按官网安装，不要把 Downloads 解压扩展当 PsyClaw Plugin。1) macOS/Linux 执行 `curl -fsSL https://cdn.kimi.com/webbridge/install.sh | bash`（Windows 按官网指引）；2) 从 Chrome Web Store 或 Edge Add-ons 安装 Kimi WebBridge 扩展并保持浏览器运行；商店不可用时才从官网下载后手动「加载已解压的扩展程序」；3) 运行 `kimi-webbridge status`，确认 extension_connected: true；4) 安装脚本若写入宿主 Skill 目录（常见为 ~/.claude/skills/kimi-webbridge），保留即可，供 Agent 调用本机 daemon。完成后报告 daemon 路径、扩展连接状态与验证命令输出。"
     },

package/skills/recommended/mcp-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "psyclaw/recommended-mcp/v1",
-  "documentVersion": "0.3.2",
+  "documentVersion": "0.3.3",
   "sourceDocument": "学术AI_Skill分享资料.pdf + curated research MCP review",
   "sourceRef": "user-curated",
   "items": [
@@ -92,6 +92,17 @@
       "writeEffects": false,
       "status": "discover-only"
     },
+    {
+      "id": "drawio-mcp",
+      "name": "draw.io MCP",
+      "stage": "研究示意图",
+      "description": "官方 draw.io（diagrams.net）MCP：把 XML / CSV / Mermaid 打开到浏览器编辑器，便于研究框架图、流程图与概念图。stdio 包 @drawio/mcp；另有托管端点 https://mcp.draw.io/mcp（需 MCP Apps 宿主）。",
+      "sourceRef": "https://github.com/jgraph/drawio-mcp",
+      "transport": "stdio",
+      "risk": "browser-open",
+      "writeEffects": false,
+      "status": "discover-only"
+    },
     {
       "id": "playwright-mcp",
       "name": "Playwright MCP",
@@ -135,6 +146,7 @@
     {"id":"zotero-mcp","sourceKind":"github","ref":"d57892db395c38d7782f037bc9fc8222e6a429ae","license":"unknown","command":"git clone https://github.com/richardjlyon/zotero-mcp .psyclaw/mcp-src/zotero-mcp && git -C .psyclaw/mcp-src/zotero-mcp checkout d57892db395c38d7782f037bc9fc8222e6a429ae","target":".psyclaw/mcp/zotero-mcp.json","dependencies":["Git","Zotero local library","Zotero API/token only if explicitly configured"],"status":"blocked","requiresApproval":true,"blockedReason":"License is not verified and local-library write effects require a separate trust decision."},
     {"id":"academic-mcp","sourceKind":"github","ref":"main","license":"MIT","command":"git clone https://github.com/veale/academic-mcp .psyclaw/mcp-src/academic-mcp && git -C .psyclaw/mcp-src/academic-mcp checkout main","target":".psyclaw/mcp/academic-mcp.json","dependencies":["Git","Zotero/OpenAlex/Semantic Scholar configuration per repository metadata"],"status":"review-required","requiresApproval":true,"blockedReason":"Immutable commit and external API terms require preflight."},
     {"id":"scholar-mcp","sourceKind":"github","ref":"f94eac6a49c6d35a83f35148375eebfa08459e9b","license":"MIT","command":"git clone https://github.com/pvliesdonk/scholar-mcp .psyclaw/mcp-src/scholar-mcp && git -C .psyclaw/mcp-src/scholar-mcp checkout f94eac6a49c6d35a83f35148375eebfa08459e9b","target":".psyclaw/mcp/scholar-mcp.json","dependencies":["Git","provider/API configuration per repository metadata"],"status":"review-required","requiresApproval":true,"blockedReason":"Verify executable entrypoint and API terms before registration."},
+    {"id":"drawio-mcp","sourceKind":"npm","ref":"1.5.0","license":"Apache-2.0","command":"npx -y @drawio/mcp@1.5.0","target":".psyclaw/mcp/drawio-mcp.json","dependencies":["Node.js >=18","npm","browser to open app.diagrams.net (or DRAWIO_BASE_URL)"],"status":"review-required","requiresApproval":true,"blockedReason":"Confirm stdio config opens diagrams in the browser; optional DRAWIO_BASE_URL for self-hosted draw.io. Hosted MCP Apps endpoint https://mcp.draw.io/mcp is a separate path."},
     {"id":"playwright-mcp","sourceKind":"github","ref":"7e0457a7cbf88823bf0146d12c46ae12c6818247","license":"Apache-2.0","command":"npx -y @playwright/mcp@latest","target":".psyclaw/mcp/playwright-mcp.json","dependencies":["Node.js >=18","npm or pnpm","optional browser extension for existing login session"],"status":"review-required","requiresApproval":true,"blockedReason":"Pin npm package version before execution; browser navigation/download remains separately approved."},
     {"id":"mne-mcp","sourceKind":"github","ref":"627142cb5beebe1a210a8e0fb1e15afbec8b8010","license":"MIT","command":"uvx --from mne-mcp==0.3.0 mne-mcp","target":".psyclaw/mcp/mne-mcp.json","dependencies":["Python >=3.10","uv","MNE-Python data dependencies"],"status":"review-required","requiresApproval":true,"blockedReason":"Verify PyPI artifact hash and local-data write policy before registration."},
     {"id":"spss-mcp","sourceKind":"github","ref":"fb4f020189b28b8acfb23a710875a7f9ae4e1e62","license":"MIT","command":"git clone https://github.com/Exekiel179/SPSS-MCP .psyclaw/mcp-src/spss-mcp && git -C .psyclaw/mcp-src/spss-mcp checkout fb4f020189b28b8acfb23a710875a7f9ae4e1e62","target":".psyclaw/mcp/spss-mcp.json","dependencies":["Git","IBM SPSS Statistics","Python runtime per repository metadata"],"status":"review-required","requiresApproval":true,"blockedReason":"Verify repository entrypoint and SPSS license/runtime before registration."}