项目管理

你可以做什么

• 创建项目
• 编辑项目信息（名称、描述、模式）
• 删除项目
• 按关键词筛选项目
• 查看项目状态与角色
• 进入项目工作台
• 管理项目成员（manager 或 owner）
• 管理项目内安装的 skills
• 管理项目内启用的全局 skills
• 管理项目内安装的 agents、actions 与 runtimes
• 管理项目内启用的全局 agents
• 管理项目级持久化容器环境
• 管理 project 环境变量（manager 或 owner 可编辑）
• 控制 Agent 自动执行行为
• 控制项目级检索记忆开关
• 批量删除项目下的所有会话
• 通过管理员公开到 Showcase（公开演示）

建议流程

1. 在 Workspace 创建项目名称/方向/描述
2. 使用筛选快速定位目标项目
3. 点击 Enter Project 开始使用

移动端与窄屏使用

工作区现在对手机和窄屏窗口做了专门适配：

• 左侧导航在小屏幕上会收起为抽屉，点击顶部侧边栏按钮可展开或隐藏
• 展开抽屉时会显示遮罩，点击遮罩或隐藏按钮可回到当前页面
• 项目列表在窄屏下会从表格切换为卡片式布局，项目名称、角色、状态、配额和操作入口会按纵向排列
• 项目工作台中的聊天区、文件面板和辅助面板会减少横向挤压，避免出现不必要的横向滚动条

使用建议：

• 手机上优先通过项目卡片进入工作台，再按需打开侧边栏或文件面板
• 如果需要长时间查看日志、表格或代码预览，横屏或平板尺寸会更舒适

项目操作

编辑项目

在项目列表或项目工作台顶部，可以修改：

• 项目名称
• 项目描述
• 项目模式（标准模式 / 开发模式）

项目模式

项目支持两种模式：

• 标准模式 (standard)：适用于常规研究工作
• 开发模式 (dev)：适用于开发自定义 Agent

开发模式的特性：

• 内置的 agent-authoring 和 visualizer-authoring skill 会通过只读全局 skill 挂载自动启用，路径位于 /global/skills/
• 支持在线创建和修改 Agent、Action、Runtime
• 切换回标准模式时，这些托管 skill 会自动变为不可用

说明：

• agent-authoring 和 visualizer-authoring 都是系统托管的 skill，不能手动安装或删除
• 模式切换入口在项目设置页面

Agent 自动运行开关

项目级 Agent Auto-Run 控制聊天中 Agent 工具的执行行为：

• 开启（默认）：当模型决定调用 Agent 时，立即自动执行
• 关闭：模型提议调用 Agent 后，显示确认界面，用户需手动填写参数并确认执行

适用场景：

• 关闭时适合需要精确控制 Agent 执行的场景
• 开启时适合自动化程度较高的工作流

设置位置：项目工作台顶部 Settings 面板

项目记忆

每个项目都可以配置专属的项目记忆，存储在项目工作区的 .agent/memory.md 文件中，相关补充笔记放在 .agent/memory/ 目录下。这些内容会自动追加到该项目所有会话的系统提示中。

功能特点：

• 内容会自动注入到每个会话的系统提示中
• 支持定义项目长期上下文、偏好、术语规范、关键决策和已知注意事项
• manager 和 owner 可以编辑，viewer 和 editor 只能查看

使用方式：

1. 在项目列表中，点击项目行右侧的菜单按钮（三点图标）
2. 选择 Project settings
3. 在弹出的对话框中编辑项目记忆
4. 点击 Save memory 保存

典型内容示例：

# Project Memory

## Overview
- 本项目聚焦癌症生物标志物与内部研究工作流。

## Durable Facts
- 回答时优先使用简洁的要点列表。
- 引用文件时先说明文件路径。

## Active Decisions
- 使用本项目领域内的标准术语。

## Recent Important Index
- [Container rules](.agent/memory/container-rules.md) - 持久容器不能以 root 运行。

说明：

• 项目记忆存储在项目本地工作区 .agent/memory.md 文件中
• 新项目默认关闭项目记忆；打开开关时，如果 .agent/memory.md 不存在，会自动用默认模板创建
• 相关补充笔记可以放在 .agent/memory/ 目录下
• 可以通过文件管理直接编辑这些文件，也可以通过 Project settings 界面编辑
• 清空内容等同于禁用该功能

项目环境变量

每个项目可以配置专属的环境变量，存储在项目工作区的 .agent/.env 文件中。这些变量会自动注入到 Agent 的 Bash 执行环境和进程型 Action 中。

功能特点：

• 环境变量在项目聊天中的 Bash 命令执行时自动可用
• 进程型 Action 执行时也会携带这些环境变量
• 支持配置 API Key、数据集 ID 等敏感或项目特定的配置
• manager 和 owner 可以编辑，viewer 和 editor 只能查看

使用方式：

1. 在项目列表中，点击项目行右侧的菜单按钮（三点图标）
2. 选择 Project settings
3. 在环境变量区域添加或编辑变量（每行一个 KEY=value 对）
4. 点击 Save environment 保存

典型使用场景：

• 配置第三方服务 API Key（如 OPENAI_API_KEY）
• 设置数据集标识符（如 DATASET_ID=atlas-01）
• 存储项目特定的配置参数

说明：

• 环境变量存储在项目本地工作区 .agent/.env 文件中
• 可以通过文件管理直接编辑该文件，也可以通过 Project settings 界面编辑
• 变量名不能重复，空值是允许的
• 项目环境变量优先级高于系统环境变量，但低于 Action 运行时指定的变量

项目级检索记忆开关

当管理员全局启用检索记忆后，每个项目可以独立控制是否启用：

