前言¶
在 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。
