yi-ge · Oct 9, 2026 · Oct 9, 2026
diff --git a/docs/02-user-guide/06-agents/03-create-agent.md b/docs/02-user-guide/06-agents/03-create-agent.md
@@ -6,6 +6,10 @@ keywords: [创建智能体, 自定义 Agent, 对话创建, 模板]
 
 # 创建自定义智能体
 
+:::info 长期指令的版本支持
+`instructions.md` 已在开发分支的 10.0.179 实现。截至 2026-10-09，最新公开发行版仍为 v10.0.177；正式发行版需要升级到包含这项能力的版本后才能使用。
+:::
+
 当市场上没有满足你需求的智能体时，你可以创建一个完全自定义的智能体。DesireCore 提供两种创建方式。
 
 ## 通过对话创建（推荐）
@@ -24,6 +28,7 @@ keywords: [创建智能体, 自定义 Agent, 对话创建, 模板]
    - **角色定位**：专业领域和行为风格
    - **技能需求**：需要哪些能力
    - **行为准则**：有什么该做或不该做的
+   - **长期指令**（可选）：这个智能体长期负责什么、默认怎样工作、应交付什么
 
 4. 确认后，核心智能体自动创建完整的智能体配置
 5. 新智能体出现在你的智能体列表中，可以立即使用
@@ -47,8 +52,7 @@ keywords: [创建智能体, 自定义 Agent, 对话创建, 模板]
 
 3. 配置人格设定（`persona.md`）：
    - 角色定位和语气风格
-   - 回答策略和确认策略
-   - 禁区和边界
+   - 表达习惯和回答组织方式
 
 4. 配置行为准则（`principles.md`）：
    - 核心原则
@@ -59,6 +63,14 @@ keywords: [创建智能体, 自定义 Agent, 对话创建, 模板]
    - 从技能市场安装
    - 或手动编写 SKILL.md
 
+### 补充长期指令（可选）
+
+长期职责可以在创建时通过对话提出，也可以创建后再补充，例如：
+
+> “为这个财务助手保存长期指令：每次分析先核实数据期间和口径，交付结论、关键指标、计算依据和待确认问题。详细分析步骤放在技能里。”
+
+内容保存在 `instructions.md`。创建后可通过[文件资源管理器](./06-agent-files.md)或[提示词中心](./12-prompt-center.md)编辑；不需要把长期职责塞进人格或行为准则，也不要求填写 L0/L1/L2。用户、团队和项目专属约定仍保留在对应作用范围。完整格式见[文件格式说明](../../05-more/06-file-formats.md)。
+
 ### AgentFS 目录结构
 
 创建完成后，智能体的文件存放在 `~/.desirecore/agents/<agent_id>/`：
@@ -68,6 +80,7 @@ keywords: [创建智能体, 自定义 Agent, 对话创建, 模板]
 ├── agent.json        # 入口配置（名称、描述、版本等）
 ├── persona.md        # 人格设定
 ├── principles.md     # 行为准则
+├── instructions.md   # 可选长期职责、工作策略与交付标准
 ├── memory/           # 记忆目录
 ├── skills/           # 技能目录
 ├── tools/            # 工具注册

diff --git a/docs/02-user-guide/06-agents/04-edit-persona.md b/docs/02-user-guide/06-agents/04-edit-persona.md
@@ -6,6 +6,10 @@ keywords: [人格设定, Persona, 角色定位, 性格特征, 智能体配置]
 
 # 编辑人格设定
 
+:::info 长期指令的版本支持
+`instructions.md` 已在开发分支的 10.0.179 实现。截至 2026-10-09，最新公开发行版仍为 v10.0.177；正式发行版需要升级到包含这项能力的版本后才能使用。
+:::
+
 人格设定（Persona）定义了智能体"是谁"——它的语气、风格、专业领域和行为方式。这不是一段人设文案，而是一份**可执行的行为规范**。
 
 ## 什么是人格设定
@@ -16,14 +20,13 @@ keywords: [人格设定, Persona, 角色定位, 性格特征, 智能体配置]
 |---|---|---|
 | **回答策略** | 怎么回答问题 | "先给结论，再给理由；少客套" |
 | **语气风格** | 用什么口吻说话 | "专业但不刻板，简洁但不敷衍" |
-| **确认策略** | 什么时候要问用户 | "发消息、删除、付费操作前必须确认" |
 | **禁区** | 什么不该做 | "不要使用模板腔，不要回避给结论" |
 | **不确定处理** | 拿不准时怎么办 | "说明不确定点并给验证路径" |
 
-`persona.md` 是 **Agent 层提示词**的一部分。运行时还会叠加当前用户的全局提示词和智能体所属团队的团队提示词；你可以在 **资源管理器 → 提示词中心**中集中编辑并预览最终组合。详见[提示词中心与三层提示词](./12-prompt-center.md)。
+`persona.md` 是 **Agent 层提示词**的一部分。运行时还会叠加当前用户的全局提示词和智能体所属团队的团队提示词；你可以在 **资源管理器 → 提示词中心**中集中编辑并预览最终组合。详见[提示词中心与内容归属](./12-prompt-center.md)。
 
