Skip to content

[Docs] 配置说明一页:干什么 / 默认 / 开了会怎样 / 和谁冲突 #290

Description

@modusensus

源自 #278 的讨论(配置说明缺位,用户与维护者两端都中招)与 #289 的定档口径。

现状

  • src/settings.js 的功能开关存在库里的 user_settings 表:面板可见,没有文件可改,也没有集中说明;
  • src/config.js 的 schema 键在宿主挂载时读,可注释即文档,但散在 schema 定义里,没有用户侧的汇总页。

交付物

一页配置说明(面板 + docs 各一份,同源生成优先),每条配置固定四栏:

栏 内容
干什么 一句话行为描述
默认 三档口径里的档位(#289:默认档/可选档/极简档)
开了会怎样 成本与行为变化(LLM 调用、注入时机、新增表面)
和谁冲突 与其他开关的互斥/覆盖关系(含 lightMode 的复位范围)

时机

随 #249 第二批的定档 PR 一起出(那次要对全部存量开关做一次默认档/可选档盘点,说明页跟着定档结果生成,不写两遍)。

不做

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions