hpyperry/dsh-ref-lib

README 摘要

dsh-ref-lib · 只读参考库 DeepSeek Harness（DSH）插件：给任意会话挂上 只读参考库 ，agent 需要查证时 先在参考库里检索 ——而不是凭空猜测或直接搜网。 安装： dsh plugin --profile web add @hpyperry/dsh-ref-lib ✨ 特性 能力 说明 🚀 统一入口 输入卡正上方的「参考库」胶囊（hero / active 常显、带数量徽标）——纯 CSS 与输入卡左缘对齐，零测量、零竞态 🎨 可视化面板 基名 + 完整路径列表、用途说明、悬停高亮、危险色移除、独立的空/加载/错误态 📂 三种添加方式 应用内目录浏览器 / 系统原生选择器（按宿主能力自动适配）/ 手动输入路径（ 与相对路径），可附 用途说明 （自动提取 README 标题兜底） 🧠 上下文注入 仅向配置了参考库的会话注入定稿英文规则：库清单（含用途 routing metadata）+ 强制查证流程 （先查参考库，未覆盖才外部）+ 权威性/冲突处理 + 只读约束；空列表零 token 🔒 per-session 隔离 每个会话独立维护，会话间互不可见；sidecar JSON 持久化，重启/恢复后仍在 📡 失效检测 每次读取实时探测库目录可用性（删除 / 被替换为文件即标记），失效库自动跳过注入并红色提示（面板状态行 + dock 失效角标 + /ref-lib list 标记）；UI 同步 交互驱动 （命令完成 / 发消息 / 面板操作即时刷新，零后台请求） ⚡ 静默数据通道 client 读写走插件自注册的 /api/ref-lib/ HTTP 路由——不渲染命令卡片、不执行命令、不产生用户消息 🌐 双语界面 zh/en 全量本地化，随界面语言实时切换 ⌨️ 命令入口 /ref-lib add [--note ] \ list \ remove ，与 UI 数据一致；结果走专属卡片（全展开完整文本 + 一键复制，规避官方卡片的截断显示） 🛡️ 安全 loopback 护栏 + 路径消毒 + 只读保证分层（沙箱强制 / 上下文软约束） 📦 安装 卸载： dsh plugin --profile web remove @hpyperry/dsh-ref-lib 🚀 快速开始 1. 重启后在 输入卡正上方 看到「参考库」胶囊（新会话与具体对话均可见）； 2. 点开面板 → 添加目录（应用内浏览器 / 系统选择器 / 手动路径三选一）→ 列表出现 → 行尾垃圾桶移除； 3. 或对话内命令： /ref-lib add [--note ] 、 /ref-lib list 、 /ref-lib remove ； 4. 配置了参考库的会话，agent 会收到定稿英文的"参考库规则"上下文指令——查证规范/API/项…

分类