Author SHA1 Message Date
gongzhiyong 790d8d5741 docs(env): clarify DeepSeek v4 already 1M-context, no -1m suffix
被问到 "为什么没有 -1m 这种 model id",查了官方 list-models 后澄清:
DeepSeek 与 Anthropic 命名风格不同,v4-pro / v4-flash 默认就是 1M 上下文,
不存在 -1m 后缀变体。把这点显式写进 .env.example,避免下个队友也疑惑。

- 加注 "1M 上下文" 直接写在每个 model 行
- 加注 deepseek-chat / deepseek-reasoner 实际路由去向(v4-flash 思考/非思考)
- 引用 https://api-docs.deepseek.com/api/list-models 作为权威来源

Made-with: Cursor
2026-04-28 23:37:07 +08:00
gongzhiyong 7fa1580622 docs(env): rewrite .env.example for DeepSeek-first config
补齐上一个提交的 .env.example 同步改写:列出三种登录方式(DeepSeek
端点 / Claude 订阅 / 原生 Anthropic)和 4 个模型 ID(含 deepseek-chat /
deepseek-reasoner 2026-07-24 弃用提示)。

本提交用 --no-verify 是因为 .claude/hooks/pre-commit-check.sh 对 staged
diff 的 - 删除行也做密钥扫描,导致旧占位符 sk-ant-xxxxxxxx 触发 false
positive。已征得 owner 明确同意。后续建议把 hook 改为只扫 + 加行。

Made-with: Cursor
2026-04-28 23:21:35 +08:00
gongzhiyong 3a008458f3 feat(model): default to DeepSeek Anthropic-compatible endpoint
把 Claude Code 的默认上游从 Anthropic 直连改到 DeepSeek 的 Anthropic 兼容端点
(`https://api.deepseek.com/anthropic`),使容器内 agent 直接复用 DeepSeek API
而无需 Anthropic 账号。

- docker-compose.yml: 透传 ANTHROPIC_BASE_URL / ANTHROPIC_SMALL_FAST_MODEL;
  默认值 deepseek-v4-pro (主) + deepseek-v4-flash (子任务)
- README.md: "前置条件" 改为 DeepSeek 优先;"切到 API Key 模式" 写明 DeepSeek
  端点和原生 Anthropic 两种填法
- scripts/bootstrap.sh: 自动生成 .env 时的提示语对齐新文案

仍兼容原 Anthropic 直连:清空 ANTHROPIC_BASE_URL 即可回退。
.env 已 gitignored,未提交真实 key。

注:.env.example 的同步 rewrite 因 pre-commit-check.sh 误报旧占位符
(sk-ant-xxxxx...),将单独提交。

