配置

SpecForge 通过环境变量进行配置。所有配置均为可选 — 已提供合理的默认值。

环境变量

变量	描述	默认值
`SDD_DATA_DIR`	所有规格数据的存储路径（项目、模板、知识库）	`./data`
`SDD_HOURLY_RATE`	开发者每小时费率（美元），用于成本估算	`50`
`SDD_LOCALE`	生成内容的默认语言（`en`、`es`、`pt`）	`en`

Claude Desktop

在 MCP 服务器配置的 env 部分传递环境变量：

json

// claude_desktop_config.json
{
  "mcpServers": {
    "specforge": {
      "command": "npx",
      "args": ["-y", "specforge-mcp@latest"],
      "env": {
        "SDD_DATA_DIR": "/Users/me/specforge-data",
        "SDD_HOURLY_RATE": "120",
        "SDD_LOCALE": "en"
      }
    }
  }
}

共享数据目录

如果你跨多个项目工作，将 SDD_DATA_DIR 指向项目文件夹之外的稳定目录。SpecForge 将每个项目的数据存储在 {SDD_DATA_DIR}/projects/{hash}/ 下 — 不会产生冲突。

Claude Code

在添加 MCP 服务器之前设置环境变量，或在 shell 配置文件中导出它们：

bash

# 选项 1：添加时内联设置
SDD_HOURLY_RATE=120 claude mcp add specforge npx -y specforge-mcp@latest

# 选项 2：在 shell 配置文件中
export SDD_HOURLY_RATE=120
export SDD_LOCALE=en

语言区域

SpecForge 支持三种语言区域用于生成规格内容和消息：

代码	语言
`en`	英语
`es`	西班牙语
`pt`	葡萄牙语

你也可以在运行时更改语言区域，无需重启：

提示词："将语言区域设置为 es"

这会调用 set_locale，并立即将所有后续生成的内容切换为西班牙语。

数据存储

所有数据以 JSON 文件形式存储在本地 — 无云端、无账号、无遥测。

{SDD_DATA_DIR}/
├── projects/
│   └── {hash}/          # 每个项目一个目录（从项目路径哈希生成）
│       ├── specs/        # 该项目的所有规格
│       ├── metrics/      # 估算和质量指标
│       ├── patterns/     # 学到的模式
│       └── knowledge/    # 贡献的上下文和文档
└── global/
    ├── templates/        # 规格和 PLAN.md 模板
    └── pricing/          # 成本估算数据

添加到 .gitignore

如果 SDD_DATA_DIR 在你的项目内部，请将其添加到 .gitignore。默认的 ./data 目录通常是项目特定的，不应被提交。

用于估算的每小时费率

SDD_HOURLY_RATE 由 estimate 使用，将故事点估算转换为美元成本范围。将其设置为团队的平均混合费率，以获得最准确的估算。

# 个人开发者
SDD_HOURLY_RATE=80

# 机构费率
SDD_HOURLY_RATE=150

# 团队混合费率
SDD_HOURLY_RATE=95

配置 ​

环境变量 ​

Claude Desktop ​

Claude Code ​

语言区域 ​

数据存储 ​

用于估算的每小时费率 ​

配置