拼豆小憩是 DeepSeek Harness（DSH） Web 端的插件：在右侧边栏打开一块像素拼豆板，照着模板拼、自由拼，或者用一句话让模型生成图纸，拼完「熨烫」定型，导出 PNG。

特性

• 模型忙时的入口：会话标题栏的豆子按钮，或模型运行 3 秒后输入框上方的小胶囊「趁现在拼一个？」。
• 12 个模板：淡色引导豆和完成度，拼完「熨烫」定型，撒彩豆庆祝。
• AI 生成图纸：一句话 → 一次模型调用 → 图纸落到豆板上，显示消耗的 tokens。
• 图片转图纸：拖入或粘贴图片，裁剪、选尺寸和颜色数，在本机转成图纸。
• 我的作品：熨烫过的作品自动收进作品墙，可导出 PNG、复制图片、再拼一次。
• 跟随 DSH：中英文界面、浅色/深色主题，键盘和读屏可用。

截图

主页与 12 个模板	一句话生成图纸
图片转图纸，全程在本机	作品墙

_{截图跟随你的 GitHub 主题显示浅色或深色版本。}

安装

需要 DSH 0.2.1-rc.3 或更高版本（package.json 的 engines.dsh 为 >=0.2.1-rc.3）。桌面客户端自带的 0.2.1-rc.3、npm 上的 0.2.1-rc.5 和之后的版本都满足。版本更低时 DSH 会拒绝安装，提示 is incompatible with dsh …，不会装任何东西。

插件只有 Web 界面，可以装进 DSH 的 Web 端和桌面客户端。TUI、ACP 这类没有 Web 界面的 profile 不支持。不需要 allowBuilds：仓库里已经提交了构建好的 lib/，也没有任何安装脚本。

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
  

确认生效：插件页的已安装插件里出现本插件，会话标题栏右侧出现豆子按钮。

卸载

# Web
npx @deepseek-ai/dsh plugin --profile web remove dsh-pindou
# 桌面客户端：先完全退出，再用客户端自带的 dsh；也可以直接在「插件」页里卸载
dsh plugin --profile desktop remove dsh-pindou

使用

• 打开：点会话标题栏右侧的豆子按钮，或者模型运行 3 秒后出现的小胶囊「趁现在拼一个？」。胶囊每个会话最多出现两次，你开始打字、面板已打开或窗口太窄时不出现，可以在 ⋯ 菜单里关掉。
• 模板：豆板上有淡色的引导豆，顶部显示完成度；拼完先问要不要「熨烫」。
• 工具：画笔、取色、橡皮、填充、撤销/重做、清空（5 秒内可以撤回）。豆板 12 / 16 / 24 三种尺寸，16 种颜色。
• 导出：导出 PNG，或者「复制图片」到剪贴板（浏览器不支持时这个按钮不显示）。
• 快捷键：桌面端默认 ⌘⌥K / Ctrl+Alt+K 打开或收起面板，可以在设置的快捷键里改绑。Web 端没有默认键（这组键已经是 DSH 的「搜索会话」），需要的话在设置里自己绑。
• 键盘与读屏：方向键移动光标，空格/回车放豆，Delete 擦除；豆板是带标签的 grid，每格会读出位置、颜色和引导色。

AI 生成图纸

一句话（例如「一只橘猫」）→ 一次模型调用 → 校验并修复图纸 → 落到豆板上，同时显示消耗的 tokens。相同的请求会命中本地缓存（最多 24 条），不再花 tokens。

模型按下面的顺序选：

1. DSH 当前的默认模型（和你聊天用的是同一个，无需额外配置）。
2. 如果 DSH 没有可用的模型路由，而环境变量里有 DEEPSEEK_API_KEY，直接调用 DeepSeek API（deepseek-flash，关闭思考模式）。
3. 都没有时，AI 页会提示「还没有可用的模型」，模板和自由拼不受影响。

检测只看凭据有没有配置，不会为此调用模型；账号登录等无法提前确认的情况会提示「首次生成会检测模型配置」。Key 失效时，第一次生成失败后会一直显示未配置，直到你点「重新检测」。DSH 没有给插件开放跳到「模型」设置的接口，「打开 DSH 设置」按钮只在能用设置快捷键打开时出现（打开的是设置首页），其他情况只给文字步骤。

- id: pindou
  config:
    provider: deepseek-official
    model: deepseek-v4-flash
    maxTokens: 1024

隐私与权限

• 图片：图片只在本机处理，不会上传，不发网络请求，也不花 tokens；原图不保存、不落盘，只保存量化后的图纸编码。
• 密钥：只在 DSH 的服务端进程里读取，不会发到浏览器。
• 存储：只在浏览器里，localStorage 的 dsh-pindou:v1（进度）、dsh-pindou:works（作品墙）、dsh-pindou:ai-cache:v1（AI 图纸缓存），以及 sessionStorage 的 dsh-pindou:hints（小胶囊本会话出现的次数）。
• 网络：浏览器里的插件只向 DSH 自己的服务发请求（同源：生成和检测两个接口，以及按需加载的两个模块）。唯一发往外部的请求是「AI 生成图纸」的那次模型调用，由 DSH 服务端发出：走 DSH 的模型路由，或你配置的 DeepSeek API 直连兜底（只允许 https，本机测试除外）。检测模型配置时不调用模型；没有任何统计或上报。

开发

pnpm install
pnpm run check      # lint + typecheck + 测试 + 构建 + bundle 形状检查
pnpm run e2e        # 从源码启动 DSH Web，用 Playwright 跑一遍，截图写进 $TMPDIR/pindou-e2e-out（加 -- --update-assets 会刷新 docs/assets/screens 里的面板截图）

代码分三层：src/core（纯逻辑：豆板、模板、图纸校验修复、缓存，无 DOM）、src/client（React 界面与 DSH 客户端胶水）、src/host（DSH 服务端：模型调用）。DSH 的界面约束和设计决定记在 docs/dsh-ui-constraints.md。

参与贡献请看 CONTRIBUTING.md，变更记录见 CHANGELOG.md。

许可证

MIT © 2026 Teloi