psyclaw 0.29.18 → 0.29.19

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.19",
   "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 路径、扩展连接状态与验证命令输出。"
     },