dsh-skill-editor 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 bosinHU
+
+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.

package/README.md

@@ -0,0 +1,80 @@
+# dsh-skill-editor
+
+<p align="center">
+  <img alt="license" src="https://img.shields.io/badge/license-MIT-green.svg">
+  <img alt="dsh" src="https://img.shields.io/badge/dsh-plugin-web-blue.svg">
+  <img alt="node" src="https://img.shields.io/badge/node-%3E%3D18-339933.svg">
+  <img alt="platform" src="https://img.shields.io/badge/platform-web-brightgreen.svg">
+</p>
+
+在 dsh Web 设置页直接编辑 skill 的 `SKILL.md`（简介 + 正文），保存即写回磁盘、无需重启。一个独立、轻量、纯 `node:fs` 实现的 dsh 插件。
+本项目所有代码由dsh完成，本人完全不会编程
+## ✨ 特性
+
+- **设置页即编即改**：`设置 → 技能编辑器`，列出所有技能，点开即可编辑。
+- **安全分级（防手滑）**：
+  - **本地技能**（`~/.dsh/skills`、`~/.agents/skills`、工作区 `.dsh/skills`）：可编辑保存。
+  - **系统/内置技能**（bundled / 插件内嵌）：只读，显示风险提示。
+- **保存即写盘**：写回 `SKILL.md`，技能热加载，刷新即生效。
+- **只动正文 + name/description**：不碰其它 frontmatter 字段，原样保留。
+- **零第三方依赖的读写逻辑**：用 `node:fs` 直接操作明文文件，不依赖任何 skill 插件内部实现，升级不失效。
+- **可独立回滚**：删除本插件即可完全移除，不影响其它功能。
+
+## 📦 安装
+
+```bash
+# 直接从 GitHub 仓库安装
+dsh plugin --profile web add https://github.com/bosinHU/dsh-skill-editor
+```
+
+> 本插件在 `dsh.client.platform: web` 下自动注入，无需手动改 `cordis.patch.yml`。
+
+安装后重启 web 服务（`dsh --profile web`），刷新页面，设置页即出现「技能编辑器」。
+
+## 🚀 使用
+
+1. 进入 dsh Web 设置 →「技能编辑器」。
+2. 展开某个技能，编辑 `description` 或正文（`SKILL.md` 中 `---` 分隔线之后的部分）。
+3. 点击「保存」，内容立即写回磁盘。
+
+## 🖼️ 界面预览
+
+> 图为 dsh Web 设置页「技能编辑器」的真实界面：左侧为设置导航，右侧列出全部技能（`全局`/`内置`），展开后可编辑 `name`、`description` 与正文（`SKILL.md`）。
+
+![技能编辑器真实界面](./interface-preview.png)
+
+## 🗂️ 项目结构
+
+```
+dsh-skill-editor/
+├── package.json        # 包声明（dsh.client / dsh.bundle.patch）
+├── cordis.patch.yml    # bundle patch（注册 host 插件）
+├── lib/
+│   ├── index.js        # host：skillEditor 远程服务（list/content/saveContent）
+│   └── client.js       # client：设置页「技能编辑器」UI
+├── README.md
+└── LICENSE
+```
+
+## 🧠 技术细节（typert 协议）
+
+- host 端 `lib/index.js` 的 `MANIFEST` 中，每个参数都带 `codec` 字段（新版 typert 强制要求）：
+  - 标量参数（`name` / `sessionId`）用 `codec: { mode: "src-json" }`；
+  - 对象参数（`payload`）用 `codec: { mode: "strict", typeSymbol: "...", schema }`。
+- `apply(ctx)` 里显式调用 `ctx.typert.register(MANIFEST)`，否则前端 `remote.skillEditor` 连不上后端。
+
+## ❓ 常见问题
+
+**Q: 保存后要重启 dsh 吗？**
+不需要，技能是热加载的，刷新页面即可生效。
+
+**Q: 系统/内置技能为什么不能改？**
+防止误改内置技能导致 dsh 异常。如需修改，请在本地 `~/.dsh/skills` 下新建同名技能，或改用本地副本。
+
+## 📄 License
+
+[MIT](./LICENSE) © 2025 [bosinHU](https://github.com/bosinHU)
+
+---
+
+所有代码内容由 dsh 自主完成。

package/cordis.patch.yml

@@ -0,0 +1,12 @@
+# dsh-skill-editor bundle patch.
+#
+# Referenced by package.json `dsh.bundle.patch`. When the package is installed
+# with `dsh plugin --profile web add <package>`, the CLI recognizes the
+# `dsh.bundle` declaration, runs pnpm, and appends this package to the web
+# profile layer stack; the row below then loads the host half (lib/index.js)
+# as an ordinary Cordis plugin. The browser half rides the `dsh.client` scan
+# (lib/client.js) via the web client loader.
+
+- insert:
+    - id: dsh-skill-editor
+      name: 'dsh-skill-editor'

package/lib/client.js

@@ -0,0 +1,199 @@
+// dsh-skill-editor — client 半区（动态 bundle）。
+// 在 dsh Web 设置页注册一个独立的「技能编辑器」栏目：列出技能，点击后在
+// 文本域里编辑 SKILL.md 的正文与 name/description，保存后写回磁盘。
+// 本地技能无提示；系统/内置技能（bundled）只读并显示风险提示。
+
+window.__ModuleLoader__.load({
+  id: "dsh-skill-editor",
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+    Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+    const react = require("react");
+    const react_jsx_runtime = require("react/jsx-runtime");
+
+    // ── 样式 ───────────────────────────────────────────────────────────
+    const css = ".SKE_section{position:relative;width:100%;max-width:760px;color:var(--dsw-alias-label-primary);flex-direction:column;gap:14px;display:flex}.SKE_card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:10px;min-width:0;overflow:hidden}.SKE_cardHeader{width:100%;align-items:center;gap:8px;font:inherit;color:var(--dsw-alias-label-primary);cursor:pointer;background:0 0;border:none;padding:10px 12px;display:flex;text-align:left}.SKE_cardTitle{min-width:0;flex:1;text-overflow:ellipsis;white-space:nowrap;overflow:hidden;font-size:13px;font-weight:500;line-height:20px}.SKE_tag{background:var(--dsw-alias-bg-layer-1);min-height:20px;color:var(--dsw-alias-label-secondary);border-radius:5px;padding:1px 6px;font-size:11px;line-height:16px;display:inline-flex;flex:none}.SKE_tag[data-bundled=true]{color:var(--dsw-alias-state-warning-primary)}.SKE_cardBody{border-top:1px solid var(--dsw-alias-border-l2);flex-direction:column;gap:10px;padding:10px 12px;display:flex}.SKE_field{display:flex;flex-direction:column;gap:5px}.SKE_label{font-size:12px;color:var(--dsw-alias-label-secondary);margin:0}.SKE_input{box-sizing:border-box;width:100%;height:32px;font:inherit;font-size:13px;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;outline:none;padding:0 10px}.SKE_textarea{box-sizing:border-box;width:100%;min-height:240px;font:inherit;font-size:12px;line-height:18px;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:10px;resize:vertical;font-family:ui-monospace,SFMono-Regular,Consolas,Menlo,monospace;white-space:pre-wrap}.SKE_actions{display:flex;align-items:center;gap:8px}.SKE_btn{font:inherit;cursor:pointer;border-radius:6px;padding:5px 14px;font-size:13px;line-height:20px}.SKE_primary{background:var(--dsw-alias-state-business-primary);border:1px solid transparent;color:var(--dsw-alias-state-business-on-primary,#fff)}.SKE_primary:disabled{opacity:.6;cursor:default}.SKE_ghost{background:0 0;border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary)}.SKE_msg{font-size:12px;line-height:18px;margin:0}.SKE_msg[data-kind=ok]{color:var(--dsw-alias-state-success-primary)}.SKE_msg[data-kind=err]{color:var(--dsw-alias-state-error-primary)}.SKE_warn{border:1px solid color-mix(in srgb,var(--dsw-alias-state-warning-primary) 40%,transparent);background:color-mix(in srgb,var(--dsw-alias-state-warning-primary) 10%,transparent);border-radius:8px;padding:8px 12px;color:var(--dsw-alias-state-warning-primary);font-size:12px;line-height:18px}.SKE_empty{color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:20px;margin:0}";
+    const tagId = "dsh-skill-editor/Editor.module.css";
+    if (typeof document !== "undefined") {
+      let tag = document.querySelector('style[data-plugin-css=' + JSON.stringify(tagId) + ']');
+      if (!tag) { tag = document.createElement("style"); tag.setAttribute("data-plugin-css", tagId); tag.textContent = css; document.head.appendChild(tag); }
+    }
+    const c = { section: "SKE_section", card: "SKE_card", cardHeader: "SKE_cardHeader", cardTitle: "SKE_cardTitle", tag: "SKE_tag", cardBody: "SKE_cardBody", field: "SKE_field", label: "SKE_label", input: "SKE_input", textarea: "SKE_textarea", actions: "SKE_actions", primary: "SKE_primary", ghost: "SKE_ghost", msg: "SKE_msg", warn: "SKE_warn", empty: "SKE_empty" };
+
+    const NS = "settings.skill-editor";
+    const zh = {
+      nav: "技能编辑器",
+      loading: "正在读取技能…",
+      error: "暂时无法读取技能。",
+      retry: "重试",
+      empty: "暂无技能。",
+      descLabel: "description",
+      bodyLabel: "正文（SKILL.md 正文部分）",
+      save: "保存",
+      saving: "保存中…",
+      cancel: "取消",
+      saved: "已保存 ✓",
+      bundledWarn: "这是一个系统/内置技能（不可编辑）。如需修改，请在本地 ~/.dsh/skills 下新建同名技能，或改用本地副本。",
+      loadFailed: "技能内容加载失败。",
+      opFailed: "操作失败：",
+      reopen: "重新载入",
+      nameLabel: "name",
+    };
+    const en = {
+      nav: "Skill Editor",
+      loading: "Reading skills…",
+      error: "Skills are temporarily unavailable.",
+      retry: "Retry",
+      empty: "No skills.",
+      descLabel: "description",
+      bodyLabel: "Body (SKILL.md content)",
+      save: "Save",
+      saving: "Saving…",
+      cancel: "Cancel",
+      saved: "Saved ✓",
+      bundledWarn: "This is a bundled / built-in skill (read-only). To edit it, create a same-named local skill under ~/.dsh/skills instead.",
+      loadFailed: "Failed to load skill content.",
+      opFailed: "Operation failed: ",
+      reopen: "Reload",
+      nameLabel: "name",
+    };
+
+    const identity = (value) => value;
+    const codec = (symbol) => ({ mode: "strict", typeSymbol: symbol, schema: { parse: identity } });
+    const CONTRIBUTION = {
+      package: "dsh-skill-editor",
+      descriptors: [
+        { id: "dsh-skill-editor#skillEditor/list", service: "skillEditor", namespace: "skillEditor", method: "list", invocation: { kind: "direct" }, parameters: [{ name: "sessionId", wire: "sessionId", source: "json", acceptsUndefined: true, codec: codec("dsh-skill-editor#sessionId") }], result: codec("dsh-skill-editor#ListResult") },
+        { id: "dsh-skill-editor#skillEditor/content", service: "skillEditor", namespace: "skillEditor", method: "content", invocation: { kind: "direct" }, parameters: [{ name: "name", wire: "name", source: "json", codec: codec("dsh-skill-editor#SkillName") }, { name: "sessionId", wire: "sessionId", source: "json", acceptsUndefined: true, codec: codec("dsh-skill-editor#sessionId") }], result: codec("dsh-skill-editor#SkillContent") },
+        { id: "dsh-skill-editor#skillEditor/saveContent", service: "skillEditor", namespace: "skillEditor", method: "saveContent", invocation: { kind: "direct" }, parameters: [{ name: "name", wire: "name", source: "json", codec: codec("dsh-skill-editor#SkillName") }, { name: "payload", wire: "payload", source: "json", codec: codec("dsh-skill-editor#SavePayload") }, { name: "sessionId", wire: "sessionId", source: "json", acceptsUndefined: true, codec: codec("dsh-skill-editor#sessionId") }], result: codec("dsh-skill-editor#SaveResult") },
+      ],
+    };
+
+    function EditorCard({ skill, t, callRemote }) {
+      const [open, setOpen] = react.useState(false);
+      const [state, setState] = react.useState({ status: "idle" });
+      const [desc, setDesc] = react.useState("");
+      const [body, setBody] = react.useState("");
+      const [busy, setBusy] = react.useState(false);
+      const [msg, setMsg] = react.useState(null);
+
+      const load = react.useCallback(() => {
+        setState({ status: "loading" });
+        Promise.resolve()
+          .then(() => callRemote("content", skill.name))
+          .then((res) => {
+            if (res === null || res === undefined) { setState({ status: "missing" }); return; }
+            setDesc(res.description || "");
+            setBody(res.body || "");
+            setState({ status: "ready", res });
+          })
+          .catch((e) => setState({ status: "err", error: String(e && e.message || e) }));
+      }, [skill.name, callRemote]);
+
+      const onToggle = () => {
+        const next = !open;
+        setOpen(next);
+        if (next && state.status === "idle") load();
+      };
+
+      const onSave = () => {
+        setBusy(true);
+        setMsg(null);
+        Promise.resolve()
+          .then(() => callRemote("saveContent", skill.name, { name: skill.name, description: desc, body }))
+          .then(() => setMsg({ kind: "ok", text: t("saved") }))
+          .catch((e) => setMsg({ kind: "err", text: t("opFailed") + (e && e.message || e) }))
+          .finally(() => setBusy(false));
+      };
+
+      const bundled = skill.bundled === true;
+      return react_jsx_runtime.jsxs("li", { className: c.card, children: [
+        react_jsx_runtime.jsx("button", { type: "button", className: c.cardHeader, onClick: onToggle, children: [
+          react_jsx_runtime.jsx("span", { className: c.cardTitle, children: skill.name }),
+          react_jsx_runtime.jsx("span", { className: c.tag, "data-bundled": bundled, children: bundled ? "内置" : (skill.scope && skill.scope.kind === "workspace" ? "工作区" : "全局") }),
+        ]}),
+        open ? react_jsx_runtime.jsxs("div", { className: c.cardBody, children: [
+          bundled ? react_jsx_runtime.jsx("div", { className: c.warn, children: t("bundledWarn") }) : null,
+          state.status === "loading" ? react_jsx_runtime.jsx("p", { className: c.msg, children: t("loading") })
+          : state.status === "missing" ? react_jsx_runtime.jsx("p", { className: c.msg, children: t("loadFailed") })
+          : state.status === "err" ? react_jsx_runtime.jsxs("div", { className: c.actions, children: [
+              react_jsx_runtime.jsx("p", { className: c.msg, children: t("error") }), react_jsx_runtime.jsx("button", { type: "button", className: c.ghost, onClick: load, children: t("reopen") }),
+            ]})
+          : react_jsx_runtime.jsxs(react.Fragment, { children: [
+              react_jsx_runtime.jsxs("div", { className: c.field, children: [
+                react_jsx_runtime.jsx("label", { className: c.label, children: t("nameLabel") }),
+                react_jsx_runtime.jsx("input", { className: c.input, value: skill.name, readOnly: true, disabled: true }),
+              ]}),
+              react_jsx_runtime.jsxs("div", { className: c.field, children: [
+                react_jsx_runtime.jsx("label", { className: c.label, children: t("descLabel") }),
+                react_jsx_runtime.jsx("textarea", { className: c.textarea, style: { minHeight: "60px" }, value: desc, onChange: (e) => setDesc(e.target.value), disabled: bundled }),
+              ]}),
+              react_jsx_runtime.jsxs("div", { className: c.field, children: [
+                react_jsx_runtime.jsx("label", { className: c.label, children: t("bodyLabel") }),
+                react_jsx_runtime.jsx("textarea", { className: c.textarea, value: body, onChange: (e) => setBody(e.target.value), disabled: bundled }),
+              ]}),
+              react_jsx_runtime.jsxs("div", { className: c.actions, children: [
+                react_jsx_runtime.jsx("button", { type: "button", className: c.primary, disabled: bundled || busy, onClick: onSave, children: busy ? t("saving") : t("save") }),
+                react_jsx_runtime.jsx("button", { type: "button", className: c.ghost, disabled: busy, onClick: () => setOpen(false), children: t("cancel") }),
+              ]}),
+              msg ? react_jsx_runtime.jsx("p", { className: c.msg, "data-kind": msg.kind, children: msg.text }) : null,
+            ]}),
+        ]}) : null,
+      ]});
+    }
+
+    const inject = ["slots", "locale", "remote", "sessions"];
+
+    function apply(ctx) {
+      ctx.effect(() => ctx.locale.register(NS, { zh, en }), "ui-skill-editor: dictionaries");
+      const t = ctx.locale.bind(NS);
+      const mount = ctx.remote.$mount(CONTRIBUTION);
+      const currentSessionId = () => { try { return ctx.get("sessions").currentProvideInfo.getSnapshot().sessionId; } catch { return undefined; } };
+      const callRemote = async (method, ...args) => {
+        await mount;
+        const remote = ctx.get("remote.skillEditor");
+        const result = await remote[method](...args);
+        if (!result.ok) throw new Error("skillEditor." + method + " failed: " + (result.error && (result.error.code || result.error.message)));
+        return result.value;
+      };
+
+      const EditorSection = (props) => {
+        const [query, setQuery] = react.useState("");
+        const [listState, setListState] = react.useState({ status: "loading" });
+        const [request, setRequest] = react.useState(0);
+        react.useEffect(() => {
+          // 不依赖注入的 listSkills；直接内部调用，最稳妥。
+          setListState({ status: "loading" });
+          Promise.resolve().then(() => callRemote("list", currentSessionId())).then((snapshot) => setListState({ status: "ready", skills: snapshot.skills || [] })).catch((e) => setListState({ status: "err", error: String(e && e.message || e) }));
+        }, [request]);
+        const q = (query || "").trim().toLowerCase();
+        const skills = (listState.status === "ready" ? listState.skills : []).filter((s) => !q || s.name.toLowerCase().includes(q));
+        return react_jsx_runtime.jsxs("div", { className: c.section, children: [
+          react_jsx_runtime.jsxs("div", { className: c.actions, children: [
+            react_jsx_runtime.jsx("input", { className: c.input, placeholder: t("nav"), value: query, onChange: (e) => setQuery(e.target.value), style: { maxWidth: "280px" } }),
+            listState.status === "err" ? react_jsx_runtime.jsx("button", { type: "button", className: c.ghost, onClick: () => setRequest((n) => n + 1), children: t("retry") }) : null,
+          ]}),
+          listState.status === "loading" ? react_jsx_runtime.jsx("p", { className: c.msg, children: t("loading") })
+          : listState.status === "err" ? react_jsx_runtime.jsx("p", { className: c.msg, children: t("error") })
+          : skills.length === 0 ? react_jsx_runtime.jsx("p", { className: c.empty, children: t("empty") })
+          : react_jsx_runtime.jsx("ul", { style: { listStyle: "none", margin: 0, padding: 0, display: "grid", gridTemplateColumns: "repeat(2,minmax(0,1fr))", gap: "10px" }, children: skills.map((s) => react_jsx_runtime.jsx(EditorCard, { skill: s, t, callRemote }, s.name + (s.scope && s.scope.kind === "workspace" ? "@ws" : ""))) }),
+        ]});
+      };
+
+      ctx.slots.inject("settings.section", () => ctx.slots.register({
+        name: "settings.section",
+        id: "skill-editor",
+        order: 16.8,
+        label: () => t("nav"),
+        locale: NS,
+        inject: () => ({}),
+      }, (props) => react_jsx_runtime.jsx(EditorSection, { ...props, t })));
+    }
+
+    exports.NS = NS;
+    exports.apply = apply;
+    exports.inject = inject;
+    return exports;
+  },
+});

