@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

Packages

Package details

extension

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。