@sokeai/cli 1.0.37 → 1.0.41

package/README.md

@@ -27,7 +27,7 @@
 3. **业务模块快捷命令**
    - 针对授客AI核心业务场景提供了丰富的快捷命令集：
      - **通讯录 (contact)**: 部门与用户查询、管理、搜索等。
-     - **课程 (course)**: 课程列表、分类、学习记录、人脸识别记录等。
+     - **课程 (course)**: 课程列表、分类、学习记录、人脸识别记录等;含 `+batch-create-from-excel` 从 Excel 批量创建课程并上传课件(ffmpeg 可选,系统已装则启用视频抽帧封面,未装则降级到默认封面)。
      - **考试 (exam)**: 考试列表、分类、考试成绩与记录查询。
      - **学习档案 (learning-profile)**: 学员学习档案查询、学习情况统计。
      - **学习地图 (learning-map)**: 学习地图、阶段、任务查询与分配。
@@ -39,6 +39,7 @@
 4. **AI Agent Skills**
    - 提供 AI Agent 技能（Skills），使 AI 助手能够自动发现和调用 CLI 功能。
    - 支持自然语言交互，无需记忆复杂的命令参数。
+   - 支持维护者删除受管 Skill，并通过本地同步与升级安装自动清理废弃 Skill。
 
 ## 安装方法
 
