302 lines
15 KiB
Markdown
302 lines
15 KiB
Markdown
# 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 语义。
|