dsh-workspace-gate

DSH PLUGIN记忆与知识

仓库 M1r0er/dsh-workspace-gate

记忆与知识 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

工作区插件门控:插件照常加载,按工作区(目录)把它不该占的提示词前缀摘掉——工具 schema 与提示词段不再进模型上下文。Workspace-scoped plugin gate for DeepSeek Harness (dsh).

一句话选型结论

按资料字段整理

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

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

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:M1r0er/dsh-workspace-gate
  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 查看包信息

能做什么

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

适用场景

智能体编排文件读写记忆

上游标签

contextcordiscordis-plugindeepseek-harnessdshdsh-pluginplugin-managertoken-optimizationworkspace

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

选择建议

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

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

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

仓库档案

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

README 全文

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

简体中文 | English

dsh-workspace-gate · 工作区插件门控

> 插件照常加载,但按工作区把它不该占的提示词前缀摘掉——工具 schema 与提示词段都不再进模型上下文。




一个 DeepSeek Harness(dsh)插件。

它让"要不要让模型看见某个插件"从全局下沉到工作区:插件依然全部加载、功能随时可用,
但在你指定的目录下,它的工具 JSON schema 和系统提示词段不再出现在每一次请求里。
省下的是每轮请求的输入 token,而不是插件的加载开销。


目录

  • 它解决什么问题
  • 它做什么 / 不做什么
  • 主要特性
  • 界面
  • 安装
  • 使用
  • 归属是怎么判断的
  • 数据存放
  • 为什么不是"真·停用插件"
  • 实测数据
  • 开发
  • 已知边界
  • 许可证

它解决什么问题

DSH 自带的插件管理只有 全局 开关:一个插件要么对所有工作区都开,要么都关。

但插件对 prompt 的成本是每轮都付的——只要它启用了,它的工具 JSON schema 和
系统提示词段就会出现在每一次请求里,哪怕这次对话完全用不到它。

典型场景:

  • 装了「小说写作」插件,但你 90% 的时间在写代码;
  • 装了「网页搜索」全家桶,但某个离线项目根本不该联网;
  • 学生工作区只需要讲解/脑图,教师工作区只需要备课/教案。

本插件把"要不要让模型看见"从全局下沉到工作区,不动全局开关、不重启、不重载插件。

它做什么 / 不做什么

做 不做
按目录(含子目录继承)决定哪些工具/段不进 prompt ❌ 不安装/卸载/升级插件
组级开关 + 展开到单个工具名/段名 ❌ 不改变插件的全局启用状态
按来源分档:第三方 / 自定义 / 官方 / 官方可选包 ❌ 不能把全局已停用的插件"变出来"(只减不加)
自动归属推断 + 静态扫包 + 手工归属 ❌ 不回溯已开会话(前缀已经发出去了)
fail-open:任何异常都当作"没配置" ❌ 不碰 sandbox / approval 策略

主要特性

  • 工作区级收窄:配置单位是目录,子目录自动继承最近祖先(给 D:\Projects 配一次,
    D:\Projects\api 就继承)。
  • 只减不加:用的是 DSH 最弱的收窄原语 ctx.tools.restrict(),它只能移除,不会新增能力。
  • 两类可见面都管:工具 schema + 系统提示词段(后者用"同名空文本段遮蔽"实现)。
  • 按来源分档:靠 bundle 的 availability 判断"随 dsh 安装"还是"用户自装",
    第三方档默认展开,官方档默认收起。
  • 归属可手工矫正:每个工具/段右侧有归属下拉,可以把未归属的项并入已有分组或新建分组。
  • 模型可调:workspace_gate 工具支持 status / list / set。
  • 可控的噪声:不写 DOM、不加载宿主客户端包、颜色只用 --dsw-alias-* 主题 token。
  • 可测试:核心逻辑抽在 lib/policy.mjs,24 条单测,不启动 DSH 也能跑。

界面

插件管理页会多出一个 「按工作区」 页签:

插件照常加载;勾掉的插件,它的工具与提示词段不再进入这个目录的请求。
存储: ~/.dsh/data/workspace-gate.json                        [重新扫描]
工作区  (default-workspace)  (my-project ●)  (+ 添加目录)
C:\work\my-project  · 跟随全局 · 已关 1 组 · 共 9 组
插件组                                                    [筛选…]
› 第三方  2                                    ≈ 2.7k
[网] web-search-free   [9 工具][1 段]        ≈2.7k   ›  ●
› 自定义分组  1
› 官方  7                                      ≈ 17.8k
› 官方可选包  1
› 未归属  27
  • 行尾开关 = 这一组在这个目录下是否可见;
  • › 展开后可以只勾单个工具/段,右侧下拉可以改它的归属;
  • 顶部显示当前目录、是否已单独配置、关了几组、大概省多少 token/轮。

安装

本插件是标准 DSH bundle(package.json 里声明 dsh.bundle.patch)。
三种装法,推荐顺序从上往下;装好后都会在插件管理页出现「工作区插件门控」这一行。

