# 知识库Agent执行层运行时协议0001 · 简体中文人类工程语言版

> 这是 TCS/HLDP 原生源码的简体中文阅读投影，不是新的正本，也不授予执行权限。若本页与 `.tcs` 源码不一致，以经过校验的 `.tcs` 源码为准。

## 这是什么

这是一份 **协议** 声明，编号为 `TCS-PROTOCOL-KB-AGENT-RUNTIME-0001`，版本为 `0.1.0`。转换器已先用 Stage-1 编译器校验原生源码，再把机器枚举翻译成汉语；原始编号保留在括号和字段路径中。

## 谁在这里

源程序没有提供这一项，转换器不猜。

## 为什么开始

源程序没有提供这一项，转换器不猜。

## 发生了什么变化

源程序没有提供这一项，转换器不猜。

## 准备怎样执行

这是非执行声明，没有动作图。

## 边界与异常处理

源程序没有提供这一项，转换器不猜。

## 怎样算完成

- **验收标准**  `acceptance`
  - **partial**：否  `acceptance.partial`
  - **是否必需**  `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

## 下一次从哪里继续

源程序没有提供这一项，转换器不猜。

## 来源与校验

- **原生声明编号**：`TCS-PROTOCOL-KB-AGENT-RUNTIME-0001`
- **原生声明类型**：`PROTOCOL`
- **TCS 源码 SHA-256**：`0ebf14a89534890caef43e15de38aaac4d9234e1a25b99ba3a889851cb021ade`
- **校验编译器**：`TCS-COMPILER-STAGE1-0001`
- **投影协议**：`GLS-HLDP-HUMAN-ENGINEERING-PROJECTION-0001`

## 原生结构逐项对照

下面保留源码的全部顶层结构和字段路径，供人类审计投影有没有漏掉信息。

- **验收标准**  `acceptance`
  - **partial**：否  `acceptance.partial`
  - **是否必需**  `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`
  - **正本路径**：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
  - **语言**：TCS/0.1  `header.language`
  - **生命周期**：候选版本，尚未成为正式正本（`CANDIDATE`）  `header.lifecycle`
  - **英文名**：KB Agent Execution Layer Runtime Protocol 0001  `header.name_en`
  - **中文名**：知识库Agent执行层运行时协议0001  `header.name_zh`
  - **协议配置**：HLDP-HUMAN-ENGINEERING/0.1  `header.profile`
  - **schema**：tcs.protocol/v1  `header.schema`
  - **版本**：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`

---

本页只改变阅读顺序，不改变 TCS/HLDP 语义。