dsh-plugin-opc 0.1.25 → 0.1.26

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 CHANGED
@@ -1,245 +1,131 @@
1
1
  # OPC 插件新手上手指南
2
2
 
3
- 把公司的知识库、技能和业务工具放进 DeepSeek Harness(下文简称 **DSH**)。安装后,点右侧的 **OPC 知识库 / OPC 技能 / OPC MCP** 就能开始。
3
+ 通过 DeepSeek Harness(DSH)安装 `dsh-plugin-opc`,在右侧打开 **OPC 工作台**,即可进入企业知识库、技能、MCP 和应用。首次使用按 **安装插件 → 打开工作台 → 配置网关 → 企业登录 → 选择空间** 的顺序操作。
4
4
 
5
- **第一次使用,建议先完成“安装 → 找到入口 → 登录 → 用知识库问一个问题”。** 技能和 MCP 可以之后再看。本文图片取自本机 DSH Desktop `0.2.2-rc.1`、OPC 插件 `0.1.4`,摄于 2026-11-06。全部配图保留完整的 DSH 客户端窗口,可点击图片查看大图。截图中的账号、公司空间、资源名称用于演示,你的列表以公司授权为准。
5
+ 本文配图于 2026-11-19 从 DeepSeek Harness 桌面客户端重新采集,实装的 OPC 插件版本为 `0.1.23`。企业空间和资源列表以当前账号的授权为准。
6
6
 
