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 Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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.