每日进度

一个团队共用的专案进度面板：每个人每天把自己负责的专案进展记一条；系统自动按专案归类、最新置顶，并能按周自动产出周报。所有内容实时同步到后台的 Google Sheet。

• 🗂️ 专案进度总览 — 给上级看的总览：每个专案的整体进度 + 各功能模块做到哪一步、卡在哪。顶部切换专案。
• 📋 每日进度 — 团队日常主页面：新增专案、给专案追加每天的进度、查看各专案折叠列表（顶部可切换只看某个专案）。周报、总览的「最近进展」都来自这里。
• 🗓️ 周报 — 选周次自动汇总成周报，可一键写入「周报存档」分页。
• 📊 汇总看板 — 专案数、进行中、已完成、阻塞、累计耗时等总览数字。「按专案」表里的「进度%」与「专案进度总览」同源（都取该专案 进度看板.md 的整体进度），所以两处永远一致；该专案还没有 进度看板.md 时，才退回显示它每日进度里最新填的那个百分比。
• ❓ 使用说明 — 本页。

左上角 ☰ 可收合 / 展开整个选单（收合后只剩图标，画面更宽）。

1. 开新专案：点主页面顶部「＋ 新增专案」展开，填专案名、团队、负责人、今日内容等 → 「建立专案」。以后这个专案就会出现在下方列表。
2. 每天追加进度：在对应专案卡片上点一下展开，最底部有一行填写格子（和上面各列对齐），直接填当天的：日期(默认今天)、负责人、类别、进度状态、进度%、今日内容、阻碍、所需协助、耗时、明日计划、证据 → 点该行「提交」。最新一条会自动排到最上面。
3. 每周出周报：到「🗓️ 周报」选这一周 → 自动生成 → 点「📥 生成并写入周报存档」存档。

💡 同一个专案通常属于同一团队，追加进度时团队会自动沿用，不用每次选。

「每日进度」记的是每天做了什么（细节）；「专案进度总览」回答的是整体做到哪、主要功能各到哪一步——专门给不看代码的上级。每个专案显示：整体进度环、最近一条进展、各功能模块的状态与进度条、当前阻碍/待协助、以及成品 DEMO / GitHub 链接。

这些「功能模块进度」从哪来？来自每个专案仓库根目录的一个文件 进度看板.md。每行一个模块，格式：

模块名 | 状态 | 进度% | 一句话说明

• 状态只用四种：待开始 / 进行中 / 待协助 / 已完成。
• 可选首行 整体: NN%（不写就自动取各模块平均）。
• 改完 push 到仓库，总览会自动刷新；只改 进度看板.md 不会算进每日进度。
• 各专案的 Claude Code 会按 CLAUDE.md 规则自动维护这个文件，一般不用手动改；要手动调也可以（在仓库里改或在面板里调）。

• 进度状态（今天这条任务）： 进行中 已完成 未开始 阻塞
• 证据：自动放 GitHub 链接 + 专案「🔗 成品链接」（DEMO/成品页，专案卡设一次即可，自动进证据）。网址可点击。
• 备注：自动写「当日提交数/改动文件数」；若本次提交含 .html 网页/说明文件，会自动列出并标注类型（指南/说明文档/演示页）。
• 进度%：0–100，填这条任务的完成度。通过 TG 机器人填报时会提示前一天是多少%供参考（不强制，可比它低 / 高 / 相同，按实际填）。
• 阻碍：还没拿到的资料，或 Claude/你需要什么才能继续（自动进度会从提交里判断，没有就留空）。所需协助：要拿到什么资料、或需要谁配合做什么才能往下走。
• 耗时(小时)＝开发这个专案花的时长。专案卡头的「总耗时(开发)」是各条耗时累加，直到状态标「已完成」就停止计算（自动进度的耗时按当日提交时间差估算）。
• 周报「节省工时」＝用本工具省下的人工填写时间（估算）：以前每条进度人工手写约 8 分钟，工具自动生成≈把这段时间全省下；按本周条数换算。注意它和上面的「开发耗时」是两回事。
• 专案卡头显示：团队徽章 · 最新状态 · 共几条 · 总耗时(开发) · 最近日期。

