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

92 lines
5 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.

# 知识库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 语义。