流明市场 · Lumen Market
为 DeepSeek Harness 提供一个集插件发现、介绍、文档、安装和更新于一体的市场。你可以搜索 npm 与 GitHub 插件，也可以查看当前已安装的本地插件。
安装和更新由 DSH 官方插件管理器执行。点击确认前，市场会展示查验过的版本或 commit，以及兼容性信息。
当前源码版本为 0.3.1，更新内容见 更新记录。可通过 npm dsh-lumen-market@0.3.1、GitHub v0.3.1 标签或本地目录安装。npm 安装前也可在版本页面核对发布状态。
实机截图
以下图片直接截取自运行中的 DeepSeek Harness 桌面应用，不是离线演示或设计稿。使用了自定义宿主主题；为保护隐私，仅裁去侧栏、会话列表和余额区域。截图中的版本和结果代表拍摄时的状态。
发现插件：查看来源、简介、版本和兼容性。
插件详情：阅读完整介绍，打开项目主页、仓库和 README。
能做什么
| 功能 | 用途 |
|---|---|
| 搜索插件 | 搜索 npm 与 GitHub，或直接输入仓库地址 |
| 按星标排序 | 选择「GitHub 星标最多」，从高到低浏览 GitHub 候选 |
| 了解插件 | 查看简介、完整描述和文档入口 |
| 安装前查验 | 展示兼容性、确切版本或固定 commit |
| 查看已安装 | 识别 npm、本地链接、Git 等不同来源 |
| 检查更新 | 查找可更新的 npm 插件，逐项预览并原地升级 |
| 重启提醒 | 更新后持续提示需要重启的插件 |
| 安装进度与取消 | 查看查验、下载和应用阶段；支持的宿主可取消正在安装的目标 |
安装
使用带有官方插件管理功能的 DeepSeek Harness。插件已发布到 npm，包和仓库均包含可加载的 lib/ 文件，无需自行构建。
推荐：在 DSH 中通过 npm 包名安装
打开侧栏 「插件」→「添加插件」。
填入下面的 npm 安装目标：
dsh-lumen-market@0.3.1确认安装，按官方管理器的提示处理构建授权或重启。
安装生效后，侧栏会出现 「流明市场」。
需要其他版本时，可在 npm 版本页面 确认版本号，再填写 dsh-lumen-market@版本号。
也可以让 DSH 使用官方管理工具完成安装：
plugin_manager { action: "install_bundle", target: "dsh-lumen-market@0.3.1" }
可选：用 npm 下载到普通项目目录
需要 Node.js 22 或更高版本和 npm。在普通项目目录运行：
npm install dsh-lumen-market@0.3.1 --ignore-scripts --registry=https://registry.npmjs.org
这会将包下载到当前项目的 node_modules/dsh-lumen-market，不会自动在 DSH 中激活。要在 DSH 中使用，推荐通过上面的官方插件管理器安装；不要直接在 DSH 的 profile 目录执行 npm 安装。
从 GitHub 安装 0.3.1
在 DSH 官方「添加插件」中填写：
github:Femad-6/dsh-lumen-market#v0.3.1
此示例使用本次版本标签。需要完整 commit SHA 时，可在 GitHub 提交列表 复制对应提交的完整 SHA，并替换末尾的 v0.3.1。流明市场内的 GitHub 安装预览仍会将仓库查验结果固定到完整 SHA。GitHub 来源不会获得 npm 来源的按包名更新按钮。
从本地目录安装
适合希望修改代码或本地测试的用户。需要 Git、Node.js 22 或更高版本，以及 npm。
git clone https://github.com/Femad-6/dsh-lumen-market.git
cd dsh-lumen-market
npm ci --omit=dev --ignore-scripts --no-audit --no-fund
然后在 DSH「添加插件」中输入克隆目录的绝对路径。例如，克隆目录是 C:\Plugins\dsh-lumen-market，就填写该路径。请替换为你自己的实际目录。
本地安装通常会建立 link/junction。安装后不要移动目录；修改 host 代码后，需要正常退出并重新打开 DSH。
开始使用
- 找插件：进入「发现」，输入关键词、
owner/repo或 GitHub 仓库根地址，选择来源后点击「搜索」。 - 看介绍：点击「查看详情」，阅读描述与兼容性，使用「查看文档」了解更多。
- 装插件：目标符合条件时，点击「安装预览」，核对版本或 commit，再点击「确认安装」。
- 查更新：进入「已安装」或「可更新」，点击「重新检查」。有更新时，逐项预览和确认。
「已安装」会先显示本地列表，再在后台查询更新。三个标签页的「重新检查」都会请求新数据；发现页的筛选条件不会影响已安装列表。输入完整 npm 包名时，市场优先直接查询该包，减少关键词搜索漏收录的影响。
发现页的「排序」可以选择 「GitHub 星标最多」，会自动切换到 GitHub 来源并回到第一页。仓库按星标数从高到低排列，翻页和重新检查会保持排序；卡片与详情展示取得的 GitHub 星标数。切换到 npm 或全部来源时恢复默认排序，星标排序仍遵守页面提示的 GitHub 搜索范围。
星标数当前只显示在 GitHub 来源结果中；npm、本地链接和已安装项尚未补查关联仓库的星标数，因此这些卡片不显示 star。
宽屏下，右侧详情会随列表滚动保持可见，点击列表下方的插件无需返回页面顶部。长详情可在面板内独立滚动，切换插件后从新详情顶部开始阅读；窄屏则在列表上方展示详情并自动定位。
安装期间会显示官方管理器报告的阶段。出现「取消操作」时可以发起取消；市场会等待安装进程结束和文件恢复后的最终结果。已经进入应用阶段时可能无法取消。安装失败时可展开「安装诊断」，查看失败分类、已脱敏的输出及待授权的构建提示。
只检查或浏览不会自动安装、更新插件。待重启提示在刷新页面后仍会保留，真正重启 DSH 后才清空。
搜索来源
| 来源 | 搜索范围 |
|---|---|
| npm | 宿主配置的注册表；默认使用 npm 官方源，并带 npmmirror 回退 |
| GitHub | 关键词搜索限定 dsh-plugin topic，按最近更新排序；直接输入仓库根地址可查验没有这个 topic 的仓库 |
| 全部来源 | 合并 npm 与 GitHub，并在第一页显示匹配的本地已安装插件 |
GitHub 搜索不是全仓库扫描。搜索结果只是候选，需要打开详情完成查验，才可能提供安装按钮。
npm 分页按查验后的候选显示，每页最多 20 项。为控制等待时间，每次最多扫描 3 页原始候选；达到上限会明确提示缩小关键词，不把原始搜索数量当成已验证插件总数。
常见问题
为什么搜不到某个插件？
检查来源和筛选条件。找本地安装的插件时，选择「全部来源」并关闭「仅可安装」，或者进入「已安装」。找 GitHub 项目时，包名可能与仓库名不同；直接输入完整仓库地址更准确。网络失败、限流或注册表尚未收录也会影响结果。
为什么显示“未验证”，没有安装按钮？
首版只直接安装仓库根目录的单包插件。缺少 DSH 声明、缺少构建产物、导出路径无法完整查验或不兼容时，会显示原因。只有客户端模块、monorepo 子包和无法固定 commit 的目标也不会直接安装。静态查验不能保证插件运行成功，最终结果仍由官方管理器决定。
为什么本地链接和 Git 插件没有升级按钮？
按 npm 包名升级会替换原来的安装来源，因此只对符合条件的 npm 依赖提供更新。本地 link/file、Git、压缩包和 npm 别名不会被转换成注册表安装，也不会自动追踪新的 Git commit。
安装或更新失败怎么办？
查看页面错误和官方管理器的诊断。兼容性拒绝会说明不满足的 peer 范围；构建脚本授权也由官方处理。市场不会自动授权脚本、写入兼容性豁免或重试安装。若提示 profile 定位异常，可点击页面底部「诊断」查看原因；分享诊断前请检查路径等个人信息。
GitHub 限流怎么办？
等待页面显示的重试时间。匿名查询可用；需要提高配额时，可以在启动宿主的环境中设置专用变量 DSH_LUMEN_MARKET_GITHUB_TOKEN，具体说明见开发文档。不要将 token 放进仓库或截图。
开发与反馈
开发命令、接口和验证说明见 开发文档 与 验证摘要。隔离集成测试使用真实临时 profile 文件和 HTTP，但安装器是模拟实现；真实桌面升级与回滚仍按 实机验收步骤 单独检查。离线预览使用模拟 API，实机截图来自桌面应用。
遇到问题可提交 Issue，附上 DSH 版本、操作步骤和去除敏感信息后的截图。
许可证
MIT。第三方依赖说明见 THIRD_PARTY_NOTICES.md。
No comments yet. Be the first to write one.