@wwkit/opm 1.0.2 → 1.0.4

package/docs/opm.html

@@ -100,16 +100,20 @@
 <a class="menu-item" href="#" onclick="show('managers_composer');return false;">composer</a>
 <a class="menu-item" href="#" onclick="show('managers_config');return false;">config</a>
 <a class="menu-item" href="#" onclick="show('managers_dnf');return false;">dnf</a>
+<a class="menu-item" href="#" onclick="show('managers_git');return false;">git</a>
 <a class="menu-item" href="#" onclick="show('managers_node');return false;">node</a>
 <a class="menu-item" href="#" onclick="show('managers_npm');return false;">npm</a>
 <a class="menu-item" href="#" onclick="show('managers_nvm');return false;">nvm</a>
 <a class="menu-item" href="#" onclick="show('managers_php');return false;">php</a>
 <a class="menu-item" href="#" onclick="show('managers_phpenv');return false;">phpenv</a>
 <a class="menu-item" href="#" onclick="show('managers_pip');return false;">pip</a>
+<a class="menu-item" href="#" onclick="show('managers_proc');return false;">proc</a>
 <a class="menu-item" href="#" onclick="show('managers_python');return false;">python</a>
 <a class="menu-item" href="#" onclick="show('managers_uv');return false;">uv</a>
 <div class="menu-category">packages</div>
 <a class="menu-item" href="#" onclick="show('packages_opencode');return false;">opencode</a>
+<div class="menu-category">test</div>
+<a class="menu-item" href="#" onclick="show('test_linux_environment_test_report');return false;">linux-environment-test-report</a>
 </div>
 <div id="content">
 <div id="managers_apt" class="doc-content" style="display:block;"><h1>apt 命令对照表</h1>
@@ -318,6 +322,61 @@ opm dnf install htop
 opm dnf uninstall htop
 opm dnf upgrade htop
 opm dnf cache clean</code></pre></div>
+<div id="managers_git" class="doc-content" style="display:none;"><h1>git 命令对照</h1>
+<p><code>@wwkit/opm</code> 统一命令管理 git 安装与配置、diff 导出/导入。</p>
+<h2>命令对照</h2>
+<table><thead><tr><th>统一命令</th><th>原始命令</th><th>说明</th></tr></thead><tbody><tr><td><code>opm git version</code></td><td><code>git --version</code></td><td>查看已安装版本和路径</td></tr><tr><td><code>opm git install</code></td><td><code>dnf install -y git</code> / <code>apt-get install -y git</code></td><td>通过系统包管理器安装 git</td></tr><tr><td><code>opm git uninstall</code></td><td><code>dnf remove -y git</code> / <code>apt-get remove -y git</code></td><td>通过系统包管理器卸载 git</td></tr><tr><td><code>opm git upgrade</code></td><td><code>dnf upgrade -y git</code> / <code>apt-get install --only-upgrade -y git</code></td><td>通过系统包管理器升级 git</td></tr><tr><td><code>opm git init</code></td><td><code>git config --global ...</code></td><td>从 opm 配置一键初始化全局 git 配置（user/ssl/pull.rebase）</td></tr><tr><td><code>opm git config</code></td><td><code>git config --global --list</code></td><td>列出全局配置</td></tr><tr><td><code>opm git config &lt;key&gt;</code></td><td><code>git config --global --get &lt;key&gt;</code></td><td>查询单个配置项</td></tr><tr><td><code>opm git config &lt;key&gt; &lt;value&gt;</code></td><td><code>git config --global &lt;key&gt; &lt;value&gt;</code></td><td>设置配置项</td></tr><tr><td><code>opm git config --unset &lt;key&gt;</code></td><td><code>git config --global --unset &lt;key&gt;</code></td><td>删除配置项</td></tr><tr><td><code>opm git user</code></td><td><code>git config --global user.name</code> / <code>user.email</code></td><td>查看 user.name 和 user.email</td></tr><tr><td><code>opm git user -n &lt;name&gt; -e &lt;email&gt;</code></td><td><code>git config --global user.name &lt;name&gt;</code></td><td>设置用户信息</td></tr><tr><td><code>opm git export mark</code></td><td><code>git rev-list -n 1 opm-diff-base</code></td><td>查看当前基准标记</td></tr><tr><td><code>opm git export mark 0</code> | <code>HEAD</code></td><td><code>git tag opm-diff-base HEAD</code></td><td>标记当前 HEAD 为 diff 基准</td></tr><tr><td><code>opm git export mark &lt;commit&gt;</code></td><td><code>git tag opm-diff-base &lt;commit&gt;</code></td><td>标记指定 commit 为 diff 基准</td></tr><tr><td><code>opm git export mark --unset</code></td><td><code>git tag -d opm-diff-base</code></td><td>删除基准标记</td></tr><tr><td><code>opm git export</code></td><td><code>git diff &lt;mark&gt; HEAD</code></td><td>导出基准到 HEAD 的 diff（auto-commit 未提交变更）</td></tr><tr><td><code>opm git export -f &lt;n&gt;</code></td><td><code>git diff HEAD~n HEAD</code></td><td>覆盖基准为 HEAD~n</td></tr><tr><td><code>opm git export -f &lt;ref&gt;</code></td><td><code>git diff &lt;ref&gt; HEAD</code></td><td>覆盖基准为任意 ref</td></tr><tr><td><code>opm git import &lt;file&gt;</code></td><td><code>git apply --reject &lt;file&gt;</code></td><td>导入 diff 文件到工作树</td></tr></tbody></table>
+<h2>选项</h2>
+<table><thead><tr><th>选项</th><th>说明</th></tr></thead><tbody><tr><td><code>-d, --dir &lt;dir&gt;</code></td><td>git 仓库目录（默认 cwd）</td></tr><tr><td><code>-p, --proxy &lt;url&gt;</code></td><td>install/upgrade 时代理</td></tr><tr><td><code>--scope &lt;global|local|system&gt;</code></td><td>config 作用域（默认 global）</td></tr><tr><td><code>-n, --name &lt;name&gt;</code></td><td>user: 用户名；export: diff 文件名</td></tr><tr><td><code>-e, --email &lt;email&gt;</code></td><td>user: 用户邮箱</td></tr><tr><td><code>-o, --output &lt;file&gt;</code></td><td>export: 输出文件路径</td></tr><tr><td><code>-f, --from &lt;n&gt;|&lt;ref&gt;</code></td><td>export: 覆盖基准 ref（数字=HEAD~n，字符串=ref）</td></tr><tr><td><code>-f, --force</code></td><td>init: 强制覆盖已有配置</td></tr><tr><td><code>--unset &lt;key&gt;</code></td><td>config: 删除配置项</td></tr><tr><td><code>-h, --help</code></td><td>显示帮助</td></tr></tbody></table>
+<h2>配置预设</h2>
+<p>opm 配置 <code>git</code> 段（<code>opm git init</code> 使用）：</p>
+<pre><code class="lang-json5">{
+  git: {
+    sslVerify: false,      // http.sslVerify
+    user: { name: "", email: "" },  // user.name / user.email
+    pullRebase: false,     // pull.rebase
+  },
+}</code></pre>
+<h2>diff 导出/导入流程</h2>
+<p>1. <strong>修改前</strong>：<code>opm git export mark 0</code> — 标记当前 HEAD 为基准</p>
+<p>2. <strong>修改后</strong>：<code>opm git export</code> — 自动 commit 未提交变更，导出基准到 HEAD 的 diff</p>
+<p>3. <strong>传输</strong>：将 diff 文件传到目标机器</p>
+<p>4. <strong>导入</strong>：<code>opm git import &lt;file&gt;</code> — 在目标仓库应用 diff</p>
+<p>默认输出文件：<code>&lt;workdir&gt;/.webwork/git/changes-&lt;from-short&gt;-to-&lt;to-short&gt;.diff</code></p>
+<h2>示例</h2>
+<pre><code class="lang-bash"># 安装/升级 git
+opm git version                     # 查看已安装版本
+opm git install                     # 安装 git
+opm git upgrade                     # 升级 git
+
+# 初始化配置
+opm git init                        # 从 opm 配置初始化全局 git 配置
+opm git init -f                     # 强制覆盖已有配置
+
+# 配置管理
+opm git config                       # 列出全局配置
+opm git config pull.rebase true      # 设置 pull.rebase
+opm git config --unset pull.rebase   # 删除配置项
+opm git config --scope local         # 操作本地配置
+
+# 用户信息
+opm git user                         # 查看当前用户信息
+opm git user -n "John" -e "john@example.com"  # 设置用户信息
+
+# diff 导出
+opm git export mark                  # 查看当前基准
+opm git export mark 0                # 标记当前 HEAD 为基准
+opm git export mark HEAD             # 标记当前 HEAD 为基准
+opm git export mark 3af967b         # 标记指定 commit 为基准
+opm git export mark --unset        # 删除基准
+opm git export                       # 导出 diff（基准 -&gt; HEAD）
+opm git export -f 2                 # 导出 diff（HEAD~2 -&gt; HEAD）
+opm git export -n feature          # 导出为 feature.diff
+opm git export -d /path/to/repo    # 指定仓库目录
+
+# diff 导入
+opm git import changes-abc-to-def.diff  # 导入 diff 文件
+opm git import file.diff -d /repo       # 导入到指定仓库</code></pre></div>
 <div id="managers_node" class="doc-content" style="display:none;"><h1>node 命令对照表</h1>
 <p><code>@wwkit/opm</code> 统一命令通过 nvm 管理 Node.js 版本。</p>
 <h2>命令对照</h2>
