@sparkelf/dsh-client-ui-skill-center 0.2.1-alpha.29 → 0.2.1-alpha.30

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/plus/ui-skill-center/README.md
-README.md: 0402b32b8f3fd4b1e290a3036d335ba119db970c
-README.zh.md: 4a1ea41110d11bf7d3de4b91878c27b1d61fa8dc
+README.md: ffac1f7d3aeb0e73c23f99b728b65f5a3e776884
+README.zh.md: 70e530cb1f95d6b365358f8fb96a514ab5379770

package/README.md

@@ -14,7 +14,8 @@ A skill center for the dsh Web sidebar: browses loaded skills grouped by source,
 ## What it does
 
 - **Sidebar entry** "Skill Center" opens a panel, registered through the official `sidebar.panellist` slot and the keyed `main` page slot — the same slots the Plugins panel uses, so the shell owns the row, label, and selected state.
-- **Skills list**: skills grouped by discovery source (bundled / runtime / `~/.agents/skills` / `~/.dsh/skills` / project `.agents/skills` / project `.dsh/skills` / custom roots), with a search box that filters by name, description, or when-to-use.
+- **Skills list**: skills grouped by discovery source (bundled / runtime / `~/.agents/skills` / `~/.dsh/skills` / project `.agents/skills` / project `.dsh/skills` / custom roots). A card carries the skill's summary — its translated one when a translation sits beside the skill, otherwise the registry description — and a search box filters by name, description, summary, or when-to-use.
+- **Details**: a card opens the skill's own `SKILL.md` body in a scrolling block, under the metadata row. The body is read when the dialog opens, so a long skill costs nothing until it is asked for.
 - **Enable / disable**: rewrites `disable-model-invocation` in the skill's YAML frontmatter. The field is edited in place rather than re-serialized, so comments, key order, and the body survive.
 - **Create**: writes a standard `SKILL.md` under the user or project root.
 - **Delete**: moves the skill into a `.trash` sibling directory, where it can be restored.
@@ -33,7 +34,7 @@ A skill center for the dsh Web sidebar: browses loaded skills grouped by source,
 
 Reading goes through the official `ctx.skills` registry, so the catalog and its hot reload are the harness's rather than a second scanner's. The registry's summaries deliberately omit file paths — they are invocation-neutral metadata — so a write resolves the path through `ctx.skills.get()` when an action actually needs to touch a file. `collect()` caches the catalog those calls share, so the resolve is not a second scan.
 
-The three writes have no official equivalent; the registry is read-only.
+The three writes have no official equivalent; the registry is read-only. The content route resolves the file the panel listed first, then through `ctx.skills.get()`, then through the configured `translationRoot`: a bundled skill serves its body from inside an installed package, where the registry reports a path or a provider raises, so one source is never the only answer.
 
 Every colour, border, and label weight comes from the shared alias tokens (`--dsw-alias-*`), and the sidebar glyph is `IconSkillOutline16` from `@deepseek-ai/dsh-client-ui-primitives`, so the panel and its row match the official panels beside them.
 
@@ -54,7 +55,7 @@ None; no string this package owns reaches a model request, so a request's cachea
 No runtime invariant companion is published. The package owns no durable package-local state: the route handlers read the skill registry and write skill files, and every observable outcome is covered by the route tests.
 
 - **Deletion refuses a symlinked skill**: a skill discovered through a symlink has no single owning directory to move, so the delete action is withheld for it.
-- **The list omits file paths**: whether a skill can be deleted is therefore not known until the delete is attempted, which then reports it.
+- **The list omits file paths**: a registry-served row has no path, so the panel can neither offer its deletion nor read its body by path; whether either applies is known only when the action is attempted.
 - **Grouping follows the discovery source label, not the file path**: a provider that reports an unrecognized source lands in the custom group.
 
 <a id="dev-note"></a>

package/README.zh.md

@@ -16,7 +16,8 @@ dsh Web 侧边栏的技能中心：按来源分组浏览已加载的技能、启
 ## 功能
 
 - **侧边栏入口**「技能中心」打开一个面板，它通过官方 `sidebar.panellist` 槽位与键控的 `main` 页面槽位注册 —— 与「插件」面板用的是同一批槽位，因此行、标签与选中态由外壳负责。
-- **技能列表**：按发现来源分组（系统内置 / 运行时 / `~/.agents/skills` / `~/.dsh/skills` / 项目 `.agents/skills` / 项目 `.dsh/skills` / 自定义目录），并有一个搜索框按名称、描述或何时使用过滤。
+- **技能列表**：按发现来源分组（系统内置 / 运行时 / `~/.agents/skills` / `~/.dsh/skills` / 项目 `.agents/skills` / 项目 `.dsh/skills` / 自定义目录）。卡片只带一句简介 —— 技能旁有翻译时用译文，否则用注册表的描述 —— 搜索框按名称、描述、简介或何时使用过滤。
+- **详情**：卡片打开后，在元数据行下方以滚动区块展示该技能自己的 `SKILL.md` 正文。正文在弹窗打开时才读取，因此长技能在没人点开前不产生任何开销。
 - **启用 / 停用**：改写技能 YAML 前置块里的 `disable-model-invocation`。该字段是就地编辑而非重新序列化，因此注释、键顺序与正文都原样保留。
 - **新建**：在用户级或项目级根目录下写入一个标准的 `SKILL.md`。
 - **删除**：把技能移入同级的 `.trash` 目录，可从中恢复。
@@ -37,7 +38,7 @@ dsh Web 侧边栏的技能中心：按来源分组浏览已加载的技能、启
 
 读取走官方的 `ctx.skills` 注册表，因此目录与其热更新属于 harness 本身，而不是第二套扫描器。注册表的摘要有意省略文件路径 —— 它们是调用无关元数据 —— 所以写操作在真正需要触碰文件时通过 `ctx.skills.get()` 解析路径。这些调用共享的目录由 `collect()` 缓存，因此该解析不是第二次全量扫描。
 
-三个写操作在官方没有等价物；注册表是只读的。
+三个写操作在官方没有等价物；注册表是只读的。正文路由先解析面板列出的文件，再走 `ctx.skills.get()`，最后走配置的 `translationRoot`：内置技能的正文安装在已安装的包内，注册表要么报告路径、要么提供者抛错，因此任何单一来源都不能是唯一答案。
 
 每一个颜色、边框与标签字重都来自共享别名 token（`--dsw-alias-*`），侧边栏图标是 `@deepseek-ai/dsh-client-ui-primitives` 的 `IconSkillOutline16`，因此面板与其行与旁边的官方面板一致。
 
@@ -61,7 +62,7 @@ host 半边挂载 `/api/dsh-skill-center` 路由族；client 半边注册侧边
 No runtime invariant companion is published. 本包不拥有任何持久化的包内状态：路由处理器读取技能注册表并写入技能文件，每一个可观察结果都由路由测试覆盖。
 
 - **删除会拒绝符号链接的技能**：通过符号链接发现的技能没有唯一归属目录可移动，因此对它不提供删除操作。
-- **列表省略文件路径**：因此某个技能能否删除，要等到删除被尝试时才知道，那时才会报告。
+- **列表省略文件路径**：注册表提供的行没有路径，因此面板既无法为它提供删除，也无法按路径读取它的正文；这两者是否适用，只有真正执行该操作时才知道。
 - **分组跟随发现来源标签，而不是文件路径**：报告了无法识别的来源的提供者会落到自定义分组。
 
 <a id="dev-note"></a>

package/lib/client.js

