mirror of
https://github.com/multica-ai/multica.git
synced 2026-07-26 12:35:35 +02:00
6e0f7b0f36
* feat(settings): allow editing workspace issue prefix (MUL-2369) Workspace admins can now change the issue prefix from Settings → General. The change is gated by a confirmation dialog that warns about external references (PR titles, branch names, links) breaking, because issue identifiers are rendered as `prefix-N` on the fly — changing the prefix effectively renames every existing issue. Refs https://github.com/multica-ai/multica/issues/2797 Co-authored-by: multica-agent <github@multica.ai> * fix(settings): invalidate issue cache when workspace prefix changes (MUL-2369) Issue identifiers (`MUL-123`) are recomputed from `workspace.issue_prefix` at read time, so cached issues kept showing the old `OLD-N` keys after a prefix change. Without invalidation the confirm dialog's "all issues will be renumbered" promise was broken until a hard refresh — and other tabs receiving the `workspace:updated` WS event saw the same drift. - WorkspaceTab: after a prefix-changing save, invalidate `issueKeys.all` in addition to the workspace list. Non-prefix saves stay cheap. - Realtime: split `workspace:updated` out of the generic `workspace` refresh into a specific handler that compares cached vs incoming `issue_prefix` and invalidates issues only when it actually changed. - Docs: align the "uppercase" language with the actual UI/backend rule (uppercase letters and digits, up to 10 chars). Co-authored-by: multica-agent <github@multica.ai> --------- Co-authored-by: multica-agent <github@multica.ai>
57 lines
2.8 KiB
Plaintext
57 lines
2.8 KiB
Plaintext
---
|
||
title: 工作区
|
||
description: 工作区（workspace）是一群人一起协作的独立空间——所有 issue、成员、评论、智能体都属于它。
|
||
---
|
||
|
||
import { Callout } from "fumadocs-ui/components/callout";
|
||
|
||
工作区（workspace）是 Multica 里**一群人一起协作的独立空间**——所有 [issue](/issues)、[成员](/members-roles)、[评论](/comments)、[智能体](/agents) 都属于它。你登录进来看到的任务列表、成员名单、智能体配置都限定在当前工作区；**切换工作区，看到的内容会完全替换**。
|
||
|
||
## 创建工作区
|
||
|
||
创建工作区时要定下三件事：
|
||
|
||
- **工作区名字** — 给成员看的显示名称，可以包含空格和中文。后续随时能改。
|
||
- **Slug（短链标识符）** — 工作区 URL 中使用的字符串，只能是小写字母和数字（用 `-` 连接）。**创建后不能改**，提前想好。如果 slug 已被占用或命中系统保留词，创建界面会让你换一个。
|
||
- **Issue 前缀** — 工作区里所有 issue 编号的前缀（比如 `MUL-123` 里的 `MUL`）。只能是大写字母和数字，最长 10 个字符。
|
||
|
||
<Callout type="warning">
|
||
**尽量不要修改 issue 前缀。** 系统在展示 issue 编号时会用当前的前缀——改了之后，`MUL-5` 会立刻变成 `NEW-5`。所有外部链接、Slack 提及、评论里的历史引用都会对不上旧编号。把 issue 前缀当成"创建后不改"的设计来对待。
|
||
</Callout>
|
||
|
||
你可以通过 Web 界面创建工作区，也可以用命令行：
|
||
|
||
```bash
|
||
multica workspace create
|
||
```
|
||
|
||
## Issue 编号
|
||
|
||
工作区每创建一个 issue，系统都会自动分配一个编号，格式是 `<前缀>-<数字>`，比如 `MUL-1`、`MUL-2`、`MUL-3`。有几个特点：
|
||
|
||
- **工作区内连号不重复** — 每个工作区单独维护自己的计数器，互不干扰。
|
||
- **不能手动指定** — 创建 issue 时你只填标题，编号由系统分配。
|
||
- **删除后不回收** — 删掉 `MUL-5` 之后，下一个新 issue 是 `MUL-6` 不是 `MUL-5`。
|
||
|
||
## 删除工作区
|
||
|
||
只有工作区的 owner 能删除整个工作区。删除是**不可恢复**的操作。
|
||
|
||
<Callout type="warning">
|
||
删除工作区会一次性清除以下所有数据：
|
||
|
||
- 所有 issue、project、评论、表情反应
|
||
- 所有附件
|
||
- 所有成员关系和待处理的邀请
|
||
- 所有智能体配置和它们的任务历史
|
||
|
||
**数据无法恢复**。在删除前导出需要保留的数据。
|
||
</Callout>
|
||
|
||
如果你是工作区里的最后一个 owner 并打算放弃这个工作区，先把 owner 角色转让给另一个成员，再由新 owner 或你自己决定删除。详见 [成员与权限](/members-roles)。
|
||
|
||
## 下一步
|
||
|
||
- [成员与权限](/members-roles) —— 怎么把人加进工作区、三种角色各能做什么
|
||
- [Issue 与 project](/issues) —— 工作区里的核心工作对象
|