Overview
@local/dsh-plugin-dream
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
- **路径不做沙箱**:`sourceDir` / `outDir` / `personaPath` 是什么就能读写什么。这是本地工具,配置由你掌握;不要指向不可信的目录。 - **提示注入**:素材内容会进入 prompt。压缩结果做了长度与字符校验,但自由文本无法彻底消毒;不要把来路不明的 md 放进 `sourceDir`。单靠一个 md 拿不到你的环境变量或 API key(没有工具授权、重试次数固定)。 - **来源边界**:只读 `sourceDir` 下匹配 `sourceGlob` 的**普通文件**;不递归;目录里的符号链接条目会被 `isFile()` 跳过,但 `sourceDir` 本身若是指向别处的链接,会照着读。 - **资源预算**:枚举最多 2000 条、成功读取最多 500 个文件、单文件 1 MiB、合计 20 MiB、候选 5000 条。文件按**限量读取**处理(最多分配到上限 +1 字节,这一个探测字节是已声明的开销);被拒绝、甚至读一半报错的字节都计入实际预算;达到上限后不再接纳新文件并打 warning。 - **长度容差**:目标区间是 150–250 / 250–400 / 600–1000 字,检查器另留约 20% 容差(standard 最多约 480 字),超过才算废稿。 - **文件名匹配不接正则**:只认 glob(`*` / `?`,最多 5 个模式、每个 ≤64 字符),用双指针匹配,复杂度受控;配置里出现旧的 `sourcePattern` 会**直接报错**,不会静默忽略。 - **默认工作区**:没配 workspace 时,相对路径以**进程工作目录**为基准,它不一定等于 DSH 的活跃工作区。如果 /dream 报找不到素材目录,请显式设置 sourceDir(或 workspace)。 - Windows 上如果环境变量读不到,会去注册表 `HKCU\Environment` 再读一次(其他平台没有这一步)。
