@addozhang/dsh-discord 0.6.3-rc.1 → 0.6.4-rc.2

package/README.md

@@ -23,6 +23,7 @@ No extra process: the adapter is a DSH plugin that mounts straight onto your `ds
 - **Approvals & questions** — DSH asks become buttons, select menus, and a free-text modal. Ownership is enforced (the asker — or the thread owner on later turns — clicks), expiry sweeps fail closed, and settled controls grey out in place.
 - **Session control** — `/steer`, `/stop`, and `/queue list|remove` with turn-ownership checks; `/project bind|list|info` and `/session resume` for guild↔workspace binding and history; `/guild forget` for operator cleanup.
 - **Model selection** — `/model show` reads the session's live model directory; `/model select` walks an interactive provider → model → reasoning cascade, or applies a typed `provider/model` directly. Open to any authorized member by default; restrictable to Host operators.
+- **Adapter status** — `/info` shows the adapter version, connection state, and project links (feedback, docs). Works in any channel.
 - **Permission switching** — `/permission show` / `set` read and switch the session's permission preset (bundled sandbox + approval tiers) through the Host's own `/permission` command path, inheriting its journal audit pair; `danger-full-access` requires a button confirmation.
 - **Settings card, bilingual out of the box** — token onboarding and connect/disconnect (stored in the Host credential service, never in settings or logs), guild allowlist, auto-archive, and language. Every Discord-visible string ships in Chinese and English; the bot follows the DSH language preference or a pinned choice.
 - **Hardened by design** — deny-first authorization inside an explicit guild allowlist. Mentions are suppressed twice: `allowed_mentions` on every request, plus byte-level neutralization of the wire body. DSH submission is at-most-once with unknown-preserving reconciliation — an ambiguous delivery is never blindly resent. Bindings survive restarts, and the READY sweep rebuilds deleted category/control channels while treating a deleted workspace channel as user intent (the mapping retires; the workspace stays bindable).
@@ -122,6 +123,7 @@ The settings card exposes the three high-frequency fields (guild allowlist, auto
 | `/project list` / `info` | any channel | list workspaces / inspect this channel's binding |
 | `/queue list`, `/queue remove` | session thread | inspect and trim the pending queue |
 | `/steer`, `/stop` | session thread | steer or cancel the running turn — any member of the thread may act on the current turn (the thread is a deliberately shared surface: single-user and small-team deployments; approvals/questions stay stricter — asker or thread owner only) |
+| `/info` | any channel | show the adapter version, connection state, and project links |
 | `/model show` / `select` | session thread | show the live model directory; `select` without arguments walks the interactive provider → model → reasoning cascade (any authorized member by default) |
 | `/session resume` | project channel | pick one of this workspace's past sessions (autocomplete: title and age, newest first) and resume it into a new thread of this channel; blank, already-bound, subagent, and archived sessions are never offered. The thread renders the session's history — answers and tool summaries plus the user's inputs as quoted echo lines (plugin/system injections are never echoed). After an adapter restart, threads catch up only what they missed: a persisted render watermark suppresses already-delivered history, and bound sessions re-subscribe on reconnect so turns prompted from the web UI still land in their thread |
 | `/guild forget` | any channel | operator-only removal of adapter records |

package/README.zh.md

@@ -23,6 +23,7 @@
 - **审批与提问** — DSH 的 ask 渲染为按钮、下拉菜单与自由文本弹窗。所有权强制校验（提问者——或后续 Turn 的线程属主——才能点击），超时清扫 fail-closed，结算后的控件原地置灰。
 - **会话控制** — `/steer`、`/stop`、`/queue list|remove` 带运行所有权校验；`/project bind|list|info` 与 `/session resume` 管理 Guild↔工作区绑定与历史会话；`/guild forget` 供操作员清理。
 - **模型切换** — `/model show` 读取会话的实时模型目录；`/model select` 走交互式 provider → 模型 → 推理强度级联，也可直接填写 `provider/model` 应用。默认对所有授权成员开放，可收紧为仅 Host 操作员。
+- **适配器状态** — `/info` 显示适配器版本、连接状态与项目链接（反馈/文档）。任意频道可用。
 - **权限切换** — `/permission show` / `set` 读写会话权限预设（沙箱 + 审批捆绑档位），走宿主自己的 `/permission` 命令路径，journal 自动记审计；`danger-full-access` 需按钮二次确认。
 - **设置卡片，开箱双语** — Token 引导与连接/断开（存入 Host 凭据服务，绝不写入设置或日志）、服务器白名单、自动归档与语言。所有 Discord 可见文案提供中英双语；Bot 默认跟随 DSH 语言偏好，也可从卡片固定。
 - **安全设计** — 显式服务器白名单内的 deny-first 授权。提及抑制双保险：每条请求携带 `allowed_mentions`，外加 wire body 的字节级提及中和。DSH 提交至多一次，并做保留 unknown 的对账——结果不明的投递绝不盲目重发。绑定重启后持久；READY 扫描会重建被删除的 category/控制频道，而把被删除的工作区频道视为用户意图（解除映射，workspace 保持可重新绑定）。
@@ -122,6 +123,7 @@ dsh-discord:
 | `/project list` / `info` | 任意频道 | 列出工作区 / 查看当前频道绑定 |
 | `/queue list`, `/queue remove` | 会话线程 | 查看与移除待处理队列 |
 | `/steer`, `/stop` | 会话线程 | 插话或取消运行中的 Turn——线程内任意成员可操作当前 Turn（有意为之的共享驾驶舱模型，面向单人与小团队场景；审批/提问保持更严的提问人-or-线程主人规则） |
+| `/info` | 任意频道 | 显示适配器版本、连接状态与项目链接 |
 | `/model show` / `select` | 会话线程 | 查看实时模型目录；`select` 不带参数时走交互式 provider → 模型 → 推理强度级联（默认对所有授权成员开放） |
 | `/session resume` | 项目频道 | 自动补全选择本工作区的历史会话（显示标题与时间，最新优先），恢复为当前频道的新线程；空白、已挂线程、subagent、已归档的会话不会出现。线程会渲染会话历史——回答与工具摘要之外，用户输入以引用行回显（插件/系统注入永不回显）。适配器重启后线程只补齐错过部分：持久化的渲染水位抑制已投递过的历史，已绑定会话在重连时自动重订阅，因此从 web UI 发起的回合也会落进对应线程 |
 | `/guild forget` | 任意频道 | 仅操作员：移除适配器记录 |

package/lib/client.js

@@ -1374,7 +1374,7 @@ function DiscordSettingsCard(props) {
     { value: "auto", label: t("discordLanguageAuto") },
     ...LANGUAGE_CHOICES
   ];
-  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_jsx_runtime4.Fragment, { children: /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
     PluginCard,
     {
       copy,
@@ -1471,10 +1471,11 @@ function DiscordSettingsCard(props) {
               props.resetField(LANGUAGE_FIELD);
             }
           }
-        )
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("p", { "data-dsh-discord-card-footer-link": "", style: { margin: "6px 2px 0", fontSize: 12, opacity: 0.6 }, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("a", { href: "https://github.com/addozhang/dsh-discord", target: "_blank", rel: "noopener noreferrer", children: "\u2B50 Feedback & docs" }) })
       ]
     }
-  );
+  ) });
 }
 
 // src/client/index.ts

package/lib/discord/commands.js

@@ -27,6 +27,7 @@ export const MILESTONE_ONE_COMMANDS = [
         { name: 'list' },
         { name: 'remove', options: [{ name: 'item', required: true }] },
     ]),
+    leaf('info', 'Show the adapter version, connection state, and project links'),
     leaf('steer', 'Steer the running turn of this thread', [{ name: 'prompt', required: true }]),
     leaf('stop', 'Cancel the running turn of this thread'),
     grouped('model', 'Show or select the session model', [

package/lib/features/interaction-router.d.ts

@@ -60,6 +60,10 @@ export interface InteractionRouterDeps {
     } | undefined>;
     /** Delete every adapter-owned record for one guild (DSH untouched). */
     forgetGuild: (guildId: string) => Promise<void>;
+    /** The adapter's own package version (from package.json at load). */
+    adapterVersion: () => string;
+    /** One-word connection condition for /info. */
+    adapterStatus: () => string;
     /** Ephemeral failure/guidance followup on a component interaction. */
     componentFollowUp: (interactionId: string, interactionToken: string, content: string) => Promise<void>;
     /** Retire a rendered control (remove its components on the source message). */

package/lib/features/interaction-router.js

@@ -469,6 +469,10 @@ export function createInteractionRouter(deps) {
                     }]);
                 return;
             }
+            if (event.commandName === 'info') {
+                await followUp(deps.copy.infoLine(deps.adapterVersion(), deps.adapterStatus()));
+                return;
+            }
             if (event.commandName === 'model') {
                 const options = event.data['options'];
                 const subcommand = Array.isArray(options) ? options[0] : undefined;

package/lib/i18n.d.ts

@@ -61,6 +61,7 @@ declare const zh: {
     forgetConfirmPrompt: string;
     forgetConfirmButton: string;
     forgetDone: string;
+    infoLine: (version: string, connection: string) => string;
     commandFailed: string;
     confirmNotOwner: string;
     submittedAck: string;

package/lib/i18n.js

@@ -34,7 +34,7 @@ const zh = {
     infoUnavailable: '⚠️ 无法读取工作区目录，请稍后重试。',
     infoRevision: (revision, binder) => `修订 ${revision}（由 <@${binder}> 绑定）`,
     infoPath: (path) => `路径：\`${path}\``,
