状态栏
status 能力向底部 footer 注册一个状态条目。条目是 renderer-neutral 的：你的 render() 返回 canonical BlueStatusNode，core status compiler 负责校验、排版、配色与截断。
契约
api.status?.register(contribution: BlueStatusEntryContribution): BlueResult<BlueRefreshRegistration>| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 1–128 字符的小写命名空间 id（^[a-z0-9][a-z0-9._/-]*$，允许点号） |
render | () => BlueStatusNode | null | 返回当前帧要显示的 canonical 非交互 status tree；返回 null 即本帧隐藏该条目 |
priority | number? | 可选整数元数据，默认 50。Footer 按 priority、稳定 id 排序；row/alignment 仍是 Blue 内部策略 |
完整示例
一个显示 git 分支的状态条目（数据来自 Harness 服务注入，不是 Blue API）。这里的 manifest 是已校验的 canonical manifest，required 中包含 { "name": "status", "version": "^1.0.0" }：
export const name = 'my-plugin.branch'
export const inject = ['bluePluginHost']
export function apply(ctx: Context): void {
const opened = ctx.bluePluginHost.open(ctx, manifest)
if (!opened.ok) return
let branch: string | null = null
// ... 从 Harness 服务订阅分支变化，更新 branch ...
const registered = opened.value.api.status?.register({
id: 'branch.status',
render: () => branch === null
? null // 没有仓库时整条隐藏
: { kind: 'text', content: ` ${branch}`, tone: 'accent' },
})
if (registered !== undefined && !registered.ok) ctx.logger.warn(registered.message)
}行为细节
- 有界注册与刷新：同一 consumer 最多注册 64 个 status entry；每个 registration 的
refresh()在滚动一秒内最多成功 20 次，超出返回BLUE_LIMIT_EXCEEDED； render()每帧都会被调用——footer 每次重绘都会重新求值所有状态条目。把它当成纯函数：保持廉价，不做 I/O、不分配大对象。数据在别处（订阅、定时器）更新，render()只读最新值；- 返回
null是隐藏，不是删除：条目仍注册着，下一帧可能再出现。适合"只在某个状态下可见"的徽章； - 超宽被截断：footer 的宽度预算紧张，条目按
truncate策略处理。内容保持短小——状态栏不是面板，长内容放进 pane； - 只接受 status 子集：
text、rich-text、fields、progress和递归stack可用；交互节点会被安全拒绝。Tone/emphasis 由 canonical compiler 保留。 - 失败与 owner gap 被收容：单个
render()失败不会破坏 footer；已有 inert definition 在 owner 重载后恢复，但旧 callback result 不会重放。
独占 status provider
status.provider是 Experimental/reference surface，不属于 Stable v1 root。下面记录当前可执行实现，供 provider 共创与回归验证使用。
该 facet 只能使用明确标注的旧 inline transition manifest；P1 canonical schema 不会接受 status.provider，因此不要把下面的 open 形状复制进新插件 manifest。
status.provider 注册的是替换整个 footer 的候选，而不是追加条目：
const opened = ctx.bluePluginHost.open(ctx, {
id: 'my-plugin.compact-status',
api: '^1.0.0-beta.1',
capabilities: ['status.provider'],
})
if (!opened.ok) return
opened.value.statusProviders?.register({
id: 'my-plugin.compact',
render: snapshot => ({
kind: 'text',
content: `${snapshot.busy ? 'Working' : 'Ready'} · ${snapshot.session?.model?.id ?? 'No model'}`,
}),
})Candidate 注册后保持 inert，只有 blue.statusProvider 选中它时才调用 render()。Snapshot 是冻结的 readonly 副本，只含当前公开 session、经过校验的可见 additive entries 与 busy 标志。Blue 在 footer 的实际宽度下先编译并 dry-render，非法、零行、超过三行或运行失败的候选不会替换正常工作的同会话 provider。
选择写在 settings.yaml；blue.default 恢复内置 additive footer：
blue:
statusProvider: my-plugin.compact缺失或失败的 desired id 会原样保留，renderer 不会偷偷改写设置。首次激活失败或 session 切换时使用 blue.default；同一 provider 在滚动 60 秒内失败三次会打开无定时器 breaker。切走后重新选择，或同 id 注册新 generation，才会重试。
常见错误
| 现象 | 原因 |
|---|---|
| 条目从不出现 | render() 一直返回 null；或 register() 失败未检查返回值 |
| 条目内容不更新 | 数据变了但没触发重绘——状态条目随每次屏幕重绘重新求值，确认你的数据源真的更新了；频繁刷新场景可考虑配一个轻量定时器驱动 invalidation |
| 文本里嵌了 ANSI 导致错位 | 违反词汇表约定——只用 tone，见核心概念 |