Made-with: Cursor
2026-04-28 23:19:56 +08:00
4 changed files with 45 additions and 15 deletions
+36 -11
View File
@@ -1,13 +1,43 @@
# =================================================================
# 登录方式(订阅模式无需填任何 KEY)
# 登录方式
# =================================================================
#
# 方式 A(推荐):Claude Max/Pro 订阅 OAuth
# —— 本文件任何 KEY 都不用填。启动容器后运行 `/login` 即可。
# 凭证会写入 docker named volume `claude-home`,下次启动自动复用。
# 方式 A(默认,已配好):DeepSeek 的 Anthropic 兼容端点
# —— 把下面 ANTHROPIC_API_KEY 填上自己的 DeepSeek key 即可。
# Claude Code 会通过 ANTHROPIC_BASE_URL 路由到 DeepSeek。
#
# 方式 B:Anthropic API Key(按量计费,适合 CI 无人值守)
# ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# 方式 B:原生 Claude Max/Pro 订阅 OAuth
# —— 清空 ANTHROPIC_BASE_URL(或注释掉 docker-compose.yml 里的默认值),
# 不填 KEY,启动容器后 `/login`,凭证写入 docker volume `claude-home`。
#
# 方式 C:原生 Anthropic API Key(按量计费)
# —— ANTHROPIC_BASE_URL 留空,ANTHROPIC_API_KEY 用 sk-ant-xxx。
#
# =================================================================
# DeepSeek Anthropic 兼容端点(默认值已写在 docker-compose.yml)
# ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
# 你的 API Key(DeepSeek 控制台申请:https://platform.deepseek.com)
ANTHROPIC_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# 模型选择(默认 deepseek-v4-pro,子任务 deepseek-v4-flash)
#
# 官方完整清单(截至 2026-04-28,via https://api-docs.deepseek.com/api/list-models):
#
# ✅ 当前推荐:
# deepseek-v4-pro 旗舰,1M 上下文,复杂推理 / 长会话;对标 Claude Opus
# deepseek-v4-flash 快速 / 便宜,1M 上下文;对标 Claude Sonnet / Haiku
#
# ⚠️ 旧版(2026-07-24 弃用,仅为兼容老脚本保留):
# deepseek-chat 实际路由到 v4-flash 的非思考模式
# deepseek-reasoner 实际路由到 v4-flash 的思考模式
#
# 注意:DeepSeek 不像 Anthropic 把 1M 上下文拆成独立 model id(如 claude-*-1m),
# v4-pro / v4-flash 默认就是 1M,无需额外后缀,也没有 -1m / -200k 变体。
#
# ANTHROPIC_MODEL=deepseek-v4-pro
# ANTHROPIC_SMALL_FAST_MODEL=deepseek-v4-flash # 子任务(commit message / 文件名等)
# =================================================================
# 仓库根目录(如果你的 6 个仓库不在 ai-ops 的父目录)
@@ -33,8 +63,3 @@ GIT_AUTHOR_EMAIL=you@example.com
# CLAUDE_CODE_USE_BEDROCK=1
# AWS_REGION=us-west-2
# AWS_PROFILE=default
# =================================================================
# 模型覆盖(默认 Opus 4.7,1M 上下文)
# =================================================================
# ANTHROPIC_MODEL=claude-sonnet-4-6
+5 -2
View File
@@ -9,7 +9,7 @@
## 前置条件
- **macOS / Linux**,装好 Docker Desktop(>= 4.30)并能拉公网镜像
- 有 **Claude Max 或 Pro 订阅**(或 Anthropic API Key)
- 有 **DeepSeek API Key**(默认)或 Claude Max/Pro 订阅 / 原生 Anthropic API Key
- 能访问 6 个业务仓库的 GitHub 权限(已配好 ssh-key 或 gh auth login)
## 快速上手(3 分钟)
@@ -282,7 +282,10 @@ tools: Read, Edit, Bash, Grep
—— 确认你的 Claude 订阅类型是 Max 或 Pro。Free 账号没有 Claude Code 权限。
**想切到 API Key 模式**
—— 编辑 `.env`,填 `ANTHROPIC_API_KEY=sk-ant-...`。API Key 优先级高于订阅。
—— 编辑 `.env`:
- 默认走 DeepSeek 的 Anthropic 兼容端点:`ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic` + `ANTHROPIC_API_KEY=sk-...`(DeepSeek 控制台申请),模型用 `deepseek-v4-pro` 或 `deepseek-v4-flash`。
- 想走原生 Anthropic:注释掉 `ANTHROPIC_BASE_URL`,填 `ANTHROPIC_API_KEY=sk-ant-...`。
API Key 优先级高于订阅。
## 不做什么
+3 -1
View File
@@ -13,7 +13,9 @@ services:
working_dir: /workspace
environment:
ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY:-}
ANTHROPIC_MODEL: ${ANTHROPIC_MODEL:-claude-opus-4-7}
ANTHROPIC_BASE_URL: ${ANTHROPIC_BASE_URL:-https://api.deepseek.com/anthropic}
ANTHROPIC_MODEL: ${ANTHROPIC_MODEL:-deepseek-v4-pro}
ANTHROPIC_SMALL_FAST_MODEL: ${ANTHROPIC_SMALL_FAST_MODEL:-deepseek-v4-flash}
CLAUDE_CODE_USE_BEDROCK: ${CLAUDE_CODE_USE_BEDROCK:-}
AWS_REGION: ${AWS_REGION:-}
AWS_PROFILE: ${AWS_PROFILE:-}
+1 -1
View File
@@ -42,7 +42,7 @@ done
cd "$AI_OPS_DIR"
if [[ ! -f .env ]]; then
cp .env.example .env
echo ">>> 已创建 .env(订阅模式无需改动;用 API Key 的话填上 ANTHROPIC_API_KEY)"
echo ">>> 已创建 .env —— 默认走 DeepSeek 端点,请填上 ANTHROPIC_API_KEY=sk-... 后再 make enter"
fi
echo ">>> 构建镜像(首次约 5 分钟)"