dsh-archify-projects 0.1.1 → 0.2.0

package/README.md

@@ -98,6 +98,8 @@ pnpm add link:/absolute/path/to/dsh-archify-projects   # 或在 package.json 里
 3. 首次添加会自动跑一次 `create`：结构图 + 领域图各一张，通常几分钟。
 4. 之后随时「更新」：切回记录的分支 → 快进到最新 → 重画两张图。
 5. 图是可以直接看的 HTML（archify 产物：可搜索、可缩放、可导出），不是截图。
+6. 右上角**齿轮**是设置：只有一个「分析模型」下拉，选项就是你在 DSH 里已经配好、
+   当前真能路由的模型；不选＝跟随宿主默认。改完对下一次运行生效。
 
 ---
 
@@ -126,6 +128,16 @@ pnpm add link:/absolute/path/to/dsh-archify-projects   # 或在 package.json 里
 `restrict` 只能装在 scoped ctx（`agent.ctx`）上，写在 preset 行里会直接抛 ——
 所以白名单与守卫在 `src/host/policy.ts` 里，运行开始时对当次会话安装。
 
+### 分析跑在子代理会话里，不占你的会话列表
+
+每次出图 / 提问都用一个 **`origin: 'subagent'` 的会话**（`ctx.agents.create` +
+`agentPresets.mount`），所以：
+
+- DSH 左侧会话列表按 origin 过滤子代理会话 —— 分析不会往你的对话列表里塞新条目；
+- 会话的模型走 `agentOptions`，**只影响这一次运行**，不会改掉 DSH 里你的默认模型；
+- 宿主版本没有这条路（缺 `agents.create` / `agentPresets`）时安静退回普通会话，
+  工具白名单、preset、产物回收都不变。
+
 ### 深浅色
 
 页面只用 DSH 的主题令牌（`--dsw-alias-*` / `--dsw-specific-*` / `--dsw-radius-*` /
@@ -217,6 +229,7 @@ scripts/           artifact 门禁
 | 位置                                                         | 内容                                                                                    |
 | ------------------------------------------------------------ | --------------------------------------------------------------------------------------- |
 | `~/.dsh/archify-projects/projects.json`（可用 `dataDir` 改） | 台账：项目、Git 快照、两张图的状态、运行历史（保留最近 20 条）                          |
+| 同目录 `settings.json`                                       | 插件设置：分析用哪个模型（`{ provider, model }`，null = 跟随宿主默认）                  |
 | `~/.dsh/archify-projects/workspace/<projectId>/`             | 每个项目的工作目录；`.archify/<kind>-<slug>-<stamp>/` 里是 `candidate.json` 与成品 HTML |
 | `<插件目录>/skills/archify/`                                 | 内嵌的 archify skill（不进 git：见 `.gitignore`；npm 包用 `files` 带上）                |
 

package/dist/client.js

@@ -28,6 +28,8 @@ const ROUTES = {
 	mergeQa: (id, qaId) => `${ROUTE_PREFIX}/projects/${encodeURIComponent(id)}/qa/${encodeURIComponent(qaId)}/merge`,
 	childQa: (id, qaId) => `${ROUTE_PREFIX}/projects/${encodeURIComponent(id)}/qa/${encodeURIComponent(qaId)}/child`,
 	runs: (id) => `${ROUTE_PREFIX}/projects/${encodeURIComponent(id)}/runs`,
+	/** 插件级设置（目前只有「分析用哪个模型」）。 */
+	settings: `${ROUTE_PREFIX}/settings`,
 	artifact: (relativePath) => `${ROUTE_PREFIX}/artifact/${relativePath.split(/[\\/]+/).map((part) => encodeURIComponent(part)).join("/")}`
 };
 
@@ -163,7 +165,7 @@ async function api(path, init) {
 	const message = result.error?.message ?? "未知错误";
 	throw new ApiError(code, message);
 }
