本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

skills

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:upstash/skills

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

常见问题

装了之后代理能直接帮我建 Upstash Redis 数据库吗？

能，但需先在会话里执行 /upstash-login <email> <api-key> 把凭证写入 ~/.dsh/.credentials.yaml，DSH 才会启动 MCP 子进程。未配凭证时技能仍可用，但只能走 HTTP/SKILL 文档路线（README.md:96-101 / .dsh-plugin/index.mjs:55-60）。

为什么 /upstash-login 提示某个变量无法写入？

因为同名变量（UPSTASH_EMAIL 或 UPSTASH_API_KEY）已经从 DSH 启动环境继承，环境来源优先级高于托管凭证。需要先在启动环境里清掉它，再重试命令（.dsh-plugin/index.mjs:111-118）。

凭证存放在哪里？会被写进会话日志吗？

两条凭证写到 ~/.dsh/.credentials.yaml；/upstash-login 命令注册时设了 recordInput: false，命令行输入的 email/key 不会进入会话日志，MCP 子进程环境变量会被宿主的 scrub 规则剥离同名敏感字段（README.md:100 / .dsh-plugin/index.mjs:73-99）。

不装 DSH 也能用这套技能吗？

可以。仓库同时是 Agent Skills、Claude Code、Cursor、OpenAI Codex、Zed 五种插件形态；DSH 路径会顺带挂载 MCP，别的 Agent 路径只挂载 SKILL.md 文档（README.md:5 / README.md:25-80）。

改了一个子技能的 SKILL.md 后还要做什么？

在仓库根目录跑 npm run build，scripts/build.mjs 会把所有子技能重组成 skills/upstash/ 下的合并技能并自动生成 SKILL.md。如果忘记 build，CI 的 npm run check 会失败（AGENTS.md:5-13 / .github/workflows/check.yml:16）。

这套技能里 upstash-redis-start 跟其他 Redis 技能有什么区别？

upstash-redis-start 不需要账号，一条 POST 到 https://upstash.com/start-redis 就能拿到一个 3 天有效的临时 Redis（带 endpoint + token），适合代理在拿不到正式凭证时做短期记忆/对话历史/工作队列；其余 Redis 技能针对的是已开通的 Upstash Redis（skills/upstash-redis-start/SKILL.md:6-14）。

为什么 DSH 安装时要带 --profile web？

仓库的 DSH 入口是 .dsh-plugin/cordis.patch.yml + .dsh-plugin/index.mjs，只在声明引用它的 profile（README 里以 web 为例）启动时挂载；不指定 profile 的话装到默认配置中可能不生效（README.md:86-92 / .dsh-plugin/cordis.patch.yml:1-9）。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: >=20（CI 使用 Node 20，运行时仅使用 node:url 内置模块，未声明更严格要求）
• Platforms: 跨平台

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则