huangjua/dsh-context-economy

README 摘要

AI 生成声明 本插件由 DSH(DeepSeek Harness)搭载 DeepSeek V4 Flash 编写,开发过程中使用了 myDshPresets 插件。 @dsh-external/dsh-context-economy Token-efficient project reading plugin for DSH —— 项目阅读的"上下文经济层"。 把 DSH 内建"项目阅读 + Agent 记忆"里最值得复用、且 DSH 还没直接提供的两个缝做成插件： 1. 项目结构索引（文件树 + 符号表 + import 图） - 按 mtime+size 增量自愈：只重扫变更文件，从磁盘真值重建，不信任过期缓存（对齐全套 dev heal links 哲学的 DSH 版本）。 - 查询只返回 相对路径 + 行号 + 短上下文 指针；命中超 maxHits 自动 落盘到 spill 文件 并返回路径。 2. byte 级指针切片 - project slice read 不整读文件，按字节窗口读取 + 可选 find 定位 + nextByteOffset 翻页，专治"单行超大文件行号失效"。 3. 附 project cost probe ：量化指针输出 vs "朴素整文件加载"的 token 节省（验收基线）。 这个插件是怎么写出来的 - 灵感来源 ：先拆解 DSH 自带的"项目阅读 + Agent 记忆"能力,提取出最值得复用的模式——指针式懒加载( read 的精确行段、 grep 只回命中行、 glob 只回路径)、mtime 自愈派生状态、超量结果落盘留指针。 - 骨架 ：用 DSH 插件生产线 dev scaffold plugin 生成 hybrid 形态,然后自己实现了两个真正缺的部分: 1. src/core.ts ——增量项目索引(文件树 + 轻量符号表 + import 图),按 mtime+size 只重扫变更文件;外加 byte 级切片 sliceRead (单行超大文件兜底)。 2. src/index.ts ——用 defineTool 注册 6 个 project 工具,全部返回 path:line 指针、超量落盘。 - 构建 ：本机 bash 是坏 WSL 启动器, dev build plugin 不可用;改用运行时 junction 链接编译依赖 + 本地 tsc 编译,产物 lib/ 干净通过。 - 验证 ： scripts/e2e-self-test.mjs 独立跑通索引/符号/import/切片,并在 demo 项目上量化出单次符号查询约省 80–93% 输出 token。 - 发布 ：git 推送 GitHub, npm pack 打 tgz,再用 GitHub CLI 创建 v0.0.1 Release …

分类