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 分钟上手
- 安装:
npm run plugin:install -- --profile desktop,完全退出 DSH 再启动,Cmd+Shift+R; - 打开「文献工作台」:空库会显示欢迎页,导入第一篇 PDF;
- 打开论文 → 七段卡 / 精读;在原文解析里选中一句话可建链;
- 回到工作台 → 新建研究 →「开始探索」,审核确认证据链;
- 去「写作」新建文稿,从研究/链详情插入引用;
- 设置 →「数据与备份」下载整库备份;换机或升级前先备份。
引导进度会按真实库自动打勾,完成后自动隐藏;可在设置里重新显示。
运行
- 数据目录:默认
~/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 任务分解与验收 |
No comments yet. Be the first to write one.