bkn-dsh 有中文文档吗？

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

bkn-dsh 还在维护吗？

GitHub 2 星。最近一次上游提交在 2026/9/24。

openbkn-ai/bkn-dsh

Q: bkn-dsh 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；暂不能直接安装（需源码编译或环境不满足）：缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装。

DeepSeek Harnessspec-screened扫描：中风险在 GitHub 查看 ↗

需源码安装

将受治理的 OpenBKN 业务知识带入 DeepSeek Harness 对话。

暂不能直接安装（需源码编译或环境不满足）：缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装。 · 最近上游提交 2026/9/24 · 已提供中文文档

OpenBKN 的 DeepSeek Harness Web UI 插件使业务用户能够安全、准确、可靠地利用企业的业务知识网络来完成业务分析和决策。

综合分

38.1

GitHub 分

38.1

用户评分

—

★ Stars

周下载量

—

安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）

dsh plugin --profile web add openbkn-ai/bkn-dsh

缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装，改用 GitHub 源安装

信任档位：已验证本站已于 3 天前真实安装成功（L4 · 真实安装）

是什么: dsh 原生插件 · ui
装得上吗: 本站已真实安装成功（L4 · 真实安装，非静态推断）
安全吗: 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
还在维护吗: 活跃：最近一次提交在 1 天前

档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。验证判据与等级说明 →

🟢实装验证通过· 2026/9/22

由本站实装验证器在真实 dsh 环境安装成功，非静态推断。

数据截至 2026/9/25（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）

安装兼容性检查需源码安装

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✗npm 包@openbkn/bkn-dsh-workspace（未发布到 npm，仅可源码安装）

✓Node 引擎未声明 engines.node

✓dsh CLI 依赖未声明 dsh 版本约束

✗入口文件缺少入口声明

缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装

验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/22 11:28:35

依赖的 DSH / Cordis 模块

@deepseek-ai/dsh-typert-generator

用户评分

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

订阅周报，不错过优质插件更新

每周一封 · 高评分插件 + 新用户活动

装之前先看这里

ℹ️ 暂无已知风险记录。注意：dsh 与插件都处于 developer-preview 阶段，装任何插件前建议先备份 ~/.dsh 配置，出问题好回滚。

装完遇到问题了？反馈一下（可选填报错关键词）：

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

v2.7.0

🟡 扫描：中风险尚无人工评估

静态扫描发现可执行固定命令，或会写入/删除本地文件，或读取剪贴板与密钥类环境变量。

可执行外部命令删除本地文件写入本地文件读取本地文件（只读）发起外部网络请求

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

