knowledge-scaffold 知识包

问题不在"模型知道得不够多"

企业里智能体常犯的错有四类：误解术语、猜字段名、编规则、算错数。knowledge-scaffold 的思路不是让模型记住更多，而是把这四件事各交给最合适的执行层：

源码knowledge-scaffold READMEagent-solution/common/knowledge-scaffold/README.md@bf702bc9

知识包长什么样

<知识包>/
├── manifest.yaml          ID、名称、版本、语言、启用状态
├── index.md               总入口
├── objects/               业务对象、属性、别名、数据语义
├── operations/            业务流程、计算规则、工具路由
├── scripts/               确定性脚本及调用说明
└── mappings/
    └── object-data-mappings.json   对象属性 → 真实数据字段

套到本站的交期承诺案例上（示意，非仓库内容）：

• objects/ 定义"订单""物料""产线"及它们的关系，"交货期""交期""承诺日期"登记为同一概念的别名
• operations/ 写"交期承诺"的步骤：查库存 → 查产能 → 计算 → 需要时请经理授权
• scripts/ 放交期计算脚本：输入数量、库存、日产能、运输天数，输出最早可承诺日期
• mappings/ 把"物料.可用库存"映射到库存系统的实际字段

这样模型负责理解和规划，数字由脚本算，字段由映射给，不靠猜。

脚本在哪里跑

知识包脚本通过 execute_script 工具执行。默认在本地运行；显式启用后，优先提交给独立的 JiuwenBox 容器，它用只读挂载、策略文件和容器隔离限制脚本权限，不支持时会审计后回落本地。

版本：会话锁定

导入后，同一知识包的多个版本并存在工作空间里，由 manifest.yaml 记录当前激活版本：

• 明确选择知识包创建的会话，锁定创建时的版本
• 切换激活版本只影响新会话
• 被会话引用的版本不能直接删除

业务数据连接按"工作空间 + 知识包"配置，各版本共享。版本锁定的是知识语义，不复制业务数据。

平台的其他部分

推理过程通过 SSE 输出回答、思考摘要、工具进度和最终状态，对话右侧能看到每次知识读取、数据查询和脚本执行。知识包的建模工具在另一个独立仓库，不在本模块里。

小结

• 知识包 = 对象 + 操作 + 脚本 + 数据映射，把术语、字段、规则、计算从模型手里拿出来。
• 数值计算交给确定性脚本，可放进 JiuwenBox 沙箱执行。
• 会话锁定知识版本，数据连接按知识包共享。