13 KiB
13 KiB
HoloLake人类与人格体共享桌面框架行为协议 · 简体中文人类工程语言版
这是 TCS/HLDP 原生源码的简体中文阅读投影，不是新的正本，也不授予执行权限。若本页与
.tcs源码不一致，以经过校验的.tcs源码为准。
这是什么
这是一份 协议 声明，编号为 TCS-HOLOLAKE-SHARED-DESKTOP-FRAMEWORK-BEHAVIOR-0001，版本为 0.2.0。转换器已先用 Stage-1 编译器校验原生源码，再把机器枚举翻译成汉语；原始编号保留在括号和字段路径中。
谁在这里
源程序没有提供这一项，转换器不猜。
为什么开始
- 来源
source- checksum_manifest_sha256：a630d1d40c5308530b67c46846e6d1215a6eab857eea760c98dc2e7333875386
source.checksum_manifest_sha256 - git_fsck_passed：12
source.git_fsck_passed - manifest_sha256：51a9bfaabb720d7948e69884727acaa218a7f28a476903282e9b228ee47962da
source.manifest_sha256 - manifest_uri：/Volumes/JZAO/HoloLake/upstream-research/tcs-dual-native-desktop-20260822/manifest.json
source.manifest_uri - readme_sha256：3b80af1e464ea1d12209591f864a976e48df3c1dd9ee857dbdf1d390220f9969
source.readme_sha256 - repository_count：12
source.repository_count - research_id：HLP-UPSTREAM-AI-NATIVE-DUAL-DESKTOP-20260822
source.research_id - route
source.route- GITHUB
- BS-SG-003
- JZAO
- checksum_manifest_sha256：a630d1d40c5308530b67c46846e6d1215a6eab857eea760c98dc2e7333875386
发生了什么变化
源程序没有提供这一项，转换器不猜。
准备怎样执行
这是非执行声明，没有动作图。
边界与异常处理
- 失败处理
failure- ambiguous_object：TCS-DESKTOP-E4102
failure.ambiguous_object - effect_mismatch：TCS-DESKTOP-E5101
failure.effect_mismatch - natural_language_operation_guess：否
failure.natural_language_operation_guess - permission_denied：TCS-E4002
failure.permission_denied - shell_fallback：否
failure.shell_fallback - stale_reference：TCS-DESKTOP-E4101
failure.stale_reference - unsupported_action：TCS-E2101
failure.unsupported_action - verifier_unavailable：TCS-DESKTOP-E5102
failure.verifier_unavailable
- ambiguous_object：TCS-DESKTOP-E4102
怎样算完成
源程序没有提供这一项，转换器不猜。
下一次从哪里继续
源程序没有提供这一项，转换器不猜。
来源与校验
- 原生声明编号：
TCS-HOLOLAKE-SHARED-DESKTOP-FRAMEWORK-BEHAVIOR-0001 - 原生声明类型：
PROTOCOL - TCS 源码 SHA-256：
844986959e6fe2979dc54c98b3406860b4600f0091bda45ce76178fcf243148c - 校验编译器：
TCS-COMPILER-STAGE6-HOST-OBJECT-OBSERVATION-0001 - 投影协议：
GLS-HLDP-HUMAN-ENGINEERING-PROJECTION-0001
原生结构逐项对照
下面保留源码的全部顶层结构和字段路径，供人类审计投影有没有漏掉信息。
- action_cycle
action_cycle- action_dispatch_success_is_effect_proof：否
action_cycle.action_dispatch_success_is_effect_proof - action_semantics：REGISTERED_TCS_OPERATION
action_cycle.action_semantics - action_target：STABLE_OBJECT_ID
action_cycle.action_target - independent_target_readback_required：是
action_cycle.independent_target_readback_required - ordered_states
action_cycle.ordered_states- OBSERVE
- RESOLVE_UNIQUE_OBJECT
- AUTHORIZE_EXACT_ACTION
- EXECUTE
- REOBSERVE
- READ_STATE_DIFF
- VERIFY_DECLARED_EFFECT
- ISSUE_RECEIPT
- process_exit_is_effect_proof：否
action_cycle.process_exit_is_effect_proof
- action_dispatch_success_is_effect_proof：否
- adapter_contract
adapter_contract- adapter_may_define_product_semantics：否
adapter_contract.adapter_may_define_product_semantics - adapter_may_infer_authority：否
adapter_contract.adapter_may_infer_authority - adapter_may_translate_machine_calls：是
adapter_contract.adapter_may_translate_machine_calls - candidate_behavior_sources
adapter_contract.candidate_behavior_sources- AGENT_DESKTOP
- ACCESSKIT
- TOUCHPOINT
- OPENADAPT
- fallback_requires_new_permission：是
adapter_contract.fallback_requires_new_permission - first_host：MACOS
adapter_contract.first_host - macos_primary_observation：ACCESSIBILITY_OBJECT_TREE
adapter_contract.macos_primary_observation - native_semantic_action_first：是
adapter_contract.native_semantic_action_first - screenshot_ocr_coordinate_fallback：EXPLICITLY_DECLARED_FALLBACK_ONLY
adapter_contract.screenshot_ocr_coordinate_fallback
- adapter_may_define_product_semantics：否
- canonical_object
canonical_object- identity_scope：ONE_OBSERVATION_SESSION_AND_ONE_HOST_ADAPTER
canonical_object.identity_scope - pixel_coordinate_is_identity：否
canonical_object.pixel_coordinate_is_identity - required_fields
canonical_object.required_fields- object_id
- tree_id
- generation
- role
- name
- states
- supported_actions
- parent_id
- child_ids
- tree_hash
- screenshot_is_identity：否
canonical_object.screenshot_is_identity - tree_update：INCREMENT_GENERATION_AND_RECOMPUTE_TREE_HASH
canonical_object.tree_update
- identity_scope：ONE_OBSERVATION_SESSION_AND_ONE_HOST_ADAPTER
- current_readback
current_readback- behavior_contract_compiled：是
current_readback.behavior_contract_compiled - completion_claim：否
current_readback.completion_claim - desktop_v3_module_installed_mounted_active：是
current_readback.desktop_v3_module_installed_mounted_active - next：RESOLVE_ONE_STABLE_OBJECT_WITHOUT_ACTION
current_readback.next - real_macos_action_executed：否
current_readback.real_macos_action_executed - real_macos_observation_implemented：是
current_readback.real_macos_observation_implemented - real_macos_observation_receipt_sha256：4e64a5065e038a3711ed6001a60dfe87c5dc8e12db0f36d4d919dbbff4fc82ec
current_readback.real_macos_observation_receipt_sha256 - real_macos_observed_nodes：18
current_readback.real_macos_observed_nodes - real_macos_tree_sha256：c7500fa83fe693c0148b95600f2b01f7018824e3055d46f7c022641f1d145dca
current_readback.real_macos_tree_sha256 - tcs_source_created：是
current_readback.tcs_source_created - title_plaintext_persisted：否
current_readback.title_plaintext_persisted - upstream_sources_unchanged：是
current_readback.upstream_sources_unchanged - virtual_desktop_executed：是
current_readback.virtual_desktop_executed - virtual_desktop_target_sha256：9ac0849412509b876a4b194a22ab91246c96639526df823a904119d955ef1e08
current_readback.virtual_desktop_target_sha256
- behavior_contract_compiled：是
- decision
decision- hololake_framework：TCS_OBJECT_ACTION_PERMISSION_STATE_DIFF_RECEIPT_PROTOCOL
decision.hololake_framework - selected_single_upstream_framework：否
decision.selected_single_upstream_framework - upstream_authority_inherited：否
decision.upstream_authority_inherited - upstream_name_or_agent_identity_inherited：否
decision.upstream_name_or_agent_identity_inherited - upstream_product_source_imported：否
decision.upstream_product_source_imported - upstream_role：FROZEN_BEHAVIOR_AND_ADAPTER_EVIDENCE_ONLY
decision.upstream_role
- hololake_framework：TCS_OBJECT_ACTION_PERMISSION_STATE_DIFF_RECEIPT_PROTOCOL
- 失败处理
failure- ambiguous_object：TCS-DESKTOP-E4102
failure.ambiguous_object - effect_mismatch：TCS-DESKTOP-E5101
failure.effect_mismatch - natural_language_operation_guess：否
failure.natural_language_operation_guess - permission_denied：TCS-E4002
failure.permission_denied - shell_fallback：否
failure.shell_fallback - stale_reference：TCS-DESKTOP-E4101
failure.stale_reference - unsupported_action：TCS-E2101
failure.unsupported_action - verifier_unavailable：TCS-DESKTOP-E5102
failure.verifier_unavailable
- ambiguous_object：TCS-DESKTOP-E4102
- 语言头
header- 正本路径：language/protocols/TCS-HOLOLAKE-SHARED-DESKTOP-FRAMEWORK-BEHAVIOR-0001.tcs
header.canonical_uri - compatibility
header.compatibility- TCS-COMPILER-STAGE6-HOST-OBJECT-OBSERVATION-0001
- GIR/1
- 语言：TCS/0.1
header.language - 生命周期：ACTIVE_READ_ONLY_OBSERVATION
header.lifecycle - 英文名：HoloLake Human and Persona Shared Desktop Framework Behavior Protocol
header.name_en - 中文名：HoloLake人类与人格体共享桌面框架行为协议
header.name_zh - 协议配置：HLDP-HUMAN-ENGINEERING/0.1
header.profile - protocols
header.protocols- TCS-HOLOLAKE-SHARED-DESKTOP-OBJECT-ACTION-0001
- TCS-HOST-STRUCTURED-OBJECT-TREE-OBSERVATION-0001
- TCS-HOST-ABI-0001
- TCS-MODULE-ABI-0001
- schema：tcs.protocol/v1
header.schema - 版本：0.2.0
header.version
- 正本路径：language/protocols/TCS-HOLOLAKE-SHARED-DESKTOP-FRAMEWORK-BEHAVIOR-0001.tcs
- permission_contract
permission_contract- channel_change：HALT
permission_contract.channel_change - human_and_persona_collision：EXPLICIT_ARBITRATION_NO_SILENT_OVERWRITE
permission_contract.human_and_persona_collision - missing_permission：HALT
permission_contract.missing_permission - target_change：HALT
permission_contract.target_change - ticket_binds
permission_contract.ticket_binds- subject
- host
- channel
- session
- snapshot_id
- object_id
- action
- target
- expiry
- ticket_reuse：否
permission_contract.ticket_reuse
- channel_change：HALT
- reference_contract
reference_contract- ambiguous_resolution：HALT_NO_ACTION
reference_contract.ambiguous_resolution - cross_session_reference_reuse：否
reference_contract.cross_session_reference_reuse - missing_object：HALT_AND_REOBSERVE
reference_contract.missing_object - reference_resolves_to_exact_object_id：是
reference_contract.reference_resolves_to_exact_object_id - scoped_reference_required：是
reference_contract.scoped_reference_required - snapshot_id_required：是
reference_contract.snapshot_id_required - stale_generation：HALT_AND_REOBSERVE
reference_contract.stale_generation
- ambiguous_resolution：HALT_NO_ACTION
- 来源
source- checksum_manifest_sha256：a630d1d40c5308530b67c46846e6d1215a6eab857eea760c98dc2e7333875386
source.checksum_manifest_sha256 - git_fsck_passed：12
source.git_fsck_passed - manifest_sha256：51a9bfaabb720d7948e69884727acaa218a7f28a476903282e9b228ee47962da
source.manifest_sha256 - manifest_uri：/Volumes/JZAO/HoloLake/upstream-research/tcs-dual-native-desktop-20260822/manifest.json
source.manifest_uri - readme_sha256：3b80af1e464ea1d12209591f864a976e48df3c1dd9ee857dbdf1d390220f9969
source.readme_sha256 - repository_count：12
source.repository_count - research_id：HLP-UPSTREAM-AI-NATIVE-DUAL-DESKTOP-20260822
source.research_id - route
source.route- GITHUB
- BS-SG-003
- JZAO
- checksum_manifest_sha256：a630d1d40c5308530b67c46846e6d1215a6eab857eea760c98dc2e7333875386
- upstream_heads
upstream_heads- accesskit：00aee8edd49ff613e37c0deaf93098b9cb37609c|Apache-2.0_OR_MIT|STRUCTURED_TREE_SCHEMA_REFERENCE
upstream_heads.accesskit - agent_desktop：ab7606185463e8ac0197c952e23df16ff2a00954|Apache-2.0|PRIMARY_REFERENCE
upstream_heads.agent_desktop - appium：147c0bcac34100875970ee4bd987d8d4d037f476|Apache-2.0|PROTOCOL_REFERENCE
upstream_heads.appium - at_spi2_core：234d2213ae4cb5c387050ce1afb8bf1c333f4af8|LGPL-2.1|RESEARCH_ONLY_LICENSE_REVIEW_REQUIRED
upstream_heads.at_spi2_core - flaui：fd7cc64ab01908a0ae4cc7d05e704caa34f98d16|MIT|WINDOWS_UIA_REFERENCE
upstream_heads.flaui - mcp：4e67bdc2f3403a8602f72025b28ac27fe7fd4e44|LICENSE_REVIEW_REQUIRED|PROTOCOL_REFERENCE
upstream_heads.mcp - nomifun_desktop：33cd05064e5a9bb0560d7815ded1aeffe00b9f61|Apache-2.0|CROSS_PLATFORM_REFERENCE
upstream_heads.nomifun_desktop - openadapt：f6d275807cc18557f57c989519be3327b90d7ac5|MIT|DETERMINISTIC_WORKFLOW_REFERENCE
upstream_heads.openadapt - playwright：9642f57665db582b12dcfa5d8022808f2402fa2a|Apache-2.0|PROTOCOL_ANALOGY_REFERENCE
upstream_heads.playwright - screenhand：dd81cb0e81afc8fa98dfdb6f017402b32b8ffc73|AGPL-3.0|RESEARCH_ONLY
upstream_heads.screenhand - touchpoint：f512227621c3e0f4e5675e4e7dbed7aaebdcc76b|MIT|PRIMARY_REFERENCE
upstream_heads.touchpoint - ufo：96983c73ed09e884a5f1d7ff8936c953b234b684|MIT|WINDOWS_REFERENCE
upstream_heads.ufo
- accesskit：00aee8edd49ff613e37c0deaf93098b9cb37609c|Apache-2.0_OR_MIT|STRUCTURED_TREE_SCHEMA_REFERENCE
- verification_contract
verification_contract- after_tree_hash_required：是
verification_contract.after_tree_hash_required - before_tree_hash_required：是
verification_contract.before_tree_hash_required - completed_unverified_is_accepted：否
verification_contract.completed_unverified_is_accepted - declared_effect_required：是
verification_contract.declared_effect_required - effect_verifier_separate_from_action_dispatch：是
verification_contract.effect_verifier_separate_from_action_dispatch - retry_after_uncertain_dispatch：否
verification_contract.retry_after_uncertain_dispatch - uncertain_effect：HALTED_UNVERIFIED
verification_contract.uncertain_effect - unchanged_when_change_required：HALTED_EFFECT_MISMATCH
verification_contract.unchanged_when_change_required
- after_tree_hash_required：是
本页只改变阅读顺序，不改变 TCS/HLDP 语义。