## 工作原理 - 一切皆为提交：帖子、议题、PR、发布版本存储在 `gitmsg/*` 分支上 - 同步即 git：`git fetch` 更新，`git push` 发布；支持离线和对等协作 - 便携：`git clone --mirror`，无需导出工具 - 提供 CLI、TUI 和 JSON-RPC 接口 ## 扩展 | 扩展 | 状态 | 描述 | |-----------|--------|-------------| | **Social** | 稳定 | 帖子、评论、转帖、列表、时间线 | | **PM** | 稳定 | 议题、里程碑、冲刺、看板 | | **Review** | 稳定 | 跨平台 PR、版本感知审查（[查看更多](documentation/GITREVIEW-FLOWS.md)） | | **Release** | 稳定 | 发布版本、制品、校验和、签名、SBOM | ## 安装 **Homebrew**（macOS / Linux）： ``` brew install gitsocial-org/tap/gitsocial ``` 如果 macOS 阻止二进制文件（"无法验证开发者"），请运行： ``` xattr -d com.apple.quarantine $(which gitsocial) ``` **Scoop**（Windows）： ``` scoop bucket add gitsocial https://github.com/gitsocial-org/scoop-bucket.git scoop install gitsocial ``` **Shell 脚本**（macOS / Linux）： ``` curl -fsSL https://raw.githubusercontent.com/gitsocial-org/gitsocial/main/install.sh | sh ``` **Go**： ``` go install github.com/gitsocial-org/gitsocial/library/cli@latest ``` 或从 [发布版本](https://github.com/gitsocial-org/gitsocial/releases/latest) 手动下载二进制文件。 ## 快速开始 导入现有项目并在 TUI 中探索： ``` git clone https://github.com/your/repo cd repo gitsocial import # imports issues, PRs, releases, discussions gitsocial tui ``` ### CLI 教程 从零开始使用 CLI： ``` # 在您的仓库中初始化 GitSocial cd repo gitsocial social init # 创建列表并关注仓库 gitsocial social list create reading gitsocial social list add reading https://github.com/someone/interesting-project # 获取更新并查看时间线 gitsocial fetch gitsocial social timeline # 撰写帖子 gitsocial social post "First post from GitSocial" # 发布 gitsocial push ``` ## 文档 **[GitReview 工作流](documentation/GITREVIEW-FLOWS.md) - PR 工作流和跨平台场景** ### 开发者文档 | 文档 | 描述 | |----------|-------------| | [架构设计](documentation/ARCHITECTURE.md) | 系统设计、包、缓存和依赖 | | [CLI 参考](documentation/CLI.md) | 命令、标志、输出格式和脚本 | | [TUI 图表](documentation/TUI-DIAGRAMS.md) | 每个列表和详情视图的 ASCII 布局 | | [JSON-RPC](documentation/RPC.md) | 通过 stdio 的客户端集成 | ### 集成 | 集成 | 描述 | |-------------|-------------| | [Agent Skill](https://github.com/gitsocial-org/gitsocial-agent-skill) | 面向 AI 代理的 GitSocial | ### 协议规范 | 规范 | 描述 | |------|-------------| | [GITMSG.md](specs/GITMSG.md) | 核心消息格式、头部、引用和版本控制 | | [GITSOCIAL.md](specs/GITSOCIAL.md) | 帖子、评论、转帖、引用和列表 | | [GITPM.md](specs/GITPM.md) | 议题、里程碑、冲刺和层级 | | [GITREVIEW.md](specs/GITREVIEW.md) | 拉取请求、内联反馈和审查状态 | | [GITRELEASE.md](specs/GITRELEASE.md) | 带制品、校验和、签名和 SBOM 的发布版本 | ## 贡献指南 所有镜像上的平台议题和 PR 均已禁用——GitSocial 使用自身工具进行协作。 ### 入门 1. 安装 GitSocial（参见[安装](#installation)） 2. 在任何托管平台上 fork 仓库（GitHub、GitLab、Codeberg 或自托管） 3. 克隆您的 fork：`git clone https://your-host.com/you/gitsocial` ### 提交拉取请求 ``` git checkout -b feature/my-change # make changes, commit gitsocial review pr create \ --base main \ --head feature/my-change \ "Short description of change" git push origin feature/my-change # push your branch gitsocial push # push PR metadata ``` 首次推送后，请在 [Matrix 房间](https://matrix.to/#/!uZYlsFjjQgPmSBYJaY:matrix.org?via=matrix.org) 中请求 fork 注册，以便维护者能够发现您的 PR 和议题。 请参阅 [GitReview 工作流](documentation/GITREVIEW-FLOWS.md) 了解完整的跨平台 PR 工作流。 ### 报告问题与请求功能 ``` gitsocial pm issue create "Bug: description" gitsocial push ``` 如有快速问题或讨论，请使用 [Matrix 房间](https://matrix.to/#/!uZYlsFjjQgPmSBYJaY:matrix.org?via=matrix.org)。 ## 许可证 MIT

标签：EVTX分析, Git, Git工作流, Go, Issue跟踪, JSON-RPC, Linux 内核安全, P2P, Pull Request, Ruby工具, TUI, 代码审查, 协作工具, 去中心化, 发布管理, 威胁情报, 开发者工具, 开源, 日志审计, 版本发布, 社交网络, 离线优先, 网络安全研究, 项目管理