92 lines
5 KiB
Markdown
92 lines
5 KiB
Markdown
|
# 知识库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 语义。
|