行配置在 cordis.patch.yml（启动默认值），运行时覆盖在 ~/.dsh/local-kb/settings.json（面板写入，热生效）。

键	默认	说明
`roots`	`[]`	索引根目录，数组，可多个；为空时同步会提示"尚未配置索引根目录"
`autoSync`	`'off'`	`'off'` 纯手动；`'watch'` 文件变化即增量同步（事件驱动，仍无定时器）
`stalenessHint`	`true`	打开面板/查状态时做一次 stat 体检，只报"有多少文件变了"，不动库
`explicitOnly`	`true`	未点名不许检索
`pathTriggers`	`true`	消息里出现库内文件名/目录名也算点名
`triggers`	知识库 / 资料库 / 公司资料 / 公司知识库 / `/kb` …	点名触发词，可改
`include` / `excludeDirs` / `excludeGlobs`	常见文本与 Office 格式	决定抽取范围（不匹配的文件只登记元数据）
`maxFileBytes`	256MB	本地解析保险丝；PDF/图片走 OCR 不受它限制
`legacyDoc`	`'word-com'`	旧版 `.doc/.xls` 用本机 Word 取正文；设 `'skip'` 则只按文件名检索
`trigram`	`true`	子串索引（更全，占用更大）
`chunkChars` / `chunkOverlap`	900 / 150	分块大小与重叠
`topK` / `maxChunksPerDoc`	8 / 3	返回条数与单文件最大块数
`ocrWidth` / `maxOcrPagesPerFile`	1600 / 60	OCR 渲染宽度与单文件页数上限
`ocrEmbeddedImages`	`true`	识别文档内嵌图片里的文字（架构图/截图也能搜到）
`embeddedImageMinBytes`	20KB	小于这个体积的图按 logo/图标跳过
`maxEmbeddedImagesPerFile`	40	单文件最多识别多少张内嵌图
`exposeWeb` / `webPath`	`true` / `/company-kb-api`	面板 API 开关与路径

dsh-company-kb

安裝