### 3.1 插件简介与定位**opencode-personal-knowledge** 是面向 OpenCode 生态的个人知识 MCP 服务器使用向量数据库进行语义搜索的知识存储和检索系统。它完全本地运行无需任何外部 API 密钥。**核心定位**打造个人专属的语义知识库实现知识的结构化管理和智能检索。### 3.2 核心功能特点| 功能 | 说明 ||------|------|| 语义搜索 | 使用 BGE-small-en-v1.5 向量嵌入进行知识检索 || 文本搜索 | 基于关键词的搜索回退 || 标签组织 | 使用标签分类条目 || 即插即用 | 无需外部服务嵌入模型 100% 本地运行 || 持久化存储 | 数据存储在本地目录 || 自动索引 | 创建条目时自动向量化 || 会话记忆 | 跨会话日志和搜索 |### 3.3 与 opencode-mem 的区别| 维度 | opencode-personal-knowledge | opencode-mem ||------|------------------------------|--------------|| **协议架构** | MCPModel Context Protocol服务器 | OpenCode 插件 || **数据管理** | 结构化的知识条目管理 | 自动记忆提取 || **会话日志** | 支持完整的会话记录和回放 | 侧重用户画像 || **使用方式** | 主动存储和检索 | AI 自动分析学习 || **API 依赖** | 完全本地无需 API | 需要 AI API 进行分析 |简单来说- **opencode-mem** 是被动学习AI 自动从对话中提取记忆- **opencode-personal-knowledge** 是主动管理用户主动存储结构化知识### 3.4 安装与配置#### 标准安装在 ~/.config/opencode/opencode.jsonc 中添加 MCP 配置jsonc{mcp: {personal-knowledge: {type: local,command: [bunx, opencode-personal-knowledge],enabled: true}}}重启 OpenCode 即可使用。#### 源码安装开发用bashgit clone https://github.com/NocturnLabs/opencode-personal-knowledge.gitcd opencode-personal-knowledgebun installbun run mcp # 启动 MCP 服务器### 3.5 知识工具详解| 工具 | 说明 | 示例 ||------|------|------|| store_knowledge | 存储新知识条目支持可选标签 | 存储技术笔记、方案设计等 || search_knowledge | 语义相似度搜索 | 用自然语言描述查找相关知识 || search_knowledge_text | 基于关键词的文本搜索 | 精确关键词匹配 || get_knowledge | 按 ID 检索条目 | 获取特定条目的完整内容 || update_knowledge | 更新已有条目 | 修改或补充知识内容 || delete_knowledge | 删除条目 | 清理过时或错误的信息 || list_knowledge | 带筛选条件列出条目 | 按标签、日期等筛选 || get_knowledge_stats | 数据库统计信息 | 查看知识库规模 |### 3.6 会话记忆工具详解| 工具 | 说明 | 示例 ||------|------|------|| start_logging_session | 开始记录一个会话 | 为调试会话命名并记录 || log_message | 将用户/代理消息记录到会话 | 保留对话历史 || search_session | 在会话内进行语义搜索 | 在单个会话中查找信息 || search_all_sessions | 跨所有已记录会话搜索 | 全局会话内容搜索 || list_sessions | 列出所有会话 | 查看会话历史列表 || get_session | 获取会话详情和消息 | 回看某个会话的完整对话 || end_session | 结束会话可选摘要 | 结束记录并保存 |### 3.7 使用示例#### 存储知识用户: store a knowledge entry about Opencode Features代理: 研究并存储条目✅ Stored knowledge entry #2: Opencode Features Indexed for semantic search#### 语义搜索用户: search_knowledge for opencode代理: 返回语义匹配结果Found 1 similar entry:### 1. Opencode Features (85% similar)Opencode is an open source AI coding agent...#### 会话记忆用户: Start logging this session, call it auth debugging代理: ✅ Started session #1: auth debugging用户: Search this session for JWT代理: 返回会话内的语义匹配### 3.8 数据存储默认存储位置~/.local/share/opencode-personal-knowledge/├── knowledge.db # SQLite 数据库└── vectors/ # LanceDB 向量存储自定义存储路径bashexport OPENCODE_PK_DATA_DIR/custom/path### 3.9 技术栈| 组件 | 技术 ||------|------|| 运行时 | Bun / Node.js || 向量数据库 | LanceDB (嵌入式) || 嵌入模型 | FastEmbed (BGE-small-en-v1.5, ONNX Runtime) || MCP SDK | modelcontextprotocol/sdk || 数据库 | SQLite (via Bun) |### 3.10 适用场景- 个人知识体系构建形成第二大脑- 技术方案文档化便于检索复用- 会议记录和决策追踪- 学习笔记的语义搜索- 会话历史回溯和复盘- 团队知识共享准备### 3.11 相关链接- **仓库地址**https://github.com/NocturnLabs/opencode-personal-knowledge- **版本**1.0.10- **许可证**MIT---