dsh-task-dispatch-table 0.1.12 → 0.1.13

package/dist/config.d.ts

@@ -28,7 +28,17 @@ export interface PluginConfig {
      */
     /** 上传临时区保留期（天）：到期文件由 tick 内清道夫删除（默认 7）。 */
     attachmentTmpRetentionDays: number;
+    /** 侧栏显示名；空串 = 用词典默认名（`panelTitle`）。 */
+    displayName: string;
+    /** 侧栏入口位置：`first` = 一级菜单（默认）；`more` = 收进「更多」菜单。 */
+    entryMode: EntryMode;
+    /** 屏蔽官方「自动化任务」入口（`@deepseek-ai/dsh-client-ui-schedule`）；false = 不屏蔽（默认）。 */
+    hideOfficialSchedule: boolean;
 }
+/** 侧栏入口的两档位置（设置区下拉的取值，别用自由字符串）。 */
+export type EntryMode = 'first' | 'more';
+/** `entryMode` 的合法取值（服务端校验 + 前端下拉共用，防两处漂移）。 */
+export declare const ENTRY_MODES: readonly EntryMode[];
 /**
  * **系统默认值**（全量，含字符串路径类）—— `Config` schema 与设置页「用户没设时显示什么」的唯一真源。
  *
@@ -50,6 +60,9 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     defaultModel: z<string, string, "defined">;
     logRetentionDays: z<number, number, "defined">;
     attachmentTmpRetentionDays: z<number, number, "defined">;
+    displayName: z<string, string, "defined">;
+    entryMode: z<string, string, "defined">;
+    hideOfficialSchedule: z<boolean, boolean, "defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
     statePath: z<string, string, "defined">;
     tickMs: z<number, number, "defined">;
@@ -63,6 +76,9 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     defaultModel: z<string, string, "defined">;
     logRetentionDays: z<number, number, "defined">;
     attachmentTmpRetentionDays: z<number, number, "defined">;
+    displayName: z<string, string, "defined">;
+    entryMode: z<string, string, "defined">;
+    hideOfficialSchedule: z<boolean, boolean, "defined">;
 }>>, "plain">;
 /**
  * rc.1 volatile 字段的解析结果是**带 get() 的引用**（非纯值）；读取时解包（与参考插件

package/dist/config.js

@@ -4,6 +4,8 @@
 import { homedir } from 'node:os';
 import { join, resolve } from 'node:path';
 import z from '@deepseek-ai/schemastery';
+/** `entryMode` 的合法取值（服务端校验 + 前端下拉共用，防两处漂移）。 */
+export const ENTRY_MODES = ['first', 'more'];
 /**
  * **系统默认值**（全量，含字符串路径类）—— `Config` schema 与设置页「用户没设时显示什么」的唯一真源。
  *
@@ -24,6 +26,9 @@ export const CONFIG_DEFAULTS = {
     unknownGraceMs: 5 * 60_000,
     logRetentionDays: 30,
     attachmentTmpRetentionDays: 7,
+    displayName: '',
+    entryMode: 'first',
+    hideOfficialSchedule: false,
 };
 // ⚠️ rc.1（0.1.7-rc.1）约束：宿主插件配置字段**不能标 .volatile()**。
 // 实测根因（set717/lib/index.js:417 + types/index.js:368-380）：configForms 的读写都要求字段
@@ -48,6 +53,12 @@ export const Config = z.object({
     defaultModel: z.string().default(CONFIG_DEFAULTS.defaultModel),
     logRetentionDays: z.number().min(1).default(CONFIG_DEFAULTS.logRetentionDays),
     attachmentTmpRetentionDays: z.number().min(1).default(CONFIG_DEFAULTS.attachmentTmpRetentionDays),
+    // ── 设置区（插件详情页）三个字段：显示名 / 入口位置 / 屏蔽官方自动化 ──
+    // entryMode 用 string 而非字面量联合：schemastery 的 union 在宿主界面上没好处，
+    // 合法性由服务端白名单（ENTRY_MODES）与前端下拉共同保证。
+    displayName: z.string().default(CONFIG_DEFAULTS.displayName),
+    entryMode: z.string().default(CONFIG_DEFAULTS.entryMode),
+    hideOfficialSchedule: z.boolean().default(CONFIG_DEFAULTS.hideOfficialSchedule),
 });
 /**
  * rc.1 volatile 字段的解析结果是**带 get() 的引用**（非纯值）；读取时解包（与参考插件
@@ -71,7 +82,7 @@ export function readConfigField(field, fallback) {
 export function resolveStatePath(statePath) {
     if (statePath.trim().length > 0)
         return resolve(statePath);
-    const raw = process.env['DSH_HOME'];
+    const raw = process.env.DSH_HOME;
     const selected = raw !== undefined && raw.trim().length > 0 ? raw : join(homedir(), '.dsh');
     const home = selected === '~' || selected.startsWith('~/')
         ? join(homedir(), selected.slice(selected.length === 1 ? 1 : 2))

package/dist/index.d.ts

@@ -17,8 +17,8 @@ export type { PluginConfig };
  *   `tasksInline`（整份任务表 JSON）与 `debugSnapshot`（宿主调试数据），不能整份吐给浏览器。
  */
 export declare function configView(config: PluginConfig): {
-    config: Record<string, string | number>;
-    defaults: Record<string, string | number>;
+    config: Record<string, string | number | boolean>;
+    defaults: Record<string, string | number | boolean>;
 };
 /** 附件约束（白名单/上限/扩展名解析）与浏览器端预检**共用同一份**，防两处漂移。 */
 export { ATTACHMENT_MAX_BYTES, ALLOWED_ATTACHMENT_EXT, extOf } from './attachment-allowlist.js';

