DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

Memerybeauty /

Memerybeauty/dsh-litkb

Verified

文献知识库:收文、精读、证据链、横向对比、可追溯检索

★ 1 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@819c5569

文献工作台(dsh-litkb)

装进 DeepSeek Harness 的本地文献知识库:收文 → 精读/七段卡 → 证据链 → 横向对比/图谱 → 可追溯问答 → 写作。

版本:0.16.3 状态:P0–P5 已交付,并完成产品化收口(上手引导 / 数据备份恢复 / 安装器 / 关于与诊断);产品形态为个人工作台 + 论文库 + 写作三块。

代码仓库:https://github.com/Memerybeauty/dsh-litkb(private)
CI:GitHub Actions(check → format → lint → test → coverage)

核心场景

场景 现在能做什么
收文 本地 PDF 拖拽/多选;DOI / arXiv / 普通 PDF 链接导入;SHA 去重;失败提示
入库自动化 导入后后台串行完成原文解析 → 七段卡 → 精读;顶部进度条、无模型降级、论文行「补全」
删除论文 详情头部「删除」:显示影响面(卡片/解析/精读/译文/链/研究/文稿引用),二次输入确认;清理索引与派生文件
固定模型 设置可固定工作台全部模型调用到 DeepSeek(V4 Pro / Flash),不跟随聊天默认模型;密钥存 DSH 凭据库
阅读状态 七段卡生成成功自动记「略读」,精读成功自动记「精读」;只升不降,手动切换后以用户为准
论文行 单列分层:标题占满、状态/卡徽标右上、操作在选中行底部、标签单行;窄屏不溢出
方向分析 论文进入研究主题后逐篇读全文,按研究内容判断符合/不符合,归纳观点与一致/分歧;观点可生成草稿链
解析 PaddleOCR / pdf.js;分页分块;页图;解析稿;整篇/章节/块翻译;术语表
七段卡 生成、逐段编辑、逐段/整卡重生成、批注、版本回滚、q-id 证据
精读 11 板块 Markdown、数值核对、论点候选、q-id 回贴;左侧小节导航可隐藏
个人工作台 研究卡片 → 四视图(论文 / 证据链 / 方向分析 / 结论);匹配可调/可解释、结论过期提示、链批量审核与合并
证据链 四种手动建链;单篇自动建链草稿;跨论文对比/矛盾链;主题建链;审核队列
图谱 证据链知识库:Cytoscape、10 字节点、分色、拖拽、布局持久化;概念图谱暂时隐藏
横向精读 独立页签;2–4 篇并排;差异/数字高亮;只看差异;折叠;对比链;存为文稿
检索问答 BM25 证据/链检索;链优先答案;q-id 引用校验;过滤/复制/存为文稿;最近 50 条历史
写作 文稿 CRUD、引用库、参考文献、AI 扩写意图、可拖拽三栏、专注模式、MD 导出
Agent 12 个 lit_* 工具;读优先,保存链/建链必须 confirm:true
导出 BibTeX、GB/T、证据 JSON/CSV、卡片 MD、图谱 Mermaid/Canvas、解析稿 MD
产品化 首次上手 5 步引导;整库 zip 备份/恢复(自动快照、路径校验);关于/诊断/本地优先说明;一键安装脚本

界面导航

大页面:个人工作台(研究卡片 → 三个大视图卡)
论文库 / 写作:从工作台入口卡进入,页头可返回
论文库(论文 / 横向精读 / 图谱 / 检索)
写作(文稿 / 引用 / 参考文献)
  • 个人工作台:卡片进研究;「开始探索」自动匹配+建链;参考论文只含本研究论文,点开即精读页;工作台状态在跳转后保留;
  • 论文库:列表 + 详情 + 原文;详情页签为 详情 / 七段卡 / 精读 / 原文解析;
  • 论文行选中后底部:补全 / 自动建链 / 审核队列;
  • 图谱页:证据链知识库 + 自动建链/审核(整库或跨论文);
  • 论文库:二级视图切换 论文 / 横向精读 / 图谱 / 检索;
  • 写作:独立模块,文稿按研究筛选;研究页/链详情可直达;
  • 横向精读:在论文库内切换;
  • 概念图谱:暂时隐藏,组件与 /graph 接口保留。