7
- ## 先知道这三个功能是做什么的
8
-
9
- | 功能 | 用一句话理解 | 可以先试什么 |
10
- | --- | --- | --- |
11
- | **OPC 知识库** | 让 AI 查公司文档,再根据文档回答 | 报销材料、制度、流程、操作手册 |
12
- | **OPC 技能** | 给 AI 装一份特定任务的操作说明 | 比较两张 Excel 表有哪些差异 |
13
- | **OPC MCP** | 让 AI 通过公司提供的工具查询业务系统 | 根据商品内部 ID 查询价格,取决于公司开放的服务 |
14
-
15
- 知识库回答来自文档,实时商品价格来自业务系统。MCP 能否查询成功还取决于服务权限、参数和平台配置。
16
-
17
- ## 一、安装插件
18
-
19
- ### 第 1 步:打开「插件」页
20
-
21
- 打开 DSH,在窗口左侧点 **插件**。右上角可以看到黑色的 **添加插件** 按钮。
22
-
23
- ![第1步:左侧选择插件,右上角找到添加插件](docs/images/01-plugins.png)
24
-
25
- **已经装过?** 向下滚动,找 **已安装插件**。如果已有 `@opc/dsh-plugin-opc`,先看第 4 步核对版本和启用状态,避免反复安装同一版本。
26
-
27
- ### 第 2 步:选择「安装第三方插件」
28
-
29
- 点 **添加插件右边的小向下箭头**,在菜单中点 **安装第三方插件**。有些版本直接点击“添加插件”也会打开同一个窗口。
30
-
31
- ![第2步:在添加插件菜单中选择安装第三方插件](docs/images/02-install-menu.png)
32
-
33
- ### 第 3 步:输入包名,点「安装」
34
-
35
- 在弹出窗口的 **包名或地址** 输入框里直接输入 npm 包名(推荐),然后点底部黑色的 **安装**:
36
-
37
- ```text
38
- dsh-plugin-opc
39
- ```
40
-
41
- > 也可以通过 Git 地址安装:`https://github.com/shtokendance/dsh-plugin-opc.git#release`。但通过 npm 包名安装可在后续享受 DSH 内置的一键自动检测和在线更新功能。
42
-
43
- ![第3步:把包名输入框,点击底部安装](docs/images/03-install-address.png)
44
-
45
- 等待安装任务结束。网络慢时会花更长时间,可以展开 **查看安装详情** 查看进度。
46
-
47
- ### 第 4 步:确认装好了,再完整重启
48
-
49
- 回到 **插件 → 已安装插件**,找到并点击 `dsh-plugin-opc`。详细页应显示版本号,右上角的启用开关应处于打开状态。
50
-
51
- ![第4步:详细页显示插件名称、版本号和启用开关](docs/images/04-installed.png)
52
-
53
- 安装或更新后,**完整退出 DSH,再重新打开**。Mac 上可在屏幕最上方的 **DeepSeek Harness → 退出 DeepSeek Harness** 操作,或按 `⌘ Q`。只点窗口左上角红色圆点可能仅关闭窗口。
54
-
55
- ### 插件后续如何在线更新?
56
-
57
- 通过包名 `dsh-plugin-opc` 安装后,当有新版本发布时:
58
- 1. 打开 DSH 左侧 **插件** 页面。
59
- 2. 点击右上角的 **刷新** 按钮。
60
- 3. 如果有新版本,插件卡片及详情页右上角将直接亮起蓝色的 **【更新到 vX.X.X】** 按钮。
61
- 4. 点击更新按钮即可由客户端自动完成静默替换升级,**无需每次卸载重装**。
62
-
63
- > 本次截图时,本机已经装有同版本。重复安装任务显示“无法从依赖变更中确定安装了哪一个包”,随后在详细页核对到插件 `0.1.4` 已启用。首次安装成功请以任务结果、已安装列表和实际功能入口一起判断。遇到相同提示先核对版本,暂时无需反复重试。
64
-
65
- ## 二、装完以后,到哪里找?
66
-
67
- ### 第 5 步:进入聊天页,打开右侧栏
68
-
69
- 点左侧 **新会话**,再点 **窗口右上角靠边的小侧栏图标**。这是“打开右侧边栏”,鼠标停在上面会显示名称。图中鼠标所在处就是这个按钮。
70
-
71
- ![第5步:新会话界面右上角的侧栏图标](docs/images/05-open-sidebar.png)
72
-
73
- ### 第 6 步:认准三个 OPC 入口
74
-
75
- 右侧出现 **开始** 页面后,选择你要使用的功能。建议第一次先点 **OPC 知识库**。
76
-
77
- ![第6步:开始页中的OPC知识库、OPC技能、OPC MCP三个入口](docs/images/06-opc-entries.png)
78
-
79
- 已经打开一个功能时,可以点右侧面板顶部的 **+(新标签页)** 回到入口页,再打开另一个功能。三个功能可各占一个标签页,直接点击标签切换。
80
-
81
- ## 三、登录公司账号和选择空间
82
-
83
- ### 第 7 步:完成企业登录
84
-
85
- 第一次打开 OPC 面板,会看到 **连接 OPC 工作空间** 和 **企业微信 / SSO 登录** 按钮。
86
-
87
- 1. 点击 **企业微信 / SSO 登录**。
88
- 2. 默认浏览器会打开公司的登录页面。按页面提示扫码或完成公司登录。
89
- 3. 登录完成后,回到 DSH。面板显示账号和公司空间,表示登录成功。
90
- 4. 如果浏览器被关掉,可点面板中的 **重新打开授权页**。
91
-
92
- 如果你已经登录,面板会直接显示资源列表,可继续下一步。DSH 自己的模型账号和 OPC 企业账号各自登录;聊天生成回答还需要 DSH 中有可用模型。
93
-
94
- ### 第 8 步:选择有资源的企业空间
95
-
96
- 面板上方的下拉框用于选择企业空间,例如 **本来生活**、**技术交付中心**。切换后,知识库、技能和 MCP 列表随之更新。没有资源时先确认选对了空间,再联系公司管理员核对授权。
97
-
98
- ![第8步:OPC面板顶部选择空间,下方查看当前空间的资源](docs/images/07-space-and-knowledge.png)
99
-
100
- ## 四、先试一个最简单的知识库问题
101
-
102
- ### 第 9 步:在聊天框输入 @ 和库名
103
-
104
- 点击**聊天输入框**,先输入 `@`,再输入你知道的库名,例如 `财务`。出现菜单后,点击 **OPC 知识库** 分组里的 **财务制度与SOP**。如果你的公司使用其他名称,就输入那个名称。
105
-
106
- ![第9步:输入@财务后,点击OPC知识库分组中的候选](docs/images/10-mention-menu.png)
107
-
108
- ### 第 10 步:选中后,继续写问题,点蓝色发送箭头
109
-
110
- 选中库后,输入框会出现库名引用。**保留这段引用,在后面写问题**。可以复制这句作为第一次练习:
111
-
112
- > 请告诉我差旅报销需要准备哪些材料,并列出依据文档的名称。
113
-
114
- 然后点输入框**右下角的蓝色向上箭头**。
115
-
116
- ![第10步:引用后面填写问题,右下角蓝色箭头发送](docs/images/11-mention-question.png)
117
-
118
- ### 第 11 步:看回答,也看依据文档
119
-
120
- 等待 AI 回答。它会先检索文档,再读取相关内容。建议第一次要求它列出来源文档,方便自己核对。
121
-
122
- ![第11步:实际回答末尾列出了依据文档](docs/images/12-answer-sources.png)
123
-
124
- 图中回答来自本次本机实测。你也可以展开对话里的 **已调用工具**,查看 `opc_knowledge_search`(检索)和 `opc_knowledge_read`(读取)的结果。
125
-
126
- **下一条还要查同一个库?** 再选一次 `@库名`。一次提问选择一个库。希望本会话持续固定在某个库时,在右侧点击该库的 **限定问答范围**;取消时点 **取消限定**。引用是本轮选择,面板固定是本会话的持续选择。
127
-
128
- ## 五、自己查文档,不让 AI 总结
7
+ | 模块 | 可以做什么 |
8
+ | --- | --- |
9
+ | 知识库 | 查找企业文档,或在对话中让 AI 根据文档回答 |
10
+ | 技能 | 查找、安装和调用已开放的技能 |
11
+ | MCP | 查看企业服务和工具,按权限查询业务数据 |
12
+ | 应用 | 查看已部署应用,或导入本地源码部署新应用 |
129
13
 
