dsh-experience-index

DSH 启动时会加载 AGENTS.md、CLAUDE.md 和 skill 目录，但 .codex/runbooks、.comate/rules、.codex/analysis 等自由格式的经验文档往往对模型完全不可见。与此同时，这些目录里通常混有大量会话语料和临时产物，全量注入既不现实也会淹没真正可复用的十来篇文档。缺口很精确：需要一种轻量方式告诉新会话「这里有哪些可参考的路标」，而不是从零重新设计或盲目 grep 整棵目录树。

dsh-experience-index 只做三件事：发现、登记、提示。你为某个绝对目录（scope）手动建立索引后，插件在数据库里只存路径、类别、标题、大小与修改时间，不复制正文、不做全文检索、不做 LLM 摘要，也不提供任何模型工具。会话首步会注入一次紧凑的路标：小类逐条列出路径与一句话说明，大类则折叠为目录加数量，日志与状态类默认只给负向提示，避免模型误把 tmux 日志当参考材料。路径相对当前工作目录，嵌套 scope 时只注入包含 cwd 的最深一层。

适合长期在 monorepo 或子项目里协作、且前序 agent 已在 .codex、.comate、.claude、.agents 等位置留下 runbook、规则与分析文档的团队与个人。若你希望接手开发的新会话能先看到「该读什么」、再自行用 read / grep / glob 深入，而不是依赖插件替你搜全文，这个索引插件就是为此设计的。过期检测会标注「可能已过期」，重建索引仍由你手动触发，保持索引与磁盘变更之间的边界清晰。