@dungsil/dsh-plugin-ui-setting-skills 0.2.0 → 0.3.1

package/README.md

@@ -0,0 +1,20 @@
+# Skills Settings · 스킬 설정
+
+![스킬 설정 전체 화면 비교: 좌측 라이트 모드, 우측 다크 모드](./assets/light-dark-preview.webp)
+
+DSH Web 설정에서 로드된 사용자 스킬을 확인하고 DSH에서의 사용 여부를 설정합니다.
+
+위 이미지는 최신 빌드의 실제 플러그인 컴포넌트에 예시 스킬 목록·설정 응답과 공식 DSH 테마·UI primitives를 제공한 독립 브라우저 화면을 각각 캡처해 좌측 라이트·우측 다크 모드의 전체 화면을 나란히 이어 붙였습니다. 실제 DSH 세션 화면은 아니며, 스킬 이름·설명·경로와 사용 상태는 예시입니다.
+
+## 사용 방법
+
+1. DSH 플러그인 설치 화면에서 `@dungsil/dsh-plugin-ui-setting-skills`를 설치하고 활성화합니다.
+2. **설정 → 스킬**을 열고 **공용 스킬** 또는 **DSH 스킬** 탭을 선택합니다.
+3. 스킬을 펼쳐 설명과 파일 경로를 확인합니다. 오른쪽 스위치로 사용 여부를 변경하면 자동 저장합니다. 이 설정은 DSH에만 적용되며 스킬 파일은 수정하지 않습니다.
+
+## 동작과 호환성
+
+- DSH `0.2.1-rc.5` 이상 `0.3.0` 미만의 Web UI를 지원합니다. 한국어·영어·중국어(간체)와 DSH 테마를 따릅니다.
+- 공용 에이전트 및 DSH 사용자 스킬 경로에서 발견한 목록을 표시합니다. 프로젝트 스킬을 편집하거나 새 스킬을 만드는 화면은 아닙니다.
+- 사고 과정 번역 서비스가 연결되어 있으면 스킬을 펼칠 때 설명을 해당 서비스로 자동 전송해 번역하고 캐시에 저장합니다. 원문으로 전환할 수 있습니다. 번역 서비스가 없으면 원문만 표시합니다.
+- 저장 오류가 나타나면 설정 항목을 닫았다가 다시 열어 저장 상태를 확인한 뒤 다시 시도하세요.

package/dist/client.js

