dsh-at-file-everything 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 leaf
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and 
+associated documentation files (the "Software"), to deal in the Software without restriction, including 
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the 
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial 
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT 
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO 
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER 
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE 
+USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,214 @@
-# Temporary Holding Version
+# dsh-at-file-everything
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Instant `@file` completion for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) on Windows, answered from the [Everything](https://www.voidtools.com/) search index through `es.exe`.
+
+> 中文说明见 [README.zh.md](README.zh.md)。
+
+## Why
+
+The shipped `@deepseek-ai/dsh-file-reference-local` provider answers `@` from a workspace walk it performs itself, bounded by `maxEntries`. In a large tree that walk is both slow and lossy. On the Unity project this plugin was written for:
+
+| | upstream walk | this plugin |
+|---|---|---|
+| what it searches | every file under the workspace root | Everything's index, scoped with `-path` |
+| entry budget | `maxEntries` (50 000 by default) | none |
+| first `@` of a session | full traversal | ~80 ms |
+| warm query | re-ranks a bounded index | ~70–80 ms |
+| coverage | ~469 k of ~1.5 M files, after tuning | the whole scope |
+| heap | ~99 MB for the index | none held by the provider |
+
+A concrete failure the upstream budget caused: ~1.2 M files under `Library/` and ~270 k under `Output/` exhausted the index before any `Assets/` source was reached, so `@PlayablePrefab` answered `Library/*` noise while the real file was missing. Everything already maintains that index machine-wide as a Windows service, so this provider answers from it and walks nothing.
+
+## Install
+
+```powershell
+# once per machine (see "Why es.exe is not bundled" below)
+winget install voidtools.Everything
+winget install voidtools.Everything.Cli
+
+# once per profile
+dsh plugin --profile <profile> add dsh-at-file-everything
+```
+
+The bundled `cordis.patch.yml` then:
+
+1. inserts the `file-reference-everything` row (this plugin), and
+2. disables `file-reference-local`, so exactly one owner provides `ctx.fileReferences`.
+
+Restart the Harness profile afterwards. Nothing else in the composition changes: the Session Controller's `fileReferences/list` Remote and the Web composer keep resolving the same service.
+
+The published tarball ships the built `lib/`, so there is nothing to compile first.
+
+### From a local checkout
+
+While developing, install this repository directly instead:
+
+```powershell
+dsh plugin --profile <profile> add link:<path to this repository>
+```
+
+> **Updating a `link:` install.** Under this profile's pnpm settings a `link:` dependency is materialised as a *copy*, not a symlink, so rebuilding `lib/` is not enough — the installed copy keeps serving the old bundle until you re-run `dsh plugin --profile <profile> add link:<path>` (or delete `<profile>/node_modules/dsh-at-file-everything` and re-add it). This bites during development: the plugin can look like it ignored a change.
+
+## Requirements
+
+- **Windows.** The plugin declares `os: win32`; on other platforms Everything does not exist and the plugin has nothing to answer from.
+- **Everything 1.4+ running and indexing.** The plugin queries it; it does not bundle or start it.
+- **`es.exe` v1.1.0+ on `PATH`**, or `esCommand` pointing at it.
+
+Check the environment before blaming the plugin:
+
+```powershell
+es -get-everything-version   # the Everything service answering
+es -version                  # the command-line client
+```
+
+### Why `es.exe` is not bundled
+
+Bundling it does not make the plugin install-and-go, because `es.exe` is only the *client* half of Everything. It talks to the Everything service over its IPC window, and without that service it answers:
+
+```
+Error 8: Everything IPC window not found. Please make sure Everything is running.
+```
+
+So even with a copy vendored into this package, the user still has to install Everything, keep it running, and let it index the drives they care about — the part that actually makes `@file` work. A bundled client also silently drifts from the user's service, because Everything's IPC and index format are upgraded together with the service while a pinned client is frozen at release time.
+
+The honest install story is therefore two commands, in this order:
+
+```powershell
+winget install voidtools.Everything          # the service and its index
+winget install voidtools.Everything.Cli      # es.exe on PATH
+```
+
+If a deployment wants to vendor `es.exe` anyway — an offline image, a locked-down machine — point `esCommand` at the copy you shipped. An explicit `esCommand` always wins over `PATH`, and nothing else needs to change:
+
+```yaml
+    esCommand: 'C:\Program Files\MyImage\tools\es.exe'
+```
+
+`es.exe` itself is MIT-licensed (its `cli.c` carries the permission notice), so vendoring is permitted; it is simply not *sufficient*, which is why this package does not pretend otherwise.
+
+## Configuration
+
+```yaml
+- id: file-reference-everything
+  name: dsh-at-file-everything
+  config:
+    esCommand: es.exe
+    maxResults: 20
+    maxCandidates: 300
+    timeoutMs: 3000
+    fuzzyFallback: true
+    excludedDirectories: [.git, node_modules, Library, Temp, Output]
+    extraPathDirectories: []
+    installPrompt: true
+```
+
+| Field | Default | Meaning |
+|---|---|---|
+| `esCommand` | `es.exe` | Executable name or absolute path. A bare name resolves through `PATH`. |
+| `maxResults` | `20` | Ranked candidates returned for one query. |
+| `maxCandidates` | `300` | Rows requested from Everything before ranking. Raising this costs roughly linearly (measured ≈ +0.3 ms/row on a 470 k-entry tree). |
+| `timeoutMs` | `3000` | Per-`es.exe` deadline. A timeout degrades to an empty completion list, never to an error in the composer. |
+| `fuzzyFallback` | `true` | When a contiguous search matches nothing, retry as a subsequence (`pbin` → `PlayButton`). |
+| `excludedDirectories` | build/VCS defaults | Directory **basenames** filtered out of results. Case-insensitive. A *file* named `build` is not excluded. |
+| `extraPathDirectories` | `[]` | Prepended to the child `PATH`, for a portable Everything install. |
+| `installPrompt` | `true` | Contribute the seam's `@path` guidance while the agent can call `read`. |
+
+For a Unity project, add the generated trees:
+
+```yaml
+    excludedDirectories:
+      - .git
+      - node_modules
+      - Library
+      - Temp
+      - obj
+      - Logs
+      - UserSettings
+      - Output
+      - Publish
+      - .vs
+```
+
+Keep `Export/` searchable if its build trees matter to you.
+
+## Behaviour
+
+`@` opens completion; typing filters; picking inserts an ordinary `@path` mention. A directory candidate keeps the quote open with a trailing slash so completion can descend another level. Selecting a file never reads its contents — the model still has to call `read`.
+
+- **Bare query** (`@Archive`) searches the whole working directory.
+- **Directory query** (`@Assets/Scripts/`) lists that one directory, one cheap lookup per level.
+- **Exclusion** is a filter over returned rows, so excluded trees cost nothing at query time.
+- **Hidden entries** stay out of results until the query itself starts with `.`.
+- **Scoped to the working directory.** A bare query carries `-path <cwd>` and every result is re-checked against the root before it is rendered, so nothing outside the workspace can appear. Directory descent is guarded too: `@../sibling/` or `@D:\elsewhere\` resolves outside the root and answers nothing rather than listing another tree. This matters on machines that hold several copies of the same project — one workspace can never surface or select a file from another.
+
+Ranking reproduces the upstream tiers exactly, so switching providers does not change which file a keystroke sequence selects: exact basename > prefix > substring > directory-segment > subsequence, directories before files at equal scores, then shorter paths, then code-unit order.
+
+## How it works
+
+Three properties of `es.exe`, each established by probing the real client, shape the implementation:
+
+1. **Every argv element is an independent AND-ed term.** A single argument containing spaces (`"package json"`) matches nothing, while `package` and `json` match `package.json`. Terms are never space-joined, and a literal space inside a pattern becomes `?`.
+2. **Everything indexes file names by default; `-p` widens a term to the full path.** Filename matching is also the fast path: the wildcard form answers in ~70–150 ms on a 470 k-entry workspace, whereas a `regex:` term over the full path costs 0.6–44 s because it scans the whole index. Queries therefore stay filename-scoped, and `-path` supplies the scoping.
+3. **Standard output is not UTF-8.** `es.exe` writes results in the process ANSI/OEM code page, so CJK and kana names arrive as mojibake on a zh-CN host. The only code-page-independent channel is `-export-csv <file>` with `-utf8-bom`, which writes real UTF-8 to a file the plugin owns. It costs about as much as stdout (~110 ms vs ~100 ms), so every query takes it.
+
+Directory-versus-file comes from the exported `Attributes` column (`D` = directory), avoiding a second filesystem round trip.
+
+## Verify
+
+```powershell
+npm run typecheck   # strict TS over src/
+npm run test        # unit + live es.exe integration
+```
+
+The unit suite runs anywhere. The live suite creates a fixture under `%TEMP%`, waits for Everything to index it, and checks directory classification, root scoping, UTF-8 decoding of CJK names, spaced names, the subsequence tier, empty results, and cancellation. It skips itself when `es.exe` is absent.
+
+`test/` is deliberately independent of the Harness installation; the pure helpers live in `src/pure.ts` and build to `lib/pure.js` for that reason.
+
+## Package layout
+
+```
+src/index.ts      plugin, service class, config schema
+src/es-client.ts  es.exe adapter: spawn, export, decode, timeouts
+src/candidates.ts pure ranking and path normalisation
+src/pure.ts       Harness-free entry for tests and reuse
+cordis.patch.yml  bundle layer: insert this row, disable file-reference-local
+assets/           storefront icon and its licence record
+scripts/make-icon.py  renders assets/icon-{180,256,512}.png from icon-256.png
+```
+
+`@deepseek-ai/*` imports stay external in the bundle: the host resolves those from the installation, and inlining them would give this plugin a second Cordis `Service` class identity.
+
+## Icon
+
+`assets/icon-{180,256,512}.png` is voidtools' Everything magnifying-glass icon.
+Everything — icon included — is MIT-licensed (Copyright (c) 2022 voidtools), so
+reuse is permitted as long as the notice travels with the asset; it does, in
+[assets/ICON-LICENSE.txt](assets/ICON-LICENSE.txt). Re-render the sizes with:
+
+```powershell
+python scripts/make-icon.py
+```
+
+Storefronts (the awesome-dsh-plugin list, dsh-market) pick it up from the
+catalog entry:
+
+```yaml
+icon: https://raw.githubusercontent.com/backkom/dsh-at-file-everything/master/assets/icon-180.png
+```
+
+That list only accepts icons hosted on GitHub as `png`/`jpg`/`jpeg`/`webp`, and
+draws the tile at ~96px, so a square raster is the shape that works. The default
+branch here is `master`; if it is ever renamed, that URL has to change with it.
+
+## Limitations
+
+- **Windows only**, and only as good as the Everything index. Files excluded from indexing are invisible here too.
+- **Everything must be running.** If the service is down the plugin logs a warning and completion answers nothing; `@` does not fall back to a filesystem walk.
+- **Filename-scoped search.** Typing a directory path with `/` lists that directory, but a bare query will not match deep path fragments that no file name contains — the upstream substring path match was traded for the ~30× latency of the index path.
+- **One `es.exe` process per keystroke.** Each query is a fresh process (~70–80 ms warm). Cancellation kills it.
+- **First query after Everything's index is cold** can take ~1 s as the service pages the index in.
+
+## Licence
+
+MIT. See [LICENSE](LICENSE).

package/README.zh.md

@@ -0,0 +1,205 @@
+# dsh-at-file-everything
+
+为 Windows 上的 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 提供秒级的 `@文件` 补全，数据来自 [Everything](https://www.voidtools.com/) 的索引，经 `es.exe` 查询。
+
+> English documentation: [README.md](README.md)。
+
+## 为什么需要它
+
+Harness 自带的 `@deepseek-ai/dsh-file-reference-local` 会自己遍历工作区，并按 `maxEntries` 截断。在大仓库里这种遍历既慢又有损。以本插件所针对的 Unity 工程为例：
+
+| | 上游遍历方案 | 本插件 |
+|---|---|---|
+| 检索对象 | 工作区根目录下的每个文件 | Everything 索引，用 `-path` 限定范围 |
+| 条目上限 | `maxEntries`（默认 50 000） | 无 |
+| 会话里第一次 `@` | 完整遍历 | ~80 ms |
+| 后续查询 | 在有限索引里重排 | ~70–80 ms |
+| 覆盖范围 | 调优后约 46.9 万 / 约 150 万 | 整个限定范围 |
+| 占用堆内存 | 索引约 99 MB | 插件不持有 |
+
+上游上限造成的真实故障：`Library/` 下约 120 万文件、`Output/` 下约 27 万文件，在校验触达 `Assets/` 源码之前就把索引额度耗尽，于是 `@PlayablePrefab` 只返回 `Library/*` 的噪声，真正的文件反而搜不到。Everything 本身就以 Windows 服务的形式维护着全机索引，因此本插件直接查它，不做任何遍历。
+
+## 安装
+
+```powershell
+# 每台机器装一次（原因见下方「为什么不内置 es.exe」）
+winget install voidtools.Everything
+winget install voidtools.Everything.Cli
+
+# 每个 profile 装一次
+dsh plugin --profile <profile> add dsh-at-file-everything
+```
+
+随包提供的 `cordis.patch.yml` 会：
+
+1. 插入 `file-reference-everything` 行（即本插件）；
+2. 禁用 `file-reference-local`，保证 `ctx.fileReferences` 只有一个提供者。
+
+之后重启该 Harness profile。组合中的其他部分无需改动：Session Controller 的 `fileReferences/list` Remote 与 Web 输入框仍然解析同一个服务。
+
+发布包自带已构建的 `lib/`，不需要你本地先编译。
+
+### 从本地代码库安装
+
+开发阶段可以直接指向本仓库：
+
+```powershell
+dsh plugin --profile <profile> add link:<本仓库路径>
+```
+
+> **更新 `link:` 安装时注意。** 在本 profile 的 pnpm 设置下，`link:` 依赖是被**复制**进去的，不是符号链接。因此只重新构建 `lib/` 不够——已安装的那份会继续跑旧代码，必须重新执行 `dsh plugin --profile <profile> add link:<本仓库路径>`（或先删掉 `<profile>/node_modules/dsh-at-file-everything` 再装）。开发时很容易被这一点误导，以为改动没生效。
+
+## 前置条件
+
+- **Windows。** 插件声明 `os: win32`；其他平台上没有 Everything，也就没有答案来源。
+- **Everything 1.4+ 正在运行并已建立索引。** 插件只查询它，不捆绑、不启动它。
+- **`es.exe` v1.1.0+ 在 `PATH` 上**，或用 `esCommand` 指定路径。
+
+排查前先确认环境：
+
+```powershell
+es -get-everything-version   # Everything 服务是否在应答
+es -version                  # 命令行客户端是否可用
+```
+
+### 为什么不内置 es.exe
+
+内置它并不能做到「装完即用」，因为 `es.exe` 只是 Everything 的**客户端**。​它要通过 IPC 窗口和服务通信，服务不在时它会直接报：
+
+```
+Error 8: Everything IPC window not found. Please make sure Everything is running.
+```
+
+也就是说，即使把一份 `es.exe` 打进包里，用户仍然必须安装 Everything、让它常驻、并让它索引目标磁盘——而这几件事才是让 `@file` 真正可用的部分。​另外，随包固定的客户端会和服务**悄悄脱节**：Everything 的 IPC 与索引格式随服务一起升级，而插件里那份是冻结在发布时的。​
+
+所以诚实的安装步骤就是上面两条命令，顺序不能反。​如果确实需要自行分发（离线镜像、受限机器），把 `esCommand` 指向你随包放的那份即可——显式 `esCommand` 永远优先于 `PATH`，其他都不用改：
+
+```yaml
+    esCommand: 'C:\Program Files\MyImage\tools\es.exe'
+```
+
+`es.exe` 本身是 MIT 许可（安装目录里的 `cli.c` 带有许可声明），所以自行分发是被允许的；它只是**不够**——这也是本包不假装相反的原因。​
+
+## 配置
+
+```yaml
+- id: file-reference-everything
+  name: dsh-at-file-everything
+  config:
+    esCommand: es.exe
+    maxResults: 20
+    maxCandidates: 300
+    timeoutMs: 3000
+    fuzzyFallback: true
+    excludedDirectories: [.git, node_modules, Library, Temp, Output]
+    extraPathDirectories: []
+    installPrompt: true
+```
+
+| 字段 | 默认值 | 含义 |
+|---|---|---|
+| `esCommand` | `es.exe` | 可执行文件名或绝对路径；写文件名时按 `PATH` 查找。 |
+| `maxResults` | `20` | 单次查询返回的候选数量。 |
+| `maxCandidates` | `300` | 排序前向 Everything 请求的行数。调高基本线性增加耗时（在 47 万条目上实测约 +0.3 ms/行）。 |
+| `timeoutMs` | `3000` | 单次 `es.exe` 超时。超时只会让补全结果为空，不会在输入框里报错。 |
+| `fuzzyFallback` | `true` | 连续子串匹配不到时，改用子序列重试（`pbin` → `PlayButton`）。 |
+| `excludedDirectories` | 构建/版本控制目录 | 按目录**名**过滤结果，大小写不敏感。名为 `build` 的**文件**不受影响。 |
+| `extraPathDirectories` | `[]` | 追加到子进程 `PATH` 前面，用于便携版 Everything。 |
+| `installPrompt` | `true` | Agent 能调用 `read` 时，注入 seam 约定的 `@path` 说明。 |
+
+Unity 工程建议补上生成目录：
+
+```yaml
+    excludedDirectories:
+      - .git
+      - node_modules
+      - Library
+      - Temp
+      - obj
+      - Logs
+      - UserSettings
+      - Output
+      - Publish
+      - .vs
+```
+
+如果 `Export/` 下的构建产物需要可搜，就不要排除它。
+
+## 行为
+
+`@` 打开补全，继续输入即过滤，选中后插入普通的 `@path` 文本。目录候选会保留尾斜杠的引号形式，以便继续向下钻取。选中文件**不会**读取内容——模型仍需自行调用 `read`。
+
+- **裸查询**（`@Archive`）：搜索整个工作目录。
+- **目录查询**（`@Assets/Scripts/`）：只列该目录，每层一次很便宜的查询。
+- **排除**是对返回行的过滤，因此被排除的目录在查询时零成本。
+- **隐藏项**：查询本身以 `.` 开头之前，不会出现在结果里。
+- **严格限定在工作目录内。** 裸查询带 `-path <cwd>`，每条结果在渲染前还会按根目录再校验一次，工作区之外的内容不会出现。目录下钻同样有守卫：`@../sibling/`、`@D:\elsewhere\` 会解析到根目录之外，此时返回空而不是列出另一棵树。这对同一工程存在多份副本的机器很关键——一个工作区永远看不到、也选不中另一个工作区的文件。
+
+排序完整复刻上游的分档，因此换用本插件不会改变某个按键序列最终选中的文件：全名精确 > 前缀 > 子串 > 目录段 > 子序列；同分时目录优先于文件，其次路径更短者优先，最后按码位排序。
+
+## 实现要点
+
+`es.exe` 的三条行为决定了实现，每条都由实测真实客户端得出：
+
+1. **每个 argv 元素都是独立的、以 AND 相连的检索词。** 单个参数里带空格（`"package json"`）什么也匹配不到，而 `package`、`json` 两个参数能匹配到 `package.json`。因此检索词绝不拼接空格，模式里的字面空格改用 `?` 表示。
+2. **Everything 默认只索引文件名；`-p` 才把检索词扩展到完整路径。** 文件名匹配同时是快路径：通配符形式在 47 万条目的工作区上约 70–150 ms，而全路径的 `regex:` 会扫描整个索引，需要 0.6–44 s。因此查询保持在文件名范围，范围限定交给 `-path`。
+3. **标准输出不是 UTF-8。** `es.exe` 按进程 ANSI/OEM 代码页输出，在中文系统上 CJK 与假名会变成乱码。唯一与代码页无关的通道是 `-export-csv <文件>` 配 `-utf8-bom`，它把真正的 UTF-8 写进插件自己掌握的文件。它和 stdout 开销相近（约 110 ms 对 100 ms），所以每次查询都走这条路。
+
+目录与文件的区分来自导出的 `Attributes` 列（含 `D` 即目录），省去一次文件系统往返。
+
+## 验证
+
+```powershell
+npm run typecheck   # 对 src/ 做严格 TS 检查
+npm run test        # 单元测试 + 真实 es.exe 集成测试
+```
+
+单元测试在任何机器上都能跑。集成测试在 `%TEMP%` 下建一棵夹具树，等 Everything 索引后验证：目录识别、根范围限定、CJK 文件名解码、含空格文件名、子序列匹配、空结果与取消。缺少 `es.exe` 时自动跳过。
+
+`test/` 刻意不依赖 Harness 安装：纯逻辑放在 `src/pure.ts`，单独打包成 `lib/pure.js` 就是为了这一点。
+
+## 目录结构
+
+```
+src/index.ts      插件、服务类、配置 schema
+src/es-client.ts  es.exe 适配层：spawn、导出、解码、超时
+src/candidates.ts 纯排序与路径归一
+src/pure.ts       不含 Harness 依赖的入口，供测试与复用
+cordis.patch.yml  打包层：插入本行，禁用 file-reference-local
+assets/           市场图标及其许可记录
+scripts/make-icon.py  由 icon-256.png 渲染 assets/icon-{180,256,512}.png
+```
+
+`@deepseek-ai/*` 在打包时保持 external：由宿主从安装目录解析；若内联，本插件会得到第二份 Cordis `Service` 类身份。
+
+## 图标
+
+`assets/icon-{180,256,512}.png` 用的是 voidtools「Everything」的放大镜图标。
+Everything（含图标）以 MIT 授权发布（Copyright (c) 2022 voidtools），因此复用
+是允许的，唯一条件是许可声明随资产一起分发——声明在
+[assets/ICON-LICENSE.txt](assets/ICON-LICENSE.txt)。重新渲染各尺寸：
+
+```powershell
+python scripts/make-icon.py
+```
+
+市场（awesome-dsh-plugin 列表、dsh-market）从目录条目里取图：
+
+```yaml
+icon: https://raw.githubusercontent.com/backkom/dsh-at-file-everything/master/assets/icon-180.png
+```
+
+该列表只接受托管在 GitHub 的 `png`/`jpg`/`jpeg`/`webp`，卡片按约 96px 显示，
+所以方形位图最合适。本仓库默认分支是 `master`；若日后改名，这个 URL 要同步改。
+
+## 已知限制
+
+- **仅 Windows**，且效果取决于 Everything 的索引范围。未纳入索引的文件同样搜不到。
+- **必须让 Everything 保持运行。** 服务停掉时插件只记录一条警告、补全返回空，不会退回到文件系统遍历。
+- **检索限定在文件名。** 带 `/` 的查询会列出该目录，但裸查询匹配不到「文件名里不含、只在深层路径里出现」的片段——这是用上游的路径子串匹配换来了索引路径约 30 倍的提速。
+- **每次按键一个 `es.exe` 进程。** 每次查询都是新进程（预热后约 70–80 ms），取消会杀掉它。
+- **Everything 索引处于冷态时**，首次查询可能需要约 1 s 让服务把索引换入。
+
+## 许可
+
+MIT，见 [LICENSE](LICENSE)。

package/assets/ICON-LICENSE.txt

@@ -0,0 +1,55 @@
+Icon: Everything application icon
+Source repository: https://github.com/backkom/dsh-at-file-everything
+Asset files: assets/icon-180.png, assets/icon-256.png, assets/icon-512.png
+
+--------------------------------------------------------------------------
+Upstream
+--------------------------------------------------------------------------
+
+The icon is voidtools' "Everything" application icon (a magnifying glass).
+The 256x256 copy used as the source was extracted from the Everything
+application binaries (version 1.4.1.1026) and is distributed at
+
+    https://commons.wikimedia.org/wiki/File:Everything_(software)_icon.png
+
+Author / copyright holder: David Carpenter (voidtools), developer of
+"Everything".
+
+--------------------------------------------------------------------------
+Licence
+--------------------------------------------------------------------------
+
+Everything, including this icon, is licensed under the MIT licence. The
+permission notice shipped with the application (License.txt in the
+Everything install directory, and https://www.voidtools.com/License.txt)
+reads:
+
+    Everything
+
+    Copyright (c) 2022 voidtools
+
+    Permission is hereby granted, free of charge, to any person obtaining a
+    copy of this software and associated documentation files (the
+    "Software"), to deal in the Software without restriction, including
+    without limitation the rights to use, copy, modify, merge, publish,
+    distribute, sublicense, and/or sell copies of the Software, and to
+    permit persons to whom the Software is furnished to do so, subject to
+    the following conditions:
+
+    The above copyright notice and this permission notice shall be included
+    in all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+    OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+    MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+    IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+    CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+    TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+    SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+That notice is reproduced here to satisfy its one condition. The resized
+derivatives were produced by scripts/make-icon.py.
+
+"Everything" is voidtools' product name. This icon is used descriptively, to
+identify that this plugin answers file completion from the Everything index;
+this plugin is not affiliated with or endorsed by voidtools.

package/cordis.patch.yml

@@ -0,0 +1,25 @@
+# Bundle patch layer for dsh-at-file-everything.
+#
+# The row loads this package's main entry as the host half (a Cordis plugin that
+# provides `ctx.fileReferences` from the Everything index).
+#
+# `file-reference-local` is disabled rather than left mounted: Cordis refuses two
+# providers of one service name in a scope, and the shipped provider would
+# otherwise win or lose the registration by load order. Disabling it here keeps
+# exactly one owner of the seam. Re-enable that row (or remove this patch layer)
+# to go back to the upstream walk-based provider.
+#
+# ORDERING MATTERS: this patch can only disable a row that an earlier bundle
+# layer already declared. `dsh-at-file-everything` must therefore appear *after*
+# the bundle that mounts `file-reference-local` (in the shipped composition,
+# `@deepseek-ai/dsh-web-app`) in `package.json`'s `dsh.profile.bundles` list.
+# `dsh plugin add` appends at the end, which satisfies this by default. If the
+# row cannot be found, the Loader reports
+# `patch: entry "file-reference-local" not found` — move this bundle later in
+# the list.
+- insert:
+    - id: file-reference-everything
+      name: dsh-at-file-everything
+
+- id: file-reference-local
+  disabled: true

package/dsh.plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "dsh-at-file-everything",
+  "description": "Everything-backed @file completion for DeepSeek Harness on Windows",
+  "version": "0.1.0",
+  "entry": {
+    "name": "dsh-at-file-everything",
+    "inject": ["agents", "workingDirectory"]
+  }
+}