dsh-ris-yds 0.0.0-stage → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-ris-yds contributors
+
+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

@@ -1,3 +1,161 @@
-# Temporary Holding Version
+# dsh-ris-yds
 
-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.
+YonBIP YDS 客开后端的本地运行时，做成 **DSH 插件 + CLI** 双形态：
+
+- **DSH 插件**：给 coding agent 提供一整套 `yds_*` 工具（体检 / 配置 / 凭据 / 运行时 / 集成 / 调试）。
+- **CLI**（`bin/yds.js`，装包后 `yds` 命令）：同一套能力给人用（在终端或 IDE 里执行）。
+
+在本地把后端运行时跑起来，用本地实例替代远端环境做开发联调。
+
+## 截图
+
+| 在 DSH 里管理本地服务：启停、实时日志、调试入口 |
+|---|
+| ![DSH 里的 RIS 控制台](https://raw.githubusercontent.com/ris-cloud/dsh-ris-yds/master/docs/screenshots/yds-run.png) |
+
+| 内网访问规则（可选）：按程序 / 内网地址 / 端口放行，一次启用 |
+|---|
+| ![内网访问规则](https://raw.githubusercontent.com/ris-cloud/dsh-ris-yds/master/docs/screenshots/ris-proxy.png) |
+
+## 能做什么
+
+- **本地运行**：构建、启动、停止、查看状态与实时日志；启动失败自动回收，不留下半启动的进程。
+- **平台配置**：从平台拉取配置并适配到本地运行时；支持离线缓存，网络不可达时也能启动。
+- **内网访问**：数据库 / 缓存 / 内网服务可经代理或直连访问；本机其它客户端也能共用同一条隧道。dsh-ris-ide 的代理 daemon（risd）在跑时自动共用它的引擎，`yds stop` 只撤自己的规则、不打断别人
+  （需要系统权限的可选能力）。
+- **平台凭据**：生成调用平台 API 的 YYCToken，新环境无需额外安装。
+- **前端调试**：让远端页面加载本地前端资源，三种接入方式（浏览器扩展规则 / 请求改路 / URL 参数）。
+- **IDE 面板**：在 dsh-ris-ide 面板里启停本地服务、查看实时日志、做 JDWP 断点调试。
+- **外部 IDE**：本地运行时可被外部 IDE 直接 F5 启动调试。
+- **浏览器回调校准**：确保工作台页面的请求回落到本机实例（失败时是静默的，自检可查）。
+- **环境自检**：`yds doctor` 一次列出配置、运行时、端口、隧道等所有缺失项。
+
+## 安装
+
+```bash
+# 公开 npm（推荐）
+dsh plugin --profile web add dsh-ris-yds
+
+# 或从本地 checkout 安装（开发调试）
+dsh plugin --profile web add <本目录>
+```
+
+装完需**重启 `dsh web`**（宿主插件只在启动时组合一次，工具注册才生效）。新会话里 agent 就有
+`yds_*` 工具；`skills/dsh-ris-yds` 会自动同步到项目 `.dsh/skills`。
+
+前置：JDK 21 与 Maven 在 `PATH`（或在 `.env` 指定 `java.path` / `maven.settings`）。
+
+## 快速开始
+
+```bash
+cd <你的 YonBIP 项目目录>
+
+yds doctor          # 体检：配置解析、运行时、端口、隧道/缺失项
+yds confcenter      # 拉取并适配平台配置（首次联网；之后可 --offline）
+yds build           # 首次构建运行时（下载依赖，约 19 分钟；缓存后约 1 分钟）
+yds start           # 后台启动（幂等；缺少配置/隧道会自动补）
+yds status          # 进程、端口、就绪状态
+yds logs --lines 200
+yds stop
+```
+
+## 命令一览
+
+| 命令 | 能力 |
+|---|---|
+| `yds doctor` / `yds config` / `yds token <url>` | 体检 / 生效配置（凭据打码）/ 生成平台 API 凭据 |
+| `yds confcenter [--offline]` | 拉取并适配平台配置到本地运行时 |
+| `yds build` | 构建本地运行时（首次下载依赖） |
+| `yds start` / `yds stop [--keep-socks]` / `yds status` / `yds logs` | 本地运行时生命周期 |
+| `yds ide apply\|check\|remove` | 本地运行时的 IDE 面板集成（启停 / 日志 / 调试） |
+| `yds proxy [status\|sync\|start\|stop\|git-on\|git-off]` | 内网访问与 git 代理 |
+| `yds browser [status\|fix] [--dry-run]` | 浏览器请求回调校准 |
+| `yds fe [rules\|plan\|url <page>]` | 前端调试接入（扩展规则 / 请求改路 / URL 参数） |
+
+## 配置（`.env` / 环境变量）
+
+工作区根目录放一份 `.env` 即可，键名不带插件前缀；项目 `.vscode/settings.json` 的 `yds.*` 优先。
+
+| 键 | 默认 | 说明 |
+|---|---|---|
+| `socks.host` / `socks.port` | 空 | 都空 = 直连；有值 = 代理模式 |
+| `socks.dbPort` / `socks.redisPort` | 1521 / 6890 | 本机映射端口（JDBC/Redis 客户端用） |
+| `ide.launch` | `proxy` | `proxy` / `direct`：外部 IDE 走代理还是直连 |
+| `git.proxy` | `auto` | `off` 关闭 git 代理 |
+| `local.ymsHome` | `<项目>/yms-home` | 本地运行时目录 |
+| `maven.settings` / `maven.repo` | 空 | 构建用；留空用默认设置 |
+| `java.path` | 空 | 指定 JDK（留空用 PATH） |
+
+## 两种使用方式：代理 / 直连
+
+| | 代理模式（有 `socks.*`） | 直连模式（无 `socks.*`） |
+|---|---|---|
+| 内网访问 | 经隧道；本机端口映射给 JDBC/Redis | 直接访问，不起任何隧道 |
+| 本地运行时配置 | 改写成 `127.0.0.1` 映射地址 | 平台地址原样保留 |
+| git 代理 | 自动按克隆地址主机写入 | 不写 |
+
+### 隧道从哪来（自动选择，无需配置）
+
+1. **dsh-ris-ide 的 risd daemon 在跑**：规则、租约与系统层拦截交给它（写规则 + 登记租约），
+   daemon 的引擎不另起；但 YMS 配置被改写成 `127.0.0.1:<dbForwardPort>/<redisForwardPort>`，
+   而 daemon 引擎的 127.0.0.1 映射只做同端口映射，覆盖不到这两个端口，所以**内置 SOCKS 转发器
+   仍会作为兜底 127.0.0.1 映射同时启动**（代理模式下是两个进程：daemon 引擎 + 内置转发器；
+   直连模式下都不起）；
+2. 装了 dsh-ris-ide 但 daemon 没跑：借用它已有的代理引擎（127.0.0.1 映射由它按规则提供）；
+3. 都没有：用本插件内置的 SOCKS 转发器（零依赖，不需要 dsh-ris-ide）。
+
+规则表是**全局一张表**（面板/文件只有一份，保存即整表覆盖，不区分 workspace）。yds 每次启动注入自己
+那一段时是「保留非 yds 行 + 用本次的 yds 行整体替换旧的 yds 行」，所以 `yds stop` 会把表里**全部** yds 行
+撤掉（同一台机器上的多个项目共用这张表，没有交叉配置）；非 yds 行（你自己加的规则、其它工具注入的）不受影响。
+非 Windows（含 WSL）除了 `java.exe`/`git.exe` 还会注入本地侧 `java`/`git` 两条规则（`side` 标明侧别），
+WSL 里的 JVM/git 才会被拦截。`yds stop` **不会主动停掉机器级引擎**（IDE 可能还在用）。
+输出里的「已从共享规则表移除 N 条规则/M 个 host」是本次真正减掉的部分，减掉 0 时会明确说没改动规则表。
+注意 `yds stop` 释放的是本项目的租约：如果 daemon 的生命周期配置是「无租约即拆除代理」，而 yds 恰好是
+最后一个租约持有者，daemon 会在约 300ms 后自己关闭隧道（这不是 yds 去停它，进程日志里会打出来）。
+
+同一台机器可以混合：dsh 走代理、外部 IDE 直连（`.env` 里设 `ide.launch=direct`）：
+
+```bash
+# .env: 保留 socks.host / socks.port，加 ide.launch=direct
+yds confcenter   # 准备运行配置
+yds ide apply    # 应用当前模式
+```
+
+切换模式只需改 `ide.launch` 后重新应用。
+
+## 与 dsh-ris-ide 搭配（可选）
+
+装上 [`dsh-ris-ide`](https://gitee.com/riscloud/dsh-ris-ide) 后，可在同一个 dsh 里获得：
+
+- 启停本地服务、查看实时日志（只看本次启动）；
+- JDWP 断点调试（线程、调用栈、变量）；
+- 工作区文件树、编辑器、搜索与多文件粘贴。
+
+两者**互不依赖**，可各自单独安装：没装 dsh-ris-ide 时本插件各项能力照常可用。
+
+## 安全与边界（摘要）
+
+- `workbenchUrl` 是**项目级信任根**：只对可信仓库执行 `yds build` / `yds start`。
+- 本机转发端口无鉴权（单用户开发机可接受）。
+- `yds token` 明文输出短期凭据，避免落盘。
+- 涉及浏览器状态的命令支持 `--dry-run` 预览，不确定时先预览。
+
+完整清单与实现理由见 [DEVELOPMENT.md](DEVELOPMENT.md) §15。
+
+## 开发
+
+- 架构、模块、内部机制（配置管线、隧道、模式隔离、IDE 集成、校准、发版）见
+  **[DEVELOPMENT.md](DEVELOPMENT.md)**。
+- 测试与自检：
+
+  ```bash
+  npm test               # node --test "test/*.test.mjs"
+  npm run check:listing  # 上架自检（❌ 必须为 0）
+  ```
+
+- 目录：`lib/` 实现、`bin/` CLI、`native/` 原生凭据模块（6 平台）、`assets/` 浏览器扩展包、
+  `test/` 测试、`skills/` dsh 技能。
+
+## License
+
+MIT

package/bin/check-listing.mjs

@@ -0,0 +1,247 @@
+#!/usr/bin/env node
+/**
+ * 上架自检：把 dsh-market（awesome-dsh-plugin 目录）与 dsh.so 的收录条件，变成能在本地跑的检查。
+ *
+ *   npm run check:listing
+ *   npm run check:listing -- --json
+ *   npm run check:listing -- --strict        # 警告也算失败
+ *   npm run check:listing -- --net           # 额外尝试联网确认仓库/包公开可达（内网环境会失败）
+ *
+ * 规则来源与逐条解释在**仓库外**的插件开发手册（`docs/dsh-plugin-listing-guide.md`）。这里是**静态**检查：license 选哪个、仓库要不要公开、
+ * npm 包名怎么定，这些决定项脚本只能标记出来，得人定。
+ */
+import { readFile, readdir, stat } from 'node:fs/promises'
+import { existsSync } from 'node:fs'
+import { join, dirname, extname, relative } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+const argv = process.argv.slice(2)
+const AS_JSON = argv.includes('--json')
+const STRICT = argv.includes('--strict')
+const NET = argv.includes('--net')
+
+const results = []
+const ok = (id, detail) => results.push({ id, level: 'ok', detail })
+const warn = (id, detail) => results.push({ id, level: 'warn', detail })
+const fail = (id, detail) => results.push({ id, level: 'error', detail })
+
+async function readJson(rel) {
+  return JSON.parse(await readFile(join(ROOT, rel), 'utf8'))
+}
+
+async function readText(rel) {
+  try {
+    return await readFile(join(ROOT, rel), 'utf8')
+  } catch {
+    return null
+  }
+}
+
+/** 递归列出目录下的文件（跳过 node_modules / .git / 构建产物） */
+async function listFiles(dir, acc = []) {
+  let entries
+  try {
+    entries = await readdir(join(ROOT, dir), { withFileTypes: true })
+  } catch {
+    return acc
+  }
+  for (const entry of entries) {
+    if (entry.name === 'node_modules' || entry.name === '.git' || entry.name === 'dist') continue
+    const rel = dir === '.' ? entry.name : `${dir}/${entry.name}`
+    if (entry.isDirectory()) {
+      await listFiles(rel, acc)
+    } else {
+      acc.push(rel)
+    }
+  }
+  return acc
+}
+
+const SRC_EXT = new Set(['.js', '.mjs', '.cjs', '.ts', '.tsx', '.jsx', '.sh', '.ps1', '.vue'])
+const PUBLIC_HOSTS = ['github.com', 'gitee.com', 'gitlab.com']
+
+function short(text, max = 120) {
+  const line = String(text).replace(/\s+/g, ' ').trim()
+  return line.length > max ? `${line.slice(0, max - 1)}…` : line
+}
+
+async function main() {
+  const pkg = await readJson('package.json')
+  const readme = await readText('README.md')
+
+  // ── dsh.so：插件 id（slug） ───────────────────────────────────────────────
+  const bareName = String(pkg.name || '').replace(/^@[^/]+\//, '')
+  if (/^[a-z0-9]+(-[a-z0-9]+)*$/.test(bareName)) ok('插件 id（slug）', `"${pkg.name}" → ${bareName} 匹配 ^[a-z0-9]+(-[a-z0-9]+)*$`)
+  else fail('插件 id（slug）', `"${pkg.name}" 不匹配 ^[a-z0-9]+(-[a-z0-9]+)*$：改成小写 kebab-case（scoped 包只校验 scope 后的段）`)
+
+  // ── 版本：市场展示的是最新正式版 ─────────────────────────────────────────
+  if (/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(String(pkg.version || ''))) {
+    if (String(pkg.version).includes('-')) warn('版本号', `${pkg.version} 是预发布版；市场/dsh.so 展示 latest 语义时应发布 X.Y.Z 正式版（快照只用于本地）`)
+    else ok('版本号', `${pkg.version}（合法 semver，正式版）`)
+  } else {
+    fail('版本号', `"${pkg.version}" 不是合法 semver`)
+  }
+
+  // ── dsh.so：DSH 兼容信号（至少一个） ─────────────────────────────────────
+  const signals = []
+  if (pkg.dsh && typeof pkg.dsh === 'object') signals.push('package.json 的 dsh 字段')
+  if (pkg.dsh?.bundle?.patch) signals.push(`dsh.bundle.patch = ${pkg.dsh.bundle.patch}`)
+  if (pkg.dsh?.plugin) signals.push('dsh.plugin.* manifest')
+  if (pkg.engines?.dsh) signals.push(`engines.dsh = ${pkg.engines.dsh}`)
+  if (existsSync(join(ROOT, 'cordis.patch.yml'))) signals.push('cordis.patch.yml')
+  if (existsSync(join(ROOT, 'agent.cordis.yml'))) signals.push('agent.cordis manifest')
+  if (signals.length) ok('DSH 兼容信号', signals.join('；'))
+  else fail('DSH 兼容信号', '缺少全部信号（dsh 字段 / cordis manifest / dsh-plugin topic）')
+
+  // ── dsh.so：README 含安装说明 ────────────────────────────────────────────
+  if (!readme) fail('README 安装说明', '没有 README.md')
+  else {
+    const installLines = readme
+      .split('\n')
+      .filter((line) => /dsh plugin --profile \S+ add /.test(line))
+    // 「公开」口径：这条安装命令不依赖内网 registry，市场用户照抄就能装
+    const publicLine = installLines.find(
+      (line) => !/registry=|\.npmrc|repository\/npm-/.test(line) && !/@\d/.test(line),
+    )
+    if (installLines.length === 0) {
+      fail('README 安装说明', 'README 里找不到 `dsh plugin --profile <p> add …`')
+    } else if (publicLine) {
+      ok('README 安装说明', `含公开可直接抄的安装命令：${short(publicLine, 80)}${installLines.length > 1 ? `（另有 ${installLines.length - 1} 条内网/带版本号的备选）` : ''}`)
+    } else {
+      warn('README 安装说明', '安装命令都指向内部 registry 或写死了版本号；公开上架需要一条不依赖内网、不写死版本的 `dsh plugin --profile web add <包名>`')
+    }
+  }
+
+  // ── dsh.so：开源 license + SPDX ─────────────────────────────────────────
+  const licenseFiles = (await listFiles('.')).filter((f) => /^LICEN[CS]E(\..*)?$/i.test(f))
+  const spdx = typeof pkg.license === 'string' ? pkg.license.trim() : ''
+  const spdxOk = /^[A-Za-z0-9.+-]+$/.test(spdx) && !/^(UNLICENSED|SEE LICENSE IN .*|PROPRIETARY)$/i.test(spdx)
+  if (spdxOk && licenseFiles.length) ok('License（SPDX）', `${spdx}，文件：${licenseFiles.join(', ')}`)
+  else if (!spdx && !licenseFiles.length) fail('License（SPDX）', '既没有 package.json 的 license 字段，也没有 LICENSE 文件；dsh.so 要求开源许可证 + 可识别 SPDX（UNLICENSED 不算）')
+  else if (!spdx) fail('License（SPDX）', `有 ${licenseFiles.join(', ')} 但 package.json 缺 license 字段（要写 SPDX id）`)
+  else fail('License（SPDX）', `license 字段是 "${spdx}"，不是可识别的 SPDX 开源标识`)
+
+  // ── dsh.so：可扫描源码 ───────────────────────────────────────────────────
+  const sourceFiles = (await listFiles('.')).filter((f) => SRC_EXT.has(extname(f).toLowerCase()))
+  if (sourceFiles.length >= 3) ok('可扫描源码', `${sourceFiles.length} 个源码/脚本文件（如 ${sourceFiles.slice(0, 3).join(', ')}…）`)
+  else fail('可扫描源码', `只找到 ${sourceFiles.length} 个可扫描文件；docs-only / 空仓库不能提交`)
+
+  // ── dsh-market：安装来源（npm 包名） ─────────────────────────────────────
+  if (typeof pkg.name === 'string' && pkg.name) ok('npm 包名（目录 install 字段）', `${pkg.name}（目录里 npm/version 取自公开 registry）`)
+  else fail('npm 包名', 'package.json 缺 name')
+
+  // ── dsh.so：仓库地址（公开托管 + topic） ──────────────────────────────────
+  const repoUrl = typeof pkg.repository === 'string' ? pkg.repository : pkg.repository?.url
+  if (!repoUrl) {
+    fail('公开仓库地址', 'package.json 缺 repository（dsh.so 只收 GitHub / Gitee / GitLab，且用它同步星数/license/最后提交）')
+  } else {
+    const cleaned = String(repoUrl).replace(/^git\+/, '')
+    const host = (cleaned.match(/^https?:\/\/([^/]+)/) || [])[1] || ''
+    if (PUBLIC_HOSTS.some((h) => host === h || host.endsWith(`.${h}`))) ok('公开仓库地址', `${cleaned}（${host}）`)
+    else fail('公开仓库地址', `${cleaned} 的 host 是 "${host || '未知'}"；dsh.so 只认 GitHub/Gitee/GitLab`)
+  }
+  if (pkg.homepage || pkg.bugs?.url) ok('homepage / bugs', short(pkg.homepage || pkg.bugs.url))
+  else warn('homepage / bugs', '建议补 homepage / bugs（市场卡片与 issue 入口会用到）')
+
+  // ── dsh.so：topic（只能人工在仓库上加，本地无法验证） ────────────────────
+  const topics = Array.isArray(pkg.keywords) ? pkg.keywords.map((k) => String(k).toLowerCase()) : []
+  if (topics.includes('dsh-plugin') || topics.includes('dsh-pack')) ok('keywords 的 dsh-plugin', 'package.json keywords 含 dsh-plugin / dsh-pack')
+  else warn('keywords 的 dsh-plugin', 'package.json keywords 缺 dsh-plugin（同时记得在 GitHub 仓库加 topic `dsh-plugin`，dsh.so 靠它自动索引；这条只能人在仓库里加）')
+
+  // ── dsh-market：双语描述 ─────────────────────────────────────────────────
+  const desc = String(pkg.description || '')
+  // 目录条目需要 en/zh 两条描述；package.json 只有一个 description，至少要求它能当英文文案用
+  //（判定口径：连续 15 个 ASCII 字母/空格/标点，短串像 "Spring Boot" 不算一句英文）
+  if (!desc) fail('描述（en + zh）', 'package.json 缺 description')
+  else if (/[A-Za-z][A-Za-z ,.'’/()-]{15,}/.test(desc)) ok('描述（en + zh）', `package.json description 含英文句子：${short(desc, 80)}`)
+  else warn('描述（en + zh）', `description 只有中文/短英文（${short(desc, 60)}）；目录条目要自己写 en/zh 两条（市场按 UI 语言显示），建议把英文句也写进 README 首段`)
+
+  // ── dsh-market：README 截图（只从 GitHub 托管加载） ──────────────────────
+  const shots = readme ? (readme.match(/!\[[^\]]*\]\(([^)]+)\)/g) || []).length : 0
+  if (shots >= 2) ok('README 截图', `${shots} 张（市场卡片是轮播，仓库托管即可）`)
+  else warn('README 截图', `README 只有 ${shots} 张图；市场卡片需要 2–4 张（侧栏控制台 / 独立窗口 / 调试面板），且必须由 GitHub 托管`)
+
+  // ── 安全扫描启发式（dsh.so 阻断项：硬编码密钥 / 私钥） ───────────────────
+  const scanTargets = sourceFiles.filter((f) => !/client-codemirror\.js$/.test(f)).slice(0, 400)
+  const secretPatterns = [
+    { name: '私钥块', re: /-----BEGIN [A-Z ]*PRIVATE KEY-----/ },
+    { name: 'AWS Access Key', re: /\bAKIA[0-9A-Z]{16}\b/ },
+    { name: 'GitHub token', re: /\bghp_[A-Za-z0-9]{36}\b/ },
+    { name: 'OpenAI 风格 key', re: /\bsk-[A-Za-z0-9]{20,}\b/ },
+    { name: '疑似硬编码口令', re: /\b(?:password|passwd|secret|apiKey|api_key)\s*[:=]\s*['"][^'"\s]{6,}['"]/i },
+  ]
+  const hits = []
+  for (const rel of scanTargets) {
+    const text = await readText(rel)
+    if (!text) continue
+    for (const { name, re } of secretPatterns) {
+      if (re.test(text)) hits.push(`${rel} → ${name}`)
+    }
+  }
+  if (hits.length) warn('安全扫描（硬编码密钥）', `${hits.length} 处命中，提交前逐条确认是否误报：${hits.slice(0, 5).join('；')}`)
+  else ok('安全扫描（硬编码密钥）', `${scanTargets.length} 个文件扫描，无私钥/密钥字面量命中`)
+
+  // ── 能力声明（本插件一定会带的外围能力，提交时会被人工复核） ──────────────
+  ok(
+    '能力边界（人工复核项）',
+    '插件会：启动/停止进程（含杀进程组）、读写工作区文件、读环境变量、注册 agent 工具。dsh.so 扫描会标出 fs-write/env/process，README 需写清用途与围栏（loopback 校验、pidfile 校验、路径限制）',
+  )
+
+  // ── 可选联网核对 ─────────────────────────────────────────────────────────
+  if (NET) {
+    await checkNetwork(pkg, repoUrl)
+  } else {
+    warn('公开可达性（可选）', '跳过联网核对（--net 开启）；内网环境通常不可达，可在有外网的机器上跑')
+  }
+
+  report()
+}
+
+async function head(url) {
+  try {
+    const res = await fetch(url, { method: 'HEAD', redirect: 'follow', signal: AbortSignal.timeout(8000) })
+    return res.ok || res.status === 405
+  } catch {
+    return false
+  }
+}
+
+async function checkNetwork(pkg, repoUrl) {
+  const npmUrl = `https://registry.npmjs.org/${encodeURIComponent(pkg.name).replace('%2F', '/')}`
+  const npmOk = await head(npmUrl)
+  if (npmOk) ok('公开 npm 可达', `${npmUrl} 200`)
+  else fail('公开 npm 可达', `${npmUrl} 不可达：需先发布到公开 npm（只发在内部 registry 的包，市场装不到）`)
+
+  if (repoUrl) {
+    const url = String(repoUrl).replace(/^git\+/, '').replace(/\.git$/, '')
+    const repoOk = await head(url)
+    if (repoOk) ok('公开仓库可达', `${url} 200`)
+    else fail('公开仓库可达', `${url} 不可达或需要登录：dsh.so/dsh-market 都要公开可拉取`)
+  }
+}
+
+function report() {
+  const errors = results.filter((r) => r.level === 'error')
+  const warns = results.filter((r) => r.level === 'warn')
+  const icon = { ok: '✅', warn: '⚠️ ', error: '❌' }
+  if (AS_JSON) {
+    console.log(JSON.stringify({ ok: errors.length === 0, errors: errors.length, warnings: warns.length, results }, null, 2))
+  } else {
+    console.log('\n上架条件自检（dsh-market / dsh.so）· 规则见仓库外插件开发手册\n')
+    for (const r of results) {
+      console.log(`${icon[r.level]} ${r.id}`)
+      if (r.detail) console.log(`   ${r.detail}`)
+    }
+    console.log(`\n合计：${results.length} 项 · ❌ ${errors.length} · ⚠️ ${warns.length}`)
+    if (errors.length) {
+      console.log('\n必须先解决：')
+      for (const r of errors) console.log(`  ❌ ${r.id} — ${r.detail}`)
+    }
+    if (!errors.length) console.log(warns.length && !STRICT ? '\n静态条件里没有阻断项；⚠️ 需要人确认。' : '\n全部通过。')
+  }
+  const failed = errors.length > 0 || (STRICT && warns.length > 0)
+  process.exitCode = failed ? 1 : 0
+}
+
+await main()

package/bin/yds.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+// yds — YonBIP YDS local runtime CLI (dsh-ris-yds). Cross-OS node entry.
+import { run } from '../lib/cli.js'
+
+const argv = process.argv.slice(2)
+try {
+  const result = await run(argv, { cwd: process.cwd() })
+  if (result !== undefined && result.text !== undefined) {
+    process.stdout.write(`${result.text}\n`)
+  }
+  // run() reports failures instead of setting process.exitCode: the same function is
+  // called in-process by the dsh tools, where a leaked exit code would hit the host.
+  if (Number.isInteger(result?.exitCode) && result.exitCode !== 0) {
+    process.exitCode = result.exitCode
+  }
+} catch (error) {
+  process.stderr.write(`yds: ${error.message}\n`)
+  process.exitCode = 1
+}

package/cordis.patch.yml

@@ -0,0 +1,13 @@
+# dsh-ris-yds bundle patch
+#
+# Tools-only plugin: no browser row, no client bundle. The insert below mounts
+# the plugin so its ctx.tools registrations reach the agent session.
+#
+# Install + mount in one step (from anywhere):
+#
+#   dsh plugin --profile web add <path-to-this-dir>
+#
+# The Loader specifier (`name`) MUST equal the package.json `name`.
+- insert:
+    - id: yds
+      name: 'dsh-ris-yds'