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

快速上手

petdex

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:crafter-station/petdex#path:packages/petdex-desktop-native/integrations/dsh

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

— 源: plugins.install

关键要点

• The HTTP API. petdex.dev/api/manifest returns every approved pet with its slug, spritesheet URL, animation states, and metadata.
• The pet package format. Every pet is a pet.json plus a spritesheet.{webp,png} rendered as an 8x9 grid of 192x208 frames, or the v2 8x11 grid.
• Submit a pet: petdex.dev/submit or npx petdex submit <path>.
• List your project: open a Built with Petdex issue.
• Fix a bug or add a feature: read CONTRIBUTING.md, then open a PR.

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装完之后为什么 Petdex 还显示"Restart DSH Web"？

这个插件是 Cordis bundle，不会被 DSH 热加载。安装成功后必须手动重启一次 npx @deepseek-ai/dsh web，然后启动或继续一个真实任务，Petdex 才会从 ~/.petdex/runtime/dsh-handshake.json 读到握手信息并显示 Connected。单纯打开 DSH 不触发任何事件，握手不会完成。

插件会把我的提示词、工具参数、模型输出发给 Petdex 吗？

不会。插件只监听官方 session lifecycle 事件，归一化后只投影 5 个状态（jumping/running/waiting/waving/failed）、显示文案、会话 ID、序号和事件类型；提示词、工具参数、模型输出和审批内容都被丢弃。POST 只发到本机 127.0.0.1:7777，并需要 ~/.petdex/runtime/update-token 里的 token 鉴权。

我点宠物应该会跳转到 DSH 当前会话，为什么只打开了默认浏览器？

V1 没有精确的浏览器 tab 定位能力。点宠物只会激活当前 macOS 默认浏览器，不会跳到任何 URL、不会打开新标签，也不会区分 DSH 占用了哪个 tab。这是当前刻意保留的兜底行为，不是 bug。

我把 DSH 装在自定义目录（DSH_HOME 指向非 ~/.dsh）怎么配置？

在 Petdex 进程的运行环境里设置同名 DSH_HOME。从 Finder 启动的 Petdex 不会继承只在交互式 shell 里 export 的变量；如果 DSH 用了自定义 home，安装前需要把 DSH_HOME 也注入到 Petdex 进程可见的环境里，否则 Petdex 会找不到 profile。

卸载后 DSH Web 里还能看到这个插件怎么办？

卸载命令只调用 dsh plugin --profile web remove @petdex/dsh-plugin，不会清掉 DSH profiles、sessions、models 或其它插件。卸载完成后同样需要手动重启一次 DSH Web，让运行中的进程卸载插件 bundle。

安装命令报 "Plugin command failed - check npx and network" 怎么排查？

桌面端跑的是 npx --package=@deepseek-ai/[email protected] [email protected] dsh plugin --profile web add，需要 npx 和能访问 npm registry。装全局 pnpm 不是必须的（命令里带了内嵌版本）。错误通常意味着 Finder 启动的 shell 没继承 PATH、registry 不通，或者桌面包里的 tarball 哈希校验失败（桌面会清掉握手并报错）。

这个插件能在 Linux 或 Windows 上用吗？

不能。Petdex 桌面本身跨平台，但 DSH 集成是 macOS 优先的首发切片（agent_hooks.zig 注释明确写了 "DSH Web is macOS-only in the first integration slice"）。Linux/Windows 上 Petdex Settings 里 DeepSeek Harness 这一行只会显示 "Not detected"。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6
• Node: 未声明

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则