55 lines
2.5 KiB
Markdown
55 lines
2.5 KiB
Markdown
# @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** 取得（不复制/不改官方包）：
|
||
路径**按序探测**而成 —— env（`DSH_SEAM_DIRECTORY_PICKER` 显式指定，或 `DSH_PACKAGE_DIR` /
|
||
`DSHS_PACKAGE_DIR` / `DSH_COMPAT_ROOT` / `DSHS_COMPAT_ROOT` 给包根）→ 由平台配置的 dsh
|
||
可执行文件解软链反推包根（`DSHS_DSH_BIN` / `DSH_USERS_PLATFORM_DSH_BIN`）→ 常见全局根
|
||
（`/usr/local/lib/node_modules`、`/usr/lib/node_modules`）各取「嵌套 / 扁平」两种布局 →
|
||
最后兜底问一次 `npm root -g`。
|
||
|
||
⚠️ 2026-09-14 修：此前是**写死** `/usr/local/lib/node_modules/...` 两个字面量；在
|
||
`npm root -g` 落到 `/usr/lib/node_modules` 的机器（发行版包管理器装的 Node）上两个候选
|
||
**都不存在** ⇒ 本模块 import 即抛错 ⇒ 实例内目录选择器不可用（测试服已实测复现）。
|
||
平台侧同思路的另一份实现在 `src/web/dsh-install.ts`（本插件跑在实例进程内、拿不到平台代码，
|
||
故自带一份；**改一侧记得同步另一侧**）。
|
||
|
||
## 自检
|
||
|
||
```bash
|
||
DSH_WORKSPACE_ROOT=/tmp/picker-test node test/poc.mjs # 26 项断言；须从实例 uid 可读的路径运行
|
||
```
|
||
|
||
> 注意：源码在 `/opt/dshs/poc/`（700 root），实例 uid 读不到 → 安装时必须**复制**到 profile。
|