psyclaw 0.29.16 → 0.29.18

package/README.md

@@ -4,7 +4,7 @@ PsyClaw 是面向社会科学研究的智能体工作台。它把研究项目、
 
 PsyClaw 自有代码使用 MIT 许可证；随 npm 包内置的 Academic Research Skills 位于 `vendor/ars`，保持上游署名并单独遵循 CC BY-NC 4.0，仅限非商业用途。
 
-当前版本：`0.29.16`。正式命令、用户配置目录和后续发布统一使用 `psyclaw`。
+当前版本：`0.29.18`。正式命令、用户配置目录和后续发布统一使用 `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.29.16
+npm install -g psyclaw@0.29.18
 ```
 
 如果本机 npm 配置把 registry 误写成带有 `~/` 的地址，请显式指定官方源：
 
 ```bash
-npm install -g psyclaw@0.29.16 --registry=https://registry.npmjs.org/
+npm install -g psyclaw@0.29.18 --registry=https://registry.npmjs.org/
 ```
 
 中国大陆网络较慢或无法访问官方源时：
 
 ```powershell
-npm install -g psyclaw@0.29.16 --registry=https://registry.npmmirror.com
+npm install -g psyclaw@0.29.18 --registry=https://registry.npmmirror.com
 ```
 
 或安装脚本：
@@ -97,6 +97,7 @@ psyclaw evidence add notes\source.md --level user
 | 查看 PsyClaw 和内置运行时更新 | `psyclaw check-updates` |
 | 更新 PsyClaw 和内置运行时 | `psyclaw update` |
 | 导出会话 | 使用 Pi 内置的 `/export` |
+| 匿名产品遥测 | `psyclaw telemetry status`、`psyclaw telemetry off`、`psyclaw telemetry on`（默认开启；对话中 `/telemetry`） |
 | 打开科研面板 | 在对话中输入 `/panel` |
 | 查看或切换 Provider | 在对话中输入 `/provider` 或 `/provider <id>` |
 | 管理启动横幅宠物 | `/pet`、`/pet on`、`/pet off`（默认关闭） |
@@ -178,6 +179,7 @@ node -e 'const fs=require("node:fs"),os=require("node:os"),path=require("node:pa
 - [评测框架](docs/评测框架.md)
 - [PsyClaw ARS 模式与保护边界](docs/PsyClaw-ARS模式.md)
 - [文档与交付物规范](docs/文档规范.md)
+- [遥测（匿名产品遥测，默认开启，可关闭）](docs/telemetry.md)
 
 ## 边界
 
@@ -185,5 +187,6 @@ node -e 'const fs=require("node:fs"),os=require("node:os"),path=require("node:pa
 - 统计计算委托 Python/R、SPSS/Stata/Mplus 或受信任 MCP；输出必须保存脚本、输入指纹和环境信息。
 - Skill、Plugin 和 MCP 默认只发现、不执行；启用前需要来源、版本/ref、哈希、许可证和依赖状态。
 - 没有可定位证据的事实性 Claim 必须是 `uncertain` 或被阻断；没有审批记录的副作用不能被当作完成。
+- 遥测默认开启（匿名产品使用与错误，不含研究正文）。首次启动会说明如何关闭：`psyclaw telemetry off`。详见 [docs/telemetry.md](docs/telemetry.md)。
 
 许可证：MIT。

package/dist/apps/panel/index.html

@@ -4,6 +4,8 @@
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width,initial-scale=1">
   <title>PsyClaw Panel · 科研工作台</title>
+  <script id="psyclaw-obs-config">window.__PSYCLAW_OBS__={"surface":"panel","sentryDsn":"","posthogKey":"","posthogHost":"","release":""};</script>
+  <script src="/observability.js" defer></script>
   <style>
     :root {
       color-scheme: light;
@@ -1090,6 +1092,26 @@
       text-align: center;
     }
     .hidden { display: none !important; }
