@celljs/ta-channels
A pi package for Ta: agents with roles of their own and channels where the user, Ta and the agents talk; Ta builds the team for what the user wants
Package details
Install @celljs/ta-channels from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@celljs/ta-channels- Package
@celljs/ta-channels- Version
4.28.0- Published
- Nov 22, 2026
- Downloads
- 4,705/mo · 3,348/wk
- Author
- muxiangqiu
- License
- MIT
- Types
- extension
- Size
- 646.1 KB
- Dependencies
- 0 dependencies · 0 peers
Pi manifest JSON
{
"web": [
"./web/index.js"
],
"host": "./host/index.mjs",
"icon": "Users",
"title": {
"en": "Agents and channels",
"ja-JP": "エージェントとチャンネル",
"zh-CN": "智能体与频道",
"zh-TW": "智慧體與頻道"
},
"summary": {
"en": "Agents with roles of their own that work with you and Ta in group chats, called channels.",
"ja-JP": "役割を持つエージェントを作り、チャンネルであなたや Ta とグループチャットで協力します。",
"zh-CN": "创建各有职责的智能体,在频道里和你、Ta 一起群聊协作。",
"zh-TW": "建立各有職責的智慧體,在頻道里和你、Ta 一起群聊協作。"
},
"extensions": [
"./extension/index.mjs"
],
"permissions": {
"host": {
"*": "agent.edit",
"listAgents": "agent.view",
"listChannels": "channel.view",
"request:post": "channel.post",
"request:watch": "channel.view",
"request:openAgent": "agent.use",
"request:setLimits": "settings.manage",
"request:setNotice": "channel.manage",
"request:addMembers": "agent.edit",
"request:resumeRound": "channel.post",
"request:changeMember": "channel.manage",
"request:createChannel": "agent.edit",
"request:deleteChannel": "channel.manage",
"request:updateChannel": "channel.manage"
},
"tools": {
"hand_off": "agent.use",
"create_agent": "agent.edit",
"list_channels": "channel.view",
"add_to_channel": "agent.edit",
"create_channel": "agent.edit",
"post_to_channel": "channel.post",
"update_channel_notice": "channel.manage"
}
}
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
Cell - Ta Channels
Ta 自带的 pi 包(默认开启,可在 Web 客户端的 设置 → 包 关闭):智能体与频道。由三部分组成,都不改 Ta 的核心:
- 服务端(
pi.host,web-src/host.ts→host/index.mjs):ta serve 在本进程里运行它一次。团队、消息和待回答的队列都由它保管和推进,转发在服务端进行,关掉页面也继续。 - pi 扩展(
pi.extensions,web-src/extension.ts→extension/index.mjs):给 Ta 的会话加上团队工具,经pi.events取得服务端的团队。 - Web 扩展(
pi.web,web-src/index.tsx→web/index.js):只负责显示和发起修改。
概念
- 智能体:一个普通的 Ta 会话,加上名字和职责(作为
appendSystemPrompt),会话名就是智能体的名字,会话属于@celljs/ta-channels分组(对话列表里折成一行)。每个智能体有自己的卡通头像(ui.Face那一套,ta-relay 的FaceUtil画,25 种形状和配色,记在face里;新建时尽量不和已有的重样,没有face的旧数据按 id 分配),会眨眼,回答时左右张望;Ta 自己仍是 Cell logo。会话文件一打开就记下,下次从文件重新打开。智能体的会话里没有团队工具。 - 频道:成员(智能体,第一个是负责人)和消息。消息发给其中
@到的成员;智能体的回答贴回频道,它在回答里@谁就再交给谁。每个智能体一次只处理一条消息。用户可以把成员设为免打扰(muted):它在这个频道里什么都不回答,被@也不回答;负责人免打扰时,没人被@的消息交给下一位没有免打扰的成员。 - 讨论预算(
ChannelsUtil.limit,设计见 docs/design/ta-channel-rounds.md):一条用户或 Ta 的消息开启一轮,智能体之间接力不限跳数,按群聊的"讨论长度"(简短 / 标准 / 深入,… 菜单里改)限制这一轮花的 token 和回答条数;花到 70% 时提示智能体收尾;你在看这个群时预算翻倍、没人在时减半,智能体只附和、重复或两人来回没进展时提前停下,这一轮改了文件或公告则到预算时自动续一次(×1.5)。另有三层按 token 的上限(设置 → 群聊用量):单条回复超了就地停下,每个群每天超了只回答你(每个群也可在群聊信息里单独设),所有群每天超了全部暂停并通知你;点"继续讨论"可越过当天的上限。停下时频道里追加一行"讨论暂停,等你决定",带这一轮的回复数和 token,下面是"继续讨论"(接上被截下的接力,预算重新计)和"请负责人总结"两个按钮,只能选一次;post_to_channel的返回里也带上这句。 - 工具:ta serve 里 Ta 的每个会话(Web 页面里的对话,以及连到 ta serve 的其他客户端)都有
create_agent、create_channel、add_to_channel、post_to_channel、list_channels。用户说一个目标("组个团队做落地页")时,Ta 建好智能体和频道、把目标贴进去,等各成员回答完再回复用户;频道缺某个角色时,Ta 用add_to_channel把已有的智能体加进来(加在已有成员之后,负责人不变);开着的页面在侧栏给这个频道标一个绿点,打开后消失。中途停止 Ta 只是不再等待,智能体会在频道里接着回答。 - 交给…(参照微信的转发,但转的是工作):对话里说"这个交给 @life",或在输入框的 + 里选"交给…"再挑一个智能体或频道,Ta 先在这个对话里写一份交接摘要(目标、已完成和已决定的、剩下的或卡住的、相关的文件和命令),再用工具
hand_off交出去。交给智能体时,摘要作为一条消息进入它自己的对话(开头是"交接自'某某对话'",原对话的会话文件写在给模型读的<context>里,摘要不够时它可以去读),它接着干;交给频道时,摘要作为 Ta 的一条消息贴进频道,由负责人回答。两者都不等回答,用户在那边跟进。原对话里留一张"已交给 @life"卡片(模型读不到),显示摘要,点"打开"进入对方的对话或频道。没有 Ta 工具的外部 Agent 在 + 发起的这一轮把摘要写进ta-handoff代码块,由 pi 扩展交出去。服务端方法是TeamService.handOff(web-src/handoff.ts)。 - 频道公告与智能体名片(见
docs/design/ta-social.md):频道的公告(决定 / 约定 / 待办)放进每个成员每条消息的<context>,成员用工具update_channel_notice随讨论更新,用户在聊天上方的公告栏查看和编辑,每次改动在频道里留一行提示。成员菜单"分享名片…"生成名片链接和二维码(TeamService.shareAgent,30 天,电脑关机也能打开;只带名字、头像和隐去密钥的职责);在 Ta 里打开名片链接,选目录后"加为我的智能体"(addFromCard),它先看这个项目,用update_my_role把职责改得贴合这里。 - 分身的任务(见
docs/design/ta-double.md):Ta 用工具建的频道带by: 'ta'和建它的会话origin,作为分身的任务(registerTasks)列出,不进用户自己的"频道"分组;它建的智能体带temporary,只在团队里出现,在成员面板或智能体菜单里"留下"后才成为常驻成员,不在任何频道里的临时智能体也列在成员里。导航栏里这个列表叫"分身":分身卡片、"任务"(一个列表,待你处理的在前,然后进行中、已结束)、"成员"(像通讯录,可选按目录分组)、"频道",各组可折叠(折叠状态存在浏览器本地)。从任务打开的团队显示在右侧工作台,顶栏可"在主区打开"。分身开启"开始任务前先问我"时,建团队前、以及第一次往用户放行过以外的频道派活前,用ctx.ui.confirm询问。下文的列表描述里,原先平铺的频道和智能体现在分别在"频道"和"成员"分组。 - 界面:导航栏最上面的"智能体"(在"对话"上面,手机上是第一个底部标签)把分身、频道和智能体放在一起(分身是 ta-web 内置的页面,开启后列在最上面,导航栏里不再单独出现):侧栏顶部是搜索框和 +。+ → 新建智能体在主区域打开一个草稿页:先给一个没人用的名字和头像,顶栏点名字可以改名、从 25 个头像里挑,侧栏顶部多一行"还没开工";输入框发出第一条消息时才真正建好智能体(职责是通用的,具体做什么写在这条消息里),随即切到它的会话并发出这条消息。+ → 新建频道是一个弹窗:名称、搜索并勾选智能体(1–12 个,先勾的是负责人)、创建;频道行是负责人在前、下一位成员在后的叠放头像,名称旁标出负责人,第二行是最近一条消息或谁正在回答;智能体按工作目录分组,第二行是"空闲"或正在哪个频道回答,右侧是最近一次发言的时间。点智能体打开它的会话:立即切过去,以智能体的名字显示"正在打开"(
pi.switchSession接收openAgent请求的 Promise),服务端打开或找到会话后显示为当前对话。智能体行悬停(触屏上常显)出现 …,菜单里是:停止(中止它正在进行的回答)、重新开始(开新会话)、重命名、职责(编辑系统提示词里的角色,下一个会话生效)、移至…(换工作目录,在新目录开新会话)、复制工作目录、导出对话(Markdown,去掉频道的上下文块)、加入频道、删除(退出所在频道,只剩它的频道一并删除,会话文件保留);靠近底部时菜单向上展开。频道是主区域的一个页面(不进右侧工作台),以群聊显示:别人的消息在左边带头像和名字,用户的在右边,连续发言合成一组,停顿久了插一行时间;顶栏是频道名和成员头像,点头像在右侧工作台打开"频道成员"(members,location: 'panel'的视图,跟着当前频道):列出成员,负责人带标记,正在回答的标绿;每行点开是智能体的会话,悬停(触屏上常显)出现设为负责人、免打扰、重开会话(忘掉之前的对话,下次回答时开新会话,旧会话仍在对话列表里)和移出频道(至少留一位);顶部"添加成员"换成可搜索的智能体列表,勾选后添加,列表底部的"新建智能体"打开新建智能体的草稿页;底部是删除频道(再确认一次,消息一并删除,正在进行的回答不再贴出)。输入框就是对话的输入框(pi.ui.Composer),@列出成员,+ 里可以点名成员、添加成员(打开频道成员的添加列表),或"做成扩展"(在频道里请负责人用 ta-package 技能把这里商量和做成的事做成扩展);消息用对话的 Markdown 渲染(pi.ui.Markdown),点名的成员加粗。 - 群聊信息与模型:频道顶栏的成员头像打开右侧“群聊信息”(原“频道成员”):成员列表旁的“统一模型”一次让群里所有智能体改用同一个模型(
setChannelModel;成员各用各的时显示“各用各的”),每个成员行的快捷设置(智能体菜单里也有)一处改名字、模型和职责;成员下面是群聊名称、主题和置顶聊天。智能体的model(<provider>/<model id>,不设就用 pi 的默认)在它打开会话时用上,已开着的会话当即切换(TaExtensionHost.setModel),pi 没有的模型不会保存;它在群聊里回答时(ta-rooms)也用这个模型。
数据与转发
数据存在服务器上的 <agentDir>/extension-data/@celljs/ta-channels.json,只有服务端写;每个频道保留最近 200 条消息。
| 键 | 内容 |
|---|---|
team |
智能体与频道 |
messages/<频道> |
频道的消息 |
queue |
还欠着的回答(job:哪个智能体回答哪条消息、第几跳、属于哪一轮)和各轮的计数 |
working |
正在回答的智能体 |
focus |
Ta 用工具建过或发过消息的频道,页面据此在侧栏标出 |
页面通过 pi.storage.onChange 得知变化后重新读取。页面要改什么(新建智能体、新建频道、添加频道成员、设负责人 / 免打扰 / 移出成员、删除频道、重开智能体的会话、修改或删除智能体、以用户身份发消息、打开智能体的会话),调用服务端的 request:本包的 Web 扩展用 pi.callHost('request', request),其他扩展用 pi.packages.callPackageHost('@celljs/ta-channels', 'request', [request])(别的包的服务端用 host.callPackageHost);request 的类型是 TeamRequest(web-src/channels-model.ts),返回结果,出错时抛出原因。每个回答先作为 job 记进 queue,回答贴进频道后才移除。ta serve 重启后接着处理剩下的 job:已经有回答(频道里有该智能体对这条消息的回复)的 job 不会再问,已经交出去的消息也不会再交一次,所以已处理的消息不会重复转发。重启时正在回答、还没有贴出的那一条,会再问一次。
别的包要知道有哪些智能体(如 ta-rooms 列出可以邀请进群聊的),调用服务端的 listAgents(callPackageHost('@celljs/ta-channels', 'listAgents')),不要读 team:它返回 TeamAgentInfo[](web-src/channels-model.ts),每个智能体的 id、name、role、mark、face(早于头像的智能体按 id 分到的那个)、cwd,设了模型的带 model,Ta 为自己的团队临时建的带 temporary;只读,不含会话文件。
限制
- 只有 ta serve 有团队:单独运行
ta(CLI,没有 ta serve)时,团队工具仍然存在,但调用时会返回"需要 ta serve"的说明,不会创建或转发任何东西。包的服务端没能启动时,工具会说明启动失败,请看 ta serve 的日志。 - 用户没有
@任何人的消息按群聊的"没 @ 时谁接话"(Channel.reply,群聊信息里改):负责人接(默认,即第一个没有免打扰的成员,它自己答或@别人)、大家都接(每个成员都收到,负责人一定答,其他成员没什么要补充就回PASS,不贴出)、只回 @(没人接,和有好友的群聊一样)。点了名的(哪怕点的是免打扰的或不在群里的智能体)只交给点到的人。Ta 发的没点名的消息总是交给负责人;智能体的回答没有@谁时,接力到此结束。 - 页面的修改要等服务端处理;包被关掉或它的服务端没能启动时,页面上的操作会直接报错。
以后
- 任务板可以作为另一个包,基于同样的智能体与频道。
为什么不进核心
pi 的核心只管一个会话怎么跑;多会话由 ta serve 提供(openSession 带 appendSystemPrompt 和 group、prompt、getState、getLastAssistantText),包的服务端部分由宿主运行(pi.host)。智能体和频道只是把这些组合起来的一种产品形态,换一种组织方式(任务板、流水线)就是另一个包,所以它和用户自己做的包一样是可选的 pi 包。核心只提供宿主能力:内置包的加载与开关、包的服务端部分、包的服务端数据及其变更通知。
开发
源码在 web-src/,三个入口:index.tsx(页面)、host.ts(服务端)、extension.ts(pi 扩展);team.ts 是服务端的团队,channels.ts 是页面看到的团队,channels-util.ts 是两边共用的纯逻辑。bun run build 先用 tsc 检查并编出 lib/(单测跑 lib/**/*.spec.js),再用 bun build 把三个入口各打成一个没有 import 的文件。发布的包只带这三个文件(web/、host/、extension/),不带源码。React 取自页面(web-src/react.ts 的 bind(pi.React)),图标用 pi.ui.icons。端到端测试(假模型、真的 ta serve)在 apps/ta/test/builtin-packages.spec.ts。