@hiai-gg/dsh-docsmint
v1.0.3
Published
DocsMint for DeepSeek Harness: a left-sidebar panel and five agent tools over the DocsMint REST API or the DocsMint MCP server (OAuth for DocsMint Cloud, API key for self-hosted).
Maintainers
Readme
@hiai-gg/dsh-docsmint
English | 简体中文
在 DeepSeek Harness 左侧边栏中浏览 DocsMint 工作区,并让智能体通过五个工具浏览目录结构以及搜索、读取、创建和更新文档。
安装稳定版
dsh plugin --profile web add @hiai-gg/dsh-docsmint
dsh --profile web --dump-config
dsh --profile web当前稳定版为 1.0.0。也可通过 Harness 的 plugin_manager install_bundle 安装,目标为 @hiai-gg/dsh-docsmint。安装后打开左侧 DocsMint 图标。
连接方式
- DocsMint Cloud:MCP 模式通过 DocsMint OAuth 登录(PKCE),API 模式使用 API 密钥。可用功能取决于账户方案和实际授权。
- 自托管 DocsMint OSS:API 模式连接实例 REST API。MCP 模式要求该实例提供以 Bearer 密钥认证的 Streamable HTTP
POST /mcp;仅提供 stdio 的旧实例应使用 API 模式。
授权范围由服务器决定。工作区密钥不会因切换筛选器而获得其他工作区权限;分类密钥只能访问已授权分类。多工作区连接必须选择实际获得授权的工作区。
面板和工具
- 按工作区、分类、文件夹筛选,并按更新时间、标题或创建时间排序。
- 每页 50 个文档,点击“显示更多”追加下一页并去重;筛选变更重置分页。如果传输忽略页码且不返回新文档,将停止继续加载,同时保留真实总数。
- 显示最近一次成功加载的时间,失败不会标记为成功刷新。
- 创建分类、文件夹和文档,编辑文档标题与 Markdown 正文,在 DocsMint 网页中打开原文。
| 工具 | 用途 |
| --- | --- |
| docsmint_list_workspace_structure | 列出可访问的文件夹和分类及其 ID |
| docsmint_search | 搜索已授权文档 |
| docsmint_get_document | 读取文档及链接 |
| docsmint_create_document | 创建文档 |
| docsmint_update_document | 更新标题或正文 |
这五个是插件提供给智能体的工具,不是 DocsMint MCP 服务端完整工具目录。
隐私和凭据
API 密钥和 OAuth 令牌保存在 Harness 凭据存储中,不发送到浏览器页面。没有可用凭据存储时,先启用它再连接。不要将密钥、令牌或回调 URL 粘贴到聊天、截图或问题报告中。
插件不添加遥测或分析,仅与配置的 DocsMint 服务通信。Host 配置、环境变量和无头运行方式见 英文配置说明。
兼容性和故障排查
要求 Node.js 22 或更新版本,DSH >=0.2.1-rc.5 <0.3.0。CI 覆盖 Node 22/24;发布验收还使用了独立 Harness 0.2.2-rc.1 配置。目录是否收录或验证,以各目录自己的结果为准。
- 看不到图标:确认启动的是安装插件的同一 profile,然后重启该 profile。
- 自托管连接失败:检查实例 URL、传输模式和密钥权限。
- 列表范围不符:检查工作区、分类和文件夹,不要通过扩大密钥权限解决筛选问题。
- 报告问题时提供插件和 Harness 版本、脱敏错误,不提供凭据。
升级和移除
用同一 profile 的安装命令升级,也可指定精确版本,例如 @hiai-gg/[email protected]。
dsh plugin --profile web remove @hiai-gg/dsh-docsmint移除插件不删除 DocsMint 文档;如有需要,先断开该插件自己的授权,不影响其他连接。
源码和支持
插件镜像供安装与目录发现使用,源码修改和 npm 发布来自 DocsMint 主仓库。请勿直接修改自动镜像。
欢迎自愿为插件镜像或主仓库加星;这不是使用条件,也不代表第三方安全认证。
许可证:Apache-2.0。
