dsh-slack 0.1.0

package/README.md

@@ -0,0 +1,128 @@
+# dsh-slack
+
+DSH（DeepSeek Harness）社区插件：让 agent 向 Slack 发通知/桥接消息。
+
+> **v0.1 范围（单向）**：本版本只做「agent → Slack」的单向通知（发消息、列频道）。
+> 双向对话（Slack 消息实时流入 agent）、Socket Mode、RTM、交互组件都不在 v0.1，见下方
+> [已知限制与路线图](#已知限制与路线图)。
+
+## 功能
+
+- `slack_notify`：向指定频道（或线程）发送一条 Markdown 文本消息，返回消息 `ts` 供后续引用。
+- `slack_channels`：列出机器人当前可见的频道（`conversations.list`）。
+- 配置走 `cordis.patch.yml`，令牌支持环境变量回退 `DSH_SLACK_TOKEN`。
+
+## 安装
+
+插件运行在宿主进程内，通过 `dsh plugin` 安装进 profile，重启后生效：
+
+```sh
+dsh plugin --profile web add dsh-slack
+```
+
+安装后重启你的 dsh Web 服务，`slack_notify` / `slack_channels` 两个工具即对模型可见。
+
+## 配置
+
+配置在 profile 的 `cordis.patch.yml` 里按 `id: slack` 覆盖本插件的行（覆盖会整体替换该行的
+`config`，不会合并）。可用配置项：
+
+| 键 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `token` | string | 是* | Slack 令牌：机器人令牌（`xoxb-`）或用户令牌（`xoxp-`）。留空时回退到环境变量 `DSH_SLACK_TOKEN`。 |
+| `defaultChannel` | string | 否 | 默认频道（如 `#general`）。模型未特别指定频道时的默认目标，写进 `channel` 参数说明里。 |
+
+`*` `token` 在「配置层」可留空，此时回退环境变量；两者都为空时插件照常加载，但调用工具时会
+返回中文报错（懒加载，见[错误处理](#错误处理)）。
+
+**方式一：环境变量（推荐，不写死令牌）**
+
+```sh
+# 在启动 dsh 的进程里设置
+export DSH_SLACK_TOKEN=xoxb-你的机器人令牌
+```
+
+**方式二：profile 的 cordis.patch.yml 直接覆盖**
+
+在你的 profile 目录（`$DSH_HOME/profiles/web/cordis.patch.yml`）追加：
+
+```yaml
+# 覆盖 dsh-slack 的 slack 行配置（整体替换）
+- id: slack
+  config:
+    token: 'xoxb-你的机器人令牌'
+    defaultChannel: '#general'
+```
+
+> 优先级：`config.token` > 环境变量 `DSH_SLACK_TOKEN`。
+
+### 创建 Slack App 并拿令牌
+
+1. 打开 <https://api.slack.com/apps>，点 **Create New App**（选 `From scratch`，给 App 起名、选工作区）。
+2. 进入 **OAuth & Permissions** 页，在 **Scopes → Bot Token Scopes** 下勾选：
+   - `chat:write`（发消息必需）
+   - `channels:read`（列频道必需）
+3. 回到顶部点 **Install to Workspace**（授权）。
+4. 拿到 **Bot User OAuth Token**（以 `xoxb-` 开头）。
+5. 把机器人（App）加进它要发消息的频道：在频道里 `/invite @你的机器人`（私有频道必需）。
+
+## 工具清单
+
+### `slack_notify`
+
+向指定频道/线程发送 Markdown 文本（底层 `chat.postMessage`）。
+
+| 参数 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `channel` | string | 是 | 频道名（如 `#general`）或频道 ID。 |
+| `text` | string | 是 | 要发送的 Markdown 文本。 |
+| `thread_ts` | string | 否 | 回复某条消息所在线程的 `ts`（即 `slack_notify` 返回的 `ts`）。 |
+
+返回：`{ "ts": "...", "channel": "#general" }`（`ts` 供后续 `thread_ts` 引用）。
+
+### `slack_channels`
+
+列出机器人可见频道（底层 `conversations.list`）。
+
+无参数。返回：`{ "channels": [{ "id": "...", "name": "..." }, ...] }`。
+
+## 错误处理
+
+所有错误信息均为中文，模型与用户都能直接读懂：
+
+- 未配置令牌：`token 未配置：缺少 Slack 机器人令牌（xoxb-）…请在 profile 的 cordis.patch.yml 覆盖 slack 行的 config.token 并重启，或设置环境变量 DSH_SLACK_TOKEN。`
+- `invalid_auth`：提示检查/重新生成 token。
+- `channel_not_found`：提示频道名或频道 ID 错误。
+- `not_in_channel`：提示先把机器人 App 邀请进频道。
+- `token_revoked` / `account_inactive` / `missing_scope`：提示权限或令牌失效，需重新安装 App。
+
+## 开发与测试
+
+```sh
+pnpm install   # 安装依赖并触发 prepare（tsc 构建）
+pnpm build     # tsc 编译 src → lib
+pnpm test      # 先 build，再用 node:test 跑 test/*.test.mjs
+```
+
+测试无需真实 token：参数编译、配置解析（含 env 回退）、工具注册（2 个工具 + 缺配置中文报错）、
+注入 fake client 断言 `postMessage` 参数、输出 schema 纯 JSON 校验。
+
+## 已知限制与路线图
+
+- **v0.1 是单向通知（agent→Slack）**：不能从 Slack 收消息反向驱动 agent。
+- **不支持** Socket Mode 实时接收、RTM、交互组件（按钮/弹窗/slash command 回复）。
+- `channel` 为必填参数，`defaultChannel` 目前只作为说明提示写入 `channel` 参数描述，不替代
+  必填的 `channel`。
+- 令牌缺失时插件仍会加载（懒加载），错误在工具被调用时才抛出。
+
+路线图：v0.2 计划引入 Socket Mode（`@slack/socket-mode`）实现「Slack 消息 → agent」双向桥接与
+交互组件。
+
+## 依赖
+
+- 运行时：`@slack/web-api`（官方 WebClient）
+- peer（由宿主提供，插件运行时不直接 import）：`@deepseek-ai/cordis`、`@deepseek-ai/dsh-tools`
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,11 @@
+# dsh-slack 的 bundle patch：向 profile 根插入 slack 插件行。
+# 用户可在 profile 的 cordis.patch.yml 里按 id 覆盖本行 config（整体替换）。
+- insert:
+    - id: slack
+      name: dsh-slack
+      config:
+        # Slack 令牌：机器人令牌（xoxb-）或用户令牌（xoxp-）。
+        # 留空时回退到环境变量 DSH_SLACK_TOKEN。
+        token: ''
+        # 默认频道（可选）：模型未特别指定频道时的默认目标（如 #general）。
+        defaultChannel: ''

package/lib/compile.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 工具参数 DSL → 已编译 JSON Schema。
+ *
+ * 关键约定（坑 1/2）：注册给宿主的 parameters 必须是【编译好的 JSON Schema 对象】
+ * （{ type: 'object', properties: {...}, required?: [...] }），绝不能把原始 DSL
+ * 直接塞进去，否则标准模式请求会被 DeepSeek API 拒绝。
+ */
+/** 单个参数的作者友好 DSL。 */
+export interface ParameterDsl {
+    type?: 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object';
+    required?: boolean;
+    description?: string;
+    enum?: readonly (string | number | boolean)[];
+    items?: ParameterDsl;
+    properties?: Record<string, ParameterDsl>;
+}
+/** 参数 DSL 表：键为参数名，值为参数描述。 */
+export type ParameterDslMap = Record<string, ParameterDsl>;
+/** 编译后的 JSON Schema 节点（lossless JSON）。 */
+export interface JsonSchemaNode {
+    type?: string;
+    properties?: Record<string, JsonSchemaNode>;
+    required?: string[];
+    description?: string;
+    enum?: (string | number | boolean)[];
+    items?: JsonSchemaNode;
+    additionalProperties?: boolean;
+}
+/**
+ * 把参数 DSL 编译为【已编译好的 JSON Schema 对象】。
+ * 结果形如 { type: 'object', properties: {...}, required?: [...] }，
+ * 可直接作为 ToolDefinition.parameters 注册。
+ */
+export declare function compileParameters(dsl: ParameterDslMap): JsonSchemaNode;

package/lib/compile.js

@@ -0,0 +1,57 @@
+/**
+ * 工具参数 DSL → 已编译 JSON Schema。
+ *
+ * 关键约定（坑 1/2）：注册给宿主的 parameters 必须是【编译好的 JSON Schema 对象】
+ * （{ type: 'object', properties: {...}, required?: [...] }），绝不能把原始 DSL
+ * 直接塞进去，否则标准模式请求会被 DeepSeek API 拒绝。
+ */
+/** 把单个属性 DSL 编译成 JSON Schema 节点。 */
+function compileProperty(spec, path) {
+    const type = spec.type;
+    if (type === undefined) {
+        throw new Error(`[dsh-slack] 参数 ${path} 缺少 type`);
+    }
+    const node = { type };
+    if (spec.description !== undefined)
+        node.description = spec.description;
+    if (spec.enum !== undefined)
+        node.enum = [...spec.enum];
+    if (type === 'array') {
+        if (spec.items !== undefined)
+            node.items = compileProperty(spec.items, `${path}[]`);
+    }
+    else if (type === 'object') {
+        node.additionalProperties = true;
+        if (spec.properties !== undefined) {
+            const properties = {};
+            const required = [];
+            for (const [key, value] of Object.entries(spec.properties)) {
+                properties[key] = compileProperty(value, `${path}.${key}`);
+                if (value.required === true)
+                    required.push(key);
+            }
+            node.properties = properties;
+            if (required.length > 0)
+                node.required = required;
+        }
+    }
+    return node;
+}
+/**
+ * 把参数 DSL 编译为【已编译好的 JSON Schema 对象】。
+ * 结果形如 { type: 'object', properties: {...}, required?: [...] }，
+ * 可直接作为 ToolDefinition.parameters 注册。
+ */
+export function compileParameters(dsl) {
+    const properties = {};
+    const required = [];
+    for (const [key, spec] of Object.entries(dsl)) {
+        properties[key] = compileProperty(spec, key);
+        if (spec.required === true)
+            required.push(key);
+    }
+    const schema = { type: 'object', properties };
+    if (required.length > 0)
+        schema.required = required;
+    return schema;
+}

package/lib/config.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Slack 插件配置解析（懒加载、全中文错误）。
+ *
+ * 坑 5：配置缺失时插件【不失败】——apply 里 try/catch，失败只 console.warn；
+ * 每个工具的 execute 再解析，缺失时抛出带中文指引的错误。
+ */
+/** Slack 插件配置。 */
+export interface SlackConfig {
+    token: string;
+    defaultChannel: string;
+}
+/** token 的环境变量名。 */
+export declare const ENV_TOKEN = "DSH_SLACK_TOKEN";
+/**
+ * 解析原始配置。永不抛错：非法形状返回 undefined，让插件懒加载不失败。
+ */
+export declare function parseConfig(raw: unknown): SlackConfig | undefined;
+/**
+ * 解析 token：config.token 优先，其次环境变量 DSH_SLACK_TOKEN。
+ */
+export declare function resolveToken(config: SlackConfig | undefined): string;
+/**
+ * 解析默认频道。
+ */
+export declare function resolveDefaultChannel(config: SlackConfig | undefined): string;
+/**
+ * 要求 token：缺失时抛出带中文指引的错误（供 execute 使用）。
+ */
+export declare function requireToken(config: SlackConfig | undefined): string;

package/lib/config.js

@@ -0,0 +1,47 @@
+/**
+ * Slack 插件配置解析（懒加载、全中文错误）。
+ *
+ * 坑 5：配置缺失时插件【不失败】——apply 里 try/catch，失败只 console.warn；
+ * 每个工具的 execute 再解析，缺失时抛出带中文指引的错误。
+ */
+/** token 的环境变量名。 */
+export const ENV_TOKEN = 'DSH_SLACK_TOKEN';
+/**
+ * 解析原始配置。永不抛错：非法形状返回 undefined，让插件懒加载不失败。
+ */
+export function parseConfig(raw) {
+    if (raw === undefined || raw === null)
+        return { token: '', defaultChannel: '' };
+    if (typeof raw !== 'object' || Array.isArray(raw))
+        return undefined;
+    const obj = raw;
+    const token = typeof obj.token === 'string' ? obj.token.trim() : '';
+    const defaultChannel = typeof obj.defaultChannel === 'string' ? obj.defaultChannel.trim() : '';
+    return { token, defaultChannel };
+}
+/**
+ * 解析 token：config.token 优先，其次环境变量 DSH_SLACK_TOKEN。
+ */
+export function resolveToken(config) {
+    const fromConfig = config?.token.trim() ?? '';
+    if (fromConfig)
+        return fromConfig;
+    return process.env[ENV_TOKEN]?.trim() ?? '';
+}
+/**
+ * 解析默认频道。
+ */
+export function resolveDefaultChannel(config) {
+    return config?.defaultChannel ?? '';
+}
+/**
+ * 要求 token：缺失时抛出带中文指引的错误（供 execute 使用）。
+ */
+export function requireToken(config) {
+    const token = resolveToken(config);
+    if (!token) {
+        throw new Error('token 未配置：缺少 Slack 机器人令牌（xoxb-）或用户令牌（xoxp-）。'
+            + '请在 profile 的 cordis.patch.yml 覆盖 slack 行的 config.token 并重启，或设置环境变量 DSH_SLACK_TOKEN。');
+    }
+    return token;
+}

package/lib/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * dsh-slack：DSH 社区 Slack 通知/桥接插件。
+ * v0.1 只做单向通知（agent→Slack），无 Socket Mode / RTM / 交互组件。
+ * @module dsh-slack
+ */
+import type { SlackContext } from './types.js';
+export declare const name = "dsh-slack";
+export declare const inject: string[];
+export { compileParameters, type ParameterDsl, type ParameterDslMap, type JsonSchemaNode } from './compile.js';
+export { parseConfig, resolveToken, resolveDefaultChannel, requireToken, ENV_TOKEN, type SlackConfig, } from './config.js';
+export { createWebSlackClient, mapSlackError, assertChannel, assertText, type SlackClient, type PostMessageParams, type ChannelInfo, } from './slack-client.js';
+export { buildNotifyTool, buildChannelsTool, type ToolDeps } from './tools.js';
+export type { SlackContext, ToolDefinition, ToolOutputDefinition, ContentBlock } from './types.js';
+/**
+ * 插件入口。配置缺失【不失败】（懒加载）：只 console.warn；
+ * token 缺失在每个工具的 execute 时抛出带中文指引的错误。
+ */
+export declare function apply(ctx: SlackContext, rawConfig: unknown): void;

package/lib/index.js

@@ -0,0 +1,47 @@
+/**
+ * dsh-slack：DSH 社区 Slack 通知/桥接插件。
+ * v0.1 只做单向通知（agent→Slack），无 Socket Mode / RTM / 交互组件。
+ * @module dsh-slack
+ */
+import { parseConfig, requireToken } from './config.js';
+import { createWebSlackClient } from './slack-client.js';
+import { buildChannelsTool, buildNotifyTool } from './tools.js';
+export const name = 'dsh-slack';
+export const inject = ['tools'];
+export { compileParameters } from './compile.js';
+export { parseConfig, resolveToken, resolveDefaultChannel, requireToken, ENV_TOKEN, } from './config.js';
+export { createWebSlackClient, mapSlackError, assertChannel, assertText, } from './slack-client.js';
+export { buildNotifyTool, buildChannelsTool } from './tools.js';
+/**
+ * 插件入口。配置缺失【不失败】（懒加载）：只 console.warn；
+ * token 缺失在每个工具的 execute 时抛出带中文指引的错误。
+ */
+export function apply(ctx, rawConfig) {
+    let config;
+    try {
+        config = parseConfig(rawConfig);
+    }
+    catch (error) {
+        console.warn('[dsh-slack] 配置解析失败，工具将在调用时报错：', error);
+        config = undefined;
+    }
+    if (config === undefined) {
+        console.warn('[dsh-slack] 配置缺失或格式错误：slack_notify / slack_channels 已注册，但调用时会报错。请在 profile 的 cordis.patch.yml 配置 slack 行并重启。');
+    }
+    else {
+        const token = config.token.trim() || process.env.DSH_SLACK_TOKEN?.trim();
+        if (!token) {
+            console.warn('[dsh-slack] 未检测到 Slack 令牌（config.token 与 DSH_SLACK_TOKEN 均为空）：slack_notify / slack_channels 调用时会报错。');
+        }
+    }
+    const configProvider = () => config;
+    const clientProvider = () => {
+        // 每次调用时重新解析配置（config.token 优先，环境变量回退），并懒创建客户端。
+        const current = parseConfig(rawConfig);
+        const token = requireToken(current);
+        return createWebSlackClient(token);
+    };
+    const deps = { clientProvider, configProvider };
+    ctx.tools.register(buildNotifyTool(deps));
+    ctx.tools.register(buildChannelsTool(deps));
+}

package/lib/slack-client.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Slack 客户端抽象：生产用官方 @slack/web-api，测试注入 fake。
+ * 同时把 Slack 错误码映射为全中文提示，并抽出频道/文本校验纯函数。
+ */
+/** chat.postMessage 参数。 */
+export interface PostMessageParams {
+    channel: string;
+    text: string;
+    thread_ts?: string;
+}
+/** conversations.list 可见频道的最小信息。 */
+export interface ChannelInfo {
+    id: string;
+    name: string;
+}
+/** 可注入的 Slack 客户端抽象。 */
+export interface SlackClient {
+    /** 发消息，返回消息 ts（用于线程后续引用）。 */
+    postMessage(params: PostMessageParams): Promise<{
+        ts: string;
+    }>;
+    /** 列出机器人可见频道。 */
+    listChannels(): Promise<ChannelInfo[]>;
+}
+/** 用官方 WebClient 实现。 */
+export declare function createWebSlackClient(token: string): SlackClient;
+/**
+ * 把 Slack API 错误映射为全中文提示。
+ */
+export declare function mapSlackError(error: unknown): string;
+/** 校验 channel 参数：必须是非空字符串（频道名或频道 ID）。 */
+export declare function assertChannel(channel: unknown): string;
+/** 校验 text 参数：必须是非空字符串。 */
+export declare function assertText(text: unknown): string;

package/lib/slack-client.js

@@ -0,0 +1,65 @@
+/**
+ * Slack 客户端抽象：生产用官方 @slack/web-api，测试注入 fake。
+ * 同时把 Slack 错误码映射为全中文提示，并抽出频道/文本校验纯函数。
+ */
+import { WebClient } from '@slack/web-api';
+/** 用官方 WebClient 实现。 */
+export function createWebSlackClient(token) {
+    const client = new WebClient(token);
+    return {
+        async postMessage(params) {
+            const result = await client.chat.postMessage({
+                channel: params.channel,
+                text: params.text,
+                ...(params.thread_ts !== undefined ? { thread_ts: params.thread_ts } : {}),
+            });
+            const ts = typeof result.ts === 'string' ? result.ts : '';
+            return { ts };
+        },
+        async listChannels() {
+            const result = await client.conversations.list({ types: 'public_channel,private_channel' });
+            const channels = [];
+            for (const ch of result.channels ?? []) {
+                if (typeof ch.id === 'string' && typeof ch.name === 'string') {
+                    channels.push({ id: ch.id, name: ch.name });
+                }
+            }
+            return channels;
+        },
+    };
+}
+/**
+ * 把 Slack API 错误映射为全中文提示。
+ */
+export function mapSlackError(error) {
+    const data = error?.data;
+    const code = data?.error;
+    if (code === 'invalid_auth') {
+        return 'Slack 认证失败（invalid_auth）：token 无效、已撤销或过期。请检查并重新生成令牌，再在 profile 的 cordis.patch.yml 覆盖 slack 行的 config.token 并重启。';
+    }
+    if (code === 'channel_not_found') {
+        return '频道未找到（channel_not_found）：请检查频道名或频道 ID 是否正确（如 #general）。';
+    }
+    if (code === 'not_in_channel') {
+        return '机器人不在该频道中（not_in_channel）：请先把机器人 App 添加（invite）到该频道。';
+    }
+    if (code === 'token_revoked' || code === 'account_inactive' || code === 'missing_scope') {
+        return `Slack 令牌或权限不足（${code}）：请确认已勾选 chat:write 与 channels:read，并重新安装 App 拿新令牌。`;
+    }
+    const message = error?.message;
+    return message ? `Slack API 调用失败：${message}` : 'Slack API 调用失败：未知错误。';
+}
+/** 校验 channel 参数：必须是非空字符串（频道名或频道 ID）。 */
+export function assertChannel(channel) {
+    if (typeof channel !== 'string' || channel.trim() === '') {
+        throw new Error('channel 参数错误：必须是频道名（如 #general）或频道 ID 的非空字符串。');
+    }
+    return channel.trim();
+}
+/** 校验 text 参数：必须是非空字符串。 */
+export function assertText(text) {
+    if (typeof text !== 'string' || text.trim() === '') {
+        throw new Error('text 参数错误：必须是待发送的 Markdown 文本（非空字符串）。');
+    }
+    return text;
+}

package/lib/tools.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 构建两个面向模型的工具：slack_notify、slack_channels。
+ * 依赖通过 ToolDeps 注入（clientProvider / configProvider），测试可注入 fake client。
+ */
+import type { SlackConfig } from './config.js';
+import type { ToolDefinition } from './types.js';
+import type { SlackClient } from './slack-client.js';
+/** 工具构建的依赖注入点。 */
+export interface ToolDeps {
+    /** 返回一个 SlackClient；token 缺失时抛中文错误。 */
+    clientProvider: () => SlackClient;
+    /** 返回当前配置（供默认频道等解析）。 */
+    configProvider: () => SlackConfig | undefined;
+}
+/** 构建 slack_notify：向指定频道/线程发送 Markdown 文本，返回 ts。 */
+export declare function buildNotifyTool(deps: ToolDeps): ToolDefinition;
+/** 构建 slack_channels：列出机器人可见频道（conversations.list）。 */
+export declare function buildChannelsTool(deps: ToolDeps): ToolDefinition;

package/lib/tools.js

@@ -0,0 +1,118 @@
+/**
+ * 构建两个面向模型的工具：slack_notify、slack_channels。
+ * 依赖通过 ToolDeps 注入（clientProvider / configProvider），测试可注入 fake client。
+ */
+import { compileParameters } from './compile.js';
+import { resolveDefaultChannel } from './config.js';
+import { assertChannel, assertText, mapSlackError } from './slack-client.js';
+/** slack_notify 的输出 schema（原始 JSON Schema，纯 JSON 无 undefined）。 */
+const NOTIFY_OUTPUT_SCHEMA = {
+    type: 'object',
+    properties: {
+        ts: { type: 'string' },
+        channel: { type: 'string' },
+    },
+    required: ['ts', 'channel'],
+    additionalProperties: true,
+};
+/** slack_channels 的输出 schema。 */
+const CHANNELS_OUTPUT_SCHEMA = {
+    type: 'object',
+    properties: {
+        channels: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string' },
+                    name: { type: 'string' },
+                },
+                required: ['id', 'name'],
+                additionalProperties: true,
+            },
+        },
+    },
+    required: ['channels'],
+    additionalProperties: true,
+};
+function textBlock(text) {
+    return { type: 'text', text };
+}
+/** 构建 slack_notify：向指定频道/线程发送 Markdown 文本，返回 ts。 */
+export function buildNotifyTool(deps) {
+    const defaultChannel = resolveDefaultChannel(deps.configProvider());
+    const channelDescription = defaultChannel
+        ? `目标频道：频道名（如 #general）或频道 ID。未特别指定时可使用默认频道 ${defaultChannel}。`
+        : '目标频道：频道名（如 #general）或频道 ID。';
+    const parameters = compileParameters({
+        channel: { type: 'string', required: true, description: channelDescription },
+        text: { type: 'string', required: true, description: '要发送的 Markdown 文本内容。' },
+        thread_ts: { type: 'string', description: '可选：回复某条消息所在线程的 ts（即 slack_notify 返回的 ts）。' },
+    });
+    const output = {
+        schema: NOTIFY_OUTPUT_SCHEMA,
+        render: (_args, value) => {
+            const v = value;
+            return [textBlock(`已发送到 ${v.channel}（消息 ts：${v.ts}）。`)];
+        },
+    };
+    return {
+        name: 'slack_notify',
+        description: '向指定 Slack 频道（或线程）发送一条 Markdown 文本消息，返回消息 ts 供后续引用。',
+        parameters,
+        output,
+        timeoutMs: 30000,
+        async execute(args) {
+            const raw = args;
+            const channel = assertChannel(raw.channel);
+            const text = assertText(raw.text);
+            const thread_ts = typeof raw.thread_ts === 'string' && raw.thread_ts.trim() !== ''
+                ? raw.thread_ts.trim()
+                : undefined;
+            const client = deps.clientProvider();
+            try {
+                const result = await client.postMessage({
+                    channel,
+                    text,
+                    ...(thread_ts !== undefined ? { thread_ts } : {}),
+                });
+                return { ts: result.ts, channel };
+            }
+            catch (error) {
+                throw new Error(mapSlackError(error));
+            }
+        },
+    };
+}
+/** 构建 slack_channels：列出机器人可见频道（conversations.list）。 */
+export function buildChannelsTool(deps) {
+    const parameters = compileParameters({});
+    const output = {
+        schema: CHANNELS_OUTPUT_SCHEMA,
+        render: (_args, value) => {
+            const v = value;
+            if (v.channels.length === 0) {
+                return [textBlock('机器人当前看不到任何频道（可能需要先把 App 加入频道）。')];
+            }
+            const names = v.channels.map((c) => `#${c.name}`).join('、');
+            return [textBlock(`机器人可见频道（${v.channels.length} 个）：${names}。`)];
+        },
+    };
+    return {
+        name: 'slack_channels',
+        description: '列出当前 Slack 机器人可见的频道（conversations.list）。',
+        parameters,
+        output,
+        timeoutMs: 30000,
+        async execute() {
+            const client = deps.clientProvider();
+            try {
+                const channels = await client.listChannels();
+                return { channels: channels.map((c) => ({ id: c.id, name: c.name })) };
+            }
+            catch (error) {
+                throw new Error(mapSlackError(error));
+            }
+        },
+    };
+}

