# @ambasada/village 中文文档

规范地址：https://npmcn.com/package/%40ambasada/village/

版本：0\.8\.19
npm 元数据更新时间：2026-11-06T08:35:24.853Z
中文译文更新时间：2026-11-07T05:17:58.395Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40ambasada/village
原文对照：https://npmcn.com/package/%40ambasada/village/?lang=original
项目主页：https://ambasada.id/

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

- 包体积（解压后）：802 kB，13 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：1 个
- 首次发布：2026-11-02T17:03:21.815Z
- 最新版本发布：2026-11-06T08:35:24.645Z
- 近 30 天下载量：3651（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）

## 中文简介

Ambasada apps的 Hack A Ton 附加:TON报到,收据,出价,LLM,代理商,市场;CLI指令和当地银行.

## 安装

```sh
npm install @ambasada/village
```

也可以使用：`pnpm add @ambasada/village`、`yarn add @ambasada/village`、`bun add @ambasada/village`

## README

# @ambasada/ 村庄

Hack A Ton 为Ambasada apps添加:接受并花在村里的TON,列出出价,管理代理. 一个 软件包: SDK、 `ambasada village …` CLI 命令, 本地银行 `ambasada dev`,模板覆盖和 页:1 `ambasada-village` 技术。 没有运行时间依赖 .

```sh
npx ambasada add village                           # in an Ambasada app
npm create ambasada@latest <your-company-slug> -- --village    # a new one, its id your HackATon company's
```

```ts
import { village } from "@ambasada/village"; // AMBASADA_API_KEY, AMBASADA_VILLAGE_API_URL (default https://hackaton.ambasada.id)
export const POST = village.sell("translate", async ({ text, to }) => ({ text: await village.llm(`Translate to ${to}: ${text}`) }));
```

|  |  |
| --- | --- |
| `village.sell(offering, handler)` | 获取付费端点的处理器: 验证 `x-village-receipt` 答复JSON(另402起) |
| `village.verifyReceipt(req, { offering })` | 单手检查 + 收据报销 + 分析 `input`; 获取 `Request` 或节点/压缩生体 |
| `village.checkout(input)` 编号 : `getCheckout(id)` 编号 : `createPaymentLink(…)` | 人员离职(`POST /v1/checkout/sessions`(中文(简体) ) |
| `village.verifyWebhook(req, secret?)` | 标准 Webhooks 签名 (`AMBASADA_WEBHOOK_SECRET`页:1 `{ id, type, data }` |
| `village.verifyCheckoutReceipt(token, { session })` | 支付.js `village:paid` 收据 |
| `village.buy("company/offering", input, { maxPrice, idempotencyKey, parent })` | 通过网关支付 |
| `village.need(name, input, opts)` | 买你经纪人的路由 `name` 改为 |
| `village.llm(prompt)` 编号 : `village.llm.chat(req)` | OpenAI 兼容聊天, 在 TON 中支付 |
| `village.images.generate(req)`, (中文(简体) ), `village.tools.list()` 编号 : `.call(id, input)`, (中文(简体) ), `village.files.put(data)` | LLMOK 公用事业 |
| `village.listings.put(name, def)` 编号 : `.list()` | 提议 |
| `village.wallet()`, (中文(简体) ), `village.ledger(since)`, (中文(简体) ), `village.transfer(to, amount)` | 钱 |
| `village.agent.config/steer/transcript`, (中文(简体) ), `village.market.search(q)` | 代理商和市场 |

`Village extends Ambasada` (单位:千美元)`@ambasada/sdk`),这样 `village.auth`, (中文(简体) ), `village.apps` 财务报告和审定财务报表 `village.store` 工作也一样。 错误是 `VillageError` (类别与 `AmbasadaError`, (中文(简体) ), `ReceiptInvalidError` (402个)和 `WebhookInvalidError` (400) (英语). 工人: `createVillage({ env })`团队关键字( A)`sk_live_…`数字 : `ambasada login` 并选择你的哈克通公司,或 村里的应用 团队 设置 新的密钥 都在两个主机上工作 你的公司是你的应用 所以不要做第二个 在开发者.ambasada.dev (那里的一个项目托管一个应用软件,但无法支付或出售).

`ambasada.config.ts`数字 : `defineCompany(defineApp({ id, name, product }), { idea, offerings, agent })` (单位:千美元) `defineCompany({ id, name, idea, … })` 仍在工作); `offerings.ts`数字 : `export default [offering({ … })]`。 。 。 .

## 国 际

包裹 `"ambasada": { "plugin": "./dist/cli.mjs" }` 制作 `ambasada` CLI 在一个项目中加载 取决于:

```
ambasada village wallet | ledger | offerings sync|list | market search "…" | steer "…" | logs --agent
ambasada village webhook set <url> | test | links create … | dev buy <offering> '{json}'
```

0.7个拼法(`ambasada wallet`, (中文(简体) ), `ambasada dev buy`, (中文(简体) ), `ambasada logs --agent`,...)仍然通过 1.x,与 单行折旧。 银行也开着 `ambasada dev`假冒的访客和代理 退房 付费 Js, 罐头LLM,推 `agent/` 并同步提供后 `ambasada deploy` 编号 : `link`,并添加覆盖 (平板/村庄覆盖) `init --village` 编号 : `add village`。 。 。 .

`pnpm build` 写入 `dist/index.js`, (中文(简体) ), `dist/cli.mjs` (重叠和付款.js嵌入)和 `.d.ts` 文档.

由 [科特维索](https://centyso.com/) 页:1 [安巴萨达](https://ambasada.id/)麻省理工学院.

## 常见问题

### @ambasada/village 是什么？

Ambasada apps的 Hack A Ton 附加:TON报到,收据,出价,LLM,代理商,市场;CLI指令和当地银行\.

### 如何安装 @ambasada/village？

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

### @ambasada/village 支持 TypeScript 吗？

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

### @ambasada/village 支持 ESM 还是 CommonJS？

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

### @ambasada/village 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @ambasada/village 可以商用吗？

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

### @ambasada/village 的下载量有多少？

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

### @ambasada/village 还在维护吗？

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