@@ -8,7 +8,7 @@ window.__ModuleLoader__.load({
 		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 		let react_jsx_runtime = require("react/jsx-runtime");
 		//#region \0dsh-css:/root/projects/deepseek-harness-plus/packages/plus/ui-skill-center/src/client/SkillCenterPage.module.css.mjs
-		const css = ".DGiSta_page{box-sizing:border-box;height:100%;color:var(--dsw-alias-label-primary);flex-direction:column;align-items:center;gap:32px;padding:28px clamp(24px,4vw,48px) 48px;display:flex;overflow:auto}.DGiSta_page>*{width:100%;max-width:960px}.DGiSta_pageHead{justify-content:space-between;align-items:flex-start;gap:16px;display:flex}.DGiSta_pageTitle{margin:0;font-size:20px;font-weight:500;line-height:28px}.DGiSta_pageIntro{color:var(--dsw-alias-label-secondary);margin:4px 0 0;font-size:13px;line-height:20px}.DGiSta_toolbar{justify-content:flex-end;align-items:center;gap:16px;display:flex}.DGiSta_iconButton{width:28px;height:28px;color:var(--dsw-alias-label-caption);cursor:pointer;background:0 0;border:0;border-radius:28px;justify-content:center;align-items:center;display:inline-flex}.DGiSta_iconButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}.DGiSta_iconButton:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}.DGiSta_iconWrap{display:inline-flex}.DGiSta_button{border:.5px solid var(--dsw-alias-border-l3);height:32px;color:var(--dsw-alias-label-primary);cursor:pointer;background:0 0;border-radius:8px;padding:0 12px;font-size:13px}.DGiSta_button:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}.DGiSta_button:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}.DGiSta_search{box-sizing:border-box;border:.5px solid var(--dsw-alias-border-l3);width:100%;height:36px;color:var(--dsw-alias-label-primary);background:0 0;border-radius:10px;padding:0 12px;font-size:13px}.DGiSta_search::placeholder{color:var(--dsw-alias-label-tertiary)}.DGiSta_group{margin-top:28px}.DGiSta_groupTitle{align-items:baseline;gap:8px;margin:0 0 12px;font-size:15px;font-weight:500;line-height:22px;display:flex}.DGiSta_groupCount{color:var(--dsw-alias-label-tertiary);font-size:13px;font-weight:400}.DGiSta_groupHint{color:var(--dsw-alias-label-caption);font-size:12px;font-weight:400}.DGiSta_cards{grid-template-columns:repeat(2,minmax(0,1fr));align-items:start;gap:10px;margin:0;padding:0;list-style:none;display:grid}.DGiSta_card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);border-radius:12px;flex-direction:column;align-self:start;gap:12px;min-width:0;padding:12px 14px;display:flex}.DGiSta_cardHead{align-items:center;gap:10px;min-width:0;display:flex}.DGiSta_cardIcon{background:var(--dsw-alias-bg-layer-2);width:28px;height:28px;color:var(--dsw-alias-label-secondary);border-radius:50%;flex:none;place-items:center;display:grid}.DGiSta_cardForeign{opacity:.72}.DGiSta_workspaceBadge{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary);vertical-align:middle;border-radius:4px;margin-left:8px;padding:1px 6px;font-size:11px;font-weight:400;line-height:16px}.DGiSta_cardTitle{text-overflow:ellipsis;white-space:nowrap;font-size:15px;font-weight:600;line-height:22px;overflow:hidden}.DGiSta_cardTitleRow{flex:1;align-items:center;gap:8px;min-width:0;display:flex}.DGiSta_cardDesc{color:var(--dsw-alias-label-secondary);-webkit-line-clamp:2;-webkit-box-orient:vertical;font-size:12px;line-height:18px;display:-webkit-box;overflow:hidden}.DGiSta_cardWhenToUse{color:var(--dsw-alias-label-caption);font-size:12px;line-height:18px}.DGiSta_cardMarks{flex-wrap:wrap;gap:6px;margin-top:2px;display:flex}.DGiSta_mark{border:1px solid var(--dsw-alias-border-l3);color:var(--dsw-alias-label-secondary);white-space:nowrap;border-radius:4px;padding:1px 6px;font-size:11px;line-height:16px}.DGiSta_markOn{border-color:var(--dsw-alias-state-business-primary);color:var(--dsw-alias-state-business-primary)}.DGiSta_markOff{border-color:var(--dsw-alias-border-l4);color:var(--dsw-alias-label-caption)}.DGiSta_markDanger{border-color:var(--dsw-alias-state-error-primary);color:var(--dsw-alias-state-error-primary)}.DGiSta_cardEnd{flex:none;justify-content:space-between;align-items:center;gap:8px;margin-top:auto;padding-top:2px;display:flex}.DGiSta_cardBody{flex-direction:column;gap:6px;min-width:0;display:flex}.DGiSta_switch{background:var(--dsw-alias-border-l3);cursor:pointer;border:none;border-radius:10px;width:36px;height:20px;transition:background .12s;position:relative}.DGiSta_switch:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}.DGiSta_switchOn{background:var(--dsw-alias-state-success-primary)}.DGiSta_switch:after{content:\"\";background:var(--dsw-alias-bg-layer-1);border-radius:50%;width:16px;height:16px;transition:transform .12s;position:absolute;top:2px;left:2px}.DGiSta_switchOn:after{transform:translate(16px)}.DGiSta_dialog{width:min(560px,100%)}.DGiSta_form{flex-direction:column;gap:12px;display:flex}.DGiSta_field{flex-direction:column;gap:4px;display:flex}.DGiSta_fieldLabel{color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px}.DGiSta_input{box-sizing:border-box;border:.5px solid var(--dsw-alias-border-l3);height:32px;color:var(--dsw-alias-label-primary);background:0 0;border-radius:8px;padding:0 10px;font-size:13px}.DGiSta_textarea{box-sizing:border-box;border:.5px solid var(--dsw-alias-border-l3);min-height:80px;color:var(--dsw-alias-label-primary);font-family:var(--dsw-font-markdown-code-block-small);resize:vertical;background:0 0;border-radius:8px;padding:8px 10px;font-size:12px}.DGiSta_status{text-align:center;color:var(--dsw-alias-label-tertiary);padding:32px 0;font-size:13px}.DGiSta_statusError{color:var(--dsw-alias-state-error-primary)}";
+		const css = ".DGiSta_page{box-sizing:border-box;height:100%;color:var(--dsw-alias-label-primary);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);flex-direction:column;align-items:center;gap:16px;padding:24px clamp(24px,4vw,40px) 40px;display:flex;overflow:auto}.DGiSta_page>*{width:100%;max-width:960px}.DGiSta_pageHead{justify-content:space-between;align-items:center;gap:16px;display:flex}.DGiSta_pageTitle{margin:0;font-size:20px;font-weight:500;line-height:28px}.DGiSta_toolbar{justify-content:flex-end;align-items:center;gap:16px;display:flex}.DGiSta_iconButton{width:28px;height:28px;color:var(--dsw-alias-label-caption);cursor:pointer;background:0 0;border:0;border-radius:28px;justify-content:center;align-items:center;display:inline-flex}.DGiSta_iconButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}.DGiSta_iconButton:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}.DGiSta_iconWrap{display:inline-flex}.DGiSta_search{width:100%}.DGiSta_group{min-width:0}.DGiSta_groupTitle{align-items:baseline;gap:8px;margin:0 0 8px;font-size:14px;font-weight:500;line-height:20px;display:flex}.DGiSta_groupCount{color:var(--dsw-alias-label-tertiary);font-size:12px;font-weight:400}.DGiSta_cards{grid-template-columns:repeat(auto-fill,minmax(272px,1fr));align-items:start;gap:12px;margin:0;padding:0;list-style:none;display:grid}.DGiSta_card{border:.5px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);border-radius:10px;flex-direction:column;align-self:start;gap:10px;min-width:0;padding:12px;display:flex}.DGiSta_cardHead{align-items:center;gap:10px;min-width:0;display:flex}.DGiSta_cardIcon{corner-shape:round;background:var(--dsw-alias-bg-layer-2);width:28px;height:28px;color:var(--dsw-alias-label-secondary);border-radius:50%;flex:none;place-items:center;display:grid}.DGiSta_cardForeign{opacity:.72}.DGiSta_workspaceBadge{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary);vertical-align:middle;border-radius:4px;margin-left:8px;padding:1px 6px;font-size:11px;font-weight:400;line-height:16px}.DGiSta_cardTitle{text-overflow:ellipsis;white-space:nowrap;font-size:14px;font-weight:600;line-height:20px;overflow:hidden}.DGiSta_cardTitleRow{flex:1;align-items:center;gap:8px;min-width:0;display:flex}.DGiSta_cardMarks{flex-wrap:wrap;gap:6px;margin-top:2px;display:flex}.DGiSta_mark{color:var(--dsw-alias-state-business-primary);white-space:nowrap;background:#ecf1fc;border:0;border-radius:4px;padding:2px 7px;font-size:11px;font-weight:500;line-height:16px}.DGiSta_markOff,.DGiSta_markDanger{background:#ecf1fc}.DGiSta_detail{flex-direction:column;gap:12px;margin:0;display:flex}.DGiSta_cardActions{flex:none;align-items:center;gap:4px;display:inline-flex}.DGiSta_detailRow{flex-direction:column;gap:2px;display:flex}.DGiSta_detailLabel{color:var(--dsw-alias-label-caption);font-size:11px;line-height:16px}.DGiSta_detailValue{color:var(--dsw-alias-label-secondary);overflow-wrap:anywhere;margin:0;font-size:12px;line-height:18px}.DGiSta_cardEnd{flex:none;justify-content:space-between;align-items:center;gap:8px;margin-top:auto;padding-top:2px;display:flex}.DGiSta_cardBody{flex-direction:column;gap:6px;min-width:0;display:flex}.DGiSta_switch{background:var(--dsw-alias-border-l3);cursor:pointer;border:none;border-radius:10px;width:36px;height:20px;transition:background .12s;position:relative}.DGiSta_switch:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}.DGiSta_switchOn{background:var(--dsw-alias-state-success-primary)}.DGiSta_switch:after{content:\"\";corner-shape:round;background:var(--dsw-alias-bg-layer-1);border-radius:50%;width:16px;height:16px;transition:transform .12s;position:absolute;top:2px;left:2px}.DGiSta_switchOn:after{transform:translate(16px)}.DGiSta_dialog{width:min(560px,100%)}.DGiSta_form{flex-direction:column;gap:12px;display:flex}.DGiSta_field{flex-direction:column;gap:4px;display:flex}.DGiSta_fieldLabel{color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px}.DGiSta_input{box-sizing:border-box;border:.5px solid var(--dsw-alias-border-l3);height:32px;color:var(--dsw-alias-label-primary);background:0 0;border-radius:8px;padding:0 10px;font-size:13px}.DGiSta_textarea{box-sizing:border-box;border:.5px solid var(--dsw-alias-border-l3);min-height:80px;color:var(--dsw-alias-label-primary);font-family:var(--dsw-font-markdown-code-block-small);resize:vertical;background:0 0;border-radius:8px;padding:8px 10px;font-size:12px}.DGiSta_status{text-align:center;color:var(--dsw-alias-label-tertiary);padding:32px 0;font-size:13px}.DGiSta_statusError{color:var(--dsw-alias-state-error-primary)}.DGiSta_cardSummary{color:var(--dsw-alias-label-secondary);-webkit-line-clamp:2;-webkit-box-orient:vertical;font-size:12px;line-height:18px;display:-webkit-box;overflow:hidden}.DGiSta_body{flex-direction:column;gap:4px;min-width:0;margin-top:16px;display:flex}.DGiSta_bodyLabel{color:var(--dsw-alias-label-caption);margin:0;font-size:11px;font-weight:500;line-height:16px}.DGiSta_bodyPre{background:var(--dsw-alias-markdown-code-block);max-height:46vh;color:var(--dsw-alias-label-primary);font-family:var(--dsw-font-markdown-code-block-small-font-family);font-size:var(--dsw-font-markdown-code-block-small-font-size);line-height:var(--dsw-font-markdown-code-block-small-line-height);white-space:pre-wrap;overflow-wrap:anywhere;--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);border-radius:8px;margin:0;padding:12px;overflow:auto}.DGiSta_bodyStatus{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:18px}.DGiSta_bodyError{color:var(--dsw-alias-state-error-primary);}.DGiSta_progressRow{align-items:center;gap:8px;margin-bottom:12px;display:flex}.DGiSta_progressLabel{color:var(--dsw-alias-label-secondary);white-space:nowrap;font-size:12px;line-height:18px}.DGiSta_progressTrack{background:var(--dsw-alias-border-l2);border-radius:2px;flex:1;height:4px;overflow:hidden}.DGiSta_progressFill{background:var(--dsw-alias-label-primary);border-radius:2px;height:100%;transition:width .2s;display:block}.DGiSta_progressCount{color:var(--dsw-alias-label-secondary);font-variant-numeric:tabular-nums;white-space:nowrap;font-size:12px;line-height:18px}";
 		const tagId = "@sparkelf/dsh-client-ui-skill-center/SkillCenterPage.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");
@@ -18,26 +18,33 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var SkillCenterPage_module_css_default = {
-			"button": "DGiSta_button",
+			"body": "DGiSta_body",
+			"bodyError": "DGiSta_bodyError",
+			"bodyLabel": "DGiSta_bodyLabel",
+			"bodyPre": "DGiSta_bodyPre",
+			"bodyStatus": "DGiSta_bodyStatus",
 			"card": "DGiSta_card",
+			"cardActions": "DGiSta_cardActions",
 			"cardBody": "DGiSta_cardBody",
-			"cardDesc": "DGiSta_cardDesc",
 			"cardEnd": "DGiSta_cardEnd",
 			"cardForeign": "DGiSta_cardForeign",
 			"cardHead": "DGiSta_cardHead",
 			"cardIcon": "DGiSta_cardIcon",
 			"cardMarks": "DGiSta_cardMarks",
+			"cardSummary": "DGiSta_cardSummary",
 			"cardTitle": "DGiSta_cardTitle",
 			"cardTitleRow": "DGiSta_cardTitleRow",
-			"cardWhenToUse": "DGiSta_cardWhenToUse",
 			"cards": "DGiSta_cards",
+			"detail": "DGiSta_detail",
+			"detailLabel": "DGiSta_detailLabel",
+			"detailRow": "DGiSta_detailRow",
+			"detailValue": "DGiSta_detailValue",
 			"dialog": "DGiSta_dialog",
 			"field": "DGiSta_field",
 			"fieldLabel": "DGiSta_fieldLabel",
 			"form": "DGiSta_form",
 			"group": "DGiSta_group",
 			"groupCount": "DGiSta_groupCount",
-			"groupHint": "DGiSta_groupHint",
 			"groupTitle": "DGiSta_groupTitle",
 			"iconButton": "DGiSta_iconButton",
 			"iconWrap": "DGiSta_iconWrap",
@@ -45,11 +52,14 @@ window.__ModuleLoader__.load({
 			"mark": "DGiSta_mark",
 			"markDanger": "DGiSta_markDanger",
 			"markOff": "DGiSta_markOff",
-			"markOn": "DGiSta_markOn",
 			"page": "DGiSta_page",
 			"pageHead": "DGiSta_pageHead",
-			"pageIntro": "DGiSta_pageIntro",
 			"pageTitle": "DGiSta_pageTitle",
+			"progressCount": "DGiSta_progressCount",
+			"progressFill": "DGiSta_progressFill",
+			"progressLabel": "DGiSta_progressLabel",
+			"progressRow": "DGiSta_progressRow",
+			"progressTrack": "DGiSta_progressTrack",
 			"search": "DGiSta_search",
 			"status": "DGiSta_status",
 			"statusError": "DGiSta_statusError",
@@ -72,7 +82,9 @@ window.__ModuleLoader__.load({
 			list: "/api/dsh-skill-center/list",
 			setEnabled: "/api/dsh-skill-center/set-enabled",
 			create: "/api/dsh-skill-center/create",
-			remove: "/api/dsh-skill-center/delete"
+			remove: "/api/dsh-skill-center/delete",
+			content: "/api/dsh-skill-center/content",
+			translationProgress: "/api/dsh-skill-center/translation-progress"
 		};
 		/** One thrown API error carrying the host's message. */
 		var ApiError = class extends Error {};
@@ -111,6 +123,27 @@ window.__ModuleLoader__.load({
 					}
 				});
 			}
+			/**
+			* One skill's instruction body, without the YAML frontmatter the card already
+			* shows as metadata.
+			*
+			* The path the list served travels back with the request: a row from another
+			* workspace is read from the file that was listed rather than from whatever the
+			* viewing workspace's registry resolves by name.
+			*/
+			async content(name, path, cwd) {
+				const params = new URLSearchParams({ name });
+				if (path !== void 0 && path !== "") params.set("path", path);
+				if (cwd !== void 0 && cwd !== "") params.set("cwd", cwd);
+				return this.request(API.content + "?" + params.toString());
+			}
+			/**
+			* The translated share of the skill set, or undefined when the host has not
+			* been told where the translations live (the route then answers `{}`).
+			*/
+			async translationProgress() {
+				return (await this.request(API.translationProgress)).progress;
+			}
 			async request(path, options = {}) {
 				const init = { method: options.method ?? "GET" };
 				if (options.body !== void 0) {
@@ -157,13 +190,59 @@ window.__ModuleLoader__.load({
 			});
 		}
 		/**
-		* One skill row.
-		* @param props - the entry, its toggle, and its delete action.
+		* One skill row, with the dialog that shows the skill's own Markdown.
+		* @param props - the entry, the API client and viewing context its body is read
+		* with, its toggle, and its delete action.
 		* @returns the row.
 		*/
-		function SkillCard({ skill, t, onToggle, onDelete }) {
+		function SkillCard({ skill, api, cwd, t, onToggle, onDelete }) {
+			const [open, setOpen] = (0, react.useState)(false);
+			const [body, setBody] = (0, react.useState)({ kind: "loading" });
+			(0, react.useEffect)(() => {
+				if (!open) return;
+				let cancelled = false;
+				setBody({ kind: "loading" });
+				api.content(skill.name, skill.path, cwd).then((payload) => {
+					if (!cancelled) setBody({
+						kind: "ready",
+						content: payload.content
+					});
+				}).catch((error) => {
+					if (!cancelled) setBody({
+						kind: "failed",
+						message: error instanceof Error ? error.message : String(error)
+					});
+				});
+				return () => {
+					cancelled = true;
+				};
+			}, [
+				open,
+				api,
+				skill.name,
+				skill.path,
+				cwd
+			]);
+			const foreign = skill.isActiveWorkspace === false && skill.workspaceName !== void 0;
+			const details = [];
+			if (skill.whenToUse !== void 0) details.push({
+				key: "detail.whenToUse",
+				value: skill.whenToUse
+			});
+			details.push({
+				key: "detail.source",
+				value: skill.level
+			});
+			if (skill.provider !== void 0) details.push({
+				key: "detail.provider",
+				value: skill.provider
+			});
+			if (skill.path !== void 0) details.push({
+				key: "detail.path",
+				value: skill.path
+			});
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", {
-				className: skill.isActiveWorkspace === false && skill.workspaceName !== void 0 ? SkillCenterPage_module_css_default.card + " " + SkillCenterPage_module_css_default.cardForeign : SkillCenterPage_module_css_default.card,
+				className: foreign ? SkillCenterPage_module_css_default.card + " " + SkillCenterPage_module_css_default.cardForeign : SkillCenterPage_module_css_default.card,
 				children: [
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: SkillCenterPage_module_css_default.cardHead,
@@ -174,7 +253,7 @@ window.__ModuleLoader__.load({
 							className: SkillCenterPage_module_css_default.cardTitleRow,
 							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 								className: SkillCenterPage_module_css_default.cardTitle,
-								children: skill.name
+								children: skill.i18n?.title ?? skill.name
 							}), skill.workspaceName === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								className: SkillCenterPage_module_css_default.workspaceBadge,
 								children: skill.workspaceName
@@ -183,33 +262,26 @@ window.__ModuleLoader__.load({
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: SkillCenterPage_module_css_default.cardBody,
-						children: [
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-								className: SkillCenterPage_module_css_default.cardDesc,
-								children: skill.description
-							}),
-							skill.whenToUse === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-								className: SkillCenterPage_module_css_default.cardWhenToUse,
-								children: skill.whenToUse
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-								className: SkillCenterPage_module_css_default.cardMarks,
-								children: [
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-										className: skill.modelInvocable ? SkillCenterPage_module_css_default.mark + " " + SkillCenterPage_module_css_default.markOn : SkillCenterPage_module_css_default.mark + " " + SkillCenterPage_module_css_default.markOff,
-										children: t("skill.modelInvocable")
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-										className: skill.userInvocable ? SkillCenterPage_module_css_default.mark + " " + SkillCenterPage_module_css_default.markOn : SkillCenterPage_module_css_default.mark + " " + SkillCenterPage_module_css_default.markOff,
-										children: t("skill.userInvocable")
-									}),
-									skill.linked === true ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-										className: SkillCenterPage_module_css_default.mark + " " + SkillCenterPage_module_css_default.markDanger,
-										children: t("skill.linked")
-									}) : null
-								]
-							})
-						]
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: SkillCenterPage_module_css_default.cardSummary,
+							children: skill.i18n?.summary ?? skill.description
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: SkillCenterPage_module_css_default.cardMarks,
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: skill.modelInvocable ? SkillCenterPage_module_css_default.mark + " " + SkillCenterPage_module_css_default.markOn : SkillCenterPage_module_css_default.mark + " " + SkillCenterPage_module_css_default.markOff,
+									children: t("skill.modelInvocable")
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: skill.userInvocable ? SkillCenterPage_module_css_default.mark + " " + SkillCenterPage_module_css_default.markOn : SkillCenterPage_module_css_default.mark + " " + SkillCenterPage_module_css_default.markOff,
+									children: t("skill.userInvocable")
+								}),
+								skill.linked === true ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: SkillCenterPage_module_css_default.mark + " " + SkillCenterPage_module_css_default.markDanger,
+									children: t("skill.linked")
+								}) : null
+							]
+						})]
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: SkillCenterPage_module_css_default.cardEnd,
@@ -221,13 +293,77 @@ window.__ModuleLoader__.load({
 							onClick: () => {
 								onToggle(skill, !skill.modelInvocable);
 							}
-						}), skill.path === void 0 || skill.linked === true ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-							type: "button",
-							className: SkillCenterPage_module_css_default.button,
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: SkillCenterPage_module_css_default.cardActions,
+							children: [skill.path === void 0 || skill.linked === true ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+								variant: "outline",
+								size: "sm",
+								onClick: () => {
+									onDelete(skill);
+								},
+								children: t("action.delete")
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+								variant: "outline",
+								size: "sm",
+								onClick: () => {
+									setOpen(true);
+								},
+								children: t("action.showDetail")
+							})]
+						})]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(_deepseek_ai_dsh_client_ui_primitives.Modal, {
+						open,
+						onClose: () => {
+							setOpen(false);
+						},
+						title: skill.name,
+						closeLabel: t("action.close"),
+						className: SkillCenterPage_module_css_default.dialog,
+						footer: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+							variant: "outline",
 							onClick: () => {
-								onDelete(skill);
+								setOpen(false);
 							},
-							children: t("action.delete")
+							children: t("action.close")
+						}),
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("dl", {
+							className: SkillCenterPage_module_css_default.detail,
+							children: details.map((item) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: SkillCenterPage_module_css_default.detailRow,
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("dt", {
+									className: SkillCenterPage_module_css_default.detailLabel,
+									children: t(item.key)
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("dd", {
+									className: SkillCenterPage_module_css_default.detailValue,
+									children: item.value
+								})]
+							}, item.key))
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+							className: SkillCenterPage_module_css_default.body,
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+									className: SkillCenterPage_module_css_default.bodyLabel,
+									children: t("detail.content")
+								}),
+								body.kind === "loading" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+									className: SkillCenterPage_module_css_default.bodyStatus,
+									children: t("content.loading")
+								}) : null,
+								body.kind === "failed" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
+									className: SkillCenterPage_module_css_default.bodyError,
+									children: [
+										t("content.failed"),
+										": ",
+										body.message
+									]
+								}) : null,
+								body.kind === "ready" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("pre", {
+									className: SkillCenterPage_module_css_default.bodyPre,
+									"data-skill-body": skill.name,
+									children: body.content
+								}) : null
+							]
 						})]
 					})
 				]
