dsh-open-dir

通过 dsh-open <目录> 在 DSH Desktop 中创建或复用工作区, 然后打开对应会话. CLI 在界面完成导航后才报告成功. 支持 DSH >=0.2.0-rc.2 <0.3.0.

使用

先在 Desktop 的插件管理器中安装并启用 dsh-open-dir. 从源码使用时, 运行 just install, just verify, just pack, 再通过插件管理器安装生成的压缩包. Desktop 与 Web 使用独立的 profile, 需要分别安装.

仓库内可直接运行, 无需安装全局命令:

just open .
just open ~/projects/my-project
just open --no-launch .

插件包也提供 dsh-open bin. 发布到 npm 后, 若要在普通终端直接使用该命令, 可由用户选择安装 CLI 包:

pnpm add -g dsh-open-dir
# 或者 {
just pack
pnpm add -g (realpath dsh-open-dir*.tgz)
# }
dsh-open .

macOS 和 Windows 通过已注册的 dsh://open 协议唤起或前置 Desktop. 首次使用前需要启动 Desktop 一次以注册协议. 协议不可用时, 手动打开 Desktop 并使用 --no-launch.

Web 模式要求已运行的本机 Web 界面安装并启用插件, 且页面已加载:

just open --target web --no-launch .
just open --timeout 60 --verbose .

默认等待 30s, --timeout 可设为 1..300s. 同类 Host 有多个实例时, CLI 输出实例 ID, 用 --instance 明确选择. 同一个 Host 的多个页面只会有一个领取请求. 路径支持相对路径和 ~, 会解析符号链接并验证目录. 目录名以 - 开头时使用 --.

通信与诊断

Host 在回环地址上申请随机端口, 向 $DSH_HOME/runtime/dsh-open-dir 写入当前实例的发现信息. 未设置 DSH_HOME 时使用 DSH 官方默认目录. 发现文件包含随机认证令牌, 使用权限 0600, 日志不输出令牌. CLI 与宿主必须使用相同的 DSH_HOME.

CLI 提交请求后等待 Client 确认. Client 通过 DSH 的认证 API 领取请求, 调用 ctx.workspaces.create({ path }) 和 ctx.uiWorkspace.openWorkspace(workspaceId). Desktop 的 dsh-app 协议负责将 Client API 转发到 Host. 请求只交付一次, ACK 可以重试, 断线后不会自动重放导航.

导航被其他操作取消, 目录不可用, 插件卸载或界面未就绪都会以非零退出码结束. 超时表示没有收到成功确认, 不能保证界面没有发生变化. --verbose 或 NODE_DEBUG=dsh-open 可输出 CLI 阶段诊断. Host 和 Client 使用 Cordis 日志记录请求生命周期.

宿主崩溃后可能留下发现记录. CLI 通过令牌和实例身份握手忽略过期记录, 正常卸载时只移除本实例的记录.

开发

just install
just verify
just pack

源码按 Host, Client, CLI 和共享协议划分. lib/ 是构建产物, 发布和 Git 安装均直接使用, 不在安装时运行构建脚本. 测试覆盖队列交付与确认, 真实本地 HTTP 和 CLI 进程, Client 导航结果及 Loader 注册. Desktop 的实际安装和页面流程仍需在产品中验证.