bingshuo/hololake-system-architecture
Watch
1
0
Fork
You've already forked hololake-system-architecture
 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity
hololake-system-architecture/build/TCS-PROGRAM-MACOS-FOCUSED-APPLICATION-OBSERVE-0001.human.zh-CN.md

15 KiB
Raw Blame History

macOS当前聚焦应用结构树只读观察 · 简体中文人类工程语言版

这是 TCS/HLDP 原生源码的简体中文阅读投影，不是新的正本，也不授予执行权限。若本页与 .tcs 源码不一致，以经过校验的 .tcs 源码为准。

这是什么

这是一份 程序 声明，编号为 TCS-PROGRAM-MACOS-FOCUSED-APPLICATION-OBSERVE-0001，版本为 0.1.0。转换器已先用 Stage-1 编译器校验原生源码，再把机器枚举翻译成汉语；原始编号保留在括号和字段路径中。

谁在这里

  • 执行主体 subject
    • channel_id：ICE-CH-ZC001 subject.channel_id
    • subject_id：TCS-HOST-OBJECT-OBSERVER-MACOS-0001 subject.subject_id
    • subject_kind：RUNTIME_INSTANCE subject.subject_kind
    • verification：LOCAL_STAGE12_READ_ONLY_CANDIDATE subject.verification

为什么开始

  • 来源 source
    • 来源编号：BINGSHUO-HOLOLAKE-TCS-ENGINEERING-ANCHOR-20260823 source.source_id
    • 来源角色：人类直接语言来源（DIRECT_HUMAN） source.source_role
    • 来源校验值：a3dd8dbd2203b631bdb23f2693eb314d4ef86af68fdeaee8835e3cf0861ddd23 source.source_sha256
    • 来源地址：language-sources/direct-human/BINGSHUO-HOLOLAKE-TCS-ENGINEERING-ANCHOR-20260823.txt source.source_uri

发生了什么变化

源程序没有提供这一项，转换器不猜。

准备怎样执行

  • 目标 target
    • 精确路径：./state/shared-desktop/macos-observation/MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001.hldp target.exact_path
    • 预期指纹：NO_PRIOR_OBSERVATION_RECEIPT target.expected_fingerprint
    • 预期状态：当前不存在（ABSENT） target.expected_state
    • target_id：MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001 target.target_id
  • 输入 inputs
    • HOST_SCOPE inputs.HOST_SCOPE
      • adapter：MACOS_ACCESSIBILITY inputs.HOST_SCOPE.adapter
      • attributes inputs.HOST_SCOPE.attributes
        • ROLE
        • SUBROLE
        • TITLE_HASH
        • VALUE_KIND
        • ENABLED
        • FOCUSED
        • CHILDREN
      • identity_scheme：SHA256_V1_HOST_SNAPSHOT_PID_AXPATH_ROLE_SUBROLE inputs.HOST_SCOPE.identity_scheme
      • max_depth：2 inputs.HOST_SCOPE.max_depth
      • max_nodes：128 inputs.HOST_SCOPE.max_nodes
      • mode：READ_ONLY inputs.HOST_SCOPE.mode
      • platform：MACOS inputs.HOST_SCOPE.platform
      • 是否必需：是 inputs.HOST_SCOPE.required
      • root：FOCUSED_APPLICATION inputs.HOST_SCOPE.root
      • 来源：TCS_PROTOCOL inputs.HOST_SCOPE.source
      • trust_prompt：否 inputs.HOST_SCOPE.trust_prompt
      • type：HostObjectTreeObservation inputs.HOST_SCOPE.type
  • 执行条件 conditions
    • C1 conditions.C1
      • 失败后：失败时默认关闭，不继续执行（FAIL_CLOSED） conditions.C1.on_false
      • predicate：MACOS_ADAPTER_PRESENT conditions.C1.predicate
    • C2 conditions.C2
      • 失败后：失败时默认关闭，不继续执行（FAIL_CLOSED） conditions.C2.on_false
      • predicate：READ_ONLY_AND_TRUST_PROMPT_FALSE conditions.C2.predicate
    • C3 conditions.C3
      • 失败后：失败时默认关闭，不继续执行（FAIL_CLOSED） conditions.C3.on_false
      • predicate：TARGET_INSIDE_SHARED_DESKTOP_MACOS_OBSERVATION_ROOT conditions.C3.predicate
    • C4 conditions.C4
      • 失败后：失败时默认关闭，不继续执行（FAIL_CLOSED） conditions.C4.on_false
      • predicate：NO_DESKTOP_ACTION_AND_NO_NETWORK conditions.C4.predicate
  • 动作 actions
    • A1 actions.A1
      • input_refs actions.A1.input_refs
        • HOST_SCOPE
      • 失败后：失败时默认关闭，不继续执行（FAIL_CLOSED） actions.A1.on_failure
      • 成功后：完成（COMPLETE） actions.A1.on_success
      • 操作：CORE.OBSERVE_HOST_OBJECT_TREE actions.A1.operation
      • output_refs actions.A1.output_refs
        • OBJECT_TREE_OR_DENIAL
        • OBSERVATION_RECEIPT
  • 输出 outputs
    • OBJECT_TREE_OR_DENIAL outputs.OBJECT_TREE_OR_DENIAL
      • destination：TARGET_STATE outputs.OBJECT_TREE_OR_DENIAL.destination
      • integrity：SHA-256 完整性校验（SHA256） outputs.OBJECT_TREE_OR_DENIAL.integrity
      • type：Record outputs.OBJECT_TREE_OR_DENIAL.type
    • OBSERVATION_RECEIPT outputs.OBSERVATION_RECEIPT
      • destination：回执（RECEIPT） outputs.OBSERVATION_RECEIPT.destination
      • integrity：SHA-256 完整性校验（SHA256） outputs.OBSERVATION_RECEIPT.integrity
      • type：Record outputs.OBSERVATION_RECEIPT.type

