dsh-skill-rag

DSH PLUGIN记忆与知识

仓库 Kosello/dsh-skill-rag

记忆与知识 L4 · 沙盒安装通过 安全审查:低风险 可信度:银 可安装插件
安装这个插件

dsh-skill-rag 是 Kosello 维护的 记忆与知识 类 DSH 可安装插件, 仓库为 Kosello/dsh-skill-rag,许可证 MIT。 下面按「装什么、怎么装、验没验过、跑起来要注意什么」逐项列出。

一句话选型结论

按资料字段整理

dsh-skill-rag 是记忆与知识类的 DSH 可安装插件,验证等级 L4 · 沙盒安装通过,安全审查为低风险,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类记忆与知识 收录类型可安装插件 验证等级L4 · 沙盒安装通过 安全审查低风险
验证等级 L4 L4 · 沙盒安装通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-10-29 创建于 2026-10-29
README 10.0 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:Kosello/dsh-skill-rag#v0.2.0
  1. 1
    确认版本与运行环境

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名未发布到 npm可用 npm view 查看包信息

能做什么

记忆与知识
字段来自项目仓库与公开索引,中文说明由本站标注

适用场景

联网搜索记忆

上游标签

deepseek-harnessdsh-pluginembeddingsgoogle-geminilocal-firstopenrouterretrievalskill-searchskills

验证等级与安全审查

L4 · 沙盒安装通过
自动化流程结论,不是人工审核
验证等级L4 · 沙盒安装通过安装命令在隔离沙盒内真实执行成功,无依赖错误
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度银综合仓库活跃度与验证结果

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L4:在沙盒里真实装过,依赖能装上,不是纸面声明。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在记忆与知识场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-skill-rag当前 L4 · 沙盒安装通过 低风险 0 未标注 有
ruflo L3 · 安装规范通过 低风险 7.4 万 未标注 无
OpenViking L3 · 安装规范通过 低风险 3.9 万 未标注 无
WeKnora L4 · 沙盒安装通过 低风险 3.3 万 未标注 有
distilly L4 · 沙盒安装通过 低风险 2.5 万 未标注 有
EverOS L4 · 沙盒安装通过 低风险 1.3 万 未标注 有

仓库档案

记忆与知识
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方Kosello仓库 dsh-skill-rag · 默认分支 main
分类记忆与知识memory
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言未标注仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-10-29 · 2026-10-29最后推送 2026-10-29
本站收录2026-10-30首次进入本站目录的时间

README 全文

10.0 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-skill-rag

Optional, configurable skill discovery for DeepSeek Harness. It keeps the
full skill library searchable without advertising every skill in every prompt,
while leaving the original skill loader, instructions, resources and
procedural-learning tools untouched.

Three modes:

Mode What it does Embedding provider Index
catalog Standard — no RAG. Leaves DSH's stock full catalog and loader alone. none none
keyword Local SQLite FTS5/BM25 search with a small selected catalog. none local keyword index
hybrid Keyword + semantic retrieval through a configured embedding provider. Jetson, Google, OpenRouter or OpenAI-compatible versioned vector generations

New installations default to catalog, so installing the plugin does not
require a key, a model service or a network connection. hybrid is opt-in.

