bingshuo
e82a377b58
冰朔的铸渊人格系统开发记录：HoloLake Agent 工具运行、上下文阈值拦截、页面组件，以及真实笔记 Markdown 表格修复。明确不属于公共运维智能人格系统。
146 lines
8.4 KiB
Text
146 lines
8.4 KiB
Text
---
|
||
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 已经运行。
|
||
- 文件中不保存密码、令牌、工单领取凭证或任何长期秘密。
|