边界与异常处理

  • 权限边界 authority
    • issuer：ICE-GL∞_DIRECT_ENGINEERING_INSTRUCTION authority.issuer
    • lease_required：否 authority.lease_required
    • proof_ref：BINGSHUO-HOLOLAKE-TCS-ENGINEERING-ANCHOR-20260823@a3dd8dbd2203 authority.proof_ref
    • scope：ONE_LOCAL_MACOS_FOCUSED_APPLICATION_READ_ONLY_OBSERVATION_WITHOUT_PERMISSION_PROMPT authority.scope
    • single_use：是 authority.single_use
    • valid_from：2026-08-24 authority.valid_from
    • valid_until：CURRENT_STAGE12_END authority.valid_until
  • 资源边界 resources
    • concurrency：1 resources.concurrency
    • 内存上限字节：67108864 resources.memory_limit_bytes
    • runway：LOCAL_TCS_GIR_RUNTIME_STAGE12_CANDIDATE resources.runway
    • 超时毫秒：5000 resources.timeout_ms
  • 失败处理 failure
    • errors failure.errors
      • TCS-E2101
      • TCS-E3001
      • TCS-E4001
      • TCS-E4002
      • TCS-HOST-E4003
      • TCS-HOST-E5102
      • TCS-E6002
      • TCS-E8001
    • 失败时默认关闭：是 failure.fail_closed
  • 停止条件 stop
    • safe_checkpoint：WRITE_ONLY_EXPLICIT_OBSERVATION_OR_DENIAL_RECEIPT stop.safe_checkpoint
    • signals stop.signals
      • 调用方要求停止（CALLER_STOP）
      • 执行超时（TIMEOUT）
      • ACCESSIBILITY_PERMISSION_NOT_GRANTED
      • NO_FOCUSED_APPLICATION
      • NODE_LIMIT_REACHED
  • 清理范围 cleanup
    • exact_boundary：ONE_STAGE12_OBSERVATION_TEMPORARY_FILE_ONLY cleanup.exact_boundary
    • targets cleanup.targets
      • ./state/shared-desktop/macos-observation/.MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001.tmp
  • 回滚方案 rollback
    • 动作 rollback.actions
      • REMOVE_ONLY_STAGE12_TEMPORARY_OBSERVATION
    • preconditions rollback.preconditions
      • PARTIAL_OBSERVATION_WITHOUT_READBACK
    • verification rollback.verification
      • NO_MACOS_ACTION
      • NO_PERMISSION_PROMPT
      • NO_NETWORK
      • NO_OTHER_FILE_CHANGED

怎样算完成

  • 回执 receipt
    • 人类可读投影：必须生成（REQUIRED） receipt.human_projection
    • integrity：SHA-256 完整性校验（SHA256） receipt.integrity
    • machine_path：./state/shared-desktop/macos-observation/MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001.hldp receipt.machine_path
    • 协议：TCS-HOST-OBJECT-TREE-OBSERVATION-RECEIPT-v1 receipt.protocol
    • target_readback：OBSERVED_TREE_HASH_OR_EXPLICIT_PERMISSION_DENIAL receipt.target_readback

下一次从哪里继续

源程序没有提供这一项，转换器不猜。

来源与校验

  • 原生声明编号：TCS-PROGRAM-MACOS-FOCUSED-APPLICATION-OBSERVE-0001
  • 原生声明类型：PROGRAM
  • TCS 源码 SHA-256：f4cbc81d88aede257af0222e292ea828c7840cc0f6d097851699e402e5385650
  • 校验编译器：TCS-COMPILER-STAGE6-HOST-OBJECT-OBSERVATION-0001
  • 投影协议：GLS-HLDP-HUMAN-ENGINEERING-PROJECTION-0001

