Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 22 additions & 8 deletions docs/02-user-guide/02-conversations/01-sending-messages.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
title: 发送消息
description: 学习在 DesireCore 中发送文本、图片、文件,以及使用快捷操作和斜杠命令
keywords: [发送消息, 文本输入, 图片上传, 文件引用, 截图, 斜杠命令, 快捷键]
last-reviewed: 2026-07-23
---

# 发送消息
Expand Down Expand Up @@ -85,6 +86,25 @@ DesireCore 的输入区域支持多种消息发送方式,包括文本、图片

这种方式适合把桌面、下载目录或文件管理器中的素材直接交给当前智能体处理。

## 切换工作目录

输入框下方的工作目录胶囊和资源面板会显示智能体目录、全局目录以及当前智能体所属团队的共享目录。

- 点击智能体或全局目录,会把它设为普通会话的主工作目录。
- 点击团队共享目录,会为当前具体会话激活该团队;输入框胶囊随即显示团队目录和“团队”标签,右上角资源入口也会显示团队图标角标。再次点击可退出团队作用域。
- 团队目录不是只读标签。发送下一条消息时,DesireCore 会把对应 `teamId` 交给后端校验,校验通过后它才成为真实 cwd。
- 智能体运行中不能切换目录,避免正在执行的相对路径和文件权限突然改变。

每个会话的团队选择彼此独立。手动多会话模式下,同一智能体的不同会话也可以使用不同的团队目录。

创建团队时,DesireCore 会自动建立一条团队共享目录绑定。组长、初始成员以及之后添加或改任主管的成员都从团队关系继承同一目录,不需要逐个配置;非成员不会看到该团队目录。目录绑定失败时,团队创建也会失败,不会留下缺少共享目录的团队。

如果这个团队用于代码交付、审计或其他对目录一致性要求高的工作,可以在创建弹窗开启“仅使用团队工作目录”:

- 开启后,团队共享目录会成为该团队会话的唯一项目工作目录。成员自己的默认目录和全局目录不会进入 cwd、Plan、项目规则或文件工具的工作目录范围。
- 这个开关不会删除成员原来的目录设置;退出团队作用域后,个人目录仍然正常可用。
- 不开启时保持兼容行为:团队目录优先,成员和全局目录仍作为相关工作目录保留。

## 智能预测

当你刚完成一轮对话、输入框为空且智能体处于空闲状态时,DesireCore 可能会在输入框上方显示一条「下一条消息」预测芯片。
Expand All @@ -109,7 +129,7 @@ DesireCore 的输入区域支持多种消息发送方式,包括文本、图片

| 类型 | 语法 | 说明 |
|------|------|------|
| 系统命令 | `/命令名` | 内置功能,如 `/plan`、`/new`、`/compact`、`/rewind`、`/steer`、`/help` 等 |
| 系统命令 | `/命令名` | 内置功能,如 `/new`、`/compact`、`/rewind`、`/steer`、`/help` 等 |
| 技能调用 | `/skill:技能名` | 调用已安装的技能 |
| 快捷调用 | `/技能名` | 直接输入技能名称快速调用 |

Expand All @@ -119,20 +139,14 @@ DesireCore 的输入区域支持多种消息发送方式,包括文本、图片

| 命令 | 用途 | 适合场景 |
|------|------|----------|
| `/plan` | 强制 Companion 先制定计划再动手 | 希望先确认方案,再允许智能体执行 |
| `/new` | 开启新的上下文边界 | 想换话题,但保留可见历史 |
| `/compact` | 手动压缩当前会话上下文 | 长对话接近模型上下文上限 |
| `/rewind` | 回撤到某条用户消息前的检查点 | 智能体走错方向,想回到之前状态 |
| `/steer` | 给正在运行的智能体追加方向指令 | 不想中断任务,只想调整执行方向 |
| `/skill:技能名` | 显式加载指定技能 | 已知道当前任务需要某个技能 |
| `/help` | 查看可用命令完整列表 | 不确定当前有哪些可用命令 |

:::tip `/plan` 的两种用法
- 单独发送 `/plan`:开启计划模式,不发任何消息
- `/plan 把所有 console.log 换成 logger.info`:开启计划模式 + 把任务作为消息发出去

