personal-bot 0.2.9 → 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/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.9",
+  "version": "0.2.10",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "personal-bot",
-      "version": "0.2.9",
+      "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
         },
@@ -4687,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.9",
+  "version": "0.2.10",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/realqiyan/personal-bot.git"
@@ -22,9 +22,7 @@
     "extensions": [
       "./src/pbot.ts"
     ],
-    "skills": [
-      "./resources/skills"
-    ],
+    "skills": [],
     "prompts": [],
     "themes": []
   },
@@ -101,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": "*",
@@ -159,6 +158,9 @@
     "@deepseek-ai/dsh-system-prompt": {
       "optional": true
     },
+    "@deepseek-ai/dsh-scope": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-skill": {
       "optional": true
     },
@@ -223,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,7 +18,7 @@ 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 配置不变。
 
 ## 失败与手工重试
 

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)));
 }

package/src/extension/command.ts

@@ -1,6 +1,6 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { packageVersion } from "../common/version.js";
-import { prepareWorkspace } from "../services/workspace/workspace-preparation.js";
+import { initializeWorkspace } from "../services/workspace/workspace-preparation.js";
 import type { Confirmations } from "../ui/confirmation.js";
 import { readPage } from "../ui/pi/reader.js";
 import { choose } from "../ui/pi/menu.js";
@@ -10,6 +10,7 @@ import type { Lifecycle } from "./lifecycle.js";
 import { showAgents } from "./agents-command.js";
 import { showTeams } from "./teams-command.js";
 import { showHistory } from "./history.js";
