需为qoderwake注入结构化本地业务文档以构建岗位知识库，操作包括：一、准备符合格式（pdf/docx/txt/markdown/csv）、≤5mb、utf-8编码、无加密的文档；二、在qoder cn控制台创建绑定场景与权限的知识库；三、上传文档触发自动解析、切块、向量化与索引；四、在qoderwake中验证问答准确性；五、通过subspace为多岗位配置独立知识空间。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望为QoderWake配置具备岗位特性的语义理解与决策能力，则需为其注入经过结构化处理的本地业务文档。以下是利用本地文档构建专属岗位知识库的具体操作路径：
一、准备符合格式要求的本地文档集
QoderWake的知识库构建依赖于原始文档的可解析性与内容一致性。系统仅支持特定格式输入，以确保后续向量化与切块过程稳定可靠。所有文档必须满足格式、大小与编码三项硬性约束，否则将被拒绝入库。
1、确认待上传文档类型属于以下任一格式：PDF、DOCX、TXT、Markdown、CSV；
2、检查单个文件体积是否小于等于5 MB，超限文件需先行压缩或拆分；
3、验证文件编码是否为UTF-8，非UTF-8编码（如GBK、ISO-8859-1）会导致解析失败或乱码；
4、将全部文档整理至同一本地文件夹中，文件名长度不得超过200个字符，且不得含特殊符号（如\ / : * ? " |）；
5、确保文档内容不含加密保护、权限限制或扫描图像型PDF——纯文本可提取性是知识库生效的前提。
二、通过Qoder CN管理控制台创建岗位知识库
知识库需在Qoder CN企业版环境中创建，并绑定明确的应用场景与成员可见范围。控制台提供图形化界面完成初始化配置，所有设置均影响后续检索精度与权限控制粒度。
1、使用管理员账号登录Qoder CN管理控制台，点击左侧导航栏中的知识管理按钮；
2、在知识管理页面右上角点击新建知识库；
3、在弹窗表单中填写：应用场景选择智能问答，知识库名称建议体现岗位属性（例如“数字程序员-支付模块知识库”）；
4、在描述字段中简要说明该知识库覆盖的业务边界，例如“涵盖支付网关对接规范、异常码定义、幂等处理方案及历史故障复盘记录”；
5、设置可见范围为私有或指定成员组，避免未授权Agent误读敏感流程逻辑；
6、点击确定提交，等待页面提示“创建成功”后进入该知识库详情页。
三、上传本地文档并触发全托管处理流程
上传动作将触发Tablestore知识库服务的全托管RAG流水线，包括自动解析、语义切块、Embedding向量化与索引构建。整个过程无需人工干预，但需留意状态反馈以确认各环节完成。
1、在知识库详情页点击添加数据按钮；
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、切换数据类型为文档，将已准备好的本地文档拖入灰色上传区域，或点击后手动选取；
3、单次最多上传10个文件，若文档数量超限，请分批执行；
4、上传完成后，页面显示“处理中”，此时系统正进行OCR识别（针对含图PDF）、文本清洗与段落切分；
5、约1–3分钟后，状态变为“已就绪”，表示文档已完成向量化并写入索引，可立即用于QoderWake的上下文增强。
四、验证知识库在QoderWake中的实际调用效果
验证环节需在QoderWake运行环境中发起真实查询，观察其是否能准确召回本地文档中的岗位专属信息。此步骤直接反映知识库内容质量与语义对齐程度，不可跳过。
1、在QoderWake工作界面中，启用企业知识库问答功能开关（该功能仅在VS Code或JetBrains IDE插件中可用）；
2、输入一条典型岗位问题，例如：“当支付返回ERR_CODE_1027时，应优先检查哪三个配置项？”；
3、确认响应内容中是否引用了您上传文档中明确列出的配置项名称与检查顺序；
4、若结果未命中或出现泛化回答，返回知识库页面检查文档是否包含该问题对应原文段落；
5、对未覆盖场景，补充撰写针对性说明文档并重新上传，系统将自动增量更新索引。
五、配置Subspace实现多岗位知识隔离
当同一组织内需部署多个数字员工角色（如数字程序员、数字客户经理），必须通过Subspace机制划分独立数据空间，防止跨岗位知识混淆与权限越界。该配置在服务端强制生效，无法绕过。
1、在Qoder CN管理控制台的知识管理页，为每个岗位角色单独创建一个知识库；
2、创建时，在高级选项中启用Subspace隔离，并为每个知识库分配唯一子空间标识（如“engineer-pay”、“customer-service-level1”）；
3、为QoderWake实例绑定对应Subspace ID，确保其仅能访问指定空间内的文档向量；
4、验证不同岗位QoderWake实例在相同查询关键词下返回的结果是否完全独立且无交叉；
5、禁止将多个岗位文档混合上传至同一知识库，否则Subspace隔离将失效。