@@ -502,6 +561,43 @@ opm pip cache clean
 opm pip help</code></pre>
 <h2>技术说明</h2>
 <ul><li><strong>源查询</strong>：优先使用 PyPI JSON API（<code>/pypi/&lt;name&gt;/json</code>），当镜像不支持 JSON API 时自动回退到 simple index HTML 解析</li><li><strong>版本排序</strong>：simple index 方式提取的版本使用内置版本比较算法排序，自动排除 dev/rc/alpha/beta 等预发布版本作为 latest</li></ul></div>
+<div id="managers_proc" class="doc-content" style="display:none;"><h1>proc 命令对照</h1>
+<p><code>@wwkit/opm</code> 统一命令管理系统信息与进程管理。</p>
+<h2>命令对照</h2>
+<table><thead><tr><th>统一命令</th><th>原始命令</th><th>说明</th></tr></thead><tbody><tr><td><code>opm proc info</code></td><td>—</td><td>显示系统信息（OS/CPU/内存/磁盘/运行时间）</td></tr><tr><td><code>opm proc list</code></td><td><code>ps aux --sort=-%mem</code></td><td>列出按内存排序的 Top N 进程（默认 10）</td></tr><tr><td><code>opm proc list -b cpu</code></td><td><code>ps aux --sort=-%cpu</code></td><td>列出按 CPU 排序的进程</td></tr><tr><td><code>opm proc search -n &lt;name&gt;</code></td><td><code>ps aux | grep &lt;name&gt;</code></td><td>按名称模糊搜索进程</td></tr><tr><td><code>opm proc search -n &lt;name&gt; --exact</code></td><td>—</td><td>精确匹配进程名</td></tr><tr><td><code>opm proc search -n &lt;name&gt; -p &lt;port&gt;</code></td><td>—</td><td>按名称 + 端口搜索</td></tr><tr><td><code>opm proc port</code></td><td><code>netstat -tlnp</code></td><td>列出所有监听端口及对应进程</td></tr><tr><td><code>opm proc port -p &lt;port&gt;</code></td><td><code>netstat -tlnp | grep &lt;port&gt;</code></td><td>查询指定端口</td></tr><tr><td><code>opm proc kill -i &lt;pid&gt;</code></td><td><code>kill &lt;pid&gt;</code></td><td>按 PID 终止进程（SIGTERM）</td></tr><tr><td><code>opm proc kill -p &lt;port&gt;</code></td><td>—</td><td>按端口终止进程</td></tr><tr><td><code>opm proc kill -n &lt;name&gt;</code></td><td><code>pkill &lt;name&gt;</code></td><td>按名称终止进程</td></tr><tr><td><code>opm proc kill -i &lt;pid&gt; -f</code></td><td><code>kill -9 &lt;pid&gt;</code></td><td>强制终止（SIGKILL）</td></tr><tr><td><code>opm proc tree</code></td><td><code>pstree</code></td><td>显示进程树（所有顶层进程）</td></tr><tr><td><code>opm proc tree &lt;pid&gt;</code></td><td><code>pstree -p &lt;pid&gt;</code></td><td>显示指定 PID 的进程树</td></tr><tr><td><code>opm proc detail &lt;pid&gt;</code></td><td><code>ps -p &lt;pid&gt; -o ...</code></td><td>显示指定 PID 的详细信息</td></tr></tbody></table>
+<h2>选项</h2>
+<table><thead><tr><th>选项</th><th>说明</th></tr></thead><tbody><tr><td><code>-n, --count &lt;n&gt;</code></td><td>list: 进程数量（默认 10）</td></tr><tr><td><code>-n, --name &lt;name&gt;</code></td><td>search/kill: 进程名称模式（默认模糊匹配）</td></tr><tr><td><code>-b, --by &lt;mem|cpu&gt;</code></td><td>list: 排序方式（默认 mem）</td></tr><tr><td><code>-p, --port &lt;port&gt;</code></td><td>search/kill/port: 端口号</td></tr><tr><td><code>-i, --id &lt;pid&gt;</code></td><td>kill: 进程 ID</td></tr><tr><td><code>--exact</code></td><td>search: 精确匹配（默认模糊）</td></tr><tr><td><code>-f, --force</code></td><td>kill: 使用 SIGKILL 替代 SIGTERM</td></tr><tr><td><code>-y, --yes</code></td><td>kill: 跳过确认提示</td></tr><tr><td><code>-h, --help</code></td><td>显示帮助</td></tr></tbody></table>
+<h2>实现说明</h2>
+<ul><li><code>src/managers/proc.js</code> — systeminformation 封装 + netstat 端口映射 + 进程操作</li><li><code>src/cli/groups/proc.js</code> — ProcGroup 命令组路由</li><li>端口映射优先使用 <code>systeminformation.networkConnections()</code>，回退 <code>netstat -tlnp</code></li><li>内存值从 KB 转换为 MB（<code>memRss / 1024</code>）</li></ul>
+<h2>示例</h2>
+<pre><code class="lang-bash"># 系统信息
+opm proc info                        # OS/CPU/内存/磁盘/运行时间
+
+# 进程列表
+opm proc list                         # Top 10 进程（按内存）
+opm proc list -n 20                   # Top 20 进程
+opm proc list -b cpu                  # 按 CPU 排序
+
+# 搜索
+opm proc search -n node               # 模糊搜索 node 进程
+opm proc search -n node --exact       # 精确匹配
+opm proc search -n node -p 3000       # 搜索 node 进程 + 端口 3000
+
+# 端口
+opm proc port                         # 所有监听端口
+opm proc port -p 8080                 # 查询 8080 端口
+
+# 终止
+opm proc kill -i 1234                 # 终止 PID 1234
+opm proc kill -p 8080 -f -y           # 强制终止 8080 端口的进程
+opm proc kill -n node -y              # 终止所有 node 进程
+
+# 进程树
+opm proc tree                         # 所有顶层进程树
+opm proc tree 1234                    # PID 1234 的进程树
+
+# 详情
+opm proc detail 1234                  # PID 1234 的详细信息</code></pre></div>
 <div id="managers_python" class="doc-content" style="display:none;"><h1>python 命令对照表</h1>
 <p><code>@wwkit/opm</code> 统一命令通过 uv 管理 Python 版本。</p>
 <h2>命令对照</h2>
