DeepSeek Harness 桌面端、昇腾 ARM 适配、用量配额、问数知识库专家嵌入网页|KnowWork 新版本预览

0 阅读13分钟

KnowWork 是基于 DeepSeek Harness(下文简称 DSH)的企业私有化 Agent 平台。11 月 11 日发布了 v0.1.0,11 月 14 日发布了 v0.1.1。

这两版主要做了四件事。v0.1.1 第一次发布桌面端,员工在自己的 Mac 或 Windows 电脑上开对话,智能体在他选的文件夹里读写文件、运行命令,账号、权限和对话记录仍然在服务端。两版的镜像都同时有 amd64 和 arm64,鲲鹏加昇腾的机器能装整套服务,文档解析用本机 NPU 上的 MinerU。v0.1.1 加了用量配额,每个空间每月能用多少 token 由系统管理员定,空间管理员再分到部门和个人。v0.1.0 起,知识库问答和智能问数能嵌进你们自己的 BI 报表或内部门户,员工在报表右下角就能问。

这两版做的四件事,v0.1.1 发布的桌面端和用量配额,两版镜像都有的 ARM64 与昇腾上的 MinerU,v0.1.0 起知识库问答和智能问数能嵌进网页 这两版做的四件事,v0.1.1 发布的桌面端和用量配额,两版镜像都有的 ARM64 与昇腾上的 MinerU,v0.1.0 起知识库问答和智能问数能嵌进网页

桌面端,对话在员工自己的电脑上执行

服务端版本里,智能体运行的命令和读写的文件,一律落在这段对话自己的沙箱容器里。服务器是多人共用的,上面有数据库连接、密钥和别人的数据,附件和知识库里夹带的提示词不能碰到它。可是不少工作的材料就在员工自己电脑上,比如一个项目文件夹、本机装的程序、不便上传的文件。桌面端是给这类工作准备的。

这一版有两个安装包,Mac(Apple 芯片)和 Windows(x64),从你们自己的服务端下载。员工在网页的“设置 → 桌面端”里下载,点“打开桌面端并连接”会把服务地址带过去。登录走系统浏览器,和网页同一套账号。服务端换了新版桌面端,员工下次打开时会提示更新。

开新对话时,输入框下面选“在哪执行”,选本机就再选一个工作文件夹。访问方式有三档,用的是 DSH 官方的权限预设。默认的“工作区内修改”只能在工作文件夹和允许的临时目录里写,要超出这个范围就停下来请本人批准。“仅可查看”只读,“完全权限”不再询问,切到完全权限前要再确认一次。智能体停下来等批准或等人回答,窗口又不在前台时,桌面端会发系统通知,Mac 上 Dock 图标跳一下,免得一段对话卡在那里没人管。

桌面端里的一段本机对话,智能体读了工作文件夹里的分公司经营表,算出完成率、画出营收和目标的对比图,Word 简报直接存回这个文件夹,输入框下面选的是本机和工作区内修改 桌面端里的一段本机对话,智能体读了工作文件夹里的分公司经营表,算出完成率、画出营收和目标的对比图,Word 简报直接存回这个文件夹,输入框下面选的是本机和工作区内修改

员工电脑上跑的是 DSH 官方的宿主,桌面端用自带的 Node 把它起起来,只监听本机。模型和工具的密钥不落到员工电脑上。宿主要调模型、查知识库时,桌面端拿员工自己的登录凭证去业务服务换短期令牌,模型、工具、技能各换各的。

每一轮对话先由业务服务准备好,@ 了哪些资料、这个人能不能用、用哪种回答方式,和网页上发消息走同一段准备,再交给本机的宿主去执行。执行中产生的事件原样按顺序送回业务服务,所以本机对话也是业务服务里的一条普通对话,网页和手机上都看得到,只读,写明是在哪台电脑上执行的。

对话在员工的电脑上执行,账号、权限、模型和对话记录仍然在服务端。

桌面端与业务服务的分工,员工电脑上是 DSH 官方宿主、工作文件夹、自带的 Python 和 Node,业务服务管账号权限、每一轮的准备、短期令牌、模型网关和对话记录 桌面端与业务服务的分工,员工电脑上是 DSH 官方宿主、工作文件夹、自带的 Python 和 Node,业务服务管账号权限、每一轮的准备、短期令牌、模型网关和对话记录

在本机,知识库和 @、技能、选模型、专家照常能用。工作文件夹里的文件能 @,能把文件拖进对话,也能把交付的文件拖出去。桌面端自带 Python 和 Node,Python 的库和云端沙箱镜像是同一份清单、同一个版本,自带的 Word、Excel、PPT 技能在两边做出来的东西一样。Office 文件用桌面端自带的引擎预览和生成,员工电脑上不用另装 Office。