@@ -242,6 +378,7 @@ window.__ModuleLoader__.load({
 			const api = (0, react.useMemo)(() => new SkillApi(), []);
 			const [state, setState] = (0, react.useState)({ kind: "loading" });
 			const [query, setQuery] = (0, react.useState)("");
+			const [progress, setProgress] = (0, react.useState)(void 0);
 			const [creating, setCreating] = (0, react.useState)(false);
 			const [draft, setDraft] = (0, react.useState)({
 				name: "",
@@ -271,13 +408,22 @@ window.__ModuleLoader__.load({
 			(0, react.useEffect)(() => {
 				load();
 			}, [load]);
+			(0, react.useEffect)(() => {
+				let cancelled = false;
+				api.translationProgress().then((p) => {
+					if (!cancelled) setProgress(p);
+				}).catch(() => {});
+				return () => {
+					cancelled = true;
+				};
+			}, [api]);
 			const groups = (0, react.useMemo)(() => {
 				if (state.kind !== "ready") return [];
 				const q = query.trim().toLowerCase();
 				if (q === "") return state.payload.groups;
 				return state.payload.groups.map((g) => ({
 					...g,
-					skills: g.skills.filter((s) => s.name.toLowerCase().includes(q) || s.description.toLowerCase().includes(q) || (s.whenToUse ?? "").toLowerCase().includes(q))
+					skills: g.skills.filter((s) => s.name.toLowerCase().includes(q) || s.description.toLowerCase().includes(q) || (s.i18n?.title ?? "").toLowerCase().includes(q) || (s.i18n?.description ?? "").toLowerCase().includes(q) || (s.i18n?.summary ?? "").toLowerCase().includes(q) || (s.whenToUse ?? "").toLowerCase().includes(q))
 				})).filter((g) => g.skills.length > 0);
 			}, [state, query]);
 			const toggle = (0, react.useCallback)(async (skill, enabled) => {
@@ -352,13 +498,10 @@ window.__ModuleLoader__.load({
 				children: [
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("header", {
 						className: SkillCenterPage_module_css_default.pageHead,
-						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h1", {
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h1", {
 							className: SkillCenterPage_module_css_default.pageTitle,
 							children: t("panel")
-						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-							className: SkillCenterPage_module_css_default.pageIntro,
-							children: t("panel.intro")
-						})] }), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 							className: SkillCenterPage_module_css_default.toolbar,
 							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 								type: "button",
@@ -464,14 +607,40 @@ window.__ModuleLoader__.load({
 							]
 						})
 					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Input, {
 						className: SkillCenterPage_module_css_default.search,
+						icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconSearchOutlineRegular, {}),
 						placeholder: t("search.placeholder"),
+						"aria-label": t("search.placeholder"),
 						value: query,
 						onChange: (e) => {
 							setQuery(e.target.value);
 						}
 					}),
+					progress === void 0 || progress.done >= progress.total ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: SkillCenterPage_module_css_default.progressRow,
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: SkillCenterPage_module_css_default.progressLabel,
+								children: t("translate.label")
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: SkillCenterPage_module_css_default.progressTrack,
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: SkillCenterPage_module_css_default.progressFill,
+									style: { width: String(progress.total === 0 ? 0 : Math.round(progress.done / progress.total * 100)) + "%" }
+								})
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: SkillCenterPage_module_css_default.progressCount,
+								children: [
+									progress.done,
+									" / ",
+									progress.total
+								]
+							})
+						]
+					}),
 					state.kind === "loading" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 						className: SkillCenterPage_module_css_default.status,
 						children: t("state.loading")
