Repository navigation
Releases
Releases · ysl289/dsh-literature-workflow
v0.3.2 — 文献工作流四件套(Zotero 收尾归档 + 学习层互操作)
这套包是什么
给 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)
- 下载下面的
dsh-literature-suite-0.3.2.zip(2.3 MB,含四个插件包 + 技能 + 文档)。 - 解压到固定目录,例如
D:\dsh-literature-suite。 - 在 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 # 可选- 重启 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-workflow153/153、knowledge-cards12/12、lit-learning54/54(3 项跳过:jsdom/真实 Cordis 未装依赖)、plugin-hub5/5。 node scripts/check.mjs72 个文件 0 失败;node scripts/verify-package.mjs四包全过。- Python:
pytest56 通过、4 待修(已知与渲染器版本绑定的 5 项之一,CI 按 informational 处理)。 - 在
lit-learning的真实数据测试上核对过:归档过的论文现在能正常读入并重建学习层。
MIT License.