dsh-plugin-tool-management 0.6.0 → 0.8.0

package/lib/skills/core.js

@@ -178,6 +178,9 @@ export function customRootsFromState(stateValue) {
             label: typeof item.label === "string" && item.label.trim()
                 ? item.label.trim().slice(0, 64)
                 : "自定义目录",
+            // 用户加进来的来源（相对「按约定发现」的 dsh / hub / agents / codex / claude）：
+            // 界面据此决定要不要给「永久删除」——只有自定义来源能真正从插件里删掉记录。
+            custom: true,
             mutable: false,
             toggleable: true,
             native: false,
@@ -280,6 +283,10 @@ export async function removeCustomRoot(key, log) {
     delete current.state.sources[clean];
     delete current.state.disabledSkills[clean];
     delete current.state.enabledSkills[clean];
+    // 已移除记录一起清掉：否则「永久删除」之后状态文件里还留着一条指向不存在来源的脏键
+    // （读取时的 normalize 会丢弃它，但没理由写进去）。
+    if (Array.isArray(current.state.removedSources))
+        current.state.removedSources = current.state.removedSources.filter((key) => key !== clean);
     await writeManagerState(current.state);
     if (log)
         log("custom-remove", `移除自定义技能目录 ${target.path} (${clean})`);
@@ -876,7 +883,10 @@ async function writeFileAtomically(path, content) {
     const temp = join(dirname(path), `.${basename(path)}.dssm-${randomUUID()}.tmp`);
     try {
         await fs.writeFile(temp, content, "utf8");
-        await fs.rename(temp, path);
+        // Windows 上目标文件会被杀软/索引器短暂占住（EPERM/EACCES/EBUSY）——
+        // 场景模式进出时这里写的是技能来源/策略状态，rename 被撞 = 运行时已切、
+        // 状态没落盘。与 rules-index.json 同一处理：重试瞬时占用，全失败才抛。
+        await renameWithRetry(temp, path);
     }
     catch (error) {
         await fs.rm(temp, { force: true }).catch(() => undefined);
@@ -2904,6 +2914,8 @@ export async function state(options = {}) {
                 mutable: root.mutable,
                 deletable: root.deletable === true,
                 removable: !isDefaultSkillSource(root) && root.scope !== "project",
+                // 自定义来源（用户手加的目录）：只有它能「永久删除」——按约定发现的来源删不掉。
+                custom: root.custom === true,
                 // 默认来源（dsh / hub）：界面据此隐藏来源开关、只显示「可管理」标记。
                 defaultSource: isDefaultSkillSource(root),
                 toggleable: root.toggleable,
@@ -2983,6 +2995,8 @@ export async function state(options = {}) {
             truncated: truncated === true,
             // 界面用：能否从管理器「移除」（不再读取）。dsh / hub / 项目级不可移除。
             removable: !isDefaultSkillSource(root) && root.scope !== "project",
+            // 自定义来源（用户手加的目录）：只有它能「永久删除」——按约定发现的来源删不掉。
+            custom: root.custom === true,
             // 默认来源（dsh / hub）：界面据此隐藏来源开关（它们不能停用），换成「可管理」标记。
             defaultSource: isDefaultSkillSource(root),
             removed: false,

package/lib/skills/service.js

@@ -397,6 +397,9 @@ export function createSkillsService(ctx) {
     // 写操作清单：与下方 ops 表同文件同源维护；HTTP 端门禁由 index.ts 从本集合派生，勿在宿主端另抄一份。
     const writeOps = new Set([
         'skill-enable', 'skill-disable', 'skill-source-enable', 'skill-source-disable',
+        // 移除/恢复来源会改写本地来源状态（listProviderCandidates 随之变化，模型侧的技能目录
+        // 也变），是写操作；漏在这份清单里 = 配了访问令牌也不会被要求带令牌。
+        'skill-source-remove', 'skill-source-restore',
         'skill-prefer', 'skill-unprefer',
         'skill-create', 'skill-import', 'skill-upload', 'skill-delete',
         'skill-trash-restore', 'skill-trash-delete', 'skill-custom-add', 'skill-custom-remove',

package/lib/subagents/catalog.js

@@ -0,0 +1,89 @@
+import { filterBySceneBinding } from './tools.js';
+/**
+ * 描述截断长度 —— 照抄官方技能目录的默认值
+ * （`dsh-tool-skill` 的 `DEFAULT_CATALOG_DESCRIPTION_MAX_LENGTH = 500`）。
+ *
+ * 照抄的理由：截断风格与模型**已经见过的**技能目录一致，不用让它适应两套习惯；
+ * 而且这是官方旋钮的默认值，不是本插件拍脑袋定的数。日后 token 成本成为问题时，
+ * 官方对应的旋钮是 `catalogDescriptionMaxLength`。
+ */
+export const DEFAULT_CATALOG_DESCRIPTION_MAX_LENGTH = 500;
+/** 段里最多列几个人设；超出部分只报数量，让模型自己去调 subagent_list。 */
+export const DEFAULT_CATALOG_MAX_ENTRIES = 40;
+/** 无描述时的占位，与 `subagent_list` 工具的输出保持同一口径。 */
+const NO_DESCRIPTION = '(无描述)';
+/**
+ * 描述归一化 + 截断 —— 逐字对齐官方 `dsh-tool-skill` 的实现：
+ * 先把所有空白折叠成单空格，再按长度截断并补省略号。保证「一人设一行」。
+ */
+export function catalogDescription(value, maxLength) {
+    const normalized = String(value ?? '').replaceAll(/\s+/g, ' ').trim();
+    if (normalized.length <= maxLength)
+        return normalized;
+    return `${normalized.slice(0, maxLength - 3)}...`;
+}
+/**
+ * 渲染人设目录段（纯函数，便于单独推理）。
+ *
+ * 返回 `''` 表示不注入 —— `renderPrompt` 会删除空段，所以不用人设的用户零 token 成本。
+ * 名字按字典序排序：即使底层目录枚举顺序变化，段文本也保持逐字节稳定（前缀缓存契约）。
+ */
+export function renderSubagentCatalog(allowed, maxEntries = DEFAULT_CATALOG_MAX_ENTRIES, maxDescription = DEFAULT_CATALOG_DESCRIPTION_MAX_LENGTH) {
+    if (!allowed.length)
+        return '';
+    const sorted = [...allowed].sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+    const shown = sorted.slice(0, Math.max(0, maxEntries));
+    const lines = shown.map((p) => '- **' + p.name + '** — ' + (catalogDescription(p.description, maxDescription) || NO_DESCRIPTION));
+    const hidden = sorted.length - shown.length;
+    const out = [
+        '## 子智能体（人设）',
+        '',
+        '需要委派独立任务时，用 `subagent_run` 并指定下面的人设名。',
+        '',
+        ...lines,
+    ];
+    if (hidden > 0)
+        out.push('', `（另有 ${hidden} 个未列出，用 subagent_list 查看全部。）`);
+    return out.join('\n');
+}
+/**
+ * 创建 SWR 人设目录。
+ *
+ * ⚠️ 计算失败（读盘异常等）时**保留上一次的值**，不把段清空 —— 否则一次瞬时 IO 抖动
+ * 会让模型突然「忘记」有哪些人设。
+ */
+export function createSubagentCatalog(deps, opts = {}) {
+    const maxEntries = opts.maxEntries ?? DEFAULT_CATALOG_MAX_ENTRIES;
+    const maxDescription = opts.maxDescription ?? DEFAULT_CATALOG_DESCRIPTION_MAX_LENGTH;
+    const ttlMs = opts.ttlMs ?? 1000;
+    const now = opts.now ?? (() => Date.now());
+    let value = '';
+    let loadedAt = Number.NEGATIVE_INFINITY;
+    let inflight = null;
+    const recompute = async () => {
+        try {
+            const { allowed } = await filterBySceneBinding(await deps.list(), await deps.sceneLists());
+            value = renderSubagentCatalog(allowed, maxEntries, maxDescription);
+        }
+        catch { /* 保留上一次的值；首次失败则维持 '' */ }
+        loadedAt = now();
+    };
+    const revalidate = () => {
+        if (inflight)
+            return inflight;
+        inflight = recompute().finally(() => { inflight = null; });
+        return inflight;
+    };
+    return {
+        text: () => {
+            if (now() - loadedAt > ttlMs)
+                void revalidate();
+            return value;
+        },
+        refresh: () => {
+            loadedAt = Number.NEGATIVE_INFINITY;
+            return revalidate();
+        },
+        warm: () => revalidate(),
+    };
+}