初始提交：DSH 多租户平台（dshs）

poc/workspace-scoped-picker/README.md

@@ -0,0 +1,45 @@
+# @dsh-local/workspace-scoped-picker
+
+会话内「添加工作区」目录选择器：把列举/建目录的根收敛为**当前用户自有目录**（`<userRoot>/ws`），
+所有用户含 admin 一视同仁。见文档库档案 18。
+
+## 生效机制（2026-09-11 实证修订）
+
+| 尝试 | 结果 |
+|---|---|
+| bundle patch 用「同 id 换 name」覆盖官方 `directory-picker` 行 | ❌ 不生效（官方 `-auto` 行原样保留） |
+| profile `cordis.patch.yml` 用「同 id 换 name」覆盖 | ❌ 不生效（dump-config 实测未应用） |
+| **profile 层：`insert` 自建行 + 对官方行 `disabled: true`** | ✅ 采用（`disabled` 是档案 09 已验证的机制） |
+
+生效写法（写入 `<profile>/cordis.patch.yml`）：
+
+```yaml
+- insert:
+    - id: workspace-scoped-picker
+      name: "@dsh-local/workspace-scoped-picker"
+- id: directory-picker
+  name: "@deepseek-ai/dsh-host-directory-picker-auto"
+  disabled: true
+```
+
+## 安装（必须走 pnpm）
+
+```bash
+cd <profile dir>
+HOME=<userRoot>/ws pnpm add file:<userRoot>/ws/workspace-scoped-picker-0.1.0.tgz
+# 手放 node_modules 无效：pnpm-lock.yaml 才是安装账本
+```
+
+## 依赖解析
+
+唯一外部物是官方 seam 基类，用**绝对路径动态 import** 取得（不复制/不改官方包）：
+`/usr/local/lib/node_modules/@deepseek-ai/dsh/node_modules/@deepseek-ai/dsh-host-directory-picker/lib/index.js`，
+可用 `DSH_SEAM_DIRECTORY_PICKER` 覆盖。
+
+## 自检
+
+```bash
+DSH_WORKSPACE_ROOT=/tmp/picker-test node test/poc.mjs   # 26 项断言；须从实例 uid 可读的路径运行
+```
+
+> 注意：源码在 `/opt/dshs/poc/`（700 root），实例 uid 读不到 → 安装时必须**复制**到 profile。