dsh-codex-port 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 stardustlc
+
+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.en.md

@@ -2,10 +2,16 @@
 
 # dsh-codex-port
 
+[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
+
 Move the whole **official Codex plugin family** into DSH: scan `~/.codex` unpacked plugins and plugin caches, then batch-port their skills into DSH skills (automatic frontmatter conversion, codex-only files stripped, name sanitization, idempotent skips).
 
 > Measured on a real machine: 186 official Codex plugins, 583 skills — one port run moved 577 successfully, 0 failures.
 
+## Compatibility
+
+Verified against `@deepseek-ai/dsh@0.1.1-rc.2` on 2026-08-26. Built for the cordis patch-bundle plugin model (`cordis.patch.yml` + `dsh.bundle.patch`). No runtime imports of `@deepseek-ai/*` internals.
+
 ## Installation
 
 ```bash
@@ -14,6 +20,15 @@ dsh plugin --profile web add dsh-codex-port
 
 Requires the Codex CLI to be installed (the `~/.codex` directory must exist).
 
+## Uninstall
+
+```bash
+dsh plugin --profile web remove dsh-codex-port
+```
+
+Then restart the web service. To clean up fully, also remove the plugin entry from your profile `cordis.patch.yml` if you overrode it.
+
+
 ## Configuration
 
 Everything is optional; defaults just work:
@@ -65,4 +80,4 @@ pnpm test       # build + 33 tests
 
 ## License
 
-MIT
+MIT

package/README.md

@@ -2,10 +2,21 @@
 
 # dsh-codex-port
 
+> **Codex 全家桶，一条命令进 DSH**：实测 186 插件、583 技能、移植 577 个 0 失败。
+
+![npm version](https://img.shields.io/npm/v/dsh-codex-port?label=npm&color=blue) ![npm downloads](https://img.shields.io/npm/dm/dsh-codex-port) ![license](https://img.shields.io/npm/l/dsh-codex-port) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-codex-port?style=social)
+
+[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
+
+
 把 **Codex 官方插件全家桶**一键搬进 DSH：扫描 `~/.codex` 里的解包插件与插件缓存，把它们的技能批量移植为 DSH 技能（frontmatter 自动转换、codex 专属文件剔除、名称清洗、幂等跳过）。
 
 > 本机实测：186 个 Codex 官方插件、583 个技能，一次移植 577 个成功、0 失败。
 
+## 兼容性
+
+在 `@deepseek-ai/dsh@0.1.1-rc.2` 上验证（2026-08-26）。遵循 cordis 组合包补丁模型（`cordis.patch.yml` + `dsh.bundle.patch`），运行时不 import 任何 `@deepseek-ai/*` 内部模块。
+
 ## 安装
 
 ```bash
@@ -14,6 +25,15 @@ dsh plugin --profile web add dsh-codex-port
 
 需要本机装有 Codex CLI（`~/.codex` 目录存在即可）。
 
+## 卸载
+
+```bash
+dsh plugin --profile web remove dsh-codex-port
+```
+
+卸载后重启 Web 服务。如需彻底清理，可再手动删除自己 profile `cordis.patch.yml` 中覆盖的插件行。
+
+
 ## 配置
 
 全部可选，默认即可用：
@@ -48,6 +68,22 @@ codex_status {}                        # 还有多少没移植
 
 移植后 DSH 技能目录立即可用，agent 按技能描述自动触发。
 
+## 跨平台使用
+
+`targetDir` 不限于 DSH：指向任何支持 Agent Skills（SKILL.md）格式的 agent 技能目录，即可把 Codex 全家桶移植给它们：
+
+| Agent | 建议 targetDir |
+| :-- | :-- |
+| DSH | `~/.dsh/skills`（默认）|
+| Claude Code | `~/.claude/skills/` |
+| Cursor | `.cursor/skills/` |
+| Gemini CLI | `~/.gemini/skills/` |
+
+```text
+codex_port { targetDir: ~/.claude/skills }
+```
+
+
 ## 移植规则
 
 - **frontmatter 转换**：Codex 的 `name/description/metadata` → DSH 的 `name/description/compatibility/allowed-tools`，多行描述完整保留

package/lib/discover.js

@@ -17,6 +17,25 @@ function isDir(path) {
         return false;
     }
 }
+/** 语义化版本比较：按数字段逐段比较，忽略 v 前缀与 pre-release 后缀。 */
+function isNewerVersion(a, b) {
+    const parse = (v) => {
+        const match = /v?(\d+(?:\.\d+)*)/.exec(v);
+        if (match === null)
+            return [];
+        return match[1].split('.').map((n) => Number(n));
+    };
+    const pa = parse(a);
+    const pb = parse(b);
+    const len = Math.max(pa.length, pb.length);
+    for (let i = 0; i < len; i += 1) {
+        const x = pa[i] ?? 0;
+        const y = pb[i] ?? 0;
+        if (x !== y)
+            return x > y;
+    }
+    return false;
+}
 /** 读取 plugin.json；缺失或非法返回 null。 */
 function readPluginManifest(pluginDir) {
     const manifestPath = join(pluginDir, '.codex-plugin', 'plugin.json');
@@ -124,7 +143,7 @@ export function discoverPlugins(codexHome) {
         }
         else {
             const betterPriority = candidate.priority > (candidates.find((c) => c.dir === existing.sourceDir)?.priority ?? -1);
-            const newerVersion = manifest.version !== 'unknown' && manifest.version !== existing.version && manifest.version > existing.version;
+            const newerVersion = manifest.version !== 'unknown' && manifest.version !== existing.version && isNewerVersion(manifest.version, existing.version);
             if (betterPriority || newerVersion)
                 found.set(key, info);
         }

package/lib/index.d.ts

@@ -10,6 +10,7 @@
 import { type CodexPortConfig } from './config.js';
 import { type CodexPortToolDefinition } from './tools.js';
 /** cordis 服务注入：apply 里要用 ctx.tools，必须显式声明。 */
+export declare const name = "codex-port";
 export declare const inject: string[];
 /** 插件所需的最小 ctx 面。 */
 export interface CodexPortPluginContext {

package/lib/index.js

@@ -10,6 +10,7 @@
 import { resolveConfig } from './config.js';
 import { buildCodexPortTools } from './tools.js';
 /** cordis 服务注入：apply 里要用 ctx.tools，必须显式声明。 */
+export const name = 'codex-port';
 export const inject = ['tools'];
 /**
  * 插件入口：解析配置并注册三个移植工具。

package/lib/port.js

@@ -13,6 +13,8 @@ function copyTree(source, target) {
     mkdirSync(target, { recursive: true });
     let count = 0;
     for (const entry of readdirSync(source, { withFileTypes: true })) {
+        if (entry.isSymbolicLink())
+            continue;
         if (entry.isDirectory() && EXCLUDED_DIRS.has(entry.name))
             continue;
         const from = join(source, entry.name);

package/lib/tools.js

@@ -263,5 +263,44 @@ export function buildCodexPortTools(config) {
             };
         },
     };
-    return [codexList, codexPort, codexStatus];
+    const codexHealth = {
+        name: 'codex_health',
+        description: 'dsh-codex-port 自检：检查 Codex 主目录（~/.codex 或自定义）是否存在、插件目录是否可见（不执行任何移植）。遇到问题时先运行本工具定位。',
+        parameters: compileParameters({
+            codexHome: { type: 'string', description: 'Codex 主目录（可选，缺省用配置或 ~/.codex）。' },
+        }),
+        output: {
+            schema: { type: 'object', additionalProperties: true },
+            render: (_args, value) => {
+                const rec = asRecord(value);
+                const checks = Array.isArray(rec.checks) ? rec.checks : [];
+                const lines = ['dsh-codex-port 自检' + (rec.ok === true ? '：正常。' : '：发现问题。')];
+                for (const item of checks) {
+                    const c = asRecord(item);
+                    lines.push('- ' + c.name + '：' + (c.ok === true ? '✅ ' + String(c.detail ?? '') : '❌ ' + String(c.detail ?? '')));
+                }
+                return [{ type: 'text', text: lines.join('\n') }];
+            },
+        },
+        async execute(rawArgs) {
+            const args = asRecord(rawArgs);
+            const home = optionalString(args, 'codexHome') ?? config.codexHome;
+            const checks = [];
+            try {
+                assertCodexHome(home);
+                checks.push({ name: 'Codex 主目录', ok: true, detail: home });
+            }
+            catch (error) {
+                checks.push({ name: 'Codex 主目录', ok: false, detail: error instanceof Error ? error.message : String(error) });
+                return { ok: false, plugin: 'dsh-codex-port', codexHome: home, checks };
+            }
+            let ok = true;
+            const pluginsOk = existsSync(home + '/plugins');
+            checks.push({ name: '插件目录', ok: pluginsOk, detail: pluginsOk ? home + '/plugins' : 'plugins/ 不存在（Codex 尚未安装任何插件）' });
+            if (!pluginsOk)
+                ok = false;
+            return { ok, plugin: 'dsh-codex-port', codexHome: home, checks };
+        },
+    };
+    return [codexList, codexPort, codexStatus, codexHealth];
 }

package/package.json

@@ -1,63 +1,63 @@
-{
-  "name": "dsh-codex-port",
-  "version": "0.1.0",
-  "description": "DSH 技能移植工具插件：把 ~/.codex 里的 Codex 官方插件（170+ 个）一键移植为 DSH 技能（codex_list / codex_port / codex_status），frontmatter 自动转换、名称清洗、幂等跳过。",
-  "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/index.d.ts",
-      "default": "./lib/index.js"
-    },
-    "./cordis.patch.yml": "./cordis.patch.yml",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "lib",
-    "cordis.patch.yml",
-    "README.md",
-    "README.en.md"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "prepare": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "pnpm run build && node --test \"test/*.test.mjs\"",
-    "prepublishOnly": "pnpm run build"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    }
-  },
-  "keywords": [
-    "dsh",
-    "deepseek-harness",
-    "plugin",
-    "codex",
-    "skills",
-    "migration"
-  ],
-  "license": "MIT",
-  "engines": {
-    "node": ">=20"
-  },
-  "dependencies": {
-    "yaml": "^2.9.0"
-  },
-  "devDependencies": {
-    "@types/node": "^24.0.0",
-    "typescript": "^5.6.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/STARDUSTLC666/dsh-codex-port"
-  },
-  "bugs": {
-    "url": "https://github.com/STARDUSTLC666/dsh-codex-port/issues"
-  },
-  "homepage": "https://github.com/STARDUSTLC666/dsh-codex-port#readme",
-  "author": "stardustlc",
-  "packageManager": "pnpm@11.7.0"
-}
+{
+  "name": "dsh-codex-port",
+  "version": "0.2.0",
+  "description": "DSH 技能移植工具插件：把 ~/.codex 里的 Codex 官方插件（170+ 个）一键移植为 DSH 技能（codex_list / codex_port / codex_status），frontmatter 自动转换、名称清洗、幂等跳过。",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "README.en.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "pnpm run build && node --test \"test/*.test.mjs\"",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "plugin",
+    "codex",
+    "skills",
+    "migration",
+    "dsh-plugin"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.6.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/STARDUSTLC666/dsh-codex-port.git"
+  },
+  "bugs": {
+    "url": "https://github.com/STARDUSTLC666/dsh-codex-port/issues"
+  },
+  "homepage": "https://github.com/STARDUSTLC666/dsh-codex-port#readme",
+  "author": "stardustlc",
+  "packageManager": "pnpm@11.7.0"
+}