@@ -1,24 +1,7 @@
import Link from "next/link" ;
import { fetchFeed , fetchRepoStats } from "@/lib/github" ;
import { getDispatch , getEnv } from "@/lib/kv" ;
import { getFacts } from "@/lib/facts" ;
import { buildPageMetadata } from "@/lib/page-meta" ;
import { Seal } from "@/components/seal" ;
import { Ticker } from "@/components/ticker" ;
import { StatGrid } from "@/components/stat-grid" ;
import { RELEASE_CONTRIBUTORS , RELEASE_HELPERS } from "@/lib/release-credits" ;
import type { CuratedDispatch , FeedItem , RepoStats } from "@/lib/types" ;
export const revalidate = 1800 ;
const FALLBACK_STATS : RepoStats = {
stars : 0 ,
forks : 0 ,
openIssues : 0 ,
openPulls : 0 ,
contributors : 141 ,
fetchedAt : new Date ( ) . toISOString ( ) ,
} ;
export async function generateMetadata ( { params } : { params : Promise < { locale : string } > } ) {
const { locale } = await params ;
@@ -28,53 +11,81 @@ export async function generateMetadata({ params }: { params: Promise<{ locale: s
locale ,
title : isZh ? "社区 · Codewhale" : "Community · Codewhale" ,
description : isZh
? "Codewhale 的社区一角：实时仓库动态、每周摘要、路线图、贡献指南与发布致谢，集中在一处 。"
: "The community side of Codewhale in one place: live repo activity, the weekly dig est, the roadmap, how to contribute , and release credit s." ,
? "了解 Codewhale 的国际开源社区，提交 issue、发送 pull request、改进翻译并查看版本贡献者 。"
: "Meet Codewhale's international open-source community, file issues, send pull requ ests , improve translations , and see release contributor s." ,
} ) ;
}
export default async function CommunityPage ( { params } : { params : Promise < { locale : string } > } ) {
const { locale } = await params ;
const isZh = locale === "zh" ;
const p = ( path : string ) = > ( isZh ? ` /zh ${ path } ` : path ) ;
const env = await getEnv ( ) ;
const p = ( path : string ) = > ` / ${ locale } ${ path } ` ;
const facts = await getFacts ( ) ;
let stats : RepoSt ats= FALLBACK_STATS ;
let feed : FeedItem [ ] = [ ] ;
let dispatch : CuratedDispatch | null = null ;
try {
[ stats , feed ] = await Promise . all ( [
fetchRepoStats ( env . GITHUB_TOKEN ) ,
fetchFeed ( env . GITHUB_TOKEN , 12 ) ,
] ) ;
} catch ( e ) {
console . error ( "github fetch failed" , e ) ;
}
try {
dispatch = await getDispatch ( ) ;
} catch {
/* dispatch stays null; the section falls back to a link */
}
const highlights =
dispatch && isZh && dispatch . highlightsZh ? dispatch.highlightsZh : dispatch?.highlights ? ? [ ] ;
const hubs = isZh
const contributionP ath s= isZh
? [
{ t : "提交问题" , d : "报告 bug、兼容性问题或不清楚的行为。请附上系统信息、复现步骤和相关日志。" , cta : "提交 issue →" , href : "https://github.com/Hmbown/CodeWhale/issues/new/choose" , tag : "反馈" } ,
{ t : "发送改进" , d : "修复运行时、测试或文档中的一个具体问题，并提交范围清晰、便于审查的 pull request。" , cta : "阅读贡献指南 →" , href : p ( "/contribute" ) , tag : "代码与文档" } ,
{ t : "改进翻译" , d : "帮助 Codewhale 在更多语言和地区中自然、准确地工作。翻译指南列出了完整语言包与待补项目。" , cta : "查看本地化指南 ↗" , href : "https://github.com/Hmbown/CodeWhale/blob/main/docs/LOCALIZATION.md" , tag : "语言" } ,
{ t : "跟进项目动态" , d : "查看最近的 issues、pull requests、版本路线和经过维护者审核的社区摘要。" , cta : "查看动态 →" , href : p ( "/feed" ) , tag : "动态" } ,
{
title : "报告问题" ,
description : "报告 bug、兼容性问题或不清楚的行为， ,
cta : "提交 issue →" ,
href : "https://github.com/Hmbown/CodeWhale/issues/new/choose" ,
} ,
{
title : "改进代码或测试" ,
description : "选择一个范围清晰的问题，提交尽可能小的有效补丁，并添加能够证明行为变化的回归测试。" ,
cta : "查看开放 issues →" ,
href : "https://github.com/Hmbown/CodeWhale/issues" ,
} ,
{
title : "改进文档或翻译" ,
description : "修正不准确的说明、补充实际示例，或帮助完成新的语言包，让文档在不同地区都自然准确。" ,
cta : "查看本地化指南 ↗" ,
href : "https://github.com/Hmbown/CodeWhale/blob/main/docs/LOCALIZATION.md" ,
} ,
{
title : "复现并审查现有工作" ,
description : "在你的平台和提供商上验证 issue 或 pull request， ,
cta : "查看 pull requests →" ,
href : "https://github.com/Hmbown/CodeWhale/pulls" ,
} ,
]
: [
{ t : "Report a problem" , d : "File a bug, compatibility problem, or unclear behavior. Include your system details, reproduction steps, and relevant logs." , cta : "File an issue →" , href : "https://github.com/Hmbown/CodeWhale/issues/new/choose" , tag : "feedback" } ,
{ t : "Send an improvement" , d : "Fix one concrete problem in the runtime, tests, or documentation and open a focused pull request that is easy to review." , cta : "Read the contribution guide →" , href : p ( "/contribute" ) , tag : "code and docs" } ,
{ t : "Improve a translation" , d : "Help Codewhale work naturally and accurately across more languages and regions. The localization guide lists complete packs and open gaps." , cta : "Open the localization guide ↗" , href : "https://github.com/Hmbown/CodeWhale/blob/main/docs/LOCALIZATION.md" , tag : "language" } ,
{ t : "Follow project activity" , d : "Browse recent issues and pull requests, the public roadmap, and maintainer-reviewed community summaries." , cta : "Open the activity feed →" , href : p ( "/feed" ) , tag : "activity" } ,
{
title : "Report a problem" ,
description : "File a bug, compatibility problem, or unclear behavior with system details, reproduction steps, and any logs you can share safely." ,
cta : "File an issue →" ,
href : "https://github.com/Hmbown/CodeWhale/issues/new/choose" ,
} ,
{
title : "Improve code or tests" ,
description : "Choose one well-bounded problem, make the smallest useful patch, and add a regression test that proves the changed behavior." ,
cta : "Browse open issues →" ,
href : "https://github.com/Hmbown/CodeWhale/issues" ,
} ,
{
title : "Improve documentation or translations" ,
description : "Correct inaccurate guidance, add a practical example, or help complete a language pack so the project reads naturally in more regions." ,
cta : "Open the localization guide ↗" ,
href : "https://github.com/Hmbown/CodeWhale/blob/main/docs/LOCALIZATION.md" ,
} ,
{
title : "Reproduce and review existing work" ,
description : "Verify an issue or pull request with your platform and provider, then share the commands you ran, the result, and any remaining problem." ,
cta : "Browse pull requests →" ,
href : "https://github.com/Hmbown/CodeWhale/pulls" ,
} ,
] ;
const activityLinks = isZh
? [
{ title : "仓库动态" , description : "最近的 issues 与 pull requests。" , href : p ( "/feed" ) } ,
{ title : "社区摘要" , description : "经过维护者审核的每周项目记录。" , href : p ( "/digest" ) } ,
{ title : "公开路线图" , description : "已发布、正在进行、考虑中和明确不做的工作。" , href : p ( "/roadmap" ) } ,
]
: [
{ title : "Repository activity" , description : "Recent issues and pull requests." , href : p ( "/feed" ) } ,
{ title : "Community digest" , description : "The maintainer-reviewed weekly project record." , href : p ( "/digest" ) } ,
{ title : "Public roadmap" , description : "Shipped, underway, considered, and ruled-out work." , href : p ( "/roadmap" ) } ,
] ;
return (
@@ -86,8 +97,8 @@ export default async function CommunityPage({ params }: { params: Promise<{ loca
< h1 > { isZh ? "与世界各地的贡献者一起构建 Codewhale。" : "Build Codewhale with contributors around the world." } < / h1 >
< p >
{ isZh
? "Codewhale 的代码 、文档、测试和翻译由不同国家、语言和技术背景的贡献者共同改进。第一次参与不需要从大功能开始：一份 清楚的 bug 报告、一处 文档修正或一个 带测试的小补丁都很有价值 。"
: "Codewhale's runtime, documentation, tests, and translations improve through contributors across countries, languages, and technical backgrounds. A first contribution does not need to be a large feature: a clear bug report, a documentation correction, or a small tested patch is useful project work." }
? "Codewhale 的运行时 、文档、测试和翻译由不同国家、语言、平台 和技术背景的贡献者共同改进。第一次参与不需要从大功能开始； 准确的 文档修正或带测试的小补丁都是重要的项目工作 。"
: "Codewhale's runtime, documentation, tests, and translations improve through contributors across countries, languages, platforms, and technical backgrounds. A first contribution does not need to be a large feature; a clear bug report, an accurate documentation correction, or a small tested patch is valuable project work." }
< / p >
< div className = "portal-actions" >
< Link href = "https://github.com/Hmbown/CodeWhale/issues/new/choose" className = "portal-button portal-button-primary" >
@@ -96,189 +107,93 @@ export default async function CommunityPage({ params }: { params: Promise<{ loca
< Link href = "https://github.com/Hmbown/CodeWhale/pulls" className = "portal-button portal-button-secondary" >
{ isZh ? "查看 pull requests" : "Browse pull requests" }
< / Link >
< Link href = "https://github.com/Hmbown/CodeWhale/blob/main/docs/LOCALIZATION.md" className = "portal-button portal-button-secondary" >
{ isZh ? "改进翻译 " : "Improve a translation " }
< Link href = { p ( "/contribute" ) } className = "portal-button portal-button-secondary" >
{ isZh ? "阅读贡献指南 " : "Read the contribution guide " }
< / Link >
< / div >
< / div >
< / section >
{ /* live repo activity — the same ticker as the homepage, composed here */ }
< Ticker items = { feed } / >
{ /* Direct contribution paths */ }
< section className = "mx-auto max-w-[1400px] px-6 py-12" >
< div className = "mb-6 hairline-b pb-4" >
< div className = "eyebrow mb-2" > { isZh ? "现在就可以参与" : "Ways to contribute now" } < / div >
< h2 className = "font-display" > { isZh ? "选择一个具体的切入点。" : "Choose one practical place to start." } < / h2 >
< / div >
< div className = "grid md:grid-cols-2 gap-0 col-rule hairline-t hairline-b" >
{ hubs . map ( ( h ) = > (
< Link key = { h . t } href = { h . href } className = "block p-6 hover:bg-paper-deep transition-colors" >
< div className = "flex items-baseline justify-between gap-3 mb-2" >
< h3 className = "font-display text-xl" > { h . t } < / h3 >
< span className = "font-mono text-[0.62rem] uppercase tracking-widest text-indigo shrink-0" > { h . tag } < / span >
< / div >
< p className = { ` text-sm text-ink-soft mb-4 ${ isZh ? "leading-[1.9] tracking-wide" : "leading-relaxed" } ` } >
{ h . d }
< / p >
< span className = "font-mono text-[0.7rem] uppercase tracking-widest text-indigo" > { h . cta } < / span >
< / Link >
) ) }
< / div >
< / section >
{ /* the numbers — same StatGrid as the homepage */ }
< StatGrid stats = { stats } / >
{ /* TODAY'S DISPATCH — composed from the same cron-curated source */ }
< section className = "bg-paper-deep hairline-t hairline-b" >
< div className = "mx-auto max-w-[1400px] px-6 py-14" >
< div className = "flex items-baseline gap-4 mb-8 hairline-b pb-4" >
< Seal char = "讯" / >
< h2 className = "font-display" > { isZh ? "今日要闻" : "Today's dispatch" } < / h2 >
< / div >
{ dispatch ? (
< article className = "grid lg:grid-cols-12 gap-x-10 gap-y-6 max-w-[1100px]" >
< h3 className = "lg:col-span-12 font-display text-2xl sm:text-3xl leading-tight" >
{ isZh && dispatch . headlineZh ? dispatch.headlineZh : dispatch.headline }
< / h3 >
< p className = { ` lg:col-span-7 text-ink-soft ${ isZh ? "leading-[1.9] tracking-wide" : "leading-relaxed" } ` } >
{ isZh && dispatch . summaryZh ? dispatch.summaryZh : dispatch.summary }
< / p >
< ul className = "lg:col-span-5 space-y-3" >
{ highlights . slice ( 0 , 3 ) . map ( ( h , i ) = > (
< li key = { i } className = "flex items-baseline gap-3" >
< span className = "font-mono text-[0.66rem] text-indigo uppercase tracking-widest w-16 shrink-0" > { h . tag } < / span >
< div >
< Link href = { h . href } className = "body-link font-display text-base leading-snug" >
{ h . title }
< / Link >
< p className = { ` text-sm text-ink-soft mt-0.5 ${ isZh ? "leading-[1.8]" : "" } ` } > { h . blurb } < / p >
< / div >
< / li >
) ) }
< / ul >
< / article >
) : (
< p className = { ` text-ink-soft max-w-2xl ${ isZh ? "leading-[1.9] tracking-wide" : "leading-relaxed" } ` } >
{ isZh ? (
< >
当 前 社 区 要 闻 暂 不 可 用 ； 你 仍 可 在 { " " }
< Link href = { p ( "/digest" ) } className = "body-link" > 社 区 摘 要 < / Link >
中 浏 览 每 周 的 仓 库 动 态 存 档 。
< / >
) : (
< >
While a current dispatch is unavailable , the { " " }
< Link href = { p ( "/digest" ) } className = "body-link" > community digest < / Link > { " " }
keeps the weekly archive of repository activity .
< / >
) }
< / p >
) }
< / div >
< / section >
{ /* RELEASE CREDITS — the people behind the current release */ }
< section className = "mx-auto max-w-[1400px] px-6 py-14" >
< div className = "flex items-baseline gap-4 mb-5 hairline-b pb-4" >
< Seal char = "谢" / >
< div >
< div className = "eyebrow mb-2" > { isZh ? ` v ${ facts . version } 致谢 ` : ` v ${ facts . version } credits ` } < / div >
< h2 className = "font-display text-3xl" > { isZh ? "每个补丁和报告都算数" : "Every patch and report counts" } < / h2 >
< / div >
< / div >
< div className = "grid lg:grid-cols-12 gap-10" >
< div className = "lg:col-span-5" >
< p className = { ` text-ink-soft ${ isZh ? "leading-[1.9] tracking-wide" : "leading-relaxed" } ` } >
< section className = "portal-section" >
< div className = "portal-container portal-section-grid" >
< div className = "portal-section-copy" >
< span > { isZh ? "参与方式" : "Ways to contribute" } < / span >
< h2 > { isZh ? "从一个具体、可验证的改进开始。" : "Start with one concrete, verifiable improvement." } < / h2 >
< p >
{ isZh
? "这一版本包含了社区提交的代码、测试、问题复现和审查建议。完整记录保存在 CHANGELOG 和贡献者名单中；即使补丁需要由维护者整理后合入，原作者的贡献也会保留 。"
: "This release includes code, tests, reproductions, and review guidance from the community. The changelog and contributor list keep the full record, including credit when a maintainer adapts a patch before it lands ." }
? "问题报告、代码、测试、文档、翻译和审查都会推进项目。请选择最适合你当前经验和时间的一种方式 。"
: "Issue reports, code, tests, documentation, translations, and review all move the project forward. Choose the path that fits your experience and available time ." }
< / p >
< div className = "flex flex-wrap gap-x-5 gap-y-2 mt-4" >
< Link href = "https://github.com/Hmbown/CodeWhale/blob/main/docs/CONTRIBUTORS.md" className = "f ont-mono text-xs uppercase tracking-wider text-indigo hover:underline " >
{ isZh ? "完整贡献者名单 →" : "Full contributor list →" }
< / div >
< div className = "c ontribute-path-grid " >
{ contributionPaths . map ( ( path ) = > (
< article key = { path . title } >
< h3 > { path . title } < / h3 >
< p > { path . description } < / p >
< Link href = { path . href } > { path . cta } < / Link >
< / article >
) ) }
< / div >
< / div >
< / section >
< section className = "portal-section portal-section-muted" >
< div className = "portal-container portal-section-grid" >
< div className = "portal-section-copy" >
< span > { isZh ? "公开项目记录" : "Public project record" } < / span >
< h2 > { isZh ? "从提案到发布，项目工作保持公开。" : "Follow the repository work from proposal to release." } < / h2 >
< p >
{ isZh
? "动态页面汇总最近的仓库活动，社区摘要保留每周存档，路线图区分已发布的能力与仍在讨论的方向。"
: "The activity feed collects recent repository work, the community digest keeps the weekly archive of repository activity, and the roadmap separates shipped capabilities from work that is still being discussed." }
< / p >
< / div >
< div className = "portal-topic-list" >
{ activityLinks . map ( ( item ) = > (
< Link key = { item . href } href = { item . href } >
< strong > { item . title } < / strong >
< span > { item . description } < / span >
< span aria-hidden = "true" > → < / span >
< / Link >
< Link href = "https://github.com/Hmbown/CodeWhale/blob/main/CHANGELOG.md" className = "font-mono text-xs uppercase tracking-wider text-indigo hover:underline" >
CHANGELOG →
< / Link >
< Link href = { p ( "/contribute" ) } className = "font-mono text-xs uppercase tracking-wider text-indigo hover:underline" >
{ isZh ? "参与贡献 →" : "Contribute →" }
) ) }
< / div >
< / div >
< / section >
< section className = "portal-section community-credit-section" >
< div className = "portal-container portal-section-grid" >
< div className = "portal-section-copy" >
< span > { isZh ? ` v ${ facts . version } 版本致谢 ` : ` v ${ facts . version } release credit ` } < / span >
< h2 > { isZh ? "贡献者署名是版本记录的一部分。" : "Contributor credit is part of the release record." } < / h2 >
< p >
{ isZh
? "这一版本包含社区提交的代码、测试、复现和验证。即使维护者需要调整补丁后再合入，原始贡献者的署名也会保留在提交、更新日志和贡献者名单中。"
: "This release includes code, tests, reproductions, and verification from the community. When a maintainer needs to adapt a patch before it lands, the original contributor remains credited in the commit, changelog, and contributor record." }
< / p >
< div className = "community-record-links" >
< Link href = "https://github.com/Hmbown/CodeWhale/blob/main/docs/CONTRIBUTORS.md" >
{ isZh ? "完整贡献者名单 ↗" : "Full contributor record ↗" }
< / Link >
< Link href = "https://github.com/Hmbown/CodeWhale/blob/main/CHANGELOG.md" > CHANGELOG ↗ < / Link >
< / div >
< / div >
< div className = "lg:col-span-7 grid gap-6 " >
< div >
< div className = "eyebrow mb-3" > { isZh ? "已合并 / 已 吸收贡献" : "Merged and harves ted contributions" } < / div >
< div className = "flex flex-wrap gap-2 " >
< div className = "community-credit-groups " >
< section >
< h3 > { isZh ? "已合并或 吸收的 贡献" : "Merged or adap ted contributions" } < / h3 >
< div className = "community-credit-list " >
{ RELEASE_CONTRIBUTORS . map ( ( handle ) = > (
< Link
key = { handle }
href = { ` https://github.com/ ${ handle . slice ( 1 ) } ` }
className = "font-mono text-xs px-2 py-1 hairline-t hairline-b hairline-l hairline-r text-ink-soft hover:text-indigo hover:bg-paper-deep"
>
{ handle }
< / Link >
< Link key = { handle } href = { ` https://github.com/ ${ handle . slice ( 1 ) } ` } > { handle } < / Link >
) ) }
< / div >
< / div >
< div >
< div className = "eyebrow mb-3" > { isZh ? "报告、复现和 验证" : "Reports, repros, and verification" } < / div >
< div className = "flex flex-wrap gap-2 " >
< / section >
< section >
< h3 > { isZh ? "报告、复现与 验证" : "Reports, reproduction s, and verification" } < / h3 >
< div className = "community-credit-list " >
{ RELEASE_HELPERS . map ( ( handle ) = > (
< Link
key = { handle }
href = { ` https://github.com/ ${ handle . slice ( 1 ) } ` }
className = "font-mono text-xs px-2 py-1 hairline-t hairline-b hairline-l hairline-r text-ink-soft hover:text-indigo hover:bg-paper-deep"
>
{ handle }
< / Link >
< Link key = { handle } href = { ` https://github.com/ ${ handle . slice ( 1 ) } ` } > { handle } < / Link >
) ) }
< / div >
< / div >
< / div >
< / div >
< / section >
{ /* JOIN IN — one clear ask, matching the homepage closer */ }
< section className = "bg-ink text-paper" >
< div className = "mx-auto max-w-[1400px] px-6 py-16 grid lg:grid-cols-12 gap-10 items-center" >
< div className = "lg:col-span-8" >
< div className = "eyebrow text-paper-deep/70 mb-3" > { isZh ? "参与其中" : "Join in" } < / div >
< h2 className = "font-display text-paper text-3xl sm:text-4xl leading-tight" >
{ isZh ? "告诉项目什么有效，什么还需要改进。" : "Tell the project what works and what still needs attention." }
< / h2 >
< p className = { ` mt-5 text-paper-deep/80 max-w-2xl ${ isZh ? "leading-[1.9]" : "leading-relaxed" } ` } >
{ isZh
? "如果你遇到 bug、需要一个尚未支持的模型， ， ，
: "If you hit a bug, need a model that is not supported yet, or find unclear documentation, file an issue. If you already have a focused improvement, a tested pull request is welcome too." }
< / p >
< div className = "mt-6 flex flex-wrap items-center gap-3" >
< Link href = "https://github.com/Hmbown/CodeWhale/issues/new" className = "px-4 py-2 bg-indigo text-paper font-mono text-sm hover:bg-indigo-deep transition-colors" >
{ isZh ? "开个 issue →" : "Open an issue →" }
< / Link >
< Link href = { p ( "/contribute" ) } className = "px-4 py-2 hairline-t hairline-b hairline-l hairline-r border-white/20 text-paper font-mono text-sm hover:bg-white/10 transition-colors" >
{ isZh ? "参与贡献 →" : "Contribute →" }
< / Link >
< Link href = "https://github.com/Hmbown/CodeWhale/discussions" className = "px-4 py-2 font-mono text-sm text-paper-deep/80 hover:text-paper transition-colors" >
{ isZh ? "讨论区 →" : "Discussions →" }
< / Link >
< / div >
< / div >
< div className = "lg:col-span-4 font-mono text-sm text-paper-deep/80 space-y-2" >
< div className = "flex justify-between hairline-b border-white/15 pb-2" >
< span className = "uppercase tracking-widest text-[0.66rem] text-paper-deep/60" > { isZh ? "版本" : "version" } < / span >
< span className = "tabular text-paper" > { facts . version ? ? "v0.8.x" } < / span >
< / div >
< div className = "flex justify-between hairline-b border-white/15 pb-2" >
< span className = "uppercase tracking-widest text-[0.66rem] text-paper-deep/60" > { isZh ? "提供商" : "providers" } < / span >
< span className = "tabular text-paper" > { facts . providers . length } < / span >
< / div >
< div className = "flex justify-between hairline-b border-white/15 pb-2" >
< span className = "uppercase tracking-widest text-[0.66rem] text-paper-deep/60" > { isZh ? "许可证" : "license" } < / span >
< span className = "text-paper" > { facts . license ? ? "MIT" } < / span >
< / div >
< / section >
< / div >
< / div >
< / section >
Hunter B