@@ -527,10 +623,13 @@ opm python upgrade</code></pre></div>
 <p><code>@wwkit/opm</code> 统一命令管理 uv 自身（安装/升级/卸载）。</p>
 <p>uv 是 Astral 出品的快速 Python 包/版本管理器（Rust 实现），替代 pyenv + pip。</p>
 <h2>命令对照</h2>
-<table><thead><tr><th>统一命令</th><th>原始命令</th><th>说明</th></tr></thead><tbody><tr><td><code>opm uv version</code></td><td><code>uv --version</code></td><td>查看 uv 版本</td></tr><tr><td><code>opm uv install</code></td><td><code>curl -LsSf https://astral.sh/uv/install.sh | sh</code></td><td>安装 uv</td></tr><tr><td><code>opm uv upgrade</code></td><td><code>uv self update</code></td><td>更新 uv</td></tr><tr><td><code>opm uv uninstall</code></td><td><code>rm ~/.local/bin/uv</code> + <code>rm -rf ~/.local/share/uv</code></td><td>卸载 uv</td></tr><tr><td><code>opm uv dir</code></td><td>返回 uv 安装目录</td></tr></tbody></table>
-<blockquote>uv 无镜像源，故无 registry action。</blockquote>
+<table><thead><tr><th>统一命令</th><th>原始命令</th><th>说明</th></tr></thead><tbody><tr><td><code>opm uv version</code></td><td><code>uv --version</code></td><td>查看 uv 版本</td></tr><tr><td><code>opm uv registry</code></td><td>读 <code>~/.config/opm/config.json5</code> 的 <code>uv.registry.active</code></td><td>查询激活的安装脚本 URL</td></tr><tr><td><code>opm uv registry set &lt;url|preset&gt;</code></td><td>写 <code>~/.config/opm/config.json5</code> 的 <code>uv.registry.active</code></td><td>设置激活安装脚本 URL（支持预设名）</td></tr><tr><td><code>opm uv registry presets</code></td><td>—</td><td>列出可用镜像预设</td></tr><tr><td><code>opm uv install</code></td><td><code>curl -LsSf &lt;active&gt; | sh</code></td><td>安装 uv（脚本 URL 来自 <code>uv.registry.active</code>）</td></tr><tr><td><code>opm uv upgrade</code></td><td><code>uv self update</code></td><td>更新 uv</td></tr><tr><td><code>opm uv uninstall</code></td><td><code>rm ~/.local/bin/uv</code> + <code>rm -rf ~/.local/share/uv</code></td><td>卸载 uv</td></tr><tr><td><code>opm uv dir</code></td><td>返回 uv 安装目录</td></tr></tbody></table>
+<blockquote>安装脚本 URL 通过 <code>uv.registry.active</code> 配置（<code>opm uv registry set &lt;url&gt;</code>）；Windows 仍使用官方 <code>install.ps1</code>。</blockquote>
 <h2>示例</h2>
 <pre><code class="lang-bash">opm uv version
+opm uv registry
+opm uv registry presets
+opm uv registry set official
 opm uv install
 opm uv upgrade
 opm uv dir
@@ -538,18 +637,62 @@ opm uv uninstall</code></pre></div>
 <div id="packages_opencode" class="doc-content" style="display:none;"><h1>opencode 命令对照</h1>
 <p><code>@wwkit/opm</code> 统一命令管理 opencode 运维操作。</p>
 <h2>命令对照</h2>
