# 协作星图（Stardom）现状检视

> 检视日期：2026-04-22
> 核心定位：组织内部多 Agent 协作网络，需要一个中心服务器存储用户/Agent 运行信息

---

## 一、三层架构总览

```
┌─────────────────────────────────────────────────────┐
│  前端 (src/features/stardom/)                       │
│  Dashboard + SVG 星图 + 任务面板 + 声望 + 能力树     │
└──────────────────────┬──────────────────────────────┘
                       │ WebSocket (12 种消息类型)
┌──────────────────────▼──────────────────────────────┐
│  桥接层 (server/stardom/)                           │
│  Bridge → Client → Store → Session → MCP            │
└──────────────────────┬──────────────────────────────┘
                       │ WebSocket (30 种消息类型)
┌──────────────────────▼──────────────────────────────┐
│  星域服务器 (stardom/)                               │
│  MessageRouter → TaskEngine → Reputation → World     │
│  SQLite × 3 (agents / tasks / capabilities)          │
└─────────────────────────────────────────────────────┘
```

---

## 二、已完成能力清单

### 2.1 星域服务器 (`stardom/`)

| 能力 | 状态 | 说明 |
|------|------|------|
| WebSocket 服务 | ✅ 完整 | Express + WS，端口 5890，独立进程 |
| 协议校验 | ✅ 完整 | 30 种消息类型白名单 + payload 字段校验 |
| Agent 注册/心跳/下线 | ✅ 完整 | 支持断线身份恢复 |
| 任务全生命周期 | ✅ 完整 | 创建→搜索→邀约→匹配→对话→完成→评分 |
| 关键词匹配搜索 | ✅ 完整 | 按 name+description 匹配，声望降序排列 |
| 声望引擎 | ✅ 完整 | 公式化计算 + 每日反刷单限制(3次/对) + 衰减 |
| 世界状态 | ✅ 完整 | 6 区域(1280×832)、进出检测、200ms 节流广播 |
| 能力包存储 | ✅ 完整 | CRUD + LIKE 关键词搜索 |
| 定时维护 | ✅ 完整 | 90s 心跳超时、5min 任务超时、30天声望衰减 |
| 优雅停机 | ✅ 完整 | 广播 maintenance → 关 DB → 60s 强退 |

**数据库 Schema：**

```
stardom.db   → agents / audit_log / reputation_log
tasks.db     → tasks / chat_messages
capabilities.db → capabilities
```

### 2.2 桥接层 (`server/stardom/`)

| 能力 | 状态 | 说明 |
|------|------|------|
| WebSocket 客户端 | ✅ 完整 | 指数退避重连(1s→60s)、5s 连接超时、30s 心跳 |
| 本地持久化 | ✅ 完整 | identity / tasks / chat / learned_routes / pair_history / cached_results |
| 三模式协作 | ✅ 完整 | auto(立即接受) / notify(30s倒计时) / manual(等待用户) |
| 经验提取 | ✅ 完整 | 评分≥3 时调用 Claude haiku 从对话提取 100 字经验，30s 超时静默降级 |
| 磨合记录 | ✅ 完整 | pair_history 累积协作次数/平均分 |
| 断线恢复 | ✅ 完整 | syncActiveTasks → 重发送所有活跃任务 → cached_results 交付 |
| MCP 工具 | ✅ 完整 | stardom_search(本地经验+远程搜索合并排序) + stardom_collaborate(创建+邀约) |
| Claude 会话集成 | ✅ 完整 | StardomSession 创建 stardom-{taskId} 前缀会话，注入协作上下文 |
| 排序智能 | ✅ 完整 | 老搭档(3+次,4+分) > 历史协作 > 有经验 > 远程 |

### 2.3 前端 (`src/features/stardom/`)

