psyclaw 0.30.1 → 0.30.3

package/README.md

@@ -4,7 +4,7 @@ PsyClaw 是面向社会科学研究的智能体工作台。它把研究项目、
 
 PsyClaw 自有代码使用 MIT 许可证；随 npm 包内置的 Academic Research Skills 位于 `vendor/ars`，保持上游署名并单独遵循 CC BY-NC 4.0，仅限非商业用途。
 
-当前版本：`0.30.1`。正式命令、用户配置目录和后续发布统一使用 `psyclaw`。
+当前版本：`0.30.3`。正式命令、用户配置目录和后续发布统一使用 `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.30.1
+npm install -g psyclaw@0.30.3
 ```
 
 如果本机 npm 配置把 registry 误写成带有 `~/` 的地址，请显式指定官方源：
 
 ```bash
-npm install -g psyclaw@0.30.1 --registry=https://registry.npmjs.org/
+npm install -g psyclaw@0.30.3 --registry=https://registry.npmjs.org/
 ```
 
 中国大陆网络较慢或无法访问官方源时：
 
 ```powershell
-npm install -g psyclaw@0.30.1 --registry=https://registry.npmmirror.com
+npm install -g psyclaw@0.30.3 --registry=https://registry.npmmirror.com
 ```
 
 或安装脚本：
@@ -46,7 +46,7 @@ PSYCLAW_CN=1 curl -fsSL https://exekiel179.github.io/psyclaw/install.sh | sh
 ```powershell
 # Windows PowerShell
 irm https://exekiel179.github.io/psyclaw/install.ps1 | iex
-# 可选：$env:PSYCLAW_CN = "1"；$env:PSYCLAW_VERSION = "0.30.1"
+# 可选：$env:PSYCLAW_CN = "1"；$env:PSYCLAW_VERSION = "0.30.3"
 ```
 
 检测到国内 npm registry（如 npmmirror）、`PSYCLAW_CN=1` 或 `PSYCLAW_GITHUB_MIRROR` 时，内置路径统一走国内可用路由：
@@ -108,7 +108,7 @@ psyclaw evidence add notes\source.md --level user
 | 打开科研面板 | 在对话中输入 `/panel` |
 | 查看或切换 Provider | 在对话中输入 `/provider` 或 `/provider <id>` |
 | 管理启动横幅宠物 | `/pet`、`/pet on`、`/pet off`（默认关闭） |
-| 管理 Skill | `/skill`（在管理页启用/安装） |
+| 管理 Skill | `/skill`（未安装→安装并默认启用；已启用→停用） |
 | 创建项目能力 | `/create-skill`、`/create-hook`、`/create-rule`、`/create-subagent`（附带需求文本） |
 | 运行只读 Subagent | `/agents` 浏览，或 `/agents <task>` 运行 |
 | 调用已加载 Skill | `/skill:<name>` |
@@ -189,13 +189,25 @@ rm -rf ~/.psyclaw
 
 ## 文档
 
-- [PsyClaw v0.30.1 使用白皮书](docs/PsyClaw使用白皮书_v0.30.1.md)
+### 使用（面向研究者）
+
+- [使用白皮书](docs/使用白皮书.md)（当前版同步说明；带版本号的副本见 `docs/PsyClaw使用白皮书_v*.md`）
+- [PsyClaw ARS 模式与保护边界](docs/PsyClaw-ARS模式.md)
+- [遥测（匿名产品遥测，默认开启，可关闭）](docs/telemetry.md)
+- [文档与交付物规范](docs/文档规范.md)（研究项目内目录约定）
+
+### 开发（面向贡献者 / 维护者）
+
+下列文件是仓库与实现契约，**不是**日常使用说明；贡献或改核心前再读：
+
 - [项目范围与里程碑](docs/开工纪要.md)
 - [架构蓝图](docs/架构蓝图.md)
 - [评测框架](docs/评测框架.md)
