前言¶
在 DeepSeek Harness（DSH）里跑长对话或等模型思考时，界面往往只能盯着进度条。和开第二个窗口刷无关内容相比，在侧栏里做一件有进度、能收尾的小事，更贴合「Harness 把能力拆成插件」的做法。下面介绍社区插件 拼豆小憩（Bead Break，仓库 teloi/dsh-pindou）：在 Web 端或桌面客户端右侧边栏打开像素拼豆板，照着模板拼、自由拼，或用一句话 / 本地图片生成图纸，拼完「熨烫」定型并导出 PNG。
这是什么¶
拼豆小憩由维护者 Teloi 发布，分类为 趣味换装，在 SkillHub 插件目录 与 GitHub 仓库 均可找到。它是纯 Web 界面插件：注入 DSH 会话标题栏、输入区与右侧边栏，不提供 TUI、ACP 等无 Web 界面的 profile。当前版本 0.3.0（以仓库 package.json 为准），许可证 MIT，依赖 DSH >=0.2.1-rc.3（engines.dsh）。
核心功能¶
以下能力均来自仓库 README 与 package.json 说明。
模型忙时的入口
- 会话标题栏右侧的豆子按钮。
- 模型运行约 3 秒后，输入框上方可能出现小胶囊「趁现在拼一个？」（每会话最多两次；开始打字、面板已开或窗口过窄时不出现，可在 ⋯ 菜单关闭）。
模板与拼豆
- 内置 12 个模板：豆板上有淡色引导豆，顶部显示完成度；拼完后可「熨烫」定型，并有庆祝动效。
- 工具：画笔、取色、橡皮、填充、撤销/重做、清空（5 秒内可撤回）。
- 小豆板尺寸 12 / 16 / 24，16 种颜色；「更多尺寸」支持实体钉板预设（29–116）或自定义宽 × 高（8–116），可分块拼，带缩放、小地图、块列表与「只看本色」；大图进度存 IndexedDB，可用
pd2:分享码或图纸文件分享。
AI 生成图纸
- 一句话描述 → 一次模型调用 → 校验并修复图纸 → 落到豆板，界面显示消耗的 tokens；相同请求命中本地缓存（最多 24 条），不再消耗 tokens。
- 模型选择顺序：DSH 当前默认模型（与聊天相同）→ 若无可用路由且环境变量有
DEEPSEEK_API_KEY，则调用 DeepSeek API（deepseek-flash，关闭思考模式）→ 否则 AI 页提示不可用，模板与自由拼仍可用。
图片转图纸
- 主页卡片、拖入面板，或在面板主页 ⌘V / Ctrl+V 粘贴（仅面板获焦时拦截，不影响聊天输入框）。
- 裁成正方形，选尺寸 12 / 16 / 24、颜色数 16 / 8 / 4、抖动与去背景；全程在本机转换。支持 PNG、JPG、GIF、WebP、BMP；不支持 SVG；单文件不超过 20 MB、边长不超过 8000 px。
我的作品
- 熨烫完成的成品自动进入作品墙（最多 60 件，超出删最旧）；可导出 PNG、复制图片、「再拼一次」。进度与作品分别存浏览器 localStorage（键
dsh-pindou:v1、dsh-pindou:works）。
与 DSH 一致的体验
- 中英文界面、浅/深色主题；键盘与读屏可用（方向键移动，空格/回车放豆等）。桌面端默认 ⌘⌥K / Ctrl+Alt+K 开关面板（Web 端无默认快捷键，避免与 DSH「搜索会话」冲突，可在设置里自行绑定）。
仓库已提交构建产物 lib/，安装不需要 allowBuilds。
安装与启用¶
需要 DSH 0.2.1-rc.3 或更高；版本过低时安装会被拒绝并提示 is incompatible with dsh …。插件仅适用于带 Web 界面的 profile（Web、桌面客户端），TUI、ACP 不支持。
Web 端¶
在终端执行：
npx @deepseek-ai/dsh plugin --profile web add github:Teloi/dsh-pindou
然后重启 dsh --profile web。确认：npx @deepseek-ai/dsh plugin --profile web list 中出现 dsh-pindou，且 Web 会话标题栏右侧有豆子按钮。
也可在 Web 侧栏 插件 → 添加插件 → 安装第三方插件，填写 github:Teloi/dsh-pindou（界面文案以 DSH 0.2.1-rc.3 为准，0.2.2 相同）。
桌面客户端（macOS、Windows）¶
桌面 profile 与 Web 分开，需单独安装：
- 客户端内：插件 → 添加插件 → 安装第三方插件，填
github:Teloi/dsh-pindou，按提示重启客户端。 - 或使用客户端自带的
dsh（先在应用菜单 管理 dsh 命令… 安装；客户端至少打开过一次并完全退出后）：
dsh plugin --profile desktop add github:Teloi/dsh-pindou
确认：已安装插件 列表中有本插件，会话标题栏有豆子按钮。注意：用 npm 安装的 npx @deepseek-ai/dsh plugin --profile desktop … 会报错 profile "desktop" is managed exclusively by the Electron application，应使用客户端提供的 dsh 路径。
插件发布到 npm 后，可将上述地址换为包名 dsh-pindou（镜像同步可能有延迟，装不上时可改用 npm 官方源或稍后再试）。
卸载¶
# Web
npx @deepseek-ai/dsh plugin --profile web remove dsh-pindou
# 桌面：完全退出客户端后，用客户端自带的 dsh，或在「插件」页卸载
dsh plugin --profile desktop remove dsh-pindou
可选配置（AI 生成）¶
Web profile 可在 $DSH_HOME/profiles/web/cordis.patch.yml 中用 id pindou 覆盖部分 AI 相关项，例如：
- id: pindou
config:
provider: deepseek-official
model: deepseek-v4-flash
maxTokens: 1024
桌面 profile 的同类配置写在 $DSH_HOME/profiles/desktop/cordis.patch.yml。未知键或非法值会导致插件加载失败并给出原因；具体键表见仓库 README「可选配置」一节。
典型用法¶
- 安装并重启 DSH Web 或桌面客户端后，在任意会话点标题栏 豆子按钮，或等模型运行几秒后点 趁现在拼一个？。
- 跟模板拼：在主页选一个模板，按淡色引导逐格填色，顶部看完成度，完成后选择 熨烫。
- AI 图纸：打开 AI 生成，输入一句话（如「一只橘猫」），等待一次模型调用后图纸出现在 16×16（或所选尺寸）豆板上。
- 照片变图纸：在 图片转图纸 拖入或粘贴图片，调整尺寸与颜色数，预览满意后 开始拼。
- 收尾： 导出 PNG 或 复制图片；熨烫过的作品在 我的作品 中按月份查看，可 再拼一次。
图片转图纸与作品墙为按需加载模块；DSH 过旧不支持动态加载时，卡片会提示「需要新版 DSH」；加载失败可点重试。
适用场景与注意¶
适合谁：经常在 DSH Web 或桌面客户端里等模型输出、又希望侧栏里有轻量、可完成的像素小活动的用户；需要快速把照片或一句话变成拼豆图纸时也可用它，图片路径不离开本机。
安全与权限：第三方 DSH 插件与 DSH 进程同权运行。安装前应阅读 GitHub 源码 与 MIT 许可证，自行判断是否信任维护者 Teloi。AI 生成会消耗与聊天相同的默认模型 tokens（或在你配置了 DEEPSEEK_API_KEY 时走 DeepSeek API）；插件不会为此单独开放跳转到 DSH「模型」设置的接口，需按界面提示在 DSH 设置中自行配置。
生态说明：SkillHub 目录 是社区插件索引，与 DeepSeek / 幻方无官方从属关系；DSH 本身遵循「一切皆插件」的扩展方式，拼豆小憩是其中一条趣味向侧栏能力。
结尾¶
拼豆小憩把「等模型」的空档收成侧栏里可拼、可熨、可导出的拼豆流程：12 个模板、本机图片转图、可选 AI 图纸与作品墙，并跟随 DSH 的语言与主题。若要安装或查更新，可看目录页 https://www.skillhub.cn/plugins/Teloi/dsh-pindou 与仓库 https://github.com/Teloi/dsh-pindou。
