sn-team-harness

1# SenseNova Team Harness
2 
3SenseNova Team Harness 是一个**自托管的团队协作工作区**，让人和本地 AI Agent 围绕
4同一份工作协同：讨论、待办、AI 执行和最终成果都放在同一个空间里。它把
5「提出问题 → 分配工作 → 持续推进 → 交付成果」连成一条完整、可审计的协作链，
6让 AI 真正作为团队成员参与，而不是把回答留在个人聊天窗口里。
7 
8## 核心概念
9 
10| 概念 | 说明 |
11| --- | --- |
12| **Workspace** | 团队共享空间，是共享协作事实的唯一权威来源。 |
13| **Project** | 一个目标下的任务、讨论和交付物的集合。 |
14| **Conversation** | 团队讨论；可以在其中 @Agent 或创建待办。 |
15| **Agent** | 作为团队成员参与的 AI，绑定一台本地 Runtime 执行工作。 |
16| **WorkItem** | 一项待办工作，有负责人、状态和预期结果。 |
17| **Resource** | 人为 Project 上传的输入文件（数据、素材等），是 Agent 工作的原料，区别于 Artifact。 |
18| **Artifact** | Agent 产出的成果（报告、代码、方案等），独立于聊天，内容寻址、可版本化、可审核。 |
19| **Local Computer** | 连接服务并在成员自己电脑上运行 Agent 的本地客户端；凭据、文件和工作目录都留在本地。 |
20 
21## 主要能力
22 
23- **AI 进入团队日常**：Agent 参与讨论、接受工作、回复问题，而非只属于某个人的聊天窗口。
24- **一句话变成一项工作**：在讨论中 @Agent 或创建 WorkItem，明确负责人和预期结果。
25- **本地执行、数据留本地**：Agent 在成员自己电脑上运行，读取 Project Resources、本地文件和工具；凭据和敏感数据不出本机。
26- **过程与成果可审计**：任务状态、负责人、评论和阻塞可见；成果作为 Artifact 独立保存，可更新、下载、引用和复核。
27- **中断可恢复、多 AI 协作**：离线或并发冲突时未发布结果会被保留；不同 Agent 可分担研究、写作、编程、审阅等。
28 
29## 适用场景
30 
31研究与分析、产品与运营、软件研发、内容与设计、知识与流程管理，以及多人多 AI
32围绕同一目标分工、由人在关键节点验收的跨角色项目。
33 
34## 快速开始（自托管）
35 
36环境要求：Node.js 24 和 npm。服务端从源码运行，不提供 Docker 镜像和 npm 包。
37 
38```bash
39git clone https://github.com/OpenSenseNova/SenseNova-Skills-TeamHarness.git
40cd SenseNova-Skills-TeamHarness
41cp .env.example .env
42npm ci
43npm run dev
44```
45 
46浏览器打开 `http://localhost:5173`。生产模式本地运行用 `npm run build` 后
47`NODE_ENV=production npm start`。
48 
49## 基本使用流程
50 
511. 创建 **Workspace**，通过可撤销的 Join Link 邀请成员。
52…