核心概念

niuniu 用六个核心概念组织所有资源。理解了这六个概念，整个产品的导航就清晰了。

Owner（所有者）

每个顶层资源都有一个 owner，要么是 user（个人空间），要么是 org（组织空间）。这是多租户的基础：A 用户的资源 B 用户看不到，A 组织的资源 B 组织看不到。

User & Org

• User：注册账号。每个 user 自动有一个个人空间。
• Org：组织。User 可以加入多个 Org，每个 Org 有 owner / admin / member 三种角色。

Repository（仓库）

代表一个 git 仓库。可以是本地路径，也可以是 git URL。注册到 niuniu 后，niuniu 会管理它的 worktree、分支信息。

Project（项目）

一个 Project 是一块看板，里面有 Issues、Columns、Checklists、Comments。Project 关联零个或多个 Repository。

Workspace（工作区）

最核心的概念。一个 workspace = 一个 issue 的执行环境：

• 关联一个 issue（项目里的某条任务）
• 对每个关联的 repository，自动创建一个独立的 git worktree
• 有自己的命令行环境、agent 会话、文件树

多个 workspace 之间互相隔离——A workspace 改的代码不会影响 B workspace。

Agent（代理）

agent 就是 workspace 内运行的 Claude Code 实例。niuniu 提供两种集成路径：

• PTY 终端：把 claude CLI 当子进程拉起，通过伪终端把输入输出桥接到浏览器
• 结构化代理：把 claude CLI 当对话 API 用，消息、cost、session 都持久化

关系图

User / Org (Owner)
  └─ Project
       ├─ Issue
       │    └─ Workspace
       │         ├─ Worktree (per repo)
       │         └─ Agent
       └─ Repository (attached)

下一步

• Kanban 与 Issue — Project 的看板用法
• Workspace 与 Agent 对话 — 在 workspace 里和 agent 对话
• Git Worktree 与代码评审 — 多 workspace 怎么共享一个仓库