package/dist/official-schedule.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 官方「自动化任务」入口的开关（宿主 0.2.2-rc.1 源码核实，结论见
+ * `docs/design/external/official-schedule-toggle.md`）。
+ *
+ * 为什么必须借道宿主的插件管理器：官方 slots 没有「隐藏他人条目」的接口，唯一的正路是把
+ * `@deepseek-ai/dsh-client-ui-schedule` 这条组合行停用（写 profile 的 `disabled` 覆盖项）。
+ * 停用后该行仍留在 loader 的 entry 表里（只是没有 fiber），所以插件清单看得到、也还能再启用。
+ *
+ * ⚠️ 不写进 inject：`pluginManager` 缺失时整块要能安静降级（决策 17：组合满足不了的依赖会让
+ * entry 一直 pending）。
+ */
+import type { HostContext, HostLogger } from './host.js';
+/** 官方自动化任务界面所在的包（组合行 id `ui-schedule`，声明在 `@deepseek-ai/dsh-web-app` 的 patch）。 */
+export declare const OFFICIAL_SCHEDULE_PACKAGE = "@deepseek-ai/dsh-client-ui-schedule";
+/** 插件清单行（`pluginManager.listPlugins()` 投影的子集）。 */
+interface PluginRow {
+    entryId: string;
+    moduleName: string;
+    enabled: boolean;
+    readOnlyReason?: string;
+}
+/** `ctx.pluginManager` 用到的最小面（TypertRemoteService，宿主 0.2.2-rc.1 `lib/types/index.d.ts:187`）。 */
+export interface PluginManagerFace {
+    listPlugins(): Promise<PluginRow[]>;
+    setPluginEnabled(id: string, enabled: boolean): Promise<unknown>;
+}
+/**
+ * 取宿主插件管理器；缺失 / 面不齐 ⇒ null（调用方降级并只记一条日志）。
+ * @param ctx - 宿主上下文。
+ */
+export declare function pluginManagerOf(ctx: HostContext): PluginManagerFace | null;
+/**
+ * 让官方自动化入口处在 `hidden` 说的状态（幂等：本来就对就一次写都不发）。
+ * @param ctx - 宿主上下文（取 `pluginManager`）。
+ * @param logger - 宿主 logger（降级/失败原因留痕，别静默）。
+ * @param hidden - true = 屏蔽官方入口；false = 放出来。
+ * @returns 是否已对齐；false 表示宿主不支持或该行不可寻址。
+ */
+export declare function syncOfficialSchedule(ctx: HostContext, logger: HostLogger, hidden: boolean): Promise<boolean>;
+/**
+ * 卸载前放回官方入口（只在我们自己设过「屏蔽」时调用）。
+ *
+ * ⚠️ 不能同步等：卸载正是插件管理器持着 profile 文件锁做 reload 时触发的，此处再调一次
+ * `setPluginEnabled` 会去等同一把锁（120s）。故丢一个延后调用出去，等外层操作放锁后再跑。
+ * 宿主进程紧接退出时这一枪可能没打出去 —— 兜底是用户在插件页手动把那行打开。
+ * @param logger - 宿主 logger。
+ */
+export declare function releaseOfficialSchedule(logger: HostLogger): void;
+export {};