130
- ### 第 12 步:选库,填关键词,点击「检索」
14
+ ## 一、按包名安装插件
131
15
 
132
- 在右侧 **OPC 知识库** 面板中,找到目标库,点 **检索此库**。下方的“检索知识库”会切换到该库。在 **输入要查找的内容** 框里填 `差旅` 等关键词,点旁边蓝色 **检索**。
16
+ 1. 打开 DSH,点击左侧 **插件**,然后点击右上角 **添加插件** 旁的下拉箭头。
133
17
 
134
- ![第12步:检索此库、关键词输入框和检索按钮的位置](docs/images/08-search-results.png)
18
+ ![DSH 插件页和右上角的添加插件按钮](docs/images/workbench/01-plugins.jpg)
135
19
 
136
- 注意区分两个输入框:上面的 **按名称搜索** 用于找“库”,下面的 **输入要查找的内容** 用于查“库里的文档”。
20
+ 2. 点击 **安装第三方插件**。
137
21
 
138
- ### 第 13 步:点击结果中的文档名,打开正文
22
+ ![添加插件菜单中的安装第三方插件选项](docs/images/workbench/02-install-menu.jpg)
139
23
 
140
- 检索结果会显示文档名称和命中片段。点击**文档名按钮**,正文显示在面板下方;需要时在右侧面板内向下滚动。阅读结束,点击 **关闭正文**。
24
+ 3. 在 **包名或地址** 输入 `dsh-plugin-opc`,确认 **安装源** 为 **npm 官方源**,点击 **安装**。
141
25
 
142
- ![第13步:正文预览和关闭正文按钮](docs/images/09-document.png)
26
+ ![输入 dsh-plugin-opc,安装源为 npm 官方源](docs/images/workbench/03-install-package.jpg)
143
27
 
144
- ## 六、安装并使用一项技能
28
+ 4. 等待弹窗显示 **已安装**,然后点击 **立即启用**。以结果弹窗中的版本为准。此次安装器显示新版仍在供应链观察期,按包名实际安装了 `0.1.23`。
145
29
 
146
- 技能适合完成具体任务。第一次建议选 **excel-compare** 这样的表格比对技能。
30
+ ![安装完成弹窗显示实际版本和立即启用按钮](docs/images/workbench/04-install-result.jpg)
147
31
 
148
- ### 第 14 步:打开 OPC 技能,点击「下载安装」
32
+ 5. 回到 **插件 → 已安装插件**,确认 `dsh-plugin-opc` 右侧开关已打开。已经装好的用户可在这里直接核对状态。有更新时,插件页会标记 **可更新**。
149
33
 
150
- 点面板顶部 **+ → OPC 技能**。在当前空间的列表里找到技能,先阅读用途说明,再点该技能下面的 **下载安装**。下图用尚未安装的 PPT 技能展示按钮位置;后两张图用已经安装的 excel-compare 展示启用和调用效果。
34
+ ![已安装插件列表中 dsh-plugin-opc 的启用开关](docs/images/workbench/05-plugin-enabled.jpg)
151
35
 
152
- ![第14步:完整客户端中未安装技能的下载安装按钮](docs/images/13-skills-install.png)
36
+ ## 二、打开 OPC 工作台
153
37
 
154
- ### 第 15 步:确认显示「已启用」
38
+ 1. 点击左侧 **新会话**,再点客户端右上角的 **打开右侧边栏** 图标。
155
39
 
156
- 安装完成后,技能下方应显示 **已启用 · 输入 / 调用**,操作按钮变为 **停用** 和 **卸载**。只安装一次即可,之后可反复使用。停用后能重新启用,卸载后需要重新下载。
40
+ ![新会话右上角的右侧边栏入口](docs/images/workbench/06-open-sidebar.jpg)
157
41
 
158
- ![第15步:安装完成后的已启用状态和管理按钮](docs/images/14-skill-enabled.png)
42
+ 2. 在右侧 **开始** 页点击 **OPC 工作台**。右栏已有该标签时,直接点击 **OPC 工作台** 标签。
159
43
 
160
- ### 第 16 步:回到聊天框,输入 / 和技能名
44
+ ![右侧开始页中的 OPC 工作台入口](docs/images/workbench/07-workbench-entry.jpg)
161
45
 
162
- 输入 `/excel-compare`,在弹出的 **技能** 候选中选择 `excel-compare`。该菜单显示 `[OPC]`,帮助你识别公司技能。
46
+ 3. 登录后,工作台首页提供 **知识库、技能、MCP、应用** 四个入口。进入模块后,点击面板左上角的 **当前模块名称及下拉箭头**,可以在同一个标签页内切换模块或返回首页。
163
47
 
164
- ![第16步:聊天框输入斜杠唤起已安装技能](docs/images/15-skill-slash.png)
48
+ ![OPC 工作台首页的四个模块入口](docs/images/workbench/08-workbench-home.jpg)
165
49
 
166
- 选择后,描述你的任务,例如:
50
+ ![展开 OPC 工作台左上角的模块切换菜单](docs/images/workbench/10-switch-module.jpg)
167
51
 