-<table><thead><tr><th>统一命令</th><th>原始命令</th><th>说明</th></tr></thead><tbody><tr><td><code>opm opencode clear</code></td><td>—</td><td>清理 opencode 会话并 VACUUM 压缩数据库</td></tr><tr><td><code>opm opencode clear -d, --days &lt;n&gt;</code></td><td>—</td><td>保留最近 n 天（对齐本地零点，含今天；默认 <code>-d 1</code>）</td></tr><tr><td><code>opm opencode clear -h, --hours &lt;n&gt;</code></td><td>—</td><td>保留最近 n 小时（滚动窗口）</td></tr><tr><td><code>opm opencode clear -n, --num &lt;n&gt;</code></td><td>—</td><td>保留最新 n 个会话</td></tr><tr><td><code>opm opencode clear --dry-run</code></td><td>—</td><td>仅预览，不修改任何数据</td></tr><tr><td><code>opm opencode clear -y</code></td><td>—</td><td>跳过确认提示</td></tr><tr><td><code>opm opencode config</code></td><td>—</td><td>显示 opencode 配置文件内容（优先 <code>opencode.jsonc</code>，其次 <code>opencode.json</code>）</td></tr><tr><td><code>opm opencode version</code></td><td><code>npm list -g opencode-ai</code></td><td>已安装版本</td></tr><tr><td><code>opm opencode install</code></td><td><code>npm install -g opencode-ai</code></td><td>安装（使用 opm npm 镜像 + proxy）</td></tr><tr><td><code>opm opencode uninstall</code></td><td><code>npm uninstall -g opencode-ai</code></td><td>卸载</td></tr><tr><td><code>opm opencode upgrade</code></td><td><code>npm install -g opencode-ai@latest</code></td><td>升级（使用 opm npm 镜像 + proxy）</td></tr><tr><td><code>opm opencode dir</code></td><td>—</td><td>显示 data/db/log/config 路径</td></tr></tbody></table>
+<table><thead><tr><th>统一命令</th><th>原始命令</th><th>说明</th></tr></thead><tbody><tr><td><code>opm opencode version</code></td><td><code>npm list -g opencode-ai</code></td><td>已安装版本</td></tr><tr><td><code>opm opencode installed</code></td><td>—</td><td>检查是否已安装</td></tr><tr><td><code>opm opencode install</code></td><td><code>npm install -g opencode-ai</code></td><td>安装（使用 opm npm 镜像 + proxy）</td></tr><tr><td><code>opm opencode uninstall</code></td><td><code>npm uninstall -g opencode-ai</code></td><td>卸载</td></tr><tr><td><code>opm opencode upgrade</code></td><td><code>npm install -g opencode-ai@latest</code></td><td>升级（使用 opm npm 镜像 + proxy）</td></tr><tr><td><code>opm opencode config</code></td><td>—</td><td>显示 opencode 配置文件内容</td></tr><tr><td><code>opm opencode dir</code></td><td>—</td><td>显示 data/db/log/config 路径</td></tr><tr><td><code>opm opencode env</code></td><td>—</td><td>显示 harness 环境变量（OPENCODE_CONFIG_DIR / OPENCODE_CONFIG_CONTENT）</td></tr><tr><td><code>opm opencode open [-d &lt;dir&gt;]</code></td><td><code>opencode</code></td><td>在指定目录启动 TUI（默认 cwd），自动注入环境变量</td></tr><tr><td><code>opm opencode clear</code></td><td>—</td><td>清理 opencode 会话并 VACUUM 压缩数据库</td></tr><tr><td><code>opm opencode clear -d, --days &lt;n&gt;</code></td><td>—</td><td>保留最近 n 天（对齐本地零点，含今天；默认 <code>-d 1</code>）</td></tr><tr><td><code>opm opencode clear -h, --hours &lt;n&gt;</code></td><td>—</td><td>保留最近 n 小时（滚动窗口）</td></tr><tr><td><code>opm opencode clear -n, --num &lt;n&gt;</code></td><td>—</td><td>保留最新 n 个会话</td></tr><tr><td><code>opm opencode clear --dry-run</code></td><td>—</td><td>仅预览，不修改任何数据</td></tr><tr><td><code>opm opencode clear -y</code></td><td>—</td><td>跳过确认提示</td></tr><tr><td><code>opm opencode clear --backup</code></td><td>—</td><td>删除前备份数据库</td></tr><tr><td><code>opm opencode clear --db &lt;path&gt;</code></td><td>—</td><td>覆盖 opencode 数据库路径</td></tr></tbody></table>
 <blockquote><code>--days</code> / <code>--hours</code> / <code>--num</code> 三选一，互斥。</blockquote>
+<h2>选项</h2>
+<table><thead><tr><th>选项</th><th>说明</th></tr></thead><tbody><tr><td><code>-p, --proxy &lt;url&gt;</code></td><td>install/upgrade 时代理（覆盖配置 <code>proxy.active</code>）</td></tr><tr><td><code>-d, --dir &lt;dir&gt;</code></td><td>open 的工作目录（默认 cwd）</td></tr><tr><td><code>-h, --help</code></td><td>显示帮助</td></tr></tbody></table>
+<h2>环境变量</h2>
+<p><code>opm opencode env</code> 显示注入 opencode 的环境变量，来源为 opm 配置 <code>opencode.env</code> 段 + 系统环境变量（系统环境变量优先）：</p>
+<table><thead><tr><th>变量</th><th>默认值</th><th>说明</th></tr></thead><tbody><tr><td><code>OPENCODE_CONFIG_DIR</code></td><td><code>{pkg:@wwkit/harness}</code></td><td>opencode 配置目录（动态解析为已安装的 @wwkit/harness 包目录）</td></tr><tr><td><code>OPENCODE_CONFIG_CONTENT</code></td><td><code>""</code></td><td>opencode 配置内容注入（非空时覆盖配置文件）</td></tr></tbody></table>
 <h2>实现说明</h2>
-<ul><li><code>src/harnesses/opencode/db.js</code> — 数据目录 / DB / 日志路径</li><li><code>src/harnesses/opencode/sqlite.js</code> — 跨平台 SQLite 驱动（Node &gt;= 22.5 内置 <code>node:sqlite</code>，否则回退 sqlite3 CLI）</li><li><code>src/harnesses/opencode/clear.js</code> — 清理流程（保留策略计算 + 删除 + VACUUM）</li><li><code>src/harnesses/base.js</code> — <code>HarnessGroup</code> 统一命令组基类（version/install/uninstall/upgrade/config/clear/dir）</li></ul>
+<ul><li><code>src/harnesses/opencode/db.js</code> — 数据目录 / DB / 日志路径</li><li><code>src/harnesses/opencode/sqlite.js</code> — 跨平台 SQLite 驱动（Node &gt;= 22.5 内置 <code>node:sqlite</code>，否则回退 sqlite3 CLI）</li><li><code>src/harnesses/opencode/clear.js</code> — 清理流程（保留策略计算 + 删除 + VACUUM）</li><li><code>src/harnesses/base.js</code> — <code>HarnessGroup</code> 统一命令组基类（version/installed/install/uninstall/upgrade/config/clear/dir/env/open）</li></ul>
 <h2>示例</h2>