package/dist/official-schedule.js

@@ -0,0 +1,74 @@
+/** 官方自动化任务界面所在的包（组合行 id `ui-schedule`，声明在 `@deepseek-ai/dsh-web-app` 的 patch）。 */
+export const OFFICIAL_SCHEDULE_PACKAGE = '@deepseek-ai/dsh-client-ui-schedule';
+/**
+ * 取宿主插件管理器；缺失 / 面不齐 ⇒ null（调用方降级并只记一条日志）。
+ * @param ctx - 宿主上下文。
+ */
+export function pluginManagerOf(ctx) {
+    const service = ctx.get('pluginManager');
+    if (typeof service !== 'object' || service === null)
+        return null;
+    const face = service;
+    if (typeof face.listPlugins !== 'function' || typeof face.setPluginEnabled !== 'function')
+        return null;
+    return face;
+}
+/** 上次拿到的管理器面：dispose 之后 `ctx.get` 未必还可用，回滚要能用旧引用。 */
+let cached = null;
+/** 找到官方自动化那一行（找不到 = 宿主改版换了包名/行，只记 warn 不抛）。 */
+async function scheduleRow(manager) {
+    return (await manager.listPlugins()).find((row) => row.moduleName === OFFICIAL_SCHEDULE_PACKAGE);
+}
+/**
+ * 让官方自动化入口处在 `hidden` 说的状态（幂等：本来就对就一次写都不发）。
+ * @param ctx - 宿主上下文（取 `pluginManager`）。
+ * @param logger - 宿主 logger（降级/失败原因留痕，别静默）。
+ * @param hidden - true = 屏蔽官方入口；false = 放出来。
+ * @returns 是否已对齐；false 表示宿主不支持或该行不可寻址。
+ */
+export async function syncOfficialSchedule(ctx, logger, hidden) {
+    const manager = pluginManagerOf(ctx);
+    if (manager === null) {
+        logger.warn('[官方自动化] 宿主没有 pluginManager 服务，屏蔽开关不生效');
+        return false;
+    }
+    cached = manager;
+    const row = await scheduleRow(manager);
+    if (row === undefined) {
+        logger.warn(`[官方自动化] 插件清单里找不到 ${OFFICIAL_SCHEDULE_PACKAGE}，屏蔽开关不生效`);
+        return false;
+    }
+    if (row.readOnlyReason !== undefined) {
+        logger.warn(`[官方自动化] 该行不可管理（${row.readOnlyReason}），屏蔽开关不生效`);
+        return false;
+    }
+    if (row.enabled === !hidden)
+        return true;
+    await manager.setPluginEnabled(row.entryId, !hidden);
+    logger.info(`[官方自动化] 已${hidden ? '屏蔽' : '放出'}官方自动化入口（重启或 HMR 后生效）`);
+    return true;
+}
+/**
+ * 卸载前放回官方入口（只在我们自己设过「屏蔽」时调用）。
+ *
+ * ⚠️ 不能同步等：卸载正是插件管理器持着 profile 文件锁做 reload 时触发的，此处再调一次
+ * `setPluginEnabled` 会去等同一把锁（120s）。故丢一个延后调用出去，等外层操作放锁后再跑。
+ * 宿主进程紧接退出时这一枪可能没打出去 —— 兜底是用户在插件页手动把那行打开。
+ * @param logger - 宿主 logger。
+ */
+export function releaseOfficialSchedule(logger) {
+    const manager = cached;
+    if (manager === null)
+        return;
+    setTimeout(() => {
+        void (async () => {
+            const row = await scheduleRow(manager);
+            if (row === undefined || row.enabled || row.readOnlyReason !== undefined)
+                return;
+            await manager.setPluginEnabled(row.entryId, true);
+            logger.info('[官方自动化] 插件卸载，已放回官方自动化入口');
+        })().catch((error) => {
+            logger.warn(`[官方自动化] 卸载回滚失败：${error instanceof Error ? error.message : String(error)}`);
+        });
+    }, 0);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-task-dispatch-table",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "Scheduled task dispatcher: a dsh host plugin that drives recurring agent tasks from a single task table, dispatching each run as an independent dsh session (scheduling itself uses zero model calls)",
   "icon": "./assets/icon-scheduler.svg",
   "keywords": [