-/** POST/PATCH 的便捷封装。 */
+/** POST/PUT/PATCH/DELETE 的便捷封装。 */
 function send(path, method, body) {
 	return api(path, {
 		method,
@@ -171,6 +173,12 @@ function send(path, method, body) {
 	});
 }
 
+// src/shared/model-key.ts
+/** 生成路由键。 */
+function modelKey(ref) {
+	return `${ref.provider}::${ref.model}`;
+}
+
 // src/client/components.tsx
 /**
 * 页面里可复用的小组件：标签、状态点、两个对话框。
@@ -531,6 +539,136 @@ function NewDiagramDialog({ t, project, selectedId, busy, onClose, onSubmit }) {
 		})
 	});
 }
+/** 齿轮图标（设置入口）。尺寸跟随字号，颜色跟随按钮。 */
+function GearIcon({ size = 13 }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", {
+		width: size,
+		height: size,
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: 1.7,
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		"aria-hidden": "true",
+		focusable: "false",
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("circle", {
+			cx: "12",
+			cy: "12",
+			r: "3.1"
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M19.4 15a1.6 1.6 0 0 0 .32 1.77l.06.06a1.9 1.9 0 1 1-2.7 2.7l-.06-.06a1.6 1.6 0 0 0-1.77-.32 1.6 1.6 0 0 0-.97 1.47V21a1.9 1.9 0 1 1-3.8 0v-.1a1.6 1.6 0 0 0-1.05-1.47 1.6 1.6 0 0 0-1.77.32l-.06.06a1.9 1.9 0 1 1-2.7-2.7l.06-.06A1.6 1.6 0 0 0 4.6 15a1.6 1.6 0 0 0-1.47-.97H3a1.9 1.9 0 1 1 0-3.8h.1a1.6 1.6 0 0 0 1.47-1.05 1.6 1.6 0 0 0-.32-1.77l-.06-.06a1.9 1.9 0 1 1 2.7-2.7l.06.06A1.6 1.6 0 0 0 9 4.6a1.6 1.6 0 0 0 .97-1.47V3a1.9 1.9 0 1 1 3.8 0v.1a1.6 1.6 0 0 0 .97 1.47 1.6 1.6 0 0 0 1.77-.32l.06-.06a1.9 1.9 0 1 1 2.7 2.7l-.06.06a1.6 1.6 0 0 0-.32 1.77V9a1.6 1.6 0 0 0 1.47.97H21a1.9 1.9 0 1 1 0 3.8h-.1a1.6 1.6 0 0 0-1.47.97z" })]
+	});
+}
+/**
+* 设置对话框：**只有一个字段**——分析用哪个模型。
+*
+* 模型选项不是插件编的，是宿主 `modelCatalog()` 列出来的（用户在 DSH 里
+* 配好、当前真的能路由到的那些）。目录拿不到时只留「跟随宿主默认」一项，
+* 并且把原因写在提示里，不假装能选。
+*/
+function SettingsDialog({ t, settings, busy, onClose, onSubmit }) {
+	const catalog = settings?.catalog ?? null;
+	const current = settings?.model ?? null;
+	const [chosen, setChosen] = (0, react.useState)(current === null ? "" : modelKey(current));
+	const options = catalog?.options ?? [];
+	const selectedOption = options.find((option) => option.key === chosen) ?? null;
+	const submit = () => {
+		onSubmit(selectedOption === null ? null : {
+			provider: selectedOption.provider,
+			model: selectedOption.model
+		});
+	};
+	const fallbackText = catalog !== null && catalog.fallback !== null ? `${catalog.fallback.provider} / ${catalog.fallback.model}` : null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		className: "dap-mask",
+		role: "presentation",
+		onClick: (e) => e.target === e.currentTarget && onClose(),
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: "dap-dialog",
+			role: "dialog",
+			"aria-modal": "true",
+			"aria-label": t("dialog.settings"),
+			children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h2", {
+					className: "dap-dialog__title",
+					children: t("dialog.settings")
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "dap-dialog__sub",
+					children: t("dialog.settingsSub")
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "dap-dialog__row",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "dap-field__label",
+						children: t("field.model")
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
+						className: "dap-select",
+						value: chosen,
+						onChange: (e) => setChosen(e.target.value),
+						"aria-label": t("field.model"),
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+							value: "",
+							children: fallbackText === null ? t("model.followDefault") : t("model.followDefaultNamed", { model: fallbackText })
+						}), options.map((option) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("option", {
+							value: option.key,
+							children: [
+								option.providerName,
+								" · ",
+								option.name
+							]
+						}, option.key))]
+					})]
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "dap-hint",
+					children: catalog === null || catalog.source === "unavailable" ? t("settings.unavailable") : options.length === 0 ? t("settings.noModels") : t("field.modelHint")
+				}),
+				selectedOption?.description != null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "dap-hint",
+					children: selectedOption.description
+				}) : null,
+				catalog !== null && catalog.failures.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "dap-hint dap-hint--warn",
+					children: t("settings.providerFailed", { list: catalog.failures.map((f) => f.providerName).join("、") })
+				}) : null,
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "dap-dialog__row",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "dap-field__label",
+						children: t("field.sessionMode")
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "dap-hint",
+						children: settings?.subagentSessions === true ? t("settings.sessionSubagent") : t("settings.sessionPlain")
+					})]
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "dap-dialog__foot",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "dap-hint",
+						children: t("settings.scopeHint")
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						style: {
+							display: "flex",
+							gap: 6
+						},
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+							className: "dap-btn dap-btn--sm",
+							onClick: onClose,
+							disabled: busy,
+							children: t("action.cancel")
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+							className: "dap-btn dap-btn--sm dap-btn--primary",
+							onClick: submit,
+							disabled: busy,
+							children: t("action.save")
+						})]
+					})]
+				})
+			]
+		})
+	});
+}
 
 // src/client/page.tsx
 /**
@@ -557,6 +695,7 @@ function StudioPage({ t }) {
 	const [diagramId, setDiagramId] = (0, react.useState)(null);
 	const [tab, setTab] = (0, react.useState)("info");
 	const [dialog, setDialog] = (0, react.useState)(null);
+	const [settings, setSettings] = (0, react.useState)(null);
 	const [busy, setBusy] = (0, react.useState)(null);
 	const [notice, setNotice] = (0, react.useState)(null);
 	const [question, setQuestion] = (0, react.useState)("");
@@ -590,6 +729,18 @@ function StudioPage({ t }) {
 	(0, react.useEffect)(() => {
 		load();
 	}, [load]);
+	(0, react.useEffect)(() => {
+		let alive = true;
+		(async () => {
+			try {
+				const value = await api(ROUTES.settings);
+				if (alive) setSettings(value);
+			} catch {}
+		})();
+		return () => {
+			alive = false;
+		};
+	}, []);
 	const running = state.projects.some((project) => isRunning(project));
 	(0, react.useEffect)(() => {
 		if (!running) return void 0;
@@ -634,6 +785,19 @@ function StudioPage({ t }) {
 			setBusy(null);
 		}
 	};
+	const saveSettings = async (model) => {
+		setBusy("settings");
+		setNotice(null);
+		try {
+			const value = await send(ROUTES.settings, "PUT", { model });
+			if (mounted.current) setSettings(value);
+			setDialog(null);
+		} catch (err) {
+			fail(err);
+		} finally {
+			setBusy(null);
+		}
+	};
 	const updateAll = async () => {
 		for (const item of state.projects) {
 			if (isRunning(item)) continue;
@@ -783,14 +947,20 @@ function StudioPage({ t }) {
 						className: "dap-head__sub",
 						children: project.repoPath
 					})
-				] }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				] }), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 					className: "dap-head__actions",
-					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						className: "dap-iconbtn",
+						onClick: () => setDialog("settings"),
+						title: t("action.settings"),
+						"aria-label": t("action.settings"),
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(GearIcon, {})
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 						className: "dap-btn dap-btn--sm dap-btn--primary",
 						onClick: () => void runUpdate(project),
 						disabled: busy !== null || isRunning(project),
 						children: t("action.update")
-					})
+					})]
 				})]
 			}),
 			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -818,6 +988,13 @@ function StudioPage({ t }) {
 					onNewDiagram: () => setDialog("diagram")
 				})]
 			}),
+			dialog === "settings" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SettingsDialog, {
+				t,
+				settings,
+				busy: busy !== null,
+				onClose: () => setDialog(null),
+				onSubmit: (model) => void saveSettings(model)
+			}) : null,
 			dialog === "diagram" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NewDiagramDialog, {
 				t,
 				project,
@@ -841,16 +1018,26 @@ function StudioPage({ t }) {
 					children: t("page.subtitle")
 				})] }), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 					className: "dap-head__actions",
-					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-						className: "dap-btn dap-btn--sm",
-						onClick: () => void updateAll(),
-						disabled: busy !== null || state.projects.length === 0,
-						children: t("action.updateAll")
-					}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
-						className: "dap-btn dap-btn--sm dap-btn--primary",
-						onClick: () => setDialog("project"),
-						children: ["+ ", t("action.add")]
-					})]
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+							className: "dap-iconbtn",
+							onClick: () => setDialog("settings"),
+							title: t("action.settings"),
+							"aria-label": t("action.settings"),
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(GearIcon, {})
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+							className: "dap-btn dap-btn--sm",
+							onClick: () => void updateAll(),
+							disabled: busy !== null || state.projects.length === 0,
+							children: t("action.updateAll")
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+							className: "dap-btn dap-btn--sm dap-btn--primary",
+							onClick: () => setDialog("project"),
+							children: ["+ ", t("action.add")]
+						})
+					]
 				})]
 			}),
 			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -938,6 +1125,13 @@ function StudioPage({ t }) {
 					})] })
 				]
 			}),
+			dialog === "settings" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SettingsDialog, {
+				t,
+				settings,
+				busy: busy !== null,
+				onClose: () => setDialog(null),
+				onSubmit: (model) => void saveSettings(model)
+			}) : null,
 			dialog === "project" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NewProjectDialog, {
 				t,
 				busy: busy !== null,
@@ -1638,6 +1832,20 @@ const zh = {
 	"action.delete": "删除",
 	"action.openSession": "查看会话",
 	"action.cancel": "取消",
+	"action.settings": "设置",
+	"dialog.settings": "设置",
+	"dialog.settingsSub": "只影响这个插件的分析会话，不动 DSH 里你自己的默认模型。",
+	"field.model": "分析模型",
+	"field.modelHint": "选项来自你在 DSH 里已经配好、当前能路由的模型。",
+	"field.sessionMode": "会话形态",
+	"model.followDefault": "跟随宿主默认",
+	"model.followDefaultNamed": "跟随宿主默认（{model}）",
+	"settings.noModels": "宿主的模型目录是空的：去 DSH 设置里配一个模型，这里才有得选。",
+	"settings.unavailable": "这个宿主版本没有提供模型目录，只能跟随宿主默认。",
+	"settings.providerFailed": "{list} 的模型列表取不到（网络或凭据），暂时不能选。",
+	"settings.sessionSubagent": "子代理会话（不占用左侧会话列表）",
+	"settings.sessionPlain": "普通会话（宿主不支持子代理会话）",
+	"settings.scopeHint": "保存后对下一次运行生效",
 	"action.submit": "创建并分析",
 	"action.close": "关闭",
 	"action.back": "返回图册",
@@ -1799,6 +2007,20 @@ const en = {
 	"action.delete": "Delete",
 	"action.openSession": "Open session",
 	"action.cancel": "Cancel",
+	"action.settings": "Settings",
+	"dialog.settings": "Settings",
+	"dialog.settingsSub": "Only affects this plugin's analysis sessions; your own default model in DSH stays untouched.",
+	"field.model": "Analysis model",
+	"field.modelHint": "Options are the models already configured in DSH and currently routable.",
+	"field.sessionMode": "Session",
+	"model.followDefault": "Follow the host default",
+	"model.followDefaultNamed": "Follow the host default ({model})",
+	"settings.noModels": "The host catalog is empty. Configure a model in DSH settings to pick one here.",
+	"settings.unavailable": "This host version exposes no model catalog; the host default is used.",
+	"settings.providerFailed": "Could not list models for {list} (network or credentials).",
+	"settings.sessionSubagent": "Subagent session (kept out of the sidebar list)",
+	"settings.sessionPlain": "Plain session (this host lacks subagent sessions)",
+	"settings.scopeHint": "Applies to the next run",
 	"action.submit": "Create and analyse",
 	"action.close": "Close",
 	"action.back": "Back to atlas",
@@ -2190,6 +2412,25 @@ const PAGE_CSS = `
 
 
 .dap-dialog--wide { width: 680px; }
+
+/* 头部图标按钮（设置齿轮）：与 dap-btn--sm 同高，窄一点 */
+.dap-iconbtn {
+  display: inline-flex; align-items: center; justify-content: center;
+  width: 26px; height: 26px; border-radius: var(--dsw-radius-md);
+  border: 1px solid var(--dsw-alias-border-l1); background: var(--dsw-alias-bg-layer-2);
+  color: var(--dsw-alias-label-secondary); cursor: pointer;
+}
+.dap-iconbtn:hover { color: var(--dsw-alias-label-primary); border-color: var(--dsw-alias-border-l2); }
+
+/* 设置弹窗的模型下拉：原生 select 最省事，长列表也能滚动 */
+.dap-select {
+  min-width: 240px; max-width: 380px; height: 28px; padding: 0 8px;
+  border: 1px solid var(--dsw-alias-border-l2); border-radius: var(--dsw-radius-md);
+  background: var(--dsw-alias-bg-layer-2); color: var(--dsw-alias-label-primary);
+  font: inherit; font-size: 12px; outline: none; cursor: pointer;
+}
+.dap-select:focus { border-color: var(--dsw-alias-border-l3); }
+.dap-hint--warn { color: var(--dsw-alias-state-warning-primary, var(--dsw-alias-label-tertiary)); }
 .dap-typebar { display: flex; flex-wrap: wrap; gap: 5px; margin: 6px 0 8px; }
 .dap-type-tag {
   display: inline-flex; align-items: center; gap: 5px; height: 27px; padding: 0 9px;