-:::info 人格 vs 行为准则
-**人格设定**定义的是"怎么做"——语气、风格、回答方式。**行为准则**（Principles）定义的是"做什么和不做什么"——规则、边界、优先级。两者互补但不重叠。
+:::info 人格、行为准则与长期指令
+**人格**定义角色和表达风格；**行为准则**定义边界、禁区和优先级；可选 **`instructions.md`** 保存 Agent 专属的稳定职责、默认工作策略和交付标准。用户偏好、团队与项目约定保留在对应作用范围，详细方法放入技能。见[文件格式说明](../../05-more/06-file-formats.md)。
 :::
 
 ## 编辑名称、头像、描述
@@ -103,5 +106,5 @@ keywords: [人格设定, Persona, 角色定位, 性格特征, 智能体配置]
 ## 下一步
 
 - [编辑行为准则](./05-edit-principles.md) — 为智能体设定行为边界
-- [提示词中心与三层提示词](./12-prompt-center.md) — 管理全局、团队和 Agent 提示词
+- [提示词中心与内容归属](./12-prompt-center.md) — 管理全局、团队和 Agent 提示词
 - [创建自定义智能体](./03-create-agent.md) — 回顾创建流程
diff --git a/docs/02-user-guide/06-agents/05-edit-principles.md b/docs/02-user-guide/06-agents/05-edit-principles.md
@@ -6,6 +6,10 @@ keywords: [行为准则, Principles, L0, L1, L2, 安全规则, 优先级]
 
 # 编辑行为准则
 
+:::info 长期指令的版本支持
+`instructions.md` 已在开发分支的 10.0.179 实现。截至 2026-10-09，最新公开发行版仍为 v10.0.177；正式发行版需要升级到包含这项能力的版本后才能使用。
+:::
+
 行为准则（Principles）是智能体的"行为手册"——它规定了智能体必须遵守的规则、禁止触碰的红线，以及决策时的优先级排序。
 
 ## 什么是行为准则
@@ -44,9 +48,9 @@ L1 保存执行任务时需要直接看到的关键要点，默认注入系统
 
 L2 保存较长的解释、例外、示例和操作细节，默认不注入，由智能体在需要时读取：
 
-- 输出格式偏好（Markdown / 纯文本）
-- 回答详细程度（简洁 / 详尽）
-- 特定领域的工作习惯
+- 某条边界的解释与判定示例
+- 例外情况及其确认条件
+- 发生规则冲突时的优先级说明
 
 | 层级 | 默认加载 | 建议内容 | 可编辑 |
 |---|---|---|---|
@@ -83,7 +87,9 @@ L2 保存较长的解释、例外、示例和操作细节，默认不注入，
 
 ## 与其他提示词层的关系
 
-运行时按 **全局 → 所属团队 → Agent 人格 → Agent 行为准则** 组合可编辑提示词，再加入团队身份、工具、记忆等系统上下文。L0/L1/L2 决定每个文件加载多少内容；全局/团队/Agent 决定规则的适用范围。请避免在不同层重复写相互矛盾的规则，并用提示词预览检查最终组合。
+在支持长期指令的版本中，运行时按 **全局 → 所属团队 → Agent 人格 → Agent 行为准则 → Agent 长期指令** 组合可编辑片段，再加入团队身份、工具、记忆等上下文。L0/L1/L2 只控制分层文件的加载粒度；`instructions.md` 使用普通 Markdown，获准时全文加载。
+
+边界和优先级留在原则中，稳定职责与交付要求写入长期指令，角色与表达方式留在人格中。用户、团队和项目要求保留在对应作用范围；详细 SOP 放入技能。完整约定见[文件格式说明](../../05-more/06-file-formats.md)。请用提示词预览检查重复和冲突。
 
 :::tip 准则写作建议
 - **具体胜于模糊**："涉及金额超过 1000 元的操作前必须确认"比"大额操作要确认"更好
@@ -95,4 +101,4 @@ L2 保存较长的解释、例外、示例和操作细节，默认不注入，
 
 - [文件资源管理器](./06-agent-files.md) — 浏览智能体的文件结构
 - [编辑人格设定](./04-edit-persona.md) — 调整智能体的语气和风格
