dsh-dingtalk 0.1.1 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 stardustlc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -17,6 +17,10 @@ Example:
 
 > Send a message to the DingTalk group: title "Build complete", body "Pipeline #123 passed ✅".
 
+## Compatibility
+
+Verified against `@deepseek-ai/dsh@0.1.1-rc.2` on 2026-08-26. Built for the cordis patch-bundle plugin model (`cordis.patch.yml` + `dsh.bundle.patch`). No runtime imports of `@deepseek-ai/*` internals.
+
 ## Installation
 
 ```sh
@@ -25,6 +29,15 @@ dsh plugin --profile web add dsh-dingtalk
 
 After installing, restart `dsh web`. The plugin ships with an empty config and **won't crash startup**; calling any `dingtalk_*` tool before configuration returns a clear Chinese configuration hint.
 
+## Uninstall
+
+```bash
+dsh plugin --profile web remove dsh-dingtalk
+```
+
+Then restart the web service. To clean up fully, also remove the plugin entry from your profile `cordis.patch.yml` if you overrode it.
+
+
 ## Step 1: Get the webhook and signing secret
 
 Use DingTalk's **custom robot** method — **no enterprise app or admin permission needed**:
@@ -113,4 +126,4 @@ pnpm test        # 构建 + node --test（加签算法/配置解析/客户端封
 
 ## License
 
-MIT. This is a community plugin, not affiliated with DeepSeek or DingTalk; `@deepseek-ai/*` is an officially reserved namespace.
+MIT. This is a community plugin, not affiliated with DeepSeek or DingTalk; `@deepseek-ai/*` is an officially reserved namespace.

package/README.md

@@ -24,6 +24,10 @@ DeepSeek Harness 钉钉群机器人通知插件：让 agent 能**单向推送 Ma
 
 > 帮我给钉钉群发一条消息：标题「构建完成」，正文「流水线 #123 已通过 ✅」。
 
+## 兼容性
+
+在 `@deepseek-ai/dsh@0.1.1-rc.2` 上验证（2026-08-26）。遵循 cordis 组合包补丁模型（`cordis.patch.yml` + `dsh.bundle.patch`），运行时不 import 任何 `@deepseek-ai/*` 内部模块。
+
 ## 安装
 
 ```sh
@@ -32,6 +36,15 @@ dsh plugin --profile web add dsh-dingtalk
 
 装好后重启 `dsh web`。插件自带空配置，**不会弄崩启动**；配置前调用任何 `dingtalk_*` 工具都会返回明确的中文配置提示。
 
+## 卸载
+
+```bash
+dsh plugin --profile web remove dsh-dingtalk
+```
+
+卸载后重启 Web 服务。如需彻底清理，可再手动删除自己 profile `cordis.patch.yml` 中覆盖的插件行。
+
+
 ## 第一步：拿到 webhook 与加签密钥
 
 用钉钉【自定义机器人】方式，**不需要企业应用、不需要管理员权限**：
@@ -126,5 +139,4 @@ MIT。这是一个社区插件，与 DeepSeek 官方及钉钉官方无关；`@de
 
 - [dsh-calendar](https://github.com/STARDUSTLC666/dsh-calendar) — CalDAV 日历五件套
 - [dsh-dingtalk](https://github.com/STARDUSTLC666/dsh-dingtalk) — 钉钉群通知（零依赖）
-- [dsh-email](https://github.com/STARDUSTLC666/dsh-email) — 邮件六件套 + Web 设置页
-
+- [dsh-email](https://github.com/STARDUSTLC666/dsh-email) — 邮件六件套 + Web 设置页

package/lib/index.js

@@ -100,6 +100,39 @@ export function apply(ctx, config = {}) {
             return { ok: true, msgtype: 'text', title: '', errcode: result.errcode, errmsg: result.errmsg };
         },
     });
+    ctx.tools.register({
+        name: 'dingtalk_health',
+        description: 'dsh-dingtalk 自检：检查钉钉机器人 webhook 与加签密钥（secret）配置是否就绪（不发送任何消息）。遇到问题时先运行本工具定位。',
+        parameters: compileParameters({}),
+        output: {
+            schema: { type: 'object', additionalProperties: true },
+            render: (_args, value) => {
+                const rec = (value ?? {});
+                const rawChecks = Array.isArray(rec.checks) ? rec.checks : [];
+                const lines = ['dsh-dingtalk 自检' + (rec.ok === true ? '：正常。' : '：发现问题。')];
+                for (const item of rawChecks) {
+                    const c = (item ?? {});
+                    lines.push('- ' + String(c.name) + '：' + (c.ok === true ? '✅ ' + String(c.detail ?? '') : '❌ ' + String(c.detail ?? '')));
+                }
+                return oneText(lines.join('\n'));
+            },
+        },
+        async execute() {
+            const checks = [];
+            let ok = true;
+            try {
+                const resolved = resolveDingTalkConfig(config);
+                checks.push({ name: 'webhook', ok: true, detail: '已配置' });
+                const secret = resolved.secret;
+                checks.push({ name: '加签密钥', ok: true, detail: typeof secret === 'string' && secret !== '' ? '已配置（加签模式）' : '未配置（关键词/白名单模式）' });
+            }
+            catch (error) {
+                ok = false;
+                checks.push({ name: 'webhook', ok: false, detail: error instanceof Error ? error.message : String(error) });
+            }
+            return { ok, plugin: 'dsh-dingtalk', checks };
+        },
+    });
 }
 export { resolveDingTalkConfig, DINGTALK_SECRET_ENV, DEFAULT_TIMEOUT_MS, clampInt } from './config.js';
 export { DingTalkClient, DingTalkError, dingTalkErrorMessage } from './client.js';

package/package.json

@@ -1,60 +1,59 @@
-{
-  "name": "dsh-dingtalk",
-  "version": "0.1.1",
-  "description": "钉钉群机器人单向通知工具（DeepSeek Harness 插件）：agent 推送 Markdown / 纯文本消息到钉钉群，支持加签安全模式。",
-  "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/index.d.ts",
-      "default": "./lib/index.js"
-    },
-    "./client": "./lib/client.js",
-    "./cordis.patch.yml": "./cordis.patch.yml",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "lib",
-    "cordis.patch.yml",
-    "README.md",
-    "README.en.md"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "prepare": "tsc",
-    "prepublishOnly": "pnpm run build",
-    "test": "pnpm run build && node --test \"test/*.test.mjs\""
-  },
-  "keywords": [
-    "dsh-plugin",
-    "deepseek-harness",
-    "dsh",
-    "dingtalk",
-    "dingtalk-robot",
-    "webhook"
-  ],
-  "author": "stardustlc",
-  "license": "MIT",
-  "packageManager": "pnpm@11.7.0",
-  "engines": {
-    "node": ">=20"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    }
-  },
-  "devDependencies": {
-    "@types/node": "^26.2.0",
-    "typescript": "^5.7.3"
-  },
-  "repository": {
-    "url": "git+https://github.com/STARDUSTLC666/dsh-dingtalk.git",
-    "type": "git"
-  },
-  "bugs": {
-    "url": "https://github.com/STARDUSTLC666/dsh-dingtalk/issues"
-  },
-  "homepage": "https://github.com/STARDUSTLC666/dsh-dingtalk#readme"
-}
+{
+  "name": "dsh-dingtalk",
+  "version": "0.2.0",
+  "description": "钉钉群机器人单向通知工具（DeepSeek Harness 插件）：agent 推送 Markdown / 纯文本消息到钉钉群，支持加签安全模式。",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": "./lib/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "README.en.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "pnpm run build",
+    "test": "pnpm run build && node --test \"test/*.test.mjs\""
+  },
+  "keywords": [
+    "dsh-plugin",
+    "deepseek-harness",
+    "dsh",
+    "dingtalk",
+    "dingtalk-robot",
+    "webhook"
+  ],
+  "author": "stardustlc",
+  "license": "MIT",
+  "packageManager": "pnpm@11.7.0",
+  "engines": {
+    "node": ">=22"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "typescript": "^5.7.3"
+  },
+  "repository": {
+    "url": "git+https://github.com/STARDUSTLC666/dsh-dingtalk.git",
+    "type": "git"
+  },
+  "bugs": {
+    "url": "https://github.com/STARDUSTLC666/dsh-dingtalk/issues"
+  },
+  "homepage": "https://github.com/STARDUSTLC666/dsh-dingtalk#readme"
+}