op7418/pilot-harness--packages-attachment-attachment-local ↗★ 276

@deepseek-ai/dsh-attachment-local

基于DSH_HOME的私有内容寻址附件存储实现,按哈希寻址。 适合需要本地附件持久化的部署,属附件接口的具体实现。

包名
@deepseek-ai/dsh-attachment-local
兼容性
待验证
Harness 依赖范围
workspace:^
Cordis 依赖范围
workspace:^
版本
0.1.0-rc.7
许可证
MIT
最近更新
2026年9月10日

同名包的其他仓库

安装

此插件尚未提供可验证的 bundle,或兼容性检查未通过。请先阅读仓库说明。 阅读完整 README ↗

@deepseek-ai/dsh-attachment-local

English | 中文

The private local implementation of @deepseek-ai/dsh-attachment. Objects land at /attachments/v1/objects// and are addressed by an opaque sha256: id. Each process proves a home durable once by syncing every ancestor entry to the filesystem root, so a directory another process created but has not yet synced is never mistaken for a safe boundary. Writes then use a private staging directory, owner-only files, a synced temporary file, an atomic exclusive hard-link publish, and directory syncs on the publication path (POSIX; Windows relies on filesystem metadata journaling) so the reported reference survives a crash. Write admission and reads fully decode the raster before accepting its format and dimensions; reads also re-check the digest and logged metadata. Byte and pixel limits are write-time admission policy, so a later policy reduction does not make already-admitted history unreadable.

DSH_HOME resolves through the shared path policy: explicit config, $DSH_HOME, then ~/.dsh. Session logs contain only the reference and verified metadata, never this host path. readImage forwards optional cancellation into the filesystem read, observes it around verification, and preserves it instead of wrapping it as ATTACHMENT_READ_FAILED.

Model Experience

Indirectly, through durable replay of historical user images and structured model image output after restart and fork.

KV Cache effect

None beyond the image block owned by the requesting adapter.

Known Limitations and Deferred Work

  • Objects are retained indefinitely; reference-aware garbage collection is deferred.
  • The local backend assumes the host and provider adapter share this filesystem service.
  • Animated GIF metadata is validated from the logical screen; frame-level decoding policy is provider-owned.