@@ -164,6 +165,28 @@ soke-cli api GET /users/me
 soke-cli api POST /some/endpoint --data '{"key": "value"}'
 ```
 
+### 删除受管 Skill（维护者）
+
+如果你需要从当前仓库中下线一个受管 Skill，可以执行：
+
+```bash
+soke-cli delete-skill soke-business-training-report
+```
+
+删除后再执行：
+
+```bash
+bash ./scripts/local-test.sh
+```
+
+本地 Agent 中由 `soke-cli` 管理的过期 `soke-*` Skills 会被自动清理。客户后续执行：
+
+```bash
+npm install -g @sokeai/cli@latest
+```
+
+也会按当前发布包中的 Skill 集合自动清理废弃的受管 Skill。
+
 ## 开发指南
 
 ### 从接口封装到发布的完整流程

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@sokeai/cli",
-    "version": "1.0.37",
+    "version": "1.0.41",
     "description": "授客AI官方CLI工具 - 支持AI Agent Skills",
     "bin": {
         "soke-cli": "scripts/run.js"

package/scripts/build-binaries.sh

@@ -15,8 +15,37 @@ NC='\033[0m' # No Color
 VERSION=$(node -p "require('./package.json').version")
 echo -e "${GREEN}开始编译 soke-cli v${VERSION}${NC}"
 
+# task 11.2 — OAuth 凭证通过 env 注入(替代原 sed 改 Go 源的方式)。
+#
+# 重要:vendor.yaml 的 ${SOKE_CLIENT_ID} / ${SOKE_CLIENT_SECRET} 由
+# sokeai/provider.go 在 init() 阶段 Interpolate,**取的是产物运行时的 env**,
+# 而不是 build 期。因此:
+#
+#   * 本地开发:用户在 shell 里 export SOKE_CLIENT_ID / SOKE_CLIENT_SECRET,
+#     然后 go run / 已 build 的 ./bin/soke-cli 启动时 init() 取到。
+#   * Release 二进制:client_id / client_secret 不在 build 阶段嵌入产物。
+#     发版 CI 应当在制作 NPM 包时附带一个 wrapper(scripts/run.js)在启动
+#     soke-cli 前 setenv 注入(具体方式由 release-lead 在发版 CI 里定),
+#     或要求最终用户自己 export(仅适用于内部分发场景)。
+#
+# 本脚本只做 sanity check + 把当前 shell env 透传到 go build(用于自动化
+# 测试场景中,build 后立即跑 ./bin/soke-cli auth login 走流程)。
+if [ -z "${SOKE_CLIENT_ID:-}" ] || [ -z "${SOKE_CLIENT_SECRET:-}" ]; then
+    if [ "${SOKE_CLI_RELEASE:-}" = "1" ]; then
+        echo -e "${RED}[FATAL] release 模式必须设置 SOKE_CLIENT_ID / SOKE_CLIENT_SECRET${NC}"
+        echo -e "${RED}        二进制本身不嵌入凭证,run.js wrapper 也需要相应的注入逻辑${NC}"
+        exit 1
+    fi
+    echo -e "${YELLOW}[警告] SOKE_CLIENT_ID / SOKE_CLIENT_SECRET 未设置;${NC}"
+    echo -e "${YELLOW}        本地 build 后直接 ./bin/soke-cli auth login 会 fail-fast。${NC}"
+fi
+export SOKE_CLIENT_ID SOKE_CLIENT_SECRET
+
 # 编译参数
-LDFLAGS="-s -w -X main.Version=${VERSION}"
+# -X 注入路径必须匹配 internal/version.Version 所在包,
+# 此前误写为 main.Version,导致 --version 始终落回 checker.go 里
+# 的 hardcoded 默认值。
+LDFLAGS="-s -w -X codeup.aliyun.com/5edbc121d1d1abe63b55f1c7/soke/soke-cli/internal/version.Version=${VERSION}"
 
 # 创建输出目录
 BIN_DIR="bin"

package/scripts/ci/check-legacy-constants.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+# task 9.1 — 拦截误引入的 dws-cli upstream 旧常量。
+#
+# 故意提一个引入旧常量的 bad PR 时,CI 该步骤应当失败。
+# 允许出现在 openspec/ 历史 doc 与 docs/dead-code-audit-*.md。
+#
+# 用法:bash scripts/ci/check-legacy-constants.sh
+
+set -euo pipefail
+
+PATTERN='OpenDevURL\|AuthorizeURL\|DefaultMCPBaseURL\|DefaultClientID\|DefaultClientSecret\|<YOUR_CLIENT_'
+
+# 只扫源码目录;openspec/docs/scripts 历史档案允许出现。
+hits=$(grep -rn -E "$PATTERN" cmd/ internal/ extension/ 2>/dev/null \
+  | grep -v vendorplugin/ \
+  | grep -v "_test.go" \
+  || true)
+
+if [ -n "$hits" ]; then
+  echo "[FAIL] 检测到 dws-cli 旧常量残留:"
+  echo "$hits"
+  echo
+  echo "请改用 vendor.Active().Endpoints() / OAuth() 读取(见 cmd/user_auth/vendor.go)。"
+  exit 1
+fi
+
+echo "[OK] 无 dws-cli 旧常量残留。"

package/scripts/ci/check-yaml-env-whitelist.sh

@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+# task 9.2 — 校验 extension/vendorplugin/builtin/**/vendor.yaml 内 ${VAR}
+# 占位符全部符合白名单(^SOKE_[A-Z0-9_]+$)。
+#
+# 故意写一个 ${HOME} 进 vendor.yaml 时,本步骤应当 FAIL。
+#
+# 用法:bash scripts/ci/check-yaml-env-whitelist.sh
+
+set -euo pipefail
+
+WHITELIST_RE='^SOKE_[A-Z0-9_]+$'
+fail=0
+
+for yaml in $(find extension/vendorplugin/builtin -name vendor.yaml 2>/dev/null); do
+  # 抽出所有 ${...} 占位符内层内容(去掉默认值部分)
+  vars=$(grep -oE '\$\{[^{}]+\}' "$yaml" \
+    | sed -E 's/^\$\{([^:}]+)(:-[^}]*)?\}$/\1/' \
+    | sort -u)
+  for v in $vars; do
+    if ! echo "$v" | grep -qE "$WHITELIST_RE"; then
+      echo "[FAIL] $yaml 引用了非白名单 env: $v"
+      fail=1
+    fi
+  done
+done
+
+if [ "$fail" -ne 0 ]; then
+  echo
+  echo "白名单规则:^SOKE_[A-Z0-9_]+\$(见 extension/vendorplugin/env_whitelist.go)"
+  exit 1
+fi
+
+echo "[OK] 所有 vendor.yaml 内 \${VAR} 占位符均符合 SOKE_* 白名单。"

package/scripts/install.js

@@ -107,6 +107,46 @@ function detectSkillNames(packagedSkillsDir) {
   }
 }
 
+function removeManagedSkillDir(targetDir, skillName) {
+  const dest = path.join(targetDir, skillName);
+  if (!fs.existsSync(dest)) return false;
+  try {
+    fs.rmSync(dest, { recursive: true, force: true });
+    return true;
+  } catch (_) {
+    return false;
+  }
+}
+
+function pruneManagedSkillDirs(targetDir, expectedSkillNames) {
+  if (!fs.existsSync(targetDir)) return [];
+  try {
+    const entries = fs.readdirSync(targetDir, { withFileTypes: true });
+    const removed = [];
+    for (const entry of entries) {
+      if (!entry.isDirectory() || !entry.name.startsWith('soke-')) continue;
+      if (expectedSkillNames.includes(entry.name)) continue;
+      if (removeManagedSkillDir(targetDir, entry.name)) {
+        removed.push(entry.name);
+      }
+    }
+    return removed;
+  } catch (_) {
+    return [];
+  }
+}
+
+function pruneRegistrySkills(registry, expectedSkillNames) {
+  if (!registry || !Array.isArray(registry.skills)) return 0;
+  const before = registry.skills.length;
+  registry.skills = registry.skills.filter((entry) => {
+    if (!entry || typeof entry.name !== 'string') return true;
+    if (!entry.name.startsWith('soke-')) return true;
+    return expectedSkillNames.includes(entry.name);
+  });
+  return before - registry.skills.length;
+}
+
 function syncSkillsToSokeclawWorkspace() {
   const packageRoot = path.join(__dirname, '..');
   const packagedSkillsDir = path.join(packageRoot, 'skills');
@@ -118,6 +158,7 @@ function syncSkillsToSokeclawWorkspace() {
   for (const targetDir of targetDirs) {
     try {
       fs.mkdirSync(targetDir, { recursive: true });
+      pruneManagedSkillDirs(targetDir, skillNames);
       for (const skillName of skillNames) {
         const src = path.join(packagedSkillsDir, skillName);
         const dest = path.join(targetDir, skillName);
@@ -263,6 +304,9 @@ function syncSkillsToWorkclawRegistry() {
     if (fs.existsSync(src)) copyDirRecursive(src, dest);
   }
 
+  pruneManagedSkillDirs(workclawSkillInstallDir, skillNames);
+  pruneRegistrySkills(registry, skillNames);
+
   // 自动注册所有 skills
   for (const skillName of skillNames) {
     const skillDir = path.join(packagedSkillsDir, skillName);
@@ -418,29 +462,19 @@ const archMap = {
 const mappedPlatform = platformMap[platform];
 const mappedArch = archMap[arch];
 
-if (!mappedPlatform || !mappedArch) {
-  console.error(`不支持的平台: ${platform}-${arch}`);
-  console.error('支持的平台: darwin-x64, darwin-arm64, linux-x64, windows-x64');
-  process.exit(1);
-}
-
 const binaryName = platform === 'win32' ? 'soke-cli.exe' : 'soke-cli';
-const binaryFileName = `soke-cli-${mappedPlatform}-${mappedArch}${platform === 'win32' ? '.exe' : ''}`;
+const binaryFileName = mappedPlatform && mappedArch
+  ? `soke-cli-${mappedPlatform}-${mappedArch}${platform === 'win32' ? '.exe' : ''}`
+  : '';
 
 // GitHub Releases 下载地址
-const downloadURL = `https://github.com/liuchenlong1111/soke-cli/releases/download/v${version}/${binaryFileName}`;
+const downloadURL = binaryFileName
+  ? `https://github.com/liuchenlong1111/soke-cli/releases/download/v${version}/${binaryFileName}`
+  : '';
 
 const binDir = path.join(__dirname, '..', 'bin');
 const binaryPath = path.join(binDir, binaryName);
 
