@morlay/dsh-preset 0.0.4 → 0.0.5

package/README.md

@@ -6,12 +6,12 @@
 
 ## 内容
 
-| 文件                       | 作用                                                                                                         |
-| -------------------------- | ------------------------------------------------------------------------------------------------------------ |
-| `cordis.patch.yml`         | bundle patch：禁用官方 preset、注册本包 preset 为默认、声明个人 `llm-pi-ai` route、插入 `prompt-reminder` 行 |
-| `tool/generate-presets.ts` | 从上游生成 preset 的模块 + tsdown hooks                                                                      |
-| `dist/presets/standard/`   | 构建产物：自定义 preset「标准模式」（由上游 `standard` 生成）                                                |
-| `dist/presets/ptc/`        | 构建产物：自定义 preset「PTC 模式」（由上游 `ptc` 生成）                                                     |
+| 文件                       | 作用                                                                                                                       |
+| -------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| `cordis.patch.yml`         | bundle patch：禁用官方 preset、注册本包 preset 为默认、声明个人 `llm-pi-ai` route、覆盖沙箱规则、插入 `prompt-reminder` 行 |
+| `tool/generate-presets.ts` | 从上游生成 preset 的模块 + tsdown hooks                                                                                    |
+| `dist/presets/standard/`   | 构建产物：自定义 preset「标准模式」（由上游 `standard` 生成）                                                              |
+| `dist/presets/ptc/`        | 构建产物：自定义 preset「PTC 模式」（由上游 `ptc` 生成）                                                                   |
 
 `cordis.patch.yml` 里插入的 `prompt-reminder`（`@morlay/dsh-prompt-reminder`）把被
 裁掉的系统提示词 section 降级为 `<system-reminder>` user 消息，见「工具说明降级为
@@ -156,6 +156,22 @@ row、改字段）都自动跟随，不依赖易碎的文本锚点；上游若
 2. `pnpm --filter @morlay/dsh-preset run build`（build:done 会重新生成）
 3. `pnpm exec vitest run packages/preset` 确认无 drift（含 reminder 插件的行为测试）。
 
+## 沙箱装配与规则（部署级）
+
+本 bundle 的 `cordis.patch.yml` 里一次做完三件事：禁用官方 `sandbox` / `fs-sandbox`
+两行、插入 `- id: sandbox-local` 行、写上 `rw` / `r-` / `--` 条目（唯一真源，本 README
+不复制一份以免两处漂移）；条目语法、优先级与各平台表达能力见
+[`@morlay/dsh-sandbox-local` 的 README](../../sandbox/dsh-sandbox-local/README.md)。
+
+放本 bundle 而不是示例 app 的 `cordis.patch.yml`：bundle patch 在 dev（web / desktop）
+与打包形态都会应用，app 的 patch 只在打包时作为 seed 的 profile patch 生效。
+
+两个前置条件：
+
+- **本包的 `dependencies` 必须声明 `@morlay/dsh-sandbox-local`**：插入行的 `name` 要能在
+  profile 的依赖树里解析（profile 的 `nodeLinker: hoisted` 由本包的依赖把它带进去）。
+- **规则变化要重启**：profile 在启动时装载，`access` 在插件构造时解析（模板也是）。
+
 ## 装配
 
 `agent-presets.roots` 需指向本包的 `dist/presets/`。因为该目录随包分发，
@@ -198,6 +214,10 @@ profile 里把内容物化到该挂载点；`includeShippedRoot: false` 两种
 - `cordis.patch.yml` 插入的 `@morlay/dsh-prompt-reminder` 必须能被 **profile** 的依赖
   树解析：示例 app 已在 `dependencies` 声明；换工作区时要一并声明，否则该行加载失败、
   工具说明会留在系统提示词里。
