菜单
StoryMoss 全部配置轴：选项、默认值、生产 vs 实验、守卫、如何新增。何时加载：要改生成模式、要改并发/超时、要加 PromptRegistry 覆盖、要调体裁模板、要改 silent_background 白名单、要动 rustfmt、或被问“在哪配/默认是什么/这个开关干啥”时。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
运行/部署 StoryMoss 的命令解剖、运行时数据与产物落点。何时加载：要启动应用、要找日志、要找数据库/配置文件、要发布 tag、要看生成链路日志、或被问“日志在哪/数据在哪/怎么发布”时。
Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.
StoryMoss 承重设计决策与 WHY、必须成立的不变量、已知弱点。何时加载：要改架构、要动数据真相源、要改生成链路、要改 IPC/SyncEvent、要动数据库层、要评估“能不能这样改”、或被问“为什么这样设计/哪些不能动”时。改任何符号前先用 gitnexus impact。
从零重建 StoryMoss 开发与构建环境，含已知陷阱。何时加载：首次 clone 后要跑起来、换机器、CI 本地复现、`cargo tauri dev/build` 报环境错、前端起不来、跨平台构建失败、或被问“怎么构建/怎么跑”时。
StoryMoss 变更门禁与不可破坏项。何时加载：要提交/推送代码、要 bump 版本、要改架构边界、要动数据库迁移、要改 CI、要发布 tag、要合并 feature 分支、或被问“能不能直接改/直接推”时。也用于判断一个改动是否需要用户授权（R10）。
StoryMoss 失败模式的症状→分诊表、卡时间的陷阱与区分实验。何时加载：报告了 bug、续写卡死、Genesis 第一章重复、生成无输出、启动崩溃、CI 失败、JSON 解析空对象、超时、白屏、或被问“为什么 X 失败/卡住”时。先建反馈回路再下结论（见 diagnose 技能 Phase 1）。
| name | sf-config-and-flags |
| description | StoryMoss 全部配置轴：选项、默认值、生产 vs 实验、守卫、如何新增。何时加载：要改生成模式、要改并发/超时、要加 PromptRegistry 覆盖、要调体裁模板、要改 silent_background 白名单、要动 rustfmt、或被问“在哪配/默认是什么/这个开关干啥”时。 |
src-tauri/src/agents/orchestrator.rs 等。四值并存：
| 模式 | 路径 | 用途 | 默认 |
|---|---|---|---|
Fast | Ghost Text 实时补全 | 单句续写 | 幕前幽灵文本 |
TimeSliced | 三时间线（写/审/洞察） | 普通生成 / auto_write / auto_revise | 默认 |
Full | 同步审计 + Rewrite 闭环 | 向导 / Genesis / Planner / Workflow | 创世等高质量路径 |
TriShot | Call1→Call2→Call3 + 预算守卫 | 快速首章 / PlanExecutor 快路径 | 可在设置页选 |
切换：前端「三击模式」配置项；TimeSliced 写作策略从 AppConfig 读取用户配置。
| 开关 | 位置 | 默认 | 说明 |
|---|---|---|---|
BACKGROUND_LLM_SEMAPHORE | agents/orchestrator.rs:40（定义；llm/service.rs 引用） | 1（串行） | 后台 LLM 调用全局串行化；ParallelWorldOutlineCharacterStep 已由 tokio::join! 3 路改串行 + 此信号量全覆盖 |
is_silent_background 白名单 | src-tauri/src/llm/service.rs | 见文件 | 后台 LLM 调用 label 加入后不触发前端主活动；新增后台 LLM 调用必须登记 |
| 候选超时 | config/settings_tests.rs 默认 | 远程 candidate_timeout_seconds=180 / 本地 candidate_timeout_local_seconds=120 | 默认值；用户可在设置改 |
| 续写 call3 超时 | agents/orchestrator.rs（v0.26.22 Bug C 注释，约 1599 行） | 60s（原 120s） | 慢模型 fail-fast 回退快模型 |
| 死模型退避 | 网关 | 30→60→120→…→3600s | 指数退避 |
| keepalive 刷新 | 网关 | 10s | is_health_fresh() 跳过内联 5s 探测 |
SceneCommitDebouncer | story_system/scene_service.rs | 30s | 场景内容变更后防抖 auto_commit |
| 自动保存 debounce | 前端编辑器 | 2s / 200ms（onChange） | store 回写 |
| LLM 输出自重复闸门 | narrative/genesis.rs | ≥8% 重试一次 | anti-repeat 指令；prompt 模板含「结构纪律」段 |
src-tauri/src/prompts/registry.rs：21 个 PromptCategory（枚举实测）。内置 prompt 数随版本增长，以 registry.rs 源码为准（ROADMAP v0.19.0 记 79，rg -c 'name:' src-tauri/src/prompts/registry.rs 实测约 61——以源码为准，文档数字可能滞后）。resolve_prompt() 运行时优先读 DB 覆盖。前端「设置→提示词」可编辑/批量重置/导入导出。新增 prompt：注册到 registry.rs，消费方（Writer/Inspector/Commentator/Planner/Analyzer/Probe/Memory/Knowledge/Skill/Methodology）通过 resolve_prompt_content 取。
启动时优先读 <app_data_dir>/templates/genres.json，缺失回退内置 43 体裁（templates/genres.json count:43；strategy/models.rs "43 个网文模板"）。模板五要素：核心基调、节奏策略、反模式清单、参考数据表、典型结构。GenreResolver 解析复合题材（v0.22.4 异星球末世生存）。新增体裁：编辑 genres.json 或 Migration 96+ 的种子数据。
SyncEvent/FrontstageEvent/BackstageEvent 加 #[derive(TS)] → 自动生成到 src-frontend/src/generated/。assertUnreachable(x: never) 在 default 分支兜底，新增 variant 时编译失败。scripts/verify-ipc-manifest.py 解析 generate_handler![] 与前端 loggedInvoke，未注册命令报 ERROR。rustfmt.toml（仓库根目录）：max_width=100、imports_granularity=Crate、group_imports=StdExternalCrate、wrap_comments=true。format_strings 已注释禁用（跨平台 nightly 不一致）。前端 prettier 默认配置。CI 在 src-tauri/ 下跑 cargo +nightly fmt -- --check（rustfmt 会向上查找根目录 rustfmt.toml），前端跑 npm run format:check。
AppConfig（src-tauri/src/config/）加字段 + 默认值 + serde 兼容（#[serde(default)]）。commands/）+ DTO。services/api/settings.ts 加 IPC 调用 + 设置页 UI。config/settings_tests.rs 测试（默认值/round-trip/向后兼容）。ARCHITECTURE.md 与 docs/USER_GUIDE.md。cargo test --lib config、npx tsc --noEmit。sf-change-control（改默认值/影响生成行为属变更，可能需用户授权 R10）+ sf-validation-and-qa（证据标准）+ 推送门（docs 同步 + CI 必查）。sf-validation-and-qa。sf-architecture-contract。sf-debugging-playbook（卡死陷阱）。rg -n 'is_silent_background|BACKGROUND_LLM_SEMAPHORE' src-tauri/src/llmrg -n 'GenerationMode::' src-tauri/src | head -20cat rustfmt.toml（仓库根，不是 src-tauri/）rg -n 'resolve_prompt' src-tauri/src/prompts/registry.rs | head