168
- > 请按商品编码比对这两张 Excel,列出只在第一张表、只在第二张表和字段不同的记录。缺少文件时请先问我。
52
+ ## 三、配置正式网关并登录
169
53
 
170
- 需要处理文件时,点击聊天输入框左下角 **+** 按 DSH 提示添加文件,并告诉 AI 比较哪一列。图中只演示技能安装和唤起,文件处理结果取决于实际文件与所选技能。
54
+ 1. 在 OPC 工作台点右上角 **设置**。如果还没登录,也可以点登录页上的 **平台设置**。
55
+ 2. 在 **统一平台网关** 下,把 **网关服务地址 (Platform Base)** 填为 `https://aiwork.benlai.com`。
56
+ 3. 点击 **测试连接**。看到 **连接成功(HTTP 200)** 后,点击 **保存并立即生效**,再点 **返回**。
171
57
 
172
- ## 七、MCP:查看公司业务系统提供了哪些工具
58
+ ![正式网关地址、连接测试结果和保存按钮](docs/images/workbench/09-platform-gateway.jpg)
173
59
 
174
- MCP 是公司开放给 AI 的业务工具入口,例如查商品价格。下面的步骤适合在管理员已提供服务 ID 和查询参数后使用。
60
+ 4. 显示 **连接 OPC 工作空间** 时,点击 **企业微信 / SSO 登录**,在浏览器完成授权后回到 DSH。浏览器关闭时,可点 **重新打开授权页**。如果切换了平台网关,使用新平台的账号重新登录。
61
+ 5. 在知识库、技能或 MCP 页面,从右上角选择 **企业空间**。如列表未更新,点击 **刷新**。OPC 的企业登录与 DSH 的模型登录是两套设置。在对话里提问时,还需要选择可用的 DSH 模型。
175
62
 
176
- ### 第 17 步:打开 OPC MCP,选对空间
63
+ ## 四、使用企业知识库
177
64
 
178
- 点右侧顶部 **+ → OPC MCP**。有些空间没有 MCP 服务,可以先切换到公司管理员指定的空间。本机示例在 **技术交付中心**,可见 **搜索服务** 和 **erp 商品价格服务**。
65
+ 从工作台首页或左上角菜单进入 **知识库**。
179
66
 
180
- ![第17步:选择提供MCP服务的空间,查看服务列表](docs/images/16-mcp-list.png)
67
+ - **文档全文检索模式**用于找文档。选择检索范围,输入关键词,点击 **开始检索**。看到结果后点击文档标题,可打开正文。
68
+ - **知识库目录筛选模式**用于找库。按库名或描述筛选,在目标卡片上点击 **检索此库**,即可切回全文检索并选定该库。
181
69
 
182
- ### 第 18 步:展开服务,阅读工具说明
70
+ ![知识库全文检索模式及检索范围](docs/images/workbench/11-knowledge-search.jpg)
183
71
 
184
- 点击服务名前面的 **小三角**。下方会显示工具名、用途和参数。例如 `post_ProductPrice_Get` 的参数是 `productSysNo`,要求商品内部的整数 ID。
72
+ ![按名称或描述筛选知识库目录](docs/images/workbench/12-knowledge-catalog.jpg)
185
73
 
186
- ![第18步:展开商品价格服务,查看工具名、参数和在线调试入口](docs/images/17-mcp-tool.png)
74
+ 在 DSH 对话中使用知识库时,输入 `@` 和库名,在 **OPC 知识库** 候选中选中目标库,再继续输入问题。可试问「差旅报销需要准备哪些材料?请列出依据文档的名称」。如需让当前会话持续使用某个库,可在卡片上点 **限定问答范围**,使用完毕后点 **取消限定**。
187
75
 
188
- ### 第 19 步:第一次使用,请先向管理员要这三项
76
+ 本次正式环境的测试账号没有可见知识库。在 **当前空间全部知识库** 下尝试检索「报销流程」,客户端显示 `INVALID_REQUEST`。
189
77
 
190
- | 需要的信息 | 如何理解 |
191
- | --- | --- |
192
- | 服务 ID(service_id) | 平台里登记的准确服务标识,请管理员复制完整值 |
193
- | 工具名(tool_name) | 上图的 `post_ProductPrice_Get` 就是工具名 |
194
- | 必填参数 | 比如商品内部 ID,以工具说明为准 |
78
+ ![本次测试账号的空目录与全文检索错误](docs/images/workbench/13-knowledge-query-result.jpg)
195
79
 
196
- 当前插件的聊天工具需要准确的服务 ID,面板没有显示这个字段,模型也没有服务目录查询工具。**请直接找管理员索要完整值**;只告诉 AI“商品中心”会使它缺少调用信息。
80
+ ## 五、安装并使用技能
197
81
 