+import { workspaceDisabledMessage } from "../services/workspace/workspace-config.js";
 
 export function registerCommand(pi: ExtensionAPI, lifecycle: Lifecycle, confirmations: Confirmations) {
   pi.registerCommand("pbot", {
@@ -22,17 +23,30 @@ export function registerCommand(pi: ExtensionAPI, lifecycle: Lifecycle, confirma
     handler: async (args, ctx) => {
       const [, command, argument = ""] = args.trim().match(/^(\S+)(?:\s+([\s\S]*))?$/) ?? [];
       confirmations.resume();
+      if (command === "init" && !argument) {
+        await ctx.waitForIdle();
+        const start = !lifecycle.active;
+        await initializeWorkspace(lifecycle.root ?? ctx.cwd);
+        ctx.ui.notify(start ? "工作区已初始化并启用，正在加载 Personal Bot。" : "资料目录已准备；新建的 AGENTS.md 经 /reload 加载。", "info");
+        if (start) await ctx.reload();
+        return;
+      }
+      if (!lifecycle.active) {
+        const configuration = lifecycle.configuration;
+        const status = { workspaceRoot: lifecycle.root ?? ctx.cwd, release: packageVersion, enabled: false,
+          state: configuration?.error || configuration?.enabled ? "error" : "disabled",
+          nextStep: configuration?.error ?? "/pbot init", configuration };
+        ctx.ui.notify(command === "status" ? JSON.stringify(status, null, 2)
+          : configuration ? workspaceDisabledMessage(configuration) : "pbot 工作区实例不可用。", configuration?.error ? "error" : "info");
+        return;
+      }
       async function execute(command: string | undefined, argument: string) {
         const instance = lifecycle.get();
-        if (command === "init" && !argument) {
-          await ctx.waitForIdle(); instance.check(); await prepareWorkspace(instance.root);
-          ctx.ui.notify("资料目录已准备。新建的 AGENTS.md 在 /reload 或下次启动后由 Pi 加载。", "info"); return;
-        }
         if (command === "status" && !argument) {
           const python = instance.pythonEnvironment.status;
-          if (ctx.mode !== "tui") { ctx.ui.notify(JSON.stringify({ workspaceRoot: instance.root, release: packageVersion, python }, null, 2), "info"); return; }
+          if (ctx.mode !== "tui") { ctx.ui.notify(JSON.stringify({ workspaceRoot: instance.root, release: packageVersion, enabled: true, state: "running", configuration: lifecycle.configuration, python }, null, 2), "info"); return; }
           const agents = instance.agents.list(agentOwner(ctx)), history = instance.history.status;
-          await readPage(ctx, "工作区", [instance.root, "", `版本    ${packageVersion}`,
+          await readPage(ctx, "工作区", [instance.root, "", "状态    已启动", `配置    ${lifecycle.configuration?.path ?? ""}`, `版本    ${packageVersion}`,
             `模型    ${ctx.model && !(ctx.model.provider === "unknown" && ctx.model.id === "unknown") ? ctx.model.provider + "/" + ctx.model.id : "未选择"}`,
             `专家    ${agents.length} 位 · ${agents.filter(value => value.alive).length} 位存活`,
             `Python  ${stateLabel(python.state)}`, ...(python.directory ? [python.directory] : []), ...(python.error ? ["", python.error] : []),
@@ -58,7 +72,10 @@ export function registerCommand(pi: ExtensionAPI, lifecycle: Lifecycle, confirma
         const choice = await choose(ctx, `Personal Bot · Python ${stateLabel(instance.pythonEnvironment.status.state)}`, choices);
         if (!choice) return;
         const command = ["agents", "teams", "history", "status", "init", "python"][choices.indexOf(choice)]!;
-        try { await execute(command, command === "python" ? "setup" : ""); }
+        try {
+          if (command === "init") { await ctx.waitForIdle(); instance.check(); await initializeWorkspace(instance.root); ctx.ui.notify("资料目录已准备。", "info"); }
+          else await execute(command, command === "python" ? "setup" : "");
+        }
         catch (error) { ctx.ui.notify(error instanceof Error ? error.message : String(error), "error"); }
       }
     },

package/src/extension/dsh/command.ts

@@ -3,12 +3,11 @@ import type {} from "@deepseek-ai/dsh-commands";
 import { Type, type Static } from "typebox";
 import { object, json } from "../../common/json.js";
 import { requireThat, schema } from "../../common/validation.js";
-import { prepareWorkspace } from "../../services/workspace/workspace-preparation.js";
 import { executeAgent, type AgentInput } from "../../tools/agents/actions.js";
 import { dshAgentActionSchema } from "../../tools/agents/dsh-contract.js";
 import { executeTeam, executeTeamMessage } from "../../tools/teams/actions.js";
 import { teamActionSchema, teamParametersSchema, teamMessageActionSchema, teamMessageParametersSchema } from "../../tools/teams/contract.js";
-import { dshStatus, type PbotManagement } from "./management.js";
+import { dshWorkspaceStatus, type PbotManagement } from "./management.js";
 import type { DshWorkspaces } from "./workspace.js";
 
 const validAgent = schema(dshAgentActionSchema), validTeam = schema(teamActionSchema), validMessage = schema(teamMessageActionSchema);
@@ -23,20 +22,26 @@ export function registerDshCommand(ctx: Context, workspaces: DshWorkspaces, mana
     input: { hint: "status | init | python setup | agent/chat/team/post/history/records JSON", attachments: true },
     async handler({ agent, rawInput, signal, attachments, commandId }) {
       signal.throwIfAborted();
+      const command = rawInput.trim(), split = command.search(/\s/);
+      if (!command || command === "status") {
+        requireThat(!attachments.length, "状态查询不接受附件。");
+        const status = await dshWorkspaceStatus(workspaces, agent);
+        signal.throwIfAborted(); return { kind: "success", text: JSON.stringify(status, null, 2) };
+      }
+      if (command === "init") {
+        requireThat(!attachments.length, "初始化不接受附件。");
+        await workspaces.initialize(agent);
+        signal.throwIfAborted();
+        return { kind: "success", text: JSON.stringify(await dshWorkspaceStatus(workspaces, agent), null, 2) };
+      }
       const workspace = await workspaces.get(agent);
       signal.throwIfAborted();
-      const command = rawInput.trim(), split = command.search(/\s/);
       const verb = split < 0 ? command : command.slice(0, split);
       requireThat(verb === "chat" || !attachments.length, "输入框附件仅用于 chat 人工对话。");
-      if (command === "init") {
-        await prepareWorkspace(workspace.root); workspace.check();
-        return { kind: "success", text: "资料目录已准备；已有文件保留。" };
-      }
       if (command === "python setup") {
         const result = await workspaces.preparePython(); workspace.check();
         return { kind: "success", text: JSON.stringify(result, null, 2) };
       }
-      if (!command || command === "status") return { kind: "success", text: JSON.stringify(dshStatus(workspaces, workspace), null, 2) };
       requireThat(split >= 0, usage);
       const input: unknown = JSON.parse(command.slice(split));
       requireThat(object(input), "命令参数必须是 JSON 对象。");

package/src/extension/dsh/history.ts

@@ -18,9 +18,9 @@ export class DshHistoryWork {
   #closing: Promise<void> | undefined;
   constructor(private readonly ctx: Context, root: string) {
     const agents = new AgentFiles(dshHomePath("pbot", "subagents"), "dsh");
-    this.service = new HistoryService(root, new HistoryFiles(join(root, ".dsh/pbot/history"), "dsh"),
+    this.service = new HistoryService(root, new HistoryFiles(join(root, ".pbot/history"), "dsh"),
       new DshHistory(ctx, root, () => agents.list().filter(value => value.workspace === root).map(value => value.agentId)),
-      undefined, new HistoryFiles(join(root, ".pi/pbot/history")));
+      new HistoryFiles(join(root, ".pbot/history")));
   }
   attach(agent: Agent) { this.#parents.add(agent); return () => { this.#parents.delete(agent); }; }
   cancel() { this.#controller?.abort(); }

package/src/extension/dsh/management.ts

@@ -1,3 +1,4 @@
+import type { Agent } from "@deepseek-ai/dsh-agent";
 import type { Context } from "@deepseek-ai/cordis";
 import { Remote, TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
 import type {} from "@deepseek-ai/dsh-typert-registry";
@@ -25,31 +26,46 @@ const validRequest = schema(requestSchema), validExpert = schema(expertSchema),
 export function dshStatus(workspaces: DshWorkspaces, workspace: DshWorkspace): Json {
   workspace.check();
   const agents = workspace.agents.list(workspace.owner);
-  return json({ host: "dsh", release: packageVersion, workspaceRoot: workspace.root, sessionId: workspace.agent.id,
+  return json({ host: "dsh", release: packageVersion, enabled: true, state: "running", workspaceRoot: workspace.root, sessionId: workspace.agent.id,
     model: workspace.agent.model.current() ?? null, python: workspaces.python.status,
     controlError: workspace.controlError ?? null, history: workspace.history.status,
     agents, teams: workspace.teams.list(workspace.owner, agents) });
 }
 
+/** Status remains available when this workspace has not opted in. */
+export async function dshWorkspaceStatus(workspaces: DshWorkspaces, agent: Agent): Promise<Json> {
+  const { root, configuration } = await workspaces.configuration(agent);
+  if (!configuration.enabled) return json({ host: "dsh", release: packageVersion, enabled: false,
+    state: configuration.error ? "error" : "disabled", nextStep: configuration.error ? configuration.error : "/pbot init",
+    workspaceRoot: root, sessionId: agent.id, configuration, model: agent.model.current() ?? null, agents: [], teams: [] });
+  return json({ ...dshStatus(workspaces, await workspaces.get(agent)) as Record<string, Json>, configuration });
+}
+
 /** Native Remote owns transport and access checks. These workspace reads do not admit or cancel execution. */
 export class PbotManagement extends TypertRemoteService {
   constructor(ctx: Context, private readonly workspaces: DshWorkspaces) { super(ctx, "pbotManagement", { namespace: "pbot" }); }
 
-  private async workspace(request: Json, signal: AbortSignal) {
+  private parent(request: Json, signal: AbortSignal) {
     signal.throwIfAborted(); requireThat(validRequest(request), "管理查询参数无效。");
     const args = request as Static<typeof requestSchema>;
     const agent = this.ctx.agents.get(SessionId(args.parentSessionId));
     requireThat(agent, "父会话未加载或已关闭，请在原生会话页面重新打开。");
+    return { agent, input: args.input };
+  }
+
+  private async workspace(request: Json, signal: AbortSignal) {
+    const { agent, input } = this.parent(request, signal);
     const workspace = await this.workspaces.get(agent);
     signal.throwIfAborted(); workspace.check();
-    return { workspace, input: args.input, signal: AbortSignal.any([signal, workspace.lifetime.signal]) };
+    return { workspace, input, signal: AbortSignal.any([signal, workspace.lifetime.signal]) };
   }
 
   @Remote
   async snapshot(request: Json, signal: AbortSignal): Promise<Json> {
-    const { workspace, input } = await this.workspace(request, signal);
+    const { agent, input } = this.parent(request, signal);
     requireThat(input === undefined, "工作区状态查询不接受额外参数。");
-    return dshStatus(this.workspaces, workspace);
+    const status = await dshWorkspaceStatus(this.workspaces, agent);
+    signal.throwIfAborted(); return status;
   }
 
   @Remote

package/src/extension/dsh/workspace.ts

@@ -18,6 +18,10 @@ import { registerDshHistoryTool } from "../../tools/history/dsh-tool.js";
 import { activatePython } from "../../integrations/python-activation.js";
 import { PythonEnvironmentService } from "../../services/workspace/python-environment-service.js";
 import { requireThat } from "../../common/validation.js";
+import { registerDshSkills } from "../../integrations/dsh/skills.js";
+import { readWorkspaceConfig, workspaceDisabledMessage } from "../../services/workspace/workspace-config.js";
+import type { WorkspaceConfiguration } from "../../model/workspace-config.js";
+import { initializeWorkspace } from "../../services/workspace/workspace-preparation.js";
 
 export const dshDependencies = ["agents", "sessions", "sessionPersistence", "sessionQuery", "llm", "tools", "systemPrompt", "skills", "fs", "attachments", "workingDirectory", "approval"];
 
@@ -45,6 +49,7 @@ export class DshWorkspace {
             { check: this.check, release: () => this.host.release(d.agentId, generation) });
           this.#experts.set(d.agentId, runtime);
           scope.effect(() => () => { if (this.#experts.get(d.agentId) === runtime) this.#experts.delete(d.agentId); });
+          registerDshSkills(scope, child);
           await dshResources(scope, child, root, "general-purpose", () => python.status, runtime.check);
           const teamTool = dshExpertTools(scope, child, d.options);
           if (teamTool) registerDshTeamMessageTool(scope, child, this.teams, runtime.actor, runtime.check);
@@ -67,6 +72,7 @@ export class DshWorkspace {
   async open() {
     this.check();
     this.#scope = await this.agent.ctx.plugin({ name: "pbot-coordinator", inject: dshDependencies, apply: async ctx => {
+      registerDshSkills(ctx, this.agent);
       await dshResources(ctx, this.agent, this.root, "coordinator", () => this.python.status, this.check);
       registerDshFileEvents(ctx, this.agent, this.root, false, this.check);
       registerDshAgentTool(ctx, this.agent, this.agents, this.owner, this.check);
@@ -108,7 +114,9 @@ export class DshWorkspace {
 /** The execution component owns Python; closing one Session must not undo its activation. */
 export class DshWorkspaces {
   readonly python = new PythonEnvironmentService(process.cwd());
-  readonly #parents = new Map<Agent, Promise<DshWorkspace>>();
+  readonly #parents = new Map<Agent, Promise<DshWorkspace | undefined>>();
+  readonly #initializing = new Map<string, Promise<void>>();
+  readonly #configurations = new Map<Agent, { root: string; configuration: WorkspaceConfiguration }>();
   readonly #parentEffects = new Map<Agent, () => Promise<void>>();
   readonly #histories = new Map<string, { work: DshHistoryWork; users: number }>();
   readonly #lifetime = new AbortController();
@@ -144,16 +152,29 @@ export class DshWorkspaces {
     const opening = (async () => {
       const root = await realpath(agent.session.header.cwd ?? process.cwd());
       this.#lifetime.signal.throwIfAborted();
+      const configuration = await readWorkspaceConfig(root);
+      this.#lifetime.signal.throwIfAborted();
+      this.#configurations.set(agent, { root, configuration });
+      if (!configuration.enabled) {
+        if (configuration.error) this.ctx.logger.warn(configuration.error);
+        const dispose = agent.ctx.effect(() => () => {
+          this.#parents.delete(agent); this.#configurations.delete(agent); this.#parentEffects.delete(agent);
+        });
+        this.#parentEffects.set(agent, dispose);
+        return undefined;
+      }
       const history = await this.history(root);
       let workspace: DshWorkspace | undefined;
       try {
         workspace = new DshWorkspace(this.ctx, root, agent, this.python, this.#lifetime.signal, history.work, history.release);
         const owned = workspace;
         const dispose = agent.ctx.effect(() => async () => {
-          this.#parents.delete(agent); this.#parentEffects.delete(agent); await owned.close();
+          this.#parents.delete(agent); this.#configurations.delete(agent); this.#parentEffects.delete(agent); await owned.close();
         });
         this.#parentEffects.set(agent, dispose);
-        await workspace.open(); this.#lifetime.signal.throwIfAborted(); return workspace;
+        await workspace.open(); this.#lifetime.signal.throwIfAborted();
+        void this.preparePython().catch(error => this.ctx.logger.warn(String(error)));
+        return workspace;
       } catch (error) {
         try {
           const dispose = this.#parentEffects.get(agent);
@@ -171,10 +192,45 @@ export class DshWorkspaces {
     this.#lifetime.signal.throwIfAborted();
     requireThat(this.ctx.agents.get(agent.id) === agent, "父会话已关闭。");
     const workspace = await this.open(agent);
+    const configuration = this.#configurations.get(agent)?.configuration;
+    requireThat(workspace, configuration ? workspaceDisabledMessage(configuration) : "pbot 工作区实例不可用。");
     workspace.check();
     return workspace;
   }
 
+  async configuration(agent: Agent) {
+    this.#lifetime.signal.throwIfAborted();
+    requireThat(this.ctx.agents.get(agent.id) === agent, "父会话已关闭。");
+    await this.open(agent);
+    this.#lifetime.signal.throwIfAborted();
+    const current = this.#configurations.get(agent);
+    requireThat(current && this.ctx.agents.get(agent.id) === agent, "父会话已关闭。");
+    return current;
+  }
+
+  async initialize(agent: Agent): Promise<DshWorkspace> {
+    const { root } = await this.configuration(agent);
+    let pending = this.#initializing.get(root);
+    if (!pending) {
+      pending = (async () => {
+        await initializeWorkspace(root);
+        this.#lifetime.signal.throwIfAborted();
+        const configuration = await readWorkspaceConfig(root);
+        for (const [parent, current] of [...this.#configurations]) {
+          if (current.root !== root || this.ctx.agents.get(parent.id) !== parent) continue;
+          const workspace = await this.#parents.get(parent);
+          if (workspace) { this.#configurations.set(parent, { root, configuration }); continue; }
+          await this.#parentEffects.get(parent)?.();
+          await this.open(parent);
+        }
+      })();
+      this.#initializing.set(root, pending);
+    }
+    try { await pending; }
+    finally { if (this.#initializing.get(root) === pending) this.#initializing.delete(root); }
+    return this.get(agent);
+  }
+
   preparePython() {
     this.#lifetime.signal.throwIfAborted();
     if (this.#preparing) return this.#preparing;
@@ -192,14 +248,15 @@ export class DshWorkspaces {
     this.#lifetime.abort();
     this.#closing = (async () => {
       try {
+        await Promise.allSettled(this.#initializing.values());
         const opened = await Promise.allSettled(this.#parents.values());
-        const closed = await Promise.allSettled(opened.filter(v => v.status === "fulfilled").map(v => v.value.close()));
+        const closed = await Promise.allSettled(opened.flatMap(value => value.status === "fulfilled" && value.value ? [value.value.close()] : []));
         const effects = await Promise.allSettled([...this.#parentEffects.values()].map(dispose => dispose()));
         const histories = await Promise.allSettled([...this.#histories.values()].map(value => value.work.close()));
         await this.python.close();
         const errors = [...new Set([...closed, ...effects, ...histories].flatMap(value => value.status === "rejected" ? [value.reason] : []))];
         if (errors.length) throw new AggregateError(errors, "部分 dsh 工作区未能完成关闭。");
-      } finally { this.#parents.clear(); this.#parentEffects.clear(); this.#histories.clear(); this.#restorePython?.(); this.#restorePython = undefined; }
+      } finally { this.#parents.clear(); this.#configurations.clear(); this.#parentEffects.clear(); this.#histories.clear(); this.#restorePython?.(); this.#restorePython = undefined; }
     })();
     return this.#closing;
   }