-console.log(`正在为 ${mappedPlatform}-${mappedArch} 下载 soke-cli v${version}...`);
-console.log(`下载地址: ${downloadURL}`);
-
-// 创建 bin 目录
-if (!fs.existsSync(binDir)) {
-  fs.mkdirSync(binDir, { recursive: true });
-}
-
 // 下载文件
 function downloadFile(url, dest) {
   return new Promise((resolve, reject) => {
@@ -491,43 +525,67 @@ function downloadFile(url, dest) {
 }
 
 // 执行下载
-downloadFile(downloadURL, binaryPath)
-  .then(() => {
-    // 设置可执行权限（非 Windows 平台）
-    if (platform !== 'win32') {
-      try {
-        fs.chmodSync(binaryPath, 0o755);
-        console.log('已设置可执行权限');
-      } catch (err) {
-        console.error('设置可执行权限失败:', err.message);
-        process.exit(1);
+if (require.main === module) {
+  if (!mappedPlatform || !mappedArch) {
+    console.error(`不支持的平台: ${platform}-${arch}`);
+    console.error('支持的平台: darwin-x64, darwin-arm64, linux-x64, windows-x64');
+    process.exit(1);
+  }
+
+  console.log(`正在为 ${mappedPlatform}-${mappedArch} 下载 soke-cli v${version}...`);
+  console.log(`下载地址: ${downloadURL}`);
+
+  if (!fs.existsSync(binDir)) {
+    fs.mkdirSync(binDir, { recursive: true });
+  }
+
+  downloadFile(downloadURL, binaryPath)
+    .then(() => {
+      // 设置可执行权限（非 Windows 平台）
+      if (platform !== 'win32') {
+        try {
+          fs.chmodSync(binaryPath, 0o755);
+          console.log('已设置可执行权限');
+        } catch (err) {
+          console.error('设置可执行权限失败:', err.message);
+          process.exit(1);
+        }
       }
-    }
 
-    try {
-      syncSkillsToSokeclawWorkspace();
-    } catch (_) {}
+      try {
+        syncSkillsToSokeclawWorkspace();
+      } catch (_) {}
 
-    try {
-      syncSkillsToWorkclawRegistry();
-    } catch (_) {}
+      try {
+        syncSkillsToWorkclawRegistry();
+      } catch (_) {}
 
-    return maybeAssistGuiPath();
-  })
-  .then(() => {
-    console.log('soke-cli 安装成功!');
-    console.log(`二进制文件位置: ${binaryPath}`);
-    console.log('\n使用方法:');
-    console.log('  soke-cli --help');
-    console.log('  soke-cli config init');
-    console.log('  soke-cli auth login');
-  })
-  .catch((err) => {
-    console.error('\n安装失败:', err.message);
-    console.error('\n可能的原因:');
-    console.error('1. 网络连接问题');
-    console.error('2. GitHub Releases 中不存在该版本的二进制文件');
-    console.error('3. 不支持当前平台');
-    console.error('\n请访问 https://github.com/sokeai/soke-cli/releases 手动下载');
-    process.exit(1);
-  });
+      return maybeAssistGuiPath();
+    })
+    .then(() => {
+      console.log('soke-cli 安装成功!');
+      console.log(`二进制文件位置: ${binaryPath}`);
+      console.log('\n使用方法:');
+      console.log('  soke-cli --help');
+      console.log('  soke-cli config init');
+      console.log('  soke-cli auth login');
+    })
+    .catch((err) => {
+      console.error('\n安装失败:', err.message);
+      console.error('\n可能的原因:');
+      console.error('1. 网络连接问题');
+      console.error('2. GitHub Releases 中不存在该版本的二进制文件');
+      console.error('3. 不支持当前平台');
+      console.error('\n请访问 https://github.com/sokeai/soke-cli/releases 手动下载');
+      process.exit(1);
+    });
+}
+
+module.exports = {
+  detectSkillNames,
+  parseSkillMetadata,
+  pruneManagedSkillDirs,
+  pruneRegistrySkills,
+  syncSkillsToSokeclawWorkspace,
+  syncSkillsToWorkclawRegistry
+};

package/scripts/local-test.js

@@ -104,6 +104,46 @@ function detectSkillNames(packagedSkillsDir) {
   }
 }
 
+function removeManagedSkillDir(targetDir, skillName) {
+  const skillDir = path.join(targetDir, skillName);
+  if (!fs.existsSync(skillDir)) return false;
+  try {
+    fs.rmSync(skillDir, { recursive: true, force: true });
+    return true;
+  } catch (_) {
+    return false;
+  }
+}
+
+function pruneManagedSkillDirs(targetDir, expectedSkillNames) {
+  if (!fs.existsSync(targetDir)) return [];
+  try {
+    const entries = fs.readdirSync(targetDir, { withFileTypes: true });
+    const removed = [];
+    for (const entry of entries) {
+      if (!entry.isDirectory() || !entry.name.startsWith('soke-')) continue;
+      if (expectedSkillNames.includes(entry.name)) continue;
+      if (removeManagedSkillDir(targetDir, entry.name)) {
+        removed.push(entry.name);
+      }
+    }
+    return removed;
+  } catch (_) {
+    return [];
+  }
+}
+
+function pruneRegistrySkills(registry, expectedSkillNames) {
+  if (!registry || !Array.isArray(registry.skills)) return 0;
+  const before = registry.skills.length;
+  registry.skills = registry.skills.filter((entry) => {
+    if (!entry || typeof entry.name !== 'string') return true;
+    if (!entry.name.startsWith('soke-')) return true;
+    return expectedSkillNames.includes(entry.name);
+  });
+  return before - registry.skills.length;
+}
+
 /**
  * 从 SKILL.md 解析元数据
  */
@@ -226,6 +266,7 @@ function detectLocalAgentDirs() {
  * 更新 workclaw registry.json
  */
 function updateWorkclawRegistry(registryPath, skillName, metadata, skillInstallPath) {
+  const safeMetadata = metadata && typeof metadata === 'object' ? metadata : {};
   let registry;
 
   try {
@@ -238,11 +279,11 @@ function updateWorkclawRegistry(registryPath, skillName, metadata, skillInstallP
   if (!registry.migrations) registry.migrations = {};
   if (!Array.isArray(registry.skills)) registry.skills = [];
 
-  const displayName = metadata.summary || metadata.name || skillName;
-  const description = metadata.description || `${displayName} - 授客AI CLI工具`;
-  const version = metadata.version || '1.0.0';
+  const displayName = safeMetadata.summary || safeMetadata.name || skillName;
+  const description = safeMetadata.description || `${displayName} - 授客AI CLI工具`;
+  const version = safeMetadata.version || '1.0.0';
   const emoji = inferSkillEmoji(skillName);
-  const requires = metadata.bins ? { bins: metadata.bins } : {};
+  const requires = safeMetadata.bins ? { bins: safeMetadata.bins } : {};
 
   const skillEntry = {
     id: `skill:${skillName}`,
@@ -323,6 +364,26 @@ function distributeSkill(skillName, packagedSkillsDir, targetDirs) {
   return successCount > 0;
 }
 
+function reconcileTarget(target, expectedSkillNames) {
+  const removedDirs = pruneManagedSkillDirs(target.path, expectedSkillNames);
+  if (removedDirs.length > 0) {
+    logInfo(`  清理过期 skills: ${removedDirs.join(', ')}`);
+  }
+
+  if (target.type === 'workclaw' && target.registryPath && fs.existsSync(target.registryPath)) {
+    try {
+      const registry = JSON.parse(fs.readFileSync(target.registryPath, 'utf8'));
+      const removedEntries = pruneRegistrySkills(registry, expectedSkillNames);
+      if (removedEntries > 0) {
+        fs.writeFileSync(target.registryPath, JSON.stringify(registry, null, 2));
+        logInfo(`  清理 registry 过期条目: ${removedEntries}`);
+      }
+    } catch (err) {
+      logError(`  ✗ 清理 registry 失败: ${err.message}`);
+    }
+  }
+}
+
 /**
  * 清理所有本地环境中的 skills
  */
@@ -455,6 +516,10 @@ function main() {
     }
   }
 
+  for (const target of targetDirs) {
+    reconcileTarget(target, allSkills);
+  }
+
   // 总结
   logSection('分发完成');
 
@@ -493,11 +558,21 @@ function main() {
   console.log('');
 }
 
+module.exports = {
+  detectSkillNames,
+  parseSkillMetadata,
+  pruneManagedSkillDirs,
+  pruneRegistrySkills,
+  updateWorkclawRegistry
+};
+
 // 运行
-try {
-  main();
-} catch (err) {
-  logError(`发生错误: ${err.message}`);
-  console.error(err);
-  process.exit(1);
+if (require.main === module) {
+  try {
+    main();
+  } catch (err) {
+    logError(`发生错误: ${err.message}`);
+    console.error(err);
+    process.exit(1);
+  }
 }

package/scripts/local-test.sh

@@ -109,59 +109,15 @@ echo ""
 
 # 步骤3.5: 分发 Skills 到本地 Agent
 echo -e "${YELLOW}[3.5/4] 分发 Skills 到本地 Agent...${NC}"
-if [ "$SKIP_GLOBAL" = false ]; then
-    echo -e "  执行 scripts/install.js 同步 Skills..."
-    # 注入特殊环境变量或者直接调用 node 执行
-    # 我们只想要触发 syncSkillsToSokeclawWorkspace 和 syncSkillsToWorkclawRegistry
-    # 但原 install.js 会尝试下载二进制文件，所以我们新建一个临时脚本或修改调用方式
-    
-    # 为了安全起见，这里直接使用 node 运行一小段脚本引入 install.js 中的逻辑
-    cat > ./scripts/sync-skills-local.js << 'EOF'
-const fs = require('fs');
-const path = require('path');
-const installCode = fs.readFileSync(path.join(__dirname, 'install.js'), 'utf8');
-
-// 提取需要的函数
-const syncFn1Match = installCode.match(/function syncSkillsToSokeclawWorkspace\(\) \{[\s\S]*?\n\}/);
-const syncFn2Match = installCode.match(/function syncSkillsToWorkclawRegistry\(\) \{[\s\S]*?\n\}/);
-
-// 我们更推荐直接利用已经写好的 js 模块（如果它是通过 module.exports 导出的）
-// 但因为 install.js 是直接执行的脚本，我们通过简单的 node 脚本手动拷贝
-const os = require('os');
-function copyDirRecursive(srcDir, destDir) {
-  if (!fs.existsSync(srcDir)) return;
-  if (!fs.existsSync(destDir)) fs.mkdirSync(destDir, { recursive: true });
-  const entries = fs.readdirSync(srcDir, { withFileTypes: true });
-  for (const entry of entries) {
-    const srcPath = path.join(srcDir, entry.name);
-    const destPath = path.join(destDir, entry.name);
-    if (entry.isDirectory()) { copyDirRecursive(srcPath, destPath); continue; }
-    fs.copyFileSync(srcPath, destPath);
-  }
-}
-
-const homeDir = os.homedir();
-const defaultSokeclawDir = path.join(homeDir, '.sokeclaw', 'openai-agents', 'workspaces', 'main', 'skills');
-const packageRoot = path.join(__dirname, '..');
-const packagedSkillsDir = path.join(packageRoot, 'skills');
-
-if (fs.existsSync(packagedSkillsDir)) {
-  const skillNames = fs.readdirSync(packagedSkillsDir).filter(n => n.startsWith('soke-'));
-  if (fs.existsSync(defaultSokeclawDir)) {
-    for (const skillName of skillNames) {
-      const src = path.join(packagedSkillsDir, skillName);
-      const dest = path.join(defaultSokeclawDir, skillName);
-      copyDirRecursive(src, dest);
-      console.log(`  ✓ 同步 ${skillName} 到 ${dest}`);
-    }
-  }
-}
-EOF
-    node ./scripts/sync-skills-local.js
-    rm ./scripts/sync-skills-local.js
+echo -e "  执行 scripts/local-test.js 同步并清理本地 Agent Skills..."
+if node ./scripts/local-test.js; then
     echo -e "${GREEN}  ✓ Skills 同步完成${NC}"
+    if [ "$SKIP_GLOBAL" = true ]; then
+        echo -e "${YELLOW}  提示: 已跳过全局 CLI 覆盖，但本地 Agent Skills 已按当前仓库状态完成同步${NC}"
+    fi
 else
-    echo -e "${YELLOW}  跳过全局安装，同时跳过 Skills 同步${NC}"
+    echo -e "${RED}  ✗ Skills 同步失败${NC}"
+    exit 1
 fi
 echo ""
 
@@ -222,4 +178,3 @@ echo ""
 echo -e "${GREEN}========================================${NC}"
 echo -e "${GREEN}  本地测试完成! ✓${NC}"
 echo -e "${GREEN}========================================${NC}"
-

package/scripts/mcp-stdout-scan.sh

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+# mcp-stdout-scan.sh — openspec change make-soke-cli-mcp-first §10.3
+#
+# 静态扫描 internal/mcp/ / extension/vendor/builtin/ / internal/courseimport/ 三个
+# 与 mcp stdio 帧纯净性相关的代码树,拦下任何会污染 stdout JSON-RPC 帧的调用:
+#   - fmt.Println / fmt.Printf / fmt.Print
+#   - fmt.Fprintln / Fprintf / Fprint to os.Stdout
+#   - os.Stdout.Write*
+#   - 顶层 print( / println( 内建函数
+#
+# 排除 _test.go (测试代码允许写 stdout);
+# 通过 sed 把 `// ...` 注释剥掉再 grep,避免文档/注释里提到 fmt.Println 触发 false positive。
+#
+# 用法: bash scripts/mcp-stdout-scan.sh
+# 退出码: 0 = 干净;1 = 有命中(并打到 stderr)。
+
+set -e
+
+ROOTS="internal/mcp extension/vendor/builtin internal/courseimport"
+PATTERN='fmt\.(Println|Printf|Print\()|fmt\.(Fprintln|Fprintf|Fprint)\(os\.Stdout|os\.Stdout\.Write|^[[:space:]]*(print|println)\('
+
+have_hits=0
+for d in $ROOTS; do
+  if [ ! -d "$d" ]; then
+    echo "skip 不存在的目录 $d"
+    continue
+  fi
+  files=$(find "$d" -name '*.go' ! -name '*_test.go' 2>/dev/null)
+  for f in $files; do
+    # 把行号前缀附在文件内容上, 再用 sed 剥 // 注释 (单行注释一律剥), 再 grep
+    hits=$(awk '{ printf "%s:%d:%s\n", FILENAME, NR, $0 }' "$f" \
+           | sed 's_//.*$__' \
+           | grep -E "$PATTERN" \
+           || true)
+    if [ -n "$hits" ]; then
+      echo "❌ $f 检测到 stdout-write 调用 (会破坏 mcp stdio JSON-RPC 帧):" >&2
+      echo "$hits" >&2
+      have_hits=1
+    fi
+  done
+done
+
+if [ "$have_hits" -eq 1 ]; then
+  exit 1
+fi
+echo "✓ stdout 纯净性扫描通过"

package/scripts/push.sh

@@ -192,7 +192,7 @@ git commit -m "$commit_info"
 FEATURE_BRANCH=$CURRENT_BRANCH
 
 # 目标主分支名称
-TARGET_BRANCH="soke-cli"
+TARGET_BRANCH="master"
 
 # 切换到主分支
 print_info "切换到 $TARGET_BRANCH 分支..."

package/scripts/regress-auth.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+# 回归 auth 命令体感 — task 8.1
+#
+# 串行跑:
+#   1. auth status --json   (预期未登录)
+#   2. auth login            (人工:浏览器跳转 + 真账号授权)
+#   3. auth status --json   (预期已登录)
+#   4. auth logout
+#   5. auth status --json   (预期未登录)
+#
+# 用法:
+#   SOKE_CLIENT_ID=... SOKE_CLIENT_SECRET=... bash scripts/regress-auth.sh
+#   首次运行前 build:make install 或 go build -o bin/soke-cli main.go
+#
+# 输出建议用 tee 保存,事后人工对比 baseline:
+#   bash scripts/regress-auth.sh 2>&1 | tee /tmp/regress-after.txt
+#   diff /tmp/regress-before.txt /tmp/regress-after.txt
+
+set -u
+
+BIN="${SOKE_CLI_BIN:-./bin/soke-cli}"
+if [ ! -x "$BIN" ]; then
+  BIN="$(command -v soke-cli 2>/dev/null || echo "$BIN")"
+fi
+
+if [ ! -x "$BIN" ]; then
+  echo "[FATAL] 找不到 soke-cli 二进制(尝试 SOKE_CLI_BIN env 指定路径)" >&2
+  exit 2
+fi
+
+run_step() {
+  local label="$1"; shift
+  echo
+  echo "==== [$label] $* ===="
+  "$@"
+  local rc=$?
+  echo "==== [$label] exit=$rc ===="
+  return $rc
+}
+
+# baseline 时间戳 mask:让 diff 忽略 expires_at / iat / nbf / exp 等时间字段。
+mask_timestamps() {
+  sed -E 's/("(expires_at|iat|nbf|exp|access_token|refresh_token)":\s*)"[^"]*"/\1"<masked>"/g'
+}
+
+run_step "1.before-status" "$BIN" auth status --json | mask_timestamps
+echo
+echo "请在浏览器完成授权后按回车继续…"
+run_step "2.login" "$BIN" auth login
+read -r _
+run_step "3.after-login-status" "$BIN" auth status --json | mask_timestamps
+run_step "4.logout" "$BIN" auth logout
+run_step "5.final-status" "$BIN" auth status --json | mask_timestamps
+
+echo
+echo "[done] 完成。请人工对比 baseline diff(/tmp/regress-before.txt)。"