Requirements

  • DSH 0.2.1-rc.2 (tested target), Node >=22.19 with native node:sqlite.
  • For hybrid, one embedding provider:
  • an existing local TensorRT manager (default http://127.0.0.1:8110);
  • a Google Gemini API key;
  • an OpenRouter API key;
  • an OpenAI-compatible embeddings endpoint and model.
  • No SDKs or extra vector database are required.

Install

From a local checkout:

npm ci
npm run verify
dsh plugin --profile web add "$PWD"

From a published Git repository:

dsh plugin --profile web add github:Kosello/dsh-skill-rag

The package declares one bundle row (skill-rag) and an optional browser
client section. The browser client registers Settings → Skill discovery
without editing the DSH shell.

Verify composition before restarting:

dsh --profile web --dump-config | grep -A4 'id: skill-rag'

Then restart the harness through your normal service mechanism. If you are
running the agent inside that service, use an external delayed restart rather
than interrupting the active turn.

Configuration

Configuration lives on the skill-rag row in the profile's
cordis.patch.yml. The same contract is edited by the settings panel.

Standard catalog (recommended zero-setup default)

- id: skill-rag
config:
mode: catalog

This does not open an index, initialize an embedding provider, register
skill_search, or project a selected catalog. The stock full catalog is used.

Local keyword search

- id: skill-rag
config:
mode: keyword
coreNames: []              # user/project DSH skills are always retained
autoIndex: false

skill_search and the selected catalog are enabled. No embedding provider is
constructed and no embedding request is made.

Hybrid with a local Jetson manager

- id: skill-rag
config:
mode: hybrid
embedding:
provider: jetson
model: Qwen3-Embedding-0.6B-TensorRT
baseURL: http://127.0.0.1:8110
dimensions: 1024
timeoutMs: 15000
index:
content: excerpts
privacy:
allowRemoteEmbeddings: false
autoIndex: true

The Jetson adapter accepts only a loopback HTTP service root and uses its
non-fallback embedding route.

Google Gemini

- id: skill-rag
config:
mode: hybrid
embedding:
provider: google
model: gemini-embedding-2
dimensions: 768
apiKeyEnv: GEMINI_API_KEY
index:
content: metadata
privacy:
allowRemoteEmbeddings: true

gemini-embedding-2 is the stable model documented by Google for text and
multimodal embeddings. Recommended output dimensions are 768, 1536 or 3072.
The adapter sends text only; no assets are uploaded.

OpenRouter

- id: skill-rag
config:
mode: hybrid
embedding:
provider: openrouter
model: openai/text-embedding-3-small
dimensions: 1536
apiKeyEnv: OPENROUTER_API_KEY
providerRouting:
allow_fallbacks: false
data_collection: deny
index:
content: metadata
privacy:
allowRemoteEmbeddings: true

OpenRouter model discovery uses its embeddings catalog, not the chat-model
list. Model support for dimensions, input types and routing varies by model.
An explicit model is required.

OpenAI-compatible endpoint

- id: skill-rag
config:
mode: hybrid
embedding:
provider: openai-compatible
model: your-embedding-model
baseURL: http://127.0.0.1:11434/v1
dimensions: 1024
apiKeyEnv: LOCAL_EMBEDDING_KEY   # optional for a loopback server
index:
content: metadata
privacy:
allowRemoteEmbeddings: false

The adapter accepts an explicit endpoint and uses the OpenAI /embeddings
shape. Compatibility is not assumed from a product name; test the endpoint and
its dimensions before relying on it. A remote endpoint requires HTTPS and
explicit remote consent.

Credentials

Configuration contains only environment-variable names, never key values.
Put keys in a private environment file and reference it from the service:

install -m 600 /dev/null ~/.dsh/skill-rag.env
printf 'GEMINI_API_KEY=%s\n' "$YOUR_KEY" >> ~/.dsh/skill-rag.env
mkdir -p ~/.config/systemd/user/deepseek-harness.service.d
printf '[Service]\nEnvironmentFile=%%h/.dsh/skill-rag.env\n' \
> ~/.config/systemd/user/deepseek-harness.service.d/skill-rag.conf
systemctl --user daemon-reload

Restart to apply. The settings panel reports only whether the referenced
variable is present; it never displays the value and has no secret-write field.
The TypeSafe/Jev key file is unrelated and should not be reused.

Using it

The model can call:

{"query":"render a short video from a photograph on my desktop", "limit":5}

skill_search returns names and routing summaries, not instructions. The model
then loads the original skill with the unchanged skill tool. Search and
indexing never synthesize a successful skill result, so read-before-write and
the self-evolve reviewer still observe real loads.

Humans can use:

/skill-search status
/skill-search models
/skill-search test
/skill-search preview
/skill-search reindex            # prints the data-consent disclosure
/skill-search reindex --confirm  # starts the rebuild
/skill-search cancel

reindex refuses to start without the explicit --confirm step. The settings
panel performs the same sequence through an authenticated owner-only RPC; model
tools cannot change provider settings, credentials or trigger a rebuild.

What gets sent

  • catalog: nothing.
  • keyword: nothing; local SQLite only.
  • hybrid local (Jetson/loopback): skill cards and search queries stay on the
    machine.
  • hybrid remote: only the configured card content and search queries are
    sent. metadata cards contain name, description, trigger guidance and
    explicit target hints. excerpts also include headings and a short
    introduction. Paths and full bodies are never part of a card. Metadata can
    still be private; remote processing requires
    privacy.allowRemoteEmbeddings: true.

There is no automatic local-to-cloud fallback. If the provider fails, the
configured onEmbeddingError chooses labelled keyword results (default) or a
strict error. Provider errors are returned in sanitized form.

Index generations and upgrades

Embedding spaces are not interchangeable, even at equal dimensions. The
namespace fingerprint includes provider, endpoint, model, explicit revision,
dimensions, query/document transforms, content policy and adapter format.
Credentials, timeout and batch size do not affect the fingerprint.

A model or policy change creates a new private generation; the prior
known-good generation stays available until the replacement is complete.
Incomplete, cancelled or superseded candidates cannot become active. A key
rotation alone reuses the same vectors. Existing 0.1 Jetson caches are adopted
into a private snapshot without modifying the old file.

The index is rebuildable local state under the configured database path. It is
not a personal-memory store and does not replace Hindsight or any other memory
service. Source skill files are never modified or synchronized by this plugin.

Settings panel

The browser client adds a Skill discovery section with:

  • mode selector;
  • provider, model, environment-variable reference and dimensions;
  • Refresh embedding models (embedding-capable models only);
  • Test connection using synthetic text, never your skills;
  • Preview data sent before a rebuild;
  • explicit consent review, rebuild progress and cancel;
  • visible keyword-fallback status.

Mode changes take effect through the runtime: catalog removes selective
catalog projection and the search tool; keyword/hybrid add them. Existing
sessions may retain earlier compact catalog messages in history, but no new
compact catalogs are produced in Catalog mode.

Development and verification

npm run check
npm test
npm run build        # server + ModuleLoader-wrapped client bundle
npm run smoke        # real filesystem -> search -> selected catalog -> stock loader
npm run benchmark    # fixed 26-case evaluation against the real library

The suite covers provider fixtures, credential and redirect safety, index
generations, mode lifecycle, management RPC, commands, settings controller and
DOM panel. Live paid-provider calls are not part of the default test suite.

tsup must keep removeNodeProtocol: false: node:sqlite is a prefix-only
builtin and stripping node: creates an invalid bare import.

Limitations

  • Full filesystem catalog discovery still happens internally; the plugin
    reduces prompt exposure, not discovery I/O.
  • Provider input limits, batch limits and pricing vary; consult each provider.
  • Dimension support varies by model. Set dimensions deliberately.
  • A remote provider sees card metadata and queries; review the disclosure.
  • A later outermost middleware could still alter the final prompt.
  • Malformed legacy catalog messages are left untouched.
  • The browser section integrates through the installed client-slot API; a
    changed host UI contract may require a client rebuild.

License

MIT. See LICENSE.

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
dsh-skill-rag 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:Kosello/dsh-skill-rag#v0.2.0` 即可。

dsh-skill-rag 的验证等级是什么意思?

L4 · 沙盒安装通过。安装命令在隔离沙盒内真实执行成功,无依赖错误

dsh-skill-rag 安全吗?

低风险。

dsh-skill-rag 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-skill-rag 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

记忆与知识
按星标排序,可作替代方案

ruflo

ruflo

L3 · 安装规范通过 7.4 万 星

OpenViking

OpenViking

面向 DeepSeek Harness 的 OpenViking 记忆与上下文插件:pre-step 自动召回与画像注入、会话捕获、`vik

L3 · 安装规范通过 3.9 万 星

WeKnora

WeKnora

把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己

L4 · 沙盒安装通过 3.3 万 星

distilly

distilly

Distilly — Distill how they think into reusable Skills for any Agent o

L4 · 沙盒安装通过 2.5 万 星

EverOS

EverOS

L4 · 沙盒安装通过 1.3 万 星

MemOS

MemOS

L4 · 沙盒安装通过 1.2 万 星

Kosello 的其它插件

1 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 —。