5 分钟上手

  1. 安装:npm run plugin:install -- --profile desktop,完全退出 DSH 再启动,Cmd+Shift+R;
  2. 打开「文献工作台」:空库会显示欢迎页,导入第一篇 PDF;
  3. 打开论文 → 七段卡 / 精读;在原文解析里选中一句话可建链;
  4. 回到工作台 → 新建研究 →「开始探索」,审核确认证据链;
  5. 去「写作」新建文稿,从研究/链详情插入引用;
  6. 设置 →「数据与备份」下载整库备份;换机或升级前先备份。

引导进度会按真实库自动打勾,完成后自动隐藏;可在设置里重新显示。

运行

  • 数据目录:默认 ~/Documents/文献库,可用 LITKB_LIBRARY 覆盖;
  • 安装:npm run plugin:install -- --profile desktop(默认安装本版本 tgz;开发模式加 --link),完全重启 DSH;
  • 前端缓存:重启后 Cmd+Shift+R;
  • 健康检查:GET /api/litkb/health 应显示 0.16.3;
  • 升级前:在「设置 → 文献工作台 → 数据与备份」下载整库备份;恢复前会自动快照当前库。

开发

npm run build     # 从 src/ 生成 lib/
npm test          # 140 项 / 39 个测试文件
npm run verify    # check + lint + format:check + test
npm pack          # 产出 dsh-litkb-0.16.3.tgz

目录:

lib/         生成产物(服务端 + 客户端;由 src/ 拼接生成)
src/         客户端/服务端源码分片 + 构建脚本
scripts/     build-client.mjs / build-server.mjs
prompts/     prompt 版本化
tests/       假 React / 临时库 / 真实库干跑
docs/        方案、交付单、验收记录、对照图
docs/assets/ 截图与架构图

关键边界

  • 自动建链是草稿 + 审核,不直接污染正式链库;
  • 无精读时用七段卡兜底,并提示补精读复核;
  • 跨论文链是规则判断(相似度/数字/线索词/主题/概念),低置信度会警告;
  • 检索答案必须带库内 q-id;无模型时退化为抽取式,不编造;
  • 主题建链同样是草稿 + 审核,确认后才进检索与图谱;
  • 概念图谱暂隐藏;LLM 重排、文件夹监控、定时备份/云同步未做;
  • 备份是本地 zip,不含 settings.json 与 cache/;恢复前自动快照,不做文件级合并。

文档

文档 内容
PDE 交付案例 按 Product Design Engineer 口径整理的端到端案例:12 份文档,含取舍、复盘与能力映射
项目开发标准流程 从立项到复盘的完整 SOP:阶段、闸门、每版七步环、走查与评估、发布清单、模板
已完成工作总览 六天进度、模块完成度、工程量、边界与下一步
功能清单 当前模块状态、接口、数据、验收与未做项
P4.11 交付单 自动建链、跨论文链、检索、Agent、场景补齐与版本记录
产品化交付 上手引导、整库备份/恢复、关于与诊断、安装器、验收
入库自动管线 导入后自动解析 / 七段卡 / 精读:状态机、降级、补全、设置
阅读状态自动标记 七段卡→略读、精读→精读;手动优先与旧库迁移
方向分析与观点链 全文方向审查、符合/不符合矩阵、观点聚类、一致/分歧、观点链
内部业务 Agent 设计 待规划:4 个内容 Owner + 审核质量门 + 编排器:职责、契约、流程、迁移
待规划 当前优先问题、Agent 架构、质量评测、启动条件
正式交付说明 安装、验收步骤、已知边界、维护入口
文档索引 当前文档 / 历史文档边界
API 参考 90 条路由分组与关键请求/响应
安装升级与发布 安装、重启、版本检查、GitHub 发布流程
数据模型与迁移 库结构、链/历史/导入字段、备份
故障排查 404、主题、概念图、端口、Git push
插件技术方案 架构、路由、工具、库结构
PRD / 需求规格 产品需求与 FR/NFR
UI 优化方案 设计令牌、页面重排、P0–P4 记录
论文精读与证据链方案 精读结构、claim-evidence、链模型
P4.10 交付单 论证链数据模型与四种建链
知识库图交付单 Cytoscape 图、拖拽、布局
研究工作台 v2 总览 + 研究页、匹配建链、数据模型
研究工作台开发计划 P5.0–P5.4 任务分解与验收
—/ 5

No ratings yet

Verified DSH bundle

Commit 819c55699c35

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout