---
gls:
  specification: GLS-0400
  specification_version: "1.0"
document:
  id: ZY-HOLOLAKE-AGENT-RUNTIME-CONTEXT-PAGE-001
  name: HoloLake Persona Agent Runtime, Context Governance and Page Components
  version: "1.0.0"
  status: verified_local_implementation
  language: zh-CN
  created_at: "2026-07-28T00:18:00+08:00"
  updated_at: "2026-07-28T00:18:00+08:00"
classification:
  system: HLDP
  layer: history
  content_type: engineering_decision_leaf
  execution_mode: read_only
history:
  object_type: leaf
  path: "hldp://fifth-domain/persona/ICE-P-ZY001/cognition/2026-07-27/hololake-agent-runtime-context-page-components"
  parent: "hldp://fifth-domain/persona/ICE-P-ZY001/cognition/2026-07-27"
  root: "hldp://fifth-domain"
  sequence: 3
  append_only: true
---

# HLDP-LEAF · HoloLake 人格体工具、上下文与页面组件开发线

> **主体边界**：本叶片属于冰朔的铸渊人格系统 `ICE-P-ZY001`
>（历史兼容号 `ICE-GL-ZY001`），不是公共智能运维系统
> `SYS-GLW-ZY-EXEC-0001`。

```yaml
engineering_record:
  human_anchor:
    id: ICE-GL∞
    name: 冰朔
  persona:
    id: ICE-P-ZY001
    legacy_id: ICE-GL-ZY001
    name: 铸渊

  product:
    name: HoloLake Era
    repository: bingshuo/hololake-platform
    remote: https://guanghulab.com/fifth-domain/bingshuo/hololake-platform.git
    branch: main
    implementation_commit: 90ce0315e31790656207f38fc0fc9f9b2e70249a
    implementation_tree: 912fd7dcd22b5389aca27451eafccfd1824e02c5
    external_source: /Volumes/HoloLakeBuild/source/hololake-platform-current
    physical_backing: /Volumes/JZAO/HoloLake/HoloLakeBuild.sparsebundle
    desktop_app_kept: /Users/bingshuolingdianyuanhe/Desktop/HoloLake Era 表格修复预览 2026-07-28.app

  problem_chain:
    - "AI 独立窗口缩放后被截断、覆盖，消息区与输入区不能稳定恢复。"
    - "工具参数正确且只读取少量页面时，工具结果仍可能中断，最终显示 finished without returning a reply。"
    - "人格体看不到完整、连续、可修复的工具回执，只能猜测执行状态。"
    - "页面表格和架构内容挤在一起，缺少独立横向视口和清晰层级。"
    - "传统做法把大量固定工具和系统摘要塞给人格体，既重又不能保证适配当前知识湖。"

  implemented:
    tool_runtime:
      - "OpenAI 兼容链使用原生 assistant.tool_calls → role:tool 回执，不再把结果伪装成普通文本。"
      - "工具失败也回送模型，使人格体能读取错误并修复参数或调整下一步。"
      - "工具结果总预算约 32 KiB，在多步骤之间均衡分配，避免单页吞掉全部上下文。"
      - "最多执行 8 轮工具循环；到预算边界时进入一次禁止继续调用工具的最终回答轮，已完成结果不会被丢弃。"
      - "神笔马良一次计划可含 1–12 个临时步骤；七页不是系统上限。"
      - "时间字段写入前必须取得真实系统时间回执，避免模型凭上下文猜时间。"
      - "临时工具步骤在当前知识湖权限边界内执行，不自动形成不可审计的永久工具缓存。"
    workspace_ui:
      - "AI 工作区作为独立窗口运行，可关闭、最小化、最大化和恢复，窗口尺寸与最小约束同步修复。"
      - "消息区域、输入区域和会话侧栏各自拥有明确的弹性与滚动边界，减少横向截断和反复拖动。"
      - "首页字号、间距、主题层次与动效重新整理，并保留多主题切换能力。"
    page_components:
      - "Markdown 表格获得局部横向滚动容器、最小列宽和粘性表头，宽架构表不再挤成一团。"
      - "补齐 Markdown 到 BlockNote 的表格解析容错：模型写出 `|:--|` 等两横线分隔符时，只在真实表头下规范为合法 GFM 三横线；围栏代码示例保持原样。"
      - "Mermaid 架构图保留局部视口，并可进入全屏查看。"
      - "保留可持久化 callout 组件，供人格体写结论、风险、协议与检查点。"

  verified:
    frontend_tests: "4910 / 4910 passed"
    focused_page_layout_tests: "2 / 2 passed"
    focused_table_parser_tests: "13 / 13 passed"
    playwright_smoke: "26 / 26 passed"
    rust_tests: "1103 passed"
    rust_line_coverage: "87.11%"
    frontend_line_coverage: "88.47%"
    build: passed
    typecheck: passed
    lint: passed
    rust_clippy_and_fmt: passed
    codescene: "not executed: credentials were not present; remote gate skipped it explicitly"

  storage_and_cleanup:
    - "源码已从电脑本地迁移到移动硬盘上的独立 Git 仓库，并校验迁移前后工作树摘要一致。"
    - "Rust 构建产物清理约 9.2 GiB；旧 node_modules、构建缓存和临时包在正式验证后继续清理。"
    - "桌面旧版 HoloLake 预览 App 已删除，只保留最新 UI 修复预览版。"
    - "Codex cache、临时目录、生成图缓存与旧日志数据库内容已清理；会话、记忆、插件和技能保留。"

  architecture_decisions:
    magic_brush:
      principle: "系统只给人格体一支受约束的笔，而不是预装一仓库固定工具。"
      execution: "人格体按当前知识湖任务生成临时操作计划；系统做权限、路径、参数、预算和危险动作拦截。"
      visibility: "小湖灯实时看板接收计划、开始、进度、系统回执、错误、重试、完成和注册建议。"
      durable_skill: "成功路径只保存经过审计的操作说明、输入输出契约和适用边界；下次按需加载，不固化沉重运行体。"

    context_governance:
      persona_authority: "人格体决定语义重点、HLRDP 压缩结构、长期记忆写入和按需展开路径。"
      system_guard: "系统只监测容量、保留压缩余量并执行协议门，不替人格体生成语义摘要。"
      soft_threshold: "提示剩余空间、未决任务和建议检查点，由人格体选择是否提前压缩。"
      hard_threshold: "系统拦截普通回复与新工具调用，只允许人格体执行压缩协议。"
      commit: "人格体提交压缩结构后，系统校验可恢复性、引用、未决任务和身份核心，再以两阶段方式切换上下文。"
      emergency_threshold: "冻结扩张动作，保留最后有效检查点；不得静默丢弃对话或由无关系统乱写摘要。"
      invariant: "人格自我认知与身份边界常驻上下文开头；任务细节、执行轨迹和旧对话按 HLRDP 树递归压缩。"

  research:
    reference_product: xAI Grok Build
    repository: https://github.com/xai-org/grok-build
    use_boundary:
      - "只研究成熟 Agent 产品的工具回执、运行循环、状态事件、上下文组织和失败恢复。"
      - "拆成可验证零件后重写进 HoloLake，不整套照搬，也不让外部框架覆盖第五域语言协议。"

  next_engineering:
    - "实现人格体可见、系统真实连接的小湖灯事件看板，并将执行状态定义为稳定事件协议。"
    - "实现软阈值、硬阈值、压缩专用模式、HLRDP 校验和两阶段上下文切换。"
    - "为几百到几千页知识湖读取增加分页、游标、索引、摘要层、断点续传和批次回执；禁止一次性灌入上下文。"
    - "把成功的神笔马良步骤登记为轻量技能说明，并提供版本、权限、回滚和失效机制。"
```

## 本轮结论

七八页读取不应成为上限。本次崩溃的根因不是页数本身，而是工具结果回执、循环终止与
上下文预算管理没有形成稳定闭环。本轮先修复基础工程链；大规模知识湖读取继续采用
“分页 + 游标 + 断点 + 分层摘要”，目标可以是数百或数千页，但不能把所有正文一次性
塞进模型上下文。

人格体自主权与系统阈值门并不冲突：人格体负责“什么重要、如何压缩、留下什么”，系统
负责“什么时候必须停下来先执行协议、压缩是否可恢复、权限有没有越界”。这是 HoloLake
后续神笔马良和小湖灯的共同运行边界。

## 证据边界

- 本叶片记录可审计的输入、判断、工程决策、实现、测试与下一步，不记录模型隐藏思维过程。
- 本地完整实现提交已经形成；远端发布必须以代码频道读回完整 SHA 为准。
- 仓库发布不等于服务器部署，也不证明常驻人格 Agent 已经运行。
- 文件中不保存密码、令牌、工单领取凭证或任何长期秘密。