iZY3 / dsh-notebook-knowledge-studio

Notebook Knowledge Studio

NotebookLM 式本地知识工作台,以双层 Cordis 插件形式运行于 DeepSeek Harness (dsh) Web UI:

Notebook → Sources → Chat → Studio

• Sources:本地文件 / URL(抓取并提取正文)/ 粘贴文本 / 网页搜索发现;内容 hash 去重(update / anyway 策略);Web 来源可 Refresh
• Chat:BM25 检索(中文二元分词)+ LLM 生成,回答带 [n] 引用,点引用打开来源抽屉并高亮引文;证据不足时明确说明,不杜撰
• Studio:思维导图 / 报告(BLUF·学习指南·FAQ·时间线等)/ 闪卡 / 测验 / 信息图 / 幻灯 / 数据表格(MD+CSV),按量化规范产出并带 provenance
• 知识存储:OKF v0.2 Markdown,local-first、可整体迁移;检索索引只是可重建缓存
• 多模态:图片/音视频/PDF 来源自动标记待转写,由已挂载的 Qwen-MM-Plugins MCP 处理后写回;未检测到时如实降级,不伪造
• UI:主界面 conversation.view 视图标签;三栏可拖宽(键盘 ←/→ 可调,宽度记忆);窄容器自动堆叠

安装

dsh plugin --profile web add <本仓库路径或 github:用户名/仓库名>

已知问题:Windows 下 dsh plugin add 对含空格的路径会拆断。绕过:在 ~/.dsh/profiles/web 目录直接 pnpm add "<绝对路径>",再把包名 dsh-notebook-knowledge-studio 追加进该目录 package.json 的 dsh.profile.bundles 数组。

数据根目录由本仓库 cordis.patch.yml 的 root 配置指定,改为你的工作区路径即可。

运行环境依赖

依赖	用途	缺失时的行为
dsh web profile	宿主:tools/webServer/llm/web 服务	无法运行
LLM 路由(如 deepseek-official)	问答与 Studio 生成质量	自动降级:抽取式回答/模板产物
dsh web 服务(ctx.web)	URL 导入、网页搜索	相关操作报错,其余正常
Qwen-MM-Plugins MCP	多模态来源转写	停在待转写状态,不影响其他功能
pnpm	插件安装(dsh plugin add 转发)	无法安装;已装插件不受影响

开发

npm test              # 23 个单元/集成测试(node --test)
node scripts/e2e.mjs  # API 端到端验收(需 dsh web 已启动)

• host 半(lib/*.mjs + lib/index.js):零外部包导入,tools + HTTP API
• client 半(lib/client.js):纯 DOM,__ModuleLoader__ 工厂格式,无构建链

License: MIT