# 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 语义。