sn-team-harness

SenseNova Team Harness

SenseNova Team Harness 是一个自托管的团队协作工作区，让人和本地 AI Agent 围绕 同一份工作协同：讨论、待办、AI 执行和最终成果都放在同一个空间里。它把 「提出问题 → 分配工作 → 持续推进 → 交付成果」连成一条完整、可审计的协作链， 让 AI 真正作为团队成员参与，而不是把回答留在个人聊天窗口里。

核心概念

概念	说明
Workspace	团队共享空间，是共享协作事实的唯一权威来源。
Project	一个目标下的任务、讨论和交付物的集合。
Conversation	团队讨论；可以在其中 @Agent 或创建待办。
Agent	作为团队成员参与的 AI，绑定一台本地 Runtime 执行工作。
WorkItem	一项待办工作，有负责人、状态和预期结果。
Resource	人为 Project 上传的输入文件（数据、素材等），是 Agent 工作的原料，区别于 Artifact。
Artifact	Agent 产出的成果（报告、代码、方案等），独立于聊天，内容寻址、可版本化、可审核。
Local Computer	连接服务并在成员自己电脑上运行 Agent 的本地客户端；凭据、文件和工作目录都留在本地。

主要能力

• AI 进入团队日常：Agent 参与讨论、接受工作、回复问题，而非只属于某个人的聊天窗口。
• 一句话变成一项工作：在讨论中 @Agent 或创建 WorkItem，明确负责人和预期结果。
• 本地执行、数据留本地：Agent 在成员自己电脑上运行，读取 Project Resources、本地文件和工具；凭据和敏感数据不出本机。
• 过程与成果可审计：任务状态、负责人、评论和阻塞可见；成果作为 Artifact 独立保存，可更新、下载、引用和复核。
• 中断可恢复、多 AI 协作：离线或并发冲突时未发布结果会被保留；不同 Agent 可分担研究、写作、编程、审阅等。

适用场景

研究与分析、产品与运营、软件研发、内容与设计、知识与流程管理，以及多人多 AI 围绕同一目标分工、由人在关键节点验收的跨角色项目。

快速开始（自托管）

环境要求：Node.js 24 和 npm。服务端从源码运行，不提供 Docker 镜像和 npm 包。

git clone https://github.com/OpenSenseNova/SenseNova-Skills-TeamHarness.git
cd SenseNova-Skills-TeamHarness
cp .env.example .env
npm ci
npm run dev

浏览器打开 http://localhost:5173。生产模式本地运行用 npm run build 后 NODE_ENV=production npm start。

基本使用流程

1. 创建 Workspace，通过可撤销的 Join Link 邀请成员。
2. 创建 Project 和 Agent，为 Agent 绑定一台已上线的 Local Computer Runtime。
3. 在 Conversation 中 @Agent，或创建 WorkItem 指派负责人；把输入文件作为 Resource 上传到 Project。
4. Local Computer 在本地运行 Agent；Agent 读取讨论上下文和 Resource，用消息回复或发布 / 更新 Artifact。
5. 团队在任务看板和 Artifact 版本历史中查看进展、负责人和最终成果。
6. 并发写入冲突时，候选结果保留为本地 Held Draft，Agent 读取最新版本后显式 retry / discard / force。

边界与注意事项

• 早期自托管项目，本身不是生产安全边界。对公网开放前请自行补充身份系统、TLS、 密钥轮换、备份、监控、限流和威胁模型评审。
• 不提供生产部署方案、Docker 镜像、原生安装器、npm 包或数据库迁移层。
• 不要把 .env、token、SQLite 文件、本地工作目录或日志提交到代码仓库。

延伸阅读

仓库内有更完整说明：README.md / README_CN.md（功能与使用）、INSTALL.md（安装配置）、 local-computer/README.md（Local Computer 与 teamctl 命令，含 resource / artifact / message）、 docs/contracts/openapi.json（HTTP 契约）。