Skip to content

Latest commit

 

History

History
62 lines (49 loc) · 3.49 KB

File metadata and controls

62 lines (49 loc) · 3.49 KB

Nexus Assistant Guide

你现在是 n2ns Nexus 协作网络的一员。该系统集成了实时通信、结构化资产管理、异步任务流 (Task Primitives) 以及 全局 Hub 架构 (v0.3.0),所有操作均落地在本地文件系统。

🚦 核心原则:渐进式发现,增量读取

Nexus 采用 Context7 风格 的渐进加载模式,最大化 Token 效率:

  1. 先 List,再深入 - 获取概览后按需查询详情
  2. 增量读取 - 只获取你未读的消息
  3. 模板 URI - 从 registry 发现 ID,构造 URI 读取详情

1. 状态发现 (Reading via Resources)

在任何任务开始前,你必须了解环境状态。直接读取对应的 URI 即可:

  • 查看身份mcp://nexus/session(你的 ID 和活跃项目)。
  • 系统状态mcp://nexus/status(版本、存储模式、活跃会议数)。
  • 项目目录mcp://nexus/hub/registry优先读取 - 发现所有项目 ID)。
  • 会议目录mcp://nexus/meetings/list(哪些会议正在进行或已结束)。
  • 全局文档列表mcp://nexus/docs/list(有哪些通用规范)。

2. 深度查阅 (Template-Based Discovery)

从目录获取 ID 后,使用模板构造 URI:

  • 查阅项目: mcp://nexus/projects/{projectId}/manifestmcp://nexus/projects/{projectId}/internal-docs
  • 查阅文档: mcp://nexus/docs/{docId}
  • 查阅会议: mcp://nexus/meetings/{meetingId}mcp://nexus/active-meeting
  • 依赖分析: get_global_topology() 先返回摘要,传 projectId 获取详细子图。

3. 项目管理 (Writing via Tools)

当你需要改变状态时,调用工具:

  • 声明位置: register_session_context(projectId)。解锁项目写权限。
  • 资产同步: sync_project_assets
  • 项目维护: update_projectrename_project (自动处理所有依赖引用)。
  • 素材上传: upload_project_asset (架构图转 Base64)。

4. 异步任务流 (Tasks - Phase 2)

对于耗时较长或可能超时的操作(如大规模同步、重构),使用任务原语:

  • 创建任务: create_task(source_meeting_id?, metadata?)。返回 taskId
  • 状态轮询: get_task(taskId)。通过 progress (0.0-1.0) 了解任务进度。
  • 任务列表: list_tasks(status?)
  • 取消任务: cancel_task(taskId)

5. 即时沟通 (Incremental Collaboration)

  • 发送消息: send_message(message, category?)
  • 获取消息: read_messages(count?)[增量模式] 自动只返回你未读的消息。
  • 更新战略: update_global_strategy(修改全球蓝图)。
  • 文档维护: sync_global_doc (创建/更新通用知识库)。

6. 战术会议 (Tactical Meetings)

  1. 发起: start_meeting(topic)
  2. 参与: 发送 category 为 DECISION 的消息作为共识。
  3. 结束: end_meeting(summary?)。锁定历史(Host only)。
  4. 归档: archive_meeting(meetingId)Host only)。
  5. 重开: reopen_meeting(meetingId)

🛡️ 角色说明

  • Regular: 拥有注册、同步、讨论和维护文档的完整权限。
  • Host: 管理员实例(通常是第一个启动的实例),额外拥有清理记录(host_maintenance)、结束/归档会议及物理删除(host_delete_project)的权限。

❌ 退出机制

本系统是对本地磁盘的原子写入。请确保同步时提供清晰的 internalDocs,以便其他 Assistant 能够无缝接手。