198
- 拿到信息后,在聊天框发送下面的话,把 `实际服务ID` 替换成管理员给你的值:
82
+ 1. 进入 **技能**,输入技能名称或关键词,点击 **立即检索**。可以用 **全部 / 已安装 / 未安装** 切换列表。
83
+ 2. 有可用技能时,在技能卡片点 **下载安装**,等待卡片显示 **已启用**。
84
+ 3. 回到 DSH 对话,输入 `/` 和技能名,从候选中选中它,再描述任务。例如安装了 `excel-compare` 后,输入 `/excel-compare`,上传两份表格并说明按哪一列比对。
199
85
 
200
- > 请使用 opc_mcp_invoke,service_id 为「实际服务ID」,tool_name 为 post_ProductPrice_Get,arguments 为 {"productSysNo":2427240}。查询商品价格,调用失败就显示实际错误,请不要猜测服务ID或工具名。
86
+ ![OPC 技能页的搜索框和安装状态筛选](docs/images/workbench/14-skills.jpg)
201
87
 
202
- 其中 `2427240` 只是示例,请换成管理员确认的商品内部 ID。
88
+ ## 六、查看并调用 MCP 工具
203
89
 
204
- ### 第 20 步:如何判断查询有没有成功
90
+ 1. 进入 **MCP**,按服务或工具名称搜索。可用 **全部 / 已连接 / 未挂载** 筛选状态。
91
+ 2. 在可见服务的卡片上展开 **查看可用工具与调试**,核对工具名、用途和参数。选择已连接的只读工具做第一次查询。
92
+ 3. 在 DSH 对话里说明要用哪个服务、哪个工具以及查询条件。需要排查单个工具时,可展开 **在线调试调用**,按工具定义输入 JSON,再点 **调用**。查看工具返回中的业务数据或实际错误。若客户端弹出审批,先阅读操作和参数。
205
93
 
206
- 展开对话里的 **已调用工具**,找到 `opc_mcp_invoke`。检查返回的是实际业务数据还是错误。平台要求审批时,先阅读工具和参数,再决定是否允许。高敏操作的审批是否出现,由平台策略决定。
94
+ ![OPC MCP 页的服务搜索和连接状态筛选](docs/images/workbench/15-mcp.jpg)
207
95
 
208
- 右侧 **在线调试调用** 适合管理员排查:在参数框填写 JSON,再点 **调用**。普通使用者优先按上一段在聊天框提问。
96
+ 如果需要显式调用 `opc_mcp_invoke`,应提供准确的 `service_id`、`tool_name` 和 `arguments`。缺少服务 ID 时,可以向平台管理员查询。
209
97
 
210
- 目前测试服缺少审批参数加密配置,需要审批的调用可能返回 `INTEGRATION_ARGS_KEY_REQUIRED`,需要平台管理员补齐配置。**本指南的 MCP 截图演示目录和参数查看,尚无真实业务成功结果截图。**
98
+ **本次验证范围**:正式网关返回 HTTP 200。在测试账号唯一可选的企业空间内,知识库、技能和 MCP 目录均显示 0 项。已操作三个模块的页面和检索入口,技能安装、MCP 工具调用和知识库问答需要有可见资源的账号才能继续验证。
211
99
 
212
- ## 八、常见问题:先看这里
100
+ ## 七、常见问题
213
101
 
214
- | 遇到的情况 | 先做什么 |
102
+ | 遇到的情况 | 处理方法 |
215
103
  | --- | --- |
216
- | 安装页说“无法从依赖变更中确定安装了哪一个包” | 先回“插件 → 已安装插件”查看是否已装同版本。已装好就完整重启后查看功能入口。 |
217
- | 装完却看不到右边的 OPC | 点左侧“新会话”,点窗口右上角侧栏图标,再在“开始”页找 OPC。仍没有时核对插件启用开关,然后完整重启。 |
218
- | 没有可用工作区 | 使用 DSH 左侧“工作区”旁的添加按钮,按客户端引导选一个本机文件夹。公司已有工作区时可直接选择。 |
219
- | 输入 @ 后找不到知识库 | 确认 OPC 已登录、空间正确,再输入库名的一部分。更新后完整重启 DSH。 |
220
- | 只看到文件和对话候选 | 确认 OPC 插件版本与后台已更新。0.1.4 对旧宿主会隐藏 OPC 候选,完整退出再打开。 |
221
- | 点击登录提示 HTTP 404 | 更新 OPC 插件后完整重启 DSH,让后台注册新版登录路由。 |
222
- | 浏览器没有打开或被关了 | 看 OPC 面板中的“重新打开授权页”,或取消后重新发起登录。 |
223
- | 登录后是空列表 | 核对企业空间。仍为空时请管理员确认账号和资源授权。 |
224
- | 聊天框提示选择模型 | 在输入框下方选择模型,并按 DSH 自身引导登录模型账号。 |
225
- | AI 一直问 service_id | 请公司管理员提供准确服务 ID。当前聊天工具需要这个字段。 |
226
- | MCP 返回 INTEGRATION_ARGS_KEY_REQUIRED | 把错误截图发给平台管理员处理;稍后再试,避免反复提交同一次操作。 |
104
+ | 安装结果显示的版本比预期旧 | 查看安装器的版本说明。若提示 `minimumReleaseAge`,以安装结果及已安装插件详情显示的版本为准。 |
105
+ | 右侧找不到 OPC 工作台 | 核对 **插件 → 已安装插件** 的启用开关,再进入新会话打开右侧边栏。在 **开始** 页仍找不到入口时,完整退出 DSH 后重新打开。 |
106
+ | 企业授权页关闭了 | 点 **重新打开授权页**,或取消后重新发起企业登录。 |
107
+ | 登录后列表为空,或输入 `@` 找不到库 | 核对右上角的企业空间并刷新。如仍无资源,请管理员确认当前账号的资源授权。 |
108
+ | 知识库检索显示 `INVALID_REQUEST` | 确认列表中有可见知识库,选择具体库再检索。如果选库后仍报错,请提供操作时间、空间和错误码供管理员查看。 |
109
+ | MCP 返回 `INTEGRATION_ARGS_KEY_REQUIRED` | 把错误码和工具名交给平台管理员排查。 |
110
+ | 对话无法发送 | 检查 DSH 是否已选择可用模型,并按客户端提示完成模型登录。 |
227
111
 
