Skip to content

Releases: YYCCCHAOOO/MindCite

MindCite v0.3.0

Choose a tag to compare

@YYCCCHAOOO YYCCCHAOOO released this 06 May 09:22

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.jsontag_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

Choose a tag to compare

@YYCCCHAOOO YYCCCHAOOO released this 05 May 11:02

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.py passed
  • safety_scan.py passed
  • validate_data_contracts.py passed
  • migrate.py --dry-run passed
  • smoke_test.py passed

MindCite v0.1.0

Choose a tag to compare

@YYCCCHAOOO YYCCCHAOOO released this 05 May 10:27

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.py passed
  • python tools/safety_scan.py passed