核心用法
马基雅维利图书馆是一个专注原文检索的学术工具，用户通过自然语言或精确指令查询马基雅维利著作及相关研究资料。触发方式包括 /machia-lib 前缀或「马基雅维利原文」等关键词。系统支持中英文双语查询，自动提取关键词后在预建索引 index/themes.md 中查找，若无结果则遍历 library/ 目录全文搜索，最终返回 3-5 个最相关的原文段落，每条结果均标注著作名、章节/书信编号及完整原文。对于不确定的检索，可调用 python3 scripts/search.py 执行本地 grep 精确匹配。
显著优点
学术严谨性：严格区分「图书馆」与「分身」两种模式，前者只返回原文不分析，避免 AI 生成内容与历史文献混淆，保障学术引用的可信度。双语覆盖：收录《君主论》《论李维》《佛罗伦萨史》《兵法》等核心著作的中英双语版本，以及书信集、政务著作、盐野七生等传记与研究资料，满足 comparative reading 需求。完全本地化：纯本地文件检索，无网络 API 调用，数据不出境，符合学术机构数据安全要求。公版合规：所有文献来源均为公有领域，无法律风险。
潜在缺点与局限性
数据依赖前置：首次使用需手动 git clone 下载原文库，library/ 目录不含于技能包内，离线环境或网络受限场景存在配置门槛。检索深度有限：依赖关键词匹配与简单索引，不支持语义级主题聚类或跨著作概念关联分析，复杂研究问题需人工二次整合。T3 来源风险：代码引用的 GitHub 仓库属个人开发者账号，项目维护连续性、长期更新稳定性存在不确定性，建议用户 fork 自建版本。无动态更新：公版文献虽固定，但学术研究新译、新编索引不会自动同步。
适合的目标群体
人文社科研究者、政治学/哲学专业学生、文艺复兴史爱好者、需要准确引证马基雅维利原文的论文写作者、对比阅读中意英多语种文献的学术译者，以及对 AI 分析保持警惕、更信任一手史料的历史求真者。
常规使用风险
性能风险：全文检索依赖本地 grep，大型文献库（预计数百万字）的响应速度随数据量线性下降，复杂查询可能出现秒级延迟。依赖项风险：subprocess.run 调用系统 grep，Windows 环境需确保 Git Bash/WSL 可用，纯 cmd 环境存在兼容性隐患。数据完整性风险：用户自行下载的原文库若版本与索引不匹配，可能导致检索结果偏移或标注错误。维护断层风险：个人开发者项目存在弃更可能，建议关键用户锁定认证版本并建立内部镜像。