228
112
  ## OPC 应用部署
229
113
 
230
- 从已打开的 DSH 对话进入右侧的 **OPC 应用**,选择 **部署新应用**,导入源码 ZIP 或填写本机源码目录。AI 在独立副本上分析和提出容器改造。核对文件改动后生成部署包,再填写运行配置、按字段选择 Platform 开放的资源,并确认发布。
114
+ 在 **OPC 工作台 → 应用** 打开应用中心,点击 **新建应用**。填写应用名称和访问子域名,选择分析模型,再选择**源码文件夹**或 **ZIP 压缩包**,也可以输入本机完整路径。点击 **创建并开始 AI 分析** 后,AI 在源码副本上分析和提出容器改造。核对改造方案与部署配置后,再确认发布。
115
+
116
+ ![新建并部署应用向导中的源码文件夹与 ZIP 入口](docs/images/workbench/16-app-source.jpg)
231
117
 
232
118
  可以单独选择改造模型。向导会保存部署配置草稿,并可在发布前预览完整应用技能。服务器启动后,向导自动发起首次业务验证,也可手动检查。应用版本、制品摘要、健康身份和只读业务验证都通过后,在对话框输入 `/app-<应用标识>` 选择技能。纯页面应用需要打开页面并确认。普通 HTTP/JSON 接口可作为技能调用,写操作会触发 DSH 审批。应用卡片可启用或停用本地技能,升级和回滚会保留该设置。
233
119
 
234
120
  改造阶段会识别应用的登录方式和权限规则。受保护的接口在部署后填写应用账号、密码或现有会话,点击 **仅重试业务验证** 即可复测。默认仅用于本次验证。勾选保存后,通过验证的凭据由 DSH 凭据服务保管,可用于对话调用。
235
121
 
236
- 应用创建者可在 **管理与回退** 查看日志、版本和存储卷,下载历史制品、单卷备份或整应用备份。平台文件直接保存到运行 DSH 的电脑的下载目录。向导内导出的本地交付包仍有 64 MiB 单文件上限。配置变化后重新验证业务。回滚恢复应用版本和运行配置,保留卷中的业务数据。
122
+ 应用创建者可从应用卡片进入 **详情** 或 **版本与回退**,查看日志、版本和存储卷,下载历史制品、单卷备份或整应用备份。平台文件直接保存到运行 DSH 的电脑的下载目录。向导内导出的本地交付包仍有 64 MiB 单文件上限。配置变化后重新验证业务。回滚恢复应用版本和运行配置,保留卷中的业务数据。
237
123
 
238
124
  需要支持 `/integration/v1/apps` 的 Platform。企微登录后即可部署,所有登录用户共享应用列表。部署资源由 Platform 的 `app_deploy.enterprise_deploy_resources` 配置提供。应用目录和部署任务独立于知识空间。DSH Desktop 使用自带 Python,独立 Web 运行需在 PATH 提供 Python 3.9 或更新版本。
239
125
 
240
126
  ## 给管理员和开发者
241
127
 
242
- 插件通过公开接口接入 DSH。企业认证使用独立凭据命名空间,OPC 服务地址由 `platformBaseUrl` 配置。默认域名是 `https://shtokendance.benlai.com`。参见[配置示例](config/overlay.example.yml)、[一期验收记录](docs/acceptance-matrix.md)。
128
+ 插件通过公开接口接入 DSH。企业认证使用独立凭据命名空间,OPC 服务地址由 `platformBaseUrl` 配置。默认域名是 `https://aiwork.benlai.com`。参见[配置示例](config/overlay.example.yml)、[一期验收记录](docs/acceptance-matrix.md)。
243
129
 
244
130
  ## 本地开发
245
131
 
@@ -255,4 +141,4 @@ npx tsc -p tsconfig.client.json
255
141
  npm run build