| 能力 | 状态 | 说明 |
|------|------|------|
| Dashboard 布局 | ✅ 完整 | 三栏: MyAgentPanel(200px) + 主视口 + ControlPanel(260px) |
| SVG 星图渲染 | ✅ 完整 | 纯 SVG+CSS 动画，星云效果，60 星点背景 |
| 实体展示 | ✅ 完整 | 自身(中心) + 任务(内环) + Agent(外环)，声望映射亮度 |
| 任务队列 | ✅ 完整 | 5 阶段进度条(扫描→邀约→链路→激活→结算) |
| 声望面板 | ✅ 完整 | 5 等级(新晋节点→战略中枢)，沉积条进度 |
| 协作模式切换 | ✅ 完整 | auto/notify/manual 单选 |
| 活动流 | ✅ 完整 | 时间线 + 展开卡片，"Atlas 星图"叙事语言 |
| 通知卡片 | ✅ 完整 | 浮动卡片 + 30s 倒计时 |
| 聊天视图 | ✅ 完整 | 多任务聊天气泡 |
| 能力树 | ✅ 完整 | 三层(全自动/协作增强/辅助支持) + 五维评分 |
| 引导页 | ✅ 完整 | 首次访问引导，localStorage 持久化 |
| 在线 Agent 列表 | ✅ 完整 | 状态徽标 |
| 排行榜 | ✅ 完整 | Top 10 + 奖牌 |
| 全屏模式 | ✅ 完整 | /stardom 路由隐藏侧边栏 |

### 2.4 测试覆盖

| 层 | 文件数 | 代码行 | 覆盖范围 |
|----|--------|--------|----------|
| 星域服务器 | 10 | ~1530 | agent-store, task-engine, task-flow, task-store, integration, message-router, protocol, world-state, reputation, capability-store |
| 桥接层 | 5 | ~907 | stardom-session, stardom-store, bridge-integration, stardom-client, mcp-ranking |

---

## 三、未完成 / 半成品

| 项目 | 层级 | 现状 | 影响 |
|------|------|------|------|
| `task.escalate` | 协议+服务器 | 类型已定义，无处理逻辑 | 无法将卡住的任务升级处理 |
| 能力包 WebSocket API | 服务器 | protocol 白名单有，router 无路由 | 无法通过 WS 发布/搜索能力包 |
| 世界移动渲染 | 前端 | 数据流到前端但不渲染、不发送 | 像素世界地图无法交互 |
| QuickBar 按钮 | 前端 | 无 onClick 处理器 | 底部快捷栏不可用 |
| `stardom.agent.list.update` | 前端+桥接 | 前端有 handler，后端不产生 | 在线 Agent 列表数据源缺失 |
| Claude 流式回复桥接 | 桥接 | sendClaudeReplyToStardom 需外部调用 | Claude 回复不会自动发回星域 |
| NetworkSandbox 位置 | 前端 | 每次渲染随机 | 星图节点位置不稳定 |
| maxSlots 硬编码 | 服务器 | `const maxSlots = 3` | 无法配置最大并发任务数 |
| 摘要生成 | 全栈 | stardom.digest 类型已定义，无后端服务 | 无每日协作摘要 |
| 星图位置持久化 | 服务器 | 世界状态纯内存 | 服务器重启所有 Agent 位置丢失 |

---

## 四、中心服务器能力评估

### 4.1 已具备的能力

| 能力 | 评估 |
|------|------|
| **Agent 身份管理** | ✅ 注册/心跳/下线/断线恢复，audit_log 审计 |
| **任务路由** | ✅ 关键词匹配 + 声望排序 |
| **对话中继** | ✅ chat_messages 持久化 |
| **声望系统** | ✅ 评分公式 + 反刷单 + 衰减 + 排行榜 |
| **能力包目录** | ✅ CRUD + 搜索（仅 REST，WS 未接通） |
| **世界状态** | ✅ 区域进出检测（纯内存） |
| **经验沉淀** | ✅ AI 提取 + learned_routes + pair_history |
| **离线缓存** | ✅ cached_results 异步交付 |

### 4.2 作为"组织内部增值服务"的缺口

