MathClaw.github.io/contribution.html at main · MathClaw-ruc/MathClaw.github.io · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
<!DOCTYPE html>
<html lang="zh-CN" dir="ltr">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width,initial-scale=1">
    <title>参与贡献 | MathClaw</title>
    <meta name="description" content="AI 驱动的数学学习工作台">
    <meta name="generator" content="VitePress v1.6.4">
    <link rel="preload stylesheet" href="/MathClaw.github.io/assets/style.D0Ca1ZhL.css" as="style">
    <link rel="preload stylesheet" href="/MathClaw.github.io/vp-icons.css" as="style">

    <script type="module" src="/MathClaw.github.io/assets/app.BorXYth1.js"></script>
    <link rel="preload" href="/MathClaw.github.io/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
    <link rel="modulepreload" href="/MathClaw.github.io/assets/chunks/theme.CDi3-8rc.js">
    <link rel="modulepreload" href="/MathClaw.github.io/assets/chunks/framework.hRhVUe7m.js">
    <link rel="modulepreload" href="/MathClaw.github.io/assets/contribution.md.xR7Y4Smk.lean.js">
    <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
    <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
  </head>
  <body>
    <div id="app"><div class="Layout" data-v-5d98c3a5><!--[--><!--]--><!--[--><span tabindex="-1" data-v-0b0ada53></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-0b0ada53>Skip to content</a><!--]--><!----><header class="VPNav" data-v-5d98c3a5 data-v-ae24b3ad><div class="VPNavBar" data-v-ae24b3ad data-v-6aa21345><div class="wrapper" data-v-6aa21345><div class="container" data-v-6aa21345><div class="title" data-v-6aa21345><div class="VPNavBarTitle" data-v-6aa21345 data-v-1168a8e4><a class="title" href="/MathClaw.github.io/" data-v-1168a8e4><!--[--><!--]--><!--[--><img class="VPImage logo" src="/MathClaw.github.io/logo.png" alt data-v-8426fc1a><!--]--><span data-v-1168a8e4>MathClaw</span><!--[--><!--]--></a></div></div><div class="content" data-v-6aa21345><div class="content-body" data-v-6aa21345><!--[--><!--]--><div class="VPNavBarSearch search" data-v-6aa21345><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="搜索"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">搜索</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-6aa21345 data-v-dc692963><span id="main-nav-aria-label" class="visually-hidden" data-v-dc692963> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/MathClaw.github.io/" tabindex="0" data-v-dc692963 data-v-e56f3d57><!--[--><span data-v-e56f3d57>首页</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/MathClaw.github.io/guide/pre-config.html" tabindex="0" data-v-dc692963 data-v-e56f3d57><!--[--><span data-v-e56f3d57>指南</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/MathClaw.github.io/product.html" tabindex="0" data-v-dc692963 data-v-e56f3d57><!--[--><span data-v-e56f3d57>产品展示</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink active" href="/MathClaw.github.io/contribution.html" tabindex="0" data-v-dc692963 data-v-e56f3d57><!--[--><span data-v-e56f3d57>参与贡献</span><!--]--></a><!--]--><!--[--><a class="VPLink link vp-external-link-icon VPNavBarMenuLink" href="https://github.com/MathClaw-ruc/MathClaw" target="_blank" rel="noreferrer" tabindex="0" data-v-dc692963 data-v-e56f3d57><!--[--><span data-v-e56f3d57>GitHub</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-6aa21345 data-v-6c893767><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-6c893767 data-v-5337faa4 data-v-1d5665e3><span class="check" data-v-1d5665e3><span class="icon" data-v-1d5665e3><!--[--><span class="vpi-sun sun" data-v-5337faa4></span><span class="vpi-moon moon" data-v-5337faa4></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-6aa21345 data-v-0394ad82 data-v-7bc22406><!--[--><a class="VPSocialLink no-icon" href="https://github.com/MathClaw-ruc/MathClaw" aria-label="github" target="_blank" rel="noopener" data-v-7bc22406 data-v-bd121fe5><span class="vpi-social-github"></span></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-6aa21345 data-v-bb2aa2f0 data-v-cf11d7a2><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-cf11d7a2><span class="vpi-more-horizontal icon" data-v-cf11d7a2></span></button><div class="menu" data-v-cf11d7a2><div class="VPMenu" data-v-cf11d7a2 data-v-b98bc113><!----><!--[--><!--[--><!----><div class="group" data-v-bb2aa2f0><div class="item appearance" data-v-bb2aa2f0><p class="label" data-v-bb2aa2f0>外观</p><div class="appearance-action" data-v-bb2aa2f0><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-bb2aa2f0 data-v-5337faa4 data-v-1d5665e3><span class="check" data-v-1d5665e3><span class="icon" data-v-1d5665e3><!--[--><span class="vpi-sun sun" data-v-5337faa4></span><span class="vpi-moon moon" data-v-5337faa4></span><!--]--></span></span></button></div></div></div><div class="group" data-v-bb2aa2f0><div class="item social-links" data-v-bb2aa2f0><div class="VPSocialLinks social-links-list" data-v-bb2aa2f0 data-v-7bc22406><!--[--><a class="VPSocialLink no-icon" href="https://github.com/MathClaw-ruc/MathClaw" aria-label="github" target="_blank" rel="noopener" data-v-7bc22406 data-v-bd121fe5><span class="vpi-social-github"></span></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-6aa21345 data-v-e5dd9c1c><span class="container" data-v-e5dd9c1c><span class="top" data-v-e5dd9c1c></span><span class="middle" data-v-e5dd9c1c></span><span class="bottom" data-v-e5dd9c1c></span></span></button></div></div></div></div><div class="divider" data-v-6aa21345><div class="divider-line" data-v-6aa21345></div></div></div><!----></header><div class="VPLocalNav empty fixed" data-v-5d98c3a5 data-v-a6f0e41e><div class="container" data-v-a6f0e41e><!----><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-a6f0e41e data-v-8a42e2b4><button data-v-8a42e2b4>返回顶部</button><!----></div></div></div><!----><div class="VPContent" id="VPContent" data-v-5d98c3a5 data-v-1428d186><div class="VPDoc has-aside" data-v-1428d186 data-v-39a288b8><!--[--><!--]--><div class="container" data-v-39a288b8><div class="aside" data-v-39a288b8><div class="aside-curtain" data-v-39a288b8></div><div class="aside-container" data-v-39a288b8><div class="aside-content" data-v-39a288b8><div class="VPDocAside" data-v-39a288b8 data-v-3f215769><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-3f215769 data-v-a5bbad30><div class="content" data-v-a5bbad30><div class="outline-marker" data-v-a5bbad30></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-a5bbad30>本页目录</div><ul class="VPDocOutlineItem root" data-v-a5bbad30 data-v-b933a997><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-3f215769></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-39a288b8><div class="content-container" data-v-39a288b8><!--[--><!--]--><main class="main" data-v-39a288b8><div style="position:relative;" class="vp-doc _MathClaw_github_io_contribution" data-v-39a288b8><div><h1 id="参与贡献" tabindex="-1">参与贡献 <a class="header-anchor" href="#参与贡献" aria-label="Permalink to &quot;参与贡献&quot;"></a></h1><div class="lead-panel"><span class="kicker">贡献方式</span><h1>欢迎参与 MathClaw 的建设</h1><p>高价值贡献通常能同时改善学习体验、管理体验和记忆质量。欢迎从以下方向选择适合自己的切入点。</p></div><h2 id="高价值贡献方向" tabindex="-1">高价值贡献方向 <a class="header-anchor" href="#高价值贡献方向" aria-label="Permalink to &quot;高价值贡献方向&quot;"></a></h2><div class="contrib-grid"><div class="contrib-card"><h3>学生体验</h3><ul><li>优化长篇数学答案的渲染效果</li><li>提高学习计划的密度、节奏和可读性</li><li>让图谱页在实际复盘场景中更易理解</li></ul></div><div class="contrib-card"><h3>管理与运维</h3><ul><li>提升运行状态和定时任务页面的信息密度</li><li>优化技能面板和配置页的操作体验</li><li>减少对机器路径和部署环境的依赖</li></ul></div><div class="contrib-card"><h3>记忆质量</h3><ul><li>改进图谱抽取和纠错信号的准确度</li><li>提升日记忆和周记忆的稳定性与可读性</li><li>保持 workspace 数据流在各页面之间一致</li></ul></div></div><h2 id="推荐贡献路径" tabindex="-1">推荐贡献路径 <a class="header-anchor" href="#推荐贡献路径" aria-label="Permalink to &quot;推荐贡献路径&quot;"></a></h2><div class="steps-grid"><div class="step-card"><span class="flow-step">01</span><h3>选一个具体模块入手</h3><p>一次解决一个问题，比大范围重写更容易合并。</p></div><div class="step-card"><span class="flow-step">02</span><h3>以当前产品为准</h3><p>以现有控制台界面、路径结构和运行方式为事实来源，而非旧文档。</p></div><div class="step-card"><span class="flow-step">03</span><h3>保持可移植性</h3><p>使用相对路径和可迁移的配置，确保在不同机器上都能正常运行。</p></div><div class="step-card"><span class="flow-step">04</span><h3>同步更新文档</h3><p>功能变化时同步更新站点截图和文档，保持官网与真实系统一致。</p></div></div><h2 id="提交前检查" tabindex="-1">提交前检查 <a class="header-anchor" href="#提交前检查" aria-label="Permalink to &quot;提交前检查&quot;"></a></h2><div class="issue-grid"><div class="issue-card"><h3>渲染检查</h3><ul><li>确认相关页面仍能正常渲染</li><li>产品截图与真实界面保持一致</li></ul></div><div class="issue-card"><h3>数据边界</h3><ul><li>不要误提交临时运行产物</li><li>涉及 workspace 的变更要明确说明作用范围</li></ul></div><div class="issue-card"><h3>品牌一致性</h3><ul><li>用户可见文案统一使用 MathClaw</li><li>避免将内部迁移说明写进公开文档</li></ul></div></div><h2 id="相关仓库" tabindex="-1">相关仓库 <a class="header-anchor" href="#相关仓库" aria-label="Permalink to &quot;相关仓库&quot;"></a></h2><div class="callout-strip"><div class="callout-chip"><strong>MathClaw</strong> 主仓库，包含运行时、控制台和记忆工作流。 </div><div class="callout-chip"><strong>MathClaw.github.io</strong> 官网与文档站点仓库。 </div><div class="callout-chip"><strong>提交说明</strong> 确保界面、文档与部署方式保持一致。 </div></div></div></div></main><footer class="VPDocFooter" data-v-39a288b8 data-v-e257564d><!--[--><!--]--><!----><!----></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter" data-v-5d98c3a5 data-v-e315a0ad><div class="container" data-v-e315a0ad><p class="message" data-v-e315a0ad>基于 MIT License 发布</p><p class="copyright" data-v-e315a0ad>© 2026 MathClaw</p></div></footer><!--[--><!--]--></div></div>
    <script>window.__VP_HASH_MAP__=JSON.parse("{\"contribution.md\":\"xR7Y4Smk\",\"guide_data-preparation.md\":\"BaRri5NJ\",\"guide_docker-start.md\":\"tZLRj3xJ\",\"guide_local-start.md\":\"D7NYdG-T\",\"guide_pre-config.md\":\"CCXhywGs\",\"guide_troubleshooting.md\":\"qkwhZOlc\",\"index.md\":\"zNg_oon3\",\"product.md\":\"Di2ocO2X\",\"zh_contribution.md\":\"B5kZlN51\",\"zh_guide_data-preparation.md\":\"Bzr4JrIS\",\"zh_guide_docker-start.md\":\"CNRCOLcU\",\"zh_guide_local-start.md\":\"BBvVRjUn\",\"zh_guide_pre-config.md\":\"zvp8gsvy\",\"zh_guide_troubleshooting.md\":\"D0qKpvpR\",\"zh_index.md\":\"oG7lwkUs\",\"zh_product.md\":\"CPI7_CX4\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"zh-CN\",\"dir\":\"ltr\",\"title\":\"MathClaw\",\"description\":\"AI 驱动的数学学习工作台\",\"base\":\"/MathClaw.github.io/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.png\",\"search\":{\"provider\":\"local\",\"options\":{\"locales\":{\"root\":{\"translations\":{\"button\":{\"buttonText\":\"搜索\",\"buttonAriaLabel\":\"搜索\"},\"modal\":{\"displayDetails\":\"显示详细列表\",\"resetButtonTitle\":\"重置搜索\",\"backButtonTitle\":\"关闭搜索\",\"noResultsText\":\"没有找到结果\",\"footer\":{\"selectText\":\"选择\",\"selectKeyAriaLabel\":\"回车\",\"navigateText\":\"切换\",\"navigateUpKeyAriaLabel\":\"上箭头\",\"navigateDownKeyAriaLabel\":\"下箭头\",\"closeText\":\"关闭\",\"closeKeyAriaLabel\":\"Esc\"}}}}}}},\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/MathClaw-ruc/MathClaw\"}],\"nav\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"指南\",\"link\":\"/guide/pre-config\"},{\"text\":\"产品展示\",\"link\":\"/product\"},{\"text\":\"参与贡献\",\"link\":\"/contribution\"},{\"text\":\"GitHub\",\"link\":\"https://github.com/MathClaw-ruc/MathClaw\"}],\"sidebar\":{\"/guide/\":[{\"text\":\"快速开始\",\"items\":[{\"text\":\"预配置\",\"link\":\"/guide/pre-config\"},{\"text\":\"工作区与记忆\",\"link\":\"/guide/data-preparation\"},{\"text\":\"本地安装\",\"link\":\"/guide/local-start\"},{\"text\":\"通道部署\",\"link\":\"/guide/docker-start\"}]},{\"text\":\"资源\",\"items\":[{\"text\":\"常见问题\",\"link\":\"/guide/troubleshooting\"}]}]},\"footer\":{\"message\":\"基于 MIT License 发布\",\"copyright\":\"© 2026 MathClaw\"},\"outline\":{\"label\":\"本页目录\"},\"docFooter\":{\"prev\":\"上一页\",\"next\":\"下一页\"},\"lastUpdated\":{\"text\":\"最后更新于\"},\"sidebarMenuLabel\":\"菜单\",\"returnToTopLabel\":\"返回顶部\",\"darkModeSwitchLabel\":\"外观\",\"langMenuLabel\":\"语言\"},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>

  </body>
</html>