# @amaster\.ai/pi-teamwork 中文文档

规范地址：https://npmcn.com/package/%40amaster.ai/pi-teamwork/

版本：0\.1\.37
npm 元数据更新时间：2026-11-09T02:53:31.790Z
中文译文更新时间：2026-11-09T08:39:35.714Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40amaster.ai/pi-teamwork
原文对照：https://npmcn.com/package/%40amaster.ai/pi-teamwork/?lang=original
项目主页：https://github.com/TGYD-helige/pi#readme
源码仓库：https://github.com/TGYD-helige/pi

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

- 包体积（解压后）：1.7 MB，16 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：typebox \*，@earendil-works/pi-coding-agent \>=0\.79\.1
- 首次发布：2026-05-25T12:29:00.712Z
- 最新版本发布：2026-11-09T02:53:31.616Z
- 近 30 天下载量：3435（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：126（近 12 个月 126 个）

## 中文简介

通过Multica为团队合作和发行管理提供扩展皮

## 安装

```sh
npm install @amaster.ai/pi-teamwork
```

也可以使用：`pnpm add @amaster.ai/pi-teamwork`、`yarn add @amaster.ai/pi-teamwork`、`bun add @amaster.ai/pi-teamwork`

## README

# @amaster.ai/pi-teamwork

![pi-teamwork preview](https://raw.githubusercontent.com/TGYD-helige/pi/master/packages/pi-teamwork/preview.png)

Pi扩展用于团队合作和项目管理. 提供LLM可调用的工具,与问题跟踪器和项目管理系统互动.

## 支持供应商

-   **复数卡** ——基于CLI的适配器通过 [莫多卡语name](https://github.com/multica-ai/multica)

## 配置

### 自动安装

运行时自动安装被禁用,因为可变的软件包管理龙头和下载脚本无法提供证书含剂过程中所需的被绑定的文物验证. 单独安装一个被绑定的 Multica 释放并打开已核实的二进制 `$PATH`,或配置 `multica.binary`。 。 。 .

堕落者 `autoInstall: true` 设置不再执行安装器。 它只在二进制缺失时报告一个明显的错误.

配置可能生活在用户/代理设置或信任的工程中 `.pi/settings.json`。当信任下降而不扩展时,项目设置会被忽略 `${ENV_VAR}`;在用户或代理设置中保存环境支持的证书.

### 模式 1 —— 自托管服务器

对于运行自己的Multica服务器的团队. 扩展运行 `multica setup self-host` 以提供的 URL 进行认证,然后以符号进行认证 :

```json
{
  "pi-teamwork": {
    "enabled": true,
    "provider": "multica",
    "multica": {
      "serverUrl": "https://api.your-server.com",
      "appUrl": "https://your-server.com",
      "token": "<token-from-multica-server>"
    }
  }
}
```

### 模式2——预配置环境

运行 `multica setup` 一次在机器上,通过多卡的正常流量完成登录. 扩展将重用该状态:

```json
{
  "pi-teamwork": {
    "enabled": true,
    "provider": "multica",
    "multica": {
      "workspace": ""
    }
  }
}
```

### 模式 3 – 无头符 (多相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相

对于无法运行的 CI 或非交互环境 `multica setup`。扩展将运行 `multica login --token <token>` 每页 `session_start`数字 :

```json
{
  "pi-teamwork": {
    "enabled": true,
    "provider": "multica",
    "multica": {
      "token": "<token-from-multica-server>"
    }
  }
}
```

> ⚠️ `token` 是一个证书。 保持它不受版本控制——将其放入仅本地设置文件或通过env替代配置来注入.

| 外地 | 说明 |
| --- | --- |
| `enabled` | 启用/ 禁用扩展名 |
| `provider` | 提供商名称 (`multica`(中文(简体) ) |
| `multica.binary` | Multica 二进制的路径( 默认 : `multica`(中文(简体) ) |
| `multica.workspace` | 工作空间 ID 覆盖; 留空以使用 multica 默认 |
| `multica.token` | 无头标志. 当Multica已经登录在机器上时关闭 |
| `multica.serverUrl` | 自托管服务器 API URL. 触发器 `multica setup self-host --server-url` 启动时 |
| `multica.appUrl` | 自托管服务器前端 URL. 需要时间 `serverUrl` 是一个远程地址 |
| `multica.autoInstall` | 已贬值的相容性旗; 没有执行安装器( 默认 : `false`(中文(简体) ) |

## 工具

| 工具 | 说明 |
| --- | --- |
| `issue_list` | 列出带有可选过滤器(地位、受让人、项目、限制)的问题 |
| `issue_get` | 获取特定问题的详细信息 |
| `issue_create` | 创建新问题 |
| `issue_update` | 更新现有问题(标题、说明、地位、优先权、受让人) |
| `issue_comment` | 对一个问题添加评论 |
| `project_list` | 列出工作空间中的所有工程 |
| `teamwork_status` | 检查提供者/ 守护状态 |

## 图标

-   `/teamwork-status` — 显示当前提供者状态

## 建筑

```
src/
├── index.ts              # Generic tool layer (provider-agnostic)
├── types.ts              # TeamworkProvider interface + shared types
└── adapters/
    └── multica.ts        # Multica CLI adapter + initialization
```

扩展使用提供者模式—— `index.ts` 登记工具,授权给 `TeamworkProvider` 接口。 添加新的供应商(Linear, Jira等)只需要执行接口并在其中添加一个工厂分支 `session_start`。 。 。 .

## 结构化结果(Pi 0.99+)

团队工作工具声明 `outputSchema`: 工作空间 列表/问题 列表/项目 列表返回 `{ workspaces | issues | projects, total, truncated }`; 问题 get/create/更新返回 `{ issue, truncated }`; 问题返回 `{ comment, truncated }`. 发行对象保留其现有的ID/状态和公共领域;排除任意提供者元数据. 团队工作 状态暴露了提供者和可用的运行/pid/状态字段,不包括原始的 CLI 输出. 失败者返回 `{ error, truncated }` 与 `isError: true`,没有CLI诊断或证明. Tracker写作仍然需要用户授权.

```javascript
const result = await tools.issue_list({ status: "todo" });
if (result.error) throw new Error(result.error);
text(result.issues.map(issue => ({ id: issue.id, title: issue.title, status: issue.status })));
// Once the user has authorized this issue's status update:
// await tools.issue_update({ id: result.issues[0].id, status: "in_progress" });
```

结构化输出限于12个KiB,而顶级列表则限于100个完整的记录. `truncated: true` 表示省略的记录; `total` 保留已有的原始数。 超大小记录,带有 `id` 保留完整的ID和小分级元数据,省略大字段,并携带 `truncated: true` 在记录和信封上;呼叫者必须在重新使用内容进行更新之前检查该旗帜。 没有记录ID的超大小结果返回打出输出限制错误,而不是剪接路径或内容. 当发生这种情况时, 写入可能已经完成: 在重试前检查保存状态 。 可读文本和渲染器细节是独立限定的.

Multica初始化在背景中运行,一个10秒的预算跨越CLI检查,设置,守护进程启动,以及登录. 普通的提示不等待它;团队协作工具等待初始化. 每个后期工具或状态命令引用有一个30秒的最后期限,涵盖初始化等和所有CLI步骤. 呼叫器取消到达运行中的CLI并阻止后续命令(包括剩下的更新/获取步骤);会话关闭会取消未完成的CLI工作.

### 诊断失败

配置和登录失败停止初始化,并保持对等待工具的可见性,带有安全错误类别. 一个失败的守护进程启动只有在状态检查确认守护进程正在运行后才会被接受. 版本检测超时不被视为CLI需要安装的证据.

## 常见问题

### @amaster\.ai/pi-teamwork 是什么？

通过Multica为团队合作和发行管理提供扩展皮

### 如何安装 @amaster\.ai/pi-teamwork？

在项目目录运行 npm install @amaster\.ai/pi-teamwork，或使用 pnpm add / yarn add / bun add。

### @amaster\.ai/pi-teamwork 支持 TypeScript 吗？

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

### @amaster\.ai/pi-teamwork 支持 ESM 还是 CommonJS？

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

### @amaster\.ai/pi-teamwork 可以商用吗？

@amaster\.ai/pi-teamwork 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @amaster\.ai/pi-teamwork 的下载量有多少？

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

### @amaster\.ai/pi-teamwork 还在维护吗？

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