> For the complete documentation index, see [llms.txt](https://tinyhumans.gitbook.io/openhuman/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/goals-and-todos.md).

# 目标与待办

OpenHuman 通过三个互补层级，让代理始终与您真正关心的内容保持一致：持久的 **长期目标**、一个 **线程目标** （每次对话一个），以及一个协作式 **任务看板** 来管理待办事项。每一项都可以由您和代理共同编辑，而且它们都会在重启后保留。

***

## 长期目标

一份简短、可读性强的持久目标列表，例如 *“发布桌面应用”* 或 *“将社区发展到 1 万人。”* 它以一个普通的 Markdown 文件（`MEMORY_GOALS.md`）的形式存放在您的工作区中，因此您可以直接打开并编辑它。

这个列表刻意保持很小，最多约 **8 项 / 500 tokens**，这样代理在每次相关轮次中读取它的成本很低，而您也更容易保持其内容准确。每个目标都有一个稳定的短 ID（`g1`, `g2`，……），因此可以在不依赖顺序的情况下编辑或删除。

* **目标面板** （智能 → 目标）显示该列表，并提供添加 / 编辑 / 删除操作。
* **反思** 会运行一个后台 `goals_agent` ，它会将您的目标与最近的记忆和对话进行比对，然后做出最小且有依据的修改：加入您显然已经开始推进的内容，移除您已经放弃的内容。首次运行时，它会根据您的上下文初始化一组初始目标。
* 代理会通过其 `goals_list` / `goals_add`  / 编辑工具在对话过程中读取并更新同一份列表，因此您和代理的修改始终保持同步。

RPC 接口： `openhuman.memory_goals_list` / `_add` / `_edit` / `_delete` / `_reflect`.

***

## 线程目标

每次对话都可以携带 **一个** 线程目标：一种持久的“完成契约”，代理会跨轮次、中断、恢复和预算边界持续推进。线程目标包含一个目标、一个状态，以及一个可选的 **token 预算** ，以便您限制一个线程最多可以消耗多少工作量。

| 状态               | 含义                                |
| ---------------- | --------------------------------- |
| `active`         | 代理可以继续推进该目标。                      |
| `paused`         | 已暂停（例如您中断了它）；当线程恢复时重新激活。          |
| `budget_limited` | 已消耗 token ≥ 预算；在您提高预算之前，实质性工作会停止。 |
| `complete`       | 目标已满足。                            |

协调器使用 `goal_set`设置目标，使用 `goal_get`读取目标，并使用 `goal_complete`完成目标。更新会发出 `thread/goal/updated` 事件，因此界面会保持实时更新。

**自主空闲续接。** 如果一个线程有活跃目标但进入空闲状态（没有正在进行的轮次，在设定的时间间隔内没有活动，例如 10 分钟）， [心跳](https://github.com/tinyhumansai/openhuman/tree/main/gitbooks/features/subconscious.md) 可以注入一个单次续接轮次，恢复对话记录并继续推进该目标。此功能为可选（`heartbeat.goal_continuation_enabled`），并且在每个空闲周期都有一次性抑制标志保护，因此代理绝不会自己驱动进入循环。

***

## 任务看板（待办事项）

每次对话还会包含一个 **看板式任务看板**：一份由您和代理共同构建的离散工作卡片列表。与线程目标（一个持久目标）不同，看板是具体条目的集合，每个条目都有丰富的结构：

* 标题 / 描述，以及一个 **状态**: `todo`, `in_progress`, `awaiting_approval`, `ready`, `blocked`, `done`, `rejected`.
* 可选的目标和期望结果。
* 有顺序的 **执行计划**, **验收标准** 清单、分配的代理，以及一个 **审批模式** （必需 / 不需要）。
* 备注、阻塞原因，以及证据 / 链接。

代理通过 `todo_list`读取看板，通过 `todo_add`追加，通过 `todo_edit`编辑，通过 `todo_update_status`推进状态。破坏性操作（清空 / 移除 / 替换）默认被禁用。您和代理共享同一份持久存储，因此编辑会保持一致。

两个保留看板分别支持特殊视图：

* **`user-tasks`**：您的个人任务列表，不附属于任何对话。可从 **用户任务编辑器** （智能 → 任务）中创建和管理这些任务。您还可以选择性地将任务附加到某次对话，并通过 `approvalMode: not_required`将其分配给协调器，这样后台调度器就会自动领取并执行它。
* **`task-sources`**：一个任务收件箱，用于在外部来源导入任务后，再将其提升为代理工作流的一部分。

RPC 接口： `openhuman.todos_list` / `_add` / `_edit` / `_update_status` / `_set_session_thread`。返回结果包含一个渲染后的 `markdown` 字段，因此看板在界面和代理对话记录中的呈现完全一致。

***

## 三者之间的关系

| 层级         | 范围     | 数量      | 由谁驱动                    |
| ---------- | ------ | ------- | ----------------------- |
| 长期目标       | 您的整个账号 | 最多约 8 个 | 您 + 定期 `goals_agent` 反思 |
| 线程目标       | 一个对话   | 每线程 1 个 | 协调器，可选预算                |
| 任务看板（待办事项） | 一个对话   | 许多卡片    | 您 + 代理，共同协作             |

***

## 另见

* [潜意识循环](https://github.com/tinyhumansai/openhuman/tree/main/gitbooks/features/subconscious.md)：驱动空闲续接和任务评估的后台循环。
* [记忆树](/openhuman/zh/gong-neng/obsidian-wiki/memory-tree.md)：目标反思读取的来源。