有的企业规定不能在个人电脑上执行,空间管理员在“管理 → 桌面端”里关掉本空间的本机会话就行,网页上的对话不受影响。桌面端单独一个交付包,解开放进部署目录,不用重启服务。以后不是每一版都出桌面端,旧桌面端连新服务端照样能用。这一版的安装包还没有签名,Mac 第一次打开要在“系统设置 → 隐私与安全性”里放行,Windows 会提示“未知发布者”。

适配鲲鹏加昇腾

不少客户的私有化环境是鲲鹏 CPU 加昇腾 NPU 的服务器。这两版的整套服务都能装在这类机器上,分三层看。

服务本身,都有 ARM64 镜像。 业务服务、宿主、网关、沙箱四个开源镜像,商业版的两个镜像,还有多跳检索,同一个版本标签里同时有 amd64 和 arm64,安装时按机器架构自动拉取对应的那份。每次出 ARM64 版之前,都会在 ARM64 机器上用交付给客户的那个安装脚本把整套起一遍,带上沙箱,接一个模拟模型,跑完冒烟测试才发。

文档解析,用本机的昇腾 NPU。 安装时加上 --mineru-ascend,就在 Atlas A2(910B)上起 MinerU,附件和知识库的文档解析默认走它,不用在管理后台另填地址。镜像照 MinerU 官方的昇腾适配构建,MinerU 3.4.5,模型已经打进镜像,运行时不联网,下载约 11 GB。两个服务只在内部网络上,不映射到宿主机,只有业务服务连得到。卡上已经跑着别的模型时,可以指定用哪张卡。

大模型,接你们在昇腾上部署的推理服务。 KnowWork 接模型用的是兼容 OpenAI 的接口,用 vLLM Ascend、MindIE 这类框架部署在昇腾上的对话模型和向量模型,在管理后台填上地址就能用。

鲲鹏加昇腾上的部署,KnowWork 的服务都是 ARM64 镜像,文档解析用本机 NPU 上的 MinerU,大模型接客户在昇腾上部署的推理服务 鲲鹏加昇腾上的部署,KnowWork 的服务都是 ARM64 镜像,文档解析用本机 NPU 上的 MinerU,大模型接客户在昇腾上部署的推理服务

这块有几个限制要说在前面。冒烟测试跑在通用的 ARM64 机器上,还没在鲲鹏加昇腾的真机上整套跑过,MinerU 的昇腾镜像也只在没有 NPU 的构建机上验证过模型、接口和 CPU 上的解析。昇腾这边目前只支持 Atlas A2。部分国产操作系统默认用 64K 内存页,这种系统还没验证。上线前请先在同款机器上把整套跑一遍,再解析几份自己的文档看看。

用量配额,从空间分到部门和个人

智能体用起来以后,管理员最常问两件事,这个月花了多少,谁用得最多。管理后台从第一版起就能看用量统计,v0.1.1 能给用量定上限。

用量配额怎么分,系统管理员定空间月总额,空间管理员按空间默认、部门和用户组、个人分下去,各个入口开始一轮之前统一判定,最近 30 天的用量反过来给出建议值 用量配额怎么分,系统管理员定空间月总额,空间管理员按空间默认、部门和用户组、个人分下去,各个入口开始一轮之前统一判定,最近 30 天的用量反过来给出建议值

系统管理员在“系统 → 空间管理”里给每个空间定每月能用多少 token,不定就是不限。空间管理员在“管理 → 用量 → 额度”里往下分,可以定空间默认、按部门或用户组的默认、个人额度,一个人同时在几个部门或用户组里,取其中最高的那个。某人这个月要多用,可以给他本月临时加额,月底自动失效。也可以设成超了只提醒、不拦截。每次改动都有记录。

管理后台的额度页,上面是空间本月总额、个人默认额度、已分配合计和下次恢复的日子,中间是最近 30 天每人用了多少和建议的默认额度,下面按成员列出本月已用和额度,用到 85% 的标着接近上限 管理后台的额度页,上面是空间本月总额、个人默认额度、已分配合计和下次恢复的日子,中间是最近 30 天每人用了多少和建议的默认额度,下面按成员列出本月已用和额度,用到 85% 的标着接近上限

额度定多少合适,额度页和设额度的对话框里都给参考,最近 30 天每人用量的平均数、中位数和 P90。建议值取 P90 再往上取整成好记的数,并折算成大约多少轮对话,模型填了单价的还折算成多少元。大多数人够用,用得特别多的少数人另外给例外,比全员一刀切好定,也好解释。

设个人默认额度的对话框,每人每月填 500 万 token,下面折算成约 74 轮对话,再下面是最近 30 天的中位数、P90 和建议值,超额时可以选拦截,也可以选只提醒、不拦截 设个人默认额度的对话框,每人每月填 500 万 token,下面折算成约 74 轮对话,再下面是最近 30 天的中位数、P90 和建议值,超额时可以选拦截,也可以选只提醒、不拦截

