Repository navigation
v0.6.3 | Native Design Previews & Offline Bundles
FiLens v0.6.3 includes CLI 0.5.4, browser preview 0.3.3, mobile source SDKs 0.1.3 and DeepSeek Harness adapter 0.1.1.
Native design previews and model workbench
- Preview 402 file extensions locally, including conversion-assisted formats. PSD/PSB read the saved composite; AI/EPS/PS produce vector PDF previews through the shared frontend WASM core. PSD/PSB require 8-bit RGB/grayscale; PostScript supports a bounded subset with font limitations. See design format limits.
- Explore 12 original design samples and 8 detailed 3D models. The model inspector offers view, structure and tool panels without shrinking the canvas; orbit, zoom, measurement, sections and snapshots work in narrow panes.
- The workbench distinguishes Samples, Supported, no sample, and Unsupported. Supported formats without a bundled sample can be opened by importing a file. Opening STEP through a direct URL now selects the Design family after its routes load.
- README installation, browser integration, mobile SDK, format coverage and size sections now have separate subheadings.
CLI and Agent interfaces
Breaking JSON change: public requests and responses use op. Capacity filters use forOp. Legacy operation and forOperation fields are rejected; no compatibility entry points remain.
{"op":"read","input":"report.pdf","pages":"1-3","ocr":"never"}
{"op":"capacity","forOp":"read","sourceFormat":"pptx"}Capacity supports combined filters, compact output and directional queries such as docx>? and ?>pdf. Document inspection adds explicit page/slide selection, per-call OCR policy and confidence filtering, source evidence, Office media inventory and requested image attachments. Intentional native-text reads report their scope and succeed when otherwise complete; genuine OCR errors and omissions retain partial-result status. Excerpts preserve complete passages and return whole short documents when the requested budget permits.
The DSH adapter uses the same CLI and frontend runtime, adding image attachments and the model inspector. Current adapter tool and browser tests pass; the real Desktop/Web profile observations from adapter 0.1.0 remain historical and were not repeated for 0.1.1.
Offline downloads
Download the archive matching your platform and extract the entire directory. CLI Full includes the native OCR engine and models; Lite includes document reading, conversion and the offline browser preview runtime. Both run directly without Node.js or Python. Choose Full for offline OCR.
For browser integration, deploy the complete extracted ZIP over HTTP(S) and import filens.js. Retain archive engine sidecars for RAR/7z. Mobile ZIPs contain Swift Package / Android Library source SDKs with offline resources; build them in the corresponding platform toolchain.
| Offline package | Download | Extracted files |
|---|---|---|
| filens-preview-0.3.3-split.zip | 4.31 MiB | 13.81 MiB |
| filens-preview-0.3.3-all-in-one.zip | 4.20 MiB | 9.84 MiB |
| filens-ios-sdk-0.1.3.zip | 4.33 MiB | 13.85 MiB |
| filens-android-sdk-0.1.3.zip | 4.33 MiB | 13.85 MiB |
| filens-0.5.4-macos-arm64-lite.tar.gz | 10.87 MiB | 18.44 MiB |
| filens-0.5.4-macos-arm64-full.tar.gz | 25.00 MiB | 41.64 MiB |
| filens-0.5.4-linux-x64-lite.tar.gz | 11.62 MiB | 18.17 MiB |
| filens-0.5.4-linux-x64-full.tar.gz | 27.57 MiB | 47.11 MiB |
| filens-0.5.4-linux-arm64-lite.tar.gz | 11.51 MiB | 18.06 MiB |
| filens-0.5.4-linux-arm64-full.tar.gz | 25.26 MiB | 41.47 MiB |
| filens-0.5.4-windows-x64-lite.zip | 11.56 MiB | 18.09 MiB |
| filens-0.5.4-windows-x64-full.zip | 27.79 MiB | 46.85 MiB |
MiB = 1,048,576 bytes. These sizes exclude filesystem overhead and user caches. SHA256SUMS and the source manifest identify every package.
Validation and limits
- Shared workspace suite: 1,876 passed, 11 intentional skips; 2,027 conversion policy checks and 311/311 WASM conversion jobs passed.
- Production workbench, design and model browser checks passed, including Chinese/English states and a 320px viewport. Standalone previews passed 58 browser cases, HEIF reference-pixel checks and both exports after production Vite bundling. Mobile runtime/bridge: 22 Chromium/WebKit checks.
- CLI tests cover requests, capacity, document inspection, conversion, OCR, archives, search, excerpts, similarity and memory/disk workspaces. Final macOS Full/Lite archives execute with an empty PATH and render exported previews with networking disabled.
- DSH adapter: 18 tests, 12 preview formats and interaction checks passed. Release archives pass checksums, integrity, size and privacy checks.
- Native execution was verified on macOS arm64. Linux x64/arm64 and Windows x64 bundles were cross-built; native execution on those systems and physical mobile devices remains unverified. Mobile artifacts are source SDKs rather than precompiled AAR/XCFramework files. Format support counts do not promise full fidelity for every file.
Live workbench · Support matrix · Release validation.
First-party code is MIT. Retain the supplied third-party notices when redistributing.
