redskillhub-upload 1.0.2 → 1.0.3-beta.1

package/README.md

@@ -4,6 +4,8 @@
 
 CLI 负责完整发布链路：登录授权、本地校验、重新打包、上传、参数确认和最终提交。输入可以是 Skill 目录，也可以是 `.zip` 文件。
 
+当前“对话内发布确认与修改”能力仅面向 Beta 验证。本文发布示例都显式使用 `--env beta`；不要将本次改动用于 Prod 发布。
+
 ## 环境要求
 
 - Node.js 18 或更高版本
@@ -14,14 +16,26 @@ CLI 负责完整发布链路：登录授权、本地校验、重新打包、上
 
 ## 安装
 
+Beta 测试安装：
+
 ```bash
-npm install -g redskillhub-upload
+npm install -g redskillhub-upload@beta
 ```
 
+`@beta` 与生产使用的 `@latest` 是两个独立 npm dist-tag。Beta 验收期间不得把测试版本发布到 `latest`；当前包的 `publishConfig.tag` 已固定为 `beta`，避免裸 `npm publish` 误更新生产安装通道。
+
+Beta Apollo 使用固定版本门禁策略：
+
+```bash
+node "<SKILL_DIR>/scripts/ensure-cli.mjs" --env beta --npm-policy beta-first
+```
+
+它会在目标版本更高时优先安装 `@beta`，正式 `@latest` 追平后自动切回正式版。Prod 不使用该策略，始终安装 `@latest`。
+
 确认安装成功：
 
 ```bash
-redskillhub-upload whoami
+redskillhub-upload whoami --env beta
 ```
 
 ## 发布 Skill
@@ -29,19 +43,19 @@ redskillhub-upload whoami
 发布本地目录：
 
 ```bash
-redskillhub-upload publish "/absolute/path/to/skill"
+redskillhub-upload publish "/absolute/path/to/skill" --env beta
 ```
 
 发布 ZIP：
 
 ```bash
-redskillhub-upload publish "/absolute/path/to/skill.zip"
+redskillhub-upload publish "/absolute/path/to/skill.zip" --env beta
 ```
 
 Agent 模式：
 
 ```bash
-redskillhub-upload publish "/absolute/path/to/skill" --agent
+redskillhub-upload publish "/absolute/path/to/skill" --agent --env beta
 ```
 
 `publish` 会自动检查登录状态，无需预先执行 `login` 或 `whoami`。
@@ -59,31 +73,31 @@ CLI 会复用有效的 access token，并在 refresh token 可用时静默续期
 手动登录：
 
 ```bash
-redskillhub-upload login
+redskillhub-upload login --env beta
 ```
 
 Agent 模式登录：
 
 ```bash
-redskillhub-upload login --agent
+redskillhub-upload login --agent --env beta
 ```
 
 取消正在等待的登录：
 
 ```bash
-redskillhub-upload login --cancel
+redskillhub-upload login --cancel --env beta
 ```
 
 查看登录状态：
 
 ```bash
-redskillhub-upload whoami
+redskillhub-upload whoami --env beta
 ```
 
 退出登录：
 
 ```bash
-redskillhub-upload logout
+redskillhub-upload logout --env beta
 ```
 
 ## 发布参数
@@ -91,41 +105,47 @@ redskillhub-upload logout
 查看可用标签：
 
 ```bash
-redskillhub-upload tags
+redskillhub-upload tags --env beta
 ```
 
 指定原创内容和标签：
 
 ```bash
-redskillhub-upload publish "/absolute/path/to/skill" --source original --tag "效率工具,内容创作"
+redskillhub-upload publish "/absolute/path/to/skill" --source original --tag "效率工具,内容创作" --env beta
 ```
 
 转载内容需要提供来源：
 
 ```bash
-redskillhub-upload publish "/absolute/path/to/skill" --source repost --repost-source "来源名称" --tag "内容创作"
+redskillhub-upload publish "/absolute/path/to/skill" --source repost --repost-source "来源名称" --tag "内容创作" --env beta
 ```
 
 只生成并检查待提交数据，不上传或提交：
 
 ```bash
-redskillhub-upload publish "/absolute/path/to/skill" --dry-run --agent --source original --tag "效率工具"
+redskillhub-upload publish "/absolute/path/to/skill" --dry-run --agent --source original --tag "效率工具" --env beta
 ```
 
-真实发布前，CLI 会展示待提交信息并要求明确确认。未收到 `submit` 时不会执行最终提交。
+真实发布前，CLI 会展示名称、Skill ID、版本、描述、Skill 介绍、来源、转载来源、场景标签、打包大小和 SHA-256。卡片后会提示作者可直接提出修改；未收到 `submit` 时不会登录、上传或执行最终提交。
+
+Agent 展示 Skill 介绍时，会把原始 Markdown 全文放在一个显式标记为 `text` 的代码块中。不能省略 `text`，否则聊天渲染器可能自动识别 Markdown 并着色；也不能使用 `markdown/md/yaml`。这样不会渲染标题和段落，所有正文保持统一单色，以贴近平台编辑器中的最终内容。
+
+确认阶段可输入 `edit`，随后逐行输入 `name`、`description`、`version`、`detail`、`identifier`、`tag`、`source` 或 `repost_source` 的 `key=value`，最后输入空行。多行 `detail` 使用 JSON 字符串。所有修改只保存在当前发布会话的提交信息中，不写回本地文件；每次修改后都会展示新的完整确认卡。
+
+目录输入和 zip 输入都保持不变，不会生成 `-updated.zip`。由于 bundle 内容不变，修改提交信息后打包大小和 SHA-256 也保持不变。
 
 ## Windows 示例
 
 PowerShell 和 cmd 中均使用双引号包裹路径：
 
 ```powershell
-redskillhub-upload publish "C:\Users\name\path\to\skill" --agent
+redskillhub-upload publish "C:\Users\name\path\to\skill" --agent --env beta
 ```
 
 向 Agent 模式写入确认指令：
 
 ```powershell
-node -e "process.stdout.write('submit\n')" | redskillhub-upload publish "C:\Users\name\path\to\skill" --agent --source original --tag "效率工具"
+node -e "process.stdout.write('submit\n')" | redskillhub-upload publish "C:\Users\name\path\to\skill" --agent --source original --tag "效率工具" --env beta
 ```
 
 ## Agent 输出协议
