前言¶
在 DeepSeek Harness（DSH）里做逆向、排错或长期项目时，模型每次对话都是新上下文：上周讨论过的踩坑、整理过的笔记，往往要重新讲一遍。把笔记放在 Obsidian 或文件夹里，Harness 里的 AI 也不会自动「记得」那些文件。社区插件 万象知识库（Minglink/wanxiang-knowledge）面向同一套宿主：在本地用 Markdown 存正文、SQLite 与 FTS5 建索引，支持会话一键落库、/wanxiang 查询，以及可选的自动召回与知识图谱。下面介绍它是什么、能做什么，以及如何安装与使用。
这是什么¶
万象知识库是为 DeepSeek Harness 开发的社区插件，维护者为 Minglink，在 SkillHub 社区目录中归类为 记忆。当前版本为 0.2.0-alpha.10 预览版，源码采用 MIT 许可证；存储方式为本地 Markdown + SQLite，主要验证环境为 Windows + Harness Desktop 0.2.1-alpha.1。
插件在 Harness 内提供：会话落库、本地检索、可选自动召回、知识图谱、工具目录和文件夹学习。当前 AI 可通过 /wanxiang 查询已有知识，并按需读取摘要、正文与项目时间线，在不额外切换模型的前提下使用当前会话的权限与模型。
核心功能¶
会话落库与导入¶
回合结束后条目进入「待落库」，点击「生成到本地」才开始整理。可选 AI 整理或无需模型的原文导出；会话新增消息会生成独立增量记录，不覆盖旧笔记。长会话会按上下文大小自动分段，不设分段数量硬上限。
支持拖入或选择 Markdown、UTF-8 文本/源代码、文件夹、ZIP 或万象内容包；相同内容跳过，同 ID 不同内容可保留两份并映射引用。单批最多 2000 文件、64 MiB；单文档/附件最多 2 MiB。PDF、Word 和图片目前作为附件保留，不提取 PDF/Word 正文，也不提供 OCR。
命令查询与文件夹学习¶
在当前会话中把问题交给 AI，由插件提供的知识工具拉取资料：
/wanxiang 如何排查这个错误？
省略问题时，可结合当前会话问题查询。
学习当前会话绑定目录中的支持文档与源代码：
/wanxiang study
斜杠菜单也可选择 /wanxiang-study。整理模型在设置中选择；网络或模型失败时可继续，已完成文件的整理缓存会复用。普通文件导入直接保存内容，不调用模型。
记忆检索¶
检索以本地 node:sqlite + FTS5 为主，结合中文预分词、两字词、条目问法 questions[] 与本地别名表。没有嵌入模型依赖，当前向量检索为 Off。
| 模式或层级 | 适用场景 |
|---|---|
exact |
路径、错误码、卡片 ID 和原文片段 |
hybrid |
精确候选与 FTS 结果融合 |
deep |
扩展到正文，显示正文命中片段 |
| L0 → L1 → L2 | 先短摘要，再概览，最后按需读正文 |
模型侧工具包括 knowledge_search、knowledge_read、knowledge_timeline 和 tool_catalog_search。knowledge_read 每页最多 12,000 字符；返回 nextOffset 时用同一 ID 和偏移继续，直到 nextOffset=null。
自动召回提供 关闭 / 仅提示 / 自动注入 三档；自动注入须先确认知识摘要会发送给宿主模型。当前自动注入仍属实验能力，开发文档中明确不能仅用检索页 Recall@5 衡量自动注入质量。
知识图谱与工具目录¶
球体与网络两种布局展示知识节点，支持筛选、旋转、定位与导出 PNG；大图通过稳定快照分页加载，避免条目过多时缩成少数簇。工具目录按类别登记工具、环境检测状态与知识关联；可选安全分析扩展需额外安装，不随插件包捆绑全部工具。
默认知识目录为用户 Documents 下的「万象知识库」，可在设置中切换。插件设置保存于 <DSH_HOME>/wanxiang/settings.json。目录结构示意：
知识目录/
├─ notes/ 会话笔记
├─ cards/ 方法、踩坑与项目卡片
├─ sources/ 会话摘录与外部来源
├─ attachments/ 导入附件
├─ tools/ 工具目录与分析记录
└─ .wanxiang/ 索引、任务、修订、召回日志及别名配置
安装与启用¶
先从 GitHub Releases 下载 dsh-wanxiang-knowledge-0.2.0-alpha.10.tgz，在 Harness 的本地插件包安装入口选择该文件。升级前请等待宿主会话和后台任务结束，并备份知识目录。
普通 Web profile 可使用宿主插件管理命令，将路径替换为本机上的插件包绝对路径：
dsh plugin --profile web add "<插件包绝对路径>"
插件以当前 DSH 进程权限运行，会读写配置的本地知识目录并按用户操作调用宿主模型；安装前应阅读仓库源码与 MIT 许可证，确认权限声明（见 package.json 中 dsh.permissions）是否符合你的环境。
典型用法小结¶
- 留下讨论经验：选中会话，一键生成笔记、方法、踩坑和项目卡片；重复内容跳过。
- 让当前 AI 用旧知识：输入
/wanxiang加问题，或省略问题以结合当前会话。 - 学习项目资料：在绑定文件夹的会话发送
/wanxiang study，或菜单选择/wanxiang-study。 - 导入已有笔记：通过导入面板拖入 Markdown、文件夹、ZIP 等。
- 查看关系与活动：在图谱中定位节点并跳转正文；活动色表示知识被访问，不表示模型已采纳结论。
仓库 knowledge/ 提供可选逆向与安全相关的内容包（1182 条正文），不会在安装插件时自动写入个人库，需从「导入知识库」选择内容包或使用文档中的导入脚本。
适用场景与注意¶
适合需要在 Harness 内长期积累、检索会话与项目资料，并希望在同一宿主里用斜杠命令查询的用户。作者主要方向包括逆向工程，工具库与安全分析扩展面向相关场景，但分析扩展不是恶意样本沙箱，结论仍需结合来源核验。
当前边界（来自 README）：尚无向量检索、OCR、PDF/Word 正文解析、云同步或多用户协作；其他平台/宿主版本需进一步测试。百万条规模与应用全链路性能尚未完整验收。DSH 社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
万象知识库把「聊过的内容」和「已有的 Markdown」接到 Harness 的会话、命令与工具扩展点上，本地可读可备份，检索不依赖嵌入模型。若要试用或贡献，可访问 GitHub 仓库（当前约 27 stars）与上述 Releases 安装包；问题与 PR 见仓库 Issues。
