declaude

declaude

将 Claude 英语转换为简明英语，作为一项服务提供。
去掉谄媚的开场白、空洞的最高级表达和犹豫不决的赘词。
完整保留原意、代码和结构。

---

Before  "Great question! Before I answer, let me make sure I understand what
        you're asking. You want to know why the build is failing. Let me walk
        through my thinking, and then I'll give you the answer."

After   "I understand you want to know why the build is failing. Here's what
        I think is happening."

Before  "One thing I didn't touch, but you won't want to leave hanging, is the
        migration script. I'd be happy to walk you through it whenever you're
        ready!"

After   "One thing I didn't cover is the migration script. When you're ready,
        I can go through it with you."

服务运行于我们自己的 L4 GPU 上，使用开源模型 Qwen2.5-14B-AWQ，因此你的文本不会发送给任何商业 AI 服务提供商。模型服务已禁用提示词日志：文本仅在内存中处理，随后即被丢弃，绝不会写入磁盘、数据库或日志。

在线使用：speak-english.tenken.co · 获取 API 密钥 · 翻译文档

	免费	$5 / 月
翻译次数	100 次 / 月	不限
文档	5 份 / 月，200 KB	500 份 / 月，2 MB
是否需要银行卡	否	是

快速开始

在 Claude Code 中安装插件。它会提供技能并注册钩子：

/plugin marketplace add tenkenco/declaude
/plugin install declaude@tenken

然后运行 /declaude:setup。它会安全迁移任何手动配置的钩子，并设置 dk_ 密钥。 Claude Code 会将密钥存储在安全的插件配置中。只要密钥存在，钩子就会改写回复。将 hook_enabled 选项设为 false 即可停止钩子。没有密钥时，钩子会保持静默，且绝不会阻塞会话。

若要单独使用 MCP 服务，可在 Claude Code 或任何其他 MCP 客户端中运行：

claude mcp add --transport http declaude https://speak-english.tenken.co/mcp

无需粘贴 API 密钥：客户端会自动发现 OAuth、打开浏览器进行登录，并保存令牌。设置就是这么简单。

使用方式	适用场景	文档
MCP 服务	Claude Code、Cursor 和任何 MCP 客户端。工具：translate、usage	技能
Claude Code 钩子	在回复显示时即时改写，不消耗 Claude 令牌。由插件注册	hook/
文档	上传 .md/.txt 文件，获取改写后的文件	网页
REST API	POST /v1/translate、/v1/documents、/v1/usage	技能
兼容 OpenAI	POST /v1/chat/completions — 将任何 OpenAI 客户端指向 /v1	技能

完整的用法、身份验证和配额说明请参阅 skills/declaude/SKILL.md — 可作为 Agent 技能安装，让你的 Agent 能直接读取。

架构

client ── API key / OAuth / Clerk JWT ──> Cloud Run gateway ── VPC ──> internal LB ──> vLLM GPU MIG
                                              │                                    (Qwen2.5-14B, spot L4)
                                              ├─> Firestore (usage, paid flags, key hashes)
                                              └─> Stripe (payment link + signed webhooks)

• gateway/ — FastAPI。所有边界均可注入，因此测试套件无需网络、GPU 或云凭据即可运行。
• infra/ — Terraform，状态存储在 GCS 中，计划执行后差异归零。GPU 层采用私有 IP 的竞价实例，位于内部 L7 负载均衡器后方。
• hook/ — Claude Code 钩子客户端。发生故障时默认放行，绝不会阻塞会话。
• hooks/ — hooks.json，Claude Code 安装时读取的插件注册文件。
• CI — 每个 PR 都会运行 lint、测试和覆盖率检查；每天运行安全扫描和生产环境冒烟测试。

运维说明

• Google Frontend 在 run.app 上保留了 /healthz，请使用 /health。
• 切换模型只需修改一个 Terraform 变量；32B 需要 2×L4（需提升配额），14B 可使用一块 L4。
• MIG 模板滚动更新是有意设置的（OPPORTUNISTIC）：主动更新策略曾将无害的模板编辑变成突发的 15 分钟中断。
• 密钥仅存储在 Secret Manager 中。API 密钥以 SHA-256 摘要形式存储，因此数据库泄露也不会暴露可用凭据。
• 模型服务器已禁用提示词日志记录；请求文本仅在内存中处理，随后即被丢弃。
• 采用测试优先的开发方式。试用过程中发现的每个生产缺陷，都会先转化为回归测试，再进行修复。

开发

cd gateway
uv sync --dev
uv run pytest -q          # 197 tests
uv run ruff check .

致谢

本项目源自 gvzdv/claudish-to-english，这是最初的本地 Ollama 钩子。采用 MIT 许可证；上游声明见 THIRD_PARTY_LICENSES.md。