Skip to content

Releases

v0.3.2 — 文献工作流四件套(Zotero 收尾归档 + 学习层互操作)

Choose a tag to compare

@ysl289 ysl289 released this 10 Nov 00:32

这套包是什么

给 DeepSeek Harness(DSH)用的文献工作插件集,四个插件各管一段:

包 一句话
literature-workflow 0.3.2 主流程:检索 → PDF→Markdown → 抽取 → Zotero → Excel → 制卡任务书 → 演示页 → 发布
knowledge-cards 0.2.0 卡片库:按「形态 × 书架」浏览、查重、编辑、导出,2D/3D 关系网
lit-learning 0.2.1 学习层:只读上游产物,生成复述、准备度评级、引用草稿、复习题、领域地图
plugin-hub 0.1.0 入口中心:把上面几个(及任何面板)的侧边栏图标收进一个启动台

怎么装(两种,任选)

A. 下载这个 release 的 zip(不用 git)

  1. 下载下面的 dsh-literature-suite-0.3.2.zip(2.3 MB,含四个插件包 + 技能 + 文档)。
  2. 解压到固定目录,例如 D:\dsh-literature-suite。
  3. 在 DSH 侧栏 → 插件 → 添加插件 粘贴四个目录的绝对路径,或命令行:
dsh plugin --profile <profile> add D:/dsh-literature-suite/packages/literature-workflow
dsh plugin --profile <profile> add D:/dsh-literature-suite/packages/knowledge-cards
dsh plugin --profile <profile> add D:/dsh-literature-suite/packages/lit-learning
dsh plugin --profile <profile> add D:/dsh-literature-suite/packages/plugin-hub    # 可选
  1. 重启 DSH。

B. 用单个 tgz

*.tgz 是 npm pack 的输出,可在 DSH 的「添加插件」里粘贴解压后的目录,或 dsh plugin add file:<绝对路径>.tgz。

Python 依赖不会自动安装:literature-workflow 需要 Python 3.10+ 与 openpyxl、requests、PyMuPDF(见 requirements.txt)。
路径默认读环境变量(DSH_LIT_WORKFLOW、DSH_CARDS_HOME/KCARD_HOME、DSH_LIT_LEARNING、DSH_PYTHON),不写死。

这次更新了什么

literature-workflow 0.3.2 —— 收尾归档到 Zotero

  • Zotero 落盘之后,已确认(按内容比对)复制到该论文 Zotero 文件夹的产物,会从任务目录删掉,job 里的路径改指向 Zotero;card_* / 制卡* 这类卡片文件不搬。
  • 缺副本、内容不一致、写失败一律保留原件并继续收尾——归档失败不会让你丢东西。
  • 顺带修掉这条路径上的一个崩溃:模块里 fs 是 promises,fs.existsSync 并不存在,归档一执行就抛错。
  • 控制面板读取产物时,任务目录与该任务的 Zotero 目录两个根都认,其它路径照旧拒绝。
  • 新增 4 项测试锁定行为(搬走 / 卡片不搬 / 缺副本保留 / 无 Zotero 目录不动作)。

lit-learning 0.2.1 —— 与归档互操作

  • 上面那个归档会让 extractPath 指到工作流目录之外,而学习层原来只认工作流目录,于是归档过的论文全被判「越界」——材料还在 Zotero,但读不到。
  • 现在声明路径允许落在工作流目录或该任务 job.json 自己的 artifacts.zoteroFolder,其它绝对路径仍然拒绝;生成器版本抬到 10,旧层自动判陈旧并重建。
  • 新增 2 项回归:归档目录里的抽取被采信、归档目录之外的声明照样被拒。

文档

  • 安装方式改为「GitHub 下载优先」;说明 npm 包名已预留但尚未发布(按包名装会 404)。
  • scripts/verify-package.mjs 支持作用域包名并覆盖 plugin-hub,四项包结构检查恢复全绿。

验证

  • Node:literature-workflow 153/153、knowledge-cards 12/12、lit-learning 54/54(3 项跳过:jsdom/真实 Cordis 未装依赖)、plugin-hub 5/5。
  • node scripts/check.mjs 72 个文件 0 失败;node scripts/verify-package.mjs 四包全过。
  • Python:pytest 56 通过、4 待修(已知与渲染器版本绑定的 5 项之一,CI 按 informational 处理)。
  • 在 lit-learning 的真实数据测试上核对过:归档过的论文现在能正常读入并重建学习层。

MIT License.