> 已发布到 npm:dsh-workspace-gate@0.1.1。
> 能访问 npm 的机器可以直接
> dsh plugin --profile add dsh-workspace-gate@0.1.1,不必走 GitHub。

> 版本要求:engines.dsh = ^0.2.1-rc.2。比这更老的 DSH 会被插件管理器直接拒绝安装,
> 而不是装上以后在运行期报错。

方式 1 · 让 AI 帮你装(最省事,推荐新手)

新开一个会话,把这句话发给助手:

> 帮我安装这个 DSH 插件:github:M1r0er/dsh-workspace-gate

助手会调用 plugin_manager 完成「pnpm 安装 → 选中 bundle → 激活」整条链路,最后告诉你
application: applied。然后刷新页面即可。

  • 前提:当前会话的预设启用了 plugin_manager 工具。DSH 默认只在 Creator 模式下启用它,
    其它预设默认关闭;如果助手说没有这个工具,切到 Creator 再试,或改用方式 2。
  • 安装 Host 代码属于高权限操作,会请求一次性授权。

方式 2 · Web 插件页安装(不碰命令行)

  1. 打开 DSH 的 插件 页;
  2. 点安装入口,在 spec 里填 github:M1r0er/dsh-workspace-gate
    (也可以填你本地 clone 的绝对路径);
  3. 若弹出 “Allow these scripts and retry”,确认后重试一次;
  4. 列表里出现 dsh-workspace-gate 即装好,刷新页面;
  5. 确认「工作区插件门控」这一行是开启状态。

方式 3 · 命令行(知道自己在做什么的人)

# A. 用 dsh CLI(profile 不是 Desktop 时)
dsh plugin --profile  add github:M1r0er/dsh-workspace-gate

# B. 直接进 profile 目录用 pnpm
cd ~/.dsh/profiles/
pnpm add github:M1r0er/dsh-workspace-gate

# C. 本地目录(开发/调试)
git clone https://github.com/M1r0er/dsh-workspace-gate.git
pnpm add link:<克隆下来的绝对路径>

# D. 从 npm(0.1.1 起可用)
dsh plugin --profile  add dsh-workspace-gate@0.1.1

> --profile 决定改哪个 profile 目录:--profile web 改的是 ~/.dsh/profiles/web,
> 而桌面版 GUI 跑的是 desktop profile —— 装进 web,桌面窗口里看不到,两个 profile 的
> 依赖和 dsh.profile.bundles 互相独立。要装进桌面版,请用它自己的插件页
> (npm 版 CLI 会拒绝管理 desktop)。

> ⚠️ pnpm 只装依赖,不会把包写进 dsh.profile.bundles。
> 少这一步插件不会加载。装完必须再做一件事:
>
> - 打开 Web 插件页,把 dsh-workspace-gate 这个 bundle 打开;或
> - 手工在 ~/.dsh/profiles//package.json 的 dsh.profile.bundles
> 数组末尾加 "dsh-workspace-gate"。
>
> 然后重启 DSH(没有 HMR 时)才会加载。

装好后:关掉插件管理页里「工作区插件门控」这一行 = 门控整体不生效,行为回到未安装状态(fail-open)。

常见坑

现象 原因 / 处理
装完插件页没有这一行 bundle 没被选中:按方式 3 的提示把它加进 dsh.profile.bundles
返回 already-installed 同 spec 已装过;先在插件页 Remove 再装
桌面版提示 CLI 不接管 Desktop profile 由 Electron 托管,npm CLI 会拒绝管理它;请用 Web 插件页
安装卡在 build scripts pnpm 11 默认拦截安装脚本;在弹窗里批准后重试
想在插件市场里搜到 仓库已打 dsh-plugin topic,但要在市场出现还需被 awesome-dsh-plugin 索引收录(提交 PR)

使用

给人

插件管理 → 「按工作区」→ 选目录 → 关掉不需要的组 → 保存。对新会话生效。

给模型

workspace_gate(action:"status")                          # 最近哪些会话命中了哪个目录、摘掉了什么
workspace_gate(action:"list")                            # 可门控的插件 → 工具名/段名
workspace_gate(action:"set", dir:"D:\\Projects\\api",
hide:["plugin:r18-novel"])               # 需要显式给 dir
workspace_gate(action:"set", dir:"D:\\Projects",
show:["tool:read"])                      # 从隐藏清单移除

> 这个工具没有用 deferLoading:实测打开后子会话里它直接不可见,模型想调也调不到。

两种写法等价(dir 必须是绝对路径,子目录会继承):

  • 隐藏整组:plugin:<分组 id>
  • 隐藏单项:tool:<工具名> / section:<段名>

归属是怎么判断的

DSH 运行时不记录某个工具是哪个插件注册的(tools.register() 只按名字存),
所以"按插件勾选"只能推断。本插件按强度依次尝试:

