runcc 0.1.1 → 0.1.2

package/.claude/skills/npm-publish/SKILL.md

@@ -0,0 +1,209 @@
+---
+name: npm-publish
+description: Automate npm package version bumping and publishing with comprehensive safety checks. Use when user requests "发布新版本", "publish to npm", "bump version", "release a new version", or similar package publishing tasks. Supports semantic versioning (patch/minor/major), git tagging, CHANGELOG updates, and pre-publish validation.
+---
+
+# NPM Publish
+
+Automate the complete npm package release workflow with safety checks, version management, and changelog updates.
+
+## Workflow
+
+Follow this sequential workflow for publishing npm packages. Each step includes validation and confirmation points to ensure safe releases.
+
+### Step 1: Pre-flight Checks
+
+Before starting the release process, create a todo list with these items and verify the environment:
+
+1. **检查 git 工作区状态**
+   - Run `git status` to ensure working directory is clean
+   - If there are uncommitted changes, ask user whether to commit them or abort
+
+2. **确认当前分支**
+   - Check current branch with `git branch --show-current`
+   - Verify it's `main` or `master` (or other release branch)
+   - If not on release branch, warn user and ask to confirm or switch
+
+3. **检查 npm 登录状态**
+   - Run `npm whoami` to verify npm authentication
+   - If not logged in, instruct user to run `npm login`
+
+4. **拉取最新代码**
+   - Run `git pull` to ensure working with latest code
+   - Check for any conflicts
+
+### Step 2: Determine Version Bump Type
+
+Ask the user which type of version bump to perform, unless they've already specified:
+
+- **patch**: Bug fixes, minor changes (1.0.0 → 1.0.1)
+- **minor**: New features, backward compatible (1.0.0 → 1.1.0)
+- **major**: Breaking changes (1.0.0 → 2.0.0)
+- **custom**: Specify exact version number
+
+Use the `AskUserQuestion` tool if the version type wasn't specified in the initial request.
+
+### Step 3: Run Tests and Build
+
+Execute the project's quality checks:
+
+1. **运行测试**
+   - Check if `package.json` has a `test` script
+   - Run `npm test` or equivalent command
+   - If tests fail, abort the release and report errors
+
+2. **运行构建**
+   - Check if `package.json` has a `build` script
+   - Run `npm run build` or equivalent command
+   - If build fails, abort the release and report errors
+
+### Step 4: Update CHANGELOG
+
+If CHANGELOG.md exists in the project:
+
+1. **Read recent commits**
+   - Run `git log` to see commits since last release
+   - Look for previous version tags with `git tag -l`
+
+2. **Generate changelog entry**
+   - Create a new section for the new version
+   - List key changes based on commit messages
+   - Format: `## [Version] - YYYY-MM-DD`
+   - Group changes by type: Features, Bug Fixes, Breaking Changes, etc.
+
+3. **Let user review and edit**
+   - Show the generated changelog entry
+   - Use `AskUserQuestion` to confirm or request modifications
+   - Update CHANGELOG.md with the approved content
+
+If no CHANGELOG.md exists, ask user if they want to create one.
+
+### Step 5: Bump Version
+
+Use npm's built-in version command:
+
+```bash
+npm version <patch|minor|major|x.y.z> -m "chore: release v%s"
+```
+
+This command will:
+- Update version in `package.json` and `package-lock.json`
+- Create a git commit with the specified message
+- Create a git tag with the new version
+
+### Step 6: User Confirmation
+
+Before publishing, display a summary and ask for final confirmation:
+
+```
+Ready to publish:
+- Package: <package-name>
+- Current version: <old-version>
+- New version: <new-version>
+- Branch: <branch-name>
+- Changes: <summary from changelog>
+
+Proceed with publishing? (yes/no)
+```
+
+Use `AskUserQuestion` for this confirmation.
+
+### Step 7: Publish to NPM
+
+If user confirms, publish the package:
+
+```bash
+npm publish
+```
+
+Options to consider:
+- `--access public` for scoped public packages
+- `--tag <tag>` for pre-release versions (e.g., `beta`, `next`)
+- `--dry-run` to test without actually publishing (useful for first-time testing)
+
+### Step 8: Push to Git Remote
+
+After successful npm publish:
+
+1. **推送代码和标签**
+   ```bash
+   git push && git push --tags
+   ```
+
+2. **验证发布**
+   - Confirm the new version appears on npmjs.com
+   - Confirm the git tag appears on the remote repository
+
+### Step 9: Summary
+
+Report the successful release:
+
+```
+✅ Successfully published <package-name>@<new-version>
+
+- NPM: https://www.npmjs.com/package/<package-name>
+- Git tag: <tag-name>
+- Changelog updated: Yes/No
+
+Next steps:
+- Create GitHub release (if applicable)
+- Announce to team
+- Update dependent projects
+```
+
+## Error Handling
+
+If any step fails:
+
+1. **Clearly state which step failed and why**
+2. **Do not proceed to next steps**
+3. **Provide actionable recovery steps**
+4. **If version was bumped but publish failed:**
+   - The version commit and tag already exist
+   - User can either: fix the issue and run `npm publish` manually, or reset with `git reset --hard HEAD~1 && git tag -d v<version>`
+
+## Rollback
+
+If user needs to undo a release:
+
+1. **Unpublish from npm** (only within 72 hours):
+   ```bash
+   npm unpublish <package-name>@<version>
+   ```
+
+2. **Delete git tag**:
+   ```bash
+   git tag -d v<version>
+   git push origin :refs/tags/v<version>
+   ```
+
+3. **Revert version commit**:
+   ```bash
+   git reset --hard HEAD~1
+   git push --force
+   ```
+
+**Warning**: Unpublishing is discouraged by npm. Prefer deprecating instead:
+```bash
+npm deprecate <package-name>@<version> "Reason for deprecation"
+```
+
+## Customization
+
+Different projects may need adaptations:
+
+- **Monorepo**: Use tools like `lerna` or `nx` for versioning multiple packages
+- **Pre-release versions**: Use `npm version prerelease --preid=beta`
+- **CI/CD**: This workflow is for manual releases; adapt for automated pipelines
+- **Private registry**: Use `--registry` flag or `.npmrc` configuration
+- **2FA**: npm may require OTP code during publish, prompt user to enter it
+
+## Best Practices
+
+1. **Always run tests before publishing**
+2. **Keep CHANGELOG.md up to date**
+3. **Use semantic versioning correctly**
+4. **Review changes one final time before confirming**
+5. **Never publish with uncommitted changes**
+6. **Tag releases for easy reference**
+7. **Announce breaking changes clearly**

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.2] - 2026-01-19
+
+### Changed
+- Renamed CLI command from `cc-run` to `runcc` for better naming consistency
+- Improved output formatting with UTF-8 support for better Chinese character display in list command
+
+### Added
+- Added `.npmignore` configuration for cleaner package distribution
+- Added Claude Code skills configuration for enhanced development workflow
+- Added local testing script (`test-install.sh`) for installation verification
+
+## [0.1.1] - 2026-01-19
+
+### Added
+- Initial release with multi-endpoint support
+- Support for official Claude API and third-party providers (GLM, DeepSeek, Minimax)
+- Custom endpoint management (add/remove)
+- Proxy configuration support
+- Configuration persistence in `~/.cc-run/config.json`
+- Integration with Claude CLI settings (`~/.claude/settings.json`)

