cprofile 0.4.0

package/docs/NAMING.zh-CN.md

@@ -0,0 +1,24 @@
+# 命名规则（Naming V2）
+
+## 核心
+
+- 用户可见名：`slug`
+- 内部唯一：`profile_id`
+- 兼容旧名：`aliases`
+
+## 自动命名
+
+`<email_short>_<space_short>_<h4>`
+
+其中：
+- `email_short`：邮箱简写
+- `space_short`：空间名简写
+- `h4`：`sha256(tool|account_key|space_key)` 前 4 位
+
+## 多空间支持
+
+同一账号在不同空间会得到不同 `space_key`，因此 slug 天然可并存。
+
+## 兼容策略
+
+旧 `name` 会自动写入 `aliases`，旧命令可继续使用。

package/docs/QUICKSTART.zh-CN.md

@@ -0,0 +1,25 @@
+# Quickstart（中文）
+
+## 步骤 1：打开账号列表
+
+运行：
+
+`cprofile`
+
+## 步骤 2：快速切换并启动
+
+- 输入关键词可过滤账号
+- 方向键选择，回车启动 codex/claude
+
+## 步骤 3：低频操作（仍在同一页）
+
+- `A`：添加账号
+- `D`：诊断
+- `I`：导入旧目录
+- `R`：刷新用量
+- `?`：查看快捷键帮助
+
+## 常见补充
+
+- 查看诊断：`cprofile doctor`
+- 查看全部命令：`cprofile --advanced-help`

package/docs/README.zh-CN.md

@@ -0,0 +1,39 @@
+# cprofile 使用说明（中文）
+
+## 什么是 cprofile
+
+cprofile 是一个“终端账号切换台”，用于本机管理和切换 Codex / Claude 多账号。
+
+## 3 步上手
+
+1. 输入 `cprofile` 直接进入账号列表。
+2. 方向键选择账号，回车立刻启动对应 CLI。
+3. 需要低频操作时，在列表页按快捷键（A/D/I/R/?）。
+
+## 使用特点
+
+- 默认主链路就是切换账号，不再先选功能菜单。
+- 列表只保留核心信息：账号 + 工作空间（Codex）+ 用量。
+- 用量口径统一为“已用/剩余”。
+
+## 列表快捷键
+
+- `A` 添加账号
+- `D` 诊断
+- `I` 导入旧目录
+- `R` 刷新用量
+- `Tab` 切换排序
+- `Ctrl+P` 收藏账号
+- `Ctrl+A` 显示/隐藏异常账号
+- `?` 查看帮助
+
+## 文档入口
+
+- `cprofile guide`：查看文档主题
+- `cprofile guide quickstart`
+- `cprofile guide troubleshooting`
+- `cprofile guide naming`
+
+## 高级命令入口
+
+- `cprofile --advanced-help`

package/docs/TROUBLESHOOTING.zh-CN.md

@@ -0,0 +1,83 @@
+# 故障排查（Troubleshooting）
+
+## 网络或代理问题
+
+现象：
+- 登录页打不开、卡住或超时
+
+一键动作：
+- 检查 `HTTP_PROXY` / `HTTPS_PROXY`
+- 重新执行首页“添加账号”向导
+
+预期结果：
+- 能正常弹出并完成登录
+
+## 登录失败
+
+现象：
+- 完成授权后仍提示未登录
+
+一键动作：
+- 执行 `cprofile` -> “添加账号”重新走向导登录
+
+预期结果：
+- `快速切换` 中状态显示“可用”
+
+## Token 失效
+
+现象：
+- 请求未授权、额度异常、突然掉线
+
+一键动作：
+- 用首页“添加账号”重新登录，覆盖旧凭证
+
+预期结果：
+- 同一账号恢复可用
+
+## 账号重复
+
+现象：
+- 列表里看起来是同一账号的重复项
+
+一键动作：
+- 先执行 `cprofile doctor`
+- 再执行 `cprofile rm <slug> --tool <tool>`
+
+预期结果：
+- 重复项被清理，`doctor` 不再报重复
+
+## 命名冲突
+
+现象：
+- 自定义短名提示已存在
+
+一键动作：
+- 在向导中换一个短名
+- 或使用 `cprofile name suggest ...` 预览建议名
+
+预期结果：
+- 新短名保存成功，可直接切换
+
+## 权限问题
+
+现象：
+- 报权限不足、文件写入失败
+
+一键动作：
+- 检查 `~/.cprofile` 权限应为 `700`
+- 敏感文件应为 `600`
+
+预期结果：
+- 命令恢复正常
+
+## 导入后仍显示旧账号
+
+现象：
+- 导入后分不清哪个是目标账号
+
+一键动作：
+- 执行 `cprofile use`，输入邮箱或空间名过滤
+- 必要时执行 `cprofile rename <id> <new_slug> --tool <tool>`
+
+预期结果：
+- 目标账号能被快速定位并切换

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "cprofile",
+  "version": "0.4.0",
+  "description": "Local multi-profile manager for Codex + Claude (interactive Chinese-first CLI)",
+  "keywords": [
+    "codex",
+    "claude",
+    "cli",
+    "profile",
+    "account-switch",
+    "terminal"
+  ],
+  "homepage": "https://github.com/WilsonLiu95/cprofile",
+  "bugs": {
+    "url": "https://github.com/WilsonLiu95/cprofile/issues"
+  },
+  "license": "MIT",
+  "author": "Wilson Liu",
+  "type": "commonjs",
+  "bin": {
+    "cprofile": "bin/cprofile",
+    "cprofile-cli": "bin/cprofile-cli"
+  },
+  "files": [
+    "bin/",
+    "shell/",
+    "docs/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/WilsonLiu95/cprofile.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  }
+}

package/shell/cprofile.sh

@@ -0,0 +1,46 @@
+# cprofile shell integration
+# Source this file in your shell rc to make `cprofile use` affect current shell.
+
+cprofile() {
+  if [ "$#" -gt 0 ] && [ "$1" = "use" ]; then
+    local _cprofile_out
+    if ! _cprofile_out="$(command cprofile-cli env "$@")"; then
+      return $?
+    fi
+    eval "${_cprofile_out}"
+
+    # Auto-open the selected CLI after profile switch.
+    # Set CPROFILE_AUTO_OPEN=0 to disable this behavior.
+    if [ "${CPROFILE_AUTO_OPEN:-1}" = "0" ]; then
+      echo "✓ 已切换到 ${CPROFILE_ACTIVE_TOOL}/${CPROFILE_ACTIVE_PROFILE}"
+      return 0
+    fi
+
+    case "${CPROFILE_ACTIVE_TOOL:-}" in
+      codex)
+        if command -v codex >/dev/null 2>&1; then
+          echo "✓ 已切换并启动 codex/${CPROFILE_ACTIVE_PROFILE}"
+          command codex
+          return $?
+        fi
+        echo "cprofile: 'codex' command not found in PATH" >&2
+        return 127
+        ;;
+      claude)
+        if command -v claude >/dev/null 2>&1; then
+          echo "✓ 已切换并启动 claude/${CPROFILE_ACTIVE_PROFILE}"
+          command claude
+          return $?
+        fi
+        echo "cprofile: 'claude' command not found in PATH" >&2
+        return 127
+        ;;
+      *)
+        echo "cprofile: unknown active tool: ${CPROFILE_ACTIVE_TOOL:-<empty>}" >&2
+        return 2
+        ;;
+    esac
+  fi
+
+  command cprofile-cli "$@"
+}