Files
autoclip/docs/COMMUNITY_BOARD.md
T
Kris K e9e6c90b42 feat: add SenseVoiceSmall as a local subtitle transcription option (#244)
* feat: add optional isolated SenseVoice local transcription

* test: verify local transcription selector switches SenseVoice and Whisper

* docs: set realistic disk space expectation for SenseVoice preparation

* docs: reconcile issue 67 delivery with historical ASR plans
2026-09-30 21:16:00 +08:00

9.9 KiB
Raw Blame History

AutoClip 社区看板

公开想法进 GitHub Discussions,已经决定要跟的事进 GitHub Issues,公开路线图用 GitHub Projects。 这三样都在公开仓库的免费额度里。第二阶段再考虑自建 Quackback,现在不建。

当前产品状态见 HANDOFF.md,商业化阶段见 ROADMAP.md。 docs/PROJECT_MANAGEMENT.md 是 2024 年的重构计划,不作为排期依据。

为什么现在就定这套

AutoClip 的用户已经在 GitHub 上。v1.2.1 的下载以 Windows 安装包为主,仓库里同时有桌面、Docker 和 CLI 用户。 再引入一套账号、投票和看板,等于让同一个人维护两个产品。

现在的反馈是散的:应用内一句、GitHub Issue 一堆,Discussions 开着但还是默认分类,没有公开路线图。飞书表格不再收反馈:界面有八种语言,一张中文表跟着走不了。 Issue 区曾经被「用不了」和「我觉得应该」混在一起。入口分开之后,Agent 才有稳定的地方可读。

方案 现在 原因
GitHub Discussions + Projects 用这套 公开仓库免费,Agent 用 gh 就能读能写
Quackback 自建 先记下,不立项 等非开发者反馈多到 Discussions 撑不住
Featurebase / Productlane 不用 免费档没有 Agent 能用的 API,付费从月费开始
Linear 不用 不适合作为公众提需求的地方

不打开 GitHub 的人用应用内反馈。它跟着界面语言走。点发送不看匿名统计开关:句子先进入 PostHog,每小时由 .github/workflows/ingest-feedback.yml 写进 GitHub。故障开 Issue,想法开 Ideas,其他开 Q&A。这些帖子带 from-app 或反馈编号,只是收件箱,不直接变成路线图卡片。邮箱不写进公开帖。没有配置或网络失败时,应用会打开预填好的 GitHub 页面。

三条通道

用户
  │
  ├─ 想法、用法、模型、提问 → Discussions
  ├─ 能复现的故障 → Issue(bug 模板)
  └─ 不想用 GitHub → 应用内反馈(自动写入 Issue 或 Discussions)
          │
          ▼
     Product Agent 聚类、去重、排序
          │
          ├─ 先不处理
          └─ 人确认值得研究
                 │
                 ▼
            GitHub Issue
                 │
                 ▼
         AutoClip Roadmap
     Exploring → Researching → Planned → Building → Testing → Shipped
                 │
                 ▼
           Pull Request → Release

Discussions 里的帖子不是承诺。Issue 才是进入 backlog 的需求。Project 上的一张卡对应一个 Issue。

Discussions 分类

对外只引导这五类。仓库里原有的 General、Polls、Show and tell 留着,说明改成把人指回下面的分类。

分类 谁来写 写什么
Ideas 任何人 希望 AutoClip 支持什么。先写场景
Use Cases 任何人 拿它做游戏切片、播客、课程、短剧
AI Models 任何人 希望支持哪个模型,现在缺在名单里还是效果不行
Q&A 任何人 怎么用。能复现的故障仍开 Issue
Announcements 维护者 版本、已知问题、方向变化

表单在 .github/DISCUSSION_TEMPLATE/。GitHub 不会按文件名自动绑到分类,装好分类后要在仓库设置里各选一次。

Polls 留给维护者发起投票,不作为日常入口。

路线图六列

Project 名称是 AutoClip Roadmap,设为公开。Status 只有这六列:

列 含义 谁能放进去
Exploring 社区出现过,还没决定做不做 Agent 可以建议,人点头后放入
Researching 值得弄清楚做法和范围 必须人确认
Planned 已经承诺,还没写 必须人确认
Building 正在做,或代码已在 main、还没发版 必须人确认
Testing 有包或可运行版本,等人看 必须人确认
Shipped 已经在某次 Release 里 发版说明写了才算

标签 status:exploring 到 status:shipped 是这六列的镜像,方便只读 Issue 的脚本。公开页面以 Project 的 Status 为准。

Agent 不可以自己把卡推进到 Planned、Building、Testing 或 Shipped。 合并 Pull Request 不等于 Shipped,发版才算。

人怎么说,Agent 怎么做

每天或每次你问「这周社区在说什么」:

python3 scripts/feature_signals.py --days 30

脚本按赞成、评论和反应排序,并用用词重叠提示可能重复。它不做语义结论。 Agent 读完后写出本周信号:哪几条是同一件事、哪几条已经有 Issue、哪几条还只是呼声。

你说「把游戏高光识别放进 Researching」时,Agent 做完这五步再停:

  1. 按 issue-body.md 建 Issue,标题 [Feature] …
  2. 打上 feature 和对应的 status:*
  3. 正文链到相关 Discussions
  4. 把 Issue 加进 AutoClip Roadmap,Status 设成你说的那一列
  5. 回讨论帖,链到 Issue

你说「最近 30 天呼声最高、还没进路线图的需求」时,Agent 只分析,不开 Issue。

初始看板

下面是按 2026-09-21 的仓库状态排的第一版,不是社区投票结果。 Testing 是空的:还没有一个「有包、正在给人验」的条目。已发版的历史写在 Project 简介里,不再补开 Issue。

完整字段在 roadmap-seed.json。

v1.3.0、v1.3.1、v1.3.2 和 v1.3.3 已经发布。八语界面、崩溃上报、应用内更新、发布页、自动封面、失败文案、通义国际站、Docker 设置页、竖屏导出和 CLI / MCP 算 Shipped,写在 Project 简介里,不再开卡。 Building 和 Testing 现在是空的:更新日志里没有「已写完、还没发版」或「有包正在给人验」的条目。

Researching

  • 本地 ASR 模型增补(#67:SenseVoiceSmall 按需接入,Whisper 保持默认;通用插件协议继续评估)
  • 切片质量对照(5 分钟和 60 分钟真视频)
  • Step 3 评分后端可插拔

Planned

  • Windows 安装包真机验证
  • Apple 公证与 Windows 代码签名(应用内更新已在 v1.3.1,签名还没有)
  • 首页与项目卡按设计系统重做
  • CLI / MCP 真视频端到端
  • Intel mac 安装包
  • 分块大小和合集条数接到流水线
  • 竖屏三条预设人工看片

Exploring(提过,但没有承诺)

  • 1080p60 导出
  • 说话人居中裁切与封面图

排期

合进 main 和发版是两件事。当前版本停在 v1.3.3。之后先把改动合进 main,卡片放到 Building,攒一批再打一个 tag。不为单个反馈单独热修。

下一次发行看 Building 里已经攒了什么,不按单个 PR 决定。社区新想法默认停在 Exploring,不插进已经排好的顺序,除非它就是其中一件的复现。

  1. 看板是排期本身。 六列装在公开 Project「AutoClip Roadmap」上。种子 Issue 按 docs/community/roadmap-seed.json 放进对应列。
  2. v1.3.1 之后按这个顺序做产品,社区新想法默认停在 Exploring:
    • Windows 真机验证。安装包已经是下载主力,交接记录里仍没有干净机器跑通的结论。
    • Apple 公证和 Windows 代码签名。应用内更新和崩溃上报已经在 v1.3.1,未签名仍会拦住安装。
    • 首页和项目卡按设计系统重做。八语界面已经上线,这两处还是 Ant Design 默认件。
    • CLI 真视频,以及竖屏三条预设的人工看片。
  3. 通用识别和评分插件接口继续评估。 #67 已按维护者 2026-09-30 的接入要求实现可选本地 SenseVoiceSmall,见 PR #244 和 模型配置;现有转写入口负责统一路由,词级时间戳必须完整、单调且不超出音频。此交付不代表全部 FunASR 模型或通用插件框架已完成。账号仍等公证和代码签名完成,不因为界面语言已经上线就提前开。
  4. 新的社区需求不插到上面这几件前面,除非它就是其中一件的复现,例如切片结果为空。

Quackback 同时满足下面三条再立项,缺一条就继续用 GitHub:

  • 连续四周,Ideas 和 Use Cases 里来自非贡献者的新帖多到每周 triage 看不过来
  • 应用内反馈里,不用 GitHub 的人成了多数,而 PostHog 已经不好把公开路线图做出来
  • 需要一个给非开发者看的独立页面:/feedback、/roadmap、/changelog

到那时的路径是:Quackback 收集和投票,Agent 读它的 API,确认后的需求仍写回 GitHub Issue 和这个 Project,代码继续在仓库里走。

安装

预览:

python3 scripts/setup_community_board.py

GitHub 的接口不能创建 Discussion 分类。脚本会打印还缺哪几类、说明该怎么改;分类本身在仓库的 Discussions 设置里点一次。 标签和公开 Project 由脚本写入:

python3 scripts/setup_community_board.py --apply

Project 权限不够时:

gh auth refresh -s project,read:project

同意种子清单后再开 Issue:

python3 scripts/setup_community_board.py --apply --seed-issues

然后在 GitHub 仓库设置的 Discussions 里,把表单对应到分类:

分类 表单
Ideas .github/DISCUSSION_TEMPLATE/ideas.yml
Use Cases .github/DISCUSSION_TEMPLATE/use-cases.yml
AI Models .github/DISCUSSION_TEMPLATE/ai-models.yml
Q&A .github/DISCUSSION_TEMPLATE/q-a.yml
Announcements .github/DISCUSSION_TEMPLATE/announcements.yml

明确不做

  • 不让普通用户用 Issue 提「我希望」。故障仍用 bug 模板。
  • 不在应用里做投票墙,也不把 Discussions 同步进数据库。
  • 不用飞书表格收反馈。不用 GitHub 的人走应用内反馈。
  • 不重开已经关闭的「用不了」Issue。
  • 不上 Featurebase、Linear、Productlane。