文档编程语言【免费下载链接】cangjie_docs仓颉编程语言开发者文档。项目地址https://gitcode.com/Cangjie/cangjie_docs点击查看免费下载仓颉中心仓官网是仓颉语言三方库托管平台的 Web 前端入口承担账号操作、制品搜索与组织管理三大核心职能。本文围绕官网的注册登录、个人信息与 API Token 管理、制品检索与详情页、组织创建与管理四条主线展开并结合 中心仓客户端配置 与 中心仓通信规格 等仓库文档帮助你在官网完成“注册 → 获取 Token → 检索制品 → 发布上线”的完整操作闭环。一、中心仓官网的定位三端协同中的 Web 入口根据 中心仓概述仓颉中心仓Cangjie Central Repository是仓颉语言的三方库托管平台由三个部分组成组成部分职责说明中心仓官网搜索、浏览制品信息以及用户和组织的管理操作本文的主角Web 前端界面中心仓客户端制品的上传和使用集成在仓颉项目管理工具cjpm中中心仓仓库存放三方库制品包及对应元数据后端存储与通信端从这一分工可以看出官网是面向人的“控制面”注册账号、管理组织、生成发布凭证Token、查看制品信息而真正的制品上传与依赖解析由客户端cjpm通过后端仓库接口完成。官网与客户端之间的衔接点正是用户 Token——这是理解后文 Token 章节的关键。二、注册账号与登录方式官网右上角的“登录”按钮用于注册中心仓账号或登录已有账号。登录方式分为两类GitCode 快捷登录若用户已登录 GitCode 账号则可以直接验证并登录中心仓无需单独注册其他登录方式除 GitCode 外中心仓还支持登录界面内“其他登录方式”一栏中列举的登录方式。账号本身不是浏览制品的前提搜索与查看制品页无需登录但它有两个关键用途发布制品的身份凭证cjpm publish发布制品包时必须携带有效用户 Token 完成认证缺少 Token 或 Token 失效会导致上传失败对应 通信规格 中401用户认证失败返回码组织操作资格创建组织、管理成员、发布组织内制品等操作都依赖账号身份。三、个人信息个人主页与个人中心登录后官网右上角会显示用户名和头像它承载两个不同的入口3.1 个人主页制品与关注一览点击用户名或头像可进入个人主页页面上可以看到用户的个人信息用户名、头像制品标签页用户上传的制品列表包含制品名、版本号、累计下载量、最近下载量、更新时间等统计信息关注标签页用户关注的制品/组织列表。3.2 个人中心资料修改与组织列表将光标悬停在用户名或头像上会弹出下拉菜单从中可以进入个人中心页面。个人中心的两个主要功能区个人资料查看或修改个人信息用户名、头像等组织列表查看自己创建或加入的组织并进入对应组织的管理页面见第六节。个人中心同时也是API Token的管理入口详见下一节。四、API Token 管理官网与客户端的桥梁在个人中心的API Token页面可以对用户 Token 执行三类操作操作说明典型场景新建 Token生成一枚新的用户 Token页面提示将其配置到本地中心仓配置文件cangjie-repo.toml中并要求确保令牌保密性首次发布制品前重新生成对已有 Token 作废旧密钥并签发新密钥旧 Token 随即失效Token 疑似泄露、定期轮换作废删除删除已不再使用的旧密钥清理过期凭证4.1 Token 如何生效配置到 cangjie-repo.toml官网页面上的提示与实际配置机制一致获取的 Token 需要写入中心仓客户端的仓库配置文件cangjie-repo.toml才会在cjpm的上传/下载通信中生效。依据 中心仓客户端配置该文件的格式为[repository.cache] path /path/to/repository/cache # 本地存放路径 [repository.home] registry https://pkg.cangjie-lang.cn/registry # 中心仓 url token user-token # 用户个人 token各字段含义repository.cache.path本地缓存路径用于存放从中心仓下载的制品包源码。可填绝对或相对路径相对路径以当前cangjie-repo.toml为基准留空时Linux/macOS上默认为$HOME/.cjpmWindows上默认为%USERPROFILE%\.cjpm。最终生效路径记为CACHE_PATH下载的制品包源码及相关内容存放在${CACHE_PATH}/repository目录下repository.home.registry中心仓仓库地址https://pkg.cangjie-lang.cn/registrycjpm所有制品上传/下载请求都以此为基础地址发起见 通信规格repository.home.token用户个人 Token仅在上传制品包时用于用户认证日常下载制品无需 Token。cangjie-repo.toml可在三个位置配置cjpm按以下顺序查找命中即止模块内与cjpm.toml同级目录的cangjie-repo.toml用户目录下.cjpm目录内的cangjie-repo.tomlLinux/macOS为$HOME/.cjpm/cangjie-repo.tomlWindows为%USERPROFILE%\.cjpm\cangjie-repo.toml仓颉SDK中tools/config目录下的cangjie-repo.tomlSDK 默认自带全部为默认值。从配置优先级可以推断模块级配置便于在不同项目间使用不同组织身份发布用户级配置则适合长期固定一台开发机的场景。4.2 Token 在发布链路中的位置结合 制品包发布 文档cjpm publish成功需要同时满足四个条件其中第一条即“已在cangjie-repo.toml中配置有效的用户 token”。换言之官网 Token 页是发布链路中唯一的凭证签发入口官网创建 Token → 写入 cangjie-repo.toml → cjpm bundle 打包 → cjpm publish 上传携带 Authorization上传请求按 通信规格 以Authorization${token}请求头携带凭证服务端对认证失败返回401、无权限返回403。五、制品信息搜索框与制品详情页5.1 搜索框制品与组织的前缀检索中心仓页面顶部的搜索框是浏览平台内容的主入口支持检索两类对象制品输入制品名检索仓库中的制品组织输入组织名检索组织组织内制品同样可通过搜索框找到。两个实用细节快捷键聚焦按下Shift S或/可快速聚焦搜索框匹配模式限制目前搜索功能仅支持前缀搜索即输入关键字必须从制品名/组织名开头连续匹配不支持模糊或部分子串检索。例如输入cangjie_artifact可以命中而输入artifact无法从后部子串命中。搜索结果页提供多个排序维度标签相关性、累计下载、最近下载、最近更新、最新发布、组织每个结果条目展示制品名、版本号、描述、作者以及累计下载、最近下载、更新时间等统计。5.2 制品详情页从 README 到依赖信息点击搜索结果中的制品条目可进入制品详情页页面信息包括README制品的说明文档来自制品包内的README.md/README_zh.md标签tag如#cangjie、#artifact便于快速识别主题版本列表Version制品的全部历史版本依赖Dependencies该制品的依赖关系Metadata 侧栏上传时间、当前版本、包大小、SHA-256 校验值用于验证制品包完整性Usage直接给出两种引入方式的现成命令/配置——cjpm install 制品名-版本号或在cjpm.toml中添加制品名 版本号Homepage / Documentation / Repository制品主页、文档页与代码仓库地址Publisher / Categories发布者与官方制品分类。这些展示字段并非人工逐条录入而是来自cjpm bundle打包时生成的元数据文件meta-data.json。依据 中心仓元数据规格元数据记录了organization组织名、name模块名、version版本号、cjc-version仓颉 SDK 版本号、description模块描述、authors作者 ID 列表、repository代码仓、homepage制品主页、documentation文档页、tag标签、category分类、license协议列表等字段并内嵌制品包索引index含依赖信息与sha256sum校验码。“元数据用于仓库端入库检查和网页端制品展示”——这解释了为什么详情页的 Usage、Metadata、Publisher 等板块与打包时填写的cjpm.toml字段一一对应。六、组织管理从创建申请到管理员权限组织是“开发和维护一个或多个制品的协作群体”制品可以隶属于组织也可以不属于任何组织。官网的组织管理流程如下6.1 申请创建组织在个人中心的组织页面可以申请创建组织。组织名必须遵守 中心仓制品规格 中的命名规范由大小写字母、数字和下划线组成长度在[3, 64]之间必须以字母或若干个下划线开头以下划线开头时第一个非下划线字符必须是字母例如cangjie_demo_1、__Cangjie_Demo_2组织名不能为任何仓颉语法关键字大小写不敏感且不能为default知名企业审核组织名涉及知名企业时必须额外提供企业域名的DNS TXT Record证明否则无法通过审核不符合法律法规的组织名同样不会获批。6.2 管理员职责与组织管理页组织通过审核后创建者默认成为组织的管理员每个组织有且仅有一个管理员。管理员通过个人中心的组织页面进入对应组织的管理页面可执行的操作包括操作说明邀请成员将其他用户加入组织使其获得组织内制品的协作发布资格删除成员移除组织内不再参与协作的成员转让管理员将唯一的管理员身份移交给其他成员成员身份直接影响发布行为cjpm publish要求“若制品包隶属于某个组织则 Token 对应的用户需要是该组织的成员”否则上传会被拒绝。此外制品名在同一组织内或无组织范围内要求唯一这是组织作为命名空间的意义所在——不同组织可以存在同名制品客户端引用时使用org::dep的组织内依赖形式加以区分见 制品包发布 中dependencies的“org::boo” { version 2.0.0 }写法。七、小结围绕官网的一条完整工作流将各章节串联起来一个新用户从注册到制品上线的完整路径是在官网右上角完成注册/登录GitCode 账号可直接验证登录在个人中心 →API Token页面新建 Token并按 4.1 节写入cangjie-repo.toml的repository.home.token可选在个人中心的组织页面创建组织通过命名审核与 DNS TXT 验证后获得管理员权限并邀请成员本地完成cjpm bundle打包生成模块名-版本号.cjp与meta-data.json再执行cjpm publish上传回到官网搜索框按前缀检索制品名在详情页核对 README、版本、依赖与 SHA-256 校验值确认入库成功。整条链路中官网负责“人”账号、组织、Token客户端cjpm负责“物”打包、上传、下载两者通过cangjie-repo.toml中的 Token 与registry地址完成闭环。赞分享文档编程语言【免费下载链接】cangjie_docs仓颉编程语言开发者文档。项目地址https://gitcode.com/Cangjie/cangjie_docs点击查看免费下载相关推荐仓颉中心仓制品规格详解制品包、制品与组织的概念及命名规范仓颉中心仓制品规格详解制品包、制品与组织的概念及命名规范 仓颉中心仓Cangjie Central Repository以 制品 为单位统一管理三方库本文档编程语言仓颉中心仓制品包发布指南cjpm bundle 与 publish 全解析仓颉中心仓制品包发布指南cjpm bundle 与 publish 全解析 本文基于仓颉开发者文档仓库cangjie_docs中的中心仓客户端文档系统讲文档编程语言仓颉-C互操作FFI实战如何在仓颉中调用C库的完整指南仓颉 C互操作FFI实战如何在仓颉中调用C库的完整指南 想让仓颉程序直接调用成熟的 C 库吗仓颉编程语言通过 FFIForeign Function文档编程语言创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考