mo-remark

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

前置约束

Pre-requisites

CRITICAL — 先阅读
共享规则
，其中包含
mocli
初始化、认证、输出解析以及安全规则

CRITICAL — Please read the
Shared Rules
first, which includes
mocli
initialization, authentication, output parsing, and security rules

mocli remark - 墨问备注(remark -> uid)

mocli remark - MoWen Remark (remark -> uid)

本技能用于为墨问 UID 设置备注名(remark -> uid)、移除备注名以及使用备注名来检索墨问 UID，一个墨问 UID 可以设置多个备注名。

This skill is used to set remark names for MoWen UID (remark -> uid), remove remark names, and retrieve MoWen UID using remark names. A single MoWen UID can have multiple remark names.

使用原则

Usage Principles

当用户用人名、昵称、备注名指代某个墨问用户，且后续命令需要 UID 时，优先执行
```
mocli remark list --keyword <name>
```
查找 UID。
- 如果备注命中唯一 UID，可直接把该 UID 用于后续命令。
- 如果备注命中多个 UID，展示备注名与 UID，让用户确认目标。
- 如果备注未命中，再使用
```
mo-user
```
  搜索用户，或询问用户提供 UID。
- ```
set
```
  和
```
remove
```
  会修改本地备注配置，执行前必须确认用户意图。

When users refer to a MoWen user by name, nickname, or remark name, and subsequent commands require a UID, prioritize executing
```
mocli remark list --keyword <name>
```
to find the UID.
- If the remark hits a unique UID, directly use this UID for subsequent commands.
- If the remark hits multiple UIDs, display the remark names and UIDs and ask the user to confirm the target.
- If no remark is matched, use
```
mo-user
```
  to search for the user, or ask the user to provide the UID.
- ```
set
```
  and
```
remove
```
  will modify the local remark configuration; you must confirm the user's intent before execution.

mocli remark set <uid> <remark>

为一个墨问 UID 设置备注名，一个 UID 可以设置多个备注名。该命令会写入本地备注配置，执行前必须确认用户确实要新增备注。

Set a remark name for a MoWen UID. A single UID can have multiple remark names. This command will write to the local remark configuration; you must confirm that the user actually wants to add the remark before execution.

使用示例

Usage Examples

把 <UID> 备注成老池

mocli remark set xxxxxx 老池

把 <UID> 备注成池老师
```
mocli remark set xxxxxx 池老师
```

Remark <UID> as Lao Chi:

mocli remark set xxxxxx 老池

Remark <UID> as Teacher Chi:
```
mocli remark set xxxxxx 池老师
```

mocli remark remove <keyword>

移除一个或多个备注条目。

墨问 UID

或

备注名

只要有一项 完全匹配

keyword

，对应条目就会被移除。该命令会修改本地备注配置，执行前必须确认用户确实要删除。

Remove one or more remark entries. If either the

MoWen UID

remark name

exactly matches the

keyword

, the corresponding entry will be removed. This command will modify the local remark configuration; you must confirm that the user actually wants to delete before execution.

使用示例

Usage Examples

删除老池的备注

mocli remark remove 老池

删除 <UID> 的备注

mocli remark remove KBqt7yiVrXBa9DJIJuUm3

Delete the remark for Lao Chi:

mocli remark remove 老池

Delete the remark for <UID>:

mocli remark remove KBqt7yiVrXBa9DJIJuUm3

mocli remark list [--keyword string]

列出所有备注条目。可选参数

--keyword

用于筛选出备注名或 UID 中包含

keyword

的条目。

List all remark entries. The optional

--keyword

parameter is used to filter entries where the remark name or UID contains the

keyword

使用示例

Usage Examples

查看我的备注列表

mocli remark list

查看老池相关的备注
```
mocli remark list --keyword 老池
```

View my remark list:
```
mocli remark list
```
- View remarks related to Lao Chi:
```
mocli remark list --keyword 老池
```

输出示例

Output Examples

without keyword

{
  "code": 0,
  "status": "OK",
  "reply": {
    "remarks": {
      "me": "KBqt7yiVrXBa9DJIJuUm3",
      "myself": "KBqt7yiVrXBa9DJIJuUm3",
      "我": "KBqt7yiVrXBa9DJIJuUm3",
      "池建强": "vtv_PV1fEMBb-8_BPlmDu",
      "池老师": "vtv_PV1fEMBb-8_BPlmDu",
      "精卫鸟zzz🇨🇳": "KBqt7yiVrXBa9DJIJuUm3",
      "老池": "vtv_PV1fEMBb-8_BPlmDu"
    }
  }
}

with --keyword 池

{
  "code": 0,
  "status": "OK",
  "reply": {
    "remarks": {
      "池建强": "vtv_PV1fEMBb-8_BPlmDu",
      "池老师": "vtv_PV1fEMBb-8_BPlmDu",
      "老池": "vtv_PV1fEMBb-8_BPlmDu"
    }
  }
}

without keyword

{
  "code": 0,
  "status": "OK",
  "reply": {
    "remarks": {
      "me": "KBqt7yiVrXBa9DJIJuUm3",
      "myself": "KBqt7yiVrXBa9DJIJuUm3",
      "我": "KBqt7yiVrXBa9DJIJuUm3",
      "池建强": "vtv_PV1fEMBb-8_BPlmDu",
      "池老师": "vtv_PV1fEMBb-8_BPlmDu",
      "精卫鸟zzz🇨🇳": "KBqt7yiVrXBa9DJIJuUm3",
      "老池": "vtv_PV1fEMBb-8_BPlmDu"
    }
  }
}

with --keyword 池

{
  "code": 0,
  "status": "OK",
  "reply": {
    "remarks": {
      "池建强": "vtv_PV1fEMBb-8_BPlmDu",
      "池老师": "vtv_PV1fEMBb-8_BPlmDu",
      "老池": "vtv_PV1fEMBb-8_BPlmDu"
    }
  }
}

reply 字段说明

Reply Field Description

字段	类型	说明
`remarks`	map[string]string	key 备注名，value 墨问 UID

Field	Type	Description
`remarks`	map[string]string	key is the remark name, value is the MoWen UID

结果解析规则

Result Parsing Rules

```
remarks
```
的 key 是备注名，value 是墨问 UID。
- 同一个 UID 可能对应多个备注名；展示时可按 UID 合并，减少重复。
- 作为后续命令参数时，只使用 UID，不要把备注名传给需要 UID 的参数。
- 如果
```
remarks
```
  为空，说明没有匹配备注，不要猜测 UID。

The key of
```
remarks
```
is the remark name, and the value is the MoWen UID.
- The same UID may correspond to multiple remark names; you can merge by UID when displaying to reduce duplicates.
- When used as a parameter for subsequent commands, only use the UID; do not pass the remark name to parameters that require a UID.
- If
```
remarks
```
  is empty, it means no matching remarks are found; do not guess the UID.

展示规则

Display Rules

** 参考 **

公共展示规则

** Refer to **

Common Display Rules