personal-bot 0.2.8 → 0.2.10

package/lib/storage/history-files.js

@@ -1,12 +1,13 @@
-import { existsSync, mkdirSync, readdirSync, rmdirSync } from "node:fs";
-import { join } from "node:path";
-import { object } from "../common/json.js";
+import { existsSync, mkdirSync, readdirSync, rmdirSync, unlinkSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { canonical, object } from "../common/json.js";
 import { requireThat } from "../common/validation.js";
-import { readJsonFile, writeJsonFile } from "./atomic-json.js";
+import { internalPath, readJsonFile, syncDirectory, writeJsonFile } from "./atomic-json.js";
 import { fileId } from "./file-access.js";
 const strings = (value) => Array.isArray(value) && value.every(item => typeof item === "string");
 function record(value) {
-    requireThat(object(value) && typeof value.id === "string" && typeof value.sessionId === "string" &&
+    requireThat(object(value) && (value.host === "pi" || value.host === "dsh") &&
+        typeof value.id === "string" && typeof value.sessionId === "string" &&
         typeof value.name === "string" && Array.isArray(value.nodes), "历史索引无效。");
     for (const node of value.nodes)
         requireThat(object(node) && typeof node.id === "string" &&
@@ -21,25 +22,77 @@ function record(value) {
 export class HistoryFiles {
     directory;
     host;
+    #warnings = [];
     constructor(directory, host = "pi") {
         this.directory = directory;
         this.host = host;
     }
-    list(workspace) {
+    get warnings() { return this.#warnings; }
+    list() {
+        this.#warnings = [];
         if (!existsSync(this.directory))
             return [];
-        return readdirSync(this.directory).filter(name => name.endsWith(".json"))
-            .map(name => readJsonFile(this.directory, name, value => {
-            const result = record(value);
-            requireThat(this.host !== "dsh" || result.id.startsWith("dsh-"), "dsh 历史根 ID 缺少来源前缀。");
-            return result;
-        }))
-            .filter(value => workspace === undefined || ("workspace" in value && value.workspace === workspace));
+        const records = [];
+        for (const name of readdirSync(this.directory).filter(name => name.endsWith(".json"))) {
+            try {
+                const value = readJsonFile(this.directory, name, record);
+                requireThat(name === fileId(value.id) + ".json", "历史文件名与根 ID 不匹配。");
+                if (value.host === this.host)
+                    records.push(value);
+            }
+            catch (error) {
+                this.#warnings.push(join(this.directory, name) + ": " + String(error));
+            }
+        }
+        return records;
+    }
+    /** Publish each legacy archive with its directory's host before removing the old copy. */
+    migrate(root) {
+        const directory = join(root, "." + this.host, "pbot/history");
+        if (!existsSync(directory))
+            return;
+        this.control(() => {
+            if (!existsSync(directory))
+                return;
+            const legacyLock = join(directory, ".write");
+            mkdirSync(legacyLock, { mode: 0o700 });
+            try {
+                for (const name of readdirSync(directory).filter(name => name.endsWith(".json"))) {
+                    const source = internalPath(directory, name), target = internalPath(this.directory, name);
+                    requireThat(source !== target, "新旧历史目录指向同一位置。");
+                    const value = readJsonFile(directory, name, value => {
+                        requireThat(object(value) && (value.host === undefined || value.host === this.host), "旧历史归档与来源目录不匹配。");
+                        return record({ ...value, host: this.host });
+                    });
+                    requireThat(name === fileId(value.id) + ".json", "历史文件名与根 ID 不匹配。");
+                    if (!writeJsonFile(this.directory, name, value, record, true)) {
+                        requireThat(canonical(readJsonFile(this.directory, name, record)) === canonical(value), "历史归档迁移冲突，请核对新旧文件：" + name);
+                    }
+                    syncDirectory(this.directory);
+                    unlinkSync(source);
+                    syncDirectory(directory);
+                }
+            }
+            finally {
+                rmdirSync(legacyLock);
+            }
+            rmdirSync(directory);
+            const parent = dirname(directory);
+            syncDirectory(parent);
+            try {
+                rmdirSync(parent);
+                syncDirectory(dirname(parent));
+            }
+            catch (error) {
+                if (!["ENOTEMPTY", "EEXIST"].includes(error.code ?? ""))
+                    throw error;
+            }
+        });
     }
     /** The callback is synchronous: no SDK reads or model work can hold this source's write lock. */
     control(operation) {
         mkdirSync(this.directory, { recursive: true, mode: 0o700 });
-        const lock = join(this.directory, ".write");
+        const lock = join(this.directory, ".write-" + this.host);
         try {
             mkdirSync(lock, { mode: 0o700 });
         }
@@ -56,7 +109,7 @@ export class HistoryFiles {
         }
     }
     save(value) {
-        requireThat(this.host !== "dsh" || value.id.startsWith("dsh-"), "dsh 历史根 ID 缺少来源前缀。");
+        requireThat(value.host === this.host, "历史归档与来源不匹配。");
         mkdirSync(this.directory, { recursive: true, mode: 0o700 });
         writeJsonFile(this.directory, fileId(value.id) + ".json", value, record);
     }

package/lib/tools/agents/contract.js

@@ -1,4 +1,4 @@
-import { Type } from "typebox";
+import { Type } from "../../common/typebox.js";
 export const agentDescription = "委派专家并继续对话。start 启动后即返回，完成自动通知，无需轮询；省略初始输入时待命。send 继续对话，团队占用期间不可私人 send。status 查看状态，read 读取报告；读取已结束周期即领取其通知，包括部分读取。续读固定 cycle.cycleId 并使用 nextOffset。state 表示执行状态，cycle.state 表示工作结果，queued 只表示入队。stop 保留历史，resume 携新 message 继续。每个父会话最多 50 个存活专家，空闲也计入。";
 const id = Type.String({ minLength: 1, maxLength: 128 });
 const message = Type.String({ minLength: 1, maxLength: 24000, description: "本次目标、相关资料、约束和交付要求。" });

package/lib/tools/agents/dsh-contract.js

@@ -1,4 +1,4 @@
-import { Type } from "typebox";
+import { Type } from "../../common/typebox.js";
 import { agentActionSchema, agentParametersSchema, agentStartOptions } from "./contract.js";
 const options = Type.Omit(Type.Object(agentStartOptions), ["provider", "model", "thinking", "files", "tools", "noExtensions", "noPromptTemplates", "noContextFiles", "noSkills"]).properties;
 const native = {

package/lib/tools/history/contract.js

@@ -1,4 +1,4 @@
-import { Type } from "typebox";
+import { Type } from "../../common/typebox.js";
 import { requireThat, schema } from "../../common/validation.js";
 const host = Type.Union([Type.Literal("pi"), Type.Literal("dsh")]);
 const nullableOffset = Type.Union([Type.Integer(), Type.Null()]);

package/lib/tools/teams/contract.js

@@ -1,4 +1,4 @@
-import { Type } from "typebox";
+import { Type } from "../../common/typebox.js";
 export const teamDescription = "组织固定成员协作。create 建立团队，run 开始一批讨论。运行时占用成员；pause 停止新安排，允许在途工作收尾，之后可私人 send；中止成员用 pbot_agent stop。close 保留成员和历史；换成员须关闭旧团队再创建。继续讨论用 run 提交新要求。成员最终答复向团队公开。";
 export const teamMessageDescription = "读写团队公共原文。post 向全体成员发布信息，需要安排回答时由主会话调用 pbot_team run；成员只能在自己的团队工作中 post。read 用 afterSeq 翻页，长正文按 seq/offset 续读，先补完 nextOffset 非空的消息。";
 const id = Type.String({ minLength: 1, maxLength: 128 });

package/lib/ui/dsh/management.js

@@ -78,6 +78,8 @@ export function showManagement(ctx, parentSessionId) {
     }
     function form(parent) { const node = element("form"); parent.append(node); return node; }
     function activate(id) {
+        if (snapshot?.enabled === false && id !== "status")
+            return;
         tab = id;
         for (const [key, section] of sections)
             section.hidden = key !== id;
@@ -157,7 +159,7 @@ export function showManagement(ctx, parentSessionId) {
     counts.classList.add("pbot-counts");
     const materials = group(status, "pbot-setting");
     materials.append(element("h3", "资料目录"));
-    button(materials, "准备目录", async () => { await command("init", undefined, "资料目录已准备。"); });
+    const initializeButton = button(materials, "准备目录", async () => { await command("init", undefined, "工作区已初始化并启用。"); });
     const pythonCard = group(status, "pbot-setting"), pythonInfo = group(pythonCard);
     const pythonButton = button(pythonCard, "准备 Python", async () => { await command("python setup", undefined, "Python 准备完成。"); });
     const diagnostic = details(status, "环境详情"), statusBody = block("");
@@ -625,13 +627,35 @@ export function showManagement(ctx, parentSessionId) {
             return;
         location.textContent = text(snapshot.workspaceRoot).split(/[\\/]/).filter(Boolean).at(-1) ?? "";
         location.title = text(snapshot.workspaceRoot);
+        if (snapshot.enabled === false) {
+            const configuration = record(snapshot.configuration);
+            counts.textContent = configuration.error ? "Personal Bot 配置错误" : "Personal Bot 未启用";
+            workspaceInfo.replaceChildren(facts([["状态", configuration.error ? "配置错误" : "未启用"], ["工作区", snapshot.workspaceRoot], ["配置文件", configuration.path]]), note(configuration.error ? "修复配置文件后执行 /pbot init。" : "执行 /pbot init，或点击下方按钮初始化并启用。"));
+            pythonInfo.replaceChildren(note("启用工作区后自动准备共享 Python 环境。"));
+            materials.hidden = false;
+            initializeButton.textContent = "初始化并启用";
+            enabled(initializeButton, !configuration.error);
+            for (const [id, control] of tabs)
+                enabled(control, id === "status");
+            enabled(pythonButton, false);
+            activate("status");
+            statusBody.textContent = JSON.stringify(snapshot, null, 2);
+            if (configuration.error)
+                inform(text(configuration.error), "error");
+            return;
+        }
+        for (const control of tabs.values())
+            enabled(control, true);
+        materials.hidden = false;
+        initializeButton.textContent = "准备目录";
+        enabled(initializeButton, true);
         const agents = rows(snapshot.agents), teams = rows(snapshot.teams), python = record(snapshot.python), history = record(snapshot.history);
         tabCounts.get("experts").textContent = text(agents.length);
         tabCounts.get("teams").textContent = text(teams.length);
         const active = agents.filter(agent => ["starting", "busy", "stopping"].includes(text(agent.state))).length;
-        counts.textContent = `专家 ${agents.length} · 执行中 ${active} · 团队 ${teams.length}`;
+        counts.textContent = `Personal Bot 已启动 · 专家 ${agents.length} · 执行中 ${active} · 团队 ${teams.length}`;
         const model = object(snapshot.model) ? snapshot.model : {};
-        workspaceInfo.replaceChildren(facts([["工作区", snapshot.workspaceRoot], ["模型", model.model || "尚未选择"], ["Provider", model.provider || "—"],
+        workspaceInfo.replaceChildren(facts([["状态", "已启动"], ["工作区", snapshot.workspaceRoot], ["配置文件", record(snapshot.configuration).path], ["模型", model.model || "尚未选择"], ["Provider", model.provider || "—"],
             ["历史", history.organizing ? "整理中" : history.pending === null ? "查询时更新索引" : `${history.pending} 项待整理`]]));
         pythonInfo.replaceChildren(element("h3", "Python"), badge(python.state));
         if (python.error)

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "personal-bot",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "personal-bot",
-      "version": "0.2.8",
+      "version": "0.2.10",
       "dependencies": {
         "ajv": "8.17.1",
         "ajv-formats": "3.0.1",
@@ -29,6 +29,7 @@
         "@deepseek-ai/dsh-fs-patch": "0.2.2-rc.1",
         "@deepseek-ai/dsh-home-paths": "0.2.2-rc.1",
         "@deepseek-ai/dsh-llm": "0.2.2-rc.1",
+        "@deepseek-ai/dsh-scope": "0.2.2-rc.1",
         "@deepseek-ai/dsh-session": "0.2.2-rc.1",
         "@deepseek-ai/dsh-session-persistence": "0.2.2-rc.1",
         "@deepseek-ai/dsh-session-query": "0.2.2-rc.1",
@@ -68,6 +69,7 @@
         "@deepseek-ai/dsh-fs-patch": "*",
         "@deepseek-ai/dsh-home-paths": "*",
         "@deepseek-ai/dsh-llm": "*",
+        "@deepseek-ai/dsh-scope": "*",
         "@deepseek-ai/dsh-session": "*",
         "@deepseek-ai/dsh-session-persistence": "*",
         "@deepseek-ai/dsh-session-query": "*",
@@ -122,6 +124,9 @@
         "@deepseek-ai/dsh-llm": {
           "optional": true
         },
+        "@deepseek-ai/dsh-scope": {
+          "optional": true
+        },
         "@deepseek-ai/dsh-session": {
           "optional": true
         },
@@ -166,6 +171,9 @@
         },
         "@earendil-works/pi-tui": {
           "optional": true
+        },
+        "typebox": {
+          "optional": true
         }
       }
     },
@@ -4684,7 +4692,6 @@
       "integrity": "sha512-FOJbXYvrskIcrb/4eVMMQfp0kaReTSBtIry2KsGNURb0OJfelqeSKaB1MsQQq/sOxbt3nPJIN9HY00SwmrTk3Q==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "peerDependencies": {
         "@deepseek-ai/cordis": "~4.1.0"
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "personal-bot",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/realqiyan/personal-bot.git"
@@ -22,21 +22,36 @@
     "extensions": [
       "./src/pbot.ts"
     ],
-    "skills": ["./resources/skills"],
+    "skills": [],
     "prompts": [],
     "themes": []
   },
   "dsh": {
-    "bundle": { "patch": "./resources/dsh/cordis.patch.yml" },
+    "bundle": {
+      "patch": "./resources/dsh/cordis.patch.yml"
+    },
     "client": {
       "platform": "web",
-      "inject": ["@deepseek-ai/dsh-api-remotes", "@deepseek-ai/dsh-client-ui-commands", "@deepseek-ai/dsh-client-file-upload"]
+      "inject": [
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-ui-commands",
+        "@deepseek-ai/dsh-client-file-upload"
+      ]
     }
   },
   "exports": {
-    ".": { "types": "./lib/dsh.d.ts", "default": "./lib/dsh.js" },
-    "./dsh": { "types": "./lib/dsh.d.ts", "default": "./lib/dsh.js" },
-    "./client": { "types": "./lib/ui/dsh/index.d.ts", "default": "./lib/client.js" },
+    ".": {
+      "types": "./lib/dsh.d.ts",
+      "default": "./lib/dsh.js"
+    },
+    "./dsh": {
+      "types": "./lib/dsh.d.ts",
+      "default": "./lib/dsh.js"
+    },
+    "./client": {
+      "types": "./lib/ui/dsh/index.d.ts",
+      "default": "./lib/client.js"
+    },
     "./*": "./*"
   },
   "files": [
@@ -84,6 +99,7 @@
     "@deepseek-ai/dsh-tools": "*",
     "@deepseek-ai/dsh-home-paths": "*",
     "@deepseek-ai/dsh-system-prompt": "*",
+    "@deepseek-ai/dsh-scope": "*",
     "@deepseek-ai/dsh-skill": "*",
     "@deepseek-ai/dsh-skill-filesystem": "*",
     "@deepseek-ai/dsh-working-directory": "*",
@@ -100,30 +116,81 @@
     "typebox": "*"
   },
   "peerDependenciesMeta": {
-    "@deepseek-ai/cordis": { "optional": true },
-    "@deepseek-ai/dsh-agent": { "optional": true },
-    "@deepseek-ai/dsh-agent-preset-registry": { "optional": true },
-    "@deepseek-ai/dsh-session": { "optional": true },
-    "@deepseek-ai/dsh-session-persistence": { "optional": true },
-    "@deepseek-ai/dsh-session-query": { "optional": true },
-    "@deepseek-ai/dsh-llm": { "optional": true },
-    "@deepseek-ai/dsh-commands": { "optional": true },
-    "@deepseek-ai/dsh-api-remotes": { "optional": true },
-    "@deepseek-ai/dsh-client-ui-commands": { "optional": true },
-    "@deepseek-ai/dsh-client-file-upload": { "optional": true },
-    "@deepseek-ai/dsh-tools": { "optional": true },
-    "@deepseek-ai/dsh-home-paths": { "optional": true },
-    "@deepseek-ai/dsh-system-prompt": { "optional": true },
-    "@deepseek-ai/dsh-skill": { "optional": true },
-    "@deepseek-ai/dsh-skill-filesystem": { "optional": true },
-    "@deepseek-ai/dsh-working-directory": { "optional": true },
-    "@deepseek-ai/dsh-fs": { "optional": true },
-    "@deepseek-ai/dsh-attachment": { "optional": true },
-    "@deepseek-ai/dsh-fs-patch": { "optional": true },
-    "@deepseek-ai/dsh-user-approval": { "optional": true },
-    "@deepseek-ai/dsh-tool-executor-ptc": { "optional": true },
-    "@deepseek-ai/dsh-typert-protocol": { "optional": true },
-    "@deepseek-ai/dsh-typert-registry": { "optional": true },
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent-preset-registry": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-session": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-session-persistence": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-session-query": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-llm": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-commands": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-api-remotes": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-commands": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-file-upload": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-home-paths": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-system-prompt": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-scope": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-skill": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-skill-filesystem": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-working-directory": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-fs": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-attachment": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-fs-patch": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-user-approval": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tool-executor-ptc": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-typert-protocol": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-typert-registry": {
+      "optional": true
+    },
     "@earendil-works/pi-ai": {
       "optional": true
     },
@@ -132,6 +199,9 @@
     },
     "@earendil-works/pi-tui": {
       "optional": true
+    },
+    "typebox": {
+      "optional": true
     }
   },
   "dependencies": {
@@ -155,6 +225,7 @@
     "@deepseek-ai/dsh-tools": "0.2.2-rc.1",
     "@deepseek-ai/dsh-home-paths": "0.2.2-rc.1",
     "@deepseek-ai/dsh-system-prompt": "0.2.2-rc.1",
+    "@deepseek-ai/dsh-scope": "0.2.2-rc.1",
     "@deepseek-ai/dsh-skill": "0.2.2-rc.1",
     "@deepseek-ai/dsh-skill-filesystem": "0.2.2-rc.1",
     "@deepseek-ai/dsh-working-directory": "0.2.2-rc.1",

package/python/README.md

@@ -4,7 +4,7 @@
 
 ## 自动准备与激活
 
-Pi 加载 Personal Bot、原生 `/reload`，或 dsh 加载 pbot Host 组件时自动执行 setup，无需另行确认或指定路径。同一系统用户的两种宿主共用该环境：
+工作区的 `.pbot/config.json` 设置 `enabled: true` 后，Pi 加载或原生 `/reload` 时自动执行 setup；dsh 在首个已启用工作区加载时准备环境。无需另行确认或指定 Python 路径。同一系统用户的两种宿主共用该环境：
 
 1. 共享 venv 不存在时创建，不使用系统 site-packages。
 2. 按 `requirements.lock` 补齐或对齐依赖，允许升级或降级；已匹配时不重新安装。
@@ -18,11 +18,11 @@ Pi 加载 Personal Bot、原生 `/reload`，或 dsh 加载 pbot Host 组件时
 
 首次准备从当前 PATH 选择 python3，无该命令时使用 python；需要 Python 3.11+ 和 venv/ensurepip。系统 Python 只用于创建独立 venv，不在系统环境中安装依赖。现有环境不自动替换基础解释器，也不删除额外安装的包。
 
-首次安装可能需要数分钟和网络。环境准备不依赖 `/pbot init` 或工作区资料；不需要 Personal Bot 时通过所属宿主的原生配置取消加载。`/pbot status` 显示环境状态。所属激活生命周期关闭时恢复本扩展修改的进程环境变量；dsh 按整个 pbot 组件共享激活，不随某个浏览器页面或单个工作区关闭而恢复，不覆盖期间其他代码对变量的新修改。外部终端和 shell 配置不变。
+首次安装可能需要数分钟和网络。`/pbot init` 创建共用启用配置并启动环境准备；手工设置 enabled 为 true 后重载也会准备环境。不需要 Personal Bot 的工作区可保留配置缺失或设置 enabled 为 false，再重载或重启宿主；也可通过宿主原生配置取消加载整个插件。`/pbot status` 显示环境状态。所属激活生命周期关闭时恢复本扩展修改的进程环境变量；dsh 按整个 pbot 组件共享激活，不随某个浏览器页面或单个工作区关闭而恢复，不覆盖期间其他代码对变量的新修改。外部终端和 shell 配置不变。
 
 ## 失败与手工重试
 
-环境异常时提醒，并在状态中保留错误。pbot 的其他能力仍可使用，但不把 Python 标记为就绪，也不替模型自动换用系统 Python 执行研究。原生 Bash 仍然可用，这不是命令黑名单或系统隔离。
+环境异常时提醒，并在状态中保留错误。pbot 的其他能力仍可使用，但不把 Python 标记为就绪，也不替模型自动换用系统 Python 执行研究。原生 Bash 仍然可用。
 
 检查错误后可执行：
 
@@ -34,7 +34,7 @@ Pi 加载 Personal Bot、原生 `/reload`，或 dsh 加载 pbot Host 组件时
 
 安装只接受 wheel，不编译 C 库、不安装系统软件，不绕过系统 Python 的安装保护。没有匹配 wheel、网络不可用、权限不足或环境损坏时停止。TA-Lib wheel 包含底层库，但并非所有系统和架构都有匹配 wheel。pip 安装配置被忽略，避免包被重定向到其他目标。
 
-多个 pbot 进程同时启动时，通过共享排他锁串行准备，后取得锁的进程重新检查。锁文件不删除。该锁不管理普通 Python 进程；更换插件版本或手工重试前，应停止使用该环境的脚本。不同插件版本可能要求不同依赖，不宜同时使用。不能承诺自动更新不会影响已运行的外部脚本。
+多个 pbot 进程同时启动时，通过共享排他锁串行准备，后取得锁的进程重新检查。锁文件不删除。该锁不管理普通 Python 进程；更换插件版本或手工重试前，应停止使用该环境的脚本。不同插件版本可能要求不同依赖，不宜同时使用。
 
 ## 独立准备
 
@@ -51,7 +51,7 @@ python3 scripts/setup-python.py --check  # 只检查，不创建或安装
 
 setup 安装 numpy、pandas、TA-Lib、backtesting、scipy、statsmodels、matplotlib、scikit-learn、pyarrow、openpyxl、seaborn 和 Bokeh。按任务导入，环境与项目运行见[计算参考](../resources/references/compute.md)，需要技术指标或回测时再读[指标与回测](../resources/references/compute-finance.md)。市场规则、费用、成交时点和数据切分由具体研究确定，原生 Backtest 不自动提供 A 股 T+1、整手或涨跌停约束。
 
-激活后直接执行 `python scripts/analyze.py` 或 `python -m analysis.main`。工作目录、模块导入、参数和结果位置遵循项目约定。项目构建或测试明确要求另一环境时，按项目约定执行。pbot 不复制源码、不生成输入文件或计算记录、不管理研究进程的超时。Python 与 Bash 不是文件或网络沙箱，也不授予交易权限。
+激活后直接执行 `python scripts/analyze.py` 或 `python -m analysis.main`。工作目录、模块导入、参数和结果位置遵循项目约定。项目构建或测试明确要求另一环境时，按项目约定执行。pbot 不复制源码、不生成输入文件或计算记录、不管理研究进程的超时。Python 与 Bash 使用实际账户权限，操作范围见[工具与执行](../docs/capability-design.md)。
 
 在已激活环境中验证：
 
@@ -60,7 +60,7 @@ python -m pip check
 python -B -m unittest discover -s python/tests -v
 ```
 
-Node 测试使用真实本地文件、进程、临时 venv 与 Pi/dsh 原生 Bash，验证检查、错误、取消和激活恢复；不下载依赖。完整安装与库测试使用准备好的真实环境，不能以损坏环境的启动测试替代成功安装验收。Python 集成测试验证原生库配合与文件往返，不证明市场规则或策略有效；macOS 的 dsh 桌面应用已在临时 HOME 中完成真实依赖安装、就绪激活、pip check 与 5 项原生库测试；真实模型使用这些库的行为仍需验收。
+Node 测试检查环境探测、错误、取消与激活恢复，使用临时 venv 和原生 Bash。上述 Python 测试在已准备的环境中检查原生库配合与文件往返。
 
 依赖版本独立于插件版本。更新锁文件须检查最低 Python 3.11 与目标环境的兼容性，不只按开发机选择最新版。
 

package/resources/prompts/workspace.md

@@ -10,7 +10,7 @@
 
 ## 资料与环境
 
-沿用已有工作区约定；新资料按下列用途组织。正文维护一份，其他位置用引用连接。
+沿用已有工作区约定；新资料按下列用途组织。文档按主题维护当前说明，保留读者理解、决策和操作所需的信息。正文维护一份，其他位置用引用连接。
 
 | 路径 | 用途 |
 | --- | --- |
@@ -23,8 +23,8 @@
 | `agents/` | `coordinator.md`、`general-purpose.md` 的职责补充 |
 | `.agents/skills/` | 工作区自有专业方法 |
 
-保存有后续用途的结论、方法、决策和产物；普通问答不逐轮存档。保存前查找同主题正文，更新或整理时使用 project-maintenance。可再次查询的数据按记录的口径获取。保留用户资料、历史记录和备份。
+保存有后续用途的结论、方法、决策和产物；普通问答不逐轮存档。保存前查找同主题正文，直接修订，合并重复内容并替换过时说明。必要的实现细节放入对应技术资料，排查过程和测试流水不逐次追加到正文。更新或整理时使用 project-maintenance。可再次查询的数据按记录的口径获取。保留用户资料、历史记录和备份。
 
 环境上下文中的 `workspaceRoot` 是资料工作区根目录，`resourceRoot` 是包内资料根目录，`python` 给出共享环境状态。资料路径相对工作区根目录，命令与文件工具按实际 cwd 解析路径。需要 Python 时读取包内 `references/compute.md`；共享环境未就绪时不退回系统 Python。项目构建和测试遵循项目声明的环境。
 
-答复先给结论，按需补充说明和产物路径。数值注明影响理解的对象、期间、单位与口径。
+答复先给结论，按需补充说明和产物路径。自然语言说明直接回答当前问题，不惯常追加否定式限定或免责声明，也不设想用户未提出的推论再逐一否定。必要的未知、条件和风险清楚说明一次。数值注明影响理解的对象、期间、单位与口径。任务要求、操作权限、必要确认和规定的输出格式照常遵循。

package/scripts/README.md

@@ -1,25 +1,26 @@
 # 维护脚本
 
-## Python 环境准备
+## 构建
 
-`setup-python.py` 创建当前用户的共享 venv，按 requirements.lock 安装依赖。Personal Bot 加载后自动调用；也可独立执行，或通过 /pbot python setup 重试。
+| 命令 | 作用 |
+| --- | --- |
+| `npm run build` | 清理 dist，编译测试模块，再构建 CLI 与 dsh 产物 |
+| `npm run build:cli` | 清理 lib，编译独立安装器、Pi 检查桥接与启动保护 |
+| `npm run build:dsh` | 编译 Host，将 TypeBox 与许可证纳入 lib，再构建原生 Web Loader 模块 |
 
-脚本不接受解释器路径，不修改工作区资料或历史记录。路径、激活和失败处理见 [Python 说明](../python/README.md)。
+完整构建与 prepack 先构建 CLI，再构建 dsh。宿主 SDK 保持 external；dsh 编译模块引用包内 TypeBox，原模块位置保留。Pi 扩展由宿主直接加载 src。
 
-## 安装 CLI 构建
+## 安装包检查
 
-`npm run build:cli` 调用 `build-cli.mjs`，清理生成目录 lib，再按 tsconfig.cli.json 编译独立 CLI、Pi 检查桥接和启动保护。bin/pbot.mjs 转交已生成的入口。npm test 的构建与 prepack 都执行此步骤；扩展运行仍由 Pi 加载 src 源码。消费者直接使用发布包中的 lib，无需安装开发依赖。
+先运行 `npm pack`，再将生成的 tarball 路径传给检查脚本：
 
-## dsh 构建
+| 命令 | 检查内容 | 环境 |
+| --- | --- | --- |
+| `node scripts/check-consumer.mjs <tarball>` | 独立 CLI、Pi 扩展、技能、工具与资料初始化 | CI 使用 Node.js 22.19.0，脚本安装锁定的 Pi SDK |
+| `node scripts/check-dsh-consumer.mjs <tarball>` | dsh 原生插件安装、独立 CLI 与 Host 导入；检查无需单独安装 TypeBox 或宿主 SDK | Node.js 24.9+、仓库开发依赖和 PATH 中的 pnpm |
 
-`npm run build:dsh` 调用 `build-dsh.mjs`，由 tsconfig.dsh.json 编译 Host 与浏览器入口，再用 esbuild 将 Web 代码包装为当前开发基线的原生包根 Loader 模块。宿主 SDK 保持 external；完整 build 和 prepack 先构建 CLI、再构建 dsh，统一输出到 lib。
+脚本使用隔离的用户目录、宿主配置与工作目录，完成后清理临时目录。两项检查均不调用模型；Pi 使用预置故障目录跳过 Python 依赖下载，dsh 通过原生 schema 收集导入 Host。
 
-## 发布包消费者检查
+## Python 准备
 
-`node scripts/check-consumer.mjs <tarball>` 在临时目录安装实际发布包，先检查独立 CLI 与宿主 SDK 缺省状态，再安装 package.json 中锁定的 Pi SDK，验证扩展、工具、技能和资料初始化。CI 使用 Node.js 22.19.0 执行，完整开发依赖、dsh 构建和全量测试仍使用 Node.js 24.9+。检查使用独立用户目录与损坏 Python 目标，不下载计算依赖或调用模型；结束后删除本次临时目录。
-
-## 构建清理
-
-`clean-dist.mjs` 由 npm run build 调用，仅清理仓库内生成的 dist/，供 TypeScript 重新编译测试导入。
-
-本包不提供工作区升级命令或历史转换脚本。插件安装和更新由对应宿主的原生包管理或用户维护的源码目录负责。
+`setup-python.py` 按 `python/requirements.lock` 准备用户共享 venv。Personal Bot 加载时自动调用，也可运行独立脚本或 `/pbot python setup`。路径、依赖与排障见 [Python 说明](../python/README.md)。

package/src/dsh.ts

@@ -1,7 +1,4 @@
-import { join } from "node:path";
 import type { Context } from "@deepseek-ai/cordis";
-import * as SkillFilesystem from "@deepseek-ai/dsh-skill-filesystem";
-import { resourceRoot } from "./common/paths.js";
 import { registerDshCommand } from "./extension/dsh/command.js";
 import { registerDshManagement } from "./extension/dsh/management.js";
 import { DshWorkspaces, dshDependencies } from "./extension/dsh/workspace.js";
@@ -13,7 +10,6 @@ export const inject = ["commands", "typert", ...dshDependencies];
 export async function apply(ctx: Context) {
   const [major, minor] = process.versions.node.split(".").map(Number);
   requireThat(major! > 24 || (major === 24 && minor! >= 9), "dsh 接入需要 Node.js 24.9.0 或更新版本。");
-  await ctx.plugin(SkillFilesystem, { providerName: "pbot", includeDefaultRoots: false, bundledSkillDir: join(resourceRoot, "skills") });
   const workspaces = new DshWorkspaces(ctx);
   ctx.effect(() => () => workspaces.close());
   const management = registerDshManagement(ctx, workspaces);
@@ -22,5 +18,4 @@ export async function apply(ctx: Context) {
     if (ctx.agents.roots().includes(agent) && agent.session.header.origin !== "subagent") await workspaces.open(agent);
   });
   for (const agent of ctx.agents.roots()) if (agent.session.header.origin !== "subagent") await workspaces.open(agent);
-  void workspaces.preparePython().catch(error => ctx.logger.warn(String(error)));
 }