dsh-mobile-plugin 0.5.17 → 0.5.19

package/lib/mobile/cli/model-prefs.js

@@ -0,0 +1,77 @@
+'use strict';
+
+/**
+ * 「这条 CLI 上次用的是哪个模型」—— 一台电脑每个 CLI 记一份。
+ *
+ * 为什么要记：ACP 的模型是**会话级**配置（`session/new` 之后才有 `configOptions`，`set_config_option`
+ * 只对那一条会话生效）。不记的话，每次从侧栏新建一条 CLI 对话都回到 CLI 自己的默认模型，用户
+ * 每一轮都要在手机上重新选一次 —— 这在普通会话里是不存在的体验（宿主那边默认模型是设备级的）。
+ *
+ * 记账口径是 `agentId`（codex / claude / gemini / opencode …），不是会话 id：换一条对话、换一台
+ * 手机、宿主重启之后，用户选过的仍然是那一个。
+ *
+ * 只记「配置项 id + 选中值」这一对，不记目录：模型清单每次由 CLI 自己给，我们记的只是「上次
+ * 选的是哪一个」。那个值在新会话里不存在（CLI 升级换了模型名）时就当没记过 —— 悄悄退回默认，
+ * 不去设一个它不认识的值。
+ */
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+const paths = require('../../shared/paths');
+
+/** 文件：`$DSH_HOME/storages/mobile-plugin/cli-models.json`。 */
+function storeFile() {
+  return path.join(paths.dshHome(), 'storages', 'mobile-plugin', 'cli-models.json');
+}
+
+function text(value) {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+function load() {
+  try {
+    const raw = JSON.parse(fs.readFileSync(storeFile(), 'utf8'));
+    return raw && typeof raw === 'object' && raw.agents && typeof raw.agents === 'object' ? raw.agents : {};
+  } catch {
+    return {};
+  }
+}
+
+function save(agents) {
+  try {
+    fs.mkdirSync(path.dirname(storeFile()), { recursive: true });
+    fs.writeFileSync(storeFile(), JSON.stringify({ agents }, null, 0), 'utf8');
+  } catch {
+    // 写不进去只是下次要重新选一次，不影响这一次。
+  }
+}
+
+/** 这个 CLI 上次选的模型：`{ configId, value }`，没记过就 null。 */
+function preferredModel(agentId) {
+  const entry = load()[text(agentId)];
+  const configId = text(entry && entry.configId);
+  const value = text(entry && entry.value);
+  return configId && value ? { configId, value } : null;
+}
+
+/** 记下这个 CLI 这次选的模型（`value` 空 = 清掉）。 */
+function rememberModel(agentId, configId, value) {
+  const id = text(agentId);
+  if (!id) return;
+  const agents = load();
+  const cleanConfig = text(configId);
+  const cleanValue = text(value);
+  if (!cleanConfig || !cleanValue) {
+    delete agents[id];
+  } else {
+    agents[id] = { configId: cleanConfig, value: cleanValue };
+  }
+  save(agents);
+}
+
+module.exports = {
+  storeFile,
+  preferredModel,
+  rememberModel,
+};

package/lib/mobile/cli/model-visibility.js

@@ -0,0 +1,92 @@
+'use strict';
+
+/**
+ * CLI 的模型开关 —— 手机上「这个 CLI 里哪些模型要显示、哪些藏起来」的那本账。
+ *
+ * 为什么存在插件里而不是手机本地：ACP 的模型目录是**那台电脑上的 CLI 自己给的**，各家会不会
+ * 「只列一部分」全看它自己，我们既不能替它删、也写不回它的配置。所以这一档只能当**展示层**
+ * 的账来做：哪几个要显示由用户定，账存在电脑上，换一台手机看到的是同一份（`model-visibility`
+ * 在 App 里存的是那份「按设备分桶的副本」，开机对一次源）。
+ *
+ * 与 App 那本 `model-visibility` 的关系：宿主这套模型目录（`/session/models`）本来就有「只影响
+ * 本机显示」的开关，CLI 这边多了个「换手机也要一样」的要求，所以真值放这儿，App 那边只读。
+ * 只记「被关掉的」：模型目录天天在长，记白名单会让新模型默认不出现。
+ */
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+const paths = require('../../shared/paths');
+
+/** 文件：`$DSH_HOME/storages/mobile-plugin/cli-model-visibility.json`。 */
+function storeFile() {
+  return path.join(paths.dshHome(), 'storages', 'mobile-plugin', 'cli-model-visibility.json');
+}
+
+function text(value) {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+/**
+ * `{ agents: { <agentId>: { models: [modelId…], configs: [configId…] } } }`
+ *
+ * 两个桶：
+ *   - `models`：被关掉的模型（目录里不出现）；
+ *   - `configs`：被关掉的整组（一个 CLI 里可能有多组模型，opencode 的「Go 订阅」就是一组）。
+ */
+function load() {
+  try {
+    const raw = JSON.parse(fs.readFileSync(storeFile(), 'utf8'));
+    const agents = raw && typeof raw === 'object' ? raw.agents : null;
+    return agents && typeof agents === 'object' ? agents : {};
+  } catch {
+    return {};
+  }
+}
+
+function save(agents) {
+  try {
+    fs.mkdirSync(path.dirname(storeFile()), { recursive: true });
+    fs.writeFileSync(storeFile(), JSON.stringify({ agents }, null, 0), 'utf8');
+  } catch {
+    // 写不进去只是这台电脑重启后开关回到全开，不影响这一次点击。
+  }
+}
+
+/** 这个 CLI 被关掉的模型与整组：`{ models: string[], configs: string[] }`（没有就是空数组）。 */
+function hiddenOf(agentId) {
+  const entry = load()[text(agentId)];
+  const list = (value) => (Array.isArray(value) ? value.filter((item) => typeof item === 'string' && item) : []);
+  return {
+    models: list(entry && entry.models),
+    configs: list(entry && entry.configs),
+  };
+}
+
+/**
+ * 改一个模型（或一整组）的开关。
+ *
+ * `kind`：
+ *   - `'model'`：`id` 是模型 id（就是 ACP 那个 `value`）；
+ *   - `'config'`：`id` 是一组的 id（模型 id 里斜杠前那一段）。
+ *
+ * `visible === true` 是把它从账里删掉 —— **账只记关掉的**，所以「打开」等于「不记」。
+ */
+function setVisible(agentId, kind, id, visible) {
+  const agent = text(agentId);
+  const target = text(id);
+  if (!agent || !target) return;
+  const agents = load();
+  const entry = agents[agent] && typeof agents[agent] === 'object' ? { ...agents[agent] } : {};
+  const bucket = kind === 'config' ? 'configs' : 'models';
+  const current = new Set(Array.isArray(entry[bucket]) ? entry[bucket].filter((item) => typeof item === 'string' && item) : []);
+  if (visible) current.delete(target);
+  else current.add(target);
+  if (current.size) entry[bucket] = [...current].sort();
+  else delete entry[bucket];
+  if (entry.models || entry.configs) agents[agent] = entry;
+  else delete agents[agent];
+  save(agents);
+}
+
+module.exports = { storeFile, hiddenOf, setVisible };

package/lib/mobile/cli/registry.js

@@ -0,0 +1,207 @@
+'use strict';
+
+/**
+ * 官方 ACP 注册表：手机上那份「能起哪些 CLI」不再写死。
+ *
+ * 为什么改成读注册表：逐家适配是件永远追不完的活，而 ACP 生态已经把这件事做成了一份清单 ——
+ * `cdn.agentclientprotocol.com/registry/v1/latest/registry.json` 里每个 agent 都写清了起法
+ * （包名、参数、分发方式、维护方、图标），由各家和 Zed 一起维护。我们只需要读它，把它们当成
+ * 同一种东西交给 ACP 连接层；新 CLI 上线不需要我们发版。
+ *
+ * **只收 `distribution.npx` 那一档**：能 `npx` 拉起来的是纯 JS 包，起法与现有桥包完全一样；
+ * `binary` 那一档要下载可执行文件、按平台选架构、还要校验，是另一件事，这轮不做 —— 于是
+ * 注册表里有、但只有二进制分发的（Cursor / Kiro / Amp …）在清单里不出现，而不是出现一个点了
+ * 会失败的行。
+ *
+ * 三级兜底，任何一级拿到就收手：
+ *   1. 内存（这个进程问过一次就不再问）；
+ *   2. 盘上缓存（`$DSH_HOME/storages/mobile-plugin/acp-registry.json`，一天内算新鲜）；
+ *   3. 联网拉一次；拉不到就用过期缓存；连缓存都没有就退回 `agents.js` 的内置四家。
+ *
+ * 联网失败**不抛也不报错**：手机要的是「能起哪些」，离线时给出上次那份（或内置那份）就够了，
+ * 为一份清单弹一张红卡不值得。
+ */
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+const paths = require('../../shared/paths');
+
+const REGISTRY_URL = 'https://cdn.agentclientprotocol.com/registry/v1/latest/registry.json';
+
+/** 缓存多久算新鲜：一天。注册表按小时自动更新版本号，一天一拉足够跟上。 */
+const TTL_MS = 24 * 60 * 60 * 1000;
+
+/** 拉取超时：清单是几十 KB 的一发，慢到这个份上就当作拉不到。 */
+const FETCH_TIMEOUT_MS = 8000;
+
+/**
+ * 拉失败之后多久再试。
+ *
+ * 失败也记一份（用的是过期缓存或内置表），但只记五分钟：断网时不该每问一次清单就干等八秒；
+ * 网络刚恢复时也不该让人等一天才看见新 CLI。
+ */
+const FAILURE_TTL_MS = 5 * 60 * 1000;
+
+/** 内存里那一份（含拉取成败的结论，失败也记，免得每次问都再等 8 秒）。 */
+let memory = null;
+
+function cacheFile() {
+  return path.join(paths.dshHome(), 'storages', 'mobile-plugin', 'acp-registry.json');
+}
+
+function text(value) {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+/**
+ * 一条注册表条目 → 我们的适配器形状。
+ *
+ * 只认 npx 那一档：`package` 可能带版本（注册表就是这么发的，`@agentclientprotocol/codex-acp@2.5.0`），
+ * 原样交给 `npx -y`，版本由注册表钉住 —— 我们不去猜「最新版」。
+ */
+function adapterOf(entry) {
+  if (!entry || typeof entry !== 'object') return null;
+  const id = text(entry.id);
+  const pkg = text(entry.distribution && entry.distribution.npx && entry.distribution.npx.package);
+  if (!id || !pkg) return null;
+  const args = Array.isArray(entry.distribution.npx.args)
+    ? entry.distribution.npx.args.filter((arg) => typeof arg === 'string')
+    : [];
+  return {
+    id,
+    label: text(entry.name) || id,
+    transport: 'npx',
+    package: pkg,
+    ...(args.length ? { args } : {}),
+    // 图标地址原样留着：`cli/icons.js` 用它在本地缓存一份 SVG，App 按 id 取（见那边文件头）。
+    ...(text(entry.icon) ? { icon: text(entry.icon) } : {}),
+    ...(text(entry.description) ? { description: text(entry.description) } : {}),
+  };
+}
+
+/**
+ * 注册表 JSON → 适配器数组（去重、丢掉没有 npx 分发的）。
+ */
+function adaptersOf(body) {
+  const agents = body && Array.isArray(body.agents) ? body.agents : [];
+  const seen = new Set();
+  const out = [];
+  for (const entry of agents) {
+    const adapter = adapterOf(entry);
+    if (!adapter || seen.has(adapter.id)) continue;
+    seen.add(adapter.id);
+    out.push(adapter);
+  }
+  return out;
+}
+
+/**
+ * 内置表与注册表合一份清单：**内置的那几条优先**，注册表只补它没有的。
+ *
+ * 为什么不是「注册表整份替换内置」：注册表只收 npx 分发，而 opencode 在那里只有二进制分发
+ * （会整条被过滤掉），gemini / codex / claude 又各有一个 `-acp` 后缀的桥包条目 —— 直接替换
+ * 的结果是「opencode 从清单里消失」，接着建会话那一步回「不认识这个 CLI」，而用起来只是
+ * 「列表里少了几个、点了报错」。所以两边并起来，同一家只留一条：
+ *
+ *   1. id 完全相同 → 留内置（`gemini`）；
+ *   2. id 去掉 `-acp` 后缀后相同 → 留内置（`codex-acp` / `claude-acp` 对 `codex` / `claude`）；
+ *   3. 包名相同 → 留内置（同一条适配器换个名字而已）。
+ *
+ * 内置那几条用的是本机已经装好的 CLI（`gemini --acp` / `opencode acp`），比去 `npx` 拉一份
+ * 新包快得多，所以「优先内置」不只是去重策略，也是更短的那条路。
+ */
+function mergeWithBuiltin(builtin, fromRegistry) {
+  const kept = Array.isArray(builtin) ? builtin.filter(Boolean).slice() : [];
+  const ids = new Set(kept.map((agent) => agent.id));
+  const bareIds = new Set(kept.map((agent) => String(agent.id).replace(/-acp$/, '')));
+  const packages = new Set(kept.map((agent) => agent.package).filter(Boolean));
+  for (const agent of Array.isArray(fromRegistry) ? fromRegistry : []) {
+    if (!agent || !agent.id) continue;
+    if (ids.has(agent.id)) continue;
+    if (bareIds.has(String(agent.id).replace(/-acp$/, ''))) continue;
+    if (agent.package && packages.has(agent.package)) continue;
+    ids.add(agent.id);
+    kept.push(agent);
+  }
+  return kept;
+}
+
+
+function readCache() {
+  try {
+    const raw = JSON.parse(fs.readFileSync(cacheFile(), 'utf8'));
+    const agents = Array.isArray(raw && raw.agents) ? raw.agents.filter((item) => item && typeof item.id === 'string') : [];
+    if (!agents.length) return null;
+    return { fetchedAt: Number(raw.fetchedAt) || 0, agents };
+  } catch {
+    return null;
+  }
+}
+
+function writeCache(agents) {
+  try {
+    fs.mkdirSync(path.dirname(cacheFile()), { recursive: true });
+    fs.writeFileSync(cacheFile(), JSON.stringify({ fetchedAt: Date.now(), agents }), 'utf8');
+  } catch {
+    // 写不进去只是下次还要联网拉一遍，不影响这次。
+  }
+}
+
+async function fetchRegistry() {
+  try {
+    const res = await fetch(REGISTRY_URL, {
+      headers: { accept: 'application/json' },
+      signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+    });
+    if (!res.ok) return null;
+    const agents = adaptersOf(await res.json());
+    return agents.length ? agents : null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 这一次该用哪份清单。`builtin` 是调用方给的内置表（`agents.js` 那四家）——
+ * 它**永远在清单里**，注册表只补它没有的（理由见 `mergeWithBuiltin`）。
+ */
+async function listRegistryAgents(builtin) {
+  const now = Date.now();
+  const base = Array.isArray(builtin) ? builtin : [];
+  if (memory && now - memory.at < (memory.degraded ? FAILURE_TTL_MS : TTL_MS)) {
+    return mergeWithBuiltin(base, memory.agents);
+  }
+  const cached = readCache();
+  if (cached && now - cached.fetchedAt < TTL_MS) {
+    memory = { at: cached.fetchedAt, agents: cached.agents };
+    return mergeWithBuiltin(base, cached.agents);
+  }
+  const fetched = await fetchRegistry();
+  if (fetched) {
+    writeCache(fetched);
+    memory = { at: now, agents: fetched };
+    return mergeWithBuiltin(base, fetched);
+  }
+  // 拉不到：过期缓存也比只有内置那四家强，先用它；都没有就只剩内置。
+  const fallback = cached && cached.agents.length ? cached.agents : [];
+  memory = { at: now, agents: fallback, degraded: true };
+  return mergeWithBuiltin(base, fallback);
+}
+
+/** 测试用：清掉内存那一份（盘上缓存照旧）。 */
+function resetRegistryMemory() {
+  memory = null;
+}
+
+module.exports = {
+  REGISTRY_URL,
+  TTL_MS,
+  FAILURE_TTL_MS,
+  listRegistryAgents,
+  adaptersOf,
+  adapterOf,
+  mergeWithBuiltin,
+  resetRegistryMemory,
+  cacheFile,
+};