deepseek-reader 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

deepseek-reader 兼容性怎么样？

尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

deepseek-reader 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

deepseek-reader 还在维护吗？

GitHub 0 星。最近一次上游提交在 2026/10/1。

文档阅读工作台 bigricedumpling/deepseek-reader

DeepSeek Harness

bigricedumpling34 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

集中阅读整理并编辑 Markdown、PDF 与 H5 文档

30/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/10/2 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add bigricedumpling/deepseek-reader

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：仅索引

是什么[目录]—

dsh 原生插件 · ui

暂无时间戳·判据 →

装得上吗[实装验证]—

本站尚未做安装检查

L4 · 真实安装等级说明 →

数据截至 2026/11/04·判据 →

安全吗[自动扫描]—

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

数据截至 2026/11/04·判据 →

还在维护吗[仓库]—

更新放缓：最近一次提交在 34 天前

暂无时间戳·判据 →

图例：✓ 通过! 需注意— 未判定 / 无数据· 「未判定」= 本站尚无数据，不代表插件有问题

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

可信度证据

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

可执行外部命令写入剪贴板(不计风险)读取剪贴板或密钥环境变量发起外部网络请求

查看扫描证据（共 29 处，展示前 29 条）

发起网络请求
plugins/reader-workspace/client.js:396
const response = await fetch('api/reader-workspace/status', { cache: 'no-store' })
读取密钥环境变量
plugins/reader-workspace/index.js:37
if (!process.env.READER_TOKEN) return
发起网络请求
plugins/reader-workspace/managed-server.js:38
const response = await fetch(new URL(legacy ? 'api/me' : 'api/instance', url), { signal: AbortSignal.timeout(1000) })
执行外部命令来自配置/变量
plugins/reader-workspace/managed-server.js:83
child = spawn(process.execPath, [path.join(runtime, 'server', 'serve.js')], {
执行外部命令来自配置/变量
server/content-api.js:97
const child = spawn(command, args, { stdio: 'ignore' })
执行外部命令来自配置/变量
server/content-api.js:769
const child = spawn(bin, [abs, '-s', 'bing', '-li', 'en', '-lo', 'zh', '-o', path.dirname(outAbs)], {
读取密钥环境变量
server/serve.js:46
const BRAND_KEY = process.env.KB_BRAND_KEY || 'reader.brand'
读取密钥环境变量
server/serve.js:47
const LOGO_KEY = process.env.KB_LOGO_KEY || 'reader.logo'
执行外部命令来自配置/变量
server/services/public-session.js:31
next = fork(fileURLToPath(new URL('../serve.js', import.meta.url)), ['--guest'], {
发起网络请求
server/services/public-session.js:60
const upstream = http.request({ hostname: '127.0.0.1', port, path: req.url, method: req.method, headers: { accept: req.headers.accept || '*/*' } }, in
执行外部命令来自配置/变量
server/services/public-session.js:67
tunnel = spawn(executable, ['tunnel', '--no-autoupdate', '--url', 'http://127.0.0.1:' + proxy.address().port], { stdio: ['ignore', 'ignore', 'pipe'] }
执行外部命令来自配置/变量
server/services/restore-viewer.js:15
const child=spawn(process.execPath,[fileURLToPath(new URL('../serve.js',import.meta.url))],{env:{...process.env,DOCS_ROOT:root,PORT:String(port),READE
读取密钥环境变量
server/share.js:24
export const EDIT_PASSWORD = process.env.READER_PASSWORD || readPasswordFile()
发起网络请求
src/composables/useExport.js:55
const response=await fetch(u);if(!response.ok)throw Error('图片读取失败，导出已停止以避免缺图')
发起网络请求
src/composables/useTableColumnWidths.js:42
const r = await fetch(API_BASE + '/api/colw?file=' + encodeURIComponent(docFile.value))
发起网络请求
src/composables/useTableColumnWidths.js:55
await fetch(API_BASE + '/api/colw', {
发起网络请求
src/main.js:44
await fetch(BASE_PATH + '/api/session', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ password: old }) }).
发起网络请求
src/main.js:48
const me = await fetch(BASE_PATH + '/api/me').then(r => r.json()).catch(() => null)
发起网络请求
src/services/readerClient.ts:7
const response=await fetch(base+'/api'+endpoint,init)
发起网络请求
src/stores/docs.js:222
const res = await fetch(API_BASE + '/api/me')
发起网络请求
src/stores/docs.js:488
const res = await fetch(API_BASE + '/api/doc?path=' + encodeURIComponent(file))
发起网络请求
src/stores/docs.js:629
const res = await fetch(API_BASE + '/api/pdf-translate', {
发起网络请求
src/stores/docs.js:658
const res = await fetch(API_BASE + '/api/pdf-translate?path=' + encodeURIComponent(file))
发起网络请求
src/stores/docs.js:674
const res = await fetch(API_BASE + '/api/pdf-translate?path=' + encodeURIComponent(file))
写入剪贴板
src/utils/clipboard.js:5
await navigator.clipboard.writeText(text)
发起网络请求
src/utils/reveal.js:18
const response = await fetch(API_BASE + '/api/reveal', {
发起网络请求
src/utils/rich-blocks.js:35
if(value.type==='card'){const a=document.createElement('a');a.textContent=value.title||'打开文档';a.href='#';a.onclick=async e=>{e.preventDefault();try{co
发起网络请求
src/utils/toc-fold.js:47
const res = await fetch(API_BASE + '/api/foldable?path=' + encodeURIComponent(path))
发起网络请求
src/utils/toc-fold.js:61
const res = await fetch(API_BASE + '/api/foldable', {

扫描于 2026/11/4（1 天前） · 范围全包扫描 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

功能亮点

阅读PDF文档
编辑H5文档

阅读器文档工作区与 DeepSeek Harness 插件预览

README

由 DeepSeek 最新模型翻译生成

文档工作台集中阅读、整理和编辑 Markdown、PDF 与 H5 文档的工作台。内容仍是普通文件，知识库、文件夹和文档都对应磁盘上的目录与文件。 Preview 安装需要 Node.js 24 或更新版本。在仓库根目录运行： npm ci npm run build npm run start:local 然后打开 http://127.0.0.1:8090/，创建知识库和文档。本机访问直接进入管理界面，无须注册账号；服务默认仅监听本机。内容默认存放在仓库旁边的知识库目录。可在启动前设置绝对路径 DOCS_ROOT 来选择数据目录，勿将它放入公开网站目录或 Git 仓库。在 DSH 中使用，还需安装接入插件并连接 Reader。预览版安装包在 GitHub Releases，步骤和已知问题见 DSH 插件说明。源码也同步在 Gitea。社区市场尚未收录，因此目前不能靠市场搜索安装；即使之后从市场安装接入插件，Reader 服务仍需单独启动。简洁侧栏与章节导航阅读与导航 - 展开左侧栏管理文档；收起后仅保留入口图标与当前文档的章节短线。 - 章节短线垂直居中，悬停仅提示该章节标题，点击短线直接跳转。右侧目录打开时，左侧目录入口自动停用。 - 收起时点击左上角图标展开文档侧栏；展开时点击该图标切换知识库。 - 手机上的知识库切换采用弹窗。

展开完整文档（README 剩余 1 节）

文档工作台

集中阅读、整理和编辑 Markdown、PDF 与 H5 文档的工作台。内容仍是普通文件，知识库、文件夹和文档都对应磁盘上的目录与文件。

Preview 安装

需要 Node.js 24 或更新版本。在仓库根目录运行：

npm ci
npm run build
npm run start:local

然后打开 http://127.0.0.1:8090/，创建知识库和文档。本机访问直接进入管理界面，无须注册账号；服务默认仅监听本机。内容默认存放在仓库旁边的 知识库 目录。可在启动前设置绝对路径 DOCS_ROOT 来选择数据目录，勿将它放入公开网站目录或 Git 仓库。

在 DSH 中使用，还需安装接入插件并连接 Reader。预览版安装包在 GitHub Releases，步骤和已知问题见 DSH 插件说明。源码也同步在 Gitea。社区市场尚未收录，因此目前不能靠市场搜索安装；即使之后从市场安装接入插件，Reader 服务仍需单独启动。

简洁侧栏与章节导航

阅读与导航

- 展开左侧栏管理文档；收起后仅保留入口图标与当前文档的章节短线。
- 章节短线垂直居中，悬停仅提示该章节标题，点击短线直接跳转。右侧目录打开时，左侧目录入口自动停用。
- 收起时点击左上角图标展开文档侧栏；展开时点击该图标切换知识库。
- 手机上的知识库切换采用弹窗。
- 多文档以标签切换；只打开一篇时显示普通标题。
- 默认使用 HarmonyOS Sans，可调整字体、字号、行距、正文宽度和主题。

字体说明：阅读器使用 HarmonyOS Sans © Huawei Device Co., Ltd.，字体文件保持原样，授权文本见 HarmonyOS Sans 字体许可。

编辑

选中文字后，在同一浮窗内使用转换格式、加粗、斜体、行内代码与链接。支持正文、一级至六级标题、代码块、引用和列表。

普通标题与折叠标题独立设置。文档与文件夹支持拖动排序，顺序保存在 .reader/state.sqlite。正文自动保存；覆盖前保留最近 100 个版本。编辑器无法完整还原的 Markdown 结构会切换到源码编辑，避免静默损失内容。

公开与锁定

/onlyread 是公开访客视角，始终只显示公开资料；/doc 是管理入口，本机打开无需登录。通过远程地址访问管理界面时，需要设置并验证管理密码。管理员可维护锁定资料，不改变访客权限。公开与锁定是独立开关：

| 状态 | 行为 |
| 对外展示 | 未登录访问者可阅读 |
| 不对外展示 | 验证管理密码后才能看到 |
| 已锁定 | 访客不可修改，包含改名、移动、删除与排序；管理员仍可维护 |
| 未锁定且公开 | 访问者可以直接编辑，适合示例知识库 |

访客不能绕过父级隐藏或锁定。继承锁定可直接打开上级解锁确认；操作会影响该上级及继承它的内容。修改公开状态、锁定或解锁，均须重新输入管理密码。管理者可从侧栏预览公开版，公开页可进入管理入口。公开与锁定状态收在条目菜单和当前文档设置中，列表行不常驻状态图标。

服务端执行权限校验，界面隐藏按钮不能代替权限检查。管理会话使用 HttpOnly Cookie，不把密码保存在浏览器中，也不通过分享链接授予编辑权限。

Agent（设计方向）用于锁定的正式交付；示例知识库是公开可编辑的体验空间。私有知识库不会出现在访客的列表或接口结果中。

搜索与导出

- 左侧栏：搜索当前知识库的文档名和路径。
- 右上角 / ⌘F / Ctrl+F：查找当前 Markdown 文档正文。
- 手机查找框在顶栏下方展开，有明确的关闭按钮，也可点击外部关闭。
- 右上角同一菜单并排显示公开与锁定状态，并提供 Markdown 下载和打印 / 导出 PDF。

手机端查找

页面外观与扩展

点击添加图标或添加封面后立即添加；点击图标更换，封面悬停后可更换、随机生成或调整位置。图标提供表情分类、Phosphor 预设、搜索、最近使用和上传。知识库图标可以直接点击更换。

后端已增加稳定文档标识、版本冲突保护、图片归属、事务恢复和 Agent 接口，详见 数据与扩展架构。

本机 DSH 插件试用版可从不同工作区连接同一份知识库，按授权范围查找和保存文档。DSH 右侧栏“开始”页也提供阅读器入口，直接加载现有网页。安装与连接见 Reader 插件说明，后续验收范围见 插件化实施计划。

左侧知识库列表始终可用，可按最近打开、名称、最近修改排序，也可置顶；从列表底部打开网格管理弹窗进行检索和筛选。文档侧栏底部另有“工作区浏览记录”，记录管理者在 DSH 打开过的 Markdown，源文件仍在原工作区。记录按来源去重，可归档与恢复；收录时生成独立、默认私有的正式文档，浏览历史继续保留。正式文档或目录可从菜单复制、移动到其他知识库，复制会保留文档图标、封面、图片和排版设置。需获取源文件最新版本时，在 DSH 预览中直接点击“收录”。

本地运行

npm ci
DOCS_ROOT=/absolute/path/to/knowledge-base npm run dev

需要远程管理时，在服务端环境中配置 READER_PASSWORD，或将密码写入项目根目录的 .admin-password（此文件已被 Git 忽略，应限制为仅当前用户可读）。本机访问无需密码。不要将本机管理服务直接暴露在公网。

不要把密码、令牌、.分享.json 或私有知识库提交到公开仓库。

默认开发端口为 8090。新知识库默认不公开；可以在知识库菜单中验证密码后修改状态。

历史链接兼容

以下已交付地址继续有效：

- /deepseek/reader/onlyread/ → 题目一
- /deepseek/reader/onlyread/笔试题/笔试题交付：题目一 → 题目一
- /deepseek/reader/onlyread/笔试题/笔试题交付：题目二 → 题目二 /edit/<路径> 兼容到管理入口。/onlyread/<路径> 保持公开访客视角，即使浏览器已有管理会话，也不会显示私有资料。公开且未锁定的示例库可以直接编辑。

工程结构

| 位置 | 职责 |
| src/components/Sidebar.vue、DocTree.vue | 知识库和文档导航 |
| src/components/RailToc.vue、TocPanel.vue | 简洁章节导航与右侧目录 |
| src/components/MarkdownEditor.vue | 富文本编辑、格式转换与内容保护 |
| src/components/AccessDialog.vue | 密码验证及状态操作 |
| src/stores/docs.js | 文档加载、缓存、标签与保存 |
| src/utils/routes.js | 统一入口与已交付书签兼容 |
| server/content-api.js | 文件接口、写入检查、历史备份 |
| server/share.js | 公开范围、继承锁和管理身份 |

技术栈：Vue 3、Pinia、Vite、Milkdown Crepe、Markdown-it、Shiki、Mermaid、PDF.js。

验证

npm run check
npm run test:access
npm run test:readonly
npm run test:block
npm run test:fold
node scripts/test-workspace.mjs
node scripts/test-recovery.mjs
node scripts/test-plugin.mjs
npm run test:transfer
npm run build

权限测试使用临时目录，覆盖公开过滤、密码验证、父级锁定、直接调用写接口、跨目录移动、删除、排序以及公开示例编辑。

部署

VITE_BASE=/deepseek/reader/ npm run build
DOCS_ROOT=/data/deepseek-reader-content PORT=8090 node server/serve.js

内容根目录应放在 Web 静态目录之外。对外仅暴露构建产物与受权限控制的 /api，不要把整个知识库目录作为静态目录发布。

部署前备份线上内容与服务配置，核对文件差异，保留服务器上的编辑。上线后检查三条历史地址、锁定资料的写入拒绝、示例库编辑，以及私有资料的访问拒绝。

入口选择

日常维护打开 /：已有管理会话直接进入管理工作区；给他人浏览使用 /onlyread/。管理员编辑无需解锁。修改访客权限时，从文档右上角或目录条目的三个点进入，修改公开或锁定状态仍需确认管理密码。

本地收尾审查（2026-09-23）

本轮通过：具名导入检查、构建、权限测试、保存备份与路径检查、标题折叠、块格式转换和入口路由测试（npm run test:routes）。浏览器实测公开入口只读、展开侧栏不连带打开知识库栏、关闭单个标签及刷新后保持关闭；本次浏览器检查未发现控制台错误。

补齐了私有文档列宽查询的权限校验、损坏 Cookie / URL 编码容错，并将默认构建资源前缀改为根路径，避免深层地址刷新时资源错位。部署到子路径时仍须设置 VITE_BASE。

上述检查属于本地回归；线上发布还需检查反向代理、内容隔离与历史链接。各版本范围见更新记录。

发布与内容更新约定

- 本地知识库是后续内容维护来源；不自动同步，收到明确更新指令后才发布。
- 线上仅包含 Agent（设计方向） 与 示例知识库。面试准备、简历、过程稿留在本地，不进入公开仓库与线上发布包。
- 公网内容根目录为 /data/deepseek-reader-content，位于静态目录之外。
- 首页按身份自动进入管理或公开视角；三个历史 /onlyread/ 地址保留。旧 /deepseek/demo/ 导向新的公开示例库。
- 发布前备份程序、内容、服务与反向代理配置；发布后验证旧链接、公开过滤及示例编辑权限。

版本更新

- 2026-09-29 阅读器编辑、页面外观与数据存储升级