psyclaw 0.30.8 → 0.30.11

package/LICENSE

@@ -1,21 +1,16 @@
-MIT License
+Creative Commons Attribution-NonCommercial 4.0 International
 
-Copyright (c) 2026 Exekiel179 and PsyClaw contributors
+Copyright (c) 2026 Exekiel179
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+PsyClaw is licensed under the Creative Commons Attribution-NonCommercial 4.0
+International License (CC BY-NC 4.0).
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+You may share and adapt the material for non-commercial purposes, provided you
+give appropriate credit and indicate if changes were made. Commercial use is not
+permitted under this license.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Full legal code:
+https://creativecommons.org/licenses/by-nc/4.0/legalcode
+
+Human-readable summary:
+https://creativecommons.org/licenses/by-nc/4.0/

package/README.md

@@ -2,21 +2,20 @@
 
 面向社会科学研究的智能体工作台：把研究项目、证据账本、完整性门禁、可恢复工作流和本地面板接到内置运行时上。它不替代统计软件，也不会把未经核验的引用、结果或审稿意见写成事实。
 
-当前版本：`0.30.8` · 命令与用户目录：`psyclaw` / `~/.psyclaw` · 许可证：MIT
-内置 Academic Research Skills（`vendor/ars`）遵循上游 CC BY-NC 4.0，仅限非商业用途。
+许可证：CC BY-NC 4.0
 
 ## 安装
 
 需要 Node.js `>=22.19.0`。
 
 ```bash
-npm install -g psyclaw@0.30.8
+npm install -g psyclaw@latest
 ```
 
 中国大陆可用镜像或安装脚本：
 
 ```bash
-npm install -g psyclaw@0.30.8 --registry=https://registry.npmmirror.com
+npm install -g psyclaw@latest --registry=https://registry.npmmirror.com
 # 或
 PSYCLAW_CN=1 curl -fsSL https://exekiel179.github.io/psyclaw/install.sh | sh
 ```
@@ -79,13 +78,6 @@ psyclaw evidence add notes/source.md --level user
 - [技能与生态准入清单](docs/技能与生态准入清单.md) · [威胁模型](docs/威胁模型.md)
 - [AGENTS.md](AGENTS.md)
 
-## 边界
-
-- 复用官方 Pi runtime，不维护 fork。
-- 统计计算委托 Python/R、SPSS/Stata/Mplus 或受信任 MCP；须保存脚本、输入指纹与环境信息。
-- Skill / Plugin / MCP 默认只发现、不执行；启用前核对来源与信任状态。
-- 无证据的事实性 Claim 须标为 `uncertain` 或阻断；无 receipt / 审批的副作用不算完成。
-
 ## 从源码开发
 
 ```bash
@@ -109,7 +101,7 @@ RELEASE_MESSAGE="release: describe the change" pnpm release:push
 
 ```bash
 npm uninstall -g psyclaw
