5 KiB
5 KiB
知识库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
- partial：否
下一次从哪里继续
源程序没有提供这一项，转换器不猜。
来源与校验
- 原生声明编号：
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
- partial：否
- 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
- donor_sources：guada sub-agent流式回执与后台pending思想（逻辑重写）；guada skills结构（内置技能清单化）；grok dream整理报告思想（organize技能）；donor代码零进入
- 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
- api_key_discipline：0600权限本地落盘，不外发除用户填写的baseURL
- 语言头
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
- 正本路径：ZCODE-DEV-20260827/zcode-zc001-kb-agent-build-20260827/TCS-PROTOCOL-KB-AGENT-RUNTIME-0001.tcs
- 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
- 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哈希门管辖
本页只改变阅读顺序，不改变 TCS/HLDP 语义。