原生结构逐项对照

下面保留源码的全部顶层结构和字段路径，供人类审计投影有没有漏掉信息。

  • 动作 actions
    • A1 actions.A1
      • input_refs actions.A1.input_refs
        • HOST_SCOPE
      • 失败后：失败时默认关闭，不继续执行（FAIL_CLOSED） actions.A1.on_failure
      • 成功后：完成（COMPLETE） actions.A1.on_success
      • 操作：CORE.OBSERVE_HOST_OBJECT_TREE actions.A1.operation
      • output_refs actions.A1.output_refs
        • OBJECT_TREE_OR_DENIAL
        • OBSERVATION_RECEIPT
  • 权限边界 authority
    • issuer：ICE-GL∞_DIRECT_ENGINEERING_INSTRUCTION authority.issuer
    • lease_required：否 authority.lease_required
    • proof_ref：BINGSHUO-HOLOLAKE-TCS-ENGINEERING-ANCHOR-20260823@a3dd8dbd2203 authority.proof_ref
    • scope：ONE_LOCAL_MACOS_FOCUSED_APPLICATION_READ_ONLY_OBSERVATION_WITHOUT_PERMISSION_PROMPT authority.scope
    • single_use：是 authority.single_use
    • valid_from：2026-08-24 authority.valid_from
    • valid_until：CURRENT_STAGE12_END authority.valid_until
  • 清理范围 cleanup
    • exact_boundary：ONE_STAGE12_OBSERVATION_TEMPORARY_FILE_ONLY cleanup.exact_boundary
    • targets cleanup.targets
      • ./state/shared-desktop/macos-observation/.MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001.tmp
  • 执行条件 conditions
    • C1 conditions.C1
      • 失败后：失败时默认关闭，不继续执行（FAIL_CLOSED） conditions.C1.on_false
      • predicate：MACOS_ADAPTER_PRESENT conditions.C1.predicate
    • C2 conditions.C2
      • 失败后：失败时默认关闭，不继续执行（FAIL_CLOSED） conditions.C2.on_false
      • predicate：READ_ONLY_AND_TRUST_PROMPT_FALSE conditions.C2.predicate
    • C3 conditions.C3
      • 失败后：失败时默认关闭，不继续执行（FAIL_CLOSED） conditions.C3.on_false
      • predicate：TARGET_INSIDE_SHARED_DESKTOP_MACOS_OBSERVATION_ROOT conditions.C3.predicate
    • C4 conditions.C4
      • 失败后：失败时默认关闭，不继续执行（FAIL_CLOSED） conditions.C4.on_false
      • predicate：NO_DESKTOP_ACTION_AND_NO_NETWORK conditions.C4.predicate
  • 失败处理 failure
    • errors failure.errors
      • TCS-E2101
      • TCS-E3001
      • TCS-E4001
      • TCS-E4002
      • TCS-HOST-E4003
      • TCS-HOST-E5102
      • TCS-E6002
      • TCS-E8001
    • 失败时默认关闭：是 failure.fail_closed
  • 语言头 header
    • 正本路径：language/programs/TCS-PROGRAM-MACOS-FOCUSED-APPLICATION-OBSERVE-0001.tcs header.canonical_uri
    • compatibility header.compatibility
      • TCS-COMPILER-STAGE6-HOST-OBJECT-OBSERVATION-0001
      • GIR/1
    • 语言：TCS/0.1 header.language
    • 生命周期：候选版本，尚未成为正式正本（CANDIDATE） header.lifecycle
    • 英文名：macOS Focused Application Structured Tree Read Only Observation header.name_en
    • 中文名：macOS当前聚焦应用结构树只读观察 header.name_zh
    • 协议配置：HLDP-NP/1 header.profile
    • protocols header.protocols
      • TCS-HOST-STRUCTURED-OBJECT-TREE-OBSERVATION-0001
      • TCS-HOLOLAKE-SHARED-DESKTOP-FRAMEWORK-BEHAVIOR-0001
    • schema：tcs.program/v1 header.schema
    • 版本：0.1.0 header.version
  • 输入 inputs
    • HOST_SCOPE inputs.HOST_SCOPE
      • adapter：MACOS_ACCESSIBILITY inputs.HOST_SCOPE.adapter
      • attributes inputs.HOST_SCOPE.attributes
        • ROLE
        • SUBROLE
        • TITLE_HASH
        • VALUE_KIND
        • ENABLED
        • FOCUSED
        • CHILDREN
      • identity_scheme：SHA256_V1_HOST_SNAPSHOT_PID_AXPATH_ROLE_SUBROLE inputs.HOST_SCOPE.identity_scheme
      • max_depth：2 inputs.HOST_SCOPE.max_depth
      • max_nodes：128 inputs.HOST_SCOPE.max_nodes
      • mode：READ_ONLY inputs.HOST_SCOPE.mode
      • platform：MACOS inputs.HOST_SCOPE.platform
      • 是否必需：是 inputs.HOST_SCOPE.required
      • root：FOCUSED_APPLICATION inputs.HOST_SCOPE.root
      • 来源：TCS_PROTOCOL inputs.HOST_SCOPE.source
      • trust_prompt：否 inputs.HOST_SCOPE.trust_prompt
      • type：HostObjectTreeObservation inputs.HOST_SCOPE.type
  • 输出 outputs
    • OBJECT_TREE_OR_DENIAL outputs.OBJECT_TREE_OR_DENIAL
      • destination：TARGET_STATE outputs.OBJECT_TREE_OR_DENIAL.destination
      • integrity：SHA-256 完整性校验（SHA256） outputs.OBJECT_TREE_OR_DENIAL.integrity
      • type：Record outputs.OBJECT_TREE_OR_DENIAL.type
    • OBSERVATION_RECEIPT outputs.OBSERVATION_RECEIPT
      • destination：回执（RECEIPT） outputs.OBSERVATION_RECEIPT.destination
      • integrity：SHA-256 完整性校验（SHA256） outputs.OBSERVATION_RECEIPT.integrity
      • type：Record outputs.OBSERVATION_RECEIPT.type
  • 回执 receipt
    • 人类可读投影：必须生成（REQUIRED） receipt.human_projection
    • integrity：SHA-256 完整性校验（SHA256） receipt.integrity
    • machine_path：./state/shared-desktop/macos-observation/MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001.hldp receipt.machine_path
    • 协议：TCS-HOST-OBJECT-TREE-OBSERVATION-RECEIPT-v1 receipt.protocol
    • target_readback：OBSERVED_TREE_HASH_OR_EXPLICIT_PERMISSION_DENIAL receipt.target_readback
  • 资源边界 resources
    • concurrency：1 resources.concurrency
    • 内存上限字节：67108864 resources.memory_limit_bytes
    • runway：LOCAL_TCS_GIR_RUNTIME_STAGE12_CANDIDATE resources.runway
    • 超时毫秒：5000 resources.timeout_ms
  • 回滚方案 rollback
    • 动作 rollback.actions
      • REMOVE_ONLY_STAGE12_TEMPORARY_OBSERVATION
    • preconditions rollback.preconditions
      • PARTIAL_OBSERVATION_WITHOUT_READBACK
    • verification rollback.verification
      • NO_MACOS_ACTION
      • NO_PERMISSION_PROMPT
      • NO_NETWORK
      • NO_OTHER_FILE_CHANGED
  • 来源 source
    • 来源编号：BINGSHUO-HOLOLAKE-TCS-ENGINEERING-ANCHOR-20260823 source.source_id
    • 来源角色：人类直接语言来源（DIRECT_HUMAN） source.source_role
    • 来源校验值：a3dd8dbd2203b631bdb23f2693eb314d4ef86af68fdeaee8835e3cf0861ddd23 source.source_sha256
    • 来源地址：language-sources/direct-human/BINGSHUO-HOLOLAKE-TCS-ENGINEERING-ANCHOR-20260823.txt source.source_uri
  • 停止条件 stop
    • safe_checkpoint：WRITE_ONLY_EXPLICIT_OBSERVATION_OR_DENIAL_RECEIPT stop.safe_checkpoint
    • signals stop.signals
      • 调用方要求停止（CALLER_STOP）
      • 执行超时（TIMEOUT）
      • ACCESSIBILITY_PERMISSION_NOT_GRANTED
      • NO_FOCUSED_APPLICATION
      • NODE_LIMIT_REACHED
  • 执行主体 subject
    • channel_id：ICE-CH-ZC001 subject.channel_id
    • subject_id：TCS-HOST-OBJECT-OBSERVER-MACOS-0001 subject.subject_id
    • subject_kind：RUNTIME_INSTANCE subject.subject_kind
    • verification：LOCAL_STAGE12_READ_ONLY_CANDIDATE subject.verification
  • 目标 target
    • 精确路径：./state/shared-desktop/macos-observation/MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001.hldp target.exact_path
    • 预期指纹：NO_PRIOR_OBSERVATION_RECEIPT target.expected_fingerprint
    • 预期状态：当前不存在（ABSENT） target.expected_state
    • target_id：MACOS-FOCUSED-APPLICATION-OBJECT-TREE-OBSERVATION-0001 target.target_id

本页只改变阅读顺序，不改变 TCS/HLDP 语义。