assura

Assura 是一款用于软件项目的命令行验证工具，采用 Rust 编写，并以 MIT 和 Apache-2.0 双重许可证发布。其核心目标是在问题尚小的时候捕获项目偏差，通过单一的快速本地信号层，对代码库结构、命名、文件与分区限制、Markdown 文档、引用、分支与工作树变更压力以及项目特定策略进行检查。 该项目将其工作流定义为“一次性接入、工作时审查、需要时解释、合并前检查”，将“审查”（雷达）与“检查”（关卡）功能区分开来。 README 中描述的功能包括：针对项目级的命名、位置、路径限制、文件数量限制、Markdown 规范、引用及生成输出边界的验证；提供包含已配置检查项、非活动功能、分支/工作树变更、热点目录及优先级建议的紧凑项目审查报告；支持文本、JSON、YAML、建议、状态及代理格式的输出；支持代理就绪的接入流程，建立基准并安装项目本地指南；支持可重用的策略层，从语言无关的基础开始，按需添加特定语言或领域规则；支持迁移 LS-Lint 2.3 配置；提供冷启动与热启动性能证据；以及持续的本地验证，保持策略处于激活状态，合并编辑突发事件并报告覆盖范围。 安装方式包括公共 Shell 安装程序、适用于 Linux、macOS 和 Windows 的预构建发布包（每个包包含 assura 和必须位于同一目录下的内部 assura-full 组件），或通过 cargo 从源码构建。典型的面向代理的启动流程为：agent onboard、review、explain、watch、check；仅需结构验证的最小启动流程为 init 后接 check。配置存储在 .assura/config.yml 中，包含用于文件和目录命名规范及排除规则的 YAML 块。 该项目目前处于 1.0 版本之前：v0.3.0 是最新发布的版本，而 Review、Explain、onboarding、事件反馈及托管主机激活契约被分配至 v0.4.0 候选版本，仅在标签通过发布关卡后才会公开安装。支持列表显示，check 及其输出格式、init/status/migrate/hooks 和性能报告在 v0.3.0 和 v0.4.0 候选版中均受支持；而 review、doctor、explain、agent onboard、agent nudge、代理集成生命周期命令、包含本地内容/查询/上下文包的 Markdown/链接/引用/指南检查以及 watch/cache/daemon/sessions 则属于 v0.4.0 候选版功能。assura info、Markdown 安全修复及第一方扩展策略系列仍处于实验阶段；托管仪表板、自动广泛修复、远程插件加载、插件市场及各代理验证引擎明确列为不支持的发布功能。 发布采用标签驱动模式：更新版本和说明，通过发布候选关卡，推送带注释的 v* 标签，并触发构建 Linux、macOS 和 Windows 归档文件及校验和的发布工作流。开发过程使用分层 cargo xtask 命令（fast, pr, release-size, release-smoke, release-live, full），性能声明通过 cargo 基准测试进行跟踪，包括与 LS-Lint 的对比。文档链接涵盖入门指南、配置、CLI/API 参考、支持策略、发布说明、贡献指南及安全性。