mega-index-map

Chinese documentation: README.zh-CN.md

A cross-workspace Library for DeepSeek Harness. Agents record the objects they meet - files, tools, environments, knowledge, work records - into $DSH_HOME/library, so any conversation can index, search and reuse them.

Tools

• library_record - record an object (change detection routes verify/confirm; a change to the immutable class is refused until the user decides, and is then recorded with confirm: true and a reason, which the log keeps as record-confirm)
• library_index - rebuild/dedupe/sort the library, report conflicts
• library_query - search by keyword/type/tags, cursor pagination
• library_detect - scan and register this machine's tools/environments. The built-in seed is machine-neutral: a bare command name is resolved from PATH, and a location is written in its owner's own words (%ProgramFiles%, %GOROOT%, %ANDROID_HOME%, ~, ${HOME}), with the newest installed build derived from disk where a location rotates with its version. A tool kept somewhere of your own goes into the per-install candidate pack with add, and propose suggests entries from a directory. A path that does not exist is skipped, and each existing result carries declared: what the file itself states about itself (product/version/vendor, read from its own version resource, statically - the tool is never executed)
• library_sniff - identify a file by its header bytes (108 signatures), independent of extension
• library_format - extend this machine's format library: list scan learn add remove deps draft report deliver unseal
• library_decrypt - read back an isolated sensitive object on request
• library_export - export to JSON/NDJSON
• library_encoding - report the host encoding and how to switch to UTF-8
• library_adb - developer-side Android device operations over ADB

Install

dsh plugin --profile web add github:Nesarf/mega-index-map

Notes

• The library lives at $DSH_HOME/library (default ~/.dsh/library). Additions learned on this machine live beside it and never override the built-in tables.
• Work stays local: the plugin performs no network I/O and transmits nothing on its own.
• Measured cost is linear and small: at 5,000 objects a query takes about 13 ms, a record 19 ms, a rebuild 26 ms (index file around 2.3 MB). Back up or migrate with library_export.
• Concurrent writers are serialised through a lock file: a lock whose owner died is taken over, and a busy one is waited for for up to two seconds before the write proceeds and says so in the log.
• This package and the sibling cross-harness build are read-only with respect to each other; nothing here writes outside $DSH_HOME, the OS temp directory or a path the caller passed in, and scripts/check-isolation.mjs enforces both directions (see ISOLATION.md).
• Three things are held invariant and checked on every push: English/ASCII-only output, Windows/macOS/Linux portability, and UTF-8-safe handling of multi-language text. npm run check runs all of it (ASCII, consistency, portability, isolation), and npm run selfcheck runs the five-stage pass - smoke, traversal, proofread, traversal, smoke - keeping those three axes in view and reporting them per axis.
• MIT License. See LICENSE.