lnyuqian/dsh-skill-sidebar

README 摘要

dsh-skill-sidebar DSH web 插件：在 dsh-better-sidebar 右侧面板中新增一个「技能」选项卡，列出本机可读取的全部技能，并以简短描述介绍每个技能的功能。 功能 - 技能选项卡 ：通过 ctx.betterSidebar.registerTab 注册，图标为技能图标，位于右侧面板的 + 菜单中（也可在侧边卡片设置里开关）。 - 紧凑排版 ：每个技能两行展示 —— 第一行技能名，第二行以 4-6 字短语点出主要功能（如「日程管理，会议预定，忙闲查询」）；内联最多显示 4 个短语，功能更多的技能末尾以高亮 +n 表示。鼠标悬停任意技能行会弹出浮层显示完整功能描述。行与行之间以细分隔线隔开。 - 短语来源 ：插件自带 lib/phrases.json （为当前全部技能手写的短语清单）；新安装的技能自动用规则从描述中拆分生成短语（按标点切分、取每段前 6 字、去重、最多 6 条）。 - 立即列出，无需等待 ：数据优先来自会话实时技能目录（与输入框 / 技能菜单同源），并合并本机文件系统扫描结果；列表同时持久化到浏览器 localStorage 与会话缓存文件，再次启动打开选项卡即可瞬间渲染。 - 自动添加新技能 ：本机技能根目录被 fs.watch 监听（含父目录，目录后建也能捕获），新技能安装后自动重新扫描；选项卡可见期间每 30 秒后台刷新一次实时目录。 - 每周一重新读取 ：周一时服务端强制对本机所有技能做一次全量重读；此后每 6 小时校验一次，若缓存早于当天则再次刷新。 数据源 - 实时目录 ： connection.api.skills.list({ sessionId }) —— 当前会话可见的技能（含内置与用户技能），由 DSH 的 skill 注册表实时提供。 - 本机扫描 ： GET /skillpanel/skills —— 插件服务端直接扫描技能根目录（ /.agents/skills ，可用 $DSH AGENTS HOME 与 $DSH SKILL DIRS 扩展），解析 SKILL.md 的 YAML frontmatter（ name / description / whenToUse ）。 - 两份数据按名称求并集合并展示（实时目录优先），因此既能显示会话可调用的技能，也能显示仅用户可调用或机器上其他根目录的技能。 缓存与刷新策略 项目 位置 策略 服务端缓存 $DSH HOME/storages/dsh-skill-sidebar/skills.json （可用 $DSH SKILL CACHE DIR 覆盖） 启动时若非周一且 7 天内已扫描则直接使用；否则重扫 浏览器缓存 localStorage dsh-skill-sidebar:cache:v1 打开选项卡立即渲染，后台再刷新 自动添加…

分类