feat(权限): 收敛普通账号写权限至本人凭证

将调度时刻、采集参数等实例级配置收归管理员，普通账号仅可维护本人 Cookie 与 User-Agent。新增 config.writable_by 作为唯一写权限入口，set_setting 强制全局键落到 user_id=0，消除「管理员改了只有自己生效」的静默缺陷。新增 tools/check_docs.py 文档自检， smoke 断言扩至 215 项、check_live 扩至 122 项并支持普通账号越权验收，忽略 backups/、data/*.bak* 与 legacy-v1/，版本升至 v1.3.0。
2026-09-18 08:46:00 +08:00
@@ -29,7 +29,11 @@
    <a href="{{ url_for('views.records') }}"   class="{{ 'on' if nav=='records' }}">数据明细</a>
    <a href="{{ url_for('views.tasks') }}"     class="{{ 'on' if nav=='tasks' }}">任务管理</a>
    <a href="{{ url_for('views.config_page') }}" class="{{ 'on' if nav=='config' }}">配置管理</a>
+    {# 日志管理里是实例运行信息（数据库路径 / 账号名 / 来源 IP），仅管理员可见；
+       服务端另有 @admin_required 兜底，这里隐藏只是不给出会 403 的死链。 #}
+    {% if cur.is_admin %}
    <a href="{{ url_for('views.logs') }}"      class="{{ 'on' if nav=='logs' }}">日志管理</a>
+    {% endif %}
    {% if cur.is_admin %}
    <a href="{{ url_for('views.users_page') }}" class="{{ 'on' if nav=='users' }}">用户管理</a>
    {% endif %}
@@ -37,7 +41,8 @@
  <div class="me">
    <a class="who" href="{{ url_for('views.profile_page') }}" title="个人中心">
      <b>{{ cur.display_name }}</b>
-      {% if cur.is_admin %}<span class="tag accent">管理员</span>{% endif %}
+      {% if cur.is_admin %}<span class="tag accent">管理员</span>
+      {% else %}<span class="tag mute">普通账号</span>{% endif %}
    </a>
    {# 退出用 POST + CSRF：GET 型退出会被 <img src="/logout"> 这类请求静默触发 #}
    <form method="post" action="{{ url_for('views.logout_post') }}" style="margin:0">
@@ -60,8 +65,8 @@
 </main>

 <footer class="foot">
-  <b>{{ project_title }}</b> · {{ project_name }} · 多用户 · 采集在 Web 进程内按各账号配置的时刻执行<br>
-  每个账号只使用并只见得到自己的 Cookie 与用量数据；数据正本 <code>data/usage.sqlite</code>
+  <b>{{ project_title }}</b> · {{ project_name }} · 多用户 · 调度与采集参数由管理员统一设定<br>
+  每个账号只使用并只见得到<b>自己的</b> Cookie 与用量数据；数据正本 <code>data/usage.sqlite</code>
 </footer>

 <script>
@@ -5,7 +5,11 @@
 <div class="pagehead">
  <div>
    <h1>配置管理</h1>
-    <p class="lead">这里改的都是<b>你自己账号</b>的配置：凭证、采集参数、维护动作；改完立即生效</p>
+    {% if is_admin %}
+    <p class="lead">凭证、采集参数、接口地址与注册策略都在这里；改完立即生效</p>
+    {% else %}
+    <p class="lead">这里维护<b>你自己账号</b>的云端凭证；采集参数与调度由管理员统一设定，只读展示</p>
+    {% endif %}
  </div>
 </div>

@@ -29,6 +33,9 @@
    任选一个 <code>billing</code> 请求 → 复制 Request Headers 里的 <code>cookie</code> 与 <code>user-agent</code>
    （<b>两者必须取自同一次请求</b>），粘贴到下面。
    <br><b>请粘贴你自己账号的 Cookie</b>：采集只使用本人凭证，各账号的数据互不可见。
+    {% if not is_admin %}
+    <br><b>这一块是你唯一可以修改的配置</b> —— 其余参数与调度时刻由管理员统一设定。
+    {% endif %}
  </p>
  <form id="formCred">
    <label class="col">Cookie
@@ -44,18 +51,21 @@

 <div class="grid2">
  <section class="card">
-    <h2>采集参数</h2>
+    <div class="cardhead">
+      <h2>采集参数</h2>
+      {% if is_admin %}
+      <span class="tag accent">实例级 · 对所有账号生效</span>
+      {% else %}
+      <span class="tag mute">只读 · 仅管理员可改</span>
+      {% endif %}
+    </div>
+    {% if is_admin %}
    <form id="formCollect">
-      {# 实例级键：所有账号共用，只有管理员能改；普通账号只读展示 #}
-      <label class="row"><span>接口基址</span>
-        <input name="api_base" value="{{ s.api_base }}" spellcheck="false"
-               {{ '' if is_admin else 'disabled' }}>
-        {% if not is_admin %}<em class="unit">实例级，仅管理员可改</em>{% endif %}</label>
-      <label class="row"><span>接口路径</span>
-        <input name="api_path" value="{{ s.api_path }}" spellcheck="false"
-               {{ '' if is_admin else 'disabled' }}>
-        {% if not is_admin %}<em class="unit">实例级</em>{% endif %}</label>
      {% set b = num_settings %}
+      <label class="row"><span>接口基址</span>
+        <input name="api_base" value="{{ s.api_base }}" spellcheck="false"></label>
+      <label class="row"><span>接口路径</span>
+        <input name="api_path" value="{{ s.api_path }}" spellcheck="false"></label>
      <label class="row"><span>分页大小</span>
        <input name="page_size" type="number" min="{{ b.page_size[0] }}" max="{{ b.page_size[1] }}" value="{{ s.page_size }}">
        <em class="unit">{{ b.page_size[0] }}~{{ b.page_size[1] }} 条/页</em></label>
@@ -82,8 +92,23 @@
      </label>
      <p class="hint">Cookie 就是账号凭证，关掉证书校验等于把它暴露给中间人，非必要不要关。</p>
      <button class="btn primary" type="submit">保存采集参数</button>
-      <p class="hint">整日校验会按天重新拉云端 total 与本地比对，发现缺记录自动补入；设为 0 表示关闭（日常够用）。</p>
+      <p class="hint">整日校验会按天重新拉云端 total 与本地比对，发现缺记录自动补入；设为 0 表示关闭（日常够用）。
+        这些是<b>实例级</b>参数，改一次对本机所有账号生效。</p>
    </form>
+    {% else %}
+    <p class="hint">这些参数影响采集行为与云端压力，属于整机策略，普通账号只读。</p>
+    <table class="kv">
+      <tr><th>接口基址</th><td class="mono">{{ s.api_base }}</td></tr>
+      <tr><th>接口路径</th><td class="mono">{{ s.api_path }}</td></tr>
+      <tr><th>分页大小</th><td>{{ s.page_size }} 条/页</td></tr>
+      <tr><th>断点回退</th><td>{{ s.rewind_minutes }} 分钟</td></tr>
+      <tr><th>时间漂移容差</th><td>{{ s.drift_tolerance_minutes }} 分钟</td></tr>
+      <tr><th>Prompt 截断</th><td>{{ s.max_prompt }} 字符{% if s.max_prompt == '0' %}（不截断）{% endif %}</td></tr>
+      <tr><th>整日校验天数</th><td>{{ s.verify_days }} 天</td></tr>
+      <tr><th>请求超时</th><td>{{ s.timeout }} 秒</td></tr>
+      <tr><th>校验 TLS 证书</th><td>{% if s.ssl_verify != '0' %}<span class="tag ok">校验</span>{% else %}<span class="tag bad">不校验</span>{% endif %}</td></tr>
+    </table>
+    {% endif %}
  </section>

  <section class="card">
@@ -118,6 +143,22 @@
  </section>
 </div>

+{% if not is_admin %}
+<section class="card">
+  <div class="cardhead">
+    <h2>为什么采集参数是只读的</h2>
+    <span class="tag mute">普通账号</span>
+  </div>
+  <p class="hint" style="margin:0">
+    你只能维护<b>本人账号的凭证</b>（Cookie 与 User-Agent）—— 采集始终只用你自己的这份凭证，
+    拿回来的数据也只会存在你自己的作用域里，别人看不到、你也看不到别人的。
+    分页大小、超时、接口地址、TLS 校验、调度时刻这些属于<b>整机策略</b>：它们既关系到云端
+    压力，也关系到所有人的采集是否安全，因此统一由管理员设定。
+    <br>如果你确实需要调整，把上面任意一项截图给管理员即可。
+  </p>
+</section>
+{% endif %}
+
 {% if is_admin %}
 <section class="card">
  <div class="cardhead">
@@ -5,7 +5,7 @@
 <div class="pagehead">
  <div>
    <h1>日志管理</h1>
-    <p class="lead">采集逐次日志、应用运行日志与操作审计</p>
+    <p class="lead">本机全实例的采集日志、应用运行日志与操作审计（仅管理员可见）</p>
  </div>
  <div class="actions">
    <button class="btn" id="btnTail" type="button">刷新应用日志</button>
@@ -49,12 +49,13 @@
  </div>
  <div class="tablewrap">
    <table class="tbl">
-      <thead><tr><th>#</th><th>开始</th><th>触发</th><th>状态</th><th class="num">耗时</th>
+      <thead><tr><th>#</th><th>账号</th><th>开始</th><th>触发</th><th>状态</th><th class="num">耗时</th>
        <th class="num">新增</th><th class="num">重复</th><th class="num">冲突</th><th>结论</th><th></th></tr></thead>
      <tbody>
      {% for r in runs %}
        <tr>
          <td>{{ r.id }}</td>
+          <td>{{ r.uname }}</td>
          <td class="mono nowrap">{{ r.started_at[5:] if r.started_at else '—' }}</td>
          <td><span class="tag {{ 'info' if r.trigger=='schedule' else ('accent' if r.trigger=='startup' else 'mute') }}">{{ r.trigger }}</span></td>
          <td class="nowrap">
@@ -70,7 +71,7 @@
          <td><a href="{{ url_for('views.logs', run=r.id, status=status or none) }}">详情</a></td>
        </tr>
      {% else %}
-        <tr><td colspan="10" class="empty">暂无采集日志</td></tr>
+        <tr><td colspan="11" class="empty">暂无采集日志</td></tr>
      {% endfor %}
      </tbody>
    </table>
@@ -58,8 +58,10 @@
      <tr><th>Cookie</th><td>{% if mf.health.cookie %}<span class="tag ok">已配置</span>{% else %}<span class="tag bad">未配置</span> <a href="{{ url_for('views.config_page') }}">去配置</a>{% endif %}</td></tr>
      <tr><th>服务器时间</th><td class="mono">{{ sch.now }}</td></tr>
    </table>
-    <p class="hint">调度在 Web 进程内运行，不再需要计划任务或外部自动化。所有时刻与开关都在
-      <a href="{{ url_for('views.tasks') }}">任务管理</a>里改。</p>
+    <p class="hint">调度在 Web 进程内运行，不再需要计划任务或外部自动化。
+      {% if current_user().is_admin %}所有时刻与开关都在
+      <a href="{{ url_for('views.tasks') }}">任务管理</a>里改。{% else %}时刻由管理员统一设定，
+      你可以在<a href="{{ url_for('views.tasks') }}">任务管理</a>里查看，也可以随时手动采集本人数据。{% endif %}</p>
  </section>

  <section class="card">
@@ -98,7 +100,8 @@
      <tbody>
      {% for r in runs %}
        <tr>
-          <td><a href="{{ url_for('views.logs', run=r.id) }}">{{ r.id }}</a></td>
+          {# 运行详情在「日志管理」里，而那页仅管理员可达 —— 普通用户不要给死链 #}
+          <td>{% if current_user().is_admin %}<a href="{{ url_for('views.logs', run=r.id) }}">{{ r.id }}</a>{% else %}{{ r.id }}{% endif %}</td>
          <td><span class="tag {{ 'info' if r.trigger=='schedule' else ('accent' if r.trigger=='startup' else 'mute') }}">{{ r.trigger }}</span></td>
          <td class="mono">{{ r.started_at[5:] if r.started_at else '—' }}</td>
          <td class="num">{{ ((r.duration_ms or 0) / 1000) | round(1) }}s</td>
@@ -5,7 +5,7 @@
 <div class="pagehead">
  <div>
    <h1>任务管理</h1>
-    <p class="lead">调度在 Web 进程内执行，采集互斥由文件锁保证；这里也能手动触发与按区间回填</p>
+    <p class="lead">调度在 Web 进程内执行，采集互斥由文件锁保证；这里能看到本人账号的运行历史，也能手动触发与按区间回填</p>
  </div>
  <div class="actions">
    <button class="btn primary" id="btnCollect" type="button">立即采集一次</button>
@@ -15,7 +15,11 @@

 <div class="grid2">
  <section class="card">
-    <h2>采集调度</h2>
+    <div class="cardhead">
+      <h2>采集调度</h2>
+      {% if not can_edit %}<span class="tag mute">只读 · 仅管理员可改</span>{% endif %}
+    </div>
+    {% if can_edit %}
    <form id="formTask">
      <label class="row"><span>启用调度</span>
        <select name="schedule_enabled">
@@ -26,8 +30,8 @@
      <label class="row"><span>每日时刻</span>
        <input name="schedule_times" value="{{ s_times }}" placeholder="09:00,17:00" spellcheck="false">
      </label>
-      <p class="hint">本地时区，逗号分隔，支持 <code>HH:MM</code>（也可只写 <code>9</code>）。保存后立即生效，
-        并会清空当天已执行的槽位标记以便新时刻接管。</p>
+      <p class="hint">本地时区，逗号分隔，支持 <code>HH:MM</code>（也可只写 <code>9</code>）。
+        保存后立即生效；已经过去且不再存在的时刻会被清掉，新的时刻当天就会接管。</p>
      <label class="row"><span>启动补跑</span>
        <select name="catch_up">
          <option value="1" {{ 'selected' if sch.catch_up }}>开启（错过的时刻在宽限期内补跑）</option>
@@ -39,7 +43,21 @@
        <em class="unit">小时（超过就不补，避免开机狂刷）</em>
      </label>
      <button class="btn primary" type="submit">保存调度配置</button>
+      <p class="hint">这套时刻是<b>实例级</b>的：本机上所有账号在同一个时刻各自采集自己的数据。</p>
    </form>
+    {% else %}
+    <table class="kv">
+      <tr><th>启用调度</th><td>{% if sch.enabled %}<span class="tag ok">已启用</span>{% else %}<span class="tag bad">已停用</span>{% endif %}</td></tr>
+      <tr><th>每日时刻</th><td>{{ sch.times | join(' · ') if sch.times else '—' }}</td></tr>
+      <tr><th>启动补跑</th><td>{% if sch.catch_up %}<span class="tag">开启</span>（宽限 {{ s_grace }} 小时）{% else %}关闭{% endif %}</td></tr>
+      <tr><th>下次执行</th><td class="mono">{{ sch.next_run or '—' }}</td></tr>
+    </table>
+    <p class="hint">
+      调度时刻与采集参数由<b>管理员统一设定</b>，普通账号只读。
+      你随时可以在右上角点「立即采集一次」拉取本人账号的最新用量，
+      也可以在下面按区间补采自己的历史数据 —— 采集始终只用<b>你自己的</b> Cookie。
+    </p>
+    {% endif %}
  </section>

  <section class="card">
@@ -96,7 +114,10 @@
          <td class="num">{{ r.dup }}</td>
          <td class="num">{% if r.conflicts %}<span class="tag warn">{{ r.conflicts }}</span>{% else %}0{% endif %}</td>
          <td>{{ r.message or '—' }}</td>
-          <td><a href="{{ url_for('views.logs', run=r.id) }}">日志</a></td>
+          <td>
+            {% if can_edit %}<a href="{{ url_for('views.logs', run=r.id) }}">日志</a>
+            {% else %}<span class="muted">—</span>{% endif %}
+          </td>
        </tr>
      {% else %}
        <tr><td colspan="12" class="empty">暂无运行记录</td></tr>