@liangjiehappy/dsh-ops 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,75 @@
-# Temporary Holding Version
+# @liangjiehappy/dsh-ops — DSH Ops Workbench
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[中文说明](README.zh.md)
+
+A dev/ops workbench for DSH-managed sites. It checks health, SEO, GEO, code
+and security, and does snapshot / deploy / rollback with automatic recovery.
+
+**7 tools + 1 skill.**
+
+## Install
+
+```bash
+dsh plugin --profile web add @liangjiehappy/dsh-ops
+```
+
+Then set your API key (get one at <https://dshio.org/me/>):
+
+```bash
+dsh plugin config dsh-ops --set api_key=<your-key>
+```
+
+Or set the environment variable `DSH_OPS_KEY`.
+
+## Tools
+
+| Tool | What it does | Mutates |
+|---|---|---|
+| `ops_status` | Summary of all sites: score, per-category score, last deploy, open issues | no |
+| `ops_check` | Run 15 checkers on one site, return detailed pass/warn/fail | no |
+| `ops_issues` | Open issues, sorted by severity, with first-seen and count | no |
+| `ops_snapshot` | Incremental snapshot (sha256 diff + hard links) | yes (add only) |
+| `ops_deploy` | Deploy with impact analysis, auto-snapshot, auto-rollback | **yes** |
+| `ops_rollback` | Restore to a snapshot | **yes** |
+| `ops_restart` | Restart a systemd service | **yes** |
+
+## Checkers (15)
+
+| Category | Checkers |
+|---|---|
+| deploy | `deploy_smoke` `deploy_assets` `deploy_sitemap` |
+| seo | `seo_title` `seo_desc` `seo_canonical` `seo_hreflang` `seo_structured` |
+| geo | `geo_ai_crawler` `geo_citable` |
+| code | `code_language_mix` `code_package_clean` `code_secret` |
+| security | `sec_fail2ban` `sec_backup` |
+
+## Skill
+
+`ops-guide` — loaded when the user asks about site status, deployment or
+rollback. It explains which tool to use, what to check before a risky
+operation, and how to read the deploy impact analysis.
+
+## Deploy safety — three layers
+
+The `ops_deploy` tool was built in response to a real incident: an
+`rsync --delete` removed 3 static JS files and broke mobile layout, the
+feedback button and the PWA prompt for 4 days.
+
+1. **Source completeness** — if the build directory is missing expected
+   subdirectories, deploy aborts (source is older than target).
+2. **Impact analysis** — the tool lists every file that would be deleted.
+   Files not in the source *and* not on the delete whitelist abort the deploy.
+3. **Verify + rollback** — a snapshot is taken before deploy; smoke checks run
+   after; any failure triggers automatic rollback.
+
+Always run `ops_deploy` with `dry_run: true` first.
+
+## Data source
+
+API: `https://deepseekbase.com/work/api/`
+
+Third-party project. Not affiliated with DeepSeek.
+
+- Homepage: <https://deepseekbase.com/work/>
+- Standards: <https://dshio.org/>
+- License: MIT

package/README.zh.md

@@ -0,0 +1,74 @@
+# @liangjiehappy/dsh-ops — DSH 運維工作台
+
+[English](README.md)
+
+跑在 DSH 裡的開發運維工作台。檢查站點的健康、SEO、GEO、代碼與安全，
+並提供快照、部署、回滾，失敗自動恢復。
+
+**7 個工具 + 1 個技能。**
+
+## 安裝
+
+```bash
+dsh plugin --profile web add @liangjiehappy/dsh-ops
+```
+
+然後設定 API key（在 <https://dshio.org/me/> 生成）：
+
+```bash
+dsh plugin config dsh-ops --set api_key=<你的 key>
+```
+
+或設定環境變數 `DSH_OPS_KEY`。
+
+## 工具
+
+| 工具 | 做什麼 | 會改系統嗎 |
+|---|---|---|
+| `ops_status` | 所有站點摘要：總分、分類得分、最後部署、未解決問題數 | 否 |
+| `ops_check` | 對單站跑 15 個檢查器，返回詳細通過/警告/失敗 | 否 |
+| `ops_issues` | 未解決問題清單，按嚴重程度排序，含首次發現與出現次數 | 否 |
+| `ops_snapshot` | 增量快照（sha256 對比 + 硬鏈接）| 是（只增不刪）|
+| `ops_deploy` | 部署，含影響分析、自動快照、驗證失敗自動回滾 | **是** |
+| `ops_rollback` | 回滾到指定快照 | **是** |
+| `ops_restart` | 重啟 systemd 服務 | **是** |
+
+## 檢查器（15 個）
+
+| 類別 | 檢查器 |
+|---|---|
+| 部署 | `deploy_smoke` `deploy_assets` `deploy_sitemap` |
+| SEO | `seo_title` `seo_desc` `seo_canonical` `seo_hreflang` `seo_structured` |
+| GEO | `geo_ai_crawler` `geo_citable` |
+| 代碼 | `code_language_mix` `code_package_clean` `code_secret` |
+| 安全 | `sec_fail2ban` `sec_backup` |
+
+每一個都是從真實事故裡長出來的：
+
+- `deploy_assets` ← 一次 `rsync --delete` 刪掉 3 個靜態 JS，手機適配、反饋按鈕、PWA 提示全部失效 4 天
+- `code_language_mix` ← 中文插件裡混進了 6 行荷蘭語
+- `code_package_clean` ← `.bak` 備份文件被發上了 npm
+- `deploy_sitemap` ← sitemap 超過 5 萬 URL 上限
+
+## 技能
+
+`ops-guide` —— 當使用者問站點狀態、要部署、要回滾時載入。
+它說明該用哪個工具、危險操作前該確認什麼、部署影響分析怎麼讀。
+
+## 部署的三層保護
+
+1. **源頭完整性** —— build 目錄缺少預期子目錄時中止（說明上次構建不完整）
+2. **影響分析** —— 列出所有會被刪的文件；既有源頭沒有、又不在刪除白名單的，中止部署
+3. **驗證 + 回滾** —— 部署前自動快照；部署後跑 smoke 檢查；失敗自動回滾
+
+**強烈建議先用 `dry_run: true` 跑一次看影響分析。**
+
+## 數據來源
+
+API：`https://deepseekbase.com/work/api/`
+
+第三方非官方項目，與 DeepSeek 官方無關。
+
+- 首頁：<https://deepseekbase.com/work/>
+- 標準：<https://dshio.org/>
+- 許可：MIT

package/cordis.patch.yml

@@ -0,0 +1,24 @@
+# DSH 運維工作台
+#
+# 本包提供：
+#   工具（7 個）：
+#     ops_status       所有站点状态摘要
+#     ops_check        跑全部检查器
+#     ops_issues       未解决的问题
+#     ops_snapshot     打快照
+#     ops_deploy       部署（含影响分析 + 自动回滚）
+#     ops_rollback     回滚到快照
+#     ops_restart      重启服务
+#
+#   技能（1 個）：
+#     ops-guide        运维工作台使用指南（何时用哪个工具、危险操作注意什么）
+#
+# 依赖：
+#   工作台后端 https://deepseekbase.com/work/api/
+#   认证复用 dshio API key（在 https://dshio.org/me/ 生成）
+#
+# 本包不写本地文件、不执行本地命令；
+# 所有动作通过 HTTPS 调工作台 API 执行。
+- insert:
+    - id: dsh-ops
+      name: "@liangjiehappy/dsh-ops"

package/lib/index.js

@@ -0,0 +1,422 @@
+/**
+ * DSH 運維工作台 —— 主入口
+ *
+ * 按 DSH 官方插件标准编写：
+ *   · ESM，export const name / inject / apply
+ *   · ctx.tools.register(defineTool({...}))
+ *   · ctx.skills.register({...})
+ *
+ * 工具（7 個）：
+ *   ops_status       所有站点状态摘要
+ *   ops_check        跑检查器
+ *   ops_issues       未解决问题
+ *   ops_snapshot     打快照
+ *   ops_deploy       部署（含影响分析）
+ *   ops_rollback     回滚
+ *   ops_restart      重启服务
+ *
+ * 技能（1 個）：
+ *   ops-guide        工作台使用指南
+ *
+ * 数据来自工作台后端 https://deepseekbase.com/work/api/
+ * 认证用 dshio API key（https://dshio.org/me/ 生成）
+ */
+
+import { defineTool } from "@deepseek-ai/dsh-tools";
+import { ALL_SKILLS } from "./skills.js";
+
+const BASE = "https://deepseekbase.com/work/api";
+const TIMEOUT_MS = 60000;   // 部署可能要几十秒
+
+export const name = "dsh-ops";
+export const inject = ["tools", "skills"];
+
+const TEXT_OUTPUT = { type: "text" };
+
+/**
+ * 调工作台 API。
+ * 认证优先用 config.api_key，其次环境变量 DSH_OPS_KEY。
+ */
+async function api(path, opts = {}, cfg = {}, signal) {
+  const key =
+    (cfg && cfg.api_key) ||
+    (typeof process !== "undefined" && process.env && process.env.DSH_OPS_KEY) ||
+    "";
+  const headers = { "Content-Type": "application/json" };
+  if (key) headers["Authorization"] = "Bearer " + key;
+
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+  if (signal) {
+    if (signal.aborted) controller.abort();
+    else signal.addEventListener("abort", () => controller.abort(), { once: true });
+  }
+
+  try {
+    const res = await fetch(BASE + path, {
+      method: opts.method || "GET",
+      headers,
+      body: opts.body ? JSON.stringify(opts.body) : undefined,
+      signal: controller.signal,
+    });
+    let data = null;
+    const raw = await res.text();
+    try {
+      data = JSON.parse(raw);
+    } catch {
+      data = { raw: raw.slice(0, 800) };
+    }
+    if (res.status === 401 || res.status === 403) {
+      return {
+        error:
+          "API key 无效或缺失。\n" +
+          "去 https://dshio.org/me/ 生成 key，然后：\n" +
+          "  dsh plugin config dsh-ops --set api_key=<你的 key>",
+      };
+    }
+    if (!res.ok) {
+      return { error: `HTTP ${res.status}: ${(data && (data.error || data.detail)) || raw.slice(0, 200)}` };
+    }
+    return { data };
+  } catch (e) {
+    if (e.name === "AbortError") {
+      return { error: "工作台超时（" + Math.round(TIMEOUT_MS / 1000) + " 秒）。部署可能仍在后台执行，稍后用 ops_status 查看。" };
+    }
+    return { error: "无法连到工作台：" + String(e.message || e).slice(0, 160) };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+export function apply(ctx, config = {}) {
+  const cfg = config || {};
+
+  // ═══════════════════════════════════════════════════════════════
+  //  1. ops_status —— 所有站点状态摘要
+  // ═══════════════════════════════════════════════════════════════
+  ctx.tools.register(
+    defineTool({
+      name: "ops_status",
+      description:
+        "查看运维工作台管理的所有站点的当前状态：总分、分类得分、最近部署时间、未解决问题数。" +
+        "当用户问「站现在怎么样」「有没有挂」「体检一下」时使用。只读，不改任何东西。",
+      parameters: {},
+      output: TEXT_OUTPUT,
+      async execute(args, exec) {
+        const r = await api("/status", {}, cfg, exec && exec.signal);
+        if (r.error) return { text: r.error };
+        const d = r.data || {};
+        const lines = [];
+        if (d.checked_at) lines.push("检查时间: " + d.checked_at);
+        lines.push("");
+        for (const p of d.projects || []) {
+          const mark = p.score >= 90 ? "✓" : p.score >= 70 ? "⚠" : "✗";
+          lines.push(
+            `${String(p.slug || "").padEnd(22)} ${String(p.product_type || "web").padEnd(6)} ` +
+            `${String(p.score).padStart(3)} 分  ${mark}`
+          );
+          if (p.by_category) {
+            const cats = Object.entries(p.by_category)
+              .map(([k, v]) => `${k} ${v}`)
+              .join("  ·  ");
+            if (cats) lines.push("  · " + cats);
+          }
+          if (p.last_deploy) {
+            lines.push("  · 最后部署 " + p.last_deploy);
+          }
+          if (p.open_issues) {
+            lines.push("  · " + p.open_issues + " 个未解决问题");
+          }
+          lines.push("");
+        }
+        if (!d.projects || !d.projects.length) {
+          lines.push("工作台还没有注册任何项目。");
+        }
+        return { text: lines.join("\n") };
+      },
+    })
+  );
+
+  // ═══════════════════════════════════════════════════════════════
+  //  2. ops_check —— 跑检查器
+  // ═══════════════════════════════════════════════════════════════
+  ctx.tools.register(
+    defineTool({
+      name: "ops_check",
+      description:
+        "对某个站点跑检查器（15 个），返回通过/警告/失败的详细结果。" +
+        "当用户说「检查一下 XX 站」「SEO 有问题吗」「静态资源有没有缺」时使用。" +
+        "只读，不改任何东西。不传 checker 就跑全部。",
+      parameters: {
+        project: {
+          type: "string",
+          required: true,
+          description: "项目 slug，如 oracleluck / deepseekbase / dshio",
+        },
+        checker: {
+          type: "string",
+          description:
+            "只跑指定检查器。可选：deploy_smoke / deploy_assets / deploy_sitemap / " +
+            "seo_title / seo_desc / seo_canonical / seo_hreflang / seo_structured / " +
+            "geo_ai_crawler / geo_citable / code_language_mix / code_package_clean / " +
+            "code_secret / sec_fail2ban / sec_backup",
+        },
+      },
+      output: TEXT_OUTPUT,
+      async execute(args, exec) {
+        const q = args.checker ? "?checker=" + encodeURIComponent(args.checker) : "";
+        const r = await api(
+          "/projects/" + encodeURIComponent(args.project) + "/check" + q,
+          { method: "POST", body: {} },
+          cfg,
+          exec && exec.signal
+        );
+        if (r.error) return { text: r.error };
+        const d = r.data || {};
+        const lines = [];
+        lines.push(`项目: ${d.project || args.project}`);
+        lines.push(`总分: ${d.score}  通过 ${d.passed}  警告 ${d.warned}  失败 ${d.failed}  错误 ${d.errored}`);
+        lines.push("");
+        for (const c of d.results || []) {
+          const mark = c.status === "pass" ? "✓" : c.status === "warn" ? "⚠" : c.status === "error" ? "!" : "✗";
+          lines.push(`  ${mark} ${String(c.checker_id).padEnd(22)} ${String(c.score).padStart(5)} 分`);
+          if (c.issues && c.issues.length) {
+            for (const i of c.issues.slice(0, 5)) {
+              lines.push(`      [${i.level}] ${i.title}`);
+              if (i.fix_hint) lines.push(`        修: ${i.fix_hint}`);
+            }
+          }
+        }
+        return { text: lines.join("\n") };
+      },
+    })
+  );
+
+  // ═══════════════════════════════════════════════════════════════
+  //  3. ops_issues —— 未解决问题
+  // ═══════════════════════════════════════════════════════════════
+  ctx.tools.register(
+    defineTool({
+      name: "ops_issues",
+      description:
+        "列出某个站点未解决的问题，按严重程度排序，含首次发现时间和出现次数。" +
+        "当用户问「还有什么没修」「问题清单」「反复出现的问题」时使用。只读。",
+      parameters: {
+        project: { type: "string", required: true, description: "项目 slug" },
+        level: {
+          type: "string",
+          description: "只列指定级别：info / warn / critical",
+        },
+      },
+      output: TEXT_OUTPUT,
+      async execute(args, exec) {
+        const q = args.level ? "?level=" + encodeURIComponent(args.level) : "";
+        const r = await api(
+          "/projects/" + encodeURIComponent(args.project) + "/issues" + q,
+          {},
+          cfg,
+          exec && exec.signal
+        );
+        if (r.error) return { text: r.error };
+        const d = r.data || {};
+        const items = d.issues || [];
+        if (!items.length) return { text: "没有未解决的问题。" };
+        const lines = [`未解决问题: ${items.length} 个`, ""];
+        const mark = { critical: "✗", warn: "⚠", info: "·" };
+        for (const i of items) {
+          lines.push(`${mark[i.level] || "·"} [${i.level}] ${i.title}`);
+          if (i.fix_hint) lines.push("    修: " + i.fix_hint);
+          lines.push(`    首次 ${i.first_seen} · 出现 ${i.seen_count} 次`);
+        }
+        return { text: lines.join("\n") };
+      },
+    })
+  );
+
+  // ═══════════════════════════════════════════════════════════════
+  //  4. ops_snapshot —— 打快照
+  // ═══════════════════════════════════════════════════════════════
+  ctx.tools.register(
+    defineTool({
+      name: "ops_snapshot",
+      description:
+        "给某个站点当前状态打一份增量快照（只存变化的文件，未变的硬链接）。" +
+        "部署前、改配置前应该先打。当用户说「先备份一下」「打个快照」时使用。" +
+        "只增不删，安全。",
+      parameters: {
+        project: { type: "string", required: true, description: "项目 slug" },
+        label: { type: "string", description: "快照标签，如 before-seo-change" },
+      },
+      output: TEXT_OUTPUT,
+      async execute(args, exec) {
+        const r = await api(
+          "/projects/" + encodeURIComponent(args.project) + "/snapshot",
+          { method: "POST", body: { label: args.label || "" } },
+          cfg,
+          exec && exec.signal
+        );
+        if (r.error) return { text: r.error };
+        const d = r.data || {};
+        return {
+          text:
+            `快照完成\n` +
+            `  id: ${d.snapshot_id}\n` +
+            `  文件: ${d.files}（新增 ${d.new} / 变化 ${d.changed} / 未变 ${d.linked}）\n` +
+            `  大小: ${(d.size_bytes / 1048576).toFixed(1)} MB\n` +
+            `  耗时: ${d.duration_sec} 秒`,
+        };
+      },
+    })
+  );
+
+  // ═══════════════════════════════════════════════════════════════
+  //  5. ops_deploy —— 部署（含影响分析）
+  // ═══════════════════════════════════════════════════════════════
+  ctx.tools.register(
+    defineTool({
+      name: "ops_deploy",
+      description:
+        "部署某个站点到生产。内置三层保护：部署前影响分析（会删除哪些文件）、" +
+        "自动快照、部署后验证，验证失败自动回滚。" +
+        "当用户说「部署」「上线」「发布」时使用。" +
+        "强烈建议先用 dry_run=true 看影响分析。",
+      parameters: {
+        project: { type: "string", required: true, description: "项目 slug" },
+        dry_run: {
+          type: "boolean",
+          description: "true 只看影响分析不执行。强烈建议先跑一次。",
+        },
+        render: {
+          type: "boolean",
+          description: "是否重新生成页面，默认 true。只同步不渲染时设 false。",
+        },
+        force: {
+          type: "boolean",
+          description:
+            "强制部署，跳过「删除白名单」保护。只有确认被删文件无害时才用。",
+        },
+      },
+      output: TEXT_OUTPUT,
+      isConcurrencySafe: () => false,
+      async execute(args, exec) {
+        const r = await api(
+          "/projects/" + encodeURIComponent(args.project) + "/deploy",
+          {
+            method: "POST",
+            body: {
+              dry_run: !!args.dry_run,
+              render: args.render !== false,
+              force: !!args.force,
+            },
+          },
+          cfg,
+          exec && exec.signal
+        );
+        if (r.error) return { text: r.error };
+        const d = r.data || {};
+        return { text: d.output || JSON.stringify(d, null, 2) };
+      },
+    })
+  );
+
+  // ═══════════════════════════════════════════════════════════════
+  //  6. ops_rollback —— 回滚
+  // ═══════════════════════════════════════════════════════════════
+  ctx.tools.register(
+    defineTool({
+      name: "ops_rollback",
+      description:
+        "把某个站点回滚到指定快照。不传 snapshot_id 就用最近一个快照。" +
+        "当部署后发现问题、或用户说「回滚」「退回上一个版本」时使用。" +
+        "回滚也会删除快照里没有的文件，建议先 dry_run=true 看影响。",
+      parameters: {
+        project: { type: "string", required: true, description: "项目 slug" },
+        snapshot_id: {
+          type: "number",
+          description: "要回滚到的快照 id。不传则用最近一个。",
+        },
+        dry_run: {
+          type: "boolean",
+          description: "true 只看影响分析不执行。",
+        },
+      },
+      output: TEXT_OUTPUT,
+      isConcurrencySafe: () => false,
+      async execute(args, exec) {
+        const r = await api(
+          "/projects/" + encodeURIComponent(args.project) + "/rollback",
+          {
+            method: "POST",
+            body: {
+              snapshot_id: args.snapshot_id || null,
+              dry_run: !!args.dry_run,
+            },
+          },
+          cfg,
+          exec && exec.signal
+        );
+        if (r.error) return { text: r.error };
+        const d = r.data || {};
+        return { text: d.output || JSON.stringify(d, null, 2) };
+      },
+    })
+  );
+
+  // ═══════════════════════════════════════════════════════════════
+  //  7. ops_restart —— 重启服务
+  // ═══════════════════════════════════════════════════════════════
+  ctx.tools.register(
+    defineTool({
+      name: "ops_restart",
+      description:
+        "重启某个站点的服务（如 Django CMS）。改了模板或配置要生效时用。" +
+        "当用户说「重启」「改完不生效」时使用。重启期间会有几秒 502。",
+      parameters: {
+        project: { type: "string", required: true, description: "项目 slug" },
+        service: {
+          type: "string",
+          description: "服务名，如 oracleluck-cms。不传则用项目默认服务。",
+        },
+      },
+      output: TEXT_OUTPUT,
+      isConcurrencySafe: () => false,
+      async execute(args, exec) {
+        const r = await api(
+          "/projects/" + encodeURIComponent(args.project) + "/restart",
+          { method: "POST", body: { service: args.service || "" } },
+          cfg,
+          exec && exec.signal
+        );
+        if (r.error) return { text: r.error };
+        const d = r.data || {};
+        return { text: d.output || JSON.stringify(d, null, 2) };
+      },
+    })
+  );
+
+  // ═══════════════════════════════════════════════════════════════
+  //  技能注册
+  // ═══════════════════════════════════════════════════════════════
+  if (ctx.skills && typeof ctx.skills.register === "function") {
+    for (const sk of ALL_SKILLS) {
+      try {
+        ctx.skills.register({
+          name: sk.name,
+          description: sk.description,
+          content: sk.content,
+          source: "runtime",
+          whenToUse: sk.whenToUse,
+          metadata: {
+            source: "dsh-ops",
+            layer: "bundled",
+            version: "0.1.0",
+            lang: "zh-Hans",
+            homepage: "https://deepseekbase.com/work/",
+          },
+        });
+      } catch (e) {
+        // 技能注册失败不影响工具使用
+      }
+    }
+  }
+}

package/lib/skills.js

@@ -0,0 +1,110 @@
+// DSH 运维工作台 —— 技能内容
+//
+// 技能是给模型看的：告诉它什么时候该用哪个工具、哪些操作危险。
+// 与工具的区别：工具会执行，技能只是知识。
+
+export const OPS_GUIDE_SKILL = {
+  name: "ops-guide",
+  description:
+    "DSH 運維工作台使用指南。说明 ops_status / ops_check / ops_deploy / " +
+    "ops_rollback 等工具何时该用、危险操作前该确认什么、部署影响分析怎么看。" +
+    "当用户问「站现在怎么样」「能不能部署」「出问题了怎么办」时载入本技能。",
+  whenToUse:
+    "用户询问站点状态、要部署、要回滚、要排查线上问题时使用。" +
+    "纯内容问题（写文章、改文案）不需要本技能。",
+  content: `# DSH 運維工作台 使用指南
+
+工作台管 3 个站点：\`oracleluck.com\`（玄学）、\`deepseekbase.com\`（DSH 插件市场）、\`dshio.org\`（标准机构）。
+
+## 一、四个工具的分工
+
+| 工具 | 什么时候用 | 会改系统吗 |
+|---|---|---|
+| \`ops_status\` | 用户问「站怎么样」「有没有问题」 | 否 |
+| \`ops_check\` | 要详细检查某一项或全部 | 否 |
+| \`ops_snapshot\` | 部署前、改配置前 | 是（但只增不删） |
+| \`ops_deploy\` | 要上线改动 | **是，高风险** |
+| \`ops_rollback\` | 部署后发现问题 | **是，高风险** |
+| \`ops_restart\` | 改了模板/配置要生效 | **是，中风险** |
+
+## 二、危险操作的规矩
+
+### ops_deploy 前必须做
+
+1. **先跑 \`ops_deploy --dry-run\`** —— 看影响分析
+2. 读懂「将删除 N 个文件」这段
+3. 如果出现「不在源头且不在白名单」的文件，**不要加 --force**，先问用户
+
+**真实事故背景：** 2026-11-09 一次 \`rsync --delete\` 删掉了 3 个静态 JS 文件，导致整个站的手机适配、反馈按钮、PWA 提示全部失效 4 天。工作台的影响分析就是为这个事故加的。
+
+### ops_rollback 前必须做
+
+1. 先 \`ops_rollback --dry-run\`，看会恢复多少、删除多少
+2. 确认快照 id 是想要的（\`ops_status\` 里有最近 5 个快照）
+3. 回滚也会删除文件（快照里没有的），确认后再执行
+
+### ops_restart 的影响
+
+- \`oracleluck-cms\` 重启约 3-5 秒，期间请求会 502
+- 不要在流量高峰做
+
+## 三、检查器清单（15 个）
+
+**部署类**
+- \`deploy_smoke\` 关键页可用性
+- \`deploy_assets\` 静态资源存在性（这条抓的就是 11-09 那个事故）
+- \`deploy_sitemap\` sitemap 合规（5 万 URL / 50MB 上限）
+
+**SEO 类**
+- \`seo_title\` 标题（长度、核心词、模板词）
+- \`seo_desc\` 描述
+- \`seo_canonical\` canonical 自指
+- \`seo_hreflang\` hreflang 对称
+- \`seo_structured\` JSON-LD 结构化数据
+
+**GEO 类**
+- \`geo_ai_crawler\` AI 爬虫放行（robots.txt）
+- \`geo_citable\` 内容可摘录性
+
+**代码类**
+- \`code_language_mix\` 多语言混入（抓过荷兰语混进中文站的事故）
+- \`code_package_clean\` 打包清洁（抓过 .bak 被发上 npm 的事故）
+- \`code_secret\` 敏感信息泄漏
+
+**安全类**
+- \`sec_fail2ban\` 防爆破
+- \`sec_backup\` 备份完整性
+
+## 四、输出怎么读
+
+\`\`\`
+deepseekbase.com          web    92 分   ✓
+  · SEO 98  ✓  · GEO 80  ⚠  · 安全 95  ✓
+  · 部署 3 小时前，smoke 全过
+\`\`\`
+
+- ✓ 全部通过
+- ⚠ 有警告（不影响使用，但建议修）
+- ✗ 有失败（会影响用户）
+
+## 五、什么时候不该用工作台
+
+| 场景 | 该用什么 |
+|---|---|
+| 改文案、写文章 | 直接编辑，不用工作台 |
+| 查数据 | 查数据库，不用工作台 |
+| 检查 DSH 插件合规 | \`dshio-check\` 技能 + \`deepseekbase_check\` 工具 |
+| 查模型价格 | \`deepseekbase_price\` 工具 |
+
+## 六、故障时怎么排查
+
+1. \`ops_status\` —— 先看哪站红
+2. \`ops_check <project>\` —— 看具体哪个检查器失败
+3. \`ops_issues <project>\` —— 看历史问题，是不是反复出现
+4. 如果是刚部署后出的问题 → \`ops_rollback\`
+
+**不要跳过第 1 步直接回滚** —— 可能问题不在代码，而在服务器或 DNS。
+`,
+};
+
+export const ALL_SKILLS = [OPS_GUIDE_SKILL];

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@liangjiehappy/dsh-ops",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "DSH 運維工作台：檢查 3 個站點的健康、SEO、GEO、代碼與安全，支援快照、部署與自動回滾。當使用者問「站現在怎麼樣」「部署安全嗎」「幫我檢查一下」時使用。",
+  "description_en": "DSH operations workbench: check health, SEO, GEO, code and security for DSH-managed sites, with snapshot, deploy and automatic rollback.",
+  "type": "module",
+  "main": "lib/index.js",
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh.md"
+  ],
+  "keywords": [
+    "dsh-plugin",
+    "dsh",
+    "devops",
+    "operations",
+    "monitoring",
+    "deploy",
+    "snapshot",
+    "rollback",
+    "skills"
+  ],
+  "license": "MIT",
+  "homepage": "https://deepseekbase.com/work/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moldkey/dsh-deepseekbase.git",
+    "directory": "sites/dsh-ops"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "engines": {
+    "dsh": ">=0.2.0-rc.2"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-tools": "*"
+  }
 }