zhuyuan-ice-gl-zy001/ZCODE-DEV-20260827/zcode-zc001-kb-agent-build-20260827/TCS-PROTOCOL-KB-AGENT-RUNTIME-0001.human.en-US.md

92 lines
5.1 KiB
Markdown
Raw Normal View History

# KB Agent Execution Layer Runtime Protocol 0001 · Human Engineering Language (English)
> This is an English reading projection of validated native TCS/HLDP source. It is not a new canonical source and grants no execution authority.
## What this is
This is a **protocol** declaration with identifier `TCS-PROTOCOL-KB-AGENT-RUNTIME-0001` and version `0.1.0`. The projector validates it with the Stage-1 compiler before changing its reading order.
## Who is here
The native source does not provide this field; the projector does not guess.
## Why this started
The native source does not provide this field; the projector does not guess.
## What changed
The native source does not provide this field; the projector does not guess.
## How it will execute
This is a non-executable declaration and has no action graph.
## Boundaries and exception handling
The native source does not provide this field; the projector does not guess.
## How completion is proven
- **acceptance** `acceptance`
- **partial**:no `acceptance.partial`
- **required** `acceptance.required`
- STAGE1_COMPILED_GIR
- CLI_SELF_TEST_ALL_COMMANDS
- IMPORT_FORMATS_TESTED_MD_TXT_CSV_JSON
- API_TEST_REAL_HTTP
- DESKTOP_INSTALLED_AND_SEEN
## Where to continue next time
The native source does not provide this field; the projector does not guess.
## Source and verification
- **Native declaration identifier**: `TCS-PROTOCOL-KB-AGENT-RUNTIME-0001`
- **Native declaration kind**: `PROTOCOL`
- **TCS source SHA-256**: `0ebf14a89534890caef43e15de38aaac4d9234e1a25b99ba3a889851cb021ade`
- **Validation compiler**: `TCS-COMPILER-STAGE1-0001`
- **Projection protocol**: `GLS-HLDP-HUMAN-ENGINEERING-PROJECTION-0001`
## Complete native structure cross-reference
All top-level structures and field paths are retained below so a reader can audit whether the projection omitted information.
- **acceptance** `acceptance`
- **partial**:no `acceptance.partial`
- **required** `acceptance.required`
- STAGE1_COMPILED_GIR
- CLI_SELF_TEST_ALL_COMMANDS
- IMPORT_FORMATS_TESTED_MD_TXT_CSV_JSON
- API_TEST_REAL_HTTP
- DESKTOP_INSTALLED_AND_SEEN
- **architecture** `architecture`
- **donor_sources**:guada sub-agent流式回执与后台pending思想(逻辑重写);guada skills结构(内置技能清单化);grok dream整理报告思想(organize技能);donor代码零进入 `architecture.donor_sources`
- **execution_layer**:agent_runtime.rs:命令循环+操作注册+逐步回执+翻译器+导入解析(md/txt/csv/json实测)+Agent设置(0600权限落盘)+真实连接测试(GET /models如实返回HTTP状态);无LLM自由循环,自主性属人格体大脑 `architecture.execution_layer`
- **layering**:冰朔2026-08-27定:底层=Agent执行层(本协议);上层=知识库;与知识库平行=人类交互入口(AgentConsole,后续接模型API,设置含用户自填API) `architecture.layering`
- **tcs_rewrite_verdict**:TCS重写评估结论:语义层四类必须TCS化=①操作注册表(本协议operations)②循环与审批规则(DENY即停、无自主续跑)③权限与数据边界(admission逐操作声明)④回执格式(schema v1);Rust/TS仅为执行件不载语义 `architecture.tcs_rewrite_verdict`
- **boundaries** `boundaries`
- **api_key_discipline**:0600权限本地落盘,不外发除用户填写的baseURL `boundaries.api_key_discipline`
- **model_free_v1**:无模型确定性优先;模型API仅按用户自填设置做连接测试,不自动调用做决策 `boundaries.model_free_v1`
- **real_not_placeholder**:全部命令真实作用于git托管知识库;导入四格式与连接测试均须实测回执证明 `boundaries.real_not_placeholder`
- **translator**:知识库翻译器=结构化回执与外部文件→人类可读markdown入库(_agent报告命名),格式md直通/txt代码块/csv转表格/json美化 `boundaries.translator`
- **header** `header`
- **canonical source path**:ZCODE-DEV-20260827/zcode-zc001-kb-agent-build-20260827/TCS-PROTOCOL-KB-AGENT-RUNTIME-0001.tcs `header.canonical_uri`
- **compatibility** `header.compatibility`
- TCS-DECISION-PERSONAL-CHANNEL-STAGE-ONE-0001
- ZHUYUAN-AGENT-FRAMEWORK-0001
- TCS-PROTOCOL-ZHUYUAN-AGENT-FRAMEWORK-0001
- **language**:TCS/0.1 `header.language`
- **lifecycle**:CANDIDATE `header.lifecycle`
- **English name**:KB Agent Execution Layer Runtime Protocol 0001 `header.name_en`
- **Chinese name**:知识库Agent执行层运行时协议0001 `header.name_zh`
- **profile**:HLDP-HUMAN-ENGINEERING/0.1 `header.profile`
- **schema**:tcs.protocol/v1 `header.schema`
- **version**:0.1.0 `header.version`
- **operations** `operations`
- **registry**:KBAG-OP-001 help / 002 list / 003 search / 004 read / 005 write / 006 organize / 007 report / 008 import / 009 skills / 010 run;路由经numbered-ipc OP-0162..0165(execute/settings_get/settings_set/api_test)受SHELL-MANIFEST哈希门管辖 `operations.registry`
---
This page changes only the reading order; it does not change TCS/HLDP semantics.