@amaster.ai/pi-teamwork
Pi扩展用于团队合作和项目管理. 提供LLM可调用的工具,与问题跟踪器和项目管理系统互动.
支持供应商
- 复数卡 ——基于CLI的适配器通过 莫多卡语name
配置
自动安装
运行时自动安装被禁用,因为可变的软件包管理龙头和下载脚本无法提供证书含剂过程中所需的被绑定的文物验证. 单独安装一个被绑定的 Multica 释放并打开已核实的二进制 $PATH,或配置 multica.binary。 。 。 .
堕落者 autoInstall: true 设置不再执行安装器。 它只在二进制缺失时报告一个明显的错误.
配置可能生活在用户/代理设置或信任的工程中 .pi/settings.json。当信任下降而不扩展时,项目设置会被忽略 ${ENV_VAR};在用户或代理设置中保存环境支持的证书.
模式 1 —— 自托管服务器
对于运行自己的Multica服务器的团队. 扩展运行 multica setup self-host 以提供的 URL 进行认证,然后以符号进行认证 :
{
"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 一次在机器上,通过多卡的正常流量完成登录. 扩展将重用该状态:
{
"pi-teamwork": {
"enabled": true,
"provider": "multica",
"multica": {
"workspace": ""
}
}
}
模式 3 – 无头符 (多相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相
对于无法运行的 CI 或非交互环境 multica setup。扩展将运行 multica login --token <token> 每页 session_start数字 :
{
"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写作仍然需要用户授权.
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需要安装的证据.