package/lib/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * dsh-slack 自包含的最小结构类型，与宿主（@deepseek-ai/dsh-tools）运行时 API 兼容。
+ * 插件只做结构化调用，运行时不 import 任何 @deepseek-ai/* 包。
+ */
+/** 面向模型/UI 的文本内容块。 */
+export type ContentBlock = {
+    type: 'text';
+    text: string;
+};
+/** 工具的输出声明：schema 必须是原始 JSON Schema，render 是纯投影。 */
+export interface ToolOutputDefinition {
+    readonly schema: unknown;
+    render(args: unknown, value: unknown): ContentBlock[];
+}
+/** 注册给 ctx.tools.register 的工具定义（与宿主 ToolDefinition 结构兼容）。 */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: unknown;
+    readonly output: ToolOutputDefinition;
+    execute(args: unknown, exec?: unknown): Promise<unknown>;
+    timeoutMs?: number;
+}
+/** 插件所需的最小 Context 形状（宿主传入真实的 Cordis Context）。 */
+export interface SlackContext {
+    tools: {
+        register(definition: ToolDefinition): () => void;
+    };
+}

package/lib/types.js

@@ -0,0 +1,5 @@
+/**
+ * dsh-slack 自包含的最小结构类型，与宿主（@deepseek-ai/dsh-tools）运行时 API 兼容。
+ * 插件只做结构化调用，运行时不 import 任何 @deepseek-ai/* 包。
+ */
+export {};

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "dsh-slack",
+  "version": "0.1.0",
+  "description": "DSH 社区插件：Slack 通知/桥接（v0.1 单向 agent→Slack，配置走 cordis.patch.yml）",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json",
+    "./cordis.patch.yml": "./cordis.patch.yml"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "license": "MIT",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepare": "tsc -p tsconfig.json",
+    "test": "pnpm run build && node --test \"test/*.test.mjs\"",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dependencies": {
+    "@slack/web-api": "^8.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.7.3"
+  },
+  "repository": {
+    "url": "https://github.com/STARDUSTLC666/dsh-slack",
+    "type": "git"
+  },
+  "bugs": {
+    "url": "https://github.com/STARDUSTLC666/dsh-slack/issues"
+  },
+  "homepage": "https://github.com/STARDUSTLC666/dsh-slack#readme",
+  "author": "stardustlc",
+  "keywords": [
+    "dsh-plugin",
+    "deepseek-harness",
+    "dsh"
+  ]
+}