-npm install -g psyclaw@0.30.8
+npm install -g psyclaw@latest
 ```
 
 仅卸载程序：`npm uninstall -g psyclaw`  

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

@@ -15,6 +15,7 @@ import { PROVIDER_PRESETS, providerCredentialSource, saveProviderConfig } from "
 import { dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { coreSkillNames, enabledRecommendedSkillPaths, normalizeRecommendedSkillId, readRecommendationState, readRecommendedCatalog, recommendedSkillTarget, saveRecommendationState, validateModelInstalledRecommendedSkill, } from "../../skills/recommended.js";
+import { buildRecommendedSkillInstallTask } from "../../skills/install-guidance.js";
 import { SkillManagerComponent } from "../../tui/skill-manager.js";
 import { BiosignalWizardComponent } from "../../tui/biosignal-wizard.js";
 import { readBiosignalPackCatalog, resolveBiosignalInstallPlan, } from "../../skills/biosignal-pack.js";
@@ -726,12 +727,20 @@ function modelMcpInstallTask(root, row, plan) {
         "成功后确保 .psyclaw/recommendations.json 的 mcp 列表包含该 id（安装时已默认写入启用），说明写入了哪些配置，并提醒用户执行 /reload。若安装命令本身失败，直接诊断并修复；只有遇到必须由用户提供的凭据或外部软件许可证时才向用户说明。",
     ].join("\n");
 }
+/** Queue an install/setup prompt for the model without rendering the long text as a user bubble. */
+function queueHiddenInstallTask(pi, ctx, task) {
+    if (typeof pi.sendMessage === "function") {
+        pi.sendMessage({ customType: "psyclaw-install-task", content: task, display: false }, ctx.isIdle() ? { triggerTurn: true } : { deliverAs: "followUp" });
+        return;
+    }
+    pi.sendUserMessage(task, ctx.isIdle() ? {} : { deliverAs: "followUp" });
+}
 async function queueModelMcpInstall(pi, ctx, row, plan) {
     if (!row.sourceRef)
         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");
+    queueHiddenInstallTask(pi, ctx, modelMcpInstallTask(ctx.cwd, row, plan));
+    ctx.ui.notify(`已将 ${row.name} 的安装任务交给当前模型（指令不展示在对话中；默认启用）。完成后请执行 /reload。`, "info");
 }
 async function showMcpManager(pi, ctx, runtime) {
     const catalog = await recommendedItems("mcp");
@@ -776,20 +785,15 @@ async function showMcpManager(pi, ctx, runtime) {
     }
 }
 function modelSkillInstallTask(root, row, scope) {
-    const target = recommendedSkillTarget(root, row.id, scope);
-    return [
-        `安装推荐 Skill：${row.name} (${row.id})。`,
-        `来源网址：${row.sourceRef}`,
-        ...(row.installHint ? [`仓库入口提示：${row.installHint}`] : []),
-        `安装位置：${skillScopeLabel(scope)}。`,
-        `唯一允许的最终目标目录：${target}`,
-        "用户已通过 Skill 管理页授权本次安装。请使用当前会话的联网、文件和命令工具读取来源仓库，并直接下载、安装所需依赖和完成 Skill 安装；不要再次要求安装权限。不要写入其他 Skill 目录，不要修改 .psyclaw/data/raw、data/raw、.git 或研究产物。",
-        row.collection
-            ? "这是多 Skill 套件：目标目录自身无需 SKILL.md，但其子目录必须包含一个或多个有效 SKILL.md。保留套件内共享目录和相对路径，不得包含 .git、符号链接或凭据。"
-            : "目标目录最终必须直接包含有效 SKILL.md（YAML frontmatter 至少包含 name 和 description），不得包含 .git、符号链接、凭据或二进制大文件。",
-        "如果仓库包含多个 Skill，只安装与此推荐项相符的部分；如果它不是 Skill 或无法合理适配，停止并说明原因，不要伪造 SKILL.md。",
-        "安装完成后检查目标目录结构。该项已在推荐状态中默认启用；完成后执行 /reload 即可加载，无需再手动启用。",
-    ].join("\n");
+    return buildRecommendedSkillInstallTask({
+        name: row.name,
+        id: row.id,
+        sourceRef: row.sourceRef ?? "",
+        target: recommendedSkillTarget(root, row.id, scope),
+        scopeLabel: skillScopeLabel(scope),
+        ...(row.installHint ? { installHint: row.installHint } : {}),
+        collection: Boolean(row.collection),
+    });
 }
 async function chooseSkillScope(ctx) {
     const projectLabel = skillScopeLabel("project");
@@ -829,8 +833,8 @@ async function queueModelSkillInstall(pi, ctx, row) {
             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");
+        queueHiddenInstallTask(pi, ctx, modelSkillInstallTask(ctx.cwd, row, scope));
+        ctx.ui.notify(`已将 ${row.name} 的安装任务交给当前模型（指令不展示在对话中；默认启用），目标为${skillScopeLabel(scope)}。完成后请执行 /reload。`, "info");
     });
 }
 function modelBiosignalPackInstallTask(root, plan, skillRows, mcpRows, mcpPlans, skillScope) {
@@ -943,8 +947,8 @@ async function queueBiosignalPackInstall(pi, ctx, plan, runtime) {
     if (!approved)
         return;
     await markBiosignalPackDesired(ctx.cwd, plan, scope);
-    pi.sendUserMessage(modelBiosignalPackInstallTask(ctx.cwd, plan, skillRows, selectedMcp, mcpCatalog.installPrep, scope), ctx.isIdle() ? {} : { deliverAs: "followUp" });
-    ctx.ui.notify("已将生理信号能力包安装任务交给当前模型。完成后请执行 /reload，并 Shift+Tab 切到 analysis 使用。", "info");
+    queueHiddenInstallTask(pi, ctx, modelBiosignalPackInstallTask(ctx.cwd, plan, skillRows, selectedMcp, mcpCatalog.installPrep, scope));
+    ctx.ui.notify("已将生理信号能力包安装任务交给当前模型（指令不展示在对话中）。完成后请执行 /reload，并 Shift+Tab 切到 analysis 使用。", "info");
 }
 async function showBiosignalPack(pi, ctx, runtime) {
     const catalog = await readBiosignalPackCatalog();
@@ -1315,6 +1319,7 @@ export default function psyclawExtension(pi) {
                         isProjectTrusted: () => ctx.isProjectTrusted(),
                         isIdle: () => ctx.isIdle(),
                         sendUserMessage: (message, options) => pi.sendUserMessage(message, options ?? {}),
+                        sendHiddenInstallTask: (task) => queueHiddenInstallTask(pi, ctx, task),
                     }, { view: "help" });
                     ctx.ui.notify(formatSessionHelpBrief(url) + (opened ? "" : "\n（未能自动打开浏览器时请手动访问）"), opened ? "info" : "warning");
                 }
@@ -1597,6 +1602,7 @@ export default function psyclawExtension(pi) {
                     isProjectTrusted: () => ctx.isProjectTrusted(),
                     isIdle: () => ctx.isIdle(),
                     sendUserMessage: (message, options) => pi.sendUserMessage(message, options ?? {}),
+                    sendHiddenInstallTask: (task) => queueHiddenInstallTask(pi, ctx, task),
                 }, { view: "help" });
                 ctx.ui.notify(formatSessionHelpBrief(url) + (opened ? "" : "\n（未能自动打开浏览器时请手动访问）"), opened ? "info" : "warning");
             }