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