# Semifold 中文文档

> 跨语言单仓库的版本、变更日志与发布管理。

按任务读取以下 Markdown 文档。先运行 smif --version，并用已安装版本的 --help 核对参数。

## 概览

- [文档](https://semifold.noctisynth.org/markdown/zh/index.md): 学习怎样用 Semifold 统一管理跨语言单仓库中的软件包版本、依赖、变更日志和发布。
- [与 Agent 一起使用 Semifold](https://semifold.noctisynth.org/markdown/zh/agents.md): 为发布任务提供按需读取的 Markdown 文档和可移植的 Semifold Skill。
- [命令行概览](https://semifold.noctisynth.org/markdown/zh/commands.md): 按任务选择 Semifold 命令，再查看行为说明或完整参数参考。
- [Semifold 是什么？](https://semifold.noctisynth.org/markdown/zh/introduction.md): 理解 Semifold 解决的仓库问题，以及它怎样连接不同的软件包生态。

## 命令

- [持续集成](https://semifold.noctisynth.org/markdown/zh/commands/ci.md): 用一条命令执行生成的 GitHub Actions 发布拉取请求或发布分支行为。
- [创建变更集](https://semifold.noctisynth.org/markdown/zh/commands/commit.md): 通过交互创建变更集，或用明确参数表达同一项发布意图。
- [配置文件](https://semifold.noctisynth.org/markdown/zh/commands/config.md): 同步发现的软件包、迁移旧字段，并在不重写无关策略的情况下维护命名发布通道。
- [初始化](https://semifold.noctisynth.org/markdown/zh/commands/init.md): 发现软件包、创建 Semifold 配置，并按需生成受支持的 GitHub Actions 工作流。
- [MCP 工具](https://semifold.noctisynth.org/markdown/zh/commands/mcp.md): 启动通过标准输入输出提供、具有版本修订保护的变更集增删改查 MCP 服务器。
- [发布软件包](https://semifold.noctisynth.org/markdown/zh/commands/publish.md): 从已经完成版本修改的清单和变更日志重新建立发布执行计划，再按依赖关系发布软件包。
- [命令索引与通用选项](https://semifold.noctisynth.org/markdown/zh/commands/reference.md): 快速查找当前 Semifold 命令、对应行为页面和全局执行选项。
- [发布状态](https://semifold.noctisynth.org/markdown/zh/commands/status.md): 在不修改软件包文件、变更日志和变更集的情况下，计算整座仓库的版本决定。
- [更新版本](https://semifold.noctisynth.org/markdown/zh/commands/version.md): 把软件包版本、内部依赖要求、变更日志和已消费变更集作为一项发布操作进行校验和应用。

## 概念

- [术语表](https://semifold.noctisynth.org/markdown/zh/concepts/glossary.md): 解释 Semifold 文档中与仓库、软件包、版本和发布有关的核心术语。

## 配置

- [配置概览](https://semifold.noctisynth.org/markdown/zh/configuration/overview.md): 理解 .changes/config.toml 各部分的职责，以及日常维护配置的正确流程。
- [配置参考](https://semifold.noctisynth.org/markdown/zh/configuration/reference.md): 逐项说明当前 .changes/config.toml 配置结构中的字段、默认值和职责。

## 开始使用

- [接入已有单仓库](https://semifold.noctisynth.org/markdown/zh/getting-started/adopt-existing-monorepo.md): 在不改变现有构建方式的前提下，让 Semifold 发现软件包、固定身份并接管版本与发布流程。
- [完成第一次发布](https://semifold.noctisynth.org/markdown/zh/getting-started/first-release.md): 初始化一座小仓库、记录变更、检查受影响的软件包、修改版本并执行发布。
- [安装 Semifold](https://semifold.noctisynth.org/markdown/zh/getting-started/installation.md): 安装最新发布的 Semifold 命令行工具，并确认 smif 命令可以使用。

## 插件

- [能力与安全边界](https://semifold.noctisynth.org/markdown/zh/plugins/capabilities.md): 理解插件运行时默认拒绝的文件、网络、命令执行和文件修改边界。
- [插件系统](https://semifold.noctisynth.org/markdown/zh/plugins/overview.md): 通过受限权限的仓库内插件，让 Semifold 支持四种内置生态之外的软件包格式。
- [编写生态插件](https://semifold.noctisynth.org/markdown/zh/plugins/quick-start.md): 定义版本为 1 的 JavaScript 生态适配器，完成打包、权限注册，并验证软件包发现与版本规划。

## reference

- [CLI 参数参考已移动](https://semifold.noctisynth.org/markdown/zh/reference/cli.md): 前往命令行模块查看 Semifold 命令行为与参数。

## 工作区

- [同步工作区配置](https://semifold.noctisynth.org/markdown/zh/workspace/config-sync.md): 在软件包增加、移动或移除后安全维护 .changes/config.toml，而不覆盖发布策略。
- [C++ 工作区](https://semifold.noctisynth.org/markdown/zh/workspace/cpp.md): 基于 CMake 的静态软件包发现、版本修改、内部链接排序和当前限制。
- [依赖与版本传播](https://semifold.noctisynth.org/markdown/zh/workspace/dependencies.md): 区分依赖排序、自动版本传播与跨生态 depends-on，理解为什么相关软件包会进入发布。
- [Node.js 工作区](https://semifold.noctisynth.org/markdown/zh/workspace/nodejs.md): package.json、npm/pnpm workspace、依赖前缀和私有软件包的当前支持范围。
- [软件包发现](https://semifold.noctisynth.org/markdown/zh/workspace/package-discovery.md): 理解 Semifold 如何从不同清单建立统一工作区，以及配置中的稳定软件包身份从哪里来。
- [Python 工作区](https://semifold.noctisynth.org/markdown/zh/workspace/python.md): pyproject.toml、setup.cfg、动态版本来源、发现目录和发布通道限制。
- [Rust 工作区](https://semifold.noctisynth.org/markdown/zh/workspace/rust.md): Rust 软件包的 Cargo 发现、共享版本、依赖约束修改与私有发布规则。

## 更多入口

- [英文索引](https://semifold.noctisynth.org/llms.txt)
- [双语全文](https://semifold.noctisynth.org/llms-full.txt)
- [Semifold Skill](https://github.com/noctisynth/semifold/tree/main/skills/semifold)