+- 沙箱装配（禁用官方两行 + 插入 `sandbox-local` 行 + 规则）全在本 bundle 的 patch 里，
+  app 的 `dsh.profile.bundles` 不需要额外列 `@morlay/dsh-sandbox-local`；
+  `@morlay/dsh-sandbox-local` 自带的 bundle patch 供把该包作为独立 bundle 采用的部署
+  使用，与本 bundle 同时上线会重复插入同一行。
 - 生成器显式设 `quotingType: '"'`：`yaml.dump` 默认单引号而仓库 oxfmt 偏好双引号，
   不指定会让生成器与 formatter 来回改；产物在 gitignore 的 dist 里，本就不参与 fmt。
 - **dev 模式需要先构建**：`just dev` / `just desktop` / `just bundle` 都先跑

package/cordis.patch.yml

@@ -58,6 +58,30 @@
               high: high
               max: max
 
+# 沙箱装配（唯一真源，就地完成）：官方 `sandbox`（ctx.sandbox）与 `fs-sandbox`
+# （ctx.fs）两行在这里禁用，由 `@morlay/dsh-sandbox-local` 注册同名服务；规则随本
+# insert 行一起写死，不再依赖任何额外 bundle 层（漏装配时规则会静默失效，只剩
+# workspace + /tmp 可写）。
+- id: sandbox
+  disabled: true
+
+- id: fs-sandbox
+  disabled: true
+
+# 沙箱规则：`rw <path>` 追加工作区之外的可写根，`-- <pattern>` 拒绝访问（读 + 写）。
+- insert:
+    - id: sandbox-local
+      name: "@morlay/dsh-sandbox-local"
+      config:
+        access: |-
+          rw /tmp
+          rw {{ env.XDG_CACHE_HOME }}
+          rw {{ env.XDG_STATE_HOME }}
+          rw {{ env.XDG_DATA_HOME }}
+          r- {{ env.XDG_CONFIG_HOME }}
+          -- mise.*.toml
+          -- **/*.pem
+
 # 提示词分层：系统提示词只留上面的 persona，工具说明 / Agent Teams 规则 / plan
 # 规则等由该插件降级为 <system-reminder> user 消息。部署级策略，在这里定义一次
 # 即覆盖全部 preset（含子 agent），preset composition 不再各自带这一行。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@morlay/dsh-preset",
-  "version": "0.0.4",
-  "description": "Personal dsh profile bundle: disables the shipped agent presets, builds generated standard / ptc presets into dist, and declares personal llm-pi-ai provider routes.",
+  "version": "0.0.5",
+  "description": "Personal dsh profile bundle: disables the shipped agent presets, builds generated standard / ptc presets into dist, declares personal llm-pi-ai provider routes, and carries the deployment sandbox access rules.",
   "keywords": [
     "dsh",
     "dsh-bundle",
@@ -26,7 +26,8 @@
     "./cordis.patch.yml": "./cordis.patch.yml"
   },
   "dependencies": {
-    "@morlay/dsh-prompt-reminder": "^0.0.1"
+    "@morlay/dsh-prompt-reminder": "^0.0.2",
+    "@morlay/dsh-sandbox-local": "^0.0.2"
   },
   "devDependencies": {
     "@deepseek-ai/cordis-plugin-include": "^1.0.7",

package/src/__tests__/patch.spec.ts

@@ -1,6 +1,10 @@
 // 装配守卫：prompt-reminder 是 host plane 的唯一装配点。被误删 / 改名时提示词分层
 // 静默失效（工具说明回到系统提示词），这里 fail loud；persona 是 keep 名单的唯一
 // 提供者，删掉它系统提示词会变空。
+//
+// 沙箱同理：官方 `sandbox` / `fs-sandbox` 的禁用与本包 `sandbox-local` 行的插入必须在
+// 同一层——官方行还在时 `ctx.sandbox` / `ctx.fs` 由官方实现提供，access 规则没有生效点，
+// 命令照跑但规则全部失效（只剩 workspace + /tmp 可写），且没有任何报错。
 
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
@@ -9,12 +13,17 @@ import yaml from "js-yaml";
 import { describe, expect, it } from "vitest";
 
 const PATCH_PATH = join(process.cwd(), "packages/preset/dsh-preset/cordis.patch.yml");
+const UPSTREAM_BASE_PATCH = join(
+  process.cwd(),
+  "vendor/deepseek-harness/packages/bundle/base/cordis.patch.yml",
+);
 
-/** patch 的一行；只用到覆盖目标与 insert 的新增行。 */
+/** patch 的一行；只用到覆盖目标、禁用与 insert 的新增行。 */
 interface PatchRow {
   id?: string;
+  disabled?: boolean;
   config?: Record<string, unknown>;
-  insert?: { id?: string; name?: string }[];
+  insert?: { id?: string; name?: string; config?: Record<string, unknown> }[];
 }
 
 // 用 include 的 entry schema 解析：patch 里含 `!!js` 表达式，默认 schema 会拒绝。
