接入参考与维护工具
本套件提供新工程初始化、已有项目的接入参考、可复制运行的离线代码和资料维护工具。
接入代码参考
整体流程与调用时序见工作机制图解，其中知识回答图是 App 对局部 Kit 合同的组合示意。
| 参考 | 可用于已有项目的内容 |
|---|---|
| 离线完整服务问答 | TS／JS 同一合同，从单节点到工具、模型和过程监听；无需凭据 |
| 基础模型与工具调用 | 具名调用、静态工具清单、真实授权与执行、Provider 流边界 |
| Core API | 执行器、模型、工具及取消／预算合同 |
| Support Context | 将现有资料和画像装配为模型输入 |
| Knowledge API | 文本解析、章节读取与快照 |
| 知识回答合同 | 根据局部 Kit 接口连接读取、生成、检查与输出 |
以上是模块调用参考，不会创建项目目录、安装依赖或启动应用。实际副作用仍由现有项目的端口承担。
维护工具
以下路径相对于已安装包的 development/。脚本需要 Node 22+ 及可解析的 Core 产物。
| 入口 | 输入 | 输出与副作用 |
|---|---|---|
skills/agent-core-app/scripts/validate-knowledge.mjs PROJECT | 已有项目资料清单、源稿和必需读取引用 | 检查结果；不改文件 |
skills/agent-core-app/scripts/prepare-source.mjs PROJECT --source UTF8_FILE --id DOCUMENT_ID | 已有项目、明确提供的来源和稳定文档 id | 待审来源与 proposal；不覆盖生效资料和配置 |
skills/agent-core-app/scripts/plan.mjs PROJECT [--source UTF8_FILE] | 已有项目、可选来源路径 | Agent 开发计划；具体行为见 Skill |
skills/agent-core-app/scripts/create-app.mjs TARGET [--write] | 空目录目标、名称和用途，可选真实来源 | 默认只读计划；显式创建 TypeScript／Node 工程与未发布来源候选 |
skills/agent-core-app/scripts/create-app.mjs TARGET --check | 生成回执、当前受管文件与所选模板 | 只读差异报告；不覆盖用户修改 |
资料维护工具按项目显式提供的配置工作，不扫描或执行项目代码。初始化及差异检查见创建应用。资料格式、流程及发布责任见 维护指南。失败以非零退出码和错误报告；无效 UTF-8、预算或章节错误不能靠放宽校验绕过。
工具不会代替文档审核、资源授权、数据库写回或发布，也不默认承担 PDF/OCR、网页采集和任意材料摄取。