-- [提示词中心与三层提示词](./12-prompt-center.md) — 理解全局、团队和 Agent 的组合顺序
+- [提示词中心与内容归属](./12-prompt-center.md) — 理解全局、团队和 Agent 的组合顺序
diff --git a/docs/02-user-guide/06-agents/06-agent-files.md b/docs/02-user-guide/06-agents/06-agent-files.md
@@ -6,6 +6,10 @@ keywords: [AgentFS, 文件系统, 资源管理器, 智能体文件, 文件结构
 
 # 文件资源管理器
 
+:::info 长期指令的版本支持
+`instructions.md` 已在开发分支的 10.0.179 实现。截至 2026-10-09，最新公开发行版仍为 v10.0.177；正式发行版需要升级到包含这项能力的版本后才能使用。
+:::
+
 每个智能体的所有配置、记忆和技能都以文件的形式存储在 AgentFS（智能体文件系统）中。资源管理器让你可以直观地浏览和管理这些文件。
 
 ## AgentFS 文件结构概览
@@ -17,6 +21,7 @@ keywords: [AgentFS, 文件系统, 资源管理器, 智能体文件, 文件结构
 ├── agent.json        # 入口配置
 ├── persona.md        # 人格设定
 ├── principles.md     # 行为准则
+├── instructions.md   # 可选长期职责、工作策略与交付标准
 ├── memory/           # 记忆文件
 │   └── *.md          # 每条记忆一个文件
 ├── skills/           # 技能目录
@@ -60,6 +65,12 @@ DesireCore 的设计理念是"一切皆文件"。文件比数据库更透明—
 直接编辑 `agent.json` 等核心配置文件可能影响智能体的正常运行。如果你不确定某个字段的含义，建议通过界面或对话来修改。
 :::
 
+### 编辑长期指令
+
+已有 `instructions.md` 可以像其他 Markdown 一样在文件树中打开并编辑，也可以在[提示词中心](./12-prompt-center.md)选择智能体的“长期指令 instructions”。尚未创建文件时，可以通过对话要求保存长期职责，再编辑正文。
+
+这份文件不分 L0/L1/L2。保存后的内容在下一次输入、显式继续或恢复被接纳时读取，当前执行轮次保留原快照。详细 SOP 放入技能，个人偏好保留在用户作用范围。完整的全文加载、预算和更新约定见[文件格式说明](../../05-more/06-file-formats.md)。
+
 ## 上传和管理资源文件
 
 你可以将参考文档、模板、数据文件等上传到智能体的 `resources/` 目录，供智能体在工作时引用。
@@ -84,6 +95,7 @@ DesireCore 的设计理念是"一切皆文件"。文件比数据库更透明—
 | `agent.json` | JSON | 入口配置：名称、版本、描述、默认模型、环境注入、心跳开关、权限和仓库配置 |
 | `persona.md` | Markdown | 人格设定：语气、风格、回答策略 |
 | `principles.md` | Markdown | 行为准则：规则、禁区、优先级 |
+| `instructions.md` | 普通 Markdown | 可选的 Agent 专属长期职责、默认工作策略和交付标准，获准时全文加载 |
 | `memory/_policy.json` | JSON | 记忆压缩与保留策略 |
 | `memory/*.md` | Markdown | 记忆条目：学到的知识和偏好 |
 | `skills/*/SKILL.md` | Markdown | 技能文档：技能说明和执行指令 |

diff --git a/docs/02-user-guide/06-agents/09-clone-and-sync.md b/docs/02-user-guide/06-agents/09-clone-and-sync.md
@@ -6,6 +6,10 @@ keywords: [Clone, 克隆智能体, 同步, 冲突解决, Agent Git]
 
 # Clone 与同步
 
+:::info 长期指令的版本支持
+`instructions.md` 已在开发分支的 10.0.179 实现。截至 2026-10-09，最新公开发行版仍为 v10.0.177；正式发行版需要升级到包含这项能力的版本后才能使用。
+:::
+
 Clone 用于基于现有智能体创建一个新副本。它适合做实验、为不同项目准备变体，或把市场智能体调整成自己的版本。
 
 ## 何时需要克隆
@@ -34,6 +38,12 @@ Clone 用于基于现有智能体创建一个新副本。它适合做实验、
 核心 DesireCore 智能体（系统调度器）不允许被克隆，以避免破坏主控入口。如果菜单中克隆选项为灰色，说明该智能体受保护。
 :::
 
+### 长期指令跟随智能体本体
+
+可选 `instructions.md` 与人格、原则等定义文件一起随智能体克隆、导入导出和版本更新，不属于“私有数据选项”。它应只保存 Agent 自身的长期职责与交付要求；用户、团队或项目专属内容保留在对应作用范围，避免通过共享智能体把这些内容带给其他人。
+
+更新前可以查看长期指令的 diff，决定如何合并本地与上游要求。使用这类内容包前，应满足包声明的最低客户端版本。格式与归属见[文件格式说明](../../05-more/06-file-formats.md)。
+
 ## 私有数据选项
 
 克隆时可以选择是否复制当前用户与该智能体之间的私有数据：
@@ -57,7 +67,7 @@ Clone 用于基于现有智能体创建一个新副本。它适合做实验、
 4. 点击 **合并更新**，系统执行 Git 合并
 
 :::info 更新策略
-- **纯配置更新**（人格、原则、技能）：查看差异，确认是否需要保留本地调整
+- **定义更新**（人格、原则、长期指令、技能）：查看差异，确认是否需要保留本地调整
 - **新增技能/工具**：合并后检查新增内容及依赖要求
 - **删除或重命名**：需要手动确认，系统不会静默删除你本地已有的文件
 :::