-<pre><code class="lang-bash">opm opencode clear                    # 只保留今天创建的会话
-opm opencode clear -d 7               # 保留最近 7 天会话
-opm opencode clear -h 24              # 保留最近 24 小时会话
-opm opencode clear -n 10              # 保留最新 10 个会话
-opm opencode clear --dry-run          # 仅预览
-opm opencode clear -y                 # 跳过确认直接执行
-opm opencode config                   # 显示 opencode 配置文件内容</code></pre></div>
+<pre><code class="lang-bash">opm opencode version                 # 查看已安装版本
+opm opencode installed               # 检查是否已安装
+opm opencode install                 # 安装 opencode
+opm opencode upgrade                 # 升级到最新
+opm opencode config                  # 显示配置文件内容
+opm opencode dir                     # 查看数据/日志/DB路径
+opm opencode env                     # 查看环境变量
+opm opencode open                    # 在当前目录启动 TUI
+opm opencode open -d /path/to/project # 在指定目录启动 TUI
+opm opencode clear                   # 只保留今天创建的会话
+opm opencode clear -d 7              # 保留最近 7 天会话
+opm opencode clear -h 24             # 保留最近 24 小时会话
+opm opencode clear -n 10             # 保留最新 10 个会话
+opm opencode clear --dry-run         # 仅预览
+opm opencode clear -y                # 跳过确认直接执行
+opm opencode clear --backup         # 删除前备份数据库</code></pre></div>
+<div id="test_linux_environment_test_report" class="doc-content" style="display:none;"><h1>opm 真实环境测试报告</h1>
+<ul><li><strong>日期</strong>: 2026-09-14</li><li><strong>环境</strong>: Linux (openEuler, x86_64)</li><li><strong>Node.js</strong>: v22.21.1 (恢复后)</li><li><strong>工具</strong>: curl 7.79.1, wget, git, dnf 4.10.0, pip 21.3.1</li><li><strong>代理</strong>: http://proxyhm-hk.security.huawei.com:8080 (认证: {env:PROXY_USER}:{env:PROXY_PASSWORD})</li><li><strong>网络</strong>: 需通过华为代理访问外网</li></ul>
+<h2>一、单元测试</h2>
+<pre><code class="lang-">node --test tests/
+# tests 228, pass 225, fail 3</code></pre>
+<ul><li><strong>通过</strong>: 225</li><li><strong>失败</strong>: 3（均为 pip 网络测试，依赖 pypi.org 直连，非本次改动引入）</li><li><strong>修复</strong>: cft.test.js 配置 active 不匹配（<code>npmmirror</code> → 动态断言）</li></ul>
+<h2>二、真实环境命令测试</h2>
+<h3>已安装命令（9 个）</h3>
+<table><thead><tr><th>命令</th><th>动作</th><th>结果</th><th>备注</th></tr></thead><tbody><tr><td><code>opm npm</code></td><td>version</td><td>PASS</td><td>10.8.2</td></tr><tr><td>registry</td><td>PASS</td><td>npmmirror</td></tr><tr><td>installed</td><td>PASS</td></tr><tr><td>search</td><td>PASS</td><td>通过代理查询 axios</td></tr><tr><td>info</td><td>PASS</td></tr><tr><td>list</td><td>PASS</td></tr><tr><td>outdated -g</td><td>PASS</td></tr><tr><td>registry set</td><td>PASS</td><td>切换 huawei 后恢复</td></tr><tr><td><code>opm pip</code></td><td>version</td><td>PASS</td><td>21.3.1</td></tr><tr><td>registry</td><td>PASS</td><td>tsinghua</td></tr><tr><td>search</td><td>PASS</td><td>通过代理查询 requests</td></tr><tr><td>list</td><td>PASS</td></tr><tr><td>registry set</td><td>PASS</td></tr><tr><td><code>opm dnf</code></td><td>version</td><td>PASS</td><td>4.10.0</td></tr><tr><td>registry</td><td>PASS</td><td>hce</td></tr><tr><td>search</td><td>PASS</td><td>curl 返回 exists:false（HCE 源无此包，预期行为）</td></tr><tr><td><code>opm node</code></td><td>version</td><td>PASS</td><td>20.20.2</td></tr><tr><td>current</td><td>PASS</td><td>v20.20.2</td></tr><tr><td>list</td><td>PASS</td></tr><tr><td>versions</td><td>PASS</td><td>通过代理获取远程版本列表</td></tr><tr><td>use</td><td>PASS</td></tr><tr><td><code>opm nvm</code></td><td>version</td><td>PASS</td><td>0.40.4</td></tr><tr><td>installed</td><td>PASS</td></tr><tr><td>registry</td><td>PASS</td><td>huawei</td></tr><tr><td>dir</td><td>PASS</td><td>/root/.nvm</td></tr><tr><td>upgrade</td><td><strong>FAIL</strong></td><td><code>/root/.nvm</code> 非 git 仓库（git clone 安装的才支持 upgrade）</td></tr><tr><td>uninstall</td><td><strong>WARN</strong></td><td>实际执行了卸载，删除了 <code>/root/.nvm</code>，导致 node 不可用</td></tr><tr><td><code>opm config</code></td><td>(full)</td><td>PASS</td></tr><tr><td>proxy</td><td>PASS</td><td>显示 huawei 代理 + active</td></tr><tr><td><code>opm ping</code></td><td>host</td><td>PASS</td></tr><tr><td>proxy</td><td>PASS</td><td>通过代理访问 npm registry 验证可用性</td></tr><tr><td>registry</td><td>PASS</td><td>16/16 全部 reachable:true</td></tr><tr><td>source</td><td>PASS</td><td>打印 curl 示例命令</td></tr><tr><td><code>opm cft</code></td><td>version</td><td>PASS</td><td>未安装，输出空</td></tr><tr><td>dir</td><td>PASS</td></tr><tr><td>list</td><td>PASS</td></tr><tr><td>status</td><td>PASS</td></tr><tr><td>versions</td><td><strong>FAIL</strong></td><td>deepbluenet 镜像无 versions JSON 文件</td></tr><tr><td><code>opm ensure</code></td><td>node</td><td>PASS</td><td>已安装，satisfied:true</td></tr><tr><td>help</td><td>PASS</td></tr></tbody></table>
+<h3>未安装命令（7 个）</h3>
+<table><thead><tr><th>命令</th><th>动作</th><th>结果</th><th>备注</th></tr></thead><tbody><tr><td><code>opm uv</code></td><td>version</td><td>PASS</td><td>未安装，输出空</td></tr><tr><td>installed</td><td>PASS</td><td>false</td></tr><tr><td>registry</td><td>PASS</td><td>ghproxy</td></tr><tr><td>install</td><td><strong>FAIL</strong></td><td>超时——curl 未走代理，无法访问 ghproxy.com</td></tr><tr><td><code>opm python</code></td><td>version</td><td>PASS</td><td>3.9.9（系统 python）</td></tr><tr><td>current</td><td>PASS</td></tr><tr><td>versions</td><td><strong>FAIL</strong></td><td>uv 未安装，预期行为</td></tr><tr><td><code>opm phpenv</code></td><td>version</td><td>PASS</td><td>未安装，输出空</td></tr><tr><td>installed</td><td>PASS</td><td>false</td></tr><tr><td><code>opm php</code></td><td>version</td><td>PASS</td><td>未安装，输出空</td></tr><tr><td>versions</td><td><strong>FAIL</strong></td><td>phpenv 未安装，预期行为</td></tr><tr><td><code>opm composer</code></td><td>version</td><td>PASS</td><td>未安装，输出空</td></tr><tr><td>registry</td><td>PASS</td><td>aliyun</td></tr><tr><td><code>opm bun</code></td><td>version</td><td>PASS</td><td>未安装，输出空</td></tr><tr><td>registry</td><td>PASS</td><td>npmmirror</td></tr><tr><td><code>opm docker</code></td><td>version</td><td>PASS</td><td>未安装，输出空</td></tr><tr><td>installed</td><td>PASS</td><td>false</td></tr><tr><td>registry</td><td>PASS</td><td>huawei</td></tr><tr><td>status</td><td>PASS</td><td>installed:false</td></tr><tr><td>dir</td><td>PASS</td></tr><tr><td>install</td><td><strong>SKIP</strong></td><td>需要网络下载便捷脚本，未测（避免修改系统）</td></tr></tbody></table>
+<h2>三、发现的问题</h2>
+<h3>BUG-1: nvm uninstall 实际执行卸载（严重）</h3>
+<ul><li><strong>现象</strong>: <code>opm nvm uninstall</code> 实际删除了 <code>/root/.nvm</code> 目录，导致 node 不可用</li><li><strong>原因</strong>: <code>ToolManagerGroup._uninstall()</code> 直接调用 <code>cfg.uninstall()</code>，无确认提示</li><li><strong>影响</strong>: 测试环境被破坏，node/nvm 需手动恢复</li><li><strong>建议</strong>: 危险操作（uninstall）应加确认提示，或至少 <code>--force</code> 标志</li></ul>
+<h3>BUG-2: nvm upgrade 对非 git 安装失败</h3>
+<ul><li><strong>现象</strong>: <code>fatal: not a git repository</code></li><li><strong>原因</strong>: nvm 通过非 git 方式安装时，<code>/root/.nvm</code> 不是 git 仓库，<code>git pull</code> 失败</li><li><strong>建议</strong>: 检测 <code>.git</code> 目录存在性，非 git 安装时提示重新 install</li></ul>
+<h3>BUG-3: uv install 不走代理</h3>
+<ul><li><strong>现象</strong>: <code>opm uv install</code> 超时</li><li><strong>原因</strong>: <code>installUv()</code> 中 <code>curl -LsSf "${installUrl}" | sh</code> 未传 <code>-x proxy</code></li><li><strong>影响</strong>: 所有 ToolManagerGroup 的 install 命令（uv/docker/homebrew）在需代理环境均不可用</li><li><strong>建议</strong>: <code>ToolManagerGroup._install()</code> 应将 proxy 传递给 <code>cfg.install(proxy)</code></li></ul>
+<h3>BUG-4: cft versions 镜像不可用</h3>
+<ul><li><strong>现象</strong>: 无法获取版本列表</li><li><strong>原因</strong>: deepbluenet 镜像无 <code>known-good-versions-with-downloads.json</code> 文件</li><li><strong>影响</strong>: <code>opm cft versions</code> 和 <code>opm cft install</code> 不可用</li><li><strong>建议</strong>: 切换回 npmmirror 或提供可用的 versions JSON 镜像</li></ul>
+<h3>ISSUE-1: nvm 华为镜像 git clone 失败</h3>
+<ul><li><strong>现象</strong>: <code>https://mirrors.huaweicloud.com/nvm.git</code> 返回 <code>could not determine hash algorithm</code></li><li><strong>原因</strong>: 华为镜像可能不提供 nvm 的 git 仓库</li><li><strong>影响</strong>: <code>opm nvm install</code> 使用此 URL 会失败</li><li><strong>建议</strong>: 改用 gitee 镜像或官方 GitHub URL</li></ul>
+<h2>四、测试统计</h2>
+<table><thead><tr><th>分类</th><th>数量</th></tr></thead><tbody><tr><td>总测试命令</td><td>16</td></tr><tr><td>PASS</td><td>12</td></tr><tr><td>FAIL（bug）</td><td>3（nvm upgrade, uv install, cft versions）</td></tr><tr><td>WARN</td><td>1（nvm uninstall 无确认）</td></tr><tr><td>SKIP</td><td>1（docker install）</td></tr><tr><td>预期 FAIL（依赖未安装）</td><td>2（python/php versions）</td></tr></tbody></table>
+<h2>五、修复建议优先级</h2>
+<p>1. <strong>P0</strong>: nvm uninstall 加确认提示（避免误删）</p>
+<p>2. <strong>P0</strong>: ToolManagerGroup install 命令传 proxy</p>
+<p>3. <strong>P1</strong>: nvm upgrade 检测 git 仓库</p>
+<p>4. <strong>P1</strong>: nvm 华为镜像 URL 修正</p>
+<p>5. <strong>P2</strong>: cft versions 镜像可用性</p></div>
 </div>
 </div>
 <script>

