安装与更新

使用言包锁定 21 个稳定库的公开标签、审阅依赖图并配置最小宿主权限。

确认工具链

全部库可在言序 1.1.12 上共同使用；单库最低版本见库目录。

yanxu 版本 --json
yanbao 版
yanbao 诊

添加稳定依赖

言包短名默认映射到yanxulang/yanxu-<短名>。言据仓库名例外，使用组织/仓库写法。

yanbao add yanxulang/yanju --package 言据 --version '^1.2'
yanbao add semver --package 言版 --version '^1.0'
yanbao add collections --package 言容 --version '^1.0'
yanbao add datetime --package 言时 --version '^1.0'
yanbao add validate --package 言验 --version '^1.0'
yanbao add log --package 言录 --version '^1.0'
yanbao add retry --package 言韧 --version '^1.0'
yanbao add cli --package 言令 --version '^1.0'
yanbao add http --version '^1.0'
yanbao add request --version '^1.0'
yanbao add jwt --package 言签 --version '^1.0'
yanbao add db --package 言库 --version '^1.0'
yanbao add sqlite --package 言舟 --version '^1.0'
yanbao add postgres --package 言库象城 --version '^1.0'
yanbao add mysql --package 言库海豚 --version '^1.0'
yanbao add orm --package 言映 --version '^1.0'
yanbao add html --package 言页 --version '^1.0'
yanbao add markdown --package 言章 --version '^1.0'
yanbao add web --version '^1.0'
yanbao add test --package 言试 --version '^1.0' --dev

每条命令都会更新格式 2 清单并重解完整图。应用通常只添加需要的顶层库，不应一次复制全部命令。

手工固定 Git 标签

审计要求明确来源时直接写清单：

[依赖]
言据 = { git = "https://github.com/yanxulang/yanju.git", 修订 = "v1.2.0", 版 = "^1.2" }
言库 = { git = "https://github.com/yanxulang/yanxu-db.git", 修订 = "v1.0.0", 版 = "^1.0" }
言映 = { git = "https://github.com/yanxulang/yanxu-orm.git", 修订 = "v1.0.0", 版 = "^1.0" }

[开发依赖]
言试 = { git = "https://github.com/yanxulang/yanxu-test.git", 修订 = "v1.0.0", 版 = "^1.0" }

不要把main当成稳定修订。版本范围决定允许升级的兼容线，标签/提交和内容校验由锁文件固定。

生成、解释和验证锁

yanbao install
yanbao tree
yanbao why 言库
yanbao check
yanbao test
yanbao audit

应用和库仓库都应提交言序.lock。CI 还应执行离线恢复，证明没有依赖开发缓存或可变网络状态。不要手工编辑锁中的提交、校验和、目标或原生制品。

更新

yanbao outdated
yanbao update --dry-run
yanbao update
yanbao check
yanbao test
yanbao build --release
yanbao audit

先审阅 dry-run 的版本和来源，再正式更新。主版本变化必须同时阅读 CHANGELOG、迁移、权限和兼容说明。

言窗的发布制品

言窗 Git 标签只保存源码与清单模板；可执行的六目标清单和动态库位于 1.0.0 GitHub Release 归档。普通 GUI 模板使用：

yanbao new 我的窗口 --gui

离线或审计环境应先校验并展开官方六目标归档，再显式提供完整包：

yanbao new 我的窗口 --gui --gui-path /已验证/yanxu-gui

详情见言窗 1.0。

权限由应用决定

能力	典型库	应用责任
文件	言据文件、言录文件、SQLite、言试快照、言访上传下载	只授权实际文件根
出站网络	言访、PostgreSQL、MySQL/MariaDB	只授权目标主机与端口，不记录完整凭据
TCP 监听	言讯、言枢开发服务器	开发只用回环；生产明确实际地址
进程	言舟可选 CLI 兼容后端	原生 SQLite 不需要；CLI 后端显式开启
原生扩展	三个数据库驱动	锁定目标、ABI、大小与摘要
GUI/剪贴板/对话框	言窗	三项独立授权，不互相隐式包含

依赖权限不会传给顶层应用。即使库的测试清单允许某项能力，消费者也必须在自己的清单中重新作出最小授权。

本地联调

yanbao add datetime --package 言时 --path ../yanxu-datetime --version '^1.0'

路径依赖只用于本地开发。发布前换回 Git 标签、更新锁、检查不存在path:来源，并从全新克隆执行检查、测试、示例、release 构建和消费者验收。

安装与更新

本页目录