Repository navigation
v0.3.2 — 文件导入与记忆上下文增强
新增与改进
- 文件分析与记忆导入:粘贴或拖入文件绝对路径,再用自然语言要求总结或导入记忆,Agent 可自行调用
read_file/import_file。也可使用/import <路径>预览、/import <路径> --apply写入,CLIqm import同步扩展。 - 多格式兼容:文本、Markdown、JSON/JSONL、CSV/TSV、YAML/XML;可选
documentsextra 通过本地 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.