dknowc-dsh：深知可信办公全家桶

DeepSeek Harness (dsh) 的核心理念是“一切皆插件”。开发者在构建 Agent 时，通常需要集成多种外部能力。dknowc-dsh 正是为了解决这一问题而生。它是一个由 dylanzhangzx 维护的插件包，通过一个 bundle 交付了四个核心 skill，并内置了深知可信工作台 MCP 转接层配置，统一接管接口调用。

核心功能¶

该插件包含以下 4 个 skill：

深知可信咨询：用于政策、法规、办事咨询，返回带角标答案及可信核验报告（首屏包含五项指标）。
深知可信搜索：用于权威材料检索与深度研究（支持多地域 deep-query/v3），返回核验报告、Markdown 及政策可视化。
深知可信PPT：用于演示文稿制作，通过 SVG 逐页创作并编译为原生可编辑 .pptx，支持双版核验报告与页面预览。
深知公文写作：用于正式公文起草、改写、多轮改稿及 Word/红头文档交付，支持素材分类核验。

插件本身零 dsh SDK 依赖（仅使用 Node 内置模块与 dsh 注入的 ctx），MCP client 由 dsh 宿主自带，因此具备跨 dsh 大版本的天然兼容性。

安装与启用¶

安装前需确保已安装 dsh 及 Node.js 22.19+。

dsh plugin --profile web add dknowc-dsh

也可从源码或本地目录安装：

dsh plugin --profile web add github:彩智/dknowc-dsh     # GitHub 安装
dsh plugin --profile web add ./dknowc-dsh              # 本地 checkout

安装完成后，4 个 skill 会在 dsh 会话的 <available_skills> 目录中显示。模型会根据任务描述自动路由：咨询政策/办事 -> 深知可信咨询；检索权威材料/深度研究 -> 深知可信搜索；制作 PPT/演示文稿 -> 深知可信PPT；起草/改写/生成正式公文 -> 深知公文写作。

配置认证¶

接口能力统一走深知可信工作台 MCP，Bearer 认证使用环境变量 DKNOWC_API_KEY。

设置 API Key¶

未配置时，可使用 dsh 专属渠道码 46A3BA1D-3E1A-4E8C-BD50-A6DCBEE1DB05 运行注册脚本：

node skills/dknowc-trusted-consulting/scripts/register_key.mjs send --phone <手机号>
node skills/dknowc-trusted-consulting/scripts/register_key.mjs register --phone <手机号> --vcode <验证码> --organ 个人 --name 用户

注册成功后获取 apiKey，将其追加到启动 dsh 的环境变量中（如 ~/.zshrc）：

export DKNOWC_API_KEY=你的APIKey

重启 dsh 或新开会话使配置生效。

Key 的传递机制¶

dsh 的安全机制会清理名字含 KEY 的隐式环境变量。本插件会把主进程的 DKNOWC_API_KEY 值经 shell-env 显式通道注入为 DSH_DKNOWC_API_KEY 供脚本门禁检查与兜底使用。MCP 的 Bearer 认证直接读取 dsh 主进程的 process.env.DKNOWC_API_KEY。用户只需配置 DKNOWC_API_KEY，无需额外设置 DSH_DKNOWC_API_KEY。

工作区与产物¶

bundle 内的 skill 目录是只读发布产物。运行时产物（溯源 HTML、搜索结果 JSON、Word 文档、中间文件）不会写入 bundle，而是写入当前会话工作区（dsh Web UI 中选中的 workspace 目录）。

产物结构（按会话隔离）：

<workspace>/dknowc-output/
└── <会话ID前8位>/
    ├── official-docs/
    │   ├── search-results/   接口 JSON、规范化 JSON、答案文件
    │   ├── output/           溯源 HTML、干净 Markdown、Word/红头文档
    │   ├── input/            正文临时文件
    │   └── outline-results/  范文大纲 JSON

跨会话持久数据分别存放：
* 公文写作的个人素材库与偏好：~/.dknowc-writer/
* 可信PPT 的项目目录：工作区级 dknowc-projects/<项目名>/

兼容性与注意事项¶

本插件在以下 dsh 版本实测通过（插件加载、4 skill 注册、MCP 连接均正常）：
- dsh 0.1.0-rc.7
- dsh 0.1.1-rc.2
- dsh 0.1.2-rc.1

注意：dsh 0.1.2 起 SDK 有破坏性变更（如移除部分 dsh-settings 导出），一批引用 SDK 内部包的第三方插件会加载失败。dsh 的加载机制是任一插件导入失败即整个 profile 启动失败。如果升级 dsh 后无法启动，可使用 dsh --profile web --patch <禁用清单.yml> 临时禁用可疑插件定位问题（- id: <插件id> + disabled: true）。本插件本身在 0.1.2 上无需任何改动。

本地验证可运行：

npm run check

总结¶

dknowc-dsh 作为一个集成插件，将彩智科技的四个专业能力无缝接入 DSH 生态。它通过 MCP 转接层解耦了接口调用，利用零依赖设计保证了跨版本兼容，并将产物与持久化数据规范地管理在工作区与用户目录中。

目录页：https://www.skillhub.cn/plugins/dylanzhangzx/dknowc-dsh
GitHub 仓库：https://github.com/dylanzhangzx/dknowc-dsh