256
142
  ```
257
143
 
258
- 链接和类型配置都生成在插件目录内。重新执行 `npm ci` 后需要重新链接。开发时可通过 DSH CLI 的 `web --patch` 加载外部 YAML,把插件入口指向构建后的 `lib/index.js`。OPC 服务域名由 `platformBaseUrl` 配置,默认是 `https://shtokendance.benlai.com`。参见[配置示例](config/overlay.example.yml)和[一期验收记录](docs/acceptance-matrix.md)。
144
+ 链接和类型配置都生成在插件目录内。重新执行 `npm ci` 后需要重新链接。开发时可通过 DSH CLI 的 `web --patch` 加载外部 YAML,把插件入口指向构建后的 `lib/index.js`。OPC 服务域名由 `platformBaseUrl` 配置,默认是 `https://aiwork.benlai.com`。参见[配置示例](config/overlay.example.yml)和[一期验收记录](docs/acceptance-matrix.md)。
@@ -3,7 +3,7 @@
3
3
  # 本地开发替换为插件 lib/index.js 的绝对路径。
4
4
  name: 'dsh-plugin-opc'
5
5
  config:
6
- platformBaseUrl: https://shtokendance.benlai.com
6
+ platformBaseUrl: https://aiwork.benlai.com
7
7
  clientId: work-desktop
8
8
  # 留空使用 DSH home;可显式指定本机受管技能目录。
9
9
  dataHome: ''
Binary file
package/lib/client.js CHANGED
@@ -56142,7 +56142,7 @@ var SLUG_RE = /^[a-z][a-z0-9-]{2,39}$/;
56142
56142
  var MAX_ZIP_BYTES = 64 * 1024 * 1024;
56143
56143
  var DRAFT_DISMISS_STORAGE_PREFIX = "opc-apps-dismissed-draft:";
56144
56144
  var DEFAULT_OPC_CONFIG = {
56145
- appDomainRoot: "10.101.102.116.nip.io:8080",
56145
+ appDomainRoot: "ai.benlai.com",
56146
56146
  defaultPort: 8080,
56147
56147
  platformBaseUrl: ""
56148
56148
  };