package/docs/packages/opencode.md

@@ -6,36 +6,67 @@
 
 | 统一命令 | 原始命令 | 说明 |
 |---------|---------|------|
+| `opm opencode version` | `npm list -g opencode-ai` | 已安装版本 |
+| `opm opencode installed` | — | 检查是否已安装 |
+| `opm opencode install` | `npm install -g opencode-ai` | 安装（使用 opm npm 镜像 + proxy） |
+| `opm opencode uninstall` | `npm uninstall -g opencode-ai` | 卸载 |
+| `opm opencode upgrade` | `npm install -g opencode-ai@latest` | 升级（使用 opm npm 镜像 + proxy） |
+| `opm opencode config` | — | 显示 opencode 配置文件内容 |
+| `opm opencode dir` | — | 显示 data/db/log/config 路径 |
+| `opm opencode env` | — | 显示 harness 环境变量（OPENCODE_CONFIG_DIR / OPENCODE_CONFIG_CONTENT） |
+| `opm opencode open [-d <dir>]` | `opencode` | 在指定目录启动 TUI（默认 cwd），自动注入环境变量 |
 | `opm opencode clear` | — | 清理 opencode 会话并 VACUUM 压缩数据库 |
 | `opm opencode clear -d, --days <n>` | — | 保留最近 n 天（对齐本地零点，含今天；默认 `-d 1`） |
 | `opm opencode clear -h, --hours <n>` | — | 保留最近 n 小时（滚动窗口） |
 | `opm opencode clear -n, --num <n>` | — | 保留最新 n 个会话 |
 | `opm opencode clear --dry-run` | — | 仅预览，不修改任何数据 |
 | `opm opencode clear -y` | — | 跳过确认提示 |
-| `opm opencode config` | — | 显示 opencode 配置文件内容（优先 `opencode.jsonc`，其次 `opencode.json`） |
-| `opm opencode version` | `npm list -g opencode-ai` | 已安装版本 |
-| `opm opencode install` | `npm install -g opencode-ai` | 安装（使用 opm npm 镜像 + proxy） |
-| `opm opencode uninstall` | `npm uninstall -g opencode-ai` | 卸载 |
-| `opm opencode upgrade` | `npm install -g opencode-ai@latest` | 升级（使用 opm npm 镜像 + proxy） |
-| `opm opencode dir` | — | 显示 data/db/log/config 路径 |
+| `opm opencode clear --backup` | — | 删除前备份数据库 |
+| `opm opencode clear --db <path>` | — | 覆盖 opencode 数据库路径 |
 
 > `--days` / `--hours` / `--num` 三选一，互斥。
 
