Releases: YYCCCHAOOO/MindCite
Releases · YYCCCHAOOO/MindCite
Release list
MindCite v0.3.0
MindCite v0.3.0
本次版本把分类方法升级为“标签体系审计”:用户主要判断标签是否应该存在,而不是逐篇审核每篇论文的分类归属。
新增
- 新增
discover_open_tag_candidates.py:从新版 notes 中发现尚未进入正式 taxonomy 的开放标签候选。 - 新增
prioritize_open_tag_candidates.py:生成可编辑的标签优先级审计表。 - 新增
apply_tag_taxonomy_decisions.py:支持a/p/m/r决策预览与显式--apply。 - 支持
a接受、p暂存、m合并、r丢弃到黑名单。 - 支持 parent/child/noise 角色判断,以及跨维度合并修正。
- README、分类指南、架构文档和 Codex 指令手册已加入 v0.3 用法。
安全边界
- 默认只做 preview,不修改 taxonomy。
--apply只修改classification_taxonomy.json和tag_taxonomy_discard_blacklist.json。- 不写回 Zotero,不批量修改 notes frontmatter。
- Zotero 写回仍然必须走 dry-run 和显式确认。
验证
structure_check.py通过。safety_scan.py通过。validate_data_contracts.py --demo-only通过。smoke_test.py通过,并覆盖 v0.3 demo 标签发现、优先级表和决策预览。- 临时 Vault 已测试
a/p/m/r四种决策和跨维度合并。
MindCite v0.2.0
MindCite v0.2.0
这是 MindCite 的安全底座增强版。这个版本不追求新增大量功能,而是为后续长期扩展建立更稳的数据保护层。
新增
schemas/:新增 Zotero index、reading status、note frontmatter、classification taxonomy、classification review queue 的数据契约。_skills/common/safe_io.py:新增原子写入、备份和 quarantine 工具。tools/validate_data_contracts.py:校验 demo 或真实 Vault 是否符合当前数据契约。tools/migrate.py:新增迁移入口,默认 dry-run,支持--apply写入并备份。tools/smoke_test.py:新增 demo-vault 回归测试。docs/extension-policy.md:新增 S0-S3 安全等级和新功能准入规则。
改进
- 核心输出开始写入
schema_version: 0.2.0。 - 索引、精读笔记、状态日志和健康检查报告改用原子写入。
- 重复精读笔记不再直接删除,改为移动到
logs/quarantine。 - demo-vault 示例数据升级到 v0.2.0 数据契约。
推荐验证
python tools/structure_check.py
python tools/safety_scan.py
python tools/validate_data_contracts.py
python tools/migrate.py --dry-run
python tools/smoke_test.py发布前验证结果
structure_check.pypassedsafety_scan.pypassedvalidate_data_contracts.pypassedmigrate.py --dry-runpassedsmoke_test.pypassed
MindCite v0.1.0
MindCite v0.1.0
这是 MindCite 的第一个公开模板版本,定位为面向 Zotero + Obsidian + Codex 用户的本地文献研究工作流。
这个版本包含
- 安全公开版目录结构,不包含真实论文、真实索引、Zotero 数据库、API key 或个人研究材料。
- 合成演示 Vault:
examples/demo-vault,可用于第一次试跑。 - Zotero 索引、精读 notes、notes 问答、分类治理、理论/方法综述等核心模块骨架。
- 通用配置层:支持 DeepSeek、OpenAI、Qwen、Zhipu、custom LLM,以及 SiliconFlow、OpenAI、custom embedding。
- README 首屏说明:项目主题、核心亮点、适合谁、不适合谁、5 分钟体验路径。
5 分钟体验
git clone https://github.com/YYCCCHAOOO/MindCite.git MindCite
cd MindCite
python -m pip install -r requirements.txt
python tools/structure_check.py
$env:MINDCITE_ROOT=(Resolve-Path .\examples\demo-vault)
python _skills/Zotero-Library-Sync/scripts/vault_health_check.py
python _skills/Classification-Governance-System/scripts/build_classification_review_queue.py --all
Remove-Item Env:\MINDCITE_ROOT发布前验证
python tools/structure_check.pypassedpython tools/safety_scan.pypassed