输入栏权限控件旁有一个「纯净模式」开关:开启后该会话不挂载任何 skill —— skill 工具与目录一起消失,再点一次即恢复。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:owenKu1010/dsh-pure-mode
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
English | 简体中文
一个极小的 DSH bundle:在输入栏的权限控件旁加一个开关。开启后,该会话完全不挂载 skill ——
skill 工具消失,随每个请求一起发送的那份持久 skill 目录也一起消失。
用在该用它的地方:纯问答、写作、临时跑一条命令;或者不希望模型自己判断「目录里某条看起来适用」而擅自加载。
[ + ] [ ⛨ 完全权限 ▾ ] [ A|B ] [ (叶子) 纯净模式 ] [ ✦ 专家 ▾ ] [ ⏻ PUA ] [ 模型 ▾ ]
↑ 这个
| 状态 | 看到的样子 | 模型拿到的东西 |
|---|---|---|
| 关(默认) | 1px 品牌蓝描边、无底色、蓝色叶片、正常文字色 | 和原先完全一样 |
| 开 | 同一个描边胶囊被品牌蓝灌满、文字反色、实心叶片 + 圆点 | 没有 skill 工具,没有 skill 目录 |
再点一次即恢复,从下一个 step 起生效。
先说清楚:这和 dsh-purge 没有关系
名字都带「净化/清洗」的味道,容易误会,所以写在最前面:本插件与 dsh-purge 无关,
不替代它、不扩展它、也不依赖它。两者解决的问题完全不同:
| dsh-purge | 纯净模式(本插件) | |
|---|---|---|
| 动的是什么 | 指令/提示词层的权威性:打补丁、注入 shim、写 override 文件 | 一个在线会话的工具可见性 |
| 改动落在哪 | profile 里的文件,组合时生效 | 只在该 Agent 的上下文里加一条工具限制 |
| 何时生效 | 需要重启组合 | 下一个 step 生效,不用重启 |
| 怎么撤销 | 回滚补丁/shim/override | 释放限制,工具立刻回来 |
| 作用范围 | 整个 profile | 单个会话 |
它除了 $DSH_HOME/pure-mode/ 之外不写任何文件,也不读 purge 的状态、不改任何提示词文本。
两者可以装在同一个 profile 里共存,互不影响。
为什么需要它
每个会话的每个请求都在付两笔钱:
skill工具的 schema;- 一条持久的
<available_skills>user 消息,逐个列出所有模型可调用的 skill 及其截断描述。
用得上的会话里,这份目录值这个价。用不上的会话里,它是持续的开销,还是一张「随时可以去加载点什么」的邀请函。 纯净模式就是「一个会话内把这个子系统整个关掉」的那个开关,不改补丁、不改 preset、不碰别的插件。
安装
这是一个标准 DSH bundle(package.json 里的 dsh.bundle.patch),装进某个 profile:
- 克隆到磁盘任意位置:
git clone https://github.com/owenKu1010/dsh-pure-mode.git - 在 DSH 里打开 Plugins → Add plugin,指向克隆下来的目录(本地目录安装)。
- 确认
@local/dsh-pure-mode这一行是启用状态,然后刷新页面一次。
它会作为一个 bundle 解析,插入一行名为 pure-mode 的插件;客户端那一半需要刷新一次页面才会出现在输入栏。
前提:组合里挂着随附的 skill 工具(@deepseek-ai/dsh-tool-skill,默认 base 组合自带)。除此之外没有别的依赖。
用法
- 开关按会话保存:每个会话保留自己的选择。
- 从没点过开关的会话,沿用最近一次切换留下的值 —— 新会话继承你上一个决定。
- 选择存在
$DSH_HOME/pure-mode/state.json,删掉这个文件就一切归零为关。 - 开很便宜(只追加一条很小的空目录声明);关要重发整份目录 —— 那才是费 token 的方向, 能决定就尽量在第一条消息之前决定。
$DSH_HOME/pure-mode/client.log记录每个页面实际加载的客户端 bundle 版本(build=v4), 这样「是不是旧标签页」是查出来的,不是猜出来的。
配置
默认只藏 skill。要把 skill 相关的其余工具也一并收走(例如技能管理器注册的 create_skill),
在 profile 补丁里整行重述 config:
- id: pure-mode
name: '@local/dsh-pure-mode'
config:
denyTools: [skill, create_skill]
名字必须是该 Agent 能看到的全局工具名。写错不会静默失败:开关会提示「工具隐藏失败」,
宿主日志里带着 tools.restrict() 给出的已知工具清单。
配套推荐:DSH Skills Manager(建议一起装)
纯净模式是全有或全无的开关。要逐条管理 skill —— 单个开/关、整个来源开/关、从仓库里浏览安装 —— 请配 DSH Skills Manager(作者 MichengAI):
github.com/MichengAI/dsh-skills-manager
@michengai/dsh-skills-manager· Apache-2.0 · 持续维护中
两者作用在不同层,天然互补:
| 技能管理器 | 纯净模式 | |
|---|---|---|
| 管什么 | 单个 skill、单个来源 | 整个 skill 工具 |
| 怎么实现 | ctx.skills 注册表里的逐条调用策略 |
agent.ctx.tools.restrict() |
| 关掉之后 | 每条 skill 保持各自状态 | 整块恢复 |
管理器会把「被你关掉的 skill」报告成 { modelInvocable: false, userInvocable: false },
所以它一开始就进不了目录、skill 工具拒绝加载、/name 手势也不认。纯净模式只藏工具,因此
永远不会把你那边关掉的重新打开:
- 纯净模式开:一个都不挂(包括管理器允许的);
- 纯净模式关:回到「管理器允许什么就是什么」,你在那边关掉的照样不出现、也加载不了;
- 纯净模式开着时去管理器里开关 skill:状态照常写入,关掉纯净模式后按新结果生效。
也就是说:纯净模式关掉 = 恢复原状,而这个原状已经扣掉了你在管理器里关掉的那些。
实现(就这一段)
在该 Agent 自己的上下文上做一次工具限制,Agent 或插件消失时释放:
agent.ctx.effect(
() => agent.ctx.tools.restrict({ deny: ['skill'] }),
'pure-mode: hide the skill tool for this session',
)
@deepseek-ai/dsh-tool-skill 每一步准备时会把「自己注册的那份 skill 定义」和「该 Agent 实际解析到的定义」
做同一性比较。所以被限制掉的工具会同时带走模型侧的 schema 和那条持久目录;而从没发布过目录的会话,
干脆一条都不会有。
客户端那一半没有任何权限:它只通过 ctx.connection.fetch 注册的、已认证的同源路由 /api/pure-mode
读写宿主保存的状态,由宿主决定是否施加限制。UI 是注册进 conversation.input.left 槽位的普通 React 组件,
只使用 --dsw-alias-* 主题 token。
注意事项
- 历史只追加、不回收。 已经发出去的目录留在对话里继续计费到压缩为止;节省是从会话开头起算,不是回溯性的。 开 → 关 → 开 这样的来回切,每次都会追加一条替换消息。
- 工具表变化会断开前缀缓存。 工具定义在请求最前面,所以每次切换都可能让该轮不再复用既有 prompt 缓存。
/skill-name手势仍然可用(针对管理器允许的 skill)。手打 skill 名是用户动作,不是「挂载」,宿主不拦截。- 作用面是工具,不是注册表。 其他工具、MCP、插件都不受影响。
- 限制需要「可被限制」的注册。 若某套组合把 skill 工具注册在 Agent 自身层(而不是祖先层),
tools.restrict()会拒绝;此时开关会明确报告失败,而不是假装成功。 - 已在 DSH
0.2.2-rc.3+ Windows(Electron 44 / Chromium 152)上验证。除公开服务 (tools/connection/agents)外没有使用任何版本特定的接口,但其他版本未验证。
仓库结构
package.json bundle 清单:dsh.bundle.patch + dsh.client
cordis.patch.yml 插入 `pure-mode` 这一行
index.js 宿主:状态、对账、tools.restrict、/api/pure-mode
client.js 客户端:输入栏开关
locale/{en,zh}.json 插件列表标题/描述 + 开关文案
icon.svg 插件图标
docs/DETAIL.md 插件详情页正文
许可
MIT,见 LICENSE。
链接
同类插件
tw93/Mole#mole★ 75286
开源磁盘清理工具 Mole CLI(mo,支持 macOS 和 Windows)的官方 skill:按 Mole 的 JSON 输出查看磁盘占用、预览并执行清理、查看已安装应用、读取系统健康状态和清理记录。清理前先用 --dry-run 预览并征得同意,卸载应用和需要管理员权限的步骤留给用户在自己的终端里执行。插件只带 skill,CLI 需另外安装。
zhu1090093659/dsh-web#packages/dsh-skill-explorer★ 10458
技能中心:按来源分级浏览已加载的全部 skill,启用/禁用模型调用、创建新技能、删除进可恢复回收站。
QingYunA/answer-me-with-html★ 6365
把回答做成一页可视化 HTML:模型只写简短的 Markdown 草稿,随包附带的 `am` 命令行生成页面,支持流程图、时序图、树、时间线、ER 图、表格和提示框。
iflytek/skillhub#dsh★ 5432
在 DeepSeek Harness 内浏览、搜索 SkillHub 技能,并管理本地技能的安装、更新和卸载。适配 DSH 0.2.0-rc.2 与 0.2.1-rc.2,暂不兼容 0.2.1-rc.3。
hyhmrright/brooks-lint★ 1578
提供六个代码质量技能,涵盖代码审查、架构审计、技术债、测试质量、健康看板与修复。
GanyuanRan/Aegis★ 1443
面向编码 Agent 的软件工程方法包,提供基线优先规划、系统化调试、提示词卫生、完成前验证,以及修复/退役双轨跟踪技能。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。