{"id":30756761,"url":"https://github.com/wibus-wee/clarityfile","last_synced_at":"2026-04-14T00:02:53.842Z","repository":{"id":307286254,"uuid":"987814858","full_name":"wibus-wee/ClarityFile","owner":"wibus-wee","description":"一款专为学术团队和多项目、多比赛参与者设计的本地化智能文档版本与事务关联中心","archived":false,"fork":false,"pushed_at":"2025-08-22T16:06:02.000Z","size":22107,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-22T18:52:06.048Z","etag":null,"topics":["electron","react"],"latest_commit_sha":null,"homepage":"http://clarityfile.wibus.ren/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wibus-wee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-21T16:15:58.000Z","updated_at":"2025-08-22T16:06:06.000Z","dependencies_parsed_at":"2025-08-22T18:26:12.661Z","dependency_job_id":null,"html_url":"https://github.com/wibus-wee/ClarityFile","commit_stats":null,"previous_names":["wibus-wee/clarityfile"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/wibus-wee/ClarityFile","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wibus-wee%2FClarityFile","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wibus-wee%2FClarityFile/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wibus-wee%2FClarityFile/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wibus-wee%2FClarityFile/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wibus-wee","download_url":"https://codeload.github.com/wibus-wee/ClarityFile/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wibus-wee%2FClarityFile/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273589391,"owners_count":25132861,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-04T02:00:08.968Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["electron","react"],"created_at":"2025-09-04T10:07:27.192Z","updated_at":"2026-04-14T00:02:53.786Z","avatar_url":"https://github.com/wibus-wee.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cp align=\"center\"\u003e\n    \u003cimg src=\"./packages/www/public/icon.png\" alt=\"Icon\" width=\"128\" /\u003e\n  \u003c/p\u003e\n  \u003ch1 align=\"center\"\u003e\u003cb\u003eClarityFile · \u003cruby\u003e明档\u003crt\u003eMíng Dàng\u003c/rt\u003e\u003c/ruby\u003e\u003c/b\u003e\u003c/h1\u003e\n  \u003cp align=\"center\"\u003e\n    一款专为学术团队和多项目、多比赛参与者设计的本地化智能文档版本与事务关联中心。\n    \u003cbr /\u003e\n    \u003cpre align=\"center\"\u003e🧪 Working in Progress\u003c/pre\u003e\n    \u003cp align=\"center\"\u003e\n      \u003cb\u003eDownload for \u003c/b\u003e\n      \u003cspan\u003emacOS\u003c/spa\u003e\u0026nbsp;·\u0026nbsp;\n      \u003cspan\u003eWindows\u003c/span\u003e\u0026nbsp;·\u0026nbsp;\n      \u003ci\u003e\u003cspan\u003ePWA (Comming Soon)\u003c/span\u003e\u003c/i\u003e\n    \u003c/p\u003e\n    \u003cbr /\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n## Motivation 动机\n\n1.  **文档版本管理混乱：** 针对不同比赛、不同赛级、通用需求产生的多版本PPT、商业计划书、项目说明书等文件，难以清晰追踪、查找和管理。\n2.  **文件命名与存放无序：** 文件夹和文件命名混乱，导致查找困难，新文件不知如何归档。\n3.  **信息孤岛：** 比赛通知、项目核心成果（专利、红头文件）、成员信息、经费报销等相关信息与核心文档割裂，难以统一管理和关联查阅。\n4.  **多项目管理挑战：** 难以有效区分和管理多个核心项目及 Side-project 的各类资料。\n5.  **流程追踪困难：** 如经费报销流程难以有效追踪。\n6.  **效率低下与文件丢失风险：** 上述问题导致工作效率低下，并存在文件误删或找不到的风险。\n\n## Design 设计\n\n1.  **以“项目”为组织核心：** 所有信息和文件都围绕项目进行组织和关联。\n2.  **“逻辑文档”与“物理版本”分离：** 清晰管理一个抽象文档概念下的多个具体文件版本。\n3.  **元数据驱动：** 通过丰富的元数据（项目、比赛、赛段、版本标签、类型等）精确描述和区分每一个文件和信息条目。\n4.  **强制智能命名与结构化存放：** 应用根据元数据自动生成规范的文件名和清晰的本地文件夹结构，用户无需手动组织。\n5.  **文件物理层与业务逻辑层分离：** 作为所有受管物理文件统一注册中心。\n6.  **信息强关联：** 打破信息孤岛，将文档、比赛、成果、资产、经费等信息相互关联。\n7.  **本地化优先：** 数据存储在本地，用户对自己的数据有完全控制权，兼容现有云同步备份方案。\n\n## Packages\n\n- `packages/desktop`: ClarityFile 的核心桌面应用代码。\n- `packages/locales-web`: ClarityFile 的本地化编辑器，用于管理 ClarityFile 的本地化。 _(WIP)_\n- `packages/www`: ClarityFile 的官方网站，用于展示项目、提供下载等。\n- `packages/shadcn`: shadcn/ui 的本地化版本，用于统一 UI 组件库。同时为各类子项目提供统一的 UI 组件。\n\n## Author\n\nClarityFile © Wibus, Released under AGPLv3. Created on Jun 18, 2025\n\n\u003e [Personal Website](http://wibus.ren/) · [Blog](https://blog.wibus.ren/) · GitHub [@wibus-wee](https://github.com/wibus-wee/) · Telegram [@wibus✪](https://t.me/wibus_wee)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwibus-wee%2Fclarityfile","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwibus-wee%2Fclarityfile","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwibus-wee%2Fclarityfile/lists"}