# 安装 Lanveris Skill 说明修订:`0.2.5-install.1`。技能包版本:`0.2.5`。CLI 版本:`0.2.5`。目标服务:`https://lanveris.net`。 This guide installs the standalone Lanveris CLI for Work Sharing and Agent Proof. Use the bundled executable by its absolute path. See [Work Sharing](https://lanveris.net/skill.md) and [Agent Proof](https://lanveris.net/proof/skill.md) for commands and service behavior. 本说明供具备本地文件与命令执行能力的 Agent 执行,当前入口为 `/install.md`。同一个独立客户端可用于工作分享与 Agent 产出存证。仅需存证时,也可按同一固定表校验、解包,在本机可复用目录保存客户端并用绝对路径调用。需要让 Agent 自动发现工作分享 Skill 时,按下方宿主目录安装。不需要商城插件或注册 MCP。 ## 安装范围和宿主识别 仅准备存证客户端时,确认实际系统与架构,执行下一节的校验与解包步骤,将核对后的客户端保存在本机可复用目录,记录实际绝对路径。工作分享 Skill 按以下规则安装。 默认安装到当前系统用户的 Skill 目录,使同一 Agent 的其他项目和新窗口可用;只有用户明确要求“仅当前项目”时才使用项目目录。不让用户替 Agent 选择目录,不因项目目录容易写入而静默退回项目级。 某些宿主把这个用户范围目录称为“受管目录”:它是该宿主存放用户技能的位置,不是另一个安装范围,也不表示其他 Agent 会自动共用这份 Skill。 先识别当前执行任务的具体宿主、版本、系统用户、操作系统、架构和实际执行环境。宿主版本应来自当前应用或实际运行进程,不用 PATH 中另一个同名 CLI 的版本冒充;无法核实时注明未知。Windows 桌面、集成终端与 Agent 的执行环境可能不同;Windows 原生用 Windows 包,Windows 中运行的 WSL2 Agent 按 WSL 的实际 Linux 架构选择。不能安装 Windows `.exe` 代替 Linux 客户端,也不能从 Windows 用户名拼出 WSL 主目录。 | 宿主 | 默认目录的确定方法 | | --- | --- | | Codex | 当前用户的 `.agents/skills/lanveris-handoff/`。macOS/Linux/标准 WSL 为 `$HOME/.agents/skills/lanveris-handoff/`;Windows 原生用当前用户路径 API,PowerShell 可用 `Join-Path $env:USERPROFILE '.agents\skills\lanveris-handoff'`。核实当前实例确实发现该用户目录。 | | WorkBuddy | 优先使用当前实例的 `WORKBUDDY_CONFIG_DIR`,其次 `CODEBUDDY_CONFIG_DIR`;均未配置时为当前用户主目录下 `.workbuddy`。在此配置根的 `skills/lanveris-handoff/` 安装。不借用 CodeBuddy IDE/CLI 的目录冒充 WorkBuddy。 | | Kimi Work | 按当前宿主自带的 Skill 安装规则:先从本轮 Available skills 核实用户安装所用的受管目录,再读取 `KIMI_SKILLS_ROOT`,最后回退当前用户的 `~/.kimi/daimon/skills/lanveris-handoff/`。不能把任意内置/只读插件目录当作可写受管目录,也不复用别的会话的路径。只有用户明确指定项目时才使用项目 `.agents/skills/`。Kimi Work 与 Kimi CLI 分开识别。 | | 其他宿主 | 先依据当前宿主的官方规则或自带安装指导确认用户级/受管目录和加载方式。不能套用 Codex 路径或把未确认宿主称作已兼容;无法确定时报告具体缺口,不静默缩为项目级。 | 目录规则依据:[Codex](https://learn.chatgpt.com/docs/build-skills)、[Codex Windows 环境](https://learn.chatgpt.com/docs/app/windows)、[WorkBuddy 技能](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Skills-Market)及其当前实例配置;Kimi Work 按当前应用内置 `skill-creator` 规则核定(本地已核 3.2.18),不将它写成 Kimi CLI 规则。 上述三宿主具备用户级或受管安装机制。WorkBuddy 旧版 Mac 已有跨项目实测;这不代替本说明修订的当前版本验收。当前没有 Windows ARM64、Linux ARM64 或 32 位原生包;没有匹配包就停止,不默认模拟运行。容器、远程电脑、Windows 与 WSL 的发现目录和凭据不自动互通。 ## 下载、检查与安装 1. 确定目标绝对路径后,选择本说明固定表中的包。正式包只从表中 HTTPS 地址下载;候选包仅从本说明声明的候选来源取用。核对字节数和 SHA-256,不匹配就停止,不执行包内内容;不以下载包附带的新哈希替换固定表。 2. 先检查 ZIP,再解压到发现目录以外的新临时目录。本版只接受四个普通文件:`lanveris-handoff/SKILL.md`、`lanveris-handoff/agents/openai.yaml`、`lanveris-handoff/release.json`、`lanveris-handoff/bin/lanveris`(Windows 为 `lanveris.exe`)。拒绝绝对路径、`..`、反斜杠路径、重复条目、符号链接、特殊文件和白名单以外条目。`release.json` 只作为版本及哈希数据读取,核对包版本、CLI 版本、平台、来源和解压后 Skill/二进制 SHA-256,不执行其中内容,不以它替换本说明的外层 ZIP 固定哈希。保持包内服务约束。 3. 核对旧安装和同名来源:当前项目及其父级、用户目录、当前宿主已加载的插件/MCP。文件存在不等于实际启用,不能把旧插件客户端当作新安装。只在来源可确认且没有自定义改动时更新同源文件;先把完整旧目录备份到所有 Skill 发现目录之外。来源不明或原文件有自定义修改时保留原件,说明冲突并请求具体处理选择,不覆盖、不删除,也不自动禁用已有插件或 MCP。 4. 在临时目录核验版本和离线帮助,成功后才放入已确定的目录;已有版本以可恢复方式替换,失败恢复原目录。新增安装失败时清除本次半成品,保留故障原因。备份、临时目录和安装回执不放在 Skill 扫描目录中,避免重复发现。 5. 中文或空格路径使用环境的路径 API、独立参数或正确引用的绝对路径,不把 `~` 当作所有终端通用语法。macOS/Linux 检查执行位,Windows 使用 PowerShell 的环境变量和 `.exe` 调用方式;不提供一条假装跨平台的万能命令。 文件写入、下载或命令执行需要权限时,走当前宿主正常的授权流程。拒绝授权就报告安装未完成及受阻步骤,不降低安装范围,不修改 HOME、USERPROFILE、系统执行策略、全局审批、PATH 或宿主保护设置。安装不登录、不创建云连接、不上传文件,不读取、复制、导出或删除系统凭据。 ## 确认实际生效 用实际客户端的绝对路径执行 `--version`(应为本说明列出的 CLI 版本)。按使用目的检查 `handoff send --help` 或 `help`;核对实际文件位置、二进制 SHA-256 和服务地址。说明修订号与 CLI 版本分别记录,不能从说明目录名推算 CLI 版本。安装 Skill 时,宿主要求刷新或重启就按其提示处理;Codex 通常自动检测,未出现时才重开。 安装结束说明安装范围、真实目录、说明修订、CLI 版本、是否保留旧版以及当前发现结果。完整跨项目验证还要在另一个不含项目 Skill 的干净项目,新开不继承安装对话的任务,不提供安装路径或手动注入技能,确认自然发现的 Skill 和实际客户端版本。不能独立验证时写明“跨项目发现待验”,不把文件存在、离线帮助、文案检查或旧版本测试当作本版验收。 Codex、WorkBuddy、Kimi Work 分别记录实际宿主版本和系统。Windows 原生、WSL、macOS Intel、Linux 的安装发现、凭据及收发必须分别实测;交叉编译或下载成功不能代替它们。允许/拒绝正常权限、旧版升级、重复来源与自定义内容保留分别记录。只有用户另行授权具体文件分享时才测真实收发;安装本身不构成发送授权。 ## 已安装用户升级 本版独立 Skill 在实际使用后调用同目录客户端 `skill-update`,正常每24小时检查一次正式公共版本,缓存命中不再联网;同一新版仅提醒一次。它只检查,不安装、不登录、不上传、不创建后台任务,也不修改审批或连接。检查失败不影响原分享结果;`--force` 仅由用户主动要求立即检查时使用,仍不重复同版提醒。用户没有明确同意升级时继续使用现有版本;不要把旧安装授权当作升级授权。 用户要求更新时重新读取官网 `/install.md`,以当前最新说明的固定包和哈希执行同源更新步骤;已发布的旧版本地址保持不变,不能修改旧文件冒充更新。包内容版本、CLI 版本、说明修订分别核对,不只看 CLI 是否相同。保留完整旧目录及自定义内容,未知来源先处理冲突。同一服务的连接凭据位于安装目录之外,更新不删除/复制/导出凭据,已有分享链接不变。已运行任务或工具进程可能继续使用旧版;按宿主要求刷新或新建任务,重新核验实际客户端路径和版本。旧版0.2.1尚无此提醒能力,需要先主动更新一次。 ## 连接目录访问提示 遇到“无法保护连接目录”时,检查工作台访问系统用户配置目录的正常许可,获准后再重试。仍失败请联系支持,并保留已有本机凭据。 ## 固定下载与校验 | 系统 | 下载 | 字节数 | SHA-256 | | --- | --- | ---: | --- | | macOS Apple Silicon | [lanveris-skill-0.2.5-darwin-arm64.zip](https://static.lanveris.net/downloads/agent-skill/0.2.5/lanveris-skill-0.2.5-darwin-arm64.zip) | 5662793 | `a71f3b9ad5db770eb7c6f7a00a3ad4c8fbf93732b94be2ec24ee238c42028795` | | macOS Intel | [lanveris-skill-0.2.5-darwin-amd64.zip](https://static.lanveris.net/downloads/agent-skill/0.2.5/lanveris-skill-0.2.5-darwin-amd64.zip) | 6051019 | `20b829e48aa557d46b3d3750be1202e7ddfaaf5b5d2d1a21eeefaa9c28fc9884` | | Windows x64 | [lanveris-skill-0.2.5-windows-amd64.zip](https://static.lanveris.net/downloads/agent-skill/0.2.5/lanveris-skill-0.2.5-windows-amd64.zip) | 6103787 | `605033f67b3a6ada85303354847ebcd1174186ebc86ecba2889fa7497f4d9f56` | | Linux x64 | [lanveris-skill-0.2.5-linux-amd64.zip](https://static.lanveris.net/downloads/agent-skill/0.2.5/lanveris-skill-0.2.5-linux-amd64.zip) | 6265328 | `9a47c5451a00e4b369c3d83b673f6db51dda6e134516e9dfab05631e48f1c8c8` | ## 安装后的使用 只有用户要求分享具体文件后才运行同目录客户端,并只为该子进程设置 `LANVERIS_HANDOFF_ORIGIN=https://lanveris.net`。Windows 使用当前终端对应的环境变量方式。不放开 HTTP,不启用开发文件凭据。 已授权发送使用 `handoff send --title "项目进展" --context-file "说明路径" --agent 实际Agent "文件或目录"`;不要上传 Skill 安装目录、凭据或无关资料。已授权下载用 `handoff download "链接" --to "新目录"`,不自动执行收到的代码。结果采用客户端实际返回的链接,不猜测。 首次发送会自动保存本机连接凭据。同一系统用户与服务地址下的 Agent 可以复用。每份分享最多 500 MB,默认有效 15 天。用 `handoff list` 查找自己的分享,按 ID 查看或下载;用 `handoff extend <分享ID> --until ` 延长仍有效的原链接,用 `handoff delete <分享ID>` 停止其访问。完整说明见 [工作分享](https://lanveris.net/skill.md)。 用 `register "文件路径" --desc "说明" --json` 生成产出存证。首次登记会在本地创建并保存 Agent 密钥,之后同一工作目录复用。用 `verify "原文件" "凭证路径"` 离线验证。见 [产出存证](https://lanveris.net/proof/skill.md)。安装或更新期间只检查本机版本和帮助,实际发送和登记按用户请求分别执行。 ## 0.2.5 验收范围 四个固定 ZIP 分别对应 Apple Silicon macOS、Intel macOS、Windows x64 和 Linux x64。包内 CLI 支持分享管理与 Agent 产出存证。工作台的用户级发现、跨项目凭据复用、权限提示及升级按宿主和系统独立验证。四平台构建范围不代表四个平台都已原生验收。0.2.4 的 Windows Codex 核心首用属于上一版实测。 ## 发行依据与实测边界 运行库:go1.26.10。包来源提交:`e045e5c6eb01787da6b8791bc82d781881fa7c52`。服务端要求 schema 28 及对应 V2 API。四种包只是构建/下载范围;本修订的安装发现、跨项目、正常权限、升级和收发结果以单独验收记录为准,不将旧版本测试当作本版验收。旧版固定发行地址和校验值保留,不覆盖。CLI 版本与说明修订独立。