@@ -22,14 +31,18 @@ const rows = yaml.load(readFileSync(PATCH_PATH, "utf8"), {
   schema: entryListSchema,
 }) as PatchRow[];
 
+/** 本层 insert 出来的行。 */
+const inserted = rows.flatMap((row) => row.insert ?? []);
+
+/** 本层的 `sandbox-local` 行（装配沙箱替换的那个）。 */
+const sandboxRow = inserted.find((row) => row.id === "sandbox-local");
+
 describe("dsh-preset patch wiring", () => {
   it("declares the prompt-reminder row exactly once, on the local plugin", () => {
-    const inserted = rows
-      .flatMap((row) => row.insert ?? [])
-      .filter((row) => row.id === "prompt-reminder");
+    const reminders = inserted.filter((row) => row.id === "prompt-reminder");
 
-    expect(inserted).toHaveLength(1);
-    expect(inserted[0]?.name).toBe("@morlay/dsh-prompt-reminder");
+    expect(reminders).toHaveLength(1);
+    expect(reminders[0]?.name).toBe("@morlay/dsh-prompt-reminder");
   });
 
   it("keeps the deployment persona the reminder keeps in the system prompt", () => {
@@ -38,4 +51,46 @@ describe("dsh-preset patch wiring", () => {
     expect(config?.personaPrefix).toBeTruthy();
     expect(config?.personaSuffix).toBeTruthy();
   });
+
+  it("disables the shipped sandbox rows and mounts the replacement in one layer", () => {
+    expect(rows.filter((row) => row.disabled === true).map((row) => row.id)).toEqual([
+      "sandbox",
+      "fs-sandbox",
+    ]);
+    expect(inserted.filter((row) => row.id === "sandbox-local")).toHaveLength(1);
+    expect(sandboxRow?.name).toBe("@morlay/dsh-sandbox-local");
+  });
+
+  it("names rows that still exist in the shipped base bundle", () => {
+    // 上游改名或移动这两行时，本层的 disabled 会被 include 静默跳过（warn+skip），
+    // 沙箱替换随之失效；这里对着 vendor 里的 base patch 校验一次。
+    const upstreamIds = new Set(
+      [...readFileSync(UPSTREAM_BASE_PATCH, "utf8").matchAll(/^\s*- id: (\S+)$/gm)].map(
+        (match) => match[1]!,
+      ),
+    );
+
+    for (const id of ["sandbox", "fs-sandbox"]) {
+      expect(upstreamIds.has(id), `missing upstream row: ${id}`).toBe(true);
+    }
+  });
+
+  it("carries the deployment sandbox rules on the inserted row", () => {
+    // 规则随本 bundle 分发（跨 dev / 打包形态一致），不再依赖另一层 bundle。
+    const access = sandboxRow?.config?.access;
+
+    expect(typeof access).toBe("string");
+    expect(String(access)).toContain("rw {{ env.XDG_CACHE_HOME }}");
+    expect(String(access)).toContain("rw {{ env.XDG_DATA_HOME }}");
+    expect(String(access)).toContain("-- mise.*.toml");
+    expect(String(access)).toContain("-- **/*.pem");
+  });
+
+  it("depends on the bundle whose service classes the inserted row mounts", () => {
+    const manifest = JSON.parse(
+      readFileSync(join(process.cwd(), "packages/preset/dsh-preset/package.json"), "utf8"),
+    ) as { dependencies?: Record<string, string> };
+
+    expect(manifest.dependencies?.["@morlay/dsh-sandbox-local"]).toBeTruthy();
+  });
 });