package/dist/index.js

@@ -1,5 +1,4 @@
-#!/usr/bin/env bun
-// @bun
+#!/usr/bin/env node
 import { createRequire } from "node:module";
 var __create = Object.create;
 var __getProtoOf = Object.getPrototypeOf;
@@ -2020,7 +2019,7 @@ function safeLog(message) {
   const encoder = new TextEncoder;
   const data = encoder.encode(message + `
 `);
-  Bun.write(Bun.stdout, data);
+  process.stdout.write(data);
 }
 function formatEndpoint(name, endpoint, hasToken) {
   const tokenStatus = hasToken ? "已配置 token" : "未配置 token";
@@ -2465,12 +2464,12 @@ function validateDashPosition(argv) {
 // src/index.ts
 function safeLog2(message) {
   const encoder = new TextEncoder;
-  Bun.write(Bun.stdout, encoder.encode(message + `
+  process.stdout.write(encoder.encode(message + `
 `));
 }
 function safeError(message) {
   const encoder = new TextEncoder;
-  Bun.write(Bun.stderr, encoder.encode(message + `
+  process.stderr.write(encoder.encode(message + `
 `));
 }
 var isBunCompiled = typeof Bun !== "undefined" && !import.meta.dir;
@@ -2483,17 +2482,17 @@ if (isBunCompiled) {
   };
 }
 var program2 = new Command;
-program2.name("cc-run").description("Claude \u542F\u52A8\u5668 - \u652F\u6301\u5207\u6362\u4E0D\u540C\u7684 API endpoint").version("0.1.0");
-program2.command("list").description("\u5217\u51FA\u6240\u6709\u53EF\u7528\u7684 endpoints").action(list);
-program2.command("add").description("\u6DFB\u52A0\u81EA\u5B9A\u4E49 endpoint").argument("<name>", "endpoint \u540D\u79F0").argument("<endpoint>", "API \u5730\u5740").action(add);
-program2.command("remove").description("\u5220\u9664\u81EA\u5B9A\u4E49 endpoint").argument("<name>", "endpoint \u540D\u79F0").action(remove);
-var proxyCmd = program2.command("proxy").description("\u4EE3\u7406\u7BA1\u7406");
-proxyCmd.command("on").description("\u5F00\u542F\u4EE3\u7406").action(proxyOn);
-proxyCmd.command("off").description("\u5173\u95ED\u4EE3\u7406").action(proxyOff);
-proxyCmd.command("reset").description("\u91CD\u7F6E\u4EE3\u7406\u914D\u7F6E").action(proxyReset);
-proxyCmd.command("status").description("\u67E5\u770B\u4EE3\u7406\u72B6\u6001").action(proxyStatus);
-proxyCmd.command("help").description("\u4EE3\u7406\u5E2E\u52A9\u4FE1\u606F").action(proxyHelp);
-program2.argument("[provider]", "provider \u540D\u79F0 (glm, deepseek, minimax \u6216\u81EA\u5B9A\u4E49)").option("--claude", "\u914D\u7F6E\u539F\u751F claude \u547D\u4EE4").allowExcessArguments(true).action(async (provider, options) => {
+program2.name("cc-run").description("Claude 启动器 - 支持切换不同的 API endpoint").version("0.1.0");
+program2.command("list").description("列出所有可用的 endpoints").action(list);
+program2.command("add").description("添加自定义 endpoint").argument("<name>", "endpoint 名称").argument("<endpoint>", "API 地址").action(add);
+program2.command("remove").description("删除自定义 endpoint").argument("<name>", "endpoint 名称").action(remove);
+var proxyCmd = program2.command("proxy").description("代理管理");
+proxyCmd.command("on").description("开启代理").action(proxyOn);
+proxyCmd.command("off").description("关闭代理").action(proxyOff);
+proxyCmd.command("reset").description("重置代理配置").action(proxyReset);
+proxyCmd.command("status").description("查看代理状态").action(proxyStatus);
+proxyCmd.command("help").description("代理帮助信息").action(proxyHelp);
+program2.argument("[provider]", "provider 名称 (glm, deepseek, minimax 或自定义)").option("--claude", "配置原生 claude 命令").allowExcessArguments(true).action(async (provider, options) => {
   try {
     validateDashPosition(process.argv);
     const passthroughArgs = extractPassthroughArgs(process.argv);
@@ -2508,14 +2507,14 @@ program2.argument("[provider]", "provider \u540D\u79F0 (glm, deepseek, minimax \
     }
   } catch (error) {
     if (error instanceof PassthroughArgsError) {
-      console.error("\u274C \u53C2\u6570\u4F4D\u7F6E\u4E0D\u6B63\u786E");
+      console.error("❌ 参数位置不正确");
       console.error("");
-      console.error("\u6B63\u786E\u7684\u7528\u6CD5\u793A\u4F8B:");
-      console.error("  cc-run glm -- <claude\u53C2\u6570>     # \u4F7F\u7528 glm provider \u5E76\u900F\u4F20\u53C2\u6570");
-      console.error("  cc-run --claude -- <\u53C2\u6570>       # \u6062\u590D\u5B98\u65B9\u914D\u7F6E\u5E76\u900F\u4F20\u53C2\u6570");
-      console.error("  cc-run glm --claude -- <\u53C2\u6570>   # \u914D\u7F6E\u539F\u751F claude \u547D\u4EE4\u4F7F\u7528 glm");
+      console.error("正确的用法示例:");
+      console.error("  cc-run glm -- <claude参数>     # 使用 glm provider 并透传参数");
+      console.error("  cc-run --claude -- <参数>       # 恢复官方配置并透传参数");
+      console.error("  cc-run glm --claude -- <参数>   # 配置原生 claude 命令使用 glm");
       console.error("");
-      console.error("\u8BF4\u660E: -- \u5206\u9694\u7B26\u7528\u4E8E\u5C06\u540E\u7EED\u53C2\u6570\u900F\u4F20\u7ED9 Claude CLI");
+      console.error("说明: -- 分隔符用于将后续参数透传给 Claude CLI");
       process.exit(1);
     }
     throw error;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runcc",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "CC launcher with endpoint switching support",
   "type": "module",
   "main": "dist/index.js",

package/test-install.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+# 本地安装测试脚本
+
+set -e
+
+echo "🔨 构建项目..."
+bun run build
+
+echo ""
+echo "📦 打包..."
+npm pack
+
+echo ""
+echo "🌍 全局安装..."
+PKG=$(ls runcc-*.tgz)
+npm install -g ./$PKG
+
+echo ""
+echo "✅ 测试中文输出..."
+runcc list
+
+echo ""
+echo "🧹 清理..."
+npm uninstall -g runcc
+rm $PKG
+
+echo ""
+echo "✨ 测试完成！"