• ① 文字 / 链接：直接在证据输入框打字说明，或贴上链接。
• ② 上传文件：
  • 图片：自动缩小后以内嵌图片放进格子（点小图可放大）。
  • PDF 文档：上传后在格子放一个可点链接（📄 文件名）。

文件存在本系统服务器上（VPS），单个文件上限约 10MB。同步到 Google Sheet 时，证据会写成一个可点开的链接。

• 周报不用单独填：选周次自动汇总成实时预览（参与人、节省工时、完成/进行中/阻塞、最新状态、进度摘要、问题、下周计划）。点「📥 生成并写入存档」存成一条独立的周报记录，并同步到 Sheet「周报存档」分页；存档记录可单独删，删除也同步删 Sheet，不影响专案进度。
• ✨ AI 润色：用本系统服务器上的本地模型（qwen2.5，免费、不联网外部）把逐日内容合并润色成通顺的一段进度，约 30-50 秒。📝 结构化则是不改写、秒出的排版整理。
• 数据都存在本系统自己的数据库里（VPS）。同时单向镜像到 Google Sheet 的「每日进度」分页：你在面板填/改/删，约 1-2 秒后 Sheet 自动跟着变。
• ⚠️ 别去 Sheet 里手改「每日进度」——它是镜像，会被面板覆盖；要改请回面板改。右上「📄 打开专案进度 Sheet」可一键跳转查看。

• 改错了 / 要删（单条）：每条进度最右边有「编辑」「删除」。编辑弹窗可改任意字段、替换或清除证据；删除会确认一次。
• 专案显示中文名：专案卡头「✏️ 改名」可给专案设一个中文显示名（GitHub 仓库名保持英文不变，方便不看英文的同事一目了然）；旁边小灰字是原仓库名。留空＝恢复用仓库名显示。「🗑 删除专案」会连同其全部进度一起删（会确认）。
• 长文字：今日内容、BUG、解决方式、明日计划等较长的格子默认一行省略，点一下展开全文，再点收起。
• 周报 = 独立存档记录：选周次先看「实时预览」（来自每日明细，只读）；点「📥 生成并写入存档」把它存成周报记录（同步到 Sheet「周报存档」分页）。存档后每行有「🗑 删除」——只删这条周报记录（面板 + Sheet 同步删），完全不影响专案进度明细。「🗑 删除此周存档」=删整周的周报记录。
• 右上「全部展开 / 收起」可一次折叠所有专案，方便快速浏览。
• 专案名建议统一写法（同名才会归到一组）；可从输入框下拉选已有专案，避免打错。
• 左侧菜单的「🐙 团队 GitHub（组织）」一键跳转到团队共用组织 kefucenterteam（私有，需被邀请加入组织才能查看）。所有专案仓库都建在这个组织下，push 会自动写入面板进度。
• GitHub 自动进度：挂了 webhook 的仓库每次 push 代码，会自动在面板新增一条以仓库名为专案的进度（提交内容由本地模型整理成一句话，负责人=提交者，附 GitHub 对比链接），并同步到 Sheet。
• 账号/登录：用花名登录，首次默认密码 123456，登录后会引导你填 GitHub 信息并强制改密。忘记密码：登录页点「忘记密码？」→ 花名 + 新密码 + 确认即可重置。
• 右上「⚙️ 设置」：可修改花名 / 密码 / GitHub 资料（用户名、仓库、Token），以及一键把你名下的 GitHub 仓库转移到团队组织（需先填 Token 且已加入组织）。
• 左侧「🤖 绑定 Telegram Bot」：点一下自动打开机器人并完成绑定，无需手动发 /bind。绑定后每天定时私聊提醒，并附上你上一次进度供参考。回报流程：① 回 1/2/3/4 状态 → ② 进度%（回 1 手动输入 / 2 自动判断＝取该专案「专案进度总览」当前整体%；会提示前日%供参考，不强制）→ ③ 阻碍/所需协助（1 手动 / 2 自动从提交判断）→ ④ 明日计划（1 手动，请假/特休自己写 / 2 自动判断：明天周末或台湾国定假日→「休假」，否则→「继续推进 未完成模块」）。每一步都能选自己填或让系统判断。
• 专案卡「🔗 链接」：给有面板/演示页的专案设个链接，会自动一起放进每条进度的「证据」（和 GitHub 链接并列）。证据里的网址点击即可打开。
• 手机浏览器打开同样能填，界面自适应。