-    unknownSubcommand: '💡 未知子命令。',
+    unknownSubcommand: '💡 未知子命令。反馈与文档: https://github.com/addozhang/dsh-discord',
     // ── /stop /steer /queue ──────────────────────────────────────────────
     stopNotSessionThread: '⚠️ 此频道不是适配器拥有的会话线程。',
     stopNothingRunning: '此线程当前没有可停止的运行中任务。',
@@ -64,6 +64,7 @@ const zh = {
     forgetConfirmPrompt: '⚠️ 将删除本 Guild 的全部适配器记录（绑定/意图；DSH 工作区与 Session 不受影响）。确认？',
     forgetConfirmButton: '确认忘记',
     forgetDone: '💡 已忘记本 Guild：适配器记录（绑定/意图）已删除；DSH 工作区与 Session 未受影响。',
+    infoLine: (version, connection) => `📡 dsh-discord v${version} · ${connection}\n⭐ 反馈与文档: https://github.com/addozhang/dsh-discord`,
     // ── interaction failures / denials ───────────────────────────────────
     commandFailed: '⚠️ 命令处理失败，请稍后重试。',
     confirmNotOwner: '⚠️ 此确认不属于你。',
@@ -194,7 +195,7 @@ const en = {
     infoUnavailable: '⚠️ The workspace directory is temporarily unavailable; try again later.',
     infoRevision: (revision, binder) => `Revision ${revision} (bound by <@${binder}>)`,
     infoPath: path => `Path: \`${path}\``,
-    unknownSubcommand: '💡 Unknown subcommand.',
+    unknownSubcommand: '💡 Unknown subcommand. Feedback & docs: https://github.com/addozhang/dsh-discord',
     stopNotSessionThread: '⚠️ This channel is not an adapter-owned session thread.',
     stopNothingRunning: 'This thread has no running task to stop.',
     stopNotOwner: '⚠️ The running task was not submitted from this thread and cannot be stopped here.',
@@ -222,6 +223,7 @@ const en = {
     forgetConfirmPrompt: '⚠️ This deletes every adapter-owned record for this Guild (bindings/intents; DSH workspaces and sessions are untouched). Continue?',
     forgetConfirmButton: 'Confirm forget',
     forgetDone: '💡 Guild forgotten: adapter records (bindings/intents) are deleted; DSH workspaces and sessions are untouched.',
+    infoLine: (version, connection) => `📡 dsh-discord v${version} · ${connection}\n⭐ Feedback & docs: https://github.com/addozhang/dsh-discord`,
     commandFailed: '⚠️ Command handling failed; try again later.',
     confirmNotOwner: '⚠️ This confirmation is not yours.',
     submittedAck: '💡 Your choice has been submitted.',

package/lib/index.js

@@ -16,6 +16,7 @@ import { sweepExpiredApprovals } from './features/approval-expiry.js';
 import { sweepExpiredQuestions } from './features/question-expiry.js';
 import { createQuestionStore } from './features/question-store.js';
 import { createTrailingSingleFlight } from './features/single-flight.js';
+import { ADAPTER_VERSION } from './version.js';
 import { handleSelectInput, handleModalSubmit } from './features/question-routing.js';
 import { createCopy, permissionPresetLabel } from './i18n.js';
 import { createInteractionRouter } from './features/interaction-router.js';
@@ -900,6 +901,11 @@ export function apply(ctx, config = DEFAULT_DISCORD_SETTINGS) {
             turnTracker,
             queueSnapshots,
             forgetGuild,
+            adapterVersion: () => ADAPTER_VERSION,
+            adapterStatus: () => {
+                const g = statusTracker.project().connection;
+                return g === 'connected' ? 'connected' : g === 'connecting' ? 'connecting' : 'disconnected';
+            },
             componentFollowUp,
             disableControl: key => askWiring.disableControl(key),
             handleQuestionComponent: input => handleSelectInput(questionRoutingDeps, input),

package/lib/version.d.ts

@@ -0,0 +1,2 @@
+export declare const ADAPTER_VERSION: string;
+export declare const REPO_URL: "https://github.com/addozhang/dsh-discord";

package/lib/version.js

@@ -0,0 +1,11 @@
+/**
+ * The adapter's own package version, read at load time from the
+ * package.json that always sits next to lib/ in the installed tree.
+ * Surfaced by /info and the settings-card RPC for support and discovery.
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const pkgPath = join(dirname(fileURLToPath(import.meta.url)), '../package.json');
+export const ADAPTER_VERSION = JSON.parse(readFileSync(pkgPath, 'utf8')).version;
+export const REPO_URL = 'https://github.com/addozhang/dsh-discord';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@addozhang/dsh-discord",
-  "version": "0.6.3-rc.1",
+  "version": "0.6.4-rc.2",
   "description": "Discord adapter for DeepSeek Harness · DeepSeek Harness 的 Discord 适配器",
   "license": "MIT",
   "type": "module",