+## 选项
+
+| 选项 | 说明 |
+|------|------|
+| `-p, --proxy <url>` | install/upgrade 时代理（覆盖配置 `proxy.active`） |
+| `-d, --dir <dir>` | open 的工作目录（默认 cwd） |
+| `-h, --help` | 显示帮助 |
+
+## 环境变量
+
+`opm opencode env` 显示注入 opencode 的环境变量，来源为 opm 配置 `opencode.env` 段 + 系统环境变量（系统环境变量优先）：
+
+| 变量 | 默认值 | 说明 |
+|------|--------|------|
+| `OPENCODE_CONFIG_DIR` | `{pkg:@wwkit/harness}` | opencode 配置目录（动态解析为已安装的 @wwkit/harness 包目录） |
+| `OPENCODE_CONFIG_CONTENT` | `""` | opencode 配置内容注入（非空时覆盖配置文件） |
+
 ## 实现说明
 
 - `src/harnesses/opencode/db.js` — 数据目录 / DB / 日志路径
 - `src/harnesses/opencode/sqlite.js` — 跨平台 SQLite 驱动（Node >= 22.5 内置 `node:sqlite`，否则回退 sqlite3 CLI）
 - `src/harnesses/opencode/clear.js` — 清理流程（保留策略计算 + 删除 + VACUUM）
-- `src/harnesses/base.js` — `HarnessGroup` 统一命令组基类（version/install/uninstall/upgrade/config/clear/dir）
+- `src/harnesses/base.js` — `HarnessGroup` 统一命令组基类（version/installed/install/uninstall/upgrade/config/clear/dir/env/open）
 
 ## 示例
 
 ```bash
-opm opencode clear                    # 只保留今天创建的会话
-opm opencode clear -d 7               # 保留最近 7 天会话
-opm opencode clear -h 24              # 保留最近 24 小时会话
-opm opencode clear -n 10              # 保留最新 10 个会话
-opm opencode clear --dry-run          # 仅预览
-opm opencode clear -y                 # 跳过确认直接执行
-opm opencode config                   # 显示 opencode 配置文件内容
-```
+opm opencode version                 # 查看已安装版本
+opm opencode installed               # 检查是否已安装
+opm opencode install                 # 安装 opencode
+opm opencode upgrade                 # 升级到最新
+opm opencode config                  # 显示配置文件内容
+opm opencode dir                     # 查看数据/日志/DB路径
+opm opencode env                     # 查看环境变量
+opm opencode open                    # 在当前目录启动 TUI
+opm opencode open -d /path/to/project # 在指定目录启动 TUI
+opm opencode clear                   # 只保留今天创建的会话
+opm opencode clear -d 7              # 保留最近 7 天会话
+opm opencode clear -h 24             # 保留最近 24 小时会话
+opm opencode clear -n 10             # 保留最新 10 个会话
+opm opencode clear --dry-run         # 仅预览
+opm opencode clear -y                # 跳过确认直接执行
+opm opencode clear --backup         # 删除前备份数据库
+```

package/docs/test/linux-environment-test-report.md

@@ -0,0 +1,147 @@
+# opm 真实环境测试报告
+
+- **日期**: 2026-09-14
+- **环境**: Linux (openEuler, x86_64)
+- **Node.js**: v22.21.1 (恢复后)
+- **工具**: curl 7.79.1, wget, git, dnf 4.10.0, pip 21.3.1
+- **代理**: http://proxyhm-hk.security.huawei.com:8080 (认证: {env:PROXY_USER}:{env:PROXY_PASSWORD})
+- **网络**: 需通过华为代理访问外网
+
+## 一、单元测试
+
+```
+node --test tests/
+# tests 228, pass 225, fail 3
+```
+
+- **通过**: 225
+- **失败**: 3（均为 pip 网络测试，依赖 pypi.org 直连，非本次改动引入）
+- **修复**: cft.test.js 配置 active 不匹配（`npmmirror` → 动态断言）
+
+## 二、真实环境命令测试
+
+### 已安装命令（9 个）
+
+| 命令 | 动作 | 结果 | 备注 |
+|------|------|------|------|
+| `opm npm` | version | PASS | 10.8.2 |
+| | registry | PASS | npmmirror |
+| | installed | PASS | |
+| | search | PASS | 通过代理查询 axios |
+| | info | PASS | |
+| | list | PASS | |
+| | outdated -g | PASS | |
+| | registry set | PASS | 切换 huawei 后恢复 |
+| `opm pip` | version | PASS | 21.3.1 |
+| | registry | PASS | tsinghua |
+| | search | PASS | 通过代理查询 requests |
+| | list | PASS | |
+| | registry set | PASS | |
+| `opm dnf` | version | PASS | 4.10.0 |
+| | registry | PASS | hce |
+| | search | PASS | curl 返回 exists:false（HCE 源无此包，预期行为） |
+| `opm node` | version | PASS | 20.20.2 |
+| | current | PASS | v20.20.2 |
+| | list | PASS | |
+| | versions | PASS | 通过代理获取远程版本列表 |
+| | use | PASS | |
+| `opm nvm` | version | PASS | 0.40.4 |
+| | installed | PASS | |
+| | registry | PASS | huawei |
+| | dir | PASS | /root/.nvm |
+| | upgrade | **FAIL** | `/root/.nvm` 非 git 仓库（git clone 安装的才支持 upgrade） |
+| | uninstall | **WARN** | 实际执行了卸载，删除了 `/root/.nvm`，导致 node 不可用 |
+| `opm config` | (full) | PASS | |
+| | proxy | PASS | 显示 huawei 代理 + active |
+| `opm ping` | host | PASS | |
+| | proxy | PASS | 通过代理访问 npm registry 验证可用性 |
+| | registry | PASS | 16/16 全部 reachable:true |
+| | source | PASS | 打印 curl 示例命令 |
+| `opm cft` | version | PASS | 未安装，输出空 |
+| | dir | PASS | |
+| | list | PASS | |
+| | status | PASS | |
+| | versions | **FAIL** | deepbluenet 镜像无 versions JSON 文件 |
+| `opm ensure` | node | PASS | 已安装，satisfied:true |
+| | help | PASS | |
+
+### 未安装命令（7 个）
+
+| 命令 | 动作 | 结果 | 备注 |
+|------|------|------|------|
+| `opm uv` | version | PASS | 未安装，输出空 |
+| | installed | PASS | false |
+| | registry | PASS | ghproxy |
+| | install | **FAIL** | 超时——curl 未走代理，无法访问 ghproxy.com |
+| `opm python` | version | PASS | 3.9.9（系统 python） |
+| | current | PASS | |
+| | versions | **FAIL** | uv 未安装，预期行为 |
+| `opm phpenv` | version | PASS | 未安装，输出空 |
+| | installed | PASS | false |
+| `opm php` | version | PASS | 未安装，输出空 |
+| | versions | **FAIL** | phpenv 未安装，预期行为 |
+| `opm composer` | version | PASS | 未安装，输出空 |
+| | registry | PASS | aliyun |
+| `opm bun` | version | PASS | 未安装，输出空 |
+| | registry | PASS | npmmirror |
+| `opm docker` | version | PASS | 未安装，输出空 |
+| | installed | PASS | false |
+| | registry | PASS | huawei |
+| | status | PASS | installed:false |
+| | dir | PASS | |
+| | install | **SKIP** | 需要网络下载便捷脚本，未测（避免修改系统） |
+
+## 三、发现的问题
+
+### BUG-1: nvm uninstall 实际执行卸载（严重）
+
+- **现象**: `opm nvm uninstall` 实际删除了 `/root/.nvm` 目录，导致 node 不可用
+- **原因**: `ToolManagerGroup._uninstall()` 直接调用 `cfg.uninstall()`，无确认提示
+- **影响**: 测试环境被破坏，node/nvm 需手动恢复
+- **建议**: 危险操作（uninstall）应加确认提示，或至少 `--force` 标志
+
+### BUG-2: nvm upgrade 对非 git 安装失败
+
+- **现象**: `fatal: not a git repository`
+- **原因**: nvm 通过非 git 方式安装时，`/root/.nvm` 不是 git 仓库，`git pull` 失败
+- **建议**: 检测 `.git` 目录存在性，非 git 安装时提示重新 install
+
+### BUG-3: uv install 不走代理
+
+- **现象**: `opm uv install` 超时
+- **原因**: `installUv()` 中 `curl -LsSf "${installUrl}" | sh` 未传 `-x proxy`
+- **影响**: 所有 ToolManagerGroup 的 install 命令（uv/docker/homebrew）在需代理环境均不可用
+- **建议**: `ToolManagerGroup._install()` 应将 proxy 传递给 `cfg.install(proxy)`
+
+### BUG-4: cft versions 镜像不可用
+
+- **现象**: 无法获取版本列表
+- **原因**: deepbluenet 镜像无 `known-good-versions-with-downloads.json` 文件
+- **影响**: `opm cft versions` 和 `opm cft install` 不可用
+- **建议**: 切换回 npmmirror 或提供可用的 versions JSON 镜像
+
+### ISSUE-1: nvm 华为镜像 git clone 失败
+
+- **现象**: `https://mirrors.huaweicloud.com/nvm.git` 返回 `could not determine hash algorithm`
+- **原因**: 华为镜像可能不提供 nvm 的 git 仓库
+- **影响**: `opm nvm install` 使用此 URL 会失败
+- **建议**: 改用 gitee 镜像或官方 GitHub URL
+
+## 四、测试统计
+
+| 分类 | 数量 |
+|------|------|
+| 总测试命令 | 16 |
+| PASS | 12 |
+| FAIL（bug） | 3（nvm upgrade, uv install, cft versions） |
+| WARN | 1（nvm uninstall 无确认） |
+| SKIP | 1（docker install） |
+| 预期 FAIL（依赖未安装） | 2（python/php versions） |
+
+## 五、修复建议优先级
+
+1. **P0**: nvm uninstall 加确认提示（避免误删）
+2. **P0**: ToolManagerGroup install 命令传 proxy
+3. **P1**: nvm upgrade 检测 git 仓库
+4. **P1**: nvm 华为镜像 URL 修正
+5. **P2**: cft versions 镜像可用性

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wwkit/opm",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "author": "bluesliu <langcai163@163.com>",
   "description": "Unified CLI — package management (npm/pip/dnf/apt) + config view + opencode maintenance",
   "type": "module",
