刘天麒GitHub

PROJECT NOTES / CHILON RECALL

Chilon Recall

让自己的资料，变成可以被追问、比较与复习的本地知识库。

Chilon Recall 是 Chilon 产品线中专注于本地检索的独立项目：把文本资料转换为私有、 来源可追溯的知识库，再通过 stdio MCP 交给本地 AI 客户端使用。

最新开发分支 agent/dsh-harness-plugin 加入了 DeepSeek Harness bundle， 通过 @deepseek-ai/dsh-mcp-client bridge 复用同一套 MCP server，并补齐 npm/npx CLI 与隔离 Python engine 的运行入口。这里记录的是开发分支进展，不等同于main 已合并或 npm 已发布。

公开版本 v0.1.0 · 最新开发分支 agent/dsh-harness-plugin

OVERVIEW / 项目说明

先回答资料说了什么，再讨论还能推断什么。

Chilon Recall 将自己的 Markdown、TXT、RST 与 CSV 资料建立为本地知识库，回答问题时保留 相对来源路径、标题层级、近似行号和检索分数，让“答案来自哪里”可以继续被检查。

它同时服务直接检索和学习工作流：可以从笔记或报告找回论据，也可以基于课程资料做教材问答、 概念比较、章节总结与复习提纲。它与 Chilon Knowledge Work Harness 保持独立，前者负责本地检索， 后者负责更广泛的长期知识工作编排。

SYSTEM / 工作结构

检索、学习工作流和安全操作各自承担清楚的职责。

本地资料Markdown / TXT / RST / CSV
首版面向 UTF-8 文本资料，文档与索引保留在本机，适合把个人笔记、课程材料和研究资料放进同一套检索流程。
检索底座FAISS + JSON metadata
资料经过标题感知分块后建立本地 FAISS 索引，并保留相对来源路径、标题层级、近似行号与检索分数。
学习入口rag_query / textbook_qa / review_outline
除了直接找回论据，也提供教材问答、概念比较、章节总结与复习提纲等面向学习的结构化入口。
MCP host 与引擎Node.js CLI / Python engine
Node.js CLI 与 MCP host 提供 init、setup、doctor、mcp 入口，并负责配置、路径安全、备份和客户端工具；Python engine 负责分块、provider 调用、索引序列化与检索。
DeepSeek Harness 适配DSH bundle + stdio bridge
开发分支 agent/dsh-harness-plugin 通过 @deepseek-ai/dsh-mcp-client bridge 启动现有 CLI MCP server，使工具以 mcp__chilon-recall__* 名称暴露；不重复运行检索引擎，凭据继续通过环境变量传递。DSH 仍属于 developer preview。
可恢复操作preview → confirmation token → execute
建库、清理与恢复先生成预览，再用短期确认 token 执行；active index 的替换与备份都保留明确的操作边界。

PROGRESS / 公开进度

进度记录

每条内容保留日期

  1. 加入 DeepSeek Harness bundle（开发分支）

    在 agent/dsh-harness-plugin 分支加入 dsh/cordis.patch.yml，通过 @deepseek-ai/dsh-mcp-client bridge 复用现有 stdio MCP server；工具以 mcp__chilon-recall__* 名称暴露，不重复运行检索引擎，凭据继续通过环境变量传递。同时补齐 Node.js CLI 的 init / setup / doctor / mcp 入口与隔离 Python engine 管理。当前适配仍属于 developer preview，公开版本仍为 v0.1.0。

    查看对应提交

  2. 发布 v0.1.0 初始版本

    完成本地优先 MCP knowledge engine、来源可追溯检索、学习工作流、分阶段建库与可恢复备份，并加入 Codex plugin、Claude Desktop/Codex 配置指南和 npm/npx CLI。

    查看对应提交

  3. 补齐中文文档与双语 README

    让项目定位、快速开始、MCP 客户端配置、工作原理、工具边界、数据安全与已知限制都能在仓库中直接阅读。

    查看对应提交

STATUS / 当前状态

已完成与计划中

已完成

  • 来源可追溯的本地检索
  • 教材问答、概念比较、章节总结与复习提纲入口
  • 分阶段建库与可恢复 backup / restore
  • Codex plugin 与 stdio MCP 配置
  • Node.js CLI 与独立 Python engine
  • DeepSeek Harness bundle 适配（开发分支）

计划中

  • 基于内容哈希的增量索引
  • 带覆盖报告的 PDF 提取与 OCR adapter
  • 本地 embedding 与 reranking provider
  • 来源过滤与 collection namespace
  • 检索质量与引用覆盖评估样例
查看 GitHub 源码 返回个人主页