-- [PsyClaw ARS 模式与保护边界](docs/PsyClaw-ARS模式.md)
-- [文档与交付物规范](docs/文档规范.md)
-- [遥测（匿名产品遥测，默认开启，可关闭）](docs/telemetry.md)
+- [技能与生态准入清单](docs/技能与生态准入清单.md)
+- [威胁模型](docs/威胁模型.md)
+- [AGENTS.md](AGENTS.md)（贡献行为约束）
+
+历史审计、分模块测评报告、会话复盘等仍在 `docs/` 下，按文件名识别；勿与使用白皮书混读。
 
 ## 边界
 

package/dist/apps/panel/observability.js

@@ -32,7 +32,8 @@
     ).trim();
     const surface = fromWindow.surface === "panel" || fromWindow.surface === "website" ? fromWindow.surface : "web";
     const release = String(fromWindow.release || "").trim();
-    return { sentryDsn, posthogKey, posthogHost, surface, release };
+    const distinctId = String(fromWindow.distinctId || "").trim();
+    return { sentryDsn, posthogKey, posthogHost, surface, release, distinctId };
   }
 
   async function loadEsm(url) {
@@ -56,7 +57,7 @@
     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, {
+    const init = {
       api_host: config.posthogHost,
       person_profiles: "identified_only",
       autocapture: true,
@@ -74,7 +75,9 @@
       loaded: function (client) {
         client.register({ surface: config.surface, app: "psyclaw" });
       },
-    });
+    };
+    if (config.distinctId) init.bootstrap = { distinctID: config.distinctId };
+    posthog.init(config.posthogKey, init);
     window.posthog = posthog;
   }
 

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