+    .telemetry-notice {
+      display: flex;
+      align-items: flex-start;
+      justify-content: space-between;
+      gap: 16px;
+      padding: 10px 20px;
+      background: var(--brand-primary-light);
+      border-bottom: 1px solid var(--border-subtle);
+      font-size: 13px;
+      color: var(--text-main);
+    }
+    .telemetry-notice.hidden { display: none !important; }
+    .telemetry-notice p {
+      margin: 0;
+      color: var(--text-muted);
+      max-width: 72ch;
+      line-height: 1.5;
+    }
+    .telemetry-notice strong { color: var(--text-main); }
+    .telemetry-notice .toolbar { display: flex; gap: 8px; align-items: center; flex-shrink: 0; }
 
     /* Pipeline Stepper */
     .pipeline-stepper {
@@ -1838,6 +1860,10 @@
       </div>
     </div>
   </header>
+  <div id="telemetry-notice" class="telemetry-notice hidden" role="status">
+    <p><strong>匿名产品遥测默认开启。</strong> 用于改进 PsyClaw 的粗粒度使用与错误信息；不含研究正文、论文或个人身份。可随时关闭。</p>
+    <div class="toolbar"><button type="button" class="button" id="telemetry-ack">知道了</button><button type="button" class="button" id="telemetry-off">关闭遥测</button></div>
+  </div>
 
   <!-- 主体工作区 Layout -->
   <div class="layout nav-collapsed">
@@ -3404,6 +3430,22 @@ loadProject().catch(error => {
 });
 loadProjectStatus();
 
+(function initTelemetryNotice(){
+  const obs = window.__PSYCLAW_OBS__ || {};
+  const banner = $("telemetry-notice");
+  if (!banner) return;
+  if (obs.showTelemetryNotice) banner.classList.remove("hidden");
+  $("telemetry-ack")?.addEventListener("click", async () => {
+    try { await json("/api/telemetry", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ action: "ack" }) }); } catch {}
+    banner.classList.add("hidden");
+  });
+  $("telemetry-off")?.addEventListener("click", async () => {
+    try { await json("/api/telemetry", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ action: "disable" }) }); } catch {}
+    banner.classList.add("hidden");
+    location.reload();
+  });
+})();
+
 const initialView = decodeURIComponent((location.hash || "").replace(/^#/, "").trim());
 const knownViews = new Set(["project", "ecosystem", "provider", "checklist", "chat", "help"]);
 if (knownViews.has(initialView)) setView(initialView);

package/dist/apps/panel/observability.js

@@ -0,0 +1,87 @@
+/**
+ * Opt-in browser observability for PsyClaw panel + website.
+ *
+ * Loads Sentry / PostHog from a CDN only when a DSN or project key is present
+ * on window.__PSYCLAW_OBS__, a meta tag, or (local debug) a query param.
+ * With those empty, this file is a no-op: no network calls, no SDK init.
+ */
+(function psyclawObservability() {
+  if (window.__PSYCLAW_OBS_BOOTED__) return;
+  window.__PSYCLAW_OBS_BOOTED__ = true;
+
+  function meta(name) {
+    const node = document.querySelector('meta[name="' + name + '"]');
+    const value = node && node.getAttribute("content");
+    return value ? String(value).trim() : "";
+  }
+
+  function param(name) {
+    try {
+      return new URLSearchParams(location.search).get(name) || "";
+    } catch {
+      return "";
+    }
+  }
+
+  function readConfig() {
+    const fromWindow = window.__PSYCLAW_OBS__ || {};
+    const sentryDsn = String(fromWindow.sentryDsn || meta("psyclaw-sentry-dsn") || param("sentryDsn") || "").trim();
+    const posthogKey = String(fromWindow.posthogKey || meta("psyclaw-posthog-key") || param("posthogKey") || "").trim();
+    const posthogHost = String(
+      fromWindow.posthogHost || meta("psyclaw-posthog-host") || param("posthogHost") || "https://us.posthog.com",
+    ).trim();
+    const surface = fromWindow.surface === "panel" || fromWindow.surface === "website" ? fromWindow.surface : "web";
+    const release = String(fromWindow.release || "").trim();
+    return { sentryDsn, posthogKey, posthogHost, surface, release };
+  }
+
+  async function loadEsm(url) {
+    return import(url);
+  }
+
+  async function bootSentry(config) {
+    const Sentry = await loadEsm("https://cdn.jsdelivr.net/npm/@sentry/browser@10/+esm");
+    Sentry.init({
+      dsn: config.sentryDsn,
+      release: config.release || undefined,
+      environment: "local",
+      tracesSampleRate: 1.0,
+      sendDefaultPii: false,
+      integrations: typeof Sentry.browserTracingIntegration === "function" ? [Sentry.browserTracingIntegration()] : [],
+    });
+    window.Sentry = Sentry;
+  }
+
+  async function bootPostHog(config) {
+    const mod = await loadEsm("https://cdn.jsdelivr.net/npm/posthog-js@1/+esm");
+    const posthog = mod.default || mod.posthog || mod;
+    const panel = config.surface === "panel";
+    posthog.init(config.posthogKey, {
+      api_host: config.posthogHost,
+      person_profiles: "identified_only",
+      autocapture: true,
+      capture_pageview: true,
+      capture_pageleave: true,
+      persistence: "memory",
+      mask_all_text: panel,
+      mask_all_element_attributes: panel,
+      session_recording: {
+        maskAllInputs: true,
+        maskTextSelector: panel
+          ? ".markdown, .raw, .viewer-body, .event-detail, pre, code, textarea, [data-file]"
+          : undefined,
+      },
+      loaded: function (client) {
+        client.register({ surface: config.surface, app: "psyclaw" });
+      },
+    });
+    window.posthog = posthog;
+  }
+
+  const config = readConfig();
+  const jobs = [];
+  if (config.sentryDsn) jobs.push(bootSentry(config).catch(function () {}));
+  if (config.posthogKey) jobs.push(bootPostHog(config).catch(function () {}));
+  if (jobs.length === 0) return;
+  Promise.all(jobs).catch(function () {});
+})();

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

@@ -35,6 +35,7 @@ import { continuouslyWorkWarningText, isContinuouslyWorkEnabled, } from "../../s
 import { assertHumanVerifyGate, formatVerifyChecklist, isNaturalPlanConfirm, ensureDefaultVerifyChecklist, loadVerifyChecklist } from "../../verify/checklist.js";
 import { formatSessionHelp, formatSessionHelpBrief } from "../../session/help.js";
 import { openResearchWorkbench } from "../../panel/workbench.js";
+import { captureAgentError, initNodeObservability, readTelemetryPreference, shutdownObservability, trackGateWaiting, writeTelemetryPreference, } from "../../observability/index.js";
 /** Codex-style slash surface: bare command, or command + trailing free text. No subcommand trees. */
 function parseInitArgs(args) {
     const goal = args.trim();
@@ -43,6 +44,7 @@ function parseInitArgs(args) {
     return { paradigm: "survey-observational", goal };
 }
 async function notifyError(ctx, error) {
+    await captureAgentError(error, { phase: "extension" });
     ctx.ui.notify(error instanceof Error ? error.message : String(error), "error");
 }
 const activeAgentRuns = new Set();
@@ -887,6 +889,7 @@ const WORKFLOW_RUNNERS = {
     "expert-review": runExpertReview,
 };
 export default function psyclawExtension(pi) {
+    void initNodeObservability();
     const developerCommands = process.env.PSYCLAW_DEVELOPER_COMMANDS === "1";
     const legacyTestApi = typeof pi.registerTool !== "function";
     const runtimeMcps = new RuntimeMcpRegistry();
@@ -936,7 +939,10 @@ export default function psyclawExtension(pi) {
             };
         });
     if (!legacyTestApi && typeof pi.on === "function")
-        pi.on("session_shutdown", () => runtimeMcps.close());
+        pi.on("session_shutdown", () => {
+            runtimeMcps.close();
+            void shutdownObservability();
+        });
     if (!legacyTestApi && typeof pi.on === "function")
         pi.on("before_agent_start", async (event, ctx) => {
             if (!(await readActiveProject(ctx?.cwd ?? process.cwd())))
@@ -1094,6 +1100,7 @@ export default function psyclawExtension(pi) {
             if (requiresSeparateOperationConfirmation(event.toolName, event.input)) {
                 if (!ctx.hasUI)
                     return { block: true, terminate: true, reason: "外部发布需要用户在交互界面中明确确认" };
+                void trackGateWaiting("tool_approval");
                 const choice = await ctx.ui.select(`确认外部操作\n${summary}`, ["确认执行", "取消"], { timeout: 120_000 });
                 const approved = choice === "确认执行";
                 await appendApproval(ctx.cwd, {
@@ -1607,6 +1614,26 @@ export default function psyclawExtension(pi) {
                 ctx.ui.notify(`启动横幅宠物已${action === "on" ? "开启" : "关闭"}，下次启动生效`, "info");
             },
         });
+    if (!legacyTestApi)
+        pi.registerCommand("telemetry", {
+            description: "查看或关闭匿名产品遥测",
+            handler: async (args, ctx) => {
+                const action = args.trim().toLowerCase() || "status";
+                if (action === "status") {
+                    const preference = await readTelemetryPreference();
+                    ctx.ui.notify(preference.enabled
+                        ? "匿名产品遥测：开启（默认）。采集粗粒度使用与错误，不含研究正文。关闭：/telemetry off"
+                        : "匿名产品遥测：已关闭。重新开启：/telemetry on", "info");
+                    return;
+                }
+                if (action !== "on" && action !== "off") {
+                    ctx.ui.notify("Usage: /telemetry on|off|status", "error");
+                    return;
+                }
+                await writeTelemetryPreference({ enabled: action === "on", noticeAcknowledged: true });
+                ctx.ui.notify(action === "on" ? "已开启匿名产品遥测。下次启动生效。" : "已关闭匿名产品遥测。下次启动不再发送。", "info");
+            },
+        });
     if (typeof pi.registerTool === "function") {
         pi.registerTool({
             name: "psyclaw_research_decision",