llm-to-agent/docs/features/spaces.md

Space、Conversation 与消息

Task 生命周期

实现阶段：P1

• 创建、命名、列出、切换、重命名、归档和删除 Task。
• 提供首次启动的默认 Task，并记录最近使用位置。
• Task 的工作文件和 Agent 数据随整个 Task 目录移动。

Conversation 生命周期

实现阶段：P1

• 在每个 Space 内创建、命名、切换、重命名、归档和删除 Conversation。
• 保存消息顺序、角色、可见内容和关联 Run。
• 支持恢复最近 Conversation，并为自动标题保留实现入口。

Project 绑定与发现

实现阶段：P2

• 将本地目录注册为 Project，并初始化或复用根目录中的 .agent/。
• 支持 Project 移动后的重新定位、解绑和重新发现。
• 保证项目源码不复制到 Agent 数据目录，多个会话共享同一个 Project 上下文。

Task 升级为 Project

实现阶段：P4

• 将整个 Task 目录移动至用户指定位置并改为 Project。
• 更新 Space 类型、全局注册路径和相关上下文引用。
• 处理目标目录冲突、Git 初始化与升级失败回退。

Conversation 搜索、分支与引用

实现阶段：P4

• 跨 Space 搜索 Conversation、消息和 Run 结果。
• 支持编辑或重新执行历史输入，并通过会话分支保留原始对话。
• 在新会话中引用其他 Conversation 或 Run，并保留来源导航。

会话附件

实现阶段：P6

• 在消息中附加文件、图片、代码片段和其他本地资料。
• 管理附件复制或引用策略、预览、上下文注入和删除。
• 为 Web/Desktop 和多模态模型共享统一附件语义。