前言¶
DeepSeek Harness (DSH) 的插件化架构支持在本地扩展各类检索能力。对于需要访问古籍文献（如《道藏》）但希望保持完全离线运行的开发者，dao-zang-skill 提供了一套完整的解决方案。它无需调用外部 Embedding API 或网络请求，直接在本地数据库中对《中华道藏》和《正统道藏》进行检索，并支持从源 Markdown 文件中提取带标记的原文。
插件概述¶
这是一个由 Godners-Code 维护的 DSH 插件，旨在解决本地化古籍文献检索与原文溯源的问题。它内置了文本与语义双引擎，能对 285,117 个文本块进行全量索引，并提供一键环境自检与工作区初始化功能。
核心能力¶
双引擎检索¶
- 文本引擎（默认）：基于 ChromaDB 实现全文本过滤，配合 TF/IDF 排序，零依赖，启动速度快。
- 语义引擎（可选）：本地运行 bge-m3 ONNX 模型，生成 1024 维余弦向量，与数据库向量维度保持一致，支持语义相似度检索。
原文定位与提取¶
使用 --original 参数，插件可定位到原始 .md 文件中的具体位置，返回带 ⟦...⟧ 标记的文本片段及行号，便于后续处理或人工校对。
文件过滤¶
通过 --source 参数，可限制搜索范围仅针对文件名包含特定关键词的文件，提高检索效率。
环境与部署¶
- 自检：提供
check_env.py --selftest命令，用于检查环境配置并执行烟雾测试。 - 一键工作区设置：
setup_workspace.py脚本可从 HuggingFace 下载数据集并离线重建本地 ChromaDB。
安装与启用¶
在终端中执行以下命令安装插件：
dsh plugin --profile web add dao-zang-skill
安装完成后，重启 dsh web。在聊天界面的输入框输入 / 并选择 dao-zang，或在对话中指令助手“use the dao-zang skill”即可激活。
数据准备¶
插件运行需要本地数据支持，工作区目录需包含 ChromaDB/（285,117 个文本块）和 Markdowns/（3,152 个文件）。
初始化工作区：
python assets/dao-zang/scripts/setup_workspace.py --dir <workspace>
适用场景与注意¶
- 离线场景：插件完全离线运行，适合内网环境或对数据隐私有高要求的场景。
- 环境要求：请确保运行环境满足
package.json中定义的依赖版本（如 Node.js >=20）。 - 数据规模：本地 ChromaDB 数据量较大（约 28 万文本块），首次初始化或重建索引需要一定的磁盘空间与时间。
总结¶
dao-zang-skill 为 DSH 用户提供了完整的本地化古籍检索能力，支持从关键词到语义的多种检索方式，并具备精确的原文溯源功能。更多详情与源码，请访问 GitHub。