• 在项目设置的容器面板中切换 项目记忆 开关
• 默认为开启状态
• 关闭后，该项目的记忆搜索和写入都会暂停
• 详见 检索记忆

删除项目

• 删除项目会同时删除：
  • 项目下所有会话
  • 项目下所有本地工作目录文件
  • 项目成员关联
• 删除操作不可恢复，请谨慎操作

项目公开展示（Showcase）

ResearchX 现在支持把项目公开展示给未登录访客浏览，用于案例演示、研究成果说明或 onboarding 示例。

使用方式：

1. 管理员进入 /workspace/admin/projects
2. 在项目列表中找到目标项目
3. 通过 示例演示 列或操作菜单开启 开启示例
4. 开启后，访客可在 /showcase 看到该项目，并进入详情页浏览公开内容

公开后访客可以看到：

• 项目名称、描述、图标和公开日期
• 已公开的会话列表与消息内容（含 Agent 任务卡片和工具结果）
• 项目工作区中的公开文件列表与在线预览（含可视化插件效果）
• 工作区文件树（.agent/ 目录自动隐藏）

限制说明：

• 该开关目前由管理员控制，不在普通项目设置面板中
• Showcase 页面是只读浏览入口，访客不能编辑消息、修改文件或进入项目工作台
• 关闭公开后，项目会从 /showcase 列表中移除

批量删除会话

在项目工作台左侧会话列表中：

• 点击顶部的删除按钮可清空当前项目下所有会话
• 适用于需要重新开始或清理历史的场景

持久化容器环境

Project settings 中提供项目级持久化容器环境入口。开启后：

• 该项目下所有会话共享同一个容器环境
• Agent 的 Read / Bash / Edit / Write 会优先在该容器内执行
• 在容器内安装的 Python / pip / npm 等依赖，可在同一项目的后续会话中直接复用
• 本地工作目录中的文件状态也会随容器一起保留

如何开启

1. 进入目标项目工作台
2. 点击顶部 Settings
3. 在 Persistent data environment 卡片中点击 Enable
4. 在页面内确认对话框中点击 Confirm

说明：

• 仅 owner 可以执行 Enable / Disable
• manager、editor、viewer 可以看到当前容器状态
• 当容器功能已启用时，只有 manager 可以在设置页执行 Start / Stop

状态说明

• Running
  • 容器正在运行，Agent 会直接复用当前环境
• Stopped
  • 容器已停止；再次发起需要容器工具的对话时，会自动拉起
• Waiting for resources
  • 容器因资源配额不足暂时无法启动，等待其他项目释放资源后自动唤醒
• Error
  • 容器启动或操作失败；owner 可在设置页重试或重新开启

更完整的镜像选择、资源设置、权限边界和项目镜像构建说明，见 容器管理。

成员管理

• 邀请成员邮箱加入项目
• 调整成员角色（viewer / editor / manager / owner）
• 移除成员

说明：

• 成员管理入口在项目工作台顶部的 Member
• manager 和 owner 可执行非 owner 成员的增删改
• 仅 owner 可以授予或移除 owner 角色
• 项目中必须至少保留一个 owner
• 邀请成员时会校验邮箱格式；尚未注册的邮箱不能直接加入项目，需要对方先完成注册

Skills 管理

• 项目工作台顶部提供 Skills 按钮
• 点击后会弹出 Skills 管理框，不再通过右侧文件树管理
• 左侧按 已安装 和不同 skill repository 分组切换
• 右侧显示当前分组下的 skills，可直接搜索过滤

常见操作：

1. 先切换到某个 repository
2. 搜索目标 skill
3. 点击 Install 安装到当前项目
4. 切换到 已安装 查看当前项目已安装的 skills
5. 对已安装的 skill 可直接删除

说明：

• 已安装的 skills 会被复制到项目本地 .agent/skills/<namespace>/<skill-name> 下
• 已有的 .agent/skills/<skill-name> 一层目录仍然兼容
• 右侧 Local Workspace 文件树默认隐藏 .agent 目录，避免干扰日常文件操作
• 通过 /skill:<name> 调用项目 skill 的方式不变

Agent / Action / Runtime 资产

• 项目工作台支持安装项目级 agent、action、runtime
• 这些资产安装后会复制到项目本地 .agent/agents、.agent/actions、.agent/runtimes
• 资产目录同时支持一层和命名空间两种布局，例如 .agent/actions/<action-name> 与 .agent/actions/<namespace>/<action-name>
• 聊天中的 agent 调用只识别当前项目已安装的 agent，不会使用未安装的全局定义

当前语义：

• agent
  • 面向用户任务语义，例如“加法分析”“文件转大写”
• action
  • agent step 的执行单元，例如 add_numbers、uppercase_project_file
• runtime
  • 被 process action 引用的可复用 runtime 定义，主要提供协议、超时、环境变量和资源默认值

补充说明：

• 同一个 runtime 可被多个 action 复用
• 项目本地 .agent/runtimes 下的 runtime 会覆盖同名全局 runtime
• 如果多个已安装 action 或 agent 声明了相同的 name，系统会在诊断中显示冲突，并且在只剩一个定义使用该名称之前不会把这个名称暴露给运行时
• 容器类 action 的镜像、工作目录、命令、参数应优先写在 action 自己的配置中，而不是 runtime 中
• 导出已安装 actions 或 agents 时，会包含被引用的项目本地 runtimes。仅存在于全局 catalog 的 runtime 仍作为全局依赖，由目标环境的全局 catalog 解析。
• 如果 agent 依赖的 action 或 runtime 缺失，它不会暴露给聊天模型作为可调用 agent 工具