@lumyne/omni-cli 0.0.0-stage → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/INSTALL.md ADDED
@@ -0,0 +1,11 @@
1
+ # 当前 Agent 安装合同
2
+
3
+ 通过 `skill source --json` 枚举 `omni-data` 和 `omni-project`。使用 `--name omni-project` 选择项目 Skill,分别解析其独立目标目录;`skill source/status/install/update` 都支持 `--name`,省略时维护命令保持默认 `omni-data`。安装一个 Skill 不代表另一个 Skill 已安装。
4
+
5
+ 先安装 npm 包 @lumyne/omni-cli;本地开发可安装用户提供的已验证 tarball。读取 omni capabilities --json 和 omni skill source --json。npm 安装完成仅代表引导 CLI 可用。
6
+
7
+ 当前 Agent 从自己实际配置或已公告目录解析一个绝对 Skill 目标,明确自己的合法名称。运行 omni skill install --agent <current-agent> --target <absolute-skill-directory> --json,复制完整 Skill 与独立 .runtime。运行返回 runtimeEntry 的 version、skill status,核对版本与 SHA-256;使用目标内的 .runtime/bin/omni.mjs 执行业务。只能同步当前 Agent,不扫描其他 Agent。
8
+
9
+ 宿主负责注册或刷新 Skill 并实际加载 SKILL.md;CLI 不伪造宿主发现成功。目录未知、非托管内容、编辑冲突或校验失败时保留现状并报告安装未完成。scripts-disabled 安装遵循相同流程。
10
+
11
+ 登录与数据库授权来自桌面「连接 Agent」。使用 --profile dev 选择开发版,--profile stable 选择安装版,未指定时自动识别唯一连接;同时存在两份连接时要求明确选择。可显式 --config 指定当前机器的受保护授权文件;不在提示词或日志中输出文件内容。Windows 的文件隐私由当前用户的系统配置目录 ACL 保护,macOS/Linux 同时校验 0600 和所有者。
package/README.md CHANGED
@@ -1,3 +1,39 @@
1
- # Temporary Holding Version
1
+ # 山海 OMNI 插件
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ 包内提供 `omni-data`(企业经营数据和市场大盘查询)与 `omni-project`(项目查询与编辑)两个独立 Skill,按当前任务选择。项目查询支持分组、项目与节点、任务详情及相关记录、文档正文与历史、系统 SOP/节点/任务模板。查询项目数据按企业隔离、企业内共享,系统模板全用户共享。
4
+
5
+ > 请使用山海 OMNI 插件,搜索抱枕相关类目,查询指定月份的销售额、环比、商品榜和店铺榜,并注明数据覆盖范围。
6
+
7
+ 市场大盘查询沿用同机账号连接和企业类目授权。详见 [市场查询命令](skills/omni-data/references/market.md)。
8
+
9
+ 项目使用提示词:
10
+
11
+ > 请使用山海 OMNI 项目插件,查询“轻量保温杯 · 新品上市”的任务进度和相关文档。
12
+
13
+ 项目查询为只读能力,项目元数据与封面通过统一的 `project edit` 编辑。文档与附件保存在山海项目模块。使用 `project list/get/context`、`directory list`、`node list/get`、`task list/get`、`document list/get/search/history`、`template list/get`;通过各命令的 `--help --json` 发现参数。列表默认每页 50 条、最大 100 条;明细优先使用查询返回的 ID,名称重复时返回候选。原有数据读写命令保持原合同。
14
+
15
+ 为具备本机命令执行、文件读写、Node.js 22.13+ 和 HTTPS 网络能力的当前 Agent 提供企业数据访问。安装本身不授予数据权限。在桌面登录后,登录后自动供同机插件使用。
16
+
17
+ 输入是明确的企业项目、店铺、资料来源与业务文档;插件验证在线登录、权限和结构,执行数据服务读写并回验结果。应用层 Skill 决定取数平台、业务口径和执行时间。支持配置与初始化数据库、管理店铺和商品,以及日经营指标、店铺销售账本、核算资料和商品分组的结构化读写;不能执行任意 SQL、删除数据或代替电商平台登录。
18
+
19
+ **安装提示词**
20
+
21
+ > 请安装山海 OMNI 插件 @lumyne/omni-cli,并为当前使用的 Agent 安装配套 Skill。
22
+
23
+ **更新提示词**
24
+
25
+ > 请将山海 OMNI 插件更新或迁移到 @lumyne/omni-cli,并同步当前使用的 Agent 的配套 Skill。
26
+
27
+ **使用提示词**
28
+
29
+ > 请使用山海 OMNI 插件,连接本机桌面应用,检查账号授权、店铺权限和数据库连接。
30
+
31
+ 安装与更新的完整合同见 [INSTALL.md](INSTALL.md)、[UPDATE.md](UPDATE.md)。具备所需能力的任意 Agent 可通过 generic 适配使用;具体平台与宿主测试证据单独记录,不能根据产品名推断兼容。
32
+
33
+ 项目编辑先用 `project edit-context` 获取当前版本和可编辑字段,再以 `project edit --project-id <id> --file <字段对象.json>` 或字段参数编辑。`--cover <图片路径>` 设置封面,`--dry-run` 仅预演,`--yes` 提交并回读验证;`--idempotency-key` 保留同一操作身份。名称、目标、负责人、平台、分组、日期/期限、置顶与封面由项目模块服务校验。任务、文档正文及项目身份是独立对象。封面支持 2 MB 内 PNG/JPEG/WebP。
34
+
35
+ 项目任务执行由 `omni-project` 配套 Skill 衔接:`execution context/get` 读取精确任务与执行,`prepare/start/attach/finish/fail` 登记执行及提交实际成果。各写命令需要 `--yes`,支持幂等编号;先使用命令帮助发现字段。`finish --wiki` 提交 UTF-8 正文并关联已上传成果,保存文档历史、完成任务并回读。Wiki 并发变化须合并当前正文后明确提交其版本。初始附件上限为 2 MB。`artifact get` 将指定任务附件下载到新路径,校验大小与 SHA,并保护已有文件。
36
+
37
+ 同机绑定提示词通过 `agent confirm` 将一次性挑战回传当前山海桌面;本机配置与账号凭据保留在包外。协议预填后的提示词由用户在 Agent 中发送,只有真实回传才显示连接已验证。
38
+
39
+ > 请用山海 OMNI 项目插件,完成指定任务,并将成果附件和结果正文归档到该任务的项目 Wiki。
package/UPDATE.md ADDED
@@ -0,0 +1,17 @@
1
+ # 当前 Agent 更新合同
2
+
3
+ > 请将山海 OMNI 插件迁移到 @lumyne/omni-cli,并同步当前使用的 Agent 的配套 Skill。
4
+
5
+ 从个人 scope 迁移时,先安装新包并核对实际入口的包名。用新包入口分别对现有 `omni-data` 和 `omni-project` 目标运行 `skill update`。迁移会校验原包的托管回执、保留宿主元数据并备份原目录。使用旧包的自动更新入口会继续查询旧发行渠道,因此本次迁移从新包入口发起。
6
+
7
+ 多 Skill 更新明确携带 `--name omni-project` 或 `--name omni-data`,仅更新该 Skill 的目标目录。未指定名称时保持默认 `omni-data`。`update install` 同步失败后,可使用返回的原 `candidate` 路径执行 `update recover --name <skill> --agent <current-agent> --target <absolute-skill-directory> --candidate <original-candidate> --yes --json`,从原候选继续同步;恢复也检查目标归属及本地编辑,不重新获取包。
8
+
9
+ 首先从实际配置解析当前 Agent 的绝对 Skill 目标。通过当前托管运行时的 skill status 检查归属与编辑,再用 update check 查询 stable latest。无注册表证据时保留版本,不把网络失败当作没有更新。
10
+
11
+ 执行托管运行时 update install --agent <current-agent> --target <absolute-skill-directory> --version <核实的精确版本> --yes --json。它获取固定候选包,在保留旧目录、备份和独立运行时的前提下,只同步指定目标。目标 .runtime 是新版本实际执行入口;npm 全局引导安装单独保留,不声称其版本已替换。后续从 receipt.runtimeEntry 执行业务。宿主自行刷新并验证发现。
12
+
13
+ 同版本更新会修复缺失资源;完整匹配时只读返回。已有本地编辑或非托管目标停止替换。包获取失败保留原安装;同步失败保留候选、旧目录及恢复信息,先检查实际状态再重试。备份留待用户授权清理。
14
+
15
+ 普通业务调用自动检测更新,默认每天最多一次、1.8 秒超时;离线保留当前版本,OMNI_UPDATE_CHECK=0 禁用检测。自动检测仅通知,不自动安装。按 npm 公开发行渠道核对可安装版本,历史升级以对应版本的验证结果为准。
16
+
17
+ 发现新版时,响应包含 update.notice、action=ask-user-before-update 和 confirmationRequired=true;Agent 必须将通知展示给用户,确认后才安装。无人值守任务保持当前版本,在结果中保留通知。缓存命中仍按当前运行时版本重新判断是否有新版,避免更新后重复提示旧通知。
package/bin/omni.mjs ADDED
@@ -0,0 +1,47 @@
1
+ #!/usr/bin/env node
2
+ import fs from 'node:fs';
3
+ import path from 'node:path';
4
+ import {business,OmniError} from '../lib/core.mjs';
5
+ import {manage} from '../lib/management.mjs';
6
+ import {projectRead} from '../lib/project-read.mjs';
7
+ import {marketRead} from '../lib/market.mjs';
8
+ import {projectArtifact} from '../lib/project-artifact.mjs';
9
+ import {projectExecution} from '../lib/project-execution.mjs';
10
+ import {confirmLocalAgent} from '../lib/local-agent.mjs';
11
+ import {projectEdit} from '../lib/project-edit.mjs';
12
+ import {initialize} from '../lib/database.mjs';
13
+ import {root,manifest,source,skillSource,status,install,checkUpdate,updateInstall,recoverInstall} from '../lib/lifecycle.mjs';
14
+ const capabilities=JSON.parse(fs.readFileSync(path.join(root,'capabilities.json'),'utf8'));
15
+ const contracts=Object.fromEntries(Object.entries(capabilities.commandContracts).map(([name,c])=>[name,Object.fromEntries(Object.entries(c.options).map(([k,s])=>[k.slice(2),s.type]))]));
16
+ const argv=process.argv.slice(2);let command=argv[0]||'help';let start=1;let group;if(['artifact','execution','agent','skill','update','data','database','shop','project','product','member','directory','node','task','template','document'].includes(command)){if(!argv[1]||argv[1].startsWith('--')){group=command;command='help';}else{command+=' '+argv[1];start=2;}}if(command==='--version')command='version';if(command==='--help')command='help';
17
+ try{
18
+ if(command==='market'){
19
+ start=argv.findIndex(arg=>arg.startsWith('--'));if(start<0)start=argv.length;
20
+ command=argv.slice(0,start).join(' ');
21
+ if(!Object.hasOwn(contracts,command)&&Object.keys(contracts).some(name=>name.startsWith(command+' '))){
22
+ group=command;command='help';
23
+ }
24
+ }
25
+ if(!Object.hasOwn(contracts,command))throw new OmniError('INVALID_COMMAND','不支持的命令;运行 omni help --json 查看合同');const options={};
26
+ for(let i=start;i<argv.length;i++){const key=argv[i].startsWith('--')?argv[i].slice(2):'';if(!['json','help',...Object.keys(contracts[command])].includes(key)||Object.hasOwn(options,key))throw new OmniError('INVALID_ARGUMENT','未知或重复的参数');const type=key==='json'||key==='help'?'boolean':contracts[command][key];if(type==='boolean')options[key]=true;else{const value=argv[++i];if(!value||value.startsWith('--'))throw new OmniError('INVALID_ARGUMENT','参数缺少值');options[key]=value;}}
27
+ let value;
28
+ if(command==='help'||command==='capabilities'||options.help)value={ok:true,...capabilities,...(group?{group,commandContracts:Object.fromEntries(Object.entries(capabilities.commandContracts).filter(([name])=>name.startsWith(group+' ')))}:{}),...(options.help?capabilities.commandContracts[command]:{})};
29
+ else if(command==='version')value={ok:true,package:manifest.name,version:manifest.version};
30
+ else if(command==='skill source'){const names=options.name?[options.name]:capabilities.skills;const items=names.map(name=>({ok:true,name,package:manifest.name,version:manifest.version,path:skillSource(name),runtimeEntry:path.join(root,'bin','omni.mjs')}));value={...capabilities,ok:true,...items[0],complete:true,items};}
31
+ else if(command==='skill status')value=status(options);
32
+ else if(command==='skill install'||command==='skill update')value=install(options);
33
+ else if(command==='update check')value={ok:true,update:await checkUpdate()};
34
+ else if(command==='update install')value=updateInstall(options);
35
+ else if(command==='update recover')value=recoverInstall(options);
36
+ else if(command==='doctor'){let account;try{account={ok:true,...await business('status',options)};}catch(error){account={ok:false,code:error.code||'CHECK_FAILED',error:error.message};}value={ok:account.ok,package:manifest.name,version:manifest.version,node:process.version,dependencies:{node:true,bundledSkill:fs.existsSync(path.join(source,'SKILL.md'))},account};if(!value.ok)process.exitCode=1;}
37
+ else if(command==='artifact get'){const update=await checkUpdate({automatic:true});value={ok:true,result:await projectArtifact(options),update};}
38
+ else if(command==='agent confirm'){const update=await checkUpdate({automatic:true});value={ok:true,result:await confirmLocalAgent(options),update};}
39
+ else if(command.startsWith('execution ')&&!['execution context','execution get'].includes(command)){const update=await checkUpdate({automatic:true});value={ok:true,result:await projectExecution(command,options),update};}
40
+ else if(command==='project edit'){const update=await checkUpdate({automatic:true});value={ok:true,result:await projectEdit(options),update};}
41
+ else if(capabilities.commandContracts[command]?.transport==='project-query-v1'){const update=await checkUpdate({automatic:true});value={ok:true,result:await projectRead(command,options),update};}
42
+ else if(capabilities.commandContracts[command]?.transport==='market-query-v1'){const update=await checkUpdate({automatic:true});value={ok:true,result:await marketRead(command,options),update};}
43
+ else if(command==='database initialize')value={ok:true,result:await initialize(options)};
44
+ else if(/^(database|shop|project|product|member) /.test(command)||['data read','data schema'].includes(command)){const update=await checkUpdate({automatic:true});value={ok:true,result:await manage(command,options),update};}
45
+ else {const update=await checkUpdate({automatic:true});value={ok:true,result:await business(command==='data write'?'write':command,options),update};}
46
+ console.log(JSON.stringify(value,null,options.json?0:2));
47
+ }catch(error){console.error(JSON.stringify({ok:false,code:error.code||'INTERNAL_ERROR',error:error instanceof OmniError?error.message:'操作失败,请检查输入和安装状态',...(error.details?{details:error.details}:{})}));process.exitCode=1;}