Read-only Molio knowledge base tools: list vaults, browse the file tree, full-text search and read documents, served over the local Molio daemon HTTP API, which must be running. Published on npm as dsh-plugin-molio.
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-plugin-molio
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:zhuzhaoyun/Molio#path:/packages/dsh-plugin-molio
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
让 DeepSeek Harness (dsh) 直接读取你的 Molio 本地知识库:在 dsh 对话中列出知识库、浏览文件树、全文搜索、读取原文,AI 基于你的积累做研究、写作与问答。
全部工具只读——插件不会修改你的知识库。
前置条件
- Molio 桌面端(或 Docker/NAS 部署)已启动,其本地 daemon 默认监听
http://127.0.0.1:3100 - Molio 中已创建至少一个知识库(vault)
- dsh
>= 0.2.0-rc.2
安装
dsh plugin add dsh-plugin-molio
或在 profile 中安装:
dsh plugin --profile <你的profile> add dsh-plugin-molio
连接远程 / 非默认端口的 daemon
通过环境变量覆盖(对 dsh 进程生效):
| 变量 | 说明 | 默认 |
|---|---|---|
MOLIO_DAEMON_URL |
daemon 完整地址(远程/NAS/Docker 部署用) | — |
MOLIO_PORT |
本机 daemon 端口 | 3100 |
工具清单
| 工具 | 参数 | 说明 |
|---|---|---|
molio_status |
— | daemon 健康状态 + 当前激活知识库 |
molio_kb_vaults |
— | 列出全部知识库 |
molio_kb_tree |
vaultId? |
知识库文件树(缺省用激活知识库) |
molio_kb_search |
query, vaultId?, limit? |
全文搜索,返回命中路径与摘录 |
molio_kb_read |
path, vaultId?, force? |
读取文本文件;二进制文件返回说明;过大文件需 force:true |
vaultId 既可传知识库 id,也可传名称(忽略大小写;重名时工具会提示改用 id)。
使用示例
在 dsh 会话中直接说:
用 molio_kb_search 在我的知识库里搜「分布式事务」,然后用 molio_kb_read 读最相关的那篇,总结要点。
错误处理
daemon 未启动时,工具返回可操作的中文提示(例如「无法连接 Molio 守护进程…请确认 Molio 已启动,或用 MOLIO_DAEMON_URL 指定地址」),不会抛裸异常。
开发
本包是 Molio monorepo 的成员(packages/dsh-plugin-molio),零运行时依赖:
pnpm --filter dsh-plugin-molio build # tsc → dist/
pnpm --filter dsh-plugin-molio test # node:test + 假 daemon HTTP 集成测试
License
与 Molio 主仓库一致:修改版 Apache License 2.0(附加条件见 LICENSE)。
Links
More in this category
Tencent/WeKnora#dsh-weknora★ 35014
Four read-only tools over a WeKnora knowledge base: list knowledge bases, hybrid passage search, reassemble one document's chunks in order, and WeKnora's own cited RAG or ReAct-agent answer with a resumable session id.
superdesigndev/treg★ 5944
Tool catalog for agents: search ~2,600 external endpoints (SEO and SERP, backlinks, social, people and company enrichment, ad libraries, scraping) by the task you want done, read each one's parameters and per-call price, then call it with the credential injected server-side. Ships the skill plus an MCP row that stays disabled until TREG_TOKEN is set.
T-Auto/dsh-ops★ 3709
Provides bash, PowerShell 7, and high-performance Rust tools for DSH on Windows to reduce token usage.
TencentCloudBase/CloudBase-AI-Toolkit#dsh-plugin★ 1141
Tencent CloudBase backend for DeepSeek Harness — scaffold and deploy full-stack apps from chat, render query results as table cards with paging, sorting and CSV export, preview a deployment on its domain, and call the CloudBase MCP toolset (`mcp__cloudbase__*`) with device-code login.
sixtysevenlf/dsh-blender-plugin★ 1019
Lets a DSH agent drive a local Blender over a direct TCP channel with 16 tools: viewport frames, custom-angle renders, Python execution, headless and job offload, transaction rollback, and a planning layer of 186 ops across 28 families.
anysearch-team/anysearch-dsh★ 634
AnySearch-powered real-time web and vertical search provider for DeepSeek Harness.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.