@@ -34,7 +34,8 @@
   "dependencies": {
     "basic-ftp": "^6.2.1",
     "extract-zip": "^2.0.1",
-    "@wwkit/shared": "1.0.5"
+    "systeminformation": "^5.23.0",
+    "@wwkit/shared": "1.0.7"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",

package/src/cli/groups/docker.js

@@ -1,9 +1,9 @@
 /**
  * docker 命令组 — 管理 Docker 自身与 daemon
  *
- * 继承 ToolManagerGroup 复用 version/installed/install/upgrade/uninstall/dir，
+ * 继承 ToolManagerGroup 复用 version/installed/registry/install/upgrade/uninstall/dir，
  * 额外增加 status/start/stop/restart/open。
- * 跨平台：Linux 用便捷脚本，macOS 用 brew cask，Windows 走 WSL2。
+ * 跨平台：Linux 用便捷脚本（URL 由 docker.registry.active 提供），macOS 用 brew cask，Windows 走 WSL2。
  */
 
 import { ToolManagerGroup } from './version-manager.js'
@@ -28,7 +28,6 @@ export class DockerGroup extends ToolManagerGroup {
     super({
       name: 'docker',
       desc: 'Docker manager (install/upgrade/start/stop/open)',
-      hasRegistry: false,
       isInstalled: () => isDockerInstalled(),
       getPath: () => getDockerDir(),
       versionCmd: () => 'docker --version',
@@ -36,14 +35,17 @@ export class DockerGroup extends ToolManagerGroup {
         const m = out.match(/Docker version\s+(\S+)/)
         return m ? m[1] : out.trim()
       },
-      install: () => installDocker(),
+      install: (proxy) => installDocker(proxy),
       upgrade: () => upgradeDocker(),
       uninstall: () => uninstallDocker(),
       usage: 'opm docker <action> [options]',
       actions: [
         ['version', 'Show Docker version'],
         ['installed', 'Check if Docker is installed'],
-        ['install', 'Install Docker (Linux: get.docker.com, macOS: brew cask, Windows: WSL2)'],
+        ['registry', 'Show active Docker install script URL (from opm config)'],
+        ['registry set <url|preset>', 'Set active Docker install script URL (writes opm config)'],
+        ['registry presets', 'List available mirror presets'],
+        ['install', 'Install Docker (Linux: script from active registry, macOS: brew cask, Windows: WSL2)'],
         ['upgrade', 'Upgrade Docker'],
         ['uninstall', 'Uninstall Docker'],
         ['dir', 'Show Docker data directory'],
@@ -57,6 +59,9 @@ export class DockerGroup extends ToolManagerGroup {
       examples: [
         'opm docker version',
         'opm docker installed',
+        'opm docker registry',
+        'opm docker registry set official',
+        'opm docker registry presets',
         'opm docker install',
         'opm docker upgrade',
         'opm docker status',