计划被批准(或拒绝)后,强制模式会自动关闭。
:::
如果希望智能体只制定计划而暂不执行,直接用自然语言说明,例如:“先写 Plan,不要执行。”Plan 是工作目录中的版本化文件,不需要开启模式或使用专门命令。详见 [计划文件与自然协作](../04-delegation/02-plan-confirmation.md)。

`/steer` 只在智能体运行中生效。发送后它会作为运行中的 steer 指令进入当前任务,并在历史中以专门标记展示。

Expand Down
4 changes: 2 additions & 2 deletions docs/02-user-guide/03-teaching/01-delegation-interaction.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,11 +46,11 @@ DesireCore:你教一次,智能体就记住了。下次遇到类似情况,

### 2. 可委派

教会之后,你可以把任务交给智能体去做。它会先制定计划、征求你的确认,然后在你允许的权限范围内执行。
教会之后,你可以把任务交给智能体去做。它会先在工作目录建立或更新计划,允许你随时用自然语言审阅和修改,然后在你允许的权限范围内执行。

> "帮我审一下这份采购合同。"

智能体不会立刻开始——它会先告诉你它打算怎么做,等你确认后才动手
智能体会先让计划可见,但不要求你点击统一的“批准计划”按钮。你可以说“先只写计划”让它停在规划阶段;否则它会继续执行已授权步骤,并在真正的高风险动作前单独请求确认

### 3. 可审计

Expand Down
7 changes: 4 additions & 3 deletions docs/02-user-guide/03-teaching/02-six-primitives.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,9 +74,10 @@ DesireCore 的所有交互都建立在六个基本原语之上。理解它们,
3. [固化步骤] 检查质保期 → 与 12 个月底线对比
4. [灵活步骤] 分析进口设备相关条款
5. [灵活步骤] 综合评估合同风险等级
6. [人闸门] 生成审查报告,等待你确认后发送给对方
6. [人闸门] 发送审查报告前单独请求确认

是否按此计划执行?"
计划会保存到当前工作目录;你可以随时告诉我修改。
如果只需要计划而暂不执行,请直接说明。"
```

:::info 什么是固化、灵活、人闸门?
Expand All @@ -89,7 +90,7 @@ DesireCore 的所有交互都建立在六个基本原语之上。理解它们,

### 第五步:做(Execute)——它执行任务

你确认计划后,智能体开始逐步执行。你可以实时看到每一步的进展
除非你要求“先只写计划”,智能体会在当前授权范围内逐步执行。你可以实时看到进展;遇到计划中标注的人闸门时,它仍会为那个具体动作单独请求确认

```
智能体:
Expand Down
11 changes: 6 additions & 5 deletions docs/02-user-guide/04-delegation/01-giving-tasks.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
title: 下达任务
description: 学习如何向智能体清晰地描述一个任务,以及"下达任务"与"简单提问"的区别。
keywords: [下达任务, 委派, 任务描述, delegate, 任务范围]
last-reviewed: 2026-07-22
---

# 下达任务
Expand Down Expand Up @@ -106,13 +107,13 @@ keywords: [下达任务, 委派, 任务描述, delegate, 任务范围]
```
你下达任务
智能体可能追问(Clarify)—— 如果信息不够
智能体在工作目录建立或读取 Plan
智能体制定计划(Plan)—— 并等你确认
信息不足时通过自然对话追问(Clarify)
你确认或修改计划
智能体按你的回答产生新的 Plan revision
智能体开始执行(Execute)
智能体在当前权限边界内开始执行(Execute)
遇到关键节点时暂停确认(人闸门)
Expand All @@ -132,5 +133,5 @@ keywords: [下达任务, 委派, 任务描述, delegate, 任务范围]
| **每步确认** | 高风险或首次执行 | "每一步都跟我确认后再做" |

:::info 下一步
下达任务后,智能体会先给你一份计划。前往 [计划确认](./02-plan-confirmation.md) 了解如何审阅和确认智能体的执行计划
下达任务后,智能体会在工作目录建立或读取 Plan。前往 [计划文件与自然协作](./02-plan-confirmation.md) 了解如何审阅、直接修改和用自然语言修订计划
:::
Loading
Loading