@@ -58318,11 +58318,11 @@ function OpcSettingsPanel({
58318
58318
  const [loading, setLoading] = (0, import_react9.useState)(true);
58319
58319
  const [saving, setSaving] = (0, import_react9.useState)(false);
58320
58320
  const [testing, setTesting] = (0, import_react9.useState)(false);
58321
- const [platformBase, setPlatformBase] = (0, import_react9.useState)("https://shtokendance.benlai.com");
58321
+ const [platformBase, setPlatformBase] = (0, import_react9.useState)("https://aiwork.benlai.com");
58322
58322
  const [appDomainRoot, setAppDomainRoot] = (0, import_react9.useState)("");
58323
58323
  const [appDefaultPort, setAppDefaultPort] = (0, import_react9.useState)("8080");
58324
- const [defaultPlatformBase, setDefaultPlatformBase] = (0, import_react9.useState)("https://shtokendance.benlai.com");
58325
- const [defaultAppDomainRoot, setDefaultAppDomainRoot] = (0, import_react9.useState)("10.101.102.116.nip.io:8080");
58324
+ const [defaultPlatformBase, setDefaultPlatformBase] = (0, import_react9.useState)("https://aiwork.benlai.com");
58325
+ const [defaultAppDomainRoot, setDefaultAppDomainRoot] = (0, import_react9.useState)("ai.benlai.com");
58326
58326
  const [testResult, setTestResult] = (0, import_react9.useState)(null);
58327
58327
  const [error62, setError] = (0, import_react9.useState)("");
58328
58328
  const [notice, setNotice] = (0, import_react9.useState)(null);
@@ -58335,9 +58335,9 @@ function OpcSettingsPanel({
58335
58335
  setError("");
58336
58336
  try {
58337
58337
  const cfg = JSON.parse(await api.opcConfigGet());
58338
- setDefaultPlatformBase(cfg.default_platform_base || "https://shtokendance.benlai.com");
58339
- setDefaultAppDomainRoot(cfg.default_app_domain_root || "10.101.102.116.nip.io:8080");
58340
- setPlatformBase(cfg.platform_base || cfg.default_platform_base || "https://shtokendance.benlai.com");
58338
+ setDefaultPlatformBase(cfg.default_platform_base || "https://aiwork.benlai.com");
58339
+ setDefaultAppDomainRoot(cfg.default_app_domain_root || "ai.benlai.com");
58340
+ setPlatformBase(cfg.platform_base || cfg.default_platform_base || "https://aiwork.benlai.com");
58341
58341
  setAppDomainRoot(cfg.app_domain_root ?? "");
58342
58342
  setAppDefaultPort(String(cfg.app_default_port ?? 8080));
58343
58343
  } catch (e) {
package/lib/index.js CHANGED
@@ -1253,8 +1253,8 @@ import { randomUUID as randomUUID3 } from "node:crypto";
1253
1253
  import { existsSync, readFileSync } from "node:fs";
1254
1254
  import { mkdir as mkdir2, rename as rename2, writeFile as writeFile2 } from "node:fs/promises";
1255
1255
  import { join as join2 } from "node:path";
1256
- var DEFAULT_PLATFORM_BASE = "https://shtokendance.benlai.com";
1257
- var DEFAULT_APP_DOMAIN_ROOT = "10.101.102.116.nip.io:8080";
1256
+ var DEFAULT_PLATFORM_BASE = "https://aiwork.benlai.com";
1257
+ var DEFAULT_APP_DOMAIN_ROOT = "ai.benlai.com";
1258
1258
  var DEFAULT_APP_DEFAULT_PORT = 8080;
1259
1259
  function normalizePlatformBaseUrl(raw) {
1260
1260
  const input = typeof raw === "string" ? raw.trim() : "";
@@ -1264,7 +1264,7 @@ function normalizePlatformBaseUrl(raw) {
1264
1264
  function sanitizeDomainRoot(raw) {
1265
1265
  const trimmed = String(raw ?? "").trim().replace(/^https?:\/\//i, "").replace(/\/+$/, "").trim();
1266
1266
  if (trimmed && /[\s/?#]/.test(trimmed)) {
1267
- throw new Error("\u5E94\u7528\u5185\u7F51\u6839\u57DF\u540D\u540E\u7F00\u683C\u5F0F\u65E0\u6548\uFF0C\u8BF7\u586B\u5199\u5982 10.101.102.116.nip.io:8080");
1267
+ throw new Error("\u5E94\u7528\u5185\u7F51\u6839\u57DF\u540D\u540E\u7F00\u683C\u5F0F\u65E0\u6548\uFF0C\u8BF7\u586B\u5199\u5982 ai.benlai.com");
1268
1268
  }
1269
1269
  return trimmed;
1270
1270
  }
@@ -2283,7 +2283,7 @@ ${combinedLog}` : combinedLog).slice(-24e3);
2283
2283
  }
2284
2284
  const defaultPort = Number.isInteger(this.options.appDefaultPort) && this.options.appDefaultPort >= 1 && this.options.appDefaultPort <= 65535 ? this.options.appDefaultPort : 8080;
2285
2285
  return {
2286
- appDomainRoot: appDomainRoot || "10.101.102.116.nip.io:8080",
2286
+ appDomainRoot: appDomainRoot || DEFAULT_APP_DOMAIN_ROOT,
2287
2287
  defaultPort,
2288
2288
  platformBaseUrl: this.core.auth?.http?.base?.toString()?.replace(/\/+$/, "") ?? ""
2289
2289
  };
@@ -4454,7 +4454,7 @@ var TYPERT = { package: contribution.package, face: "host", schemas: [], invocat
4454
4454
  // src/index.ts
4455
4455
  var name = "dsh-plugin-opc";
4456
4456
  var inject = ["credentials", "authorization", "skills", "tools", "agents", "approval", "typert", "llm"];
4457
- var Config = z2.object({ platformBaseUrl: z2.string().default("https://shtokendance.benlai.com"), clientId: z2.string().default("work-desktop"), dataHome: z2.string().default(""), appDomainRoot: z2.string().default(""), appDefaultPort: z2.number().default(8080) });
4457
+ var Config = z2.object({ platformBaseUrl: z2.string().default("https://aiwork.benlai.com"), clientId: z2.string().default("work-desktop"), dataHome: z2.string().default(""), appDomainRoot: z2.string().default(""), appDefaultPort: z2.number().default(8080) });
4458
4458
  function apply(ctx, config) {
4459
4459
  const key = credentialKey(name, "enterprise");
4460
4460
  const home = config.dataHome || resolveDshHome();
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-plugin-opc",
3
- "version": "0.1.25",
3
+ "version": "0.1.26",
4
4
  "description": "OPC Enterprise Plugin for DeepSeek Harness (DSH)",
5
5
  "type": "module",
6
6
  "publishConfig": {
@@ -52,6 +52,7 @@
52
52
  "LICENSE-Inter.txt",
53
53
  "runtime",
54
54
  "README.md",
55
+ "docs/images/workbench/*.jpg",
55
56
  "config/overlay.example.yml"
56
57
  ],
57
58
  "dsh": {
@@ -23,7 +23,7 @@ from app_delivery.scripts import delivery
23
23
 
24
24
  def fetch_platform_dockerfile_template(platform_url: str, language: str, version: str = "") -> dict:
25
25
  """Step 2 helper: fetch Dockerfile template for (language, version) from platform-opc deploy-opc DB."""
26
- base = (platform_url or "https://shtokendance.benlai.com").rstrip("/")
26
+ base = (platform_url or "https://aiwork.benlai.com").rstrip("/")
27
27
  query = urllib.parse.urlencode({"language": language.strip(), "version": version.strip()})
28
28
  url = f"{base}/api/v1/apps/dockerfile-templates?{query}"
29
29
  req = urllib.request.Request(url, headers={"Accept": "application/json"}, method="GET")