6.2 KiB
6.2 KiB
TZ 统一控制指令架构（讨论稿）
状态：Draft 0.1
范围：Clash/Mihomo、sing-box，以及待确认的 NinjaDesktop Lite 适配器
参考：/mnt/data_4t2/lht_self/sing-box-13/sb
第一版:下面的架构以假设使用.sh调用原二进制内核开发，
1. 目标
对用户只暴露一套稳定的 tz 指令。切换内核后，用户的日常命令、配置档名称、当前节点、路由模式、TUN、终端代理和系统代理等状态不变；由内核适配器负责生成配置并执行不同的底层指令。
用户 / shell
|
v
tz CLI（解析、状态、锁、事务、统一输出）
|
+-- clash adapter ------> mihomo/clash + Clash API
+-- sing-box adapter ---> sing-box + Clash API
`-- ninja adapter ------> 待探测
基本原则：
- 正式命令统一为
tz <对象> <动作> [参数]。 - 常用操作保留短命令，但短命令只是正式命令的别名。
- 用户状态由
tz保存，不能以某个内核的运行配置作为唯一状态源。 - 原始订阅/配置档只读保存；端口、DNS、TUN、绕过规则等系统配置在启动前覆盖合并。
- 所有内核差异只进入 adapter；主控制逻辑中不散落
if clash/if sing-box。 - 不支持的能力必须明确报错并返回非零退出码，不能假装执行成功。
- 修改内核、配置档、模式、TUN 等操作均先生成并校验配置，再应用；失败时保留旧的可运行状态。
2. 完整指令树
我想做的就是普通clash界面的终端操控指令
tz
快速启动
|-- status [--watch] # 显示整体状态，使用的内核，profile情况，节点，延迟等
|-- start # 启动，直接启动上次使用的profile，之后立刻执行status，做参考
|-- stop/end # 停止服务
|-- restart # 强制完整重启，等效于 stop 后 start
|-- reload # 重新生成配置并热加载，必要时自动重启
|
|-- list|-l [keyword] # 列出默认策略组节点并按延迟排序，快速切换节点
| [--group|-g <name>]
| [--fresh] # 这是什么?
|-- use <node> [--group <name>] # 快速选择节点
整体服务
|-- service 服务,选择节点(对应当前profile），开关等
| |-- status [--watch]
| |-- stop/end # 停止进程
| |-- restart [profile] # 重启多用来刷新 bypass.list
|
|-- core
| |-- list 查看有哪些内核，比如clash ，sing-box，mihomo。用*指出当前内核，选择可换
| |-- info [name] 当前内核的版本，二进制位置、导入时的url，是否正常启动等信息，或者是指定的
| |-- add <name> <url>不需要这个我后面会给出内核加入的标准格式，只做上传到网上，下载即可。如果名字重复，可以选择覆盖或者输入新的名称
| |-- remove <name> 删除对应内核
| |-- use <name> [--no-start] 切换内核，
| `-- update [name] 去查看url的内核版本，可选是否更新，否则提示无更新
|-- setting 这个是所有的core共用(配置一次就可以用了）?还是每个core有自己的单独配置(麻烦)
| |-- list # 列表展示 项目(key）+ 出来。可以选择设置哪一个
| |-- get <key> # 这个是只展示某个key的配置
| |-- set <key> <value> # 这个是单独配置
| `-- reset [key] # 恢复默认值
|
|-- key 这里展示setting可以打开哪些项目及其配置。下面指出的是默认配置
| |-- core ： mihomo # 等效于 core list，
| |-- sysproxy ： on/off # 系统proxy开启，注意需要识别bypass.list 配置ignore host
| |-- proxy ： on/off 终端～/.bashrc中的变量配置
| |-- http-proxy : 127.0.0.1:7892
| |-- socks-proxy : 127.0.0.1:7891
| |-- mixed-proxy : 127.0.0.1:7890
| |-- WebUI ： 127.0.0.1:9189
| |-- autostart : true/false
|-- env 环境配置
| |-- list # 展示出来，有哪些可以配置
| |-- sysproxy ： on/off # 系统proxy开启，注意需要识别bypass.list 配置ignore host
| |-- proxy ： on/off 终端～/.bashrc中的变量配置
| |-- http-proxy : 127.0.0.1:7892
| |-- socks-proxy : 127.0.0.1:7891
| |-- mixed-proxy : 127.0.0.1:7890
| |-- WebUI ： 127.0.0.1:9189
|-- profile # 由于内核不同profile也不同，所以注意区分。profile是对应core的
| |-- list # 列出订阅,*指出当前的订阅，注意profile与core对应
| |-- show [name]
| |-- add <name> <url-or-file> [--format auto|clash|sing-box] # 新增订阅，重名选择覆盖(remove后add）还是重命名
| |-- remove <name> # 删除
| |-- use <name> [--restart]
| |-- current
| |-- update [name]
| |-- update-all
| |-- check [name] [--core <name>]
| `-- source [name]
|
|-- group # profile对应的group可选择切换与node 节点应该在一起
| |-- list
| |-- current [group]
| `-- select <group> <node>
|-- node 节点
| |-- list [--group <name>] [--match <keyword>]
| |-- current [--group <name>]
| |-- select <node> [--group <name>]
| `-- test [--group <name>] [--match <keyword>]
| [--url <url>] [--timeout <ms>] [--select]
|
|-- mode # 这个放在这儿?为什么不放在setting
| |-- get
| `-- set rule|global|direct
|
|-- tun
| |-- status
| |-- on
| `-- off
|
|-- proxy
| |-- status
| |-- on
| |-- off
| |-- env
| |-- noenv
| |-- shell-init [bash|zsh|fish]
| |-- terminal on|off
| `-- system on|off
|
|-- rule
| `-- bypass
| |-- list
| |-- add <domain-or-cidr>
| |-- remove <domain-or-cidr>
| |-- import <file>
| |-- reset
| `-- apply
|
|-- connection
| |-- list
| |-- close <id>
| `-- close-all
|
|-- config
| |-- path
| |-- show [--effective|--source]
| |-- build [--core <name>] [--profile <name>]
| |-- check [--core <name>] [--profile <name>]
| `-- apply
|
|-- log # 日志没必要吧?
| `-- show [--lines <n>] [--follow] [--level <level>]
|
|-- diagnose # 这是什么?
| |-- run [--full]
| |-- ports
| |-- process [pid]
| |-- network direct|proxy|compare
| |-- dependencies
| |-- interfaces
| |-- dns
| |-- routes
| |-- api
| `-- config
|
|-- api status
|-- api get <path>
`-- completion generate bash|zsh|fish