dsh_shenxian/poc/workspace-scoped-picker/README.md

@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）：

- 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）

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 覆盖。

自检

DSH_WORKSPACE_ROOT=/tmp/picker-test node test/poc.mjs   # 26 项断言；须从实例 uid 可读的路径运行

注意：源码在 /opt/dshs/poc/（700 root），实例 uid 读不到 → 安装时必须复制到 profile。