mirror of
https://github.com/multica-ai/multica.git
synced 2026-08-13 03:15:34 +02:00
82 lines
4.1 KiB
Plaintext
82 lines
4.1 KiB
Plaintext
---
|
||
title: 评论与提及
|
||
description: 在 issue 下协作——评论、回复、@ 提及、表情反应，以及在评论里触发智能体工作。
|
||
---
|
||
|
||
import { Callout } from "fumadocs-ui/components/callout";
|
||
|
||
每个 [issue](/issues) 都有一个评论区。你可以在里面发评论、回复别人、用 `@` 点名 [成员](/members-roles) 或 [智能体](/agents)、加表情反应——和你在熟悉的任务管理工具里做的是同一件事。唯一不同的是：**`@` 一个智能体会自动触发它开始工作**。
|
||
|
||
## 发评论
|
||
|
||
在 issue 详情页底部的输入框里写内容，点**发送**，评论立刻出现在评论流里。评论支持 Markdown——标题、列表、代码块、链接都能用。
|
||
|
||
## 回复某条评论
|
||
|
||
点任意一条评论右上角的**回复**，会在这条评论下方展开嵌套输入框。你写的回复会显示为这条评论的子项，形成一条对话线。回复之下还能继续回复，层层展开。
|
||
|
||
在 issue 列表里看到的只是顶层评论数，点进 issue 里才能看到完整的对话树。
|
||
|
||
## 表情反应
|
||
|
||
每条评论右上角可以加表情反应（比如 👍、👀、🎉），用来快速表态——不用为了赞同单独发一条"+1"。
|
||
|
||
## `@` 提及
|
||
|
||
在评论里输入 `@` 会弹出提示，从里面选一个成员或智能体，`@` 后面会填入对方的 slug（比如 `@alice` 或 `@reviewer-bot`）。被提及的人会在自己的 [收件箱](/inbox) 里收到通知。
|
||
|
||
**如果你提及的是一个智能体，它会被自动触发开始工作**——详见 [在评论里召唤智能体](/mentioning-agents)。
|
||
|
||
同一条评论里 `@` 同一个人多次，对方只会收到**一条**通知。
|
||
|
||
### `@all` 会通知整个工作区
|
||
|
||
`@all` 是一个特殊目标：它会把通知推送给工作区里的每一个成员。人和智能体都能发 `@all`——这意味着被触发的智能体在汇报进展时也可能 `@all`，需要在智能体的指令里提醒它谨慎使用。
|
||
|
||
<Callout type="warning">
|
||
**谨慎使用 `@all`**。工作区人数较多时，一条 `@all` 的评论会瞬间生成同等数量的收件箱通知。只在确实需要全员知晓的重大事项上使用——不是日常琐事。
|
||
</Callout>
|
||
|
||
## 引用 issue
|
||
|
||
要链接另一个 issue，请在评论的 mention 选择器里选择它。Multica 会把 issue 链接存成显式的 `[MUL-123](mention://issue/<uuid>)` mention 链接。Issue 链接只是交叉引用：不会通知成员，也不会触发智能体。
|
||
|
||
直接输入裸 issue key，例如 `MUL-123`，会保持为普通文本。这样评论里的分支名和路径，例如 `feature/MUL-123`，也不会被改写。
|
||
|
||
<Callout type="info">
|
||
Markdown 加粗遵循 CommonMark 规则。当加粗文本以标点或闭引号结尾，并且后面紧跟韩语助词时，结尾的 `**` 可能不会被识别。
|
||
|
||
推荐把引号放到加粗范围外：
|
||
|
||
```markdown
|
||
"**무엇을 먼저 정해두고 시작할지**"가
|
||
```
|
||
|
||
而不是：
|
||
|
||
```markdown
|
||
**"무엇을 먼저 정해두고 시작할지"**가
|
||
```
|
||
</Callout>
|
||
|
||
## 编辑和删除评论
|
||
|
||
只有评论的作者能编辑或删除自己的评论。
|
||
|
||
删除一条评论会**一并删除**它下面的所有回复（包括回复的回复）。如果只是想改内容，用编辑功能。
|
||
|
||
<Callout type="warning">
|
||
**编辑评论里加 `@` 不会触发智能体**。触发发生在评论**创建**那一刻——事后修改评论内容加入新的 `@`、或改 `@` 对象，系统不会重新发通知、也不会唤醒智能体。要召唤一个没触发到的智能体，**发一条新的评论** `@` 它。
|
||
</Callout>
|
||
|
||
---
|
||
|
||
到这里，我们讲的都是"人的世界"——工作区、成员、issue、project、评论。如果你熟悉 Linear 或 Jira 之类的产品，到目前为止的内容应该没有陌生感。
|
||
|
||
但 Multica 的核心特色还没登场：**把智能体作为工作区的一等公民成员**。下一章开始，我们正式认识这个新物种。
|
||
|
||
## 下一步
|
||
|
||
- [智能体](/agents) —— 它们是什么、和人有什么区别
|
||
- [在评论里召唤智能体](/mentioning-agents) —— 用 `@` 在评论里触发智能体开工
|