QIWEI-skill/.env.example

# Fmode 网关转发的企业微信接口
QIWEI_API_BASE=https://server.fmode.cn/api/qiwei

# 可选：稳定标识一个企微设备；留空时技能首次使用会自动生成并保存。
QIWEI_UID=

# 可选：通常会自动复用 Claude Code 已配置的 Fmode NewAPI sk- token。
# 也可以显式配置平台 sessionToken 或 Fmode API token。
QIWEI_AUTH_TOKEN=

# 语音合成只接受 Fmode API 控制台 /keys/ 创建的 sk- Token，不复用平台 sessionToken。
QIWEI_VOICE_AUTH_TOKEN=

# 企业微信接口访问凭据和设备上下文仅由 Fmode 网关管理，客户端无需配置。

# 产品运行模式：personal（个人版，本地主动监听）或 enterprise（企业版，服务端统一回调）。
# 留空时兼容旧项目：检测到完整 Relay 凭据则判断为企业版，否则为个人版。
QIWEI_PRODUCT_MODE=

# 可选：覆盖企业微信官方 CLI 程序缓存目录。
QIWEI_OFFICIAL_CLI_RUNTIME_DIR=

# 可选：覆盖官方 CLI 的本地加密认证目录；默认 ~/.config/wecom。
WECOM_CLI_CONFIG_DIR=

# ---- Relay 中央 Webhook 配置（可选） ----
# 仅企业版使用。中央 Relay 服务器地址，留空则企业 Relay 尚未就绪。
RELAY_BASE_URL=

# Relay 租户凭证（可由 qiwei_relay_register 自动写入）
TENANT_API_KEY=
TENANT_API_SECRET=
TENANT_ID=

# RSA 私钥，必须写成单行，用 \n 替换真实换行符
RELAY_PRIVATE_KEY=

# 仅限个人版、独立服务 Token 和独立公网部署。默认关闭，普通个人版使用本地主动监听。
QIWEI_ALLOW_DIRECT_CALLBACK=false

# ---- 智能会话监听与白名单 ----
# 留空时监听器会拒绝启动，避免误回复真实客户。
QIWEI_AUTO_REPLY_ALLOWED_SENDERS=
QIWEI_AUTO_REPLY_SELF_USER_ID=
QIWEI_AUTO_REPLY_INTERVAL_MS=10000

# ---- 4320 智能会话 Agent（真实消息 + 人工监管） ----
# 默认启动待审核监听；人工关闭后会持久保持关闭，不会被后台自动拉起。
QIWEI_AGENT_GLOBAL_DEFAULT_PAUSED=false
QIWEI_AGENT_DEFAULT_MODE=review
QIWEI_AGENT_AUTO_SEND_CONFIDENCE=0.88
QIWEI_AGENT_DB_PATH=
QIWEI_AGENT_KNOWLEDGE_DIR=./knowledge
QIWEI_AGENT_CONTEXT_FILES=personality.md,context.md,rules.md
QIWEI_AGENT_CONTEXT_CHAR_LIMIT=6000
QIWEI_AGENT_INITIAL_SYNC_LIMIT=5000
QIWEI_AGENT_INITIAL_SYNC_MAX_PAGES=200
QIWEI_AGENT_STARTUP_GRACE_SECONDS=10

# 新私聊接入默认仅限白名单。可选：allowlist_only / auto_enroll_review / auto_enroll_autopilot。
# 全自动接入仍必须在 Dashboard 中由管理员二次确认；环境变量不能绕过确认。
QIWEI_PERSONAL_INTAKE_MODE=allowlist_only
QIWEI_WELCOME_ENABLED=false
QIWEI_WELCOME_TEXT=您好，已经收到您的消息，我会尽快为您处理。
QIWEI_WELCOME_SEND_MODE=draft

# 可选：额外生成便于检索的 JSONL 消息流水。默认关闭；Workbench 数据库归档不受影响。
QIWEI_MESSAGE_ARCHIVE_ENABLED=0