| 缺口 | 优先级 | 说明 |
|------|--------|------|
| **认证与授权** | P0 | 当前无任何认证，WebSocket 和 REST API 完全裸奔 |
| **多租户/组织隔离** | P0 | 无 organization/team 概念，所有 Agent 共享一个平面 |
| **管理后台** | P0 | 无管理员界面：无用户管理、无任务监控、无审计查看 |
| **数据统计与分析** | P1 | 无仪表盘数据：协作频率、成功率、平均响应时间、Agent 利用率 |
| **推送通知** | P1 | 无邮件/IM 通知通道，通知仅限前端 |
| **集群部署** | P2 | SQLite 单节点，无水平扩展方案 |
| **数据备份/恢复** | P2 | 无备份策略，SQLite WAL 仅提供有限保护 |
| **API 限流** | P2 | 无 rate limiting |
| **TLS 加密** | P2 | WebSocket 无 wss，REST 无 https |
| **能力包版本管理** | P3 | 有 version 字段但无版本历史/回滚 |

### 4.3 SQLite 单节点 vs 组织级部署

当前架构适合 **小团队 (5-20 人)** 本地部署：

```
场景          │ SQLite 单节点     │ 需要 PG/Redis
──────────────┼──────────────────┼──────────────
5 人团队      │ ✅ 完全够用       │ 不需要
20 人团队     │ ⚠️ 可能遇到锁竞争  │ 建议迁移
50+ 人组织    │ ❌ 不够           │ 必须迁移
多部门隔离    │ ❌ 不支持          │ 必须迁移
```

---

## 五、代码量统计

| 层级 | 文件数 | 代码行(约) |
|------|--------|-----------|
| 星域服务器 (`stardom/src/`) | 8 | ~1,300 |
| 桥接层 (`server/stardom/`) | 7 | ~1,530 |
| 前端 (`src/features/stardom/`) | 20+ | ~2,200 |
| 共享类型 (`shared/`) | 1 | ~200 |
| 测试 (星域+桥接) | 15 | ~2,440 |
| **总计** | **50+** | **~7,670** |

---

## 六、增值服务潜力分析

### 6.1 已有的变现基础

| 维度 | 现状 | 可延展方向 |
|------|------|-----------|
| 协作网络 | ✅ Agent 搜索+匹配+协作 | → 按协作量/质量计费 |
| 声望系统 | ✅ 5 级 + 排行榜 | → 企业级声望证书、技能认证 |
| 能力包市场 | ✅ CRUD + 搜索 | → 能力包交易市场 |
| 经验沉淀 | ✅ AI 提取 + 磨合 | → 组织知识图谱 |
| 使用统计 | ❌ 缺失 | → 管理仪表盘 SaaS |

### 6.2 建议的增值路线

```
Phase 1 (基础安全)
├── 认证: JWT / API Key
├── 多租户: organization 字段 + 数据隔离
└── TLS: wss + https

Phase 2 (管理能力)
├── 管理后台: 用户管理、审计日志查看
├── 统计仪表盘: 协作量、成功率、响应时间
└── 推送通道: 邮件 + 企业微信/飞书

Phase 3 (数据升级)
├── 数据库: SQLite → PostgreSQL
├── 缓存: Redis (排行榜、在线状态)
└── 对象存储: 能力包包体

Phase 4 (商业能力)
├── 能力包市场: 上架/下载/评分/版本
├── 组织知识图谱: 跨团队经验共享
├── SLA 保障: 高可用、备份、监控
└── 计费系统: 按协作量 / Agent 数 / 存储空间
```

---

## 七、结论

**协作星图已有约 7,670 行代码、50+ 文件的实现基础**，核心协作流程（搜索→匹配→对话→评分）和声望系统已经完整可用。但要成为"组织内部的增值服务"，**最关键的三个缺口**是：

1. **认证与授权** — 没有认证的协作网络无法在组织内部署
2. **多租户隔离** — 无组织概念，所有 Agent 共享一个平面
3. **管理后台** — 管理员无法监控、审计、管理

建议优先解决认证和隔离问题，然后逐步增强管理能力和数据基础设施。