执行外部命令固定命令
compat/dsh-0.1.2-rc.1/apply.mjs:12
return execFileSync('git', args, { cwd: target, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }).trim()
执行外部命令固定命令
compat/dsh-0.1.2-rc.1/apply.mjs:20
const result = execFileSync('git', args, {
读取本地文件
compat/dsh-0.1.2-rc.1/apply.mjs:32
if (!existsSync(target)) throw new Error(`DSH target is not a Git worktree: ${target}`)
读取本地文件
compat/dsh-0.1.2-rc.1/apply.mjs:52
const manifest = suppliedManifest ?? JSON.parse(readFileSync(resolve(root, 'manifest.json'), 'utf8'))
读取本地文件
compat/dsh-0.1.2-rc.1/apply.mjs:62
const digest = createHash('sha256').update(readFileSync(path)).digest('hex')
写入本地文件
compat/dsh-0.1.2-rc.1/apply.mjs:89
copyFileSync(resolve(target, indexPath), temporaryIndex)
删除本地文件递归
compat/dsh-0.1.2-rc.1/apply.mjs:104
rmSync(temporaryDirectory, { recursive: true, force: true })
执行外部命令固定命令
compat/dsh-0.1.6-alpha.2/apply.mjs:12
return execFileSync('git', args, { cwd: target, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }).trim()
执行外部命令固定命令
compat/dsh-0.1.6-alpha.2/apply.mjs:20
const result = execFileSync('git', args, {
读取本地文件
compat/dsh-0.1.6-alpha.2/apply.mjs:32
if (!existsSync(target)) throw new Error(`DSH target is not a Git worktree: ${target}`)
读取本地文件
compat/dsh-0.1.6-alpha.2/apply.mjs:52
const manifest = suppliedManifest ?? JSON.parse(readFileSync(resolve(root, 'manifest.json'), 'utf8'))
读取本地文件
compat/dsh-0.1.6-alpha.2/apply.mjs:62
const digest = createHash('sha256').update(readFileSync(path)).digest('hex')
写入本地文件
compat/dsh-0.1.6-alpha.2/apply.mjs:89
copyFileSync(resolve(target, indexPath), temporaryIndex)
删除本地文件递归
compat/dsh-0.1.6-alpha.2/apply.mjs:104
rmSync(temporaryDirectory, { recursive: true, force: true })
读取本地文件
docs/eval/run-eval.mjs:32
const doc = load(readFileSync(SET_PATH, 'utf8'))
读取本地文件
docs/eval/run-eval.mjs:87
const raw = JSON.parse(readFileSync(resolve(process.cwd(), answersPath), 'utf8'))
写入本地文件
docs/eval/run-eval.mjs:114
mkdirSync(dirname(target), { recursive: true })
写入本地文件
docs/eval/run-eval.mjs:125
writeFileSync(target, `${lines.join('\n')}\n`)
读取本地文件
packages/openbkn-business-context/src/business-context-service.ts:474
const canonicalPath = await realpath(path)
读取本地文件
packages/openbkn-business-context/src/business-context-service.ts:475
if (!(await stat(canonicalPath)).isDirectory()) throw new Error('OpenBKN workspace must be an existing local directory.')
发起网络请求
packages/openbkn-business-context/src/platform-reader.ts:83
return await this.request(path, { method: 'GET' }, signal, options)
发起网络请求
packages/openbkn-business-context/src/platform-reader.ts:87
return await this.request(path, {
读取本地文件
runtime/bootstrap-openbkn-plugin.mjs:15
if (!existsSync(profileManifest) || !existsSync(pluginManifest)) return false
读取本地文件
runtime/bootstrap-openbkn-plugin.mjs:31
parsed = JSON.parse(readFileSync(path, 'utf8'))
读取本地文件
runtime/bootstrap-openbkn-plugin.mjs:48
if (existsSync(profile)) throw new Error('OpenBKN runtime home has a web profile without the matching bundled plugin.')
写入本地文件
runtime/bootstrap-openbkn-plugin.mjs:52
mkdirSync(resolve(home), { recursive: true })
读取本地文件
runtime/bundle-portability.mjs:17
for (const entry of readdirSync(directory, { withFileTypes: true })) {
读取本地文件
runtime/bundle-portability.mjs:33
const stat = statSync(path)
读取本地文件
runtime/bundle-portability.mjs:38
const buffer = readFileSync(path)
删除本地文件
runtime/bundle-portability.mjs:57
rmSync(path)
删除本地文件递归
runtime/bundle-portability.mjs:153
rmSync(path, { recursive: true, force: true })
读取本地文件
runtime/bundle-portability.mjs:154
symlinkSync(linkTarget, path, statSync(target).isDirectory() ? 'dir' : 'file')
读取本地文件
runtime/bundle-portability.mjs:159
if (mirrored !== undefined && existsSync(mirrored)) {
读取本地文件
runtime/bundle-portability.mjs:160
const kind = statSync(mirrored).isDirectory() ? 'dir' : 'file'
删除本地文件递归
runtime/bundle-portability.mjs:164
rmSync(path, { recursive: true, force: true })
删除本地文件递归
runtime/bundle-portability.mjs:170
rmSync(staging, { recursive: true, force: true })
删除本地文件递归
runtime/bundle-portability.mjs:173
rmSync(path, { recursive: true, force: true })
写入本地文件
runtime/bundle-portability.mjs:174
renameSync(staging, path)
写入本地文件
runtime/bundle-portability.mjs:206
writeFileSync(path, updated)
读取本地文件
runtime/prepare-compatible-runtime.mjs:73
if (!existsSync(packageJson)) throw new Error('Runtime closure deploy did not produce package.json.')
读取本地文件
runtime/prepare-compatible-runtime.mjs:74
const manifest = JSON.parse(readFileSync(packageJson, 'utf8'))
读取本地文件
runtime/prepare-compatible-runtime.mjs:78
if (existsSync(destination)) continue
读取本地文件
runtime/prepare-compatible-runtime.mjs:80
if (!existsSync(source)) throw new Error(`Runtime closure dependency is missing from deploy and source: ${dependency}.`)
写入本地文件
runtime/prepare-compatible-runtime.mjs:81
mkdirSync(dirname(destination), { recursive: true })
执行外部命令来自配置/变量
runtime/prepare-compatible-runtime.mjs:93
execFileSync(command, args, { cwd, stdio: 'inherit', shell: process.platform === 'win32' })
读取本地文件
runtime/prepare-runtime-profile.mjs:12
if (!existsSync(cli)) throw new Error('Compatible runtime is missing its DSH CLI.')
读取本地文件
runtime/prepare-runtime-profile.mjs:13
if (!existsSync(resolve(pluginTarball))) throw new Error('Compatible runtime plugin tarball does not exist.')
读取本地文件
runtime/prepare-runtime-profile.mjs:14
if (existsSync(output)) throw new Error(`Compatible runtime profile output already exists: ${output}`)
写入本地文件
runtime/prepare-runtime-profile.mjs:16
mkdirSync(home, { recursive: true })
读取本地文件
runtime/prepare-runtime-profile.mjs:22
if (!existsSync(join(profile, 'package.json'))) throw new Error('DSH native plugin manager did not create a web profile.')
执行外部命令来自配置/变量
runtime/prepare-runtime-profile.mjs:28
const result = spawnSync(command, args, options)
读取本地文件
runtime/runtime-manifest.mjs:25
? JSON.parse(readFileSync(fileURLToPath(source), 'utf8'))

扫描于 2026/9/26（0 天前） · 范围全包扫描 · 来源 GitHub 仓库

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

DeepSeek Harness Hub

openbkn-ai/bkn-dsh

OpenBKN 的 DeepSeek Harness Web UI 插件使业务用户能够安全、准确、可靠地利用企业的业务知识网络来完成业务分析和决策。

https://dpharness.com/plugin/openbkn-ai/bkn-dsh

粘贴到微信 / 小红书 / 微博等，链接会自动带上本站预览图。

广告WorkBuddy 天津胜凌

WorkBuddy 官方合作伙伴 · 天津胜凌

有意合作请致电 185 2226 8817 —— 代理合作或直接购买。

致电联络→

广告WorkBuddy 海外版

WorkBuddy 海外版 · 注册立得 350 积分

通过邀请链接注册即得 350 积分（100 邀请积分 + 250 新人积分），可用于平台内 AI 能力调用。

领取 350 积分→

README

由 DeepSeek 最新模型翻译生成

bkn-dsh

English

将受治理的 OpenBKN 业务知识带入 DeepSeek Harness 对话。

为什么

企业决策依赖可信的业务对象、指标、规则、关系和权限范围内的证据；通用对话本身不能提供这一受治理上下文。

做什么

bkn-dsh 是一个增量式 DeepSeek Harness 插件。授权用户可为一个会话选择一个 OpenBKN 业务知识网络，在明确边界内分析问题，并查看每轮已完成回答可用的业务溯源。

版本前提：业务溯源视图需要有效的 OpenBKN 令牌，且 businessDomain 在部署允许清单内（x-business-domain；社区 chart 出厂即允许 bd_public，无需管理面操作）。经对 OpenBKN 0.1.4 核实：observability 读路由没有 License 门，社区部署同样能看完整溯源面板；业务图在社区部署上的富集引用可能较少（企业版 optimizer，未实测）。读取路径不会出现升级提示——403 一律意味着业务域或账号被拒。

面向谁

- 需要可解释、受治理分析的业务用户和分析师；
- 希望业务语义被一致复用的知识网络维护者；
- 需要最小权限知识访问、又不希望暴露任意数据接口的企业 AI 平台团队。

业务价值

- 让分析建立在授权的业务语义和平台数据之上；
- 将每个会话固定在一个明确、不可变的知识网络范围内；
- 保留原生 DeepSeek Harness 工作流，并增加可追溯的 OpenBKN 上下文；
- 降低获得可信业务洞察的交互成本，无需用户掌握查询语言。

发布包内的 README 也提供面向包使用者的同等产品介绍。

安装并开始使用

推荐方式：OpenBKN 兼容 DSH Runtime

对于 DSH 0.1.6-alpha.2 用户，请从项目 Releases 下载匹配的 OpenBKN Runtime 压缩包。该包包含固定版本的 DSH Runtime、版本受限的兼容桥接以及 bkn-dsh 插件产物；首次启动时仍使用 DSH 原生插件管理器激活插件，不会修改已有 DSH 安装。

唯一前置条件为 Node.js ^22.19.0 或 >=24.0.0（与锁定的 DSH 版本一致）。Runtime 压缩包仅发布 darwin-arm64 与 win32-x64 两个平台；不提供 Intel Mac（darwin-x64）构建。发布 profile 在构建阶段由 DSH 原生插件管理器创建，首次启动时复制到隔离 Home；客户侧无需 pnpm，也不需要访问 npm registry。

1. 在下载目录使用同目录的 .sha256 文件校验压缩包，然后解压：

shasum -a 256 -c openbkn-dsh-runtime-.sha256

2. 启动包内的 DSH Web：

./openbkn-dsh-runtime-/bin/dsh web

Windows 请先使用 Get-FileHash 校验发布摘要，再在解压目录运行 bin\\dsh.cmd web。
3. 打开 DSH Web，在侧栏点击 OpenBKN；填写 OpenBKN 平台地址，通过引导完成 CLI 登录或输入平台 Token，并测试连接。
4. 选择有权限的业务知识网络，为它新建本地工作区或继续已有工作区，然后开始业务会话。

Runtime 使用隔离的 OpenBKN DSH Home（可用 OPENBKN_DSH_HOME 覆盖），不会改动 ~/.dsh。平台地址仅作为非敏感 DSH 设置保存；Token 只保存在 DSH credential。不要将 OpenBKN Token 写入 Cordis YAML。

源码构建路径：插件包 + 兼容补丁

在你自己的 DSH 源码树（精确处于上游 dsh-v0.1.6-alpha.2 版本）上，两样东西配合使用：

1. 插件包 —— openbkn-dsh-business-context-.tgz（从项目 Release 下载，或 pnpm --filter @openbkn/dsh-business-context pack 自行构建）。通过 DSH 原生插件管理器安装与卸载。
2. 兼容补丁脚本 —— 本仓库的 compat/dsh-0.1.6-alpha.2/，在构建 DSH 前应用于其源码树：

git clone --depth 1 --branch dsh-v0.1.6-alpha.2 https://github.com/deepseek-ai/deepseek-harness.git ~/dsh-src
node compat/dsh-0.1.6-alpha.2/apply.mjs  --dsh ~/dsh-src   # 在本仓库根执行
node compat/dsh-0.1.6-alpha.2/verify.mjs --dsh ~/dsh-src
cd ~/dsh-src && pnpm install && pnpm build
pnpm dsh plugin --profile web add file:

补丁是必需项而非可选项：未打补丁的 DSH 上，插件可以安装、加载并绑定知识网络，但其持久化的会话事件在每次 DSH 重启后被拒绝重载（上游事件白名单是构建期静态集合）。补丁补上缺失的写入侧，使会话正常重载、并在卸载插件后仍可移植。补丁采用失败即拒绝策略，不能应用于桌面应用包或其他 DSH 版本；更换 DSH 版本前先用 apply.mjs --revert 还原。详见兼容补丁包与分步安装指南（配置、凭证、卸载与已知注意事项）。

已知上游限制：直接以源码 dev 形式运行 DSH 时，任何插件的工具派发都会失败（Cannot read properties of undefined (reading 'prepare')）；完整问答需打包形态——上方的推荐 Runtime，或本仓库的 scripts/build-compatible-runtime.mjs --dsh  --output 。

已知插件限制：若某一轮在 bkn_start_interaction 与 bkn_finish_interaction 之间被取消或失败，该 Interaction 会留在平台侧不闭合。插件刻意不自动补 finish（平台对注入式收尾的语义尚未验证），只记录一条无载荷告警；观测项应跟踪「未闭合 Interaction 计数」。自动收尾属后续工作。

先决条件与试用路径

插件需要一个可达的 OpenBKN 平台，且至少有一个你有权限访问的知识网络。

1. 平台 —— 用 bkn-foundry 本地部署（macOS 用 deploy/dev/mac.sh；Docker 引擎需 ≥16 GB 内存），或使用你所在组织的部署。
2. 样例数据 —— 从 bkn-samples 导入样例知识网络（supply_ontology_hand 是主端到端数据集）。
3. 凭证 —— 执行一次 openbkn auth login ；插件仅通过 CLI 握手读取 Token。
4. 绑定 —— 在 DSH 中打开 OpenBKN 面板，选择网络，在其工作区中开始会话。

升级与卸载

- Runtime N → N+1：把新归档解到新目录启动即可；隔离的 OpenBKN DSH Home（OPENBKN_DSH_HOME，默认在用户数据目录下）跨 Runtime 版本保留会话与设置，无需手工迁移。
- 源码构建树：更换 DSH 版本前先用 apply.mjs --revert 还原补丁系列，切换版本后若有对应系列再重新应用。
- 卸载插件：dsh plugin --profile  remove @openbkn/dsh-business-context，并删除该 profile 目录下残留的 node_modules/@openbkn。打了兼容补丁时，装插件期间创建的会话在卸载后仍可读（插件事件可忽略）；未打补丁时，含插件事件的存量会话会被拒绝重载。

支持的 DSH 版本

一次只支持一个上游 DSH 版本——当前为 dsh-v0.1.6-alpha.2，由兼容 manifest 锁定。定时 workflow（upstream-dsh-watch）监控上游 tag，一旦有版本超过锁定版本即开出跟踪 issue；在兼容系列针对新版本重新生成之前，更新的 DSH 版本不在支持范围内。