顺序 手段 说明 可靠度
1 段名命名空间 r18-novel:protocol → r18-novel,与插件 id/包名归一后比较 高(约定)
2 工具名前缀 工具名 token 与插件 id 或包名 token 的前导全等匹配 中高
3 静态扫包 读包入口(第三方递归扫 .js)里的 name: 'x' 定义位,与未归属工具名求交,只在唯一命中时采纳 较高
4 手工归属 界面里自己指定,赢过以上全部 最高

静态扫包解决的是这类情况:dsh-free-search 的 profile 行 id 是 web-search-free,
而它注册的 platform_search / video_search / weather 等名字里根本不含包名——
只靠前缀只能认出 1/9,扫包之后 9 个全部归位。

硬边界:官方内置包在 app.asar 里,磁盘上没有目录,扫不到;运行时动态注册的工具
(没有对应文件插件)也没有包可扫。这些会留在「未归属」,用手工归属分类即可。

数据存放

/data/workspace-gate.json(本机示例:~/.dsh/data/workspace-gate.json)

{
"version": 1,
"overrides": {
"d:/projects/api": ["plugin:r18-novel", "tool:free_search_news"]
},
"assignments": {
"tool:read": "文件工具"
}
}
  • overrides:按工作区的隐藏清单,键是归一化目录(小写 + /),子目录继承最近祖先;
  • assignments:全局的手工归属,赢过自动推断,只改分组、不影响"要不要隐藏";
  • 文件损坏 / 读不到 → 退化为空配置(全放行),不会让门控把会话搞挂。

为什么不是"真·停用插件"

三条硬理由:

  1. 全局状态。profile 的 disabled 是每个 profile 一份,不是每个工作区一份;
    两个工作区想一开一关只能来回改文件。
  2. 来回改 = 反复重激活。会触发 Loader 重载,而且同时开两个工作区会互相打架。
  3. 那也不省 token。真停用省的是内存与启动开销;而 token 取决于 prompt 里有什么。
    本插件摘的正是"模型侧的东西",与工作区数量无关。

实测数据

本机 DSH 0.2.0-rc.2 / desktop profile:

事实 数值
全局可见工具(tools.schemas(undefined)) 19
4 个 preset 作用域并集 53
某个具体会话可见工具 52–59
提示词段(按 preset 并集取) 20
插件行总数 204

两个踩出来的坑:

  1. 只查全局会漏掉 34+ 个工具——多数标准工具由 agent preset 在自己的作用域注册,
    清单必须按 preset 逐个 agentPresets.acquireScope(id) 取并集。
  2. systemPrompt.assemble() 是 async,不 await 只拿到一个空对象。

验证记录(对某个目录隐藏 tool:read 与 section:free-search:engines 后新开子会话):

bound = { cwd: "D:\\DSH Workspace", key: "d:/dsh workspace",
deny: ["weather"], sections: ["free-search:engines"], skipped: [] }
weather             in agentTools    : no
free-search:engines in agentSections : no

skipped: [] 说明两个名字都被接受——包括 preset 作用域里的工具,即 restrict 对
"继承面"(全局 + 祖先层)有效,不必是全局注册。

开发

npm run check   # node --check 三个入口
npm test        # 24 条单测(纯逻辑,不需要 DSH)
index.js              Host 半:绑定 agent、workspace_gate 工具、HTTP 路由
client.js             Client 半:插件页「按工作区」页签
lib/policy.mjs        纯逻辑:目录匹配、归属推断、spec 展开、存储规整
tests/policy.test.mjs 上面那层的单测
cordis.patch.yml      组合包的行声明
locale/{zh,en}.json   插件管理页标题与描述
icon.svg              图标

Host 与 Client 之间的通道是本插件自注册的 HTTP 路由
(/workspace-gate/state|apply|assign|refresh):第三方插件的 Host 服务无法凭空长出
一个 remote namespace,而 webServer.register() 是宿主公开的接缝。

已知边界

  1. 只对新会话生效:已开会话的前缀已经发出去,不回溯。
  2. 只减不加:不会把全局已停用的插件变出来。
  3. 归属靠推断:app.asar 内与动态注册的工具无法自动归属,需手工分类。
  4. restrict 只作用于继承面:极少见的、在该 agent 自己层注册的工具会落进 skipped。
  5. 折叠状态不持久化:刷新后回到默认展开策略。

许可证

MIT © 2026 M1r0er


本仓库打了 dsh-plugin topic,便于在 DSH 插件索引/市场里被检索到。

常见问题

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

在 DSH 里执行 `dsh plugin --profile web add github:M1r0er/dsh-workspace-gate` 即可。

dsh-workspace-gate 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-workspace-gate 安全吗?

低风险。

dsh-workspace-gate 装之前要先确认什么?

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

dsh-workspace-gate 用的是什么许可证?

上游标注为 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 万 星

M1r0er 的其它插件

2 个

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