dir-launcher（目录快启）

思源笔记桌面端插件：在侧边栏添加面板，点击目录即用系统文件管理器打开。要求思源 ≥ 3.0.0，仅桌面端。

功能

• 内置目录：工作空间根、数据目录（data）、资产目录（data/assets）
• 私有目录：data/private 存在时自动显示一项（锁图标），不存在则静默隐藏
• 自定义目录：行式设置面板，每行 = 显示名称（可选）+ 相对工作空间的路径；行内 + 在下方插入新行，垃圾桶删除本行
• 仅相对路径：输入 data、conf/temp 这类相对路径；绝对路径输入框标红，保存时拒绝并报错，对话框保留
• 保存时解析后相同的路径自动去重并提示；全部行留空保存即清空自定义项
• 打开面板：右侧 dock 栏文件夹图标；设置入口：面板标题栏齿轮（或 设置→插件→目录快启→设置图标）
• 界面语言跟随思源（zh-CN / en）

安装

任选其一，目标目录均为 工作空间/data/plugins/dir-launcher/（目录内直接是 index.js、plugin.json 等文件），随后重启思源或在 设置 → 插件 中启用「目录快启」：

1. 仓库内置产物：仓库随源码提交最新 dist/，把 dist/ 内文件拷入目标目录，或解压 dist/package.zip
2. Releases：从 Releases 下载 package.zip 解压

开发与构建

前置：Node.js ≥ 18。

git clone https://github.com/gtiders/dir-launcher.git
cd dir-launcher
npm install

命令	作用
npm run dev	开发构建并 watch（产物在 dist/）
npm run build:dev	单次开发构建
npm run build	生产构建：压缩产物并打包 dist/package.zip
npm run deploy -- <工作空间路径>	构建 + 同步到本机思源插件目录

部署目标不写死，二选一：

npm run deploy -- D:/SiYuan            # 传参
$env:SIYUAN_WORKSPACE="D:/SiYuan"; npm run deploy   # 或环境变量（macOS/Linux 用 export）

注意：Windows 下思源内核扫描 data/plugins 时不识别目录 junction，deploy 使用真实文件拷贝，请勿将插件目录做成链接。