dsh-armory 2.4.2 → 2.4.4

package/lib/expert-market.js

@@ -66,6 +66,9 @@ function skillsRoot() {
   return join(homedir(), ".agents", "skills");
 }
 function workbuddyExpertCache() {
+  // 测试隔离口（同 DSH_ARMORY_MARKET_HOME 的纪律）：设置时本机 WorkBuddy 缓存根指到临时目录。
+  const override = process.env.DSH_ARMORY_WORKBUDDY_CACHE;
+  if (override) return override;
   return join(homedir(), ".workbuddy", "plugins", "cache", "experts");
 }
 // 团队专家：主理人 + N 个成员，每人一份人设。成员人设不塞进 preset（会白白撑大每轮
@@ -335,6 +338,105 @@ async function localExpertPluginJson(plugin) {
   return null;
 }
 
+// 主理人人设的本机来源：WorkBuddy 自己下载过的专家包里就有 agents/<name>.md。
+// 上游只把一部分专家放在公开分发地址上（2026-10-27 实测 428 个里 185 个 404），
+// 所以本机缓存不是「优化」，而是这些专家唯一能拿到正文的途径。
+// 人设文件名只做「取最后一段 + 拒绝穿越」，不做 ASCII 化：WorkBuddy 里真实存在
+// 中文 agentName（如「腾讯健康-觅影-眼底彩照疾病分析专家」），safeSegment 会把它压成
+// 一串连字符，永远找不到本机缓存里的 agents/<agentName>.md。
+function agentFileStem(value) {
+  const raw = String(value || "").trim();
+  if (!raw) return "";
+  const base = basename(raw.replace(/\\/g, "/")).replace(/\.md$/i, "").trim();
+  if (!base || base === "." || base === ".." || base.includes("\0")) return "";
+  return base;
+}
+
+async function localExpertPersona(plugin, agentName) {
+  const names = [agentName, plugin].map(agentFileStem).filter(Boolean);
+  for (const version of await localExpertVersions(plugin)) {
+    const dir = join(version.dir, "agents");
+    for (const name of new Set(names)) {
+      try {
+        const text = await readFile(join(dir, `${name}.md`), "utf8");
+        if (text.trim()) return text;
+      } catch { /* 换个名字或换下一个版本 */ }
+    }
+    // 人设文件名与 plugin / agentName 都不一致时，接受 agents/ 下唯一那份 md。
+    try {
+      const files = (await readdir(dir)).filter((file) => /\.md$/i.test(file));
+      if (files.length === 1) {
+        const text = await readFile(join(dir, files[0]), "utf8");
+        if (text.trim()) return text;
+      }
+    } catch { /* 该版本没有 agents/ */ }
+  }
+  return null;
+}
+
+// 本机覆盖：用户自备的人设正文，优先级高于缓存与 CDN。上游 185/429 没有公开分发、
+// 本机也没有缓存时，这是唯一能拿到「原文」的途径。文件名走 safeSegment，不能借 plugin 穿越目录。
+function overridePersonaPath(plugin) {
+  return join(cacheDir(), "overrides", `${safeSegment(plugin)}.md`);
+}
+async function overridePersona(plugin) {
+  try {
+    const text = await readFile(overridePersonaPath(plugin), "utf8");
+    if (text.trim()) return text;
+  } catch { /* 绝大多数专家没有覆盖文件 */ }
+  return null;
+}
+
+/** 原文取不到的原因：上游缺包与网络故障说法不同，用户据此决定换专家还是重试。 */
+function describePersonaFailure(error) {
+  const detail = String(error?.message || error);
+  if (/HTTP 404/.test(detail)) return "上游 404：专家中心目录里挂着它，但公开分发地址上没有这个包";
+  return `拉取原文失败：${detail}`;
+}
+
+/**
+ * 兜底人设：三条正路都拿不到原文时，用专家中心公开的介绍 / 专业 / 标签 / 示例问题拼一份替身。
+ * 必须显式标注非原文——召唤出来的会话会照这份文字行事，用户有权知道它不是原作者设定；
+ * 拿到原文后放进本机覆盖目录即自动改用原文（覆盖优先级最高）。
+ */
+function generatedPersona(row, reason) {
+  const name = row.name || row.plugin;
+  const profession = row.profession || "该领域的专家";
+  const description = row.description || "（专家中心没有为它提供介绍文字）";
+  const category = row.categoryName || row.categoryId || "";
+  const tags = Array.isArray(row.tags) ? row.tags.filter(Boolean) : [];
+  const prompts = Array.isArray(row.quickPrompts) ? row.quickPrompts.filter(Boolean) : [];
+  const overridePath = overridePersonaPath(row.plugin).replace(/\\/g, "/");
+  const lines = [
+    `# ${name}（${profession}）`,
+    "",
+    `> **这份人设不是原文。**${reason}；本机 WorkBuddy 缓存里也没有它。`,
+    "> 下面的内容由 WorkBuddy 专家中心公开的介绍、标签与示例问题整理而成，",
+    "> 只能还原「大致是谁、负责什么」，不等同于原作者写的工作方法与铁律。",
+    `> 拿到原始人设后，放到 \`${overridePath}\` 即可自动改用原文。`,
+    "",
+    "## 身份",
+    `你是「${name}」，身份是「${profession}」${category ? `，属于「${category}」` : ""}。`,
+    "",
+    "## 你负责什么",
+    description,
+    "",
+    "## 工作原则",
+    "- 只做上面这段职责范围内的事；被问到范围外的内容时说明边界并给出替代方向，不冒充全才。",
+    "- 这不是原作者人设：不要声称掌握原作者未公开的资料、模板或内部流程，拿不准就直说。",
+    "- 先确认目标、已有输入与验收标准，再动手；信息不足时先问最关键的那一个。",
+    "- 给结论时附上依据与可执行的下一步，不写空泛的鼓励语。",
+  ];
+  if (tags.length) lines.push(`- 额外关注：${tags.join("、")}。`);
+  if (prompts.length) lines.push("", "## 用户常这样开始", ...prompts.map((prompt) => `- ${prompt}`));
+  lines.push(
+    "",
+    "## 开场",
+    "第一次对话先用一句话说明自己是谁、能做什么，然后按上面的原则推进；不要主动展开与任务无关的话题。",
+  );
+  return `${lines.join("\n")}\n`;
+}
+
 // ── 专家详情：人设正文 + 捆绑技能清单 ──────────────────────────────────
 // 召唤前给用户看的全部真实内容：人设 MD 原文、plugin.json 的技能声明、quickPrompts。
 export async function wbExpertDetail(payload) {
@@ -356,13 +458,40 @@ export async function wbExpertDetail(payload) {
   if (!row.agentName && pluginJson?.agentName) row.agentName = String(pluginJson.agentName);
   const promptFile = String(row.promptFile || (pluginJson ? `/plugins/${plugin}/agents/${pluginJson.agentName || plugin}.md` : "")).trim();
   if (!promptFile) throw new Error(`专家 ${plugin} 没有人设文件路径（promptFile 缺失）`);
-  let persona = "";
-  try {
-    persona = await fetchText(EXPERT_ORIGIN + promptFile);
-  } catch (error) {
-    throw new Error(`拉取人设失败：${error.message}`);
+  // 取数顺序：本机覆盖 → 本机 WorkBuddy 缓存 → 公开分发地址 → 兜底生成。
+  // 上游 185/429 没有公开分发人设（issue #5），所以「三条路都空」是常态而非异常：
+  // 这时给一份明确标注非原文的替身，保证专家至少能看详情、能召唤，不再抛 404。
+  let persona = (await overridePersona(plugin)) || "";
+  let personaSource = persona ? "override" : "";
+  let personaNotice = "";
+  if (!persona) {
+    persona = (await localExpertPersona(plugin, row.agentName || pluginJson?.agentName)) || "";
+    if (persona) personaSource = "workbuddy-cache";
+  }
+  if (!persona) {
+    try {
+      const fetched = await fetchText(EXPERT_ORIGIN + promptFile);
+      if (fetched.trim()) {
+        persona = fetched;
+        personaSource = "cdn";
+      } else {
+        personaNotice = "公开分发地址上的人设文件是空的";
+      }
+    } catch (error) {
+      personaNotice = describePersonaFailure(error);
+      // 只有「上游确实没有这份文件」（404 / 410）才生成替身。断网 / 超时 / 5xx 是暂时故障，
+      // 静默换成替身会让用户以为专家原文就长这样——如实报错，让用户重试或放本机覆盖。
+      if (!/HTTP (404|410)\b/.test(String(error?.message || error))) {
+        throw new Error(`拉取专家人设失败：${String(error?.message || error)}。请检查网络后重试，或把原文放到本机覆盖目录后再打开。`);
+      }
+    }
+  }
+  if (!persona) {
+    persona = generatedPersona(row, personaNotice);
+    personaSource = "generated";
+    personaNotice = personaNotice || "原文不可用";
   }
-  if (!persona.trim()) throw new Error("人设文件为空");
+  if (!persona.trim()) throw new Error("人设正文为空");
   const skillNames = Array.isArray(pluginJson?.skills)
     ? pluginJson.skills.map((entry) => basename(String(entry).replace(/\/+$/, ""))).filter(Boolean)
     : [];
@@ -374,6 +503,8 @@ export async function wbExpertDetail(payload) {
     promptFile,
     persona,
     personaChars: persona.length,
+    personaSource,
+    personaNotice,
     version: String(pluginJson?.version || ""),
     skills,
     avatarPluginUrl: pluginJson?.avatar ? `${EXPERT_ORIGIN}/plugins/${encodeURIComponent(plugin)}/${String(pluginJson.avatar).replace(/^\//, "")}` : row.avatarUrl,