deepseekplugins

DeepSeek Harness plugin

dsh-ref-lib

只读参考库插件：UI 交互式管理（应用内目录浏览器/系统选择器/手动路径直加）+ systemPrompt 注入 + per-session sidecar 持久化

Tools & Capabilities
Jump to install

Source facts

Repository
hpyperry/dsh-ref-lib
Latest update
Aug 21, 2026
Category
Tools & Capabilities
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/hpyperry/dsh-ref-lib
Plugin: dsh-ref-lib
Author: hpyperry

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

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 隔离 | 每个会话独立维护，会话间互不可见；分支会话（fork）自动继承父列表（fork 时刻快照、条目 id 独立）；sidecar JSON 持久化，重启/恢复后仍在 | | 📡 | 失效检测 | 每次读取实时探测库目录可用性（删除 / 被替换为文件即标记），失效库自动跳过注入并红色提示（面板状态行 + dock 失效角标 + /ref-lib list 标记）；UI 同步交互驱动（命令完成 / 发消息 / 面板操作即时刷新，零后台请求） | | ⚡ | 静默数据通道 | client 读写走插件自注册的 /api/ref-lib/* HTTP 路由——不渲染命令卡片、不执行命令、不产生用户消息 | | 🌐 | 双语界面 | zh/en 全量本地化，随界面语言实时切换 | | ⌨️ | 命令入口 | /ref-lib add <path> [--note <用途>] \| list \| remove <id>，与 UI 数据一致；结果走专属卡片（全展开完整文本 + 一键复制，规避官方卡片的截断显示） | | 🛡️ | 安全 | loopback 护栏 + 路径消毒 + 只读保证分层（沙箱强制 / 上下文软约束） |

📦 安装

# 使用npm
dsh plugin --profile web add @hpyperry/dsh-ref-lib

# 本地开发期（改动即时生效）：指向仓库本地路径
# dsh plugin --profile web add /path/to/ref-lib

# 重启生效
dsh --profile web

卸载：dsh plugin --profile web remove @hpyperry/dsh-ref-lib

🚀 快速开始

1. 重启后在输入卡正上方看到「参考库」胶囊（新会话与具体对话均可见）； 2. 点开面板 → 添加目录（应用内浏览器 / 系统选择器 / 手动路径三选一）→ 列表出现 → 行尾垃圾桶移除； 3. 或对话内命令：/ref-lib add <path> [--note <用途>]、/ref-lib list、/ref-lib remove <id>； 4. 配置了参考库的会话，agent 会收到定稿英文的"参考库规则"上下文指令——查证规范/API/项目事实时必须先查参考库（未覆盖才允许外部途径并自报），且禁止修改库内文件。

⚙️ 行为与配置

开箱即用，无配置文件。几个可说明的行为：

项说明
数据存储<dshHome>/plugin-data/ref-lib/<sessionId>.json（per-session sidecar，随 dsh home 持久化）
用途说明（note）添加时可选填写；未填写时自动提取目录 README 首个 H1 标题兜底（无 README 则为空）。note 作为 routing metadata 注入，帮助 agent 判断库的相关性
目录选择后端启动时自动探测：应用内目录浏览器（browse）或系统原生对话框（native）；可在 profile 的 cordis.patch.yml 切换 directory-picker 行为
上下文注入仅向有参考库的会话注入（systemPrompt.context，空列表零 token；注入文本为定稿英文模板）
子会话分支会话（fork）创建时复制继承父会话的参考库列表（fork 时刻快照、条目 id 独立）；legacy 子会话（升级前创建）首次读取时同语义物化

🛡️ 安全

  • /api/ref-lib/* 走宿主 ctx.webServer 同源路由，loopback 护栏（源地址 + Host + Origin + Sec-Fetch-Site），恶意网页 CSRF 与 LAN 访问均被拒；
  • 端点唯一的文件写入是自己的 sidecar（固定目录、session 隔离、原子写）；add 只把"已存在的目录路径"记入列表，不创建/修改目标路径文件；
  • 只读保证分层：库放在 workspace 之外 → 沙箱进程级强制只读（read-only/workspace-write 模式均只读）；上下文再注入软约束（"禁止创建、修改或删除库内文件"）。

⚠️ 已知限制

  • 系统原生目录选择器可能卡顿且界面语言跟随 OS：可用「手动输入路径」绕开；或在 profile 把 directory-picker 切换为 @deepseek-ai/dsh-host-directory-picker-browse（应用内浏览器，快速且 zh/en 本地化）；
  • settings 配置客户端白名单（DSH rc.6 框架限制）：第三方插件 namespace 默认不可被浏览器端读写，官方标注为 deferred work；
  • 已添加条目的用途说明暂不支持在 UI 编辑（可移除后重新添加，或重新 add 同路径带新 note 更新）；
  • /ref-lib add <path> 的相对路径基于当前会话工作区解析，而非 dsh 进程启动目录。

🧑‍💻 开发

pnpm typecheck   # tsc --noEmit
pnpm lint        # eslint（typescript-eslint recommended）+ prettier
pnpm test        # vitest（L0–L2：纯函数 / 装载 / harness 边界回归）
pnpm build       # tsc（node half）+ tsdown（client bundle）→ lib/
  • 结构：src/（node half：服务 / /api/ref-lib/* 路由 / /ref-lib 命令 / 上下文注入）+ src/client/（web half：dock 胶囊 / 管理面板 / 目录浏览器 / 本地化）+ tests/；
  • 隔离开发环境：scripts/dev-isolate.sh（独立 DSH_HOME，默认 ~/.dsh-dev，真实 ~/.dsh 零接触；rm -rf 即重置）——启动/安装/热更新/重置的完整用法见仓库 AGENTS.md；
  • 热更新：src/client/* 改动 pnpm build:client 后浏览器 ≤0.5s 自动热更新；node half 改动需重启 dsh web。

📄 License

[MIT](LICENSE)，与 DeepSeek Harness 一致。

📚 更多

  • 项目开发约定（开发规范 / 测试标准 / 开发环境）：见仓库 AGENTS.md
  • 仓库：<https://github.com/hpyperry/dsh-ref-lib>
Back to searchOpen GitHub repository

More related plugins

View category