额度在各个入口统一生效,网页、桌面端、IM 机器人、网页嵌入、定时任务,开始一轮之前都判一次,进行中的那一轮不打断。员工在“设置 → 我的用量”里看本月还剩多少、哪天恢复,快用完时输入框上方会提醒,前面桌面端截图里的“本月额度已用 85%,还剩 75.2 万 token”就是这条提醒,用完了会说清楚为什么发不出去。公开嵌入和 IM 里没认出身份的访客,只算空间总额。系统自己调模型的那部分,比如起标题、对话摘要、知识库解析,这一版还没算进额度。

知识库和问数,嵌进你们的网站

不少客户已经有自己的 BI 报表和内部门户,员工看报表时冒出一个问题,最好就在报表右下角问,不用再切到另一个系统。v0.1.0 的网页嵌入做的就是这件事。

管理员在“管理 → 渠道”里添加“网页嵌入”,选回答方式和能查的资料,填允许嵌入的网站、开场白、快捷提问和限次,复制一段嵌入代码放进自己的页面,右下角就多了一个小窗。也可以整页嵌入,或者直接发分享链接。回答方式和平台里一样,可以查选定的知识库,也可以用智能问数查选定的数据源。小窗里的对话和平台里是同一个对话视图,知识库的回答照样带出处,问数的结果卡片照样能下载、改条件、下钻。访客只能动自己这段对话里的查询,按访客限次。

模拟的集团经营驾驶舱页面,右下角点开嵌入的小窗,问今年 1 到 10 月各产品线的营收和毛利率,回答逐条列出四条产品线的数,和驾驶舱上的对得上 模拟的集团经营驾驶舱页面,右下角点开嵌入的小窗,问今年 1 到 10 月各产品线的营收和毛利率,回答逐条列出四条产品线的数,和驾驶舱上的对得上

访问方式有两种,按嵌在哪里选。

公开访问。 访客不用登录就能问,适合官网和对外的帮助页面。会话凭证只放在页面内存里,不靠 Cookie,Safari 和手机浏览器里也能用,按访客限次。

认证访问。 嵌进 BI 这类内部系统时用。你们的后端用渠道的认证密钥签一个登录信息(JWT,有效期不超过 10 分钟)交给小窗,KnowWork 按这个人自己的权限回答。先按邮箱对上空间里已有的成员,对不上可以自动建一个外部用户,只能从这个入口进来。用户组按“组对照”同步,权限按组配,人员变动不用一个个改。手机 App 用 WebView 打开带登录信息的地址就行。

认证访问时,员工在报表小窗里问出来的数,和在 KnowWork 里问的用同一套口径、同一份权限。

小窗里的问数结果卡片,营收和毛利率两个指标可以切换,底下写着口径是 2026 年 1 月 1 日到 10 月 31 日、按产品线,旁边能改条件、下载,点图上的一项还能往下钻 小窗里的问数结果卡片,营收和毛利率两个指标可以切换,底下写着口径是 2026 年 1 月 1 日到 10 月 31 日、按产品线,旁边能改条件、下载,点图上的一项还能往下钻

允许嵌入的网站在渠道里填,网关按它限制哪些页面能把小窗嵌进去,别的网站拿到嵌入代码也嵌不了。

商业版里,网页嵌入还能挂专家。专家编辑页多了一个“嵌入网页”标签,嵌出去的小窗照这位专家的回答方式、说明和能查的资料回答,知识库和数据源一起用。专家改了,嵌出去的跟着变,专家删了,嵌入跟着关掉。

其他更新

问数的口径能写得更细。 语义模型多了计算字段,比如给客户加一个“订单总额”,汇总他的订单。筛选条件能跨表、带汇总,“大客户”可以定义成积分够、订单总额过千,原来的筛选条件会自动转成新写法,已有的可信查询和看板照常用。还能写先汇总再平均的指标,比如按客户算的平均订单额。阈值、天数这类会变的数可以写成变量,用户说了“超过 800 算大单”就按他说的算,没说就用默认值,结果卡片的口径里写明这次用的是多少,过几天有人拿着这个数来问,也追得回当时的取值。

开源版。 回答里的文件链接和交付的文件卡片,现在能直接点开预览、下载。文件按它在对话里的路径读,沙箱回收以后,交付过的那份也读得到。新增一个自带的“读文档”技能,PDF、Word、Excel、PPT 交给它读成文字,扫描件会提示改用附件上传,走文档解析。桌面端和配额用到的接口也都在开源这边,原生应用经系统浏览器登录、按用途换短期令牌,各个入口开始一轮之前问一下扩展登记的配额判定,没装扩展时不限制,也不多一次查询。

这两版把智能体从服务端带到了员工的电脑和别的系统里。下一篇回到问数系列,讲一个没有外键的业务库,语义模型怎么起草,关联怎么在库上核对。

KnowWork 的智能体部分以 Apache-2.0 开源。内置知识库、智能问数、专家、记忆、多空间、企业技能与企业 MCP、组织同步、用量配额和桌面端属于商业版,想试用可以联系我们申请授权。

项目地址 github.com/knowflow-ai… ,欢迎提 Issue 和 PR,也欢迎点个 Star。