dsh-pet-corner

Author / Maintainer: @Zacklinkk

DSH 的轻量摸鱼角：右下角是一只可拖动的小猫，点击后可浏览猫、狗和狐狸图片、 猫咪知识与收藏。所有第三方请求都先经过宿主白名单代理，浏览器不会直接访问外站。

安装

# 已登录私有 npm registry
dsh plugin --profile web add @deepseek-ai/dsh-pet-corner@0.0.1-rc.3

# 本地开发 checkout
dsh plugin --profile web add link:/path/to/dsh-pet-corner

包内已经声明 dsh.bundle.patch；dsh plugin add 会自动维护 Profile Bundle。 不要手工修改 profile manifest，也不要重复插入 pet-corner loader row，否则会得到 duplicate loader entry id。

功能与网络边界

• 小猫挂件、来源开关、默认狗狗品种和自动换图周期；
• 收藏仅保存在当前浏览器的 localStorage；
• 图片面板打开后才会通过宿主白名单代理访问 Cataas、Dog CEO、RandomFox、 TheCatAPI 和 Cat Facts；仅加载页面不会预热这些上游；
• 设置通过插件自有的 /plugins/dsh-pet-corner/api/settings 读写，不依赖 DSH rc.3 配置面的 namespace allowlist；该端点仅接受 loopback 同源请求；
• 插件不需要 API Key。上游不可用或返回非成功状态时，代理会以 HTTP 200 返回 包内图片或兼容 JSON，避免把预期的第三方故障暴露成浏览器 4xx/5xx；图片面板仍可重试。

兼容性

组件	支持范围
DSH	>=0.1.0-rc.3 <0.2.0
Node.js	>=22.19.0
Profile	web

宿主路由使用 rc.3 的 webServer 服务名；本版本不兼容 rc.1 的 httpServer 名称。 设置页使用现存的 settings.section slot，但持久化不经过通用 settings API。

开发

npm install --legacy-peer-deps
DSH_NODE_MODULES=/path/to/dsh-runtime/node_modules npm run setup:dsh-workspace
npm run typecheck
npm test
npm run build
npm pack

构建产出 lib/index.js（宿主）和 lib/client.js（浏览器 ModuleLoader 包）。测试和 smoke 不访问真实宠物上游；代理行为用本地替身验证。

License

BSD-3-Clause