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 起知识库问答和智能问数能嵌进网页
桌面端,对话在员工自己的电脑上执行
服务端版本里,智能体运行的命令和读写的文件,一律落在这段对话自己的沙箱容器里。服务器是多人共用的,上面有数据库连接、密钥和别人的数据,附件和知识库里夹带的提示词不能碰到它。可是不少工作的材料就在员工自己电脑上,比如一个项目文件夹、本机装的程序、不便上传的文件。桌面端是给这类工作准备的。
这一版有两个安装包,Mac(Apple 芯片)和 Windows(x64),从你们自己的服务端下载。员工在网页的“设置 → 桌面端”里下载,点“打开桌面端并连接”会把服务地址带过去。登录走系统浏览器,和网页同一套账号。服务端换了新版桌面端,员工下次打开时会提示更新。
开新对话时,输入框下面选“在哪执行”,选本机就再选一个工作文件夹。访问方式有三档,用的是 DSH 官方的权限预设。默认的“工作区内修改”只能在工作文件夹和允许的临时目录里写,要超出这个范围就停下来请本人批准。“仅可查看”只读,“完全权限”不再询问,切到完全权限前要再确认一次。智能体停下来等批准或等人回答,窗口又不在前台时,桌面端会发系统通知,Mac 上 Dock 图标跳一下,免得一段对话卡在那里没人管。
桌面端里的一段本机对话,智能体读了工作文件夹里的分公司经营表,算出完成率、画出营收和目标的对比图,Word 简报直接存回这个文件夹,输入框下面选的是本机和工作区内修改
员工电脑上跑的是 DSH 官方的宿主,桌面端用自带的 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,大模型接客户在昇腾上部署的推理服务
这块有几个限制要说在前面。冒烟测试跑在通用的 ARM64 机器上,还没在鲲鹏加昇腾的真机上整套跑过,MinerU 的昇腾镜像也只在没有 NPU 的构建机上验证过模型、接口和 CPU 上的解析。昇腾这边目前只支持 Atlas A2。部分国产操作系统默认用 64K 内存页,这种系统还没验证。上线前请先在同款机器上把整套跑一遍,再解析几份自己的文档看看。
用量配额,从空间分到部门和个人
智能体用起来以后,管理员最常问两件事,这个月花了多少,谁用得最多。管理后台从第一版起就能看用量统计,v0.1.1 能给用量定上限。
用量配额怎么分,系统管理员定空间月总额,空间管理员按空间默认、部门和用户组、个人分下去,各个入口开始一轮之前统一判定,最近 30 天的用量反过来给出建议值
系统管理员在“系统 → 空间管理”里给每个空间定每月能用多少 token,不定就是不限。空间管理员在“管理 → 用量 → 额度”里往下分,可以定空间默认、按部门或用户组的默认、个人额度,一个人同时在几个部门或用户组里,取其中最高的那个。某人这个月要多用,可以给他本月临时加额,月底自动失效。也可以设成超了只提醒、不拦截。每次改动都有记录。
管理后台的额度页,上面是空间本月总额、个人默认额度、已分配合计和下次恢复的日子,中间是最近 30 天每人用了多少和建议的默认额度,下面按成员列出本月已用和额度,用到 85% 的标着接近上限
额度定多少合适,额度页和设额度的对话框里都给参考,最近 30 天每人用量的平均数、中位数和 P90。建议值取 P90 再往上取整成好记的数,并折算成大约多少轮对话,模型填了单价的还折算成多少元。大多数人够用,用得特别多的少数人另外给例外,比全员一刀切好定,也好解释。
设个人默认额度的对话框,每人每月填 500 万 token,下面折算成约 74 轮对话,再下面是最近 30 天的中位数、P90 和建议值,超额时可以选拦截,也可以选只提醒、不拦截
额度在各个入口统一生效,网页、桌面端、IM 机器人、网页嵌入、定时任务,开始一轮之前都判一次,进行中的那一轮不打断。员工在“设置 → 我的用量”里看本月还剩多少、哪天恢复,快用完时输入框上方会提醒,前面桌面端截图里的“本月额度已用 85%,还剩 75.2 万 token”就是这条提醒,用完了会说清楚为什么发不出去。公开嵌入和 IM 里没认出身份的访客,只算空间总额。系统自己调模型的那部分,比如起标题、对话摘要、知识库解析,这一版还没算进额度。
知识库和问数,嵌进你们的网站
不少客户已经有自己的 BI 报表和内部门户,员工看报表时冒出一个问题,最好就在报表右下角问,不用再切到另一个系统。v0.1.0 的网页嵌入做的就是这件事。
管理员在“管理 → 渠道”里添加“网页嵌入”,选回答方式和能查的资料,填允许嵌入的网站、开场白、快捷提问和限次,复制一段嵌入代码放进自己的页面,右下角就多了一个小窗。也可以整页嵌入,或者直接发分享链接。回答方式和平台里一样,可以查选定的知识库,也可以用智能问数查选定的数据源。小窗里的对话和平台里是同一个对话视图,知识库的回答照样带出处,问数的结果卡片照样能下载、改条件、下钻。访客只能动自己这段对话里的查询,按访客限次。
模拟的集团经营驾驶舱页面,右下角点开嵌入的小窗,问今年 1 到 10 月各产品线的营收和毛利率,回答逐条列出四条产品线的数,和驾驶舱上的对得上
访问方式有两种,按嵌在哪里选。
公开访问。 访客不用登录就能问,适合官网和对外的帮助页面。会话凭证只放在页面内存里,不靠 Cookie,Safari 和手机浏览器里也能用,按访客限次。
认证访问。 嵌进 BI 这类内部系统时用。你们的后端用渠道的认证密钥签一个登录信息(JWT,有效期不超过 10 分钟)交给小窗,KnowWork 按这个人自己的权限回答。先按邮箱对上空间里已有的成员,对不上可以自动建一个外部用户,只能从这个入口进来。用户组按“组对照”同步,权限按组配,人员变动不用一个个改。手机 App 用 WebView 打开带登录信息的地址就行。
认证访问时,员工在报表小窗里问出来的数,和在 KnowWork 里问的用同一套口径、同一份权限。
小窗里的问数结果卡片,营收和毛利率两个指标可以切换,底下写着口径是 2026 年 1 月 1 日到 10 月 31 日、按产品线,旁边能改条件、下载,点图上的一项还能往下钻
允许嵌入的网站在渠道里填,网关按它限制哪些页面能把小窗嵌进去,别的网站拿到嵌入代码也嵌不了。
商业版里,网页嵌入还能挂专家。专家编辑页多了一个“嵌入网页”标签,嵌出去的小窗照这位专家的回答方式、说明和能查的资料回答,知识库和数据源一起用。专家改了,嵌出去的跟着变,专家删了,嵌入跟着关掉。
其他更新
问数的口径能写得更细。 语义模型多了计算字段,比如给客户加一个“订单总额”,汇总他的订单。筛选条件能跨表、带汇总,“大客户”可以定义成积分够、订单总额过千,原来的筛选条件会自动转成新写法,已有的可信查询和看板照常用。还能写先汇总再平均的指标,比如按客户算的平均订单额。阈值、天数这类会变的数可以写成变量,用户说了“超过 800 算大单”就按他说的算,没说就用默认值,结果卡片的口径里写明这次用的是多少,过几天有人拿着这个数来问,也追得回当时的取值。
开源版。 回答里的文件链接和交付的文件卡片,现在能直接点开预览、下载。文件按它在对话里的路径读,沙箱回收以后,交付过的那份也读得到。新增一个自带的“读文档”技能,PDF、Word、Excel、PPT 交给它读成文字,扫描件会提示改用附件上传,走文档解析。桌面端和配额用到的接口也都在开源这边,原生应用经系统浏览器登录、按用途换短期令牌,各个入口开始一轮之前问一下扩展登记的配额判定,没装扩展时不限制,也不多一次查询。
这两版把智能体从服务端带到了员工的电脑和别的系统里。下一篇回到问数系列,讲一个没有外键的业务库,语义模型怎么起草,关联怎么在库上核对。
KnowWork 的智能体部分以 Apache-2.0 开源。内置知识库、智能问数、专家、记忆、多空间、企业技能与企业 MCP、组织同步、用量配额和桌面端属于商业版,想试用可以联系我们申请授权。
项目地址 github.com/knowflow-ai… ,欢迎提 Issue 和 PR,也欢迎点个 Star。