DSH 极简片段/命令工具箱:5 个工具,一个可手工编辑的 JSONL 文件,零 UI、零数据库、零网络,只有明确说存才存。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:taxueseek/dsh-snippets
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。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
DeepSeek Harness 极简「常用片段/命令」工具箱:把高频命令、代码、网址、提示词存下来,任何会话里一条工具调用就能找回。
- 一个 JSONL 文件(
~/.dsh/snippets/snippets.jsonl),人类可读、可手工编辑、本身就是备份 - 五个工具,语义一眼可懂,没有多余概念
- 零 UI、零数据库、零网络:不加新运行时依赖,只有 harness SDK
- 显式记忆:AI 不会自动记录你的对话,只有你明确说「存」才存
功能
| 工具 | 作用 |
|---|---|
snippet_save |
保存或覆盖一条片段(同名覆盖并更新时间) |
snippet_search |
按子串搜索(匹配名称/正文/标签,不区分大小写) |
snippet_get |
按确切名字取回一条 |
snippet_delete |
删除一条 |
snippet_count |
统计总数 |
用法(模型视角)
- 存:
snippet_save(name: "docker-logs", text: "docker logs -f --tail 100 myapp", tags: ["ops"]) - 找:
snippet_search(query: "logs")→ 返回docker-logs - 取回:
snippet_get(name: "docker-logs")→ 拿到全文直接执行
为什么极简
- 不占上下文:不自动注入记忆,只在调用工具时才取回
- 可预期:存了什么、在哪、长什么样,一清二楚(就是那个 JSONL 文件)
- 内容是你挑的:存的是你特意收藏的,不是 AI 替你判断的
- 轻:无数据库、无向量库、无 UI 面板、无额外服务
数据
- 路径:
~/.dsh/snippets/snippets.jsonl - 每行一条 JSON:
{"name","text","tags","updatedAt"} - 损坏行自动跳过,不影响其余数据
- 片段名限制
[A-Za-z0-9._-]{1,80},单条上限 2 万字符
安装
# 从 GitHub 安装(与 taxueseek 其他插件一致)
dsh plugin --profile web add "github:taxueseek/dsh-snippets#main&path:."
# 重启 dsh web
(本地开发:dsh plugin --profile web add /path/to/dsh-snippets)
配置
- id: snippets-toolkit
name: 'dsh-snippets'
config:
snippetsDir: '~/.dsh/snippets' # 数据目录
maxEntryChars: 20000 # 单条片段字符上限
defaultLimit: 20 # search 默认返回条数
开发
npm install --include=dev
npm test # node --test 单元测试(11 项)
npm run build # tsc 编译 host TS
许可
MIT
安装
```sh dsh plugin --profile web add taxueseek/dsh-snippets ```
贡献
欢迎提交 PR。
链接
同类插件
Tencent/WeKnora#dsh-weknora★ 37918
把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己带引用的 RAG 或 ReAct agent 回答(含可续聊的 session id)。
DayuanJiang/next-ai-draw-io#dsh-plugin★ 37097
dsh 的 draw.io 绘图插件:通过 next-ai-drawio MCP 服务器作图,点回复里的链接在右侧栏打开实时预览,可以手动修改图,AI 的每次修改都是可以恢复的版本。需 Node.js 18+,首次使用由 npx 下载 MCP 服务器。
superdesigndev/treg★ 8650
给 Agent 的工具目录:按「要做的事」检索约 2,600 个外部接口(SEO 与 SERP、外链、社交、人物与公司信息补全、广告库、抓取),查看参数与单次调用价格后直接调用,凭据由服务端注入。附带技能,MCP 行在未设置 TREG_TOKEN 前保持禁用。
T-Auto/dsh-ops★ 5964
为 Windows 的 DSH 提供 bash、PowerShell 7 及 Rust 高性能工具,减少 token 消耗。
sixtysevenlf/dsh-blender-plugin★ 2216
让 DSH agent 通过直连 TCP 通道驱动本地 Blender,提供 15 个工具:视口帧、自定义视角渲染、Python 执行、无头与作业卸载、事务回滚,以及 34 个 family / 228 个 op 的规划层。
helloHub1212/dsh-windows-mcp★ 2002
通过官方 MCP 客户端桥接层把 CursorTouch/Windows-MCP 桌面自动化服务器接入 DSH,把截屏、UI 树快照、鼠标键盘输入、剪贴板、进程与注册表等工具注册成 mcp__windows__* 供模型调用,并附带 windows_mcp_doctor 诊断工具;Computer Use 默认关闭,需在插件面板里打开。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。