@@ -161,5 +181,5 @@ npm pack --dry-run
 执行 dry-run：
 
 ```bash
-node cli/index.mjs publish "/absolute/path/to/skill" --dry-run --agent --source original --tag-id 101,102 --yes
+node cli/index.mjs publish "/absolute/path/to/skill" --dry-run --agent --source original --tag-id 101,102 --env beta
 ```

package/cli/config.mjs

@@ -5,7 +5,7 @@ export const DEFAULT_API_BASE = 'https://edith.xiaohongshu.com';
 export const BETA_API_BASE = 'https://edith-redskill.sl.beta.xiaohongshu.com';
 export const DEFAULT_SCOPES = ['base_info', 'skill_publish'];
 export const DEFAULT_SCOPE = DEFAULT_SCOPES.join(',');
- 
+
 export const PATHS = {
   UPLOAD_TOKEN: '/api/sns/v2/red_skill/upload/permit',
   SUBMIT_SKILL_VERSION: '/api/sns/v1/creator/red_skill/cli_submit_skill_version',

package/cli/index.mjs

@@ -6,6 +6,7 @@ import { ExitCodes, SkillhubUploadError, toResultError } from './errors.mjs';
 import { prepareBundle } from './pack.mjs';
 import {
   applyConfirmEdit,
+  buildConfirmationCard,
   buildDraftPayload,
   formatContentTagOptions,
   submitSkillVersion
@@ -64,17 +65,6 @@ function buildValidatedDraftPayload(input) {
   }
 }
 
-function wrapLocalValidation(error) {
-  if (error instanceof SkillhubUploadError) {
-    return error;
-  }
-  return new SkillhubUploadError(
-    'LOCAL_VALIDATION_FAILED',
-    error?.message || String(error),
-    ExitCodes.LOCAL_VALIDATION
-  );
-}
-
 function assertUsableCredentials(credentials, nowMs = Date.now()) {
   if (!credentials?.accessToken) {
     throw new SkillhubUploadError('NEED_LOGIN', '请先执行 redskillhub-upload login', ExitCodes.NEED_LOGIN);
@@ -117,18 +107,27 @@ export async function ensurePublishCredentials({
   return credentials;
 }
 
-async function confirmBeforeSubmit(payload, io = {}, { tagOptions } = {}) {
-  let current = payload;
+async function confirmBeforeSubmit(payload, bundle, io = {}, options = {}) {
+  const { tagOptions, showConfirmationCard = false } = options;
+  let currentPayload = payload;
   while (true) {
-    const answer = await confirmAgent(current, io);
+    const answer = await confirmAgent(currentPayload, io, {
+      card: showConfirmationCard ? buildConfirmationCard(currentPayload, tagOptions) : undefined
+    });
     if (answer.action === 'submit') {
-      return current;
+      return { payload: currentPayload, bundle };
     }
     if (answer.action === 'edit') {
       try {
-        current = applyConfirmEdit(current, answer.values || {}, { tagOptions });
+        currentPayload = applyConfirmEdit(currentPayload, answer.values || {}, { tagOptions });
       } catch (error) {
-        throw wrapLocalValidation(error);
+        throw error instanceof SkillhubUploadError
+          ? error
+          : new SkillhubUploadError(
+            'LOCAL_VALIDATION_FAILED',
+            error?.message || String(error),
+            ExitCodes.LOCAL_VALIDATION
+          );
       }
       continue;
     }
@@ -187,8 +186,9 @@ export async function main(argv = process.argv.slice(2), env = process.env, io =
       ExitCodes.INVALID_ARGS
     );
   }
+  let apiEnvironment;
   try {
-    resolveApiEnvironment(flags);
+    apiEnvironment = resolveApiEnvironment(flags);
   } catch (error) {
     throw new SkillhubUploadError('INVALID_ARGS', error.message, ExitCodes.INVALID_ARGS);
   }
@@ -239,7 +239,7 @@ export async function main(argv = process.argv.slice(2), env = process.env, io =
 
     const dryRun = Boolean(flags.dryRun);
     let credentials = null;
-    if (!dryRun) {
+    if (!dryRun && apiEnvironment !== 'beta') {
       const { readCredentials, login } = await import('./auth.mjs');
       credentials = await ensurePublishCredentials({
         flags,
@@ -250,7 +250,6 @@ export async function main(argv = process.argv.slice(2), env = process.env, io =
         login
       });
     }
-
     const bundle = await prepareBundle(pathArg, { env, flags });
     const bundleMetadata = {
       bundleSha256: bundle.bundleSha256,
@@ -277,17 +276,40 @@ export async function main(argv = process.argv.slice(2), env = process.env, io =
 
       if (dryRun) {
         const upload = await uploadBundle(bundle, { dryRun: true });
-        writeResult({ status: 'dry_run', payload: attachUploadResult(draftPayload, upload) }, out);
+        const payload = attachUploadResult(draftPayload, upload);
+        const result = {
+          status: 'dry_run',
+          payload
+        };
+        if (apiEnvironment === 'beta') {
+          result.confirmationCard = buildConfirmationCard(payload, tagOptions);
+        }
+        writeResult(result, out);
         return;
       }
 
-      const confirmedPayload = await confirmBeforeSubmit(draftPayload, promptSession, { tagOptions });
-      if (!confirmedPayload) {
+      const confirmed = await confirmBeforeSubmit(draftPayload, bundle, promptSession, {
+        tagOptions,
+        showConfirmationCard: apiEnvironment === 'beta'
+      });
+      if (!confirmed) {
         writeResult({ status: 'cancelled' }, out);
         return;
       }
 
-      const upload = await uploadBundle(bundle, {
+      if (!credentials) {
+        const { readCredentials, login } = await import('./auth.mjs');
+        credentials = await ensurePublishCredentials({
+          flags,
+          env,
+          io: { ...io, out },
+          nowMs: io.now ? io.now() : Date.now(),
+          readCredentials,
+          login
+        });
+      }
+
+      const upload = await uploadBundle(confirmed.bundle, {
         dryRun: false,
         flags: publishFlags,
         accessToken: credentials.accessToken,
@@ -297,7 +319,7 @@ export async function main(argv = process.argv.slice(2), env = process.env, io =
         progressStream: io.progressStream || out,
         env
       });
-      const submitted = await submitSkillVersion(attachUploadResult(confirmedPayload, upload), {
+      const submitted = await submitSkillVersion(attachUploadResult(confirmed.payload, upload), {
         flags: publishFlags,
         accessToken: credentials.accessToken,
         fetchImpl: io.fetchImpl,

package/cli/pack.mjs

@@ -506,5 +506,5 @@ export async function prepareBundle(inputPath, options = {}) {
     );
   }
 
-  return await buildBundle(source, env, flags);
+  return buildBundle(source, env, flags);
 }

package/cli/prompt.mjs

@@ -10,6 +10,31 @@ async function readLine(iterator) {
   return next.done ? '' : String(next.value).trim();
 }
 
+function parseEditValue(rawValue, line) {
+  const value = rawValue.trim();
+  if (!value.startsWith('"')) {
+    return value;
+  }
+  try {
+    return JSON.parse(value);
+  } catch {
+    throw new Error(`确认信息修改格式不正确，JSON 字符串无法解析：${line}`);
+  }
+}
+
+function parseEditLine(line) {
+  const idx = line.indexOf('=');
+  if (idx < 0) {
+    throw new Error(`确认信息修改格式不正确，请使用 key=value 格式：${line}`);
+  }
+
+  const key = line.slice(0, idx).trim();
+  if (!key) {
+    throw new Error(`确认信息修改格式不正确，请使用 key=value 格式：${line}`);
+  }
+  return [key, parseEditValue(line.slice(idx + 1), line)];
+}
+
 export function createPromptSession(io = {}) {
   const input = io.input || process.stdin;
   const out = io.out || process.stdout;
@@ -40,10 +65,10 @@ export async function askAgent(prompt, io = {}) {
   }
 }
 
-export async function confirmAgent(payload, io = {}) {
+export async function confirmAgent(payload, io = {}, options = {}) {
   const input = io.input || process.stdin;
   const out = io.out || process.stdout;
-  writePrompt({ type: 'confirm', payload }, out);
+  writePrompt({ type: 'confirm', payload, card: options.card }, out);
 
   if (io.readLine) {
     const first = await io.readLine();
@@ -61,16 +86,8 @@ export async function confirmAgent(payload, io = {}) {
           break;
         }
 
-        const idx = trimmed.indexOf('=');
-        if (idx < 0) {
-          throw new Error(`确认信息修改格式不正确，请使用 key=value 格式：${trimmed}`);
-        }
-
-        const key = trimmed.slice(0, idx).trim();
-        if (!key) {
-          throw new Error(`确认信息修改格式不正确，请使用 key=value 格式：${trimmed}`);
-        }
-        values[key] = trimmed.slice(idx + 1).trim();
+        const [key, value] = parseEditLine(trimmed);
+        values[key] = value;
       }
       return { action: 'edit', values };
     }
@@ -95,16 +112,8 @@ export async function confirmAgent(payload, io = {}) {
           break;
         }
 
-        const idx = trimmed.indexOf('=');
-        if (idx < 0) {
-          throw new Error(`确认信息修改格式不正确，请使用 key=value 格式：${trimmed}`);
-        }
-
-        const key = trimmed.slice(0, idx).trim();
-        if (!key) {
-          throw new Error(`确认信息修改格式不正确，请使用 key=value 格式：${trimmed}`);
-        }
-        values[key] = trimmed.slice(idx + 1).trim();
+        const [key, value] = parseEditLine(trimmed);
+        values[key] = value;
       }
       return { action: 'edit', values };
     }

package/cli/submit.mjs

@@ -5,7 +5,16 @@ import { compatibleFetch } from './fetch.mjs';
 import { redactMessage } from './redact.mjs';
 import { FALLBACK_CONTENT_TAGS } from './tags.mjs';
 
-const EDITABLE_FIELDS = new Set(['name', 'identifier', 'version', 'description', 'detail', 'tag']);
+const EDITABLE_FIELDS = new Set([
+  'name',
+  'identifier',
+  'version',
+  'description',
+  'detail',
+  'tag',
+  'source',
+  'repost_source'
+]);
 const VALID_SOURCES = new Set(['original', 'repost']);
 const SENSITIVE_PAYLOAD_FIELDS = new Set([
   'access_token',
@@ -47,6 +56,28 @@ export function formatContentTagOptions(tagOptions = FALLBACK_CONTENT_TAGS) {
   return tagOptions.map((tag) => tag.name).join(' / ');
 }
 
+export function buildConfirmationCard(payload, tagOptions = FALLBACK_CONTENT_TAGS) {
+  const contentTags = (payload.content_tag_ids || []).map((tagId) => {
+    const matched = tagOptions.find((tag) => String(tag.tagId) === String(tagId));
+    return {
+      tagId: String(tagId),
+      name: matched?.name || String(tagId)
+    };
+  });
+  return {
+    skillName: payload.name || '',
+    skillId: payload.skill_identifier || '',
+    version: payload.version || '',
+    description: payload.description || '',
+    skillIntroduction: payload.skill_md_content || '',
+    original: payload.original,
+    repostSource: payload.repost_source || '',
+    contentTags,
+    bundleSizeBytes: payload.bundle_size_bytes,
+    bundleSha256: payload.bundle_sha256 || ''
+  };
+}
+
 function resolveTagIds(flags, tagOptions = FALLBACK_CONTENT_TAGS) {
   const rawTagId = flags.tagId ?? flags['tag-id'] ?? flags.tag;
   const rawTags = splitTagValues(rawTagId);
@@ -137,6 +168,19 @@ export function applyConfirmEdit(payload, values, { tagOptions = FALLBACK_CONTEN
     }
   }
 
+  const hasSourceEdit = Object.prototype.hasOwnProperty.call(values, 'source');
+  const hasRepostSourceEdit = Object.prototype.hasOwnProperty.call(values, 'repost_source');
+  let sourceFields = {};
+  if (hasSourceEdit || hasRepostSourceEdit) {
+    const source = hasSourceEdit
+      ? values.source
+      : payload.original === false ? 'repost' : 'original';
+    sourceFields = resolveSourceFields({
+      source,
+      repostSource: hasRepostSourceEdit ? values.repost_source : payload.repost_source
+    });
+  }
+
   return {
     ...payload,
     skill_identifier: values.identifier || payload.skill_identifier,
@@ -144,7 +188,8 @@ export function applyConfirmEdit(payload, values, { tagOptions = FALLBACK_CONTEN
     name: values.name || payload.name,
     description: values.description || payload.description,
     skill_md_content: values.detail || payload.skill_md_content,
-    content_tag_ids: values.tag ? resolveTagIds({ tag: values.tag }, tagOptions) : payload.content_tag_ids
+    content_tag_ids: values.tag ? resolveTagIds({ tag: values.tag }, tagOptions) : payload.content_tag_ids,
+    ...sourceFields
   };
 }
 

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "redskillhub-upload",
-  "version": "1.0.2",
+  "version": "1.0.3-beta.1",
   "type": "module",
   "publishConfig": {
     "access": "public",
-    "registry": "https://registry.npmjs.org/"
+    "registry": "https://registry.npmjs.org/",
+    "tag": "beta"
   },
   "bin": {
     "redskillhub-upload": "cli/index.mjs"
@@ -16,7 +17,7 @@
   ],
   "scripts": {
     "test": "node --test test/*.test.mjs",
-    "dry-run": "node cli/index.mjs publish test/fixtures/minimal-skill --dry-run --agent --yes"
+    "dry-run": "node cli/index.mjs publish test/fixtures/minimal-skill --dry-run --agent --source original --tag-id 1001 --env beta"
   },
   "dependencies": {
     "adm-zip": "^0.5.16",

package/skill/SKILL.md

@@ -1,149 +1,169 @@
 ---
 name: redskillhub-upload
-description: 当用户要求安装或更新 redskillhub-upload、按照 upload.md 将本地 Skill 上传到小红书 SkillHub，或要求检查 CLI 版本、登录授权、取消登录时使用。固定使用 1.0 版本线中补丁号 z 最新的 CLI，完成安装更新、二维码授权、打包、上传、确认和提交。
+description: 当用户要求在 Beta 环境按照 upload.md 将本地 Skill 上传到小红书 SkillHub，或要求检查 CLI 版本、登录授权、取消登录时使用。发布前必须在对话内展示完整确认卡；修改只更新本次提交信息，不改本地文件；只有用户明确确认后才提交。
 ---
 
-# redskillhub-upload
+# redskillhub-upload（Beta）
 
-## 运行环境
+## 环境硬门禁
 
-所有 CLI 命令都必须显式带上同一个环境参数：生产环境用 `--env prod`（也是 CLI 默认值），测试环境用 `--env beta`。用户未指定时选择 `prod`；用户明确说 beta、测试环境或联调环境时选择 `beta`。确定后记为 `<ENV>`，本次流程中的标签、dry-run、真实 publish、login、whoami、logout 和取消等待命令均追加 `--env <ENV>`，不得混用。beta 业务接口由 CLI 自动选择 `https://edith.beta.xiaohongshu.com`，Agent 不自行传 `--api-base`。
+本需求当前只开放 **Beta 环境**。本流程的每一条 CLI 命令都必须显式追加 `--env beta`，禁止省略，禁止使用 `--env prod`，也不要通过 `--api-base` 绕过环境选择。
 
-CLI 按环境隔离本地状态：prod 保留在 `~/.skillhub-upload`，beta 存放在其 `beta` 子目录。凭证、待授权状态、二维码、标签缓存和临时包不会跨环境复用。设置 `SKILLHUB_UPLOAD_HOME` 时，该路径作为环境目录的共同根目录。
+Beta 凭证、待授权状态、二维码、标签缓存和临时包位于 `~/.skillhub-upload/beta`，不得与 Prod 状态混用。
 
 ## 操作系统兼容
 
-本 Skill 必须同时支持 macOS 和 Windows。执行前通过 Node.js 判断系统，不依赖 `uname`：
+执行前通过 Node.js 判断系统，不依赖 `uname`：
 
 ```bash
 node -p "process.platform"
 ```
 
-- 输出 `darwin`：按 macOS 处理，路径形如 `/Users/name/path/to/skill`。
-- 输出 `win32`：按 Windows 处理，优先使用 PowerShell，路径形如 `C:\Users\name\path\to\skill`。
-- 所有传给 CLI 的本地路径都使用双引号包裹，兼容空格和中文。
-- 命令必须写成单行，不使用 Bash 的 `\` 续行、`printf`、`export`，也不使用 PowerShell 反引号续行或 `$env:`。
-- 需要向 stdin 写入确认值时，统一使用 `node -e "process.stdout.write('submit\n')"` 或 `node -e "process.stdout.write('cancel\n')"`，不要按系统拼两套管道命令。
+- `darwin` 和 `win32` 都受支持。
+- 所有本地路径使用双引号包裹，兼容空格和中文。
+- 命令写成单行，不使用 shell 专属续行语法。
+- 不由 Agent 解压、过滤或重新打包 zip；这些操作全部交给 CLI。
 
 ## CLI 版本门禁
 
-在执行任何 `redskillhub-upload` 命令前，先从本 Skill 目录执行：
+执行任何发布相关命令前，从本 Skill 目录运行：
 
 ```bash
-node "<SKILL_DIR>/scripts/ensure-cli.mjs" --env <ENV>
+node "<SKILL_DIR>/scripts/ensure-cli.mjs" --env beta
 ```
 
-`<SKILL_DIR>` 是包含本文件的目录，执行前替换为其绝对路径。
+`--env beta` 只决定 Beta 接口和凭证，不决定 npm 包版本。npm 默认安装 `latest` tag 指向的 `1.0.z` 正式版本。可信的外层 Beta 测试口令应把上述命令替换为固定的自动择优策略：
 
-脚本固定 `x=1`、`y=0`，查询 npm 后选择最大的兼容版本：存在正式版时只选最大的 `1.0.z`；尚无正式版时才选择同一版本线的最新预发布版。脚本会检查全局安装状态，按需安装或升级，并用 `redskillhub-upload whoami --env <ENV>` 验证命令。
-
-- 读取 `CLI_VERSION_JSON`；`status=current|installed|updated` 才继续。
-- `status=error` 时如实告诉用户并停止，不得改用其他 major/minor、不得静默安装本地源码、不得使用 `sudo`。
-- 不要在 Agent 中重写版本比较逻辑；以 `scripts/ensure-cli.mjs` 为唯一实现。
+```bash
+node "<SKILL_DIR>/scripts/ensure-cli.mjs" --env beta --npm-policy beta-first
+```
 
-## 目标流程
+该策略同时读取 `latest` 和 `beta`：仅当 `beta` 对应的目标正式版本高于当前 `latest` 时安装预发布版；正式版追平或超过预发布版后自动回到 `latest`；没有 `beta` tag 时也使用 `latest`。`--npm-policy beta-first` 只允许搭配 `--env beta`，Prod 禁止使用。不得根据 `--env beta` 自行推断使用预发布包。读取 `CLI_VERSION_JSON`；只有 `status=current|installed|updated` 才继续。失败时如实告知用户并停止，不改用其他版本线、不使用本地源码替代、不使用 `sudo`。
 
-1. 回复用户：收到。我会在电脑上读取 upload.md 说明，检查 Red Skill CLI 和本地 Skill。
-2. 执行「CLI 版本门禁」，确保 PATH 中的 `redskillhub-upload` 是允许版本线内的最新包。
-3. 查找用户给出的本地 Skill 目录或 `.zip` 源包。用户只给名称时，先在当前工作区和常见目录查找唯一匹配目录；找不到或多匹配时询问用户绝对路径。zip 只能作为 CLI 输入源包，不能由 agent 解压或代替 CLI 重新打包。
-4. 直接执行下面的「publish 子流程」，不要预先调用 `whoami` 或 `login`。真实 `publish` 会自动复用或刷新已有凭证；首次登录或 refresh token 失效时，会在同一进程中输出授权 `PROMPT`，授权成功后原地继续发布。
-5. 遇到授权 `PROMPT` 时，必须按以下顺序展示：先提示用户使用小红书 App 扫码，再把 `prompt.qrCodePath` 的本地 PNG 展示或发送给用户，最后才提供手机浏览器兜底链接。文字链接使用 `prompt.authorizeH5Url`（兼容字段 `prompt.authorizeUrl` 也是同一 H5 URL）。二维码由 CLI 使用接口的 `authorize_common_url` 生成，Agent 不得自行换字段或重新编码。授权内容必须照抄模板，只替换 `<QR_CODE_IMAGE>`、`<AUTH_URL>`、`<USER_CODE>`、`<MINUTES>`，不增删措辞；不得在二维码之前引导用户打开链接。
+## 发布流程
 
-````markdown
-请使用小红书 App 扫描下面的二维码完成授权：
+### 1. 定位输入并收集会话参数
 
-<QR_CODE_IMAGE>
+输入可以是本地 Skill 目录或 `.zip` 文件。用户只给名称时，在当前工作区和常见目录定位唯一匹配；找不到或多匹配时询问绝对路径。
 
-如果无法扫码，请使用手机自带浏览器打开下面的授权链接，打开后会自动跳转到小红书 App 完成授权：
+先查询 Beta 标签：
 
-```
-<AUTH_URL>
+```bash
+redskillhub-upload tags --env beta
 ```
 
-授权码：<USER_CODE>
-有效期：<MINUTES> 分钟
+从 `RESULT_JSON.tags` 取得中文标签后，必须沿用线上现有交互，一次性按下面的固定结构询问。只替换 `<标签列表>` 和 `<absolute-path>`，不得压缩、省略或改写转载来源提示：
 
-我会继续等待 CLI 自动完成授权。如果你已经在手机上完成授权但我没有自动响应，你再回复「好了」。
-````
+```text
+CLI 版本门禁已通过，实时标签已获取。请一次回复：
 
-6. 正常情况下等待 CLI 轮询完成并在同一 `publish` 进程中自动继续。用户回复”好了”只是兜底唤醒：仅当 CLI 轮询已完成但 agent 没有恢复时使用；进程中断或状态丢失时，重新执行原 `publish` 命令，CLI 会自动从磁盘恢复未完成的授权状态，无需用户重新打开授权链接。
-   用户明确要求取消登录等待时，执行 `redskillhub-upload login --cancel --env <ENV>`；不要仅终止当前 shell，因为取消命令还会清理待授权状态和二维码。
-7. 所有发布字段值取自用户当前会话答复，不要从 SKILL.md / 目录名 / 文件结构 / 上下文对话推断。
-8. publish 子流程结束后，把 `RESULT_JSON` 的成功结果、失败原因或取消状态如实转述给用户。
+1. source：原创 或 转载
+2. tag：可多选，用逗号分隔
 
-## publish 子流程
+可选标签：<标签列表>。
 
-固定 4 步，按顺序执行；步骤 1 用 AskUserQuestion 一次性收齐参数，步骤 2 把参数全部以 CLI flag 传入，步骤 3 仅通过跨平台 Node 管道写入提交或取消指令。
+例如：原创；编程开发、学习成长
 
-### Step 1 — 一次性收齐 publish 参数
+若选择转载，还请附上不超过 15 个字符的转载来源。待上传目录为 <absolute-path>。
+```
+
+用户选择转载但没有提供来源时，再单独追问 `repost_source`；选择原创时不追问。
 
-(a) 通过已安装的 CLI 拉一次当前环境标签列表，命令：
+### 2. 启动发布会话并展示确认卡
+
+直接启动真实 publish，但保持进程等待输入；不要预先执行 login，也不要提前向 stdin 写入 submit：
 
 ```bash
-redskillhub-upload tags --env <ENV>
+redskillhub-upload publish "<absolute-path>" --agent --source <original-or-repost> --tag "<中文标签名[,中文标签名...]>" [--repost-source "<来源名>"] --env beta
 ```
 
-读取 `RESULT_JSON.tags` 中的 `name` 和 `tagId`。命令失败时如实报告并停止，不直接 curl 内部接口、不导入仓库源码，也**不硬编码标签清单**。
+CLI 会先在本地解析、执行安全校验并打包，然后输出 `PROMPT.type=confirm`。此时尚未上传，也未调用 submit。
 
-(b) 用 AskUserQuestion 一次发两题：
+必须把 `PROMPT.card` 完整回显为确认卡，不得省略字段：
 
-- 「source：原创 / 转载」二选一
-- 「tag：&lt;上一步拉到的中文名数组&gt;」多选，用户可选一个或多个
+- Skill 名称：`skillName`
+- Skill ID：`skillId`
+- 版本：`version`
+- 简介：`description`
+- Skill 介绍：`skillIntroduction`
+- 来源：`original=true` 显示“原创”，`original=false` 显示“转载”
+- 转载来源：`repostSource`，原创时显示“无”
+- 场景标签：`contentTags[].name`
+- 打包大小：`bundleSizeBytes` bytes
+- SHA-256：`bundleSha256`
 
-(c) 用户 source 选 `转载` 才追问 `repost_source`（自由文本，最多 15 字符）；选 `原创` 直接跳过。
+Skill 介绍的展示方式必须与平台编辑器尽量一致，首次确认和每轮修改后的确认卡都遵守以下规则：
 
-### Step 2 — dry-run 出待提交载荷给用户审阅
+- 在“Skill 介绍：”后，把 `skillIntroduction` 全文原样放进一个显式标记为 `text` 的围栏代码块；不得省略 `text` 标记，避免聊天渲染器自动猜测为 Markdown 并着色。
+- 外层围栏的反引号数量必须多于正文中最长的连续反引号；正文含三个反引号时，外层至少使用四个，并在起始围栏后紧跟 `text`，确保内部 Markdown 围栏仍在同一个展示块内。
+- 不得把 Skill 介绍渲染成聊天标题、段落、列表或多个代码块。
+- 不得使用 `markdown`、`md`、`yaml` 等会触发语法高亮的标记，只能使用 `text`。
+- 所有正文字符使用代码块统一的字号、字重和颜色；`#`、`##`、`**` 等 Markdown 标记只能作为普通原始字符显示，不能产生标题字号或粗体差异。
+- 不改写、不美化、不截断正文；用户看到的原始 Markdown 必须与当前待提交的 `skill_md_content` 一致。
 
-```bash
-redskillhub-upload publish "<absolute-path>" --dry-run --agent --source <original-or-repost> --tag "<中文标签名[,中文标签名...]>" [--repost-source "<来源名>"] --env <ENV>
-```
+确认卡后必须直接提示：作者如需修改，可告诉 Agent 要修改的字段和新内容，修改后会重新展示完整确认卡；如无需修改，明确回复“确认”“提交”或 `submit`；如需终止，回复“取消”。不要等用户追问“可以修改吗”才说明。
 
-读 `RESULT_JSON.payload`，把关键字段摘出来给用户看：`name`、Skill ID（payload 字段 `skill_identifier`）、`version`、`description`、`original`、`repost_source`、`content_tag_ids`。标签字段展示**中文名列表**，不要只甩 `tagId`。
+如果进程或对话会话失效，重新运行原 publish 命令、重新解析并回显完整确认卡；不得沿用一张失效卡直接提交。
 
-**Skill ID 派生失败的兜底**：如果 dry-run 抛 `Skill ID 为空，无法从名称...或目录名...自动生成，请输入 Skill ID` 错误（名称和目录名都派生不出合法 kebab-case），按以下顺序处理：
+### 3. 在同一会话中修改
 
-1. 基于 skill 的 `name` / `description` 语义推一个 kebab-case Skill ID（如「微信读书」→ `weread`，「飞书文档助手」→ `feishu-docs`）
-2. 用 `AskUserQuestion` 给用户「采纳推荐 `<推荐值>` / 自定义其他名字」两个选项
-3. 必须告知用户：**Skill ID 是平台上的 skill 主键，提交后跨版本不可改名**，请慎重
-4. 拿到最终 Skill ID 后追加 `--identifier <值>` 重跑 Step 2
+用户提出修改时，只向当前 publish 进程写入一次 `edit` 块；不要由 Agent 直接编辑文件：
 
-### Step 3 — 用户明确说「提交 / 确认 / submit」后真实提交
+```text
+edit
+name=<新名称>
+description=<新简介>
+version=<新版本号>
+detail=<新的 Skill 介绍；多行内容使用 JSON 字符串>
+identifier=<新的 Skill ID>
+tag=<中文标签名[,中文标签名...]>
+source=<original|repost>
+repost_source=<转载来源>
 
-```bash
-node -e "process.stdout.write('submit\n')" | redskillhub-upload publish "<absolute-path>" --agent --source <original-or-repost> --tag "<中文标签名[,中文标签名...]>" [--repost-source "<来源名>"] --env <ENV>
 ```
 
-不要带 `--yes`，让 CLI 进 confirm 阶段；`submit\n` 从 stdin 推给它即可。用户说「取消 / cancel」就把输入命令换成 `node -e "process.stdout.write('cancel\n')"`。用户回复「好了」不能当成提交触发词。
+只发送用户明确要求修改的键。用户改为转载但未提供转载来源时，先在对话中追问，收齐后把 `source` 和 `repost_source` 放在同一个 edit 块中。多行 Skill 介绍必须编码为 JSON 字符串，例如 `detail="# 标题\n\n正文"`。
 
-该命令会自动检查并恢复登录：凭证有效时直接发布，access token 过期时尝试静默刷新，必须重新授权时输出设备码 `PROMPT`；授权成功后仍由当前进程继续上传和提交，不要另起 `login` 命令。
+- `name`、`description`、`version`、`detail`、`identifier`、`tag`、`source`、`repost_source`：所有修改字段只更新本次发布会话参数。
+- 不得修改本地 `SKILL.md/skill.md` 或原 zip，也不会生成 `-updated.zip`。
+- 其他键禁止修改。
 
-### Step 4 — 转述结果
+每次 edit 后，CLI 都会基于最新提交信息输出新的 `PROMPT.type=confirm`。每次都要重新展示完整确认卡，不能只展示差异。bundle 没有变化，因此打包大小和 SHA-256 保持不变。
 
-把最终 `RESULT_JSON` 的 `status`（submitted / cancelled / error）+ 关键回执（`skillId` 或错误码 + 文案）发给用户。
+### 4. 明确确认或取消
 
-## CLI 调用约定
+只有用户明确回复“确认”“提交”或“submit”时，才向仍在等待的同一进程写入：
 
-本 skill 只负责把聊天请求翻译成 CLI 调用，不复制打包、上传、提交逻辑。
-上传入口接受本地 skill 目录或 `.zip` 源包；zip 必须由 CLI 在本地解包、过滤、校验并重新生成上传包，不能由 agent 直接上传或改包。
+```text
+submit
+```
 
-```bash
-redskillhub-upload publish "<absolute-path-to-skill>" --agent --env <ENV>
-redskillhub-upload publish "<absolute-path-to-skill.zip>" --agent --env <ENV>
+任何近义表达、用户回复“好了”或授权完成都不能当作提交确认。
+
+用户回复“取消”或“cancel”时写入：
+
+```text
+cancel
 ```
 
-`redskillhub-upload whoami --env <ENV>`、`redskillhub-upload login --agent --env <ENV>`、`redskillhub-upload login --cancel --env <ENV>` 仅用于诊断、显式预登录或取消等待，不属于标准发布前置步骤。
+取消后应得到 `RESULT_JSON.status=cancelled`；此路径不得上传、不得调用 submit、不得创建 Version 或审核单。
+
+### 5. 授权与结果
 
-本地验证可使用 dry-run。标签可直接传一个或多个中文名（CLI 内部完成 name→id 映射，多个用逗号分隔），也允许调试时传数字 id：
+CLI 只会在明确 submit 之后检查或恢复登录。需要授权时，按 `PROMPT.type=auth_device_code` 先展示二维码，再提供手机浏览器兜底链接。二维码路径 `qrCodePath` 必须作为图片发给用户，不能只显示路径。
+
+用户要求取消登录等待时执行：
 
 ```bash
-node cli/index.mjs publish "test/fixtures/minimal-skill" --dry-run --agent --source original --tag "效率工具,内容创作" --yes --env beta
-# 或调试用：--tag-id 1001,1002
+redskillhub-upload login --cancel --env beta
 ```
 
+最终如实转述 `RESULT_JSON` 的 `submitted / cancelled / error` 状态及关键回执。不得访问或修改 Prod，不得执行 npm publish、部署或远端提交。
+
 ## 禁止事项
 
-- 不自行拼授权链接。
-- 不要求用户复制 token、cookie 或 authorization code。
-- 不展示 access token / refresh token。
-- 不代替用户或 CLI 解压、过滤、zip/tar 打包；只把本地 skill 目录或 `.zip` 源包交给 CLI。
-- 不使用浏览器自动化或 `/tmp/skillhub-*` 信号文件。
+- 用户明确确认前，禁止上传 bundle、禁止调用 submit。
+- 不自行拼授权链接，不要求用户复制 token、cookie 或 authorization code。
+- 不显示 access token / refresh token。
+- 不修改本地 SKILL.md 或 zip；所有确认阶段修改只写入等待中的 CLI 会话。
+- 不使用浏览器自动化或临时信号文件绕过确认门禁。

package/skill/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "Red SkillHub 上传"
-  short_description: "安装最新兼容 CLI 并发布本地 Skill 到 SkillHub"
-  default_prompt: "使用 $redskillhub-upload 检查并安装 1.0 版本线的最新 CLI，然后将我指定的本地 Skill 发布到小红书 SkillHub。"
+  short_description: "在 Beta 对话中确认、修改并发布本地 Skill"
+  default_prompt: "使用 $redskillhub-upload 在 Beta 环境解析我的本地 Skill，展示含 Skill 介绍的完整确认卡并提示我可修改；修改只更新提交信息，只有我明确确认后才提交。"

package/skill/scripts/ensure-cli.mjs

@@ -8,6 +8,9 @@ const COMMAND_NAME = 'redskillhub-upload';
 const REGISTRY = 'https://registry.npmjs.org/';
 const REQUIRED_MAJOR = 1;
 const REQUIRED_MINOR = 0;
+const BETA_RELEASE_TAG = 'beta';
+const PROD_RELEASE_TAG = 'latest';
+const BETA_FIRST_POLICY = 'beta-first';
 
 function parseVersion(version) {
   const match = String(version).match(/^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/);
@@ -21,49 +24,6 @@ function parseVersion(version) {
   };
 }
 
-function comparePrerelease(a, b) {
-  if (!a && !b) return 0;
-  if (!a) return 1;
-  if (!b) return -1;
-  const left = a.split('.');
-  const right = b.split('.');
-  const length = Math.max(left.length, right.length);
-  for (let index = 0; index < length; index += 1) {
-    if (left[index] === undefined) return -1;
-    if (right[index] === undefined) return 1;
-    const leftNumber = /^\d+$/.test(left[index]) ? Number(left[index]) : null;
-    const rightNumber = /^\d+$/.test(right[index]) ? Number(right[index]) : null;
-    if (leftNumber !== null && rightNumber !== null && leftNumber !== rightNumber) {
-      return leftNumber - rightNumber;
-    }
-    if (leftNumber !== null && rightNumber === null) return -1;
-    if (leftNumber === null && rightNumber !== null) return 1;
-    const compared = left[index].localeCompare(right[index]);
-    if (compared) return compared;
-  }
-  return 0;
-}
-
-function compareVersions(a, b) {
-  if (a.patch !== b.patch) return a.patch - b.patch;
-  return comparePrerelease(a.prerelease, b.prerelease);
-}
-
-export function selectLatestCompatibleVersion(versions, options = {}) {
-  const major = options.major ?? REQUIRED_MAJOR;
-  const minor = options.minor ?? REQUIRED_MINOR;
-  const compatible = versions
-    .map(parseVersion)
-    .filter((version) => version && version.major === major && version.minor === minor);
-  if (!compatible.length) {
-    throw new Error(`npm 中没有找到 ${major}.${minor} 版本线的 ${PACKAGE_NAME}`);
-  }
-  const stable = compatible.filter((version) => !version.prerelease);
-  const candidates = stable.length ? stable : compatible;
-  candidates.sort(compareVersions);
-  return candidates.at(-1).raw;
-}
-
 export function shouldUseSystemShell(platform = process.platform) {
   return platform === 'win32';
 }
@@ -83,16 +43,18 @@ function run(command, args, options = {}) {
   return result;
 }
 
-function queryVersions() {
+function queryTaggedVersion(tag, options = {}) {
   const result = run('npm', [
     'view',
-    PACKAGE_NAME,
-    'versions',
+    `${PACKAGE_NAME}@${tag}`,
+    'version',
     '--json',
     `--registry=${REGISTRY}`
-  ], { capture: true });
-  const versions = JSON.parse(result.stdout);
-  return Array.isArray(versions) ? versions : [versions];
+  ], { capture: true, allowFailure: options.optional });
+  if (result.status !== 0 && options.optional) return '';
+  const version = JSON.parse(result.stdout);
+  if (Array.isArray(version)) return version.at(-1) || '';
+  return String(version || '');
 }
 
 function readInstalledVersion() {
@@ -127,9 +89,73 @@ export function normalizeCliEnvironment(value = 'prod') {
   return envName;
 }
 
+export function normalizeNpmTag(value = PROD_RELEASE_TAG) {
+  const tag = String(value).trim().toLowerCase();
+  if (tag !== BETA_RELEASE_TAG && tag !== PROD_RELEASE_TAG) {
+    throw new Error(`--npm-tag 仅支持 beta 或 latest，当前值：${value}`);
+  }
+  return tag;
+}
+
+export function resolveCliRelease(npmTag, version) {
+  const tag = normalizeNpmTag(npmTag);
+  const parsed = parseVersion(version);
+  if (!parsed || parsed.major !== REQUIRED_MAJOR || parsed.minor !== REQUIRED_MINOR) {
+    throw new Error(`${tag} tag 仅支持 ${REQUIRED_MAJOR}.${REQUIRED_MINOR} 版本线，当前值：${version || '缺失'}`);
+  }
+  if (tag === BETA_RELEASE_TAG && !parsed.prerelease) {
+    throw new Error(`beta tag 必须指向预发布版本，当前值：${version}`);
+  }
+  if (tag === PROD_RELEASE_TAG && parsed.prerelease) {
+    throw new Error(`latest tag 必须指向正式版本，当前值：${version}`);
+  }
+  return { tag, version: parsed.raw };
+}
+
+function compareCoreVersion(left, right) {
+  if (left.major !== right.major) return left.major - right.major;
+  if (left.minor !== right.minor) return left.minor - right.minor;
+  return left.patch - right.patch;
+}
+
+export function selectBetaFirstRelease(latestVersion, betaVersion) {
+  const latest = resolveCliRelease(PROD_RELEASE_TAG, latestVersion);
+  if (!betaVersion) return latest;
+
+  const beta = resolveCliRelease(BETA_RELEASE_TAG, betaVersion);
+  return compareCoreVersion(parseVersion(beta.version), parseVersion(latest.version)) > 0
+    ? beta
+    : latest;
+}
+
+export function normalizeNpmPolicy(value = '') {
+  const policy = String(value || '').trim().toLowerCase();
+  if (policy && policy !== BETA_FIRST_POLICY) {
+    throw new Error(`--npm-policy 仅支持 beta-first，当前值：${value}`);
+  }
+  return policy;
+}
+
 export function ensureCli(options = {}) {
   const envName = normalizeCliEnvironment(options.env);
-  const latestVersion = selectLatestCompatibleVersion(queryVersions());
+  const npmPolicy = normalizeNpmPolicy(options.npmPolicy);
+  if (npmPolicy && options.npmTag !== undefined) {
+    throw new Error('--npm-policy 与 --npm-tag 不能同时使用');
+  }
+  if (npmPolicy === BETA_FIRST_POLICY && envName !== 'beta') {
+    throw new Error('--npm-policy beta-first 仅允许与 --env beta 一起使用');
+  }
+
+  const release = npmPolicy === BETA_FIRST_POLICY
+    ? selectBetaFirstRelease(
+      queryTaggedVersion(PROD_RELEASE_TAG),
+      queryTaggedVersion(BETA_RELEASE_TAG, { optional: true })
+    )
+    : (() => {
+      const releaseTag = normalizeNpmTag(options.npmTag);
+      return resolveCliRelease(releaseTag, queryTaggedVersion(releaseTag));
+    })();
+  const latestVersion = release.version;
   const previousVersion = readInstalledVersion();
   let status = 'current';
   if (previousVersion !== latestVersion) {
@@ -141,7 +167,14 @@ export function ensureCli(options = {}) {
     throw new Error(`版本校验失败：期望 ${latestVersion}，实际 ${installedVersion || '未安装'}`);
   }
   run(COMMAND_NAME, ['whoami', '--env', envName]);
-  return { status, previousVersion: previousVersion || null, version: installedVersion };
+  return {
+    status,
+    previousVersion: previousVersion || null,
+    version: installedVersion,
+    tag: release.tag,
+    policy: npmPolicy || null,
+    env: envName
+  };
 }
 
 function readEnvironmentArg(argv) {
@@ -150,6 +183,18 @@ function readEnvironmentArg(argv) {
   return argv[index + 1];
 }
 
+function readNpmTagArg(argv) {
+  const index = argv.indexOf('--npm-tag');
+  if (index === -1) return undefined;
+  return argv[index + 1];
+}
+
+function readNpmPolicyArg(argv) {
+  const index = argv.indexOf('--npm-policy');
+  if (index === -1) return undefined;
+  return argv[index + 1];
+}
+
 function isMainModule() {
   if (!process.argv[1]) return false;
   try {
@@ -162,7 +207,9 @@ function isMainModule() {
 if (isMainModule()) {
   try {
     process.stdout.write(`CLI_VERSION_JSON:${JSON.stringify(ensureCli({
-      env: readEnvironmentArg(process.argv.slice(2))
+      env: readEnvironmentArg(process.argv.slice(2)),
+      npmTag: readNpmTagArg(process.argv.slice(2)),
+      npmPolicy: readNpmPolicyArg(process.argv.slice(2))
     }))}\n`);
   } catch (error) {
     process.stderr.write(`CLI_VERSION_JSON:${JSON.stringify({