桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载本指南完整解析 EcoPaste 仓库.agents/skills/trellis-check/SKILL.md中定义的六步代码质量检查流程从 diff 变更识别、规范文档对照到 lint / 类型检查 / 测试执行、Checklist 逐项核查与跨层数据流校验并结合仓库中真实存在的 Biome、TypeScript 与 Rust 质量设施给出可直接落地的操作命令与判断标准。读完本文你将掌握一套提交前自查与长会话防漂移的工程化质量校验方法论。技能定位为什么需要一套代码质量检查工作流.agents/skills/trellis-check/SKILL.md本文简称该技能是 Trellis 体系中负责质量守门的环节。其 frontmatter 声明了它的适用时机代码已写完、需要做质量验证时提交commit之前长会话中需要捕捉上下文漂移context drift时。它把质量检查从零散的凭感觉核对收敛为一条确定性的六步流水线识别变更 → 对照规范 → 跑项目检查 → 逐项自检 → 跨层审计 → 修复并复跑。该技能本身是通用方法论文档不绑定某一具体语言本文以其为骨架用 EcoPaste 仓库AGENTS.md 所定义的 Rust-First Tauri 架构的实际设施逐条印证使其变成可复制、可运行的工程实践。Step 1识别变更范围任何质量检查的第一步都是搞清楚我到底改了哪些文件。该技能给出的两个命令git diff --name-only HEAD git statusgit diff --name-only HEAD列出相对最近一次提交的已暂存 未暂存变更文件清单是最小化的影响面git status补充完整工作区状态含未跟踪文件、重命名、冲突标记。对 EcoPaste 这类前后端同仓的 Tauri 项目影响面判断要先按技术栈分层src/React 前端与src-tauri/Rust 后端改动应分开对待因为后续检查命令完全不同。此外需注意 EcoPaste 的分支策略见 AGENTS.md 快速原则若当前分支为master且需要推送应自动新建工作分支再提交推送。Step 2读取任务产物与适用规范技能要求按顺序读取当前任务产物prd.mddesign.md如存在implement.md如存在然后运行python3 ./.trellis/scripts/get_context.py --mode packages并逐个读取变更包/层对应的规范索引cat .trellis/spec/package/layer/index.md该技能特别强调index 是指针不是目标——索引文件只负责定位必须继续打开其中引用的具体规范文件才算完成阅读。EcoPaste 仓库中.trellis/目录承载任务 backlog、PRD 与调研资料见 AGENTS.md 顶部说明而当前仓库快照内的可读规范载体是根目录的 AGENTS.md它同时是AI 编码工具的单一真相源集中定义了 Rust-First 架构边界、跨端契约、目录约定、Rust 约定与前端约定。在实际检查中读取的规范应至少包含该文件且重点核对与本次改动相关的章节如改 schema 时必须对照已发布版本的 schema 变更必须新增 migration已发布 migration 不回改一条。Step 3运行项目检查命令这是流水线中最具确定性的环节。EcoPaste 将质量工具直接写进了 package.json 与 git hooks可据此复现完整命令链。前端lint 类型检查pnpm lint # biome check pnpm tsc # tsc --noEmitpnpm lint走 Biome配置见 biome.json规则启用preset: recommended并额外以error级别开启noConsolesrc/utils/log.ts 注释中可见biome-ignore lint/suspicious/noConsole的豁免场景、noUnusedImports、noUnusedVariables等还包含useTemplate、useSelfClosingElements、useSortedClasses这类带fix: safe的可自动修复规则pnpm tsc即 tsconfig.json 下的tsc --noEmitstrict: true、noUnusedLocals、noUnusedParameters、noFallthroughCasesInSwitch全部开启前端路径别名/*映射到./src/*。后端fmt clippy testcd src-tauri cargo fmt cargo clippy -- -D warnings cargo testcargo fmt依据 src-tauri/rustfmt.toml 统一格式cargo clippy -- -D warnings把 clippy 警告升级为错误是提交硬性门槛cargo test运行全部 Rust 单元测试。提交门禁git hooks 自动拦截EcoPaste 的 simple-git-hooks.json 注册了两个 hookpre-commit→npx lint-staged只对暂存文件执行检查commit-msg→npx --no-error-on-unmatched commitlint -e校验 Conventional Commits 规范。其中 lint-staged 的规则定义在 lint-staged.config.ts前端文件执行biome check --write --no-errors-on-unmatchedRust 文件执行cargo fmt与cargo clippy --all-targets --all-features -- -D warnings。也就是说Step 3 的这些命令平时已由 hook 半自动执行但提交前仍建议手动全量跑一遍因为 lint-staged 只覆盖暂存文件。Step 4对照 Checklist 自检技能给出了三组勾选项逐条说明其在 EcoPaste 语境下的落点。代码质量Code QualityLinter passes?对应pnpm lint与cargo clippy -- -D warnings注意 Biome 的noConsole是error级意味着遗留console.log会直接判红Type checker passes?对应pnpm tscstrict 模式Tests pass?对应cargo testNo debug logging left in?EcoPaste 的日志约定是统一走 src/utils/log.ts禁止裸console.*AGENTS.md 前端约定。log模块统一经tauri-apps/plugin-log落到 Rust 侧 LogDir 文件与 Rustlog::error!同源dev 环境才镜像到浏览器 consoleNo suppressed warnings or type-safety bypasses?在 EcoPaste 即检查是否存在不必要的biome-ignore、any逃生舱Biome 中noExplicitAny虽被关闭但/utils/is、类型定义文件等仍应按规范收敛与 Rust 侧unwrap()滥用。测试覆盖Test Coverage新函数 → 单元测试修复 bug → 回归测试行为变更 → 更新既有测试。EcoPaste 的 Rust 侧测试体系是这一条的最佳佐证仅 src-tauri/src/db/items.rs 一个文件就包含 30 个#[tokio::test]用例覆盖入库去重upsert_dedups_same_content_bumping_use_count、排序默认值query_default_sorts_by_updated_at、收藏/置顶过滤query_filters_by_favorite_and_pinned、SQLite FTS 搜索search_fts_matches_prefix_across_columns、分页query_paginates_with_limit_and_offset、历史清理保留收藏与置顶cleanup_history_drops_old_items_keeping_pinned_and_favorite等关键行为src-tauri/src/clipboard/ 下的watcher.rs、read.rs、guard.rs、cleanup.rs等模块也各自带测试。改到这里对应的行为时应先确认这些既有用例是否被同步更新。规范同步Spec Sync技能的检查点是.trellis/spec/是否需要更新并给出一个判断口诀If I fixed a bug or discovered something non-obvious, should I document it so future me wont hit the same issue? → If YES, update the relevant spec doc.如果我修复了一个 bug 或发现了某个非显然的问题是否应该记录下来免得未来的自己再踩同一个坑→ 若是就更新相应规范文档。在 EcoPaste 中这条对应的是新形成的模式、约定、经验教训应沉淀回规范载体AGENTS.md及.trellis/体系例如改 schema 时同步检查所有SELECT/INSERT/UPDATE/bind/测试结构体字面量因为query_as字段不匹配可能表现为 UI 空结果这类经验正是应当被文档化的非显然知识。Step 5跨层维度审计技能明确若改动只局限在单一层如只改一个前端组件本步可跳过。只有改动触及多层如同时改了 Rust 命令、前端调用、类型与 schema时才执行下列审计。A. 数据流改动触及 3 层读链路Storage → Service → API → UI 是否正确写链路UI → API → Service → Storage 是否正确类型/schema 是否在层间正确传递错误是否被正确传播给调用方。EcoPaste 的数据流契约非常清晰AGENTS.md 跨端契约前端通过#[tauri::command]调 RustRust 用emit通知刷新命令名、事件名、channel/storage key 等跨端或多处复用的字面量必须集中维护Rust 模块常量 src/constants/ 同步更新。事件名统一采用domain://action格式如clipboard://updated、settings://updated、window://visibility、keyboard://nav。因此跨层改动时必须同步检查常量文件两侧是否一致这正是类型/schema 在层间正确传递的具体形态。Rust 侧的错误传播约定进一步细化了错误正确传播的标准命令与仓储函数用asyncResultT, AppErrorAppError序列化为{ kind, message }message写用户可读根因不加xxx failed: {err}动作前缀动作上下文由前端 toast label 拼接技术上下文写日志错误类型用thiserror内部传播用anyhow上下文用tauri-plugin-log。跨层检查时若新增命令没有按此返回AppError即为违反规范的传播缺口。B. 代码复用修改常量、创建工具技能要求先搜索已有实现再新建grep -r pattern src/并遵循三条规则两处以上定义同一值 → 抽取共享常量批量修改后 → 所有出现位置同步更新创建新工具函数前 → 确认没有同能力旧实现。EcoPaste 的常量集中原则跨端字面量必须集中在 Rust 模块常量 src/constants/与此完全同构——例如captureKinds.ts、itemActions.ts、events.ts、windows.ts等即属于这类集中点。C. 导入/依赖创建新文件导入路径正确相对 vs 绝对EcoPaste 前端约定用/*路径别名tsconfig.json无循环依赖。D. 同层一致性检查其他使用同一概念的地方是否保持一致。EcoPaste 中典型场景新增 UI 文案必须同步补齐zh-CN默认与en-US两套 localesrc/locales/新增颜色必须先扩 src/unocss/presetAntdColors.ts平台代码用#[cfg(target_os macos)]/#[cfg(target_os windows)]隔离且两端同步实现。Step 6报告、修复与复跑技能的收尾动作非常明确报告发现的问题直接修复修复后重跑项目检查。结合该技能 frontmatter 的定位在提交之前完整的收尾还应包括汇总违例清单lint 报错、类型错误、测试失败、跨层不一致、规范缺口逐个修复遵循仓库规范如 Rust 侧cargo clippy -- -D warnings为硬门槛重跑 Step 3 的全部命令直至全绿如需新增测试新函数 / bug 修复在复跑前补齐用例若发现非显然经验按 Step 4 的 Spec Sync 判断是否需回写规范文档最后借助 simple-git-hooks.json 的 pre-commit 门禁自然完成提交前的最后校验。在 EcoPaste 中落地的最小命令集把以上六个步骤浓缩为一份可直接复制的检查清单适用于修改了前后端多层的提交# Step 1 变更范围 git diff --name-only HEAD git status # Step 3 前端 pnpm lint pnpm tsc # Step 3 后端按规范应在 src-tauri 目录下执行 cargo fmt --check cargo clippy --all-targets --all-features -- -D warnings cargo test # Step 5 复用性检查 grep -r 目标模式 src/ src-tauri/src/判断基准以仓库实际配置为准Biome 开启recommendedpreset 并将noConsole、noUnusedImports、noUnusedVariables设为 errorbiome.jsonTypeScript 全量 stricttsconfig.jsonRust 侧 clippy 警告即失败、测试覆盖集中在src-tauri/src各模块如 src-tauri/src/db/items.rs。总结trellis-check技能的可贵之处在于把质量定义为一套可执行、可复验、可追溯到文件的流程先看清影响面再以规范校准预期用 lint / 类型检查 / 测试三件套建立基线通过 Checklist 逐项自查堵住测试缺失、调试残留、规范不同步三类高频漏网最后对跨层改动单独做数据流、复用、依赖与一致性审计。在 EcoPaste 的工程语境下这套流程与仓库已有的质量设施biome.json、tsconfig.json、lint-staged.config.ts、simple-git-hooks.json、cargo test测试体系天然咬合——工具负责拦截流程负责兜底规范AGENTS.md负责沉淀经验。无论是 AI Agent 在长会话中防漂移还是开发者提交前自查都可以直接照此执行。赞分享桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载相关推荐FckSignups 社区生态全解读Discord、Reddit 与 GitHub 如何协作FckSignups 社区生态全解读Discord、Reddit 与 GitHub 如何协作 FckSignups现更名 NoSignups是一个收录 2桌面应用基于 fairseq 的多样机器翻译混合专家模型translation_moe实战指南训练、解码与评估基于 fairseq 的多样机器翻译混合专家模型translation_moe实战指南训练、解码与评估 本文围绕 fairseq 仓库中的 transla桌面应用Ptex性能基准测试与其他纹理系统的对比分析Ptex性能基准测试与其他纹理系统的对比分析 Ptex作为一款面向生产渲染的每面纹理映射系统在计算机图形学领域具有独特的技术优势。本文将通过客观的性能基准测桌面应用上一篇Certimate Grafana仪表盘导入模板实现证书状态监控下一篇如何快速搭建前后端分离博客blog45/blog新手入门教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