# 可选：为每位联系人生成并允许 Agent 维护通用五文件记忆。默认关闭。
QIWEI_AGENT_MEMORY_ENABLED=0

# 客服回复时效监控（仅本地提醒，不自动发送企微消息）
QIWEI_RESPONSE_REMINDER_MINUTES=15
QIWEI_RESPONSE_URGENT_MINUTES=60

# ---- Fmode 声音克隆与企微语音 ----
# 默认复用上面的 Fmode Token，无需单独配置语音服务密钥。
QIWEI_VOICE_ENDPOINT=https://server.fmode.cn/api/voice/indextts2
QIWEI_TTS_TIMEOUT_MS=180000

# 合成走 /api/voice/indextts2；企微语音媒体通过 /api/qiwei/doFileApi 直传。

# Agent 模型。密钥只放 .env.local 或用户级模型配置，禁止提交到仓库。
AGENT_PROVIDER=claude-code
AGENT_API_KEY=
AGENT_BASE_URL=
AGENT_MODEL=
AGENT_MAX_TOOL_ROUNDS=4
QIWEI_AGENT_PROMPT_CHAR_LIMIT=16000
QIWEI_AGENT_SYSTEM_PROMPT_CHAR_LIMIT=12000
QIWEI_AGENT_QUALITY_PASS_SCORE=82
# 可选：按项目覆盖通用客服目标和阶段策略；不要在通用包中硬编码行业目标。
QIWEI_AGENT_BUSINESS_GOAL=
QIWEI_AGENT_STAGE_PLAYBOOK=
# 可选：通用阶段引擎与条件-动作规则。JSON 中不得包含业务凭据；行业项目通过覆盖层配置。
QIWEI_AGENT_REQUIRED_PROFILE_FIELDS=
QIWEI_AGENT_SALES_GUIDELINES_JSON=
QIWEI_AGENT_JOURNEY_JSON=

# 推荐：直接使用客户项目中的 Claude Code + Fmode 配置生成草稿。
CLAUDE_CODE_EXECUTABLE=
CLAUDE_CODE_WORKDIR=.
CLAUDE_CODE_SESSION_FILE=
CLAUDE_CODE_TIMEOUT_MS=45000
CLAUDE_CODE_MAX_BUDGET_USD=1
CLAUDE_CODE_RETRY_MAX_BUDGET_USD=3
CLAUDE_CODE_ALLOWED_TOOLS=Read,Glob,Grep
CLAUDE_CODE_SESSION_MAX_TURNS=12
CLAUDE_CODE_SESSION_MAX_AGE_MS=86400000

# Hermes-style 本地分层记忆。完整消息仍在 Workbench DB，只有核心事实和相关历史进入本轮上下文。
QIWEI_AGENT_MEMORY_ENABLED=true
QIWEI_AGENT_MEMORY_CORE_CHAR_LIMIT=4000
QIWEI_AGENT_MEMORY_RECALL_LIMIT=6
QIWEI_AGENT_MEMORY_RECENT_MESSAGES=12
QIWEI_AGENT_MEMORY_HISTORY_SCAN_LIMIT=240
QIWEI_AGENT_MEMORY_EXTRACTION_INTERVAL_MS=1000
QIWEI_AGENT_MEMORY_EXTRACTION_RETRY_BASE_MS=1000
QIWEI_AGENT_MEMORY_EXTRACTION_MAX_ATTEMPTS=3

# 可选：绑定项目主控 Claude Code Session。未配置时仍会生成项目级控制器标识，客户 Session 保持独立。
QIWEI_AGENT_PROJECT_ID=
QIWEI_AGENT_MAIN_SESSION_ID=

# Optional ESM runtime config path. The installer creates qiwei.runtime.config.mjs in the customer project.
QIWEI_RUNTIME_CONFIG=

# Existing pre-isolation data is assigned to this account space during migration.
QIWEI_LEGACY_ACCOUNT_KEY=legacy-default