dsh-dingtalk 0.1.1 → 0.2.1

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

@@ -1,5 +1,7 @@
 # dsh-dingtalk
 
+![npm](https://img.shields.io/npm/v/dsh-dingtalk) ![downloads](https://img.shields.io/npm/dm/dsh-dingtalk) ![license](https://img.shields.io/github/license/STARDUSTLC666/dsh-dingtalk) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-dingtalk?style=social)
+
 [![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
 
 DeepSeek Harness DingTalk group robot notification plugin: lets the agent **push Markdown / plain-text messages to a DingTalk group one-way**. Pure plugin implementation, zero core changes, works out of the box.
@@ -17,6 +19,10 @@ Example:
 
 > Send a message to the DingTalk group: title "Build complete", body "Pipeline #123 passed ✅".
 
+## Compatibility
+
+Verified with official `@deepseek-ai/dsh@0.1.5-rc.1` and Node `24.16.0` on 2026-09-11: all 18 components load alongside Modlens, with passing tool-schema, skill-registration and offline read-only invocation checks. Uses the `cordis.patch.yml` + `dsh.bundle.patch` bundle model. Node requirements match this Harness release: 22.19 or later within 22.x, or 24 or later. Live external-service workflows require separate configuration and validation.
+
 ## Installation
 
 ```sh
@@ -25,6 +31,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**:

package/README.md

@@ -24,6 +24,10 @@ DeepSeek Harness 钉钉群机器人通知插件：让 agent 能**单向推送 Ma
 
 > 帮我给钉钉群发一条消息：标题「构建完成」，正文「流水线 #123 已通过 ✅」。
 
+## 兼容性
+
+已在官方 `@deepseek-ai/dsh@0.1.5-rc.1`、Node `24.16.0` 上验证（2026-09-11）：18 个组件与 Modlens 同载，工具 schema、技能注册及离线只读调用检查通过。采用 `cordis.patch.yml` + `dsh.bundle.patch` 组合包模型。Node 要求与该版本 Harness 一致：22.19 及以上的 22.x，或 24 及以上。外部服务的实际业务操作需按各组件配置单独验证。
+
 ## 安装
 
 ```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,6 +1,6 @@
 {
   "name": "dsh-dingtalk",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "钉钉群机器人单向通知工具（DeepSeek Harness 插件）：agent 推送 Markdown / 纯文本消息到钉钉群，支持加签安全模式。",
   "type": "module",
   "main": "lib/index.js",
@@ -22,7 +22,6 @@
   ],
   "scripts": {
     "build": "tsc",
-    "prepare": "tsc",
     "prepublishOnly": "pnpm run build",
     "test": "pnpm run build && node --test \"test/*.test.mjs\""
   },
@@ -38,7 +37,7 @@
   "license": "MIT",
   "packageManager": "pnpm@11.7.0",
   "engines": {
-    "node": ">=20"
+    "node": "^22.19.0 || >=24.0.0"
   },
   "dsh": {
     "bundle": {