NeuroBook

Appearance

节点说明 ​

Profile TSX 节点会被编译成 ProfileTurnPlan。不同节点进入不同上下文区域，因此不要把所有内容都塞进 system prompt。

ProfilePrompt ​

ProfilePrompt 是根节点。顶层推荐只放：

  • System
  • HistorySet
  • ModelContext
  • AppendingSet
  • Compaction
  • If
  • Fragment

不要在根节点下放非空裸文本。

System ​

System 定义 profile 的长期身份、任务边界和工具原则。

适合放：

  • profile 是谁。
  • profile 不应该做什么。
  • 工具和输出边界。
  • 长期协作规则。

不适合放当前 Project Workspace、当前选中文件、本轮任务摘要或大段共享协议。共享协议优先放进 reference/，再用 Import。

HistorySet ​

HistorySet 是稳定历史前缀。session 缺少前缀时写入，已有前缀时不每轮重复。

适合放：

  • AgentCatalog
  • SkillCatalog
  • <Import path="reference/..." />
  • 稳定共享规范

Import、SkillCatalog、AgentCatalog 都是 string fragment，必须包在 Message 或 System 这类 string 容器里。

ModelContext ​

ModelContext 只进入本轮模型上下文，不写入产品历史。

适合放：

  • VariableSchema
  • Variable
  • SQL schema summary
  • 本轮临时摘要
  • 不应持久化的 Reminder / Watch

变量第一版只能直接放在 ModelContext。

AppendingSet ​

AppendingSet 产出的非空消息会贴近当前用户输入，并写入当前历史光标。

适合放：

  • RuntimeLocationReminder
  • WorkspaceFocusReminder
  • PlanModeReminder
  • LinkedAgentsReminder
  • TaskReminder
  • MentionedSkillsReminder
  • ActivatedSkills

AppendingSet 也不接受非空裸文本，文本要放在 Message 内。

Import ​

Import 用于导入共享文本文件：

tsx
<HistorySet>
    <Message>
        <Import path="reference/agent/project-workspace-guide.md" />
    </Message>
</HistorySet>

V1 允许路径：

  • AGENTS.md
  • reference/**
  • docs/**

缺失文件默认返回空字符串；required={true} 时缺失会报错。渲染结果是 Markdown fenced block。

Reminder 和 Watch ​

Reminder 用于按条件注入提醒；Watch 用于观察变量变化并在变化时写入消息。

它们适合放在 ModelContext 或 AppendingSet，不要放入 HistorySet。

继续阅读 ​