dp-plugin-market 0.0.0-stage → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +160 -2
- package/client.js +3037 -0
- package/cordis.patch.yml +7 -0
- package/icon.svg +20 -0
- package/index.js +16 -0
- package/locale/en.json +6 -0
- package/locale/zh.json +6 -0
- package/package.json +40 -4
- package/scripts/build.mjs +92 -0
- package/src/app/AppRoot.tsx +38 -0
- package/src/app/api/client.ts +260 -0
- package/src/app/api/download.ts +218 -0
- package/src/app/api/errors.ts +212 -0
- package/src/app/api/hosted-install.ts +35 -0
- package/src/app/api/install.ts +122 -0
- package/src/app/api/normalize.ts +271 -0
- package/src/app/api/types.ts +156 -0
- package/src/app/components/ErrorBoundary.tsx +40 -0
- package/src/app/components/icons.tsx +407 -0
- package/src/app/components/ui.tsx +805 -0
- package/src/app/features/market/DetailSidebar.tsx +149 -0
- package/src/app/features/market/DetailTabs.tsx +202 -0
- package/src/app/features/market/FilterBar.tsx +88 -0
- package/src/app/features/market/MarketHero.tsx +111 -0
- package/src/app/features/market/MarketPage.tsx +170 -0
- package/src/app/features/market/PluginCard.tsx +105 -0
- package/src/app/features/market/PluginDetailPage.tsx +256 -0
- package/src/app/features/market/PluginIcon.tsx +31 -0
- package/src/app/features/market/VersionRow.tsx +114 -0
- package/src/app/features/market/useArtifactDownload.ts +344 -0
- package/src/app/features/market/useMarketQuery.ts +264 -0
- package/src/app/features/market/usePluginDetail.ts +62 -0
- package/src/app/lib/auth.ts +109 -0
- package/src/app/lib/clipboard.ts +30 -0
- package/src/app/lib/format.ts +125 -0
- package/src/app/lib/hooks.ts +80 -0
- package/src/app/router.tsx +73 -0
- package/src/client/icon.jsx +41 -0
- package/src/client/index.js +57 -0
- package/src/client/styles/base.css +277 -0
- package/src/client/styles/market.css +1577 -0
- package/src/client/styles/panel.css +190 -0
- package/src/client/styles/tokens.css +131 -0
- package/src/client/styles/ui.css +965 -0
- package/src/client/styles/utilities.css +152 -0
- package/src/host/artifact.js +102 -0
- package/src/host/coral.js +154 -0
- package/src/host/install.js +319 -0
package/README.md
CHANGED
|
@@ -1,3 +1,161 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 插件市场 · DSH Plugin Market(玻尔版)
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
A DeepSeek Harness Web UI plugin that brings the 「DSH 插件市场 (玻尔版 / DP Edition)」
|
|
4
|
+
into Harness itself: a sidebar entry, a full central panel, plugin search, category /
|
|
5
|
+
tag filters, cursor pagination, plugin detail with versions / dependencies / runtime
|
|
6
|
+
requirements, and Host-side verified installs (download → sha256/size check → extract →
|
|
7
|
+
DSH plugin manager install + enable).
|
|
8
|
+
|
|
9
|
+
一个跑在 **DeepSeek Harness Web UI** 里的本地插件(bundle):左侧栏出现「插件市场」
|
|
10
|
+
图标,主面板直接浏览 Coral 插件市场,搜索、筛选、分页、查看版本/依赖/运行要求,并从
|
|
11
|
+
对象存储现取直链,校验 sha256 与体积;「安装」由 Host 半边解压后交给 DSH 插件管理器
|
|
12
|
+
安装并启用,「仅下载」则保存校验后的 .tgz。
|
|
13
|
+
|
|
14
|
+
## 功能
|
|
15
|
+
|
|
16
|
+
- **左侧栏入口**:注册 `sidebar.panellist` 图标(订单 30,排在文献阅读之后),点击进入
|
|
17
|
+
注册在 `main` 槽位的主面板。
|
|
18
|
+
- **列表**:搜索输入 **250ms 防抖**;分类(`category`)与标签(`tag`)筛选;游标分页
|
|
19
|
+
「加载更多」;请求序号 + AbortController 防止旧响应覆盖新筛选;加载中用骨架屏,
|
|
20
|
+
空结果/出错都有独立状态。
|
|
21
|
+
- **详情**:插件元信息、全部版本历史、最新版本依赖清单、`requirements`(peers /
|
|
22
|
+
engines / clients)运行要求、原始 JSON;每个版本都可单独安装或仅下载。
|
|
23
|
+
- **安装(Host 半边)**:点击「安装」后由 Host 用 Node 请求 **5 分钟有效**的 OSS 直链
|
|
24
|
+
(每次现取、绝不缓存),校验 **sha256 与体积**,把 `.tgz` 存到
|
|
25
|
+
`<DSH_HOME>/dp-plugin-market/artifacts/`,解压 `dsh-node-modules` 布局后交给 DSH 自己的
|
|
26
|
+
插件管理器 `pluginManager.installBundle(packageDir, { enabled: true })` **安装并启用**。
|
|
27
|
+
`application: applied` 立即生效;`restart-required` 会明确提示重启。这也是在 DSH 桌面
|
|
28
|
+
webview 里唯一可靠的下载方式 —— 浏览器 `<a download>` 跨域直链会留下
|
|
29
|
+
`~/Downloads/Unconfirmed *.crdownload`(字节下完了却永远不会落成 `.tgz`)。
|
|
30
|
+
- **仅下载**:同一套下载+校验流程,但只把校验后的 `.tgz` 保存到 artifacts 目录,不安装;
|
|
31
|
+
Host 不可用时才回退浏览器直链,并明确标注「未校验」+ 展示服务端登记值。
|
|
32
|
+
- **npm 源兜底(自动)**:市场 `/artifact` 返回 `409 PLUGIN_ARTIFACT_NOT_IN_OBJECT_STORAGE`
|
|
33
|
+
(历史版本未回填对象存储)时,「安装」会自动改用 `name@version` 从当前配置的 npm registry
|
|
34
|
+
经 pnpm 安装并启用(仍走 DSH 插件管理器,校验 DSH 版本范围与 bundle 清单)。**这条兜底成功时
|
|
35
|
+
不再显示任何 409 提示**,只保留一条短暂的「已安装并启用」toast。详情页另有「改用 npm 源安装
|
|
36
|
+
(pnpm)」按钮可手动选择这条路径。注意:这条路径使用 registry 的完整性校验,不经过市场登记的
|
|
37
|
+
sha256;未发布到 npm 的包(例如 `@local/*`)仍无法安装。
|
|
38
|
+
- **错误处理**:按 `error.code` 映射中文提示(`PLUGIN_MARKET_QUERY_INVALID`、
|
|
39
|
+
`PLUGIN_LISTING_NOT_FOUND`、`PLUGIN_ARTIFACT_NOT_IN_OBJECT_STORAGE`、
|
|
40
|
+
`CORAL_ROUTE_NOT_FOUND`、`CONFLICT` 等);**401 的
|
|
41
|
+
`{"error":"Authentication required"}` 字符串格式单独解析**;未知 code 展示原始
|
|
42
|
+
code/message;网络异常、超时、取消都有对应中文。
|
|
43
|
+
- **玻尔设计令牌**:沿用 dp-plugin-market 的 Bohrium 设计令牌(品牌渐变、圆角、阴影、
|
|
44
|
+
字体、间距),面板整体浅色,样式全部收敛在 `.dpm-root` 下,不会污染 Harness 其它界面。
|
|
45
|
+
|
|
46
|
+
> 作者控制台(上传 / 从 npm 源导入 / 上架管理)不在本插件范围内。
|
|
47
|
+
|
|
48
|
+
## 数据源
|
|
49
|
+
|
|
50
|
+
- API 基地址:`https://agent.bohrium.com/api/v1/coral`(生产);Host 半边使用同一个 base
|
|
51
|
+
读取直链与字节。
|
|
52
|
+
- 契约:`docs/api-contract.md`(源自 test 环境实测;生产路径/错误格式一致,响应多出的
|
|
53
|
+
`source` / `author` / `npmUrl` / `recommended` / `usageCount` 等字段会被宽容解析忽略)
|
|
54
|
+
- 市场接口公开、跨域为 `*`;浏览器请求统一 `credentials: 'omit'`、`cache: 'no-store'`,
|
|
55
|
+
不依赖 Cookie。生产 OSS 直链域名为 `coral-prod.oss-cn-zhangjiakou.aliyuncs.com`,
|
|
56
|
+
同样没有 CORS 头,因此字节仍由 Host 半边读取。
|
|
57
|
+
- 浏览器面板负责列表/详情/搜索;下载与安装走 Host 半边(Node fetch 读字节、校验、解压、
|
|
58
|
+
调 DSH 插件管理器),因为浏览器跨域读不到 OSS 字节、也无法安装插件。
|
|
59
|
+
|
|
60
|
+
## 包结构
|
|
61
|
+
|
|
62
|
+
```
|
|
63
|
+
dp-plugin-market-dsh/
|
|
64
|
+
├── package.json # name dp-plugin-market + dsh.bundle / dsh.client 清单
|
|
65
|
+
├── cordis.patch.yml # 插入 dp-plugin-market 一行(挂载 Host 半边)
|
|
66
|
+
├── index.js # Host 半边:注册 /api/dp-plugin-market 路由
|
|
67
|
+
├── client.js # 构建产物:window.__ModuleLoader__ 懒加载工厂(勿手改)
|
|
68
|
+
├── icon.svg # 包图标(插件管理器里的展示图标)
|
|
69
|
+
├── locale/{zh,en}.json # 标题与描述
|
|
70
|
+
├── scripts/build.mjs # esbuild:React external + 经典 JSX + CSS 内联
|
|
71
|
+
└── src/
|
|
72
|
+
├── host/ # Host 半边:coral.js(直链+校验)、artifact.js(安全解压)、
|
|
73
|
+
│ # install.js(路由 + installBundle)
|
|
74
|
+
├── client/ # 浏览器入口、侧栏图标、面板外壳 CSS
|
|
75
|
+
├── app/ # 从 dp-plugin-market 移植的市场应用
|
|
76
|
+
│ ├── api/ # Coral 客户端 / 规范化 / 错误映射 / Host 下载安装
|
|
77
|
+
│ ├── lib/ # 格式化、hooks 等
|
|
78
|
+
│ ├── components/ # ui.tsx、icons.tsx
|
|
79
|
+
│ ├── features/market/
|
|
80
|
+
│ ├── router.tsx # 面板内内存路由(Link / useRoute / navigate)
|
|
81
|
+
│ └── AppRoot.tsx
|
|
82
|
+
└── client/styles/ # tokens / utilities / ui / market / panel
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
## 构建
|
|
86
|
+
|
|
87
|
+
```bash
|
|
88
|
+
# esbuild 从 paper-read 的 node_modules 软链而来(见 node_modules/)
|
|
89
|
+
node scripts/build.mjs # 生成 client.js
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
构建把 `src/client/styles/*.css` 按 `tokens → utilities → ui → market → panel` 顺序拼接,
|
|
93
|
+
`tokens.css` 的 `:root` 令牌被重绑到 `.dpm-root`,整段 CSS 作为 `__MARKET_CSS__` 常量
|
|
94
|
+
内联进 bundle,面板挂载时由一个 `<style>` 元素注入、卸载时随 React 树移除。
|
|
95
|
+
|
|
96
|
+
## 安装
|
|
97
|
+
|
|
98
|
+
### 从 npm 官方源安装(推荐)
|
|
99
|
+
|
|
100
|
+
插件发布在 **https://registry.npmjs.org**(包名 `dp-plugin-market`):
|
|
101
|
+
|
|
102
|
+
1. 打开 DeepSeek Harness → 左侧「插件」→ 右上角「添加插件」
|
|
103
|
+
2. 选择「从 npm 安装」,输入包名:`dp-plugin-market`
|
|
104
|
+
3. 安装后在「已安装插件」中确认已启用;左侧栏出现「插件市场」
|
|
105
|
+
4. 打开即可浏览 / 搜索 Coral 插件市场
|
|
106
|
+
|
|
107
|
+
### 本地路径安装(开发调试)
|
|
108
|
+
|
|
109
|
+
```bash
|
|
110
|
+
# 插件 → 添加插件 → 本地路径 → 选择本目录
|
|
111
|
+
# 或 plugin_manager install_bundle 指向本目录绝对路径
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
安装并启用后刷新 Harness 页面,左侧栏出现 **插件市场** 图标。
|
|
115
|
+
|
|
116
|
+
## 验证结果
|
|
117
|
+
|
|
118
|
+
**接口契约(Node,直接访问生产环境)**
|
|
119
|
+
|
|
120
|
+
```bash
|
|
121
|
+
cd /Users/barret/workspace/dp-plugin-market-dsh
|
|
122
|
+
node tests/api-check.mjs # 16/16 passed
|
|
123
|
+
node tests/host-install-check.mjs # 6/6 PASS:下载→校验→解压→installBundle→npm 兜底→409 透传
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
- 列表 / 搜索 / `limit=1` 游标分页 / 详情 / 5 条错误路径 / 401 字符串错误全部通过
|
|
127
|
+
(数据跟随当前生产环境,不写死插件名)。
|
|
128
|
+
- 生产环境当前有 5 个公开插件:
|
|
129
|
+
- owner 上传:`dsh-science-workbench` / **BioMaster 任务总览**(science,0.7.0-biomaster.1)、
|
|
130
|
+
`dsh-virtual-cell` / **虚拟细胞工作台**(science,0.6.1)
|
|
131
|
+
- npm 源:`dsh-theme-palette`、`paper-read@0.1.2`、`dp-plugin-market@0.1.0`
|
|
132
|
+
`paper-read` 的最新版本直链为 `coral-prod…` OSS,Node 实下字节
|
|
133
|
+
**sha256 = `3507c0a24c1f1e1fb2bfd33a5b60101078c6b31f16bb62a8e9029e2edd6682a4`、650068 字节**,
|
|
134
|
+
与市场登记值一致;OSS 响应 `ACAO=null`(无 CORS),所以字节由 Host 读取。
|
|
135
|
+
- 详情页只保留「版本历史 / 依赖 / 运行要求」三个分区;「原始信息」已按需求移除。
|
|
136
|
+
409 相关检查在无产物时会自动跳过并断言错误码(此前实测过
|
|
137
|
+
`409 PLUGIN_ARTIFACT_NOT_IN_OBJECT_STORAGE`)。
|
|
138
|
+
- `tests/host-install-check.mjs` 用真实 Host 路由 + 已核验的测试产物驱动完整链路:
|
|
139
|
+
现取直链 → sha256/大小校验 → 安全解压 → `pluginManager.installBundle(packageDir, {enabled:true})`,
|
|
140
|
+
并覆盖 409 透传、npm 兜底 spec(`name@version`)与恶意包名拒绝。
|
|
141
|
+
|
|
142
|
+
**Harness 内实测(已安装到 desktop profile 并启用)**
|
|
143
|
+
|
|
144
|
+
- 左侧栏出现「插件市场」入口(`sidebar.panellist`, order 30),点击打开 `main` 槽位面板;
|
|
145
|
+
顶栏只保留「插件市场」标题。
|
|
146
|
+
- 列表 / 搜索(250ms 防抖)/ 分类 / 标签 / 游标分页 / 详情(版本/依赖/运行要求)均正常。
|
|
147
|
+
- 「安装」优先走 Host 校验后的市场产物;市场无产物(409)时自动改用 npm 源(pnpm),
|
|
148
|
+
成功时只保留一条「已安装并启用」toast;「仅下载 .tgz」把校验后的文件保存到
|
|
149
|
+
`<DSH_HOME>/dp-plugin-market/artifacts/`。
|
|
150
|
+
- 安装机制已用真实产物验证(解压后交给 DSH 插件管理器,`application: applied`);
|
|
151
|
+
npm 兜底也现场验证过并保留了 `@linyanzhi/dsh-mesh@0.3.46`(可在插件页关闭/卸载)。
|
|
152
|
+
- 在 DevTools Console 清空后触发热重载并完成列表加载 / 搜索 / 详情 / 下载交互,
|
|
153
|
+
console 消息数保持 0。
|
|
154
|
+
|
|
155
|
+
截图:[列表](docs/screenshots/01-market-list.png) ·
|
|
156
|
+
[详情(安装 / 仅下载)](docs/screenshots/02-plugin-detail.png) ·
|
|
157
|
+
[安装完成:DSH Mesh 已在「已安装插件」中启用](docs/screenshots/03-dsh-mesh-installed.png) ·
|
|
158
|
+
[插件页已安装并启用](docs/screenshots/04-installed-enabled.png)
|
|
159
|
+
|
|
160
|
+
产物缓存位置:`<DSH_HOME>/dp-plugin-market/artifacts/*.tgz`(校验后下载)与
|
|
161
|
+
`<DSH_HOME>/dp-plugin-market/packages/<name>-<version>-<sha8>/`(解压后供插件管理器安装)。
|