用途:为 Solana 相关软件开发提供统一编码规范,适用于使用 TypeScript 的 Solana 客户端代码、使用 Solana crate 的 Rust 库、Anchor 程序等场景。
主要能力:一是真实性要求,代码、注释、命名、PR 标题、README、提交信息不得描述不成立的事实,不确定需明说,命名前先用 grep 确认标识符真实存在;文档只描述当前状态,不写“已不再使用”等历史表述。二是完整交付要求,功能需配套测试与文档,README.md 和 CHANGELOG.md 必须同步更新。三是测试标准,需运行项目实际测试命令(如 anchor test、cargo test 或项目 TypeScript 测试命令),禁止占位测试,测试须初始化账户、发送交易、验证状态变化与余额。四是术语规范,使用 program 而非 smart contract,使用 transaction fees 而非 gas,无 mempool 概念;代币程序区分 Token Extensions Program 与 Classic Token Program;统一写作 onchain/offchain,不加连字符。五是文档写作规范,标题不带编号,不设预览段落,不使用 ASCII 图、Mermaid 与 Markdown 表格,不用破折号,最终术语首次加粗。六是金融软件写作规范,避免误用 non-custodial、securities 等词,经济描述中用 token 而非 mint,角色术语全文统一。七是代码风格,提倡删除冗余注释与代码,变量名用完整单词、数组用复数、函数用动词,配置文件改动需注释说明原因。八是推荐使用最新稳定版 Anchor、Rust、TypeScript、Solana Kit 与 Kite,错误时优先升级;新项目用 npm,已有 pnpm 项目继续用 pnpm;不使用 yarn。
文档来源:Anchor、LiteSVM、Quasar、Solana Kite、Solana Kit、Agave、Switchboard、Arcium 等官方地址。
限制:不得使用已废弃来源(Solana Labs、Coral XYZ、Project Serum)及已停维护产品(Switchboard Functions、Clockwork,后者可用 TukTuk 替代)。具体收费与平台信息暂未提供。