# @debuffjp/share 中文文档

规范地址：https://npmcn.com/package/%40debuffjp/share/

版本：0\.33\.0
npm 元数据更新时间：2026-11-11T02:35:19.407Z
中文译文更新时间：2026-11-11T18:59:18.697Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40debuffjp/share
原文对照：https://npmcn.com/package/%40debuffjp/share/?lang=original
项目主页：https://debuff.jp/
源码仓库：https://github.com/debuffjp/debuff

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：34.6 kB，22 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-10-19T03:46:34.489Z
- 最新版本发布：2026-11-11T02:35:18.998Z
- 近 30 天下载量：7005（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：44（近 12 个月 44 个）

## 中文简介

解禁游戏的剪贴板、共享工作表和挑战链接

## 安装

```sh
npm install @debuffjp/share
```

也可以使用：`pnpm add @debuffjp/share`、`yarn add @debuffjp/share`、`bun add @debuffjp/share`

## README

# @ debuffjp/ share (英语)

让你的游戏容易被传递:最后几秒钟的片段,系统共享表,以及"击败我的跑"挑战链接. 没有依赖关系,每个出口都可以自行使用.

```ts
import { ClipRecorder, challengeLink, clipFile, readChallenge, share } from "@debuffjp/share";

// A friend opened a challenge link: play their seed
const challenge = readChallenge<{ seed: number; score: number }>();
if (challenge) game.random.reseed(challenge.seed);

// Keep the last ~12 seconds while a run is going
const clips = new ClipRecorder(game.canvas, { seconds: 12 });
clips.start();

// On a "share" button (share needs a click or key press)
const clip = await clips.clip();
await share({
  text: `I scored ${score}. Beat it?`,
  url: challengeLink({ seed, score }),
  files: clip ? [clipFile(clip, "my-run")] : [],
});
```

-   `share()` 打开一个共享工作表,复制文本并链接其他内容。 它回来了 `"shared"`, (中文(简体) ), `"copied"`, (中文(简体) ), `"cancelled"` 或者说 `"unsupported"` 这样你就可以展示正确的祝酒词.
-   `ClipRecorder` 运行两个交错 `MediaRecorder`s,所以当运行开始而不是在页面负载上开始. `ClipRecorder.supported()` 告诉你是否要显示剪辑按钮 .
-   挑战数据可见于URL. 把游戏状态放进去 从不针对个人.
-   `screenshot(canvas)` 财务报告和审定财务报表 `download(blob, name)` 覆盖"保存图像"按钮.
-   `postIntent({ text, url }, "x" | "bluesky")` 返回打开 X 或 Bluesky 作曲的链接,该链接带有已起草的后缀,切入以适应(X上280个加权字符,链接在 Bluesky 上为23,300个图表)。 什么也没有发布。 在您想要的地方使用它, 例如在 devlog 帖子的 dev 脚本中; debuff 从未将其添加到游戏中 。 增入0.26册.

## 常见问题

### @debuffjp/share 是什么？

解禁游戏的剪贴板、共享工作表和挑战链接

### 如何安装 @debuffjp/share？

在项目目录运行 npm install @debuffjp/share，或使用 pnpm add / yarn add / bun add。

### @debuffjp/share 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @debuffjp/share 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @debuffjp/share 可以商用吗？

@debuffjp/share 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @debuffjp/share 的下载量有多少？

根据 npm 官方下载统计，@debuffjp/share 在 2026/10/12 – 2026/11/10 这 30 天内被下载 7,005 次，日均约 234 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @debuffjp/share 还在维护吗？

最新版本 0\.33\.0 发布于 2026/11/11（今天）；至今共发布 44 个版本，其中过去 12 个月发布了 44 个；首次发布于 2026/10/19。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。