Docs
CONTEXT.md Source

Workspace

Shared folder, artifacts, attachments, search.

On this page
  1. 工作区(Workspace)
  2. 工作目录(Work dir)
  3. 产物(Artifact)
  4. 附件(Attachment)
  5. 搜索(Search)

工作区(Workspace)

账户级一个本地目录。文件、产物、交接附件都在这里;所有 Bot 共用。Bot 之间不隔离。信使侧栏可打开整棵工作区目录(从右侧滑出的独立浮层:文件树 + 预览,不占用对话框旁那条产物预览);区内 UTF-8 文本可在查看器里改并保存回同一路径。

Avoid: 云电脑, 每 Bot 一个目录, sandbox(除非以后另开)

工作目录(Work dir)

一件事的中间产物集中的那个文件夹,在工作区的 work/ 下,名字是日期 + 触发消息开头 + 一小段 id。谁开的:一条用户消息或一次日程触发。谁继承:交接、点名、判断下场、Bot↔Bot 私聊和中断续跑都用唤醒方那一轮的目录,所以一件事跨 Bot、跨会话仍是同一个文件夹。日程每次触发新开一个;同一会话静默够久之后的下一轮也新开;一个会话同时只有一个开着的。第一次真被用到才创建,只说话的轮次不留空壳。壳默认在里面跑,文件工具的路径仍相对工作区根。交付物不进来:你点名了路径就写在那儿,没点名的落这个目录里。里面有两个保留子目录:tool-results/ 是守护进程存的大工具结果(关闭够久后自动清掉),scratch/ 是纯过程文件——两处的东西都不会挂成产物。删掉工作目录是你的事,应用只清 tool-results/

Avoid: 任务表, 计划 DAG, 状态机, 负责人, 每 Bot 一个目录, 产物库, 把它当沙箱, 应用替你删整个目录

产物(Artifact)

一条消息里引用的工作区相对路径,或 http/https 链接。文件本体在工作区(或远端 URL)上。本轮写入的区内文件会自动出现在最终消息里。点开后在聊天右侧预览面板查看(图 / 音视频 / PDF / 文本 / 单文件 HTML)。面板左侧的树列的是这件事引用过的全部路径——不是只有这一条消息的,也不是工作目录里的全部文件,相关指的是被引用过;树以工作目录为根,这件事在目录之外引用的路径和它并列平铺,本条消息自己引用的那几个标出来,面板与聊天共用一栏、中间拖条改宽度;同一条消息多个路径或打开工作区时左侧是文件树,树和内容之间可拖。拖过的预览栏宽度和文件树宽度,退出后再开还在。文本用 Monaco + Shiki 编辑(行号、查找 / 替换、匹配括号·标签·标题折叠、换行、复制);Markdown 和单文件 HTML 默认看渲染结果,可切源码。区内 UTF-8 文本可 Cmd+S / 保存写回同一路径;未保存切文件或关面板先确认。目录和未知类型用系统打开;也能从预览打开或在 Finder 显示。交接时把路径写进给对方的那条消息,不另建种类。种类按扩展名在预览时推导。

Avoid: 资产库, Artifact 表, 快照副本, 每 Bot 产物目录, @文件

附件(Attachment)

聊天里丢进来的文件,复制到工作区 inbox/,消息上保留指向该副本的链接。Bot 把工作区里已有文件当产物挂上时也走同一套附件行,但不复制、不进 inbox/。工作区是电脑,附件不是第二套文件系统。栅格图进轮次窗时按像素发给模型;其它文件只给路径,要读走 read_file

Avoid: 只挂在消息上的幽灵文件

搜索(Search)

跨 Bot、群、文件和日程的查找,跳回原会话位置。v1 做本机检索,不是另一个 Bot。

Avoid: 语义记忆层