@@ -496,21 +665,16 @@ window.__ModuleLoader__.load({
 						className: SkillCenterPage_module_css_default.group,
 						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("h2", {
 							className: SkillCenterPage_module_css_default.groupTitle,
-							children: [
-								group.title,
-								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-									className: SkillCenterPage_module_css_default.groupCount,
-									children: group.skills.length
-								}),
-								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-									className: SkillCenterPage_module_css_default.groupHint,
-									children: group.hint
-								})
-							]
+							children: [group.title, /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: SkillCenterPage_module_css_default.groupCount,
+								children: group.skills.length
+							})]
 						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", {
 							className: SkillCenterPage_module_css_default.cards,
 							children: group.skills.map((skill) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SkillCard, {
 								skill,
+								api,
+								cwd: state.kind === "ready" ? state.payload.cwd : scope,
 								t,
 								onToggle: (s, enabled) => {
 									toggle(s, enabled);
@@ -540,18 +704,26 @@ window.__ModuleLoader__.load({
 		/** Simplified Chinese dictionary. */
 		const zh = {
 			"panel": "技能中心",
-			"panel.intro": "浏览已加载的技能，启用或停用模型调用",
 			"search.placeholder": "搜索技能…",
-			"search.clear": "清除搜索",
 			"search.noMatches": "无匹配技能",
 			"action.refresh": "刷新",
 			"action.create": "新建技能",
 			"action.delete": "删除",
+			"action.showDetail": "详情",
+			"action.close": "关闭",
+			"translate.label": "中文翻译",
+			"detail.whenToUse": "何时使用",
+			"detail.source": "来源",
+			"detail.provider": "提供方",
+			"detail.path": "位置",
+			"detail.content": "技能内容",
 			"action.cancel": "取消",
 			"action.confirm": "确定",
 			"state.loading": "正在加载技能…",
 			"state.empty": "该分组暂无技能",
 			"state.failed": "技能列表加载失败",
+			"content.loading": "正在读取技能正文…",
+			"content.failed": "技能正文加载失败",
 			"skill.enabled": "已启用",
 			"skill.disabled": "已停用",
 			"skill.modelInvocable": "模型可调用",
@@ -570,18 +742,26 @@ window.__ModuleLoader__.load({
 		/** English dictionary. */
 		const en = {
 			"panel": "Skill Center",
-			"panel.intro": "Browse loaded skills and control model invocation",
 			"search.placeholder": "Search skills…",
-			"search.clear": "Clear search",
 			"search.noMatches": "No matching skills",
 			"action.refresh": "Refresh",
 			"action.create": "New skill",
 			"action.delete": "Delete",
+			"action.showDetail": "Details",
+			"action.close": "Close",
+			"translate.label": "Chinese",
+			"detail.whenToUse": "When to use",
+			"detail.source": "Source",
+			"detail.provider": "Provider",
+			"detail.path": "Location",
+			"detail.content": "Skill content",
 			"action.cancel": "Cancel",
 			"action.confirm": "Confirm",
 			"state.loading": "Loading skills…",
 			"state.empty": "No skills in this group",
 			"state.failed": "Could not load the skill list",
+			"content.loading": "Loading the skill content…",
+			"content.failed": "Could not load the skill content",
 			"skill.enabled": "Enabled",
 			"skill.disabled": "Disabled",
 			"skill.modelInvocable": "Model invocable",

package/lib/index.js

@@ -2,11 +2,75 @@ import { existsSync, lstatSync } from "node:fs";
 import { mkdir, readFile, readdir, rename, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { basename, dirname, join, resolve } from "node:path";
+//#region lib/types/translations.js
+/**
+* Chinese metadata for the skill center, read from each skill's own directory.
+*
+* The panel renders what the official registry routes on, so the registry's English
+* description is what decides whether the model invokes a skill. Replacing it would
+* change that decision, so a translation is carried alongside and applied only at
+* render time: the card shows Chinese, the model keeps reading English.
+*
+* A skill keeps its translation in its own directory (`<skill>/i18n/zh.json`), which
+* lets a skill and its Chinese travel together and ship from one clone. The skill
+* file itself is located through the registry, so the translation is found even when
+* the skill resolves through a symlink into another repository.
+*
+* @module @sparkelf/dsh-client-ui-skill-center/translations
+*/
+/**
+* Read one skill's translation from beside its resolved skill file.
+*
+* A skill without a translation, or with an unreadable or malformed one, is returned
+* as undefined: the panel then shows the registry values, so a partial translation
+* set degrades to English rather than to a broken card.
+*
+* @param skillFilePath - absolute path of the skill's SKILL.md, when the registry reports one.
+* @returns the translation, or undefined when none is usable.
+*/
+async function readSkillTranslation(skillFilePath) {
+	if (skillFilePath === void 0) return void 0;
+	let record;
+	try {
+		record = JSON.parse(await readFile(join(dirname(skillFilePath), "i18n", "zh.json"), "utf8"));
+	} catch {
+		return;
+	}
+	const { title, description, summary } = record;
+	if (typeof title !== "string" || typeof description !== "string" || typeof summary !== "string") return void 0;
+	return {
+		title,
+		description,
+		summary
+	};
+}
+/**
+* Read translation progress for the panel's progress bar.
+*
+* @param translationRoot - repository holding the skill set, whose `i18n/.progress.json` the script writes.
+* @returns the progress, or undefined when no translation run has recorded one.
+*/
+async function readTranslationProgress(translationRoot) {
+	try {
+		const raw = JSON.parse(await readFile(join(translationRoot, "i18n", ".progress.json"), "utf8"));
+		if (typeof raw.total !== "number" || typeof raw.done !== "number") return void 0;
+		return {
+			total: raw.total,
+			done: raw.done,
+			current: typeof raw.current === "string" ? raw.current : null,
+			finishedAt: typeof raw.finishedAt === "string" ? raw.finishedAt : null
+		};
+	} catch {
+		return;
+	}
+}
+//#endregion
 //#region lib/types/index.js
 /**
 * Skill center — host half. Serves the skill-center data source over the
-* `/api/dsh-skill-center` route family: list grouped by source, enable or disable
-* model invocation, create, delete into a recoverable trash, and health.
+* `/api/dsh-skill-center` route family: list grouped by source, read one skill's
+* body, enable or disable model invocation, create, delete into a recoverable
+* trash, and health.
 *
 * Reading goes through the official `ctx.skills` registry, so the catalog, its
 * provider precedence, and its hot reload are the harness's rather than a second
@@ -30,7 +94,9 @@ const ROUTES = {
 	setEnabled: "/api/dsh-skill-center/set-enabled",
 	create: "/api/dsh-skill-center/create",
 	delete: "/api/dsh-skill-center/delete",
-	health: "/api/dsh-skill-center/health"
+	content: "/api/dsh-skill-center/content",
+	health: "/api/dsh-skill-center/health",
+	translationProgress: "/api/dsh-skill-center/translation-progress"
 };
 /**
 * Groups the panel renders, in order. The level a skill resolves to selects its
@@ -39,38 +105,31 @@ const ROUTES = {
 const SOURCE_GROUPS = [
 	{
 		key: "bundled",
-		title: "系统内置",
-		hint: "随 Harness 一同安装，对所有项目生效"
+		title: "系统内置"
 	},
 	{
 		key: "project-dsh",
-		title: "项目 .dsh/skills",
-		hint: "位于项目目录，仅对该工作区生效"
+		title: "项目 .dsh/skills"
 	},
 	{
 		key: "project-agents",
-		title: "项目 .agents/skills",
-		hint: "位于项目目录，随项目提交，对协作者共享"
+		title: "项目 .agents/skills"
 	},
 	{
 		key: "custom",
-		title: "自定义目录",
-		hint: "由本插件的 customSkillDirs 配置"
+		title: "自定义目录"
 	},
 	{
 		key: "user-dsh",
-		title: "用户 ~/.dsh/skills",
-		hint: "在用户 dsh 目录下，对本机所有项目生效"
+		title: "用户 ~/.dsh/skills"
 	},
 	{
 		key: "user-agents",
-		title: "用户 ~/.agents/skills",
-		hint: "在用户 agents 目录下，对本机所有项目生效"
+		title: "用户 ~/.agents/skills"
 	},
 	{
 		key: "runtime",
-		title: "运行时注册",
-		hint: "由已安装的插件在运行时注册"
+		title: "运行时注册"
 	}
 ];
 /**
@@ -240,6 +299,16 @@ function localSkillRoots(deps, projectRoots, activeRoot) {
 	return roots;
 }
 /**
+* Strip the leading YAML frontmatter from a skill file.
+*
+* @param source - the skill file's complete content.
+* @returns the body below the closing delimiter, or the whole file when it declares none.
+*/
+function stripFrontmatter(source) {
+	const match = /^---\r?\n[\s\S]*?\r?\n---[ \t]*\r?\n?/.exec(source);
+	return match === null ? source : source.slice(match[0].length);
+}
+/**
 * Read `disable-model-invocation` from a skill file.
 * @param source - the skill file's content.
 * @returns the flag when the frontmatter declares it, otherwise undefined.
@@ -311,14 +380,43 @@ async function readJson(req, maxBytes) {
 	if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) throw new Error("request body must be a JSON object");
 	return parsed;
 }
+/**
+* Chinese copy for every skill the list will render, keyed by skill name.
+*
+* The registry omits the skill file path from its summaries, so each one is resolved
+* through `pathOf`, which consults the catalog `collect()` already cached. A skill
+* whose path or translation is missing simply has no entry here and renders in English.
+*
+* @param deps - the routes' dependencies.
+* @param skills - skill names to look up.
+* @param cwd - the viewing context the registry resolves against.
+* @returns the translations found, keyed by name.
+*/
+async function translationsFor(deps, skills, cwd) {
+	const found = /* @__PURE__ */ new Map();
+	const root = deps.translationRoot;
+	await Promise.all(skills.map(async ({ name, path: known }) => {
+		let path = known;
+		if (path === void 0) try {
+			path = await deps.pathOf(name, cwd);
+		} catch {
+			path = void 0;
+		}
+		const translation = await readSkillTranslation(path) ?? (root === void 0 ? void 0 : await readSkillTranslation(join(root, name, "SKILL.md")));
+		if (translation !== void 0) found.set(name, translation);
+	}));
+	return found;
+}
 /** The list handler: group the registry snapshot and the local roots together. */
 async function handleList(deps, cwd) {
 	const projectRoots = [...new Set(deps.activeSessionCwds().map(findProjectRoot).concat(findProjectRoot(cwd)))];
 	const snapshot = await deps.snapshotProject(cwd);
 	const byGroup = new Map(SOURCE_GROUPS.map((g) => [g.key, []]));
 	const seen = /* @__PURE__ */ new Set();
+	const translations = await translationsFor(deps, snapshot.skills.map((s) => ({ name: s.name })), cwd);
 	for (const skill of snapshot.skills) {
 		const level = levelOfSource(skill.source, skill.provider);
+		const i18n = translations.get(skill.name);
 		const entry = {
 			name: skill.name,
 			description: skill.description,
@@ -326,7 +424,8 @@ async function handleList(deps, cwd) {
 			provider: skill.provider,
 			modelInvocable: skill.invocation.modelInvocable,
 			userInvocable: skill.invocation.userInvocable,
-			...skill.whenToUse === void 0 ? {} : { whenToUse: skill.whenToUse }
+			...skill.whenToUse === void 0 ? {} : { whenToUse: skill.whenToUse },
+			...i18n === void 0 ? {} : { i18n }
 		};
 		seen.add(level + ":" + skill.name);
 		(byGroup.get(level) ?? byGroup.get("custom"))?.push(entry);
@@ -334,6 +433,7 @@ async function handleList(deps, cwd) {
 	for (const root of localSkillRoots(deps, projectRoots, findProjectRoot(cwd))) for (const skill of await scanSkillRoot(root.path, root.level, root.workspace)) {
 		if (seen.has(root.level + ":" + skill.name)) continue;
 		seen.add(root.level + ":" + skill.name);
+		const i18n = await readSkillTranslation(skill.path) ?? (deps.translationRoot === void 0 ? void 0 : await readSkillTranslation(join(deps.translationRoot, skill.name, "SKILL.md")));
 		byGroup.get(root.level)?.push({
 			name: skill.name,
 			description: skill.description,
@@ -345,7 +445,8 @@ async function handleList(deps, cwd) {
 			...skill.whenToUse === void 0 ? {} : { whenToUse: skill.whenToUse },
 			...skill.workspaceRoot === void 0 ? {} : { workspaceRoot: skill.workspaceRoot },
 			...skill.workspaceName === void 0 ? {} : { workspaceName: skill.workspaceName },
-			...skill.isActiveWorkspace === void 0 ? {} : { isActiveWorkspace: skill.isActiveWorkspace }
+			...skill.isActiveWorkspace === void 0 ? {} : { isActiveWorkspace: skill.isActiveWorkspace },
+			...i18n === void 0 ? {} : { i18n }
 		});
 	}
 	const groups = [];
@@ -354,7 +455,6 @@ async function handleList(deps, cwd) {
 		if (skills.length > 0) groups.push({
 			key: g.key,
 			title: g.title,
-			hint: g.hint,
 			skills
 		});
 	}
@@ -365,6 +465,39 @@ async function handleList(deps, cwd) {
 		groups
 	};
 }
+/**
+* The content handler: one skill's instruction body, without its frontmatter.
+*
+* The registry's summaries carry metadata only, so the body is read from the file
+* the name resolves to. The path the panel listed is preferred — the row already
+* names its own file, and the panel lists skills from workspaces other than the one
+* being viewed — then the registry's resolution, then the configured translation
+* set's own copy, which is what answers for a bundled skill.
+*
+* @param listedPath - the path the listing served with the row, when the caller sent one.
+*/
+async function handleContent(deps, name, listedPath, cwd) {
+	const candidates = [];
+	if (listedPath !== void 0 && listedPath !== "") candidates.push(listedPath);
+	try {
+		const resolved = await deps.pathOf(name, cwd);
+		if (resolved !== void 0 && !candidates.includes(resolved)) candidates.push(resolved);
+	} catch {}
+	if (deps.translationRoot !== void 0) candidates.push(join(deps.translationRoot, name, SKILL_FILE));
+	for (const candidate of candidates) {
+		let source;
+		try {
+			source = await readFile(candidate, "utf8");
+		} catch {
+			continue;
+		}
+		return {
+			name,
+			content: stripFrontmatter(source)
+		};
+	}
+	throw new Error("skill \"" + name + "\" has no readable SKILL.md");
+}
 /** The set-enabled handler: rewrite the skill's frontmatter flag. */
 async function handleSetEnabled(deps, body, cwd) {
 	const path = await resolveSkillPath(deps, requireString(body.name, "name"), body, cwd);
@@ -452,6 +585,14 @@ function makeRoutes(deps) {
 			path: ROUTES.health,
 			handler: (_req, res) => writeJson(res, 200, { ok: true })
 		},
+		{
+			kind: "exact",
+			path: ROUTES.translationProgress,
+			handler: async (_req, res) => {
+				const progress = deps.translationRoot === void 0 ? void 0 : await readTranslationProgress(deps.translationRoot);
+				writeJson(res, 200, progress === void 0 ? {} : { progress });
+			}
+		},
 		{
 			kind: "exact",
 			path: ROUTES.list,
@@ -464,6 +605,21 @@ function makeRoutes(deps) {
 				}
 			}
 		},
+		{
+			kind: "exact",
+			path: ROUTES.content,
+			handler: async (req, res) => {
+				try {
+					const params = new URL(req.url ?? "/", "http://localhost").searchParams;
+					const name = params.get("name") ?? "";
+					if (name === "") throw new Error("missing name");
+					writeJson(res, 200, await handleContent(deps, name, params.get("path") ?? void 0, currentCwd(deps, req)));
+				} catch (error) {
+					deps.logger.warn(error);
+					writeJson(res, 400, { error: error instanceof Error ? error.message : String(error) });
+				}
+			}
+		},
 		{
 			kind: "exact",
 			path: ROUTES.setEnabled,
@@ -522,9 +678,10 @@ function apply(ctx, config = {}) {
 		activeSessionCwds: () => ctx.sessions.list().map((s) => s.header.cwd).filter((c) => typeof c === "string" && c !== ""),
 		logger: { warn: (error) => {
 			ctx.logger.warn(error);
-		} }
+		} },
+		...config.translationRoot === void 0 ? {} : { translationRoot: config.translationRoot }
 	};
 	for (const route of makeRoutes(deps)) ctx.effect(() => ctx.webServer.register(route), "ui-skill-center: route " + route.path);
 }
 //#endregion
-export { ROUTES, apply, buildSkillContent, findProjectRoot, inject, levelOfSource, localSkillRoots, makeRoutes, name, projectSkillRoot, readDisabledFlag, scanSkillRoot, userSkillRoot, withDisabledFlag };
+export { ROUTES, apply, buildSkillContent, findProjectRoot, inject, levelOfSource, localSkillRoots, makeRoutes, name, projectSkillRoot, readDisabledFlag, scanSkillRoot, stripFrontmatter, userSkillRoot, withDisabledFlag };

package/lib/types/client/api.d.ts

@@ -4,6 +4,24 @@
  *
  * @module @sparkelf/dsh-client-ui-skill-center/client/api
  */
+/** Chinese copy for one skill, when a translation file exists beside it. */
+export interface SkillEntryTranslation {
+    title: string;
+    description: string;
+    summary: string;
+}
+/** One skill's instruction body, as the content route serves it. */
+export interface SkillContent {
+    name: string;
+    content: string;
+}
+/** Translated share of the skill set, as the translation script recorded it. */
+export interface TranslationProgress {
+    total: number;
+    done: number;
+    current: string | null;
+    finishedAt: string | null;
+}
 /** One skill entry as the host serves it. */
 export interface SkillEntry {
     name: string;
@@ -19,12 +37,13 @@ export interface SkillEntry {
     workspaceRoot?: string;
     workspaceName?: string;
     isActiveWorkspace?: boolean;
+    /** Chinese copy rendered in place of the English values; the registry keeps its own. */
+    i18n?: SkillEntryTranslation;
 }
 /** One group as the host serves it. */
 export interface GroupPayload {
     key: string;
     title: string;
-    hint: string;
     skills: SkillEntry[];
 }
 /** One selectable workspace. */
@@ -70,6 +89,20 @@ export declare class SkillApi {
         ok: true;
         moved: string;
     }>;
+    /**
+     * One skill's instruction body, without the YAML frontmatter the card already
+     * shows as metadata.
+     *
+     * The path the list served travels back with the request: a row from another
+     * workspace is read from the file that was listed rather than from whatever the
+     * viewing workspace's registry resolves by name.
+     */
+    content(name: string, path?: string, cwd?: string): Promise<SkillContent>;
+    /**
+     * The translated share of the skill set, or undefined when the host has not
+     * been told where the translations live (the route then answers `{}`).
+     */
+    translationProgress(): Promise<TranslationProgress | undefined>;
     private request;
 }
 //# sourceMappingURL=api.d.ts.map

package/lib/types/client/locales.d.ts

@@ -7,18 +7,26 @@
 /** Every string this plugin renders. */
 export interface SkillCenterLocale {
     'panel': string;
-    'panel.intro': string;
     'search.placeholder': string;
-    'search.clear': string;
     'search.noMatches': string;
     'action.refresh': string;
     'action.create': string;
     'action.delete': string;
+    'action.showDetail': string;
+    'action.close': string;
+    'translate.label': string;
+    'detail.whenToUse': string;
+    'detail.source': string;
+    'detail.provider': string;
+    'detail.path': string;
+    'detail.content': string;
     'action.cancel': string;
     'action.confirm': string;
     'state.loading': string;
     'state.empty': string;
     'state.failed': string;
+    'content.loading': string;
+    'content.failed': string;
     'skill.enabled': string;
     'skill.disabled': string;
     'skill.modelInvocable': string;

package/lib/types/client/slot-contract.d.ts

@@ -1,10 +1,12 @@
 /**
- * Owner props a contributed section receives. The slot passes none today; the type exists so a
- * consumer can name the slot's owner share without importing the page.
+ * Owner props a contributed section receives.
+ *
+ * Declared here rather than inferred at the call site: the page and the section live in
+ * different packages, so the type is the only thing keeping their props in step.
  */
 export interface SkillCenterSectionOwnerProps {
-    /** Reserved for an owner share the panel may add; currently empty. */
-    readonly reserved?: never;
+    /** The page's current search text, unfiltered and untrimmed. */
+    readonly query: string;
 }
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface SlotMap {
@@ -12,6 +14,7 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
         'skill-center.section': {
             kind: 'list';
             scope: 'root';
+            owner: SkillCenterSectionOwnerProps;
         };
     }
 }

package/lib/types/index.d.ts

@@ -11,7 +11,9 @@ export declare const ROUTES: {
     readonly setEnabled: "/api/dsh-skill-center/set-enabled";
     readonly create: "/api/dsh-skill-center/create";
     readonly delete: "/api/dsh-skill-center/delete";
+    readonly content: "/api/dsh-skill-center/content";
     readonly health: "/api/dsh-skill-center/health";
+    readonly translationProgress: "/api/dsh-skill-center/translation-progress";
 };
 /** Plugin configuration. */
 export interface Config {
@@ -21,6 +23,20 @@ export interface Config {
     dshHome?: string;
     /** User agents config root; defaults to `$DSH_AGENTS_HOME` or `~/.agents`. */
     agentsHome?: string;
+    /**
+     * Skill set whose `<skill>/i18n/zh.json` files supply the panel's Chinese copy.
+     *
+     * A skill that resolves through a symlink into another repository keeps its
+     * translation in that repository, not in the deployment, so this names the
+     * checkout that holds the translated set. Unset means English only.
+     */
+    translationRoot?: string;
+}
+/** Chinese copy for one skill, rendered in place of the English values. */
+export interface SkillEntryTranslation {
+    title: string;
+    description: string;
+    summary: string;
 }
 /** A skill row as the panel receives it. */
 export interface SkillEntry {
@@ -37,12 +53,18 @@ export interface SkillEntry {
     workspaceRoot?: string;
     workspaceName?: string;
     isActiveWorkspace?: boolean;
+    /**
+     * Chinese copy, when a translation file exists beside the skill.
+     *
+     * Kept apart from `description` rather than replacing it: the registry value is
+     * what the model routes on, and the panel must stay able to show it.
+     */
+    i18n?: SkillEntryTranslation;
 }
 /** One rendered group. */
 export interface GroupPayload {
     key: string;
     title: string;
-    hint: string;
     skills: SkillEntry[];
 }
 /** One selectable workspace. */
@@ -148,6 +170,13 @@ export declare function localSkillRoots(deps: Pick<SkillRoutesDeps, 'dshHome' |
         active: boolean;
     };
 }[];
+/**
+ * Strip the leading YAML frontmatter from a skill file.
+ *
+ * @param source - the skill file's complete content.
+ * @returns the body below the closing delimiter, or the whole file when it declares none.
+ */
+export declare function stripFrontmatter(source: string): string;
 /**
  * Read `disable-model-invocation` from a skill file.
  * @param source - the skill file's content.
@@ -197,6 +226,8 @@ export interface SkillRoutesDeps {
     logger: {
         warn(error: unknown): void;
     };
+    /** Skill set holding the `<skill>/i18n/zh.json` files; unset disables translation. */
+    translationRoot?: string;
 }
 /** The registry summary this route family reads, re-exported for its callers. */
 export type { SkillSummary };

package/lib/types/translations.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Chinese metadata for the skill center, read from each skill's own directory.
+ *
+ * The panel renders what the official registry routes on, so the registry's English
+ * description is what decides whether the model invokes a skill. Replacing it would
+ * change that decision, so a translation is carried alongside and applied only at
+ * render time: the card shows Chinese, the model keeps reading English.
+ *
+ * A skill keeps its translation in its own directory (`<skill>/i18n/zh.json`), which
+ * lets a skill and its Chinese travel together and ship from one clone. The skill
+ * file itself is located through the registry, so the translation is found even when
+ * the skill resolves through a symlink into another repository.
+ *
+ * @module @sparkelf/dsh-client-ui-skill-center/translations
+ */
+/** One skill's translated metadata. */
+export interface SkillTranslation {
+    /** Short Chinese title shown in place of the kebab-case identifier. */
+    title: string;
+    /** Chinese rendering of the registry description. */
+    description: string;
+    /** Chinese summary of the skill body. */
+    summary: string;
+}
+/** Translation progress, written by the translation script. */
+export interface TranslationProgress {
+    total: number;
+    done: number;
+    current: string | null;
+    finishedAt: string | null;
+}
+/**
+ * Read one skill's translation from beside its resolved skill file.
+ *
+ * A skill without a translation, or with an unreadable or malformed one, is returned
+ * as undefined: the panel then shows the registry values, so a partial translation
+ * set degrades to English rather than to a broken card.
+ *
+ * @param skillFilePath - absolute path of the skill's SKILL.md, when the registry reports one.
+ * @returns the translation, or undefined when none is usable.
+ */
+export declare function readSkillTranslation(skillFilePath: string | undefined): Promise<SkillTranslation | undefined>;
+/**
+ * Read translation progress for the panel's progress bar.
+ *
+ * @param translationRoot - repository holding the skill set, whose `i18n/.progress.json` the script writes.
+ * @returns the progress, or undefined when no translation run has recorded one.
+ */
+export declare function readTranslationProgress(translationRoot: string): Promise<TranslationProgress | undefined>;
+//# sourceMappingURL=translations.d.ts.map

package/package.json

@@ -1,20 +1,28 @@
 {
+  "name": "@sparkelf/dsh-client-ui-skill-center",
+  "version": "0.2.1-alpha.30",
   "description": "Skill center for the dsh web client: browses loaded skills grouped by source, enables or disables model invocation, creates skills, and deletes them into a recoverable trash",
-  "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-layout": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-skill": "^0.1.6-alpha.1",
-    "@types/react": "~18.3.1",
-    "@types/react-dom": "~18.3.0",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0"
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/plus/ui-skill-center"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
   },
   "dsh": {
     "client": {
@@ -25,16 +33,9 @@
       "platform": "web"
     }
   },
-  "exports": {
-    ".": {
-      "default": "./lib/index.js",
-      "types": "./lib/types/index.d.ts"
-    },
-    "./client": {
-      "default": "./lib/client.js",
-      "types": "./lib/types/client/index.d.ts"
-    },
-    "./package.json": "./package.json"
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
   },
   "files": [
     "lib/index.js",
@@ -42,24 +43,23 @@
     "lib/types/**/*.d.ts"
   ],
   "license": "MIT",
-  "main": "lib/index.js",
-  "name": "@sparkelf/dsh-client-ui-skill-center",
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.1"
   },
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "directory": "packages/plus/ui-skill-center",
-    "type": "git",
-    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git"
-  },
-  "scripts": {
-    "bundle": "tsdown",
-    "watch": "tsdown --watch"
-  },
-  "type": "module",
-  "types": "lib/types/index.d.ts",
-  "version": "0.2.1-alpha.29"
+  "devDependencies": {
+    "@deepseek-ai/cordis": "workspace:^",
+    "@deepseek-ai/dsh-client-locale": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-layout": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-primitives": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-renderer": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-sidebar": "workspace:^",
+    "@deepseek-ai/dsh-client-ui-slots": "workspace:^",
+    "@deepseek-ai/dsh-host-webserver": "workspace:^",
+    "@deepseek-ai/dsh-session": "workspace:^",
+    "@deepseek-ai/dsh-skill": "workspace:^",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  }
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 DeepSeek
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.