彩智科技深知可信智能出品的可信办公全家桶 dsh 插件:包含深知可信咨询(政策/法规/办事问答,带真实来源角标 + 可点击溯源 HTML)、深知可信搜索(权威政策/标准检索与深度研究,溯源 HTML + 干净 Markdown)、深知公文写作(正式公文起草/改写/Word/红头交付)三个 Skill;接口统一经深知可信工作台 MCP 转接(Bearer 认证),产物写入会话工作区,API Key 一次配置长期免注册;已发布 npm 包 dknowc-dsh。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:dylanzhangzx/dknowc-dsh
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
深知可信办公全家桶 —— DeepSeek Harness(dsh)插件包。
通过一个 bundle 交付彩智科技的三个深知 Skill(深知可信搜索 / 深知可信PPT / 深知公文写作),接口能力统一走脚本直连(全量结构化返回),并捆绑深知可信工作台 MCP(trusted_search / deep_query / doc_outline)作为脚本异常时的应急兜底。
包含什么
dknowc-dsh/
├── skills/
│ ├── dknowc-trusted-search/ 深知可信搜索(脚本直连 + deep_convert 转换层;三页产出物 HTML)
│ ├── dknowc-ppt-assistant/ 深知可信PPT(素材检索脚本直连;SVG→原生PPTX 纯本地编译)
│ └── dknowc-official-doc-writer/ 深知公文写作(两阶段检索脚本直连;公文 Word × 产出物 HTML 双开关交付)
├── src/index.js 注册 3 个 skill 到 dsh ctx.skills
└── cordis.patch.yml 挂载 skill provider + mcp-client(Bearer 认证)
| Skill | 能力 | 接口调用方式 |
|---|---|---|
| 深知可信搜索 | 咨询类政策问答 + 权威材料检索/深度研究(分级),单文件产出物 HTML 三页(正文/溯源核验报告/知识专库,图表一体化,研究资料层) | 脚本直连(trusted_search.py / deep_query.py + deep_convert.py 转换层);MCP 兜底 mcp__dknowc__trusted_search / mcp__dknowc__deep_query |
| 深知公文写作 | 正式公文起草/改写/多轮改稿,交付双开关:15 种法定公文出 Word(可红头)、执行过搜索出产出物 HTML 三页;研究资料层 + 参考范文召回 | 脚本直连(dkag_search.py/deep_query.py/deep_convert.py/outline_reference.py);MCP 兜底 mcp__dknowc__* |
| 深知可信PPT | 演示文稿制作:SVG 逐页创作→编译原生可编辑 .pptx,双版核验报告(提纲/成稿)+ 页面预览页 | 素材检索脚本直连(trusted_search.py);编译纯本地(python-pptx,uv 隔离依赖) |
dsh 版本兼容性
本插件零 dsh SDK 依赖(src/index.js 只用 Node 内置模块 + cordis 注入的 ctx),MCP client 由 dsh 宿主自带并随宿主版本自动对齐(@deepseek-ai/dsh-mcp-client 是 dsh CLI 的直接依赖),因此跨 dsh 大版本天然兼容。已在以下版本实测通过(插件加载、skill 注册、MCP 连接均正常):
- dsh 0.2.1-rc.2(npm
latest,2026-10-19 实测:插件树加载零告警;--dump-configpatch 合成正常;headless 一次性任务会话中 3 skill 出现在<available_skills>(2.2.1 新描述);MCP server dknowc 连接成功、5 个工具(trusted_search / deep_query / credible_chat / doc_outline / create_api_key)完整同步——见下方 0.2.x 门禁说明) - dsh 0.1.2-rc.1(SDK 破坏性变更版本)
- dsh 0.1.1-rc.2
- dsh 0.1.0-rc.7(本插件首发基线)
v1.4.0:四 skill 溯源核验报告整体重构(双视图单页/句后引文胶囊/材料专库视图/链接活性检测+存档快照兜底/核验结论分级);公文范文大纲接入 MCP 第四工具 doc_outline;注册统一自动持久化(四 skill 共用同一 ~/.zshrc 标记块)。
注意(dsh 0.1.2 时代):SDK 破坏性变更(如
dsh-settings移除部分导出)会让引用 SDK 内部包的第三方插件加载失败,且当时的加载机制是任一插件导入失败即整个 profile 启动失败。可先用dsh --profile web --patch <禁用清单.yml>临时禁用可疑插件定位问题;本插件零 SDK 依赖,历次破坏性变更均无需改动。dsh 0.2.x 起机制改善:宿主新增插件兼容性门禁——不兼容插件(peer requirements 不满足)不再拖垮整树,而是启动时单独跳过并给出明确告警与精确豁免口(
dsh plugin allow-version)。2026-10-19 在 0.2.1-rc.2 实测:本插件零告警直接加载(无 peer requirements 冲突项),同环境 dshmarket 1.29.2 被门禁拒绝、升级 1.66.42 后恢复——第三方社区迁移走廊卡(dsh-plugin-upgrade,DSH 官方负责人公开推荐)梳理的 0.1.3→0.1.6 全部 25 条破坏性接缝(静默槽位/状态键删除、agent/created监听器竞态、异步注册 INACTIVE_EFFECT、模型 id 删除等)经逐条比对均不涉及本插件接触面(纯同步apply()注册、无 UI 槽位、无会话 API、无模型引用、无 SDK import)。
安装
前置:Node.js 22.19+,已安装 dsh。
dsh plugin --profile web add dknowc-dsh
或从源码/本地目录安装:
dsh plugin --profile web add github:彩智/dknowc-dsh # GitHub 安装
dsh plugin --profile web add ./dknowc-dsh # 本地 checkout
配置 MCP 认证
接口走深知可信工作台 MCP,Bearer 认证使用环境变量 DKNOWC_API_KEY:
export DKNOWC_API_KEY=你的APIKey
cordis.patch.yml 中已内置:
- id: mcp-dknowc
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: dknowc
transport: streamable-http
url: https://mcp.dknowc.cn/s6/mcp/
headers:
Authorization: !!js '`Bearer ${process.env.DKNOWC_API_KEY}`'
获取并配置 API Key
未配置 DKNOWC_API_KEY 时,可运行任一 skill 内置的注册脚本(使用 dsh 专属渠道码 46A3BA1D-3E1A-4E8C-BD50-A6DCBEE1DB05):
node skills/dknowc-trusted-search/scripts/register_key.mjs send --phone <手机号>
node skills/dknowc-trusted-search/scripts/register_key.mjs register --phone <手机号> --vcode <验证码> --organ 个人 --name 用户
注册成功后脚本自动把 Key 写入本机专用配置文件 ~/.config/dknowc/api_key(600 权限,并清理历史 ~/.zshrc 旧块)——dsh 的环境变量清理机制不影响配置文件读取,本会话立即可用,无需重启:
脚本会同时输出 envWriteInstruction。已有历史 ~/.zshrc Key 块的用户无需处理(脚本与 initialize 自动兼容读取);如仍想让 dsh 主进程环境变量持有 Key(MCP 兜底通道用),可自行追加 export DKNOWC_API_KEY=... 并重启 dsh,属可选项。
Key 的传递机制:dsh 的安全机制会清理名字含
KEY的隐式环境变量(DKNOWC_API_KEY会被拦)。本 bundle 插件会把 dsh 主进程的DKNOWC_API_KEY值经 shell-env 显式通道注入为DSH_DKNOWC_API_KEY供脚本门禁检查与兜底使用;用户只需配置DKNOWC_API_KEY,无需设置DSH_DKNOWC_API_KEY。MCP 的 Bearer 认证直接读 dsh 主进程的process.env.DKNOWC_API_KEY。
工作区与产物位置
bundle 内的 skill 目录是只读发布产物,运行时产物(溯源 HTML、搜索结果 JSON、Word 文档、中间文件)不会写入 bundle,而是写入当前会话工作区(dsh 里即你在 Web UI 中选中的 workspace 目录)。
机制:所有脚本支持 DKNWOC_WS_ROOT 环境变量显式指定产物根;未设置时,若存在 DSH_SESSION_ID(dsh 注入)则自动使用会话隔离目录,否则回退当前目录。因此:
- 在 dsh 里:每个会话的产物自动落到
<工作区>/dknowc-output/<会话ID前8位>/,同一工作区多会话互不混杂、互不覆盖 - 本地裸跑:无会话变量时落
dknowc-output/_default/ - 显式指定:
DKNWOC_WS_ROOT优先级最高(测试/特殊场景)
产物结构(在工作区内,按会话隔离):
<workspace>/dknowc-output/
└── <会话ID前8位>/
└── official-docs/
├── search-results/ 接口 JSON、MCP 原始返回、规范化 JSON、答案文件
├── output/ 产出物 HTML(正文/溯源核验报告/知识专库 三页)、Word/红头文档
├── input/ 正文临时文件(公文写作)
└── outline-results/ 范文大纲 JSON(公文写作)
公文写作的个人素材库与写作偏好是跨会话持久数据,单独存放在用户主目录
~/.dknowc-writer/(不随会话隔离,升级插件不丢失)。 可信PPT 的项目目录是跨会话延续的工作数据,单独存放在工作区级dknowc-projects/<项目名>/(内容包、SVG、导出的 .pptx,访达可直接找到,不随会话隔离)。
使用
装好后,3 个 skill 会出现在 dsh 会话的 <available_skills> 目录中,模型会按任务描述自动路由:
- 咨询政策/办事、检索权威材料/深度研究 → 深知可信搜索
- 制作 PPT/演示文稿/课件 → 深知可信PPT
- 起草/改写/生成正式公文 → 深知公文写作
也可在 dsh 中通过 skill 名称直接触发。
本地验证
npm run check
分发
- GitHub 仓库:打
dsh-plugintopic 以便生态发现 - npm:
pnpm publish(本包零构建,main直接指向src/index.js)
License
MIT
版本与维护
- 版本历史与逐版变更见 GitHub Releases:https://github.com/dylanzhangzx/dknowc-dsh/releases
- 仓库内维护说明(内部流程)见
MAINTENANCE.md(不随 npm 包发布)。
链接
同类插件
tw93/Mole#mole★ 75324
开源磁盘清理工具 Mole CLI(mo,支持 macOS 和 Windows)的官方 skill:按 Mole 的 JSON 输出查看磁盘占用、预览并执行清理、查看已安装应用、读取系统健康状态和清理记录。清理前先用 --dry-run 预览并征得同意,卸载应用和需要管理员权限的步骤留给用户在自己的终端里执行。插件只带 skill,CLI 需另外安装。
zhu1090093659/dsh-web#packages/dsh-skill-explorer★ 10461
技能中心:按来源分级浏览已加载的全部 skill,启用/禁用模型调用、创建新技能、删除进可恢复回收站。
QingYunA/answer-me-with-html★ 6373
把回答做成一页可视化 HTML:模型只写简短的 Markdown 草稿,随包附带的 `am` 命令行生成页面,支持流程图、时序图、树、时间线、ER 图、表格和提示框。
iflytek/skillhub#dsh★ 5434
在 DeepSeek Harness 内浏览、搜索 SkillHub 技能,并管理本地技能的安装、更新和卸载。适配 DSH 0.2.0-rc.2 与 0.2.1-rc.2,暂不兼容 0.2.1-rc.3。
hyhmrright/brooks-lint★ 1579
提供六个代码质量技能,涵盖代码审查、架构审计、技术债、测试质量、健康看板与修复。
GanyuanRan/Aegis★ 1443
面向编码 Agent 的软件工程方法包,提供基线优先规划、系统化调试、提示词卫生、完成前验证,以及修复/退役双轨跟踪技能。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。