@@ -1,8 +1,68 @@
 window.__ModuleLoader__.load({ id: "@dungsil/dsh-plugin-ui-setting-skills", factory(require) { const module = { exports: {} }; const exports = module.exports;
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let react = require("react");
+let react_dom_client = require("react-dom/client");
 let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 let react_jsx_runtime = require("react/jsx-runtime");
+// ../../tools/ui/src/client.ts
+/** Each effect owns its sheet, even when another plugin installs the same defaults. */
+function installStyles(css) {
+	const style = document.createElement("style");
+	style.textContent = css;
+	document.head.append(style);
+	return () => style.remove();
+}
+// ../../tools/ui/src/settings.tsx
+/** The rc.5 settings shell has no icon slot, so decorate only the matching navigation rows. */
+function installSettingsIcon(id, labels, icon) {
+	const attribute = "data-dsh-settings-icon";
+	const selector = `[${attribute}="${id}"]`;
+	const removeStyles = installStyles(`
+${selector} > svg { display: none; }
+${typeof icon === "string" ? `${selector}::before { content: ''; display: block; flex: none; width: 16px; height: 16px; background: currentColor; mask: url("data:image/svg+xml,${encodeURIComponent(icon)}") center / contain no-repeat; }` : ""}
+${selector} > [data-dsh-settings-icon-glyph] { display: inline-flex; flex: none; }
+`);
+	const marked = /* @__PURE__ */ new Map();
+	const refresh = () => {
+		const rows = new Set(document.querySelectorAll("[data-shortcut-modal=\"settings\"] nav button"));
+		for (const [row, dispose] of marked) if (!rows.has(row) || !labels.includes(row.textContent?.trim() ?? "")) {
+			row.removeAttribute(attribute);
+			dispose();
+			marked.delete(row);
+		}
+		for (const row of rows) if (!marked.has(row) && labels.includes(row.textContent?.trim() ?? "")) {
+			row.setAttribute(attribute, id);
+			let dispose = () => {};
+			if (typeof icon !== "string") {
+				const glyph = document.createElement("span");
+				glyph.setAttribute("data-dsh-settings-icon-glyph", "");
+				glyph.setAttribute("aria-hidden", "true");
+				row.prepend(glyph);
+				const unmount = icon(glyph);
+				dispose = () => {
+					unmount();
+					glyph.remove();
+				};
+			}
+			marked.set(row, dispose);
+		}
+	};
+	const observer = new MutationObserver(refresh);
+	observer.observe(document.body, {
+		childList: true,
+		subtree: true,
+		characterData: true
+	});
+	refresh();
+	return () => {
+		observer.disconnect();
+		for (const [row, dispose] of marked) {
+			row.removeAttribute(attribute);
+			dispose();
+		}
+		removeStyles();
+	};
+}
 // locale/en.json
 var en_default = {
 	meta: {
@@ -20,6 +80,17 @@ var en_default = {
 		"incomplete": "Some skill sources could not be loaded. This list may be incomplete.",
 		"use": "Use",
 		"disabled": "Off",
+		"openFolder": "Open folder",
+		"openingFolder": "Opening folder…",
+		"openFolderHint": "Open this skill’s folder in the file manager on the DSH host.",
+		"openFolderUnavailable": "Folder opening requires a desktop on the DSH host.",
+		"openFolderError": "Could not open the skill folder. Check the file manager on the DSH host and try again.",
+		"translate": "View translation",
+		"original": "View original",
+		"retry": "Retry",
+		"translating": "Translating…",
+		"translationNotice": "Expanding a skill automatically sends its description to the service selected in reasoning translation settings. Translations are cached using its target language.",
+		"translationError": "Could not translate. The original is shown. Paid services require a Session and are unavailable here.",
 		"saveError": "Could not save the setting. Close and reopen this section to check the saved state before trying again."
 	}
 };
@@ -40,6 +111,17 @@ var ko_default = {
 		"incomplete": "일부 스킬 소스를 불러오지 못해 목록이 완전하지 않을 수 있습니다.",
 		"use": "사용",
 		"disabled": "꺼짐",
+		"openFolder": "폴더 열기",
+		"openingFolder": "폴더를 여는 중…",
+		"openFolderHint": "DSH 실행 호스트의 파일 탐색기에서 이 스킬의 폴더를 엽니다.",
+		"openFolderUnavailable": "폴더를 열려면 DSH 실행 호스트에 데스크톱 환경이 필요합니다.",
+		"openFolderError": "스킬 폴더를 열지 못했습니다. DSH 실행 호스트의 파일 탐색기를 확인한 후 다시 시도해 주세요.",
+		"translate": "번역 보기",
+		"original": "원문 보기",
+		"retry": "다시 시도",
+		"translating": "번역 중…",
+		"translationNotice": "스킬을 펼치면 사고 과정 번역 설정에서 선택한 서비스로 설명을 자동 전송합니다. 번역문은 해당 설정의 대상 언어에 따라 캐시에 저장합니다.",
+		"translationError": "번역하지 못해 원문을 표시합니다. 유료 서비스는 세션이 필요하므로 이 화면에서 사용할 수 없습니다.",
 		"saveError": "설정을 저장하지 못했습니다. 이 설정 항목을 닫았다가 다시 열어 저장 상태를 확인한 후 다시 시도해 주세요."
 	}
 };
@@ -60,6 +142,17 @@ var zh_default = {
 		"incomplete": "部分技能源无法加载，列表可能不完整。",
 		"use": "使用",
 		"disabled": "已关闭",
+		"openFolder": "打开文件夹",
+		"openingFolder": "正在打开文件夹…",
+		"openFolderHint": "在 DSH 主机的文件管理器中打开此技能的文件夹。",
+		"openFolderUnavailable": "打开文件夹需要 DSH 主机具备桌面环境。",
+		"openFolderError": "无法打开技能文件夹。请检查 DSH 主机的文件管理器后重试。",
+		"translate": "查看译文",
+		"original": "查看原文",
+		"retry": "重试",
+		"translating": "正在翻译…",
+		"translationNotice": "展开技能时，会自动将描述发送至思考过程翻译设置中选择的服务。译文按该设置的目标语言缓存。",
+		"translationError": "翻译失败，已显示原文。付费服务需要会话，无法在此页面使用。",
 		"saveError": "无法保存设置。请关闭并重新打开此设置项，确认已保存的状态后重试。"
 	}
 };
@@ -67,6 +160,7 @@ var zh_default = {
 const channel = "/api";
 const method = "dungsil-ui-setting-skills/list";
 const saveMethod = "dungsil-ui-setting-skills/save";
+const translateMethod = "dungsil-ui-setting-skills/translate";
 // src/client.tsx
 const name = "dungsil-ui-setting-skills";
 const inject = [
@@ -83,8 +177,8 @@ const styles = `
 .dsh-skills-settings ul { list-style: none; margin: 0; padding: 0; }
 .dsh-skills-settings code { font-size: 12px; overflow-wrap: anywhere; }
 .dsh-skills-settings [role=alert] { color: var(--dsw-alias-state-error-primary, #b54424); }
-.dsh-skills-settings li { display: flex; align-items: flex-start; gap: 16px; border-bottom: .5px solid var(--dsw-alias-border-l2); }
-.dsh-skills-settings details { flex: 1; min-width: 0; }
+.dsh-skills-settings li { display: grid; grid-template-columns: minmax(0, 1fr) auto; column-gap: 16px; border-bottom: .5px solid var(--dsw-alias-border-l2); }
+.dsh-skills-settings details { min-width: 0; }
 .dsh-skills-settings summary { display: flex; align-items: center; gap: 12px; padding: 16px 0; list-style: none; cursor: pointer; border-radius: var(--dsw-radius-md); }
 .dsh-skills-settings summary::-webkit-details-marker { display: none; }
 .dsh-skills-settings summary:hover { background: var(--dsw-alias-interactive-bg-hover); }
@@ -97,9 +191,73 @@ const styles = `
 .dsh-skills-title .dsh-skills-muted { flex: none; font-size: 12px; }
 .dsh-skills-preview { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .dsh-skills-detail { padding: 0 0 16px 28px; overflow-wrap: anywhere; }
-.dsh-skills-toggle { flex: none; padding-top: 27px; }
+.dsh-skills-actions { display: flex; align-items: center; align-self: start; gap: 12px; height: 78px; }
+.dsh-skills-folder { width: 28px; padding: 0; }
+.dsh-skills-open-error { grid-column: 1 / -1; padding: 0 0 16px 28px; }
 .dsh-skills-list-header { display: flex; justify-content: space-between; gap: 16px; padding: 8px 0; border-bottom: .5px solid var(--dsw-alias-border-l2); }
 `;
+function SkillDescription({ skill, connection, language, available, expanded }) {
+	const text = localizedCopy(language);
+	const [translated, setTranslated] = (0, react.useState)();
+	const [original, setOriginal] = (0, react.useState)(false);
+	const [pending, setPending] = (0, react.useState)(false);
+	const [failed, setFailed] = (0, react.useState)(false);
+	const [retry, setRetry] = (0, react.useState)(0);
+	(0, react.useEffect)(() => {
+		setTranslated(void 0);
+		setOriginal(false);
+		setPending(false);
+		setFailed(false);
+		if (!expanded || !available || !skill.path || !skill.description) return;
+		const request = new AbortController();
+		setPending(true);
+		(async () => {
+			try {
+				const result = await connection.rpc.call(channel, translateMethod, {
+					path: skill.path,
+					language
+				}, request.signal);
+				if (request.signal.aborted) return;
+				if (!result.ok || typeof result.value !== "string") throw new Error("Could not translate description");
+				setTranslated(result.value);
+			} catch {
+				if (!request.signal.aborted) setFailed(true);
+			} finally {
+				if (!request.signal.aborted) setPending(false);
+			}
+		})();
+		return () => request.abort();
+	}, [
+		expanded,
+		skill.description,
+		skill.path,
+		language,
+		available,
+		connection,
+		retry
+	]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: original || translated === void 0 ? skill.description : translated }), available && skill.path && skill.description && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+		pending && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+			role: "status",
+			children: text.translating
+		}),
+		translated !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+			variant: "ghost",
+			size: "sm",
+			onClick: () => setOriginal((value) => !value),
+			children: original ? text.translate : text.original
+		}),
+		failed && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+			role: "alert",
+			children: text.translationError
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+			variant: "ghost",
+			size: "sm",
+			onClick: () => setRetry((value) => value + 1),
+			children: text.retry
+		})] })
+	] })] });
+}
 function SkillsSettings({ ctx }) {
 	const locale = (0, react.useSyncExternalStore)((listener) => ctx.locale.subscribe(listener), () => ctx.locale.getSnapshot());
 	const text = localizedCopy(locale.active);
@@ -109,8 +267,11 @@ function SkillsSettings({ ctx }) {
 	const [error, setError] = (0, react.useState)(false);
 	const [saveError, setSaveError] = (0, react.useState)(false);
 	const [busy, setBusy] = (0, react.useState)(false);
+	const [folderStatus, setFolderStatus] = (0, react.useState)({});
+	const openingPending = (0, react.useRef)(/* @__PURE__ */ new Set());
 	const pending = (0, react.useRef)(false);
 	const mounted = (0, react.useRef)(false);
+	const [expanded, setExpanded] = (0, react.useState)({});
 	const [source, setSource] = (0, react.useState)("user-agents");
 	const groups = ["user-agents", "user-dsh"].map((value) => ({
 		value,
@@ -160,6 +321,28 @@ function SkillsSettings({ ctx }) {
 			if (mounted.current) setBusy(false);
 		}
 	}
+	async function openFolder(path) {
+		if (openingPending.current.has(path)) return;
+		openingPending.current.add(path);
+		setFolderStatus((current) => ({
+			...current,
+			[path]: "opening"
+		}));
+		try {
+			if (!(await connection.rpc.call("/api", "dungsil-ui-setting-skills/open-folder", { path })).ok) throw new Error("Could not open skill folder");
+			if (mounted.current) setFolderStatus((current) => ({
+				...current,
+				[path]: void 0
+			}));
+		} catch {
+			if (mounted.current) setFolderStatus((current) => ({
+				...current,
+				[path]: "error"
+			}));
+		} finally {
+			openingPending.current.delete(path);
+		}
+	}
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 		className: "dsh-skills-settings",
 		"aria-label": text.nav,
@@ -169,6 +352,14 @@ function SkillsSettings({ ctx }) {
 				className: "dsh-skills-muted",
 				children: text.description
 			}),
+			view && !view.folderOpenAvailable && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				className: "dsh-skills-muted",
+				children: text.openFolderUnavailable
+			}),
+			view?.translationAvailable && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				className: "dsh-skills-muted",
+				children: text.translationNotice
+			}),
 			!view && !error && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 				role: "status",
 				children: text.loading
@@ -212,45 +403,98 @@ function SkillsSettings({ ctx }) {
 						" ",
 						group.skills.length
 					] }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: text.use })]
-				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", { children: group.skills.map((skill) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("details", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("summary", {
-					"aria-label": skill.name,
-					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronRightOutlineRegular, {
-						size: 16,
-						"aria-hidden": "true"
-					}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
-						className: "dsh-skills-summary-text",
-						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
-							className: "dsh-skills-title",
-							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("strong", { children: skill.name }), view.disabled.includes(skill.name) && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", { children: group.skills.map((skill) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", { children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("details", {
+						onToggle: (event) => {
+							const open = event.currentTarget.open;
+							setExpanded((current) => ({
+								...current,
+								[skill.path ?? skill.name]: open
+							}));
+						},
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("summary", {
+							"aria-label": skill.name,
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronRightOutlineRegular, {
+								size: 16,
+								"aria-hidden": "true"
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: "dsh-skills-summary-text",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+									className: "dsh-skills-title",
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("strong", { children: skill.name }), view.disabled.includes(skill.name) && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: "dsh-skills-muted",
+										children: text.disabled
+									})]
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "dsh-skills-preview dsh-skills-muted",
+									"aria-hidden": "true",
+									children: skill.description
+								})]
+							})]
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dsh-skills-detail",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SkillDescription, {
+								skill,
+								connection,
+								language: locale.active,
+								available: view.translationAvailable && source === group.value,
+								expanded: expanded[skill.path ?? skill.name] ?? false
+							}), skill.path && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 								className: "dsh-skills-muted",
-								children: text.disabled
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", { children: skill.path })
 							})]
-						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-							className: "dsh-skills-preview dsh-skills-muted",
-							"aria-hidden": "true",
-							children: skill.description
 						})]
-					})]
-				}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-					className: "dsh-skills-detail",
-					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: skill.description }), skill.path && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-						className: "dsh-skills-muted",
-						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", { children: skill.path })
-					})]
-				})] }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-					className: "dsh-skills-toggle",
-					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Switch, {
-						label: `${text.use}: ${skill.name}`,
-						checked: !view.disabled.includes(skill.name),
-						disabled: busy || saveError,
-						onChange: (enabled) => void save(skill.name, !enabled)
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "dsh-skills-actions",
+						children: [skill.path && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+							label: folderStatus[skill.path] === "opening" ? text.openingFolder : text.openFolder,
+							side: "top",
+							portal: true,
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+								className: "dsh-skills-folder",
+								variant: "ghost",
+								size: "sm",
+								"aria-label": `${folderStatus[skill.path] === "opening" ? text.openingFolder : text.openFolder}: ${skill.name}`,
+								"aria-busy": folderStatus[skill.path] === "opening",
+								disabled: !view.folderOpenAvailable || folderStatus[skill.path] === "opening",
+								"aria-description": view.folderOpenAvailable ? text.openFolderHint : text.openFolderUnavailable,
+								onClick: () => void openFolder(skill.path),
+								icon: folderStatus[skill.path] === "opening" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconLoadingOutlineRegular, {
+									size: 16,
+									"aria-hidden": "true"
+								}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFolderOpenOutlineRegular, {
+									size: 16,
+									"aria-hidden": "true"
+								})
+							})
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Switch, {
+							label: `${text.use}: ${skill.name}`,
+							checked: !view.disabled.includes(skill.name),
+							disabled: busy || saveError,
+							onChange: (enabled) => void save(skill.name, !enabled)
+						})]
+					}),
+					skill.path && folderStatus[skill.path] === "error" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "dsh-skills-open-error",
+						role: "alert",
+						children: text.openFolderError
 					})
-				})] }, skill.path ?? skill.name)) })] })
+				] }, skill.path ?? skill.name)) })] })
 			}, group.value))] })
 		]
 	});
 }
 function apply(ctx) {
+	ctx.effect(() => installSettingsIcon(name, [
+		en_default.ui.nav,
+		ko_default.ui.nav,
+		zh_default.ui.nav
+	], (container) => {
+		const root = (0, react_dom_client.createRoot)(container);
+		root.render(/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconSkillOutlineRegular, { size: 16 }));
+		return () => root.unmount();
+	}));
 	ctx.effect(() => {
 		const style = document.createElement("style");
 		style.textContent = styles;

package/dist/index.js

@@ -1,4 +1,10 @@
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { writeFileAtomic } from "@deepseek-ai/dsh-atomic-write";
 import { clientRequestSchema } from "@deepseek-ai/dsh-client-connection";
+import { dshCachePath } from "@deepseek-ai/dsh-home-paths";
+import { canOpenNativePath, openNativePath } from "@deepseek-ai/dsh-native-command";
 import { SkillRegistry } from "@deepseek-ai/dsh-skill";
 import { FileSystemSkillProvider } from "@deepseek-ai/dsh-skill-filesystem";
 // ../../node_modules/.pnpm/@deepseek-ai+cosmokit@1.8.6/node_modules/@deepseek-ai/cosmokit/lib/index.js
@@ -890,12 +896,15 @@ defineMethod("transform", [
 const channel = "/api";
 const method = "dungsil-ui-setting-skills/list";
 const saveMethod = "dungsil-ui-setting-skills/save";
+const translateMethod = "dungsil-ui-setting-skills/translate";
+const openFolderMethod = "dungsil-ui-setting-skills/open-folder";
 // src/index.ts
 const name = "dungsil-ui-setting-skills";
 const inject = ["connection", "configEditor"];
 const Config = Schema.object({ disabled: Schema.array(Schema.string()).default([]) });
 function apply(ctx, config = {}) {
 	const editor = ctx.configEditor;
+	const cacheDir = dshCachePath("dungsil-ui-setting-skills", "translations-v1");
 	const entry = () => editor.entries().find((entry) => entry.options.name === "@dungsil/dsh-plugin-ui-setting-skills");
 	const disabled = () => entry()?.options.config?.disabled ?? config.disabled ?? [];
 	ctx.effect(() => {
@@ -930,7 +939,12 @@ function apply(ctx, config = {}) {
 		lifetime.abort();
 		await provider.dispose();
 	}, "ui-setting-skills: dispose discovery");
-	for (const endpoint of [method, saveMethod]) ctx.effect(() => ctx.connection.fetch.register({
+	for (const endpoint of [
+		method,
+		saveMethod,
+		translateMethod,
+		openFolderMethod
+	]) ctx.effect(() => ctx.connection.fetch.register({
 		path: `${channel}/${endpoint}`,
 		methods: ["POST"],
 		requestBody: "buffered",
@@ -942,6 +956,103 @@ function apply(ctx, config = {}) {
 				return new Response("Invalid request", { status: 400 });
 			}
 			if (!body.success || body.data.method !== endpoint) return new Response("Invalid request", { status: 400 });
+			if (endpoint === "dungsil-ui-setting-skills/open-folder") {
+				const payload = body.data.payload;
+				if (!payload || typeof payload.path !== "string") return new Response("Invalid request", { status: 400 });
+				let result;
+				try {
+					const signal = AbortSignal.any([
+						request.signal,
+						lifetime.signal,
+						AbortSignal.timeout(15e3)
+					]);
+					if (!canOpenNativePath()) throw new Error("Native folder opening unavailable");
+					const observation = await provider.list({ signal });
+					const skill = ("candidates" in observation ? observation.candidates : observation).find((skill) => skill.path === payload.path && ["user-agents", "user-dsh"].includes(skill.source));
+					if (!skill?.path) throw new Error("Unknown user skill");
+					await openNativePath(dirname(skill.path), signal);
+					result = {
+						ok: true,
+						value: {}
+					};
+				} catch {
+					result = {
+						ok: false,
+						error: {
+							code: "open_folder_failed",
+							message: "Could not open skill folder.",
+							details: {}
+						}
+					};
+				}
+				return Response.json({
+					type: "server-response",
+					rpcId: body.data.rpcId,
+					result
+				}, { headers: { "Cache-Control": "no-store" } });
+			}
+			if (endpoint === "dungsil-ui-setting-skills/translate") {
+				const payload = body.data.payload;
+				if (!payload || typeof payload.path !== "string" || typeof payload.language !== "string") return new Response("Invalid request", { status: 400 });
+				let result;
+				try {
+					const signal = AbortSignal.any([request.signal, lifetime.signal]);
+					const translator = ctx.get("cotTranslation");
+					if (!translator) throw new Error("Translation unavailable");
+					const observation = await provider.list({ signal });
+					const skill = ("candidates" in observation ? observation.candidates : observation).find((skill) => skill.path === payload.path && ["user-agents", "user-dsh"].includes(skill.source));
+					if (!skill) throw new Error("Unknown user skill");
+					const { preferences } = await translator.limits(signal);
+					const targetLanguage = preferences.targetLanguage === "auto" ? payload.language : preferences.targetLanguage;
+					const key = createHash("sha256").update(JSON.stringify([
+						preferences.provider,
+						targetLanguage,
+						skill.description
+					])).digest("hex");
+					const cachePath = join(cacheDir, `${key}.json`);
+					let value;
+					try {
+						const cached = JSON.parse(await readFile(cachePath, "utf8"));
+						if (typeof cached === "string") value = cached;
+					} catch {}
+					signal.throwIfAborted();
+					if (value === void 0) {
+						value = await translator.translate({
+							text: skill.description,
+							provider: preferences.provider,
+							targetLanguage
+						}, signal);
+						signal.throwIfAborted();
+						try {
+							await writeFileAtomic(cachePath, JSON.stringify(value), {
+								mode: 384,
+								dirMode: 448
+							});
+						} catch {
+							ctx.logger.warn("Could not cache skill description translation");
+						}
+					}
+					signal.throwIfAborted();
+					result = {
+						ok: true,
+						value
+					};
+				} catch {
+					result = {
+						ok: false,
+						error: {
+							code: "translation_failed",
+							message: "Could not translate skill description.",
+							details: {}
+						}
+					};
+				}
+				return Response.json({
+					type: "server-response",
+					rpcId: body.data.rpcId,
+					result
+				}, { headers: { "Cache-Control": "no-store" } });
+			}
 			if (endpoint === "dungsil-ui-setting-skills/save") {
 				const payload = body.data.payload;
 				if (!payload || typeof payload.name !== "string" || typeof payload.disabled !== "boolean") return new Response("Invalid request", { status: 400 });
@@ -992,6 +1103,8 @@ function apply(ctx, config = {}) {
 				result = {
 					ok: true,
 					value: {
+						translationAvailable: !!ctx.get("cotTranslation"),
+						folderOpenAvailable: canOpenNativePath(),
 						disabled: disabled(),
 						complete: "candidates" in observation ? observation.complete : true,
 						skills: skills.flatMap((skill) => skill.source === "user-agents" || skill.source === "user-dsh" ? [{

package/locale/en.json

@@ -14,6 +14,17 @@
     "incomplete": "Some skill sources could not be loaded. This list may be incomplete.",
     "use": "Use",
     "disabled": "Off",
+    "openFolder": "Open folder",
+    "openingFolder": "Opening folder…",
+    "openFolderHint": "Open this skill’s folder in the file manager on the DSH host.",
+    "openFolderUnavailable": "Folder opening requires a desktop on the DSH host.",
+    "openFolderError": "Could not open the skill folder. Check the file manager on the DSH host and try again.",
+    "translate": "View translation",
+    "original": "View original",
+    "retry": "Retry",
+    "translating": "Translating…",
+    "translationNotice": "Expanding a skill automatically sends its description to the service selected in reasoning translation settings. Translations are cached using its target language.",
+    "translationError": "Could not translate. The original is shown. Paid services require a Session and are unavailable here.",
     "saveError": "Could not save the setting. Close and reopen this section to check the saved state before trying again."
   }
 }

package/locale/ko.json

@@ -14,6 +14,17 @@
     "incomplete": "일부 스킬 소스를 불러오지 못해 목록이 완전하지 않을 수 있습니다.",
     "use": "사용",
     "disabled": "꺼짐",
+    "openFolder": "폴더 열기",
+    "openingFolder": "폴더를 여는 중…",
+    "openFolderHint": "DSH 실행 호스트의 파일 탐색기에서 이 스킬의 폴더를 엽니다.",
+    "openFolderUnavailable": "폴더를 열려면 DSH 실행 호스트에 데스크톱 환경이 필요합니다.",
+    "openFolderError": "스킬 폴더를 열지 못했습니다. DSH 실행 호스트의 파일 탐색기를 확인한 후 다시 시도해 주세요.",
+    "translate": "번역 보기",
+    "original": "원문 보기",
+    "retry": "다시 시도",
+    "translating": "번역 중…",
+    "translationNotice": "스킬을 펼치면 사고 과정 번역 설정에서 선택한 서비스로 설명을 자동 전송합니다. 번역문은 해당 설정의 대상 언어에 따라 캐시에 저장합니다.",
+    "translationError": "번역하지 못해 원문을 표시합니다. 유료 서비스는 세션이 필요하므로 이 화면에서 사용할 수 없습니다.",
     "saveError": "설정을 저장하지 못했습니다. 이 설정 항목을 닫았다가 다시 열어 저장 상태를 확인한 후 다시 시도해 주세요."
   }
 }

package/locale/zh.json

@@ -14,6 +14,17 @@
     "incomplete": "部分技能源无法加载，列表可能不完整。",
     "use": "使用",
     "disabled": "已关闭",
+    "openFolder": "打开文件夹",
+    "openingFolder": "正在打开文件夹…",
+    "openFolderHint": "在 DSH 主机的文件管理器中打开此技能的文件夹。",
+    "openFolderUnavailable": "打开文件夹需要 DSH 主机具备桌面环境。",
+    "openFolderError": "无法打开技能文件夹。请检查 DSH 主机的文件管理器后重试。",
+    "translate": "查看译文",
+    "original": "查看原文",
+    "retry": "重试",
+    "translating": "正在翻译…",
+    "translationNotice": "展开技能时，会自动将描述发送至思考过程翻译设置中选择的服务。译文按该设置的目标语言缓存。",
+    "translationError": "翻译失败，已显示原文。付费服务需要会话，无法在此页面使用。",
     "saveError": "无法保存设置。请关闭并重新打开此设置项，确认已保存的状态后重试。"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dungsil/dsh-plugin-ui-setting-skills",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "View loaded user skills in DeepSeek Harness settings.",
   "license": "MIT",
   "repository": {
@@ -11,6 +11,7 @@
   "files": [
     "dist",
     "locale",
+    "assets",
     "cordis.patch.yml"
   ],
   "type": "module",
@@ -23,6 +24,11 @@
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "@deepseek-ai/dsh-atomic-write": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-home-paths": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-native-command": "0.2.1-rc.5"
+  },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.5",
     "@deepseek-ai/dsh-app-boot": "0.2.1-rc.5",
@@ -32,6 +38,7 @@
     "@deepseek-ai/dsh-client-ui-settings": "0.2.1-rc.5",
     "@deepseek-ai/dsh-config-editor": "0.2.1-rc.5",
     "@deepseek-ai/dsh-credentials-local": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-experimental-client-ui-cot-translation": "0.2.1-rc.5",
     "@deepseek-ai/dsh-skill": "0.2.1-rc.5",
     "@deepseek-ai/dsh-skill-filesystem": "0.2.1-rc.5",
     "@deepseek-ai/schemastery": "3.18.5",
@@ -39,7 +46,10 @@
     "@dungsil/dsh-tsdown": "0.0.0",
     "@dungsil/dsh-ui": "0.0.0",
     "@types/react": "18.3.31",
+    "@types/react-dom": "18.3.7",
+    "happy-dom": "21.0.4",
     "react": "18.3.1",
+    "react-dom": "18.3.1",
     "tsdown": "0.23.4"
   },
   "peerDependencies": {