Skip to content

v0.3.2 — 文件导入与记忆上下文增强

Choose a tag to compare

@Shardkiht Shardkiht released this 29 Oct 02:11

新增与改进

  • 文件分析与记忆导入:粘贴或拖入文件绝对路径,再用自然语言要求总结或导入记忆,Agent 可自行调用 read_file / import_file。也可使用 /import <路径> 预览、/import <路径> --apply 写入,CLI qm import 同步扩展。
  • 多格式兼容:文本、Markdown、JSON/JSONL、CSV/TSV、YAML/XML;可选 documents extra 通过本地 MarkItDown 解析 PDF 文字层、DOCX、XLS/XLSX、PPTX、HTML、EPUB、Outlook MSG 与 IPYNB。
  • 事实上下文:抽取与存储可保留事件日期、生效区间、时间原话、地点类型和明确表达的情绪;兼容旧 Markdown,不需要迁移。
  • 独立推断基础:假设单独保存,证据仅接受有效事实 ID,重复证据不增加可信度;不进入事实检索。
  • Spark MaaS:新增供应商预设、配置向导和参数适配。
  • 模型选择更清晰:/model 只列模型;Ctrl+P 打开独立供应商管理,Ctrl+R 刷新,Ctrl+N 输入自定义模型名,管理菜单按 Esc 返回。长列表独立滚动,小窗口保留快捷键提示。
  • 恢复 Markdown 回复的选择复制,修复极小 token 预算下截断超限和无效 Unicode,减少恢复会话时的通知干扰。

升级

uv tool upgrade quiet-memo
# 需要办公文档/PDF 解析时:
uv tool install --force 'quiet-memo[documents]==0.3.2'

若原来使用 local-embed,重装时保留该 extra:quiet-memo[local-embed,documents]==0.3.2。源码开发环境用 uv sync --extra documents。

使用边界

  • 文件仅对本轮用户明确提供的路径开放;单文件上限 20 MiB。目录导入只扫描当前层。
  • 默认预览不写记忆,但仍调用配置的模型并可能收费。正式导入重新分析;部分写入不回滚。大文件受工具步数限制,未完成时需按游标接续。
  • 没有 OCR、音视频转写、旧 DOC/PPT 或压缩包解析;扫描件需先转文字。没有新增通用外部 MCP 接入或对外文件 MCP 工具。
  • 上下文目前用于抽取和存储,尚未实现多维召回;独立推断尚无用户确认/拒绝与来源失效流程。Dreaming、动态画像继续按 Issues 规划。

验证

完整隔离测试覆盖 Agent、记忆、检索、CLI/TUI、配置、MCP 与搜索。文件功能另以合成数据完成两轮共 10 次 Spark 真实请求,覆盖工具接线、自然语言自动选工具,以及助手建议不作为用户事实写入。

English

This release adds local document analysis and memory import, optional MarkItDown-based Office/PDF conversion, contextual memory metadata, isolated inference foundations, Spark MaaS support, and a cleaner model picker with separate provider management. File access is scoped to paths explicitly supplied in the current message. Dry-run still uses the configured model; scans require external OCR. Temporal retrieval, inference review/invalidation, Dreaming, and dynamic profiles remain planned.