package/lib/index.js

@@ -0,0 +1,341 @@
+// dsh-skill-editor — host 半区（完全独立，不依赖任何第三方技能插件）。
+//
+// 一个 Typert 远程服务（"skillEditor"），对外暴露：
+//   - list()            列出所有可编辑技能（区分 local / bundled / workspace）
+//   - content()         读取某个技能的 SKILL.md（返回 frontmatter 与正文分离）
+//   - saveContent()     写回某个技能的 frontmatter 和/或正文（本地技能；bundled 只读）
+//
+// 技能即明文文件：<root>/<name>/SKILL.md 或 <root>/<name>.md。
+// 本插件完全用 node:fs 读写，不走第三方包的内部逻辑，重启后热刷新。
+//
+// 安全分级（与用户约定）：
+//   - 本地技能（~/.dsh/skills、~/.agents/skills、工作区 .dsh/skills）：可改，无提示。
+//   - 系统自带技能（bundled / 插件内嵌，无对应可写文件）：只读，前端会显示风险提示。
+
+import { mkdir, readFile, writeFile, readdir, stat } from "node:fs/promises";
+import { basename, dirname, join, resolve as resolvePath } from "node:path";
+import { homedir } from "node:os";
+import { z } from "zod";
+
+export const name = "dsh-skill-editor";
+export const inject = ["typert", "skills", "sessions"];
+
+// ── root 解析 ───────────────────────────────────────────────────────────
+function dshHome() {
+    return process.env.DSH_HOME || join(homedir(), ".dsh");
+}
+function agentsHome() {
+    return process.env.DSH_AGENTS_HOME || join(homedir(), ".agents");
+}
+/** 返回 [root, source] 列表；source ∈ {"user-dsh","user-agents"}。项目根动态扫描由 list() 补充。 */
+function userRoots() {
+    return [
+        { path: join(dshHome(), "skills"), source: "user-dsh" },
+        { path: join(agentsHome(), "skills"), source: "user-agents" },
+    ];
+}
+
+// ── frontmatter 解析（轻量版，足够分离 name/description/正文）────────
+// 只解析 "---" 之间的行，读取 name 与 description，正文是其后内容。
+function parseFrontmatter(raw) {
+    const lines = raw.split("\n");
+    if (lines[0]?.trim() !== "---") return undefined;
+    let end = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === "---") { end = i; break; }
+    }
+    if (end === -1) return undefined;
+    const meta = {};
+    for (let i = 1; i < end; i++) {
+        const m = lines[i].match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+        if (m) meta[m[1]] = m[2].trim();
+    }
+    const body = lines.slice(end + 1).join("\n").trim();
+    return { name: meta.name, description: meta.description ?? "", body, meta };
+}
+
+/** 把 frontmatter 重新拼回（保留其它字段）。body 语义内容应已 trim。 */
+function rebuildFrontmatter(meta, body) {
+    const lines = ["---"];
+    for (const [k, v] of Object.entries(meta)) {
+        lines.push(k + ": " + v);
+    }
+    lines.push("---", "");
+    if (body) lines.push(body.trim());
+    return lines.join("\n") + "\n";
+}
+
+// ── 目录扫描：找出所有 .md 技能文件 ──────────────────────────────────
+async function scanDir(dir, projectRoot, source, depth, maxDepth, out) {
+    let items;
+    try {
+        items = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return; // 目录不存在
+    }
+    for (const item of items) {
+        if (item.name.startsWith(".") || item.name === "node_modules") continue;
+        const full = join(dir, item.name);
+        if (item.isDirectory()) {
+            if (item.name.endsWith(".disabled")) continue;
+            // 目录束技能：内含 SKILL.md
+            const skillFile = join(full, "SKILL.md");
+            try {
+                const info = await stat(skillFile);
+                if (info.isFile()) {
+                    const raw = await readFile(skillFile, "utf8");
+                    const parsed = parseFrontmatter(raw);
+                    out.push({
+                        name: parsed?.name || item.name,
+                        description: parsed?.description || "",
+                        path: skillFile,
+                        kind: "dir",
+                        projectRoot,
+                        source,
+                        bundled: false,
+                        raw,
+                    });
+                    // 目录束不下钻
+                    continue;
+                }
+            }
+            catch { /* 非技能目录 */ }
+            if (depth < maxDepth) await scanDir(full, projectRoot, source, depth + 1, maxDepth, out);
+        }
+        else if (item.isFile() && item.name.endsWith(".md")) {
+            const raw = await readFile(full, "utf8");
+            const parsed = parseFrontmatter(raw);
+            out.push({
+                name: parsed?.name || item.name.slice(0, -3),
+                description: parsed?.description || "",
+                path: full,
+                kind: "flat",
+                projectRoot,
+                source,
+                bundled: false,
+                raw,
+            });
+        }
+        // 其它文件忽略
+    }
+}
+
+/** 列出所有本地可写技能。 */
+async function collectFiles() {
+    const out = [];
+    for (const root of userRoots()) {
+        await scanDir(root.path, undefined, root.source, 0, 8, out);
+    }
+    return out;
+}
+
+// ── schema ──────────────────────────────────────────────────────────────
+const scopeSchema = z.object({
+    kind: z.enum(["global", "workspace"]),
+    path: z.string().optional(),
+    label: z.string().optional(),
+});
+const skillSummarySchema = z.object({
+    name: z.string(),
+    description: z.string(),
+    provider: z.string(),
+    source: z.string(),
+    bundled: z.boolean(),
+    scope: scopeSchema.optional(),
+    path: z.string().optional(),
+});
+const listResultSchema = z.object({ skills: z.array(skillSummarySchema) });
+const skillContentSchema = z
+    .object({
+        name: z.string(),
+        description: z.string(),
+        body: z.string(),
+        content: z.string(),
+        provider: z.string(),
+        bundled: z.boolean(),
+        path: z.string().optional(),
+    })
+    .nullable();
+const savePayloadSchema = z.object({
+    name: z.string(),
+    description: z.string().optional(),
+    body: z.string().optional(),
+    content: z.string().optional(),
+});
+const saveResultSchema = z.object({ name: z.string(), ok: z.boolean() });
+
+/** 注册到 API 网关的类型化 wire 描述符。 */
+const MANIFEST = {
+    package: "dsh-skill-editor",
+    face: "host",
+    schemas: [],
+    invocations: [
+        {
+            id: "dsh-skill-editor#skillEditor/list",
+            service: "skillEditor",
+            namespace: "skillEditor",
+            method: "list",
+            invocation: { kind: "direct" },
+            parameters: [{ name: "sessionId", wire: "sessionId", source: "json", acceptsUndefined: true, codec: { mode: "src-json" } }],
+            result: { mode: "strict", typeSymbol: "dsh-skill-editor#ListResult", schema: listResultSchema },
+        },
+        {
+            id: "dsh-skill-editor#skillEditor/content",
+            service: "skillEditor",
+            namespace: "skillEditor",
+            method: "content",
+            invocation: { kind: "direct" },
+            parameters: [
+                { name: "name", wire: "name", source: "json", codec: { mode: "src-json" } },
+                { name: "sessionId", wire: "sessionId", source: "json", acceptsUndefined: true, codec: { mode: "src-json" } },
+            ],
+            result: { mode: "strict", typeSymbol: "dsh-skill-editor#SkillContent", schema: skillContentSchema },
+        },
+        {
+            id: "dsh-skill-editor#skillEditor/saveContent",
+            service: "skillEditor",
+            namespace: "skillEditor",
+            method: "saveContent",
+            invocation: { kind: "direct" },
+            parameters: [
+                { name: "name", wire: "name", source: "json", codec: { mode: "src-json" } },
+                { name: "payload", wire: "payload", source: "json", codec: { mode: "strict", typeSymbol: "dsh-skill-editor#SavePayload", schema: savePayloadSchema } },
+                { name: "sessionId", wire: "sessionId", source: "json", acceptsUndefined: true, codec: { mode: "src-json" } },
+            ],
+            result: { mode: "strict", typeSymbol: "dsh-skill-editor#SaveResult", schema: saveResultSchema },
+        },
+    ],
+};
+
+// ── 远程服务实例 ────────────────────────────────────────────────────────
+import { TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
+
+class SkillEditorService extends TypertRemoteService {
+    constructor(ctx) {
+        super(ctx, "skillEditor");
+        // 列表缓存（简单起见每次实时扫）
+    }
+    /** 对动态 harness 上下文（sessions/agents/typert）的无类型访问桥。 */
+    get C() {
+        return this.ctx;
+    }
+
+    async list(_sessionId) {
+        try {
+            const files = await collectFiles.call(this);
+            const skills = files.map((f) => ({
+                name: f.name,
+                description: f.description,
+                provider: "filesystem",
+                source: f.source,
+                bundled: f.bundled,
+                path: f.path,
+                ...(f.projectRoot === undefined
+                    ? {}
+                    : { scope: { kind: "workspace", path: f.projectRoot } }),
+            }));
+            // 把注册表里可见的 bundled/plugin 技能也列出来（只读标识）。
+            const registry = this.C.get("skills");
+            if (registry !== undefined && typeof registry.list === "function") {
+                try {
+                    const live = await registry.list({ cwd: undefined });
+                    for (const s of live) {
+                        if (skills.some((e) => e.name === s.name)) continue;
+                        skills.push({
+                            name: s.name,
+                            description: s.description ?? "",
+                            provider: s.provider ?? "bundled",
+                            source: s.source ?? "bundled",
+                            bundled: !(s.path || s.resourceBase),
+                            path: s.path,
+                        });
+                    }
+                }
+                catch { /* 忽略注册表故障 */ }
+            }
+            console.error("[dsh-skill-editor] list() 返回", skills.length, "个技能:", skills.map((s) => s.name).join(", "));
+            return { skills };
+        }
+        catch (e) {
+            console.error("[dsh-skill-editor] list() 抛出异常:", e && e.message ? e.message : String(e));
+            throw e;
+        }
+    }
+
+    async content(name, _sessionId) {
+        const files = await collectFiles.call(this);
+        const entry = files.find((f) => f.name === name);
+        if (entry !== undefined) {
+            const parsed = parseFrontmatter(entry.raw);
+            return {
+                name: entry.name,
+                description: parsed?.description ?? "",
+                body: parsed?.body ?? "",
+                content: entry.raw,
+                provider: "filesystem",
+                bundled: false,
+                path: entry.path,
+            };
+        }
+        // 注册表里的（bundled / 插件内嵌）技能：展示全文，但 bundled 不可保存。
+        const registry = this.C.get("skills");
+        if (registry !== undefined && typeof registry.get === "function") {
+            try {
+                const skill = await registry.get(name, { cwd: undefined });
+                if (skill !== undefined) {
+                    return {
+                        name: skill.name,
+                        description: skill.description ?? "",
+                        body: skill.content ?? "",
+                        content: skill.content ?? "",
+                        provider: skill.provider ?? "bundled",
+                        bundled: !skill.path,
+                        ...(skill.path === undefined ? {} : { path: skill.path }),
+                    };
+                }
+            }
+            catch { /* 忽略 */ }
+        }
+        return null;
+    }
+
+    async saveContent(name, payload, _sessionId) {
+        const files = await collectFiles.call(this);
+        const entry = files.find((f) => f.name === name);
+        if (entry === undefined || entry.bundled) {
+            throw new Error('技能 "' + name + '" 不可编辑（不存在或为系统/内置技能）');
+        }
+        const parsed = parseFrontmatter(entry.raw) ?? { meta: { name, description: "" }, body: "" };
+        const meta = { ...parsed.meta };
+        // 正文：显式传入的 body/content 优先；否则保留当前正文，绝不因只改简介而清空。
+        const nextBody =
+            payload.body !== undefined && typeof payload.body === "string"
+                ? payload.body
+                : payload.content !== undefined && typeof payload.content === "string"
+                  ? payload.content
+                  : parsed.body;
+        if (typeof payload.description === "string") meta.description = payload.description;
+        await mkdir(dirname(entry.path), { recursive: true });
+        await writeFile(entry.path, rebuildFrontmatter(meta, nextBody), "utf8");
+        return { name, ok: true };
+    }
+}
+
+export function apply(ctx) {
+    try {
+        new SkillEditorService(ctx);
+        console.error("[dsh-skill-editor] SkillEditorService 已实例化, service=skillEditor");
+        // 必须把调用描述符注册进 typert，否则前端 remote.skillEditor 无法建连。
+        ctx.effect(() => {
+            const r = ctx.typert.register(MANIFEST);
+            console.error("[dsh-skill-editor] ctx.typert.register 已调用, 返回:", r === undefined ? "undefined" : typeof r);
+            return r;
+        }, "dsh-skill-editor: typert manifest");
+        console.error("[dsh-skill-editor] apply() 完成, 无异常");
+    }
+    catch (e) {
+        console.error("[dsh-skill-editor] apply() 抛出异常:", e && e.message ? e.message : String(e));
+        throw e;
+    }
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "dsh-skill-editor",
+  "version": "0.1.0",
+  "description": "dsh-skill-editor: edit skill SKILL.md content (body + name/description) right from the DSH web Settings page. Local skills edit freely; bundled / built-in skills are read-only with a warning.",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "plugin",
+    "skill",
+    "skill-editor",
+    "settings"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bosinHU/dsh-skill-editor.git"
+  },
+  "homepage": "https://github.com/bosinHU/dsh-skill-editor",
+  "bugs": {
+    "url": "https://github.com/bosinHU/dsh-skill-editor/issues"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-api-gateway"
+      ]
+    }
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.0-rc.6",
+    "zod": "^4.4.3"
+  }
+}