Passer au contenu principal
D

dknowc-dsh

dylanzhangzx/dknowc-dsh

Suite bureautique de confiance pour le travail gouvernemental/entreprise par Beijing Caizhi Technology (深知可信智能) : trois compétences — conseil de confiance (Q&R politiques/réglementations avec marqueurs de citation + HTML de provenance), recherche de confiance (récupération de politiques/standards faisant autorité avec HTML traçable + Markdown propre) et rédaction de documents officiels (brouillon/réécriture/Word/livraison à en-tête) ; toutes les interfaces passent par le MCP de l'atelier de confiance dknowc (auth Bearer), les produits arrivent dans l'espace de travail de la session, la configuration de clé persiste pour les sessions suivantes ; publié sur npm sous dknowc-dsh.

Installer

dsh plugin --profile web add github:dylanzhangzx/dknowc-dsh

README

dknowc-dsh

深知可信办公全家桶 —— 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-config patch 合成正常;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-plugin topic 以便生态发现
  • npm:pnpm publish(本包零构建,main 直接指向 src/index.js)

License

MIT

版本与维护

Plugins associés