@@ -35,7 +35,7 @@ import { continuouslyWorkWarningText, isContinuouslyWorkEnabled, } from "../../s
 import { assertHumanVerifyGate, formatVerifyChecklist, isNaturalPlanConfirm, isPlanRitualConfirm, PLAN_RITUAL_PHRASE, 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";
+import { captureAgentError, initNodeObservability, readTelemetryPreference, shutdownObservability, trackGateWaiting, trackSkillInstall, withAgentSpan, 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,8 +43,8 @@ function parseInitArgs(args) {
         return {};
     return { paradigm: "survey-observational", goal };
 }
-async function notifyError(ctx, error) {
-    await captureAgentError(error, { phase: "extension" });
+async function notifyError(ctx, error, extra = {}) {
+    await captureAgentError(error, { phase: "extension", cwd: ctx.cwd, ...extra });
     ctx.ui.notify(error instanceof Error ? error.message : String(error), "error");
 }
 const activeAgentRuns = new Set();
@@ -410,17 +410,21 @@ async function skillManagerRows(root, state) {
 }
 async function mcpManagerRows(root, state, runtime) {
     const { items, installPrep } = await recommendedItems("mcp");
+    const userEntries = await runtime.listUserConfigs(root);
+    const configuredIds = new Set(userEntries.map((entry) => entry.id));
     const recommendedRows = items.map((item) => {
         const id = String(item.id ?? "");
         const plan = installPrep.find((candidate) => candidate.id === id);
         const dependencies = Array.isArray(plan?.dependencies)
             ? plan.dependencies.filter((value) => typeof value === "string")
             : [];
+        const installed = configuredIds.has(id);
         return {
             id,
             name: String(item.name ?? id),
             description: String(item.description ?? ""),
             ...(typeof item.sourceRef === "string" ? { sourceRef: item.sourceRef } : {}),
+            installed,
             enabled: state.mcp.includes(id),
             source: "recommended",
             details: [
@@ -433,10 +437,11 @@ async function mcpManagerRows(root, state, runtime) {
     // Merge user-configured MCP servers (`.psyclaw/mcp/*.json` and
     // `~/.psyclaw/mcp/*.json`) so the management page shows them too, even when
     // disabled.  User rows win over a same-id recommended row.
-    const userRows = (await runtime.listUserConfigs(root)).map((entry) => ({
+    const userRows = userEntries.map((entry) => ({
         id: entry.id,
         name: entry.name,
         description: `用户配置：${entry.command}`,
+        installed: true,
         enabled: entry.enabled,
         source: "user",
         userEntry: entry,
@@ -508,7 +513,7 @@ function mcpManagerItems(rows) {
         id: row.id,
         name: row.name,
         description: row.description,
-        status: row.enabled ? "enabled" : "disabled",
+        status: row.enabled ? "enabled" : row.installed ? "disabled" : "missing",
         configuredEnabled: row.enabled,
         ...(row.sourceRef === undefined ? {} : { sourceRef: row.sourceRef }),
         details: row.details,
@@ -518,10 +523,10 @@ async function openMcpManager(ctx, rows) {
     return ctx.ui.custom((tui, theme, keybindings, done) => (new SkillManagerComponent(mcpManagerItems(rows), tui, theme, keybindings, done, {
         title: "MCP 管理",
         itemLabel: "MCP",
-        footer: "↑/↓ 移动 · Space 开启/关闭 · a 全部开启 · d 全部关闭 · Enter 交给模型安装并配置 · Esc 关闭",
-        enterAction: "install",
-        enabledText: "已开启；Enter 可让当前模型重新安装或修复推荐配置",
-        disabledText: "已关闭",
+        footer: "↑/↓ 移动 · Space/Enter 安装或启停 · a 全部开启 · d 全部关闭 · Esc 关闭",
+        enabledText: "已开启；再次点击可关闭",
+        disabledText: "已安装，当前未启用；点击可开启",
+        missingMessage: "尚未安装；点击交给模型安装并默认启用",
     })));
 }
 function pluginManagerItems(rows) {
@@ -643,7 +648,7 @@ function modelMcpInstallTask(root, row, plan) {
         "用户已经通过 MCP 管理页明确授权本次安装。你可以直接联网、克隆或下载来源、使用所需包管理器安装依赖、执行安装命令，并写入与该 MCP 有关的项目或用户级运行配置；不要再次要求用户批准这些安装步骤。",
         "请先阅读来源仓库的实际安装与启动说明，再根据当前操作系统和宿主环境完成可运行的 stdio/HTTP MCP 配置。目录中的版本、命令和依赖只作参考，不得因为哈希、许可证、依赖或本地数据策略检查而中止安装。",
         "安装完成后实际启动一次服务器或执行等价的最小连通性检查，确认启动命令和工作目录有效。不要输出、复制或提交 API Key、令牌及其他凭据。",
-        `成功后确保 .psyclaw/recommendations.json 的 mcp 列表包含 ${JSON.stringify(row.id)}，说明写入了哪些配置，并提醒用户执行 /reload。若安装命令本身失败，直接诊断并修复；只有遇到必须由用户提供的凭据或外部软件许可证时才向用户说明。`,
+        "成功后确保 .psyclaw/recommendations.json 的 mcp 列表包含该 id（安装时已默认写入启用），说明写入了哪些配置，并提醒用户执行 /reload。若安装命令本身失败，直接诊断并修复；只有遇到必须由用户提供的凭据或外部软件许可证时才向用户说明。",
     ].join("\n");
 }
 async function queueModelMcpInstall(pi, ctx, row, plan) {
@@ -651,7 +656,7 @@ async function queueModelMcpInstall(pi, ctx, row, plan) {
         throw new Error(`推荐 MCP 没有来源网址: ${row.id}`);
     await setRecommendedMcpEnabled(ctx.cwd, row.id, true);
     pi.sendUserMessage(modelMcpInstallTask(ctx.cwd, row, plan), ctx.isIdle() ? {} : { deliverAs: "followUp" });
-    ctx.ui.notify(`已将 ${row.name} 的下载、安装和配置任务交给当前模型。模型完成并确认可启动后，请执行 /reload。`, "info");
+    ctx.ui.notify(`已将 ${row.name} 的下载、安装和配置任务交给当前模型（默认启用）。完成后请执行 /reload。`, "info");
 }
 async function showMcpManager(pi, ctx, runtime) {
     const catalog = await recommendedItems("mcp");
@@ -708,7 +713,7 @@ function modelSkillInstallTask(root, row, scope) {
             ? "这是多 Skill 套件：目标目录自身无需 SKILL.md，但其子目录必须包含一个或多个有效 SKILL.md。保留套件内共享目录和相对路径，不得包含 .git、符号链接或凭据。"
             : "目标目录最终必须直接包含有效 SKILL.md（YAML frontmatter 至少包含 name 和 description），不得包含 .git、符号链接、凭据或二进制大文件。",
         "如果仓库包含多个 Skill，只安装与此推荐项相符的部分；如果它不是 Skill 或无法合理适配，停止并说明原因，不要伪造 SKILL.md。",
-        "安装完成后检查目标目录结构，并提醒用户执行 /skill 启用该项，再执行 /reload。",
+        "安装完成后检查目标目录结构。该项已在推荐状态中默认启用；完成后执行 /reload 即可加载，无需再手动启用。",
     ].join("\n");
 }
 async function chooseSkillScope(ctx) {
@@ -721,20 +726,37 @@ async function chooseSkillScope(ctx) {
         return "user";
     return undefined;
 }
+async function markRecommendedSkillDesired(root, requestedId, scope) {
+    const id = normalizeRecommendedSkillId(requestedId);
+    const state = await readRecommendationState(root);
+    const current = new Set(state.skills);
+    current.add(id);
+    state.skills = [...current];
+    state.skillScopes = { ...(state.skillScopes ?? {}), [id]: scope };
+    await saveRecommendationState(root, state);
+}
 async function queueModelSkillInstall(pi, ctx, row) {
     if (!row.sourceRef)
         throw new Error(`推荐 Skill 没有来源网址: ${row.id}`);
     const scope = await chooseSkillScope(ctx);
     if (!scope)
         return;
-    const approved = await ctx.ui.confirm("交给当前模型安装 Skill？", `${row.name}\n来源：${row.sourceRef}\n安装位置：${skillScopeLabel(scope)}\n目标目录：${recommendedSkillTarget(ctx.cwd, row.id, scope)}\n模型将检查仓库并使用文件与命令工具完成安装。`);
+    const approved = await ctx.ui.confirm("交给当前模型安装 Skill？", `${row.name}\n来源：${row.sourceRef}\n安装位置：${skillScopeLabel(scope)}\n目标目录：${recommendedSkillTarget(ctx.cwd, row.id, scope)}\n模型将检查仓库并使用文件与命令工具完成安装；安装后默认启用。`);
     if (!approved)
         return;
-    const state = await readRecommendationState(ctx.cwd);
-    state.skillScopes = { ...(state.skillScopes ?? {}), [row.id]: scope };
-    await saveRecommendationState(ctx.cwd, state);
-    pi.sendUserMessage(modelSkillInstallTask(ctx.cwd, row, scope), ctx.isIdle() ? {} : { deliverAs: "followUp" });
-    ctx.ui.notify(`已将 ${row.name} 的安装任务交给当前模型，目标为${skillScopeLabel(scope)}。安装完成后请在 /skill 中启用，再执行 /reload。`, "info");
+    await withAgentSpan("cli.skill_install", { phase: "skill_install", scope, skill_id: row.id }, async () => {
+        try {
+            await markRecommendedSkillDesired(ctx.cwd, row.id, scope);
+        }
+        catch (error) {
+            void trackSkillInstall("error", { skill_id: row.id, scope, status: "error" });
+            await notifyError(ctx, error, { phase: "skill_install", skill_id: row.id, scope });
+            return;
+        }
+        void trackSkillInstall("queued", { skill_id: row.id, scope, status: "queued" });
+        pi.sendUserMessage(modelSkillInstallTask(ctx.cwd, row, scope), ctx.isIdle() ? {} : { deliverAs: "followUp" });
+        ctx.ui.notify(`已将 ${row.name} 的安装任务交给当前模型（默认启用），目标为${skillScopeLabel(scope)}。完成后请执行 /reload。`, "info");
+    });
 }
 async function showSkillManager(pi, ctx) {
     if (!ctx.hasUI || typeof ctx.ui.custom !== "function") {