ihui-cli 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 IHUI AI Contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied. See the License for the specific language governing permissions
+   and limitations under the License.

package/NOTICE

@@ -0,0 +1,44 @@
+IHUI-AI (智汇AI)
+Copyright 2026 Li Chunchuan (李春川) · https://aizhs.top
+
+This product includes software developed by IHUI AI (https://aizhs.top).
+
+------------------------------------------------------------------
+
+License:
+  This project is licensed under the Apache License 2.0 (see LICENSE).
+  Commercial use, modification and redistribution are permitted under
+  the terms of the Apache License 2.0 without separate authorization.
+
+  Under Apache-2.0 §4(b)(d), every copy (including modified versions)
+  you distribute must:
+    - retain this NOTICE file and the copyright statements;
+    - include the full License and NOTICE with the copy;
+    - carry prominent notices stating that you changed the files;
+    - prominently credit the source <https://aizhs.top>.
+
+  Source file headers carry a one-line visible copyright attribution;
+  please retain it when redistributing (Apache-2.0 §4 attribution notice).
+
+------------------------------------------------------------------
+
+第三方来源台账（Inbound third-party provenance ledger）：
+  上面两段讲的是**出站**（别人复制我们的代码时必须保留什么）。本节讲**入站**：
+  本仓库携带的第三方 / 嵌入 / 复制内容，逐条登记在
+    config/third-party-provenance/embedded.json   （打进产物的组件，如 vendored crate）
+    config/third-party-provenance/copied.json     （复制进仓的源码与素材）
+    config/third-party-provenance/overrides.json  （被 override 换掉来源的依赖）
+    config/third-party-provenance/mechanisms.json （只吸收机制、不带走代码的借鉴）
+  每条登记上游项目、获取来源、revision（不可考则显式 null 并说明）、许可证、
+  许可原文的位置与 sha256、本仓是否改过（Apache-2.0 §4(b) 要求标注修改），
+  以及"仍需审计"的义务清单。
+  判据：node scripts/provenance-ledger.mjs（--report 出人读盘点，--self-test 出取证），
+  入口 pnpm check:provenance。它同时反向核查：盘上任何 vendored 目录或带第三方
+  版权 / SPDX 头的文件，若台账里没有对应条目即判红。
+
+  分发本仓库任何部分（含 vendored 目录内的文件）时，除保留本 NOTICE 外，
+  还必须按台账登记的各自许可保留其上游版权声明与许可原文：
+    apps/desktop/src-tauri/vendor/tray-icon-0.24.2/ —— tray-icon (tauri-apps)，
+      MIT OR Apache-2.0，许可原文随目录内的 LICENSE-APACHE / LICENSE-MIT 一并分发；
+      本仓对该副本的 Windows 后端修改见该条目 modification 字段。
+  本节是登记面的指针，不构成对上述任何组件的再授权；各组件许可以上述文件为准。

package/README.md

@@ -1,3 +1,220 @@
-# Temporary Holding Version
+<!--
+  © 2026 IHUI AI (智汇AI) · 版权所有者: 李春川 (Li Chunchuan) · https://aizhs.top
+  Provenance-watermarked. 未授权商用可被溯源追责 (Apache-2.0 须保留本声明与 NOTICE)。
+  [IHUI-AI-PROVENANCE]:⁠​‌​​‌​​‌‍‍​‌​​‌​​​‍‍​‌​‌​‌​‌‍‍​‌​​‌​​‌‍‍​​‌​‌‌​‌‍‍​‌​​​​​‌‍‍​‌​​‌​​‌‍‍‌​‌‌​‌‌‌‍‍‌‌​​‌‌​​‌‌‌‌​‌​‍‍‌‌​‌‌​​​‌​​​‌‌‌‍‍​‌​​​​​‌‍‍​‌​​‌​​‌‍‍‌​‌‌​‌‌‌‍‍‌‌​​‌‌‌​‌​​‌‌‌​‍‍‌‌​​‌‌​​​‌​​‌​‌‍‍‌​‌‌‌​‌‌‌​‌‌‌​‌‍‍‌​‌‌​‌‌‌‍‍​‌​​‌‌​​‍‍​‌​​​​‌‌‍‍‌​‌‌​‌‌‌‍‍​‌‌​​​​‌‍‍​‌‌​‌​​‌‍‍​‌‌‌‌​‌​‍‍​‌‌​‌​​​‍‍​‌‌‌​​‌‌‍‍​​‌​‌‌‌​‍‍​‌‌‌​‌​​‍‍​‌‌​‌‌‌‌‍‍​‌‌‌​​​​‍‍‌​‌‌​‌‌‌‍‍​‌​‌​​​​‍‍​‌​‌​​‌​‍‍​‌​​‌‌‌‌‍‍​‌​‌​‌‌​‍‍​‌​​​‌​‌‍‍​‌​​‌‌‌​‍‍​‌​​​​​‌‍‍​‌​​‌‌‌​‍‍​‌​​​​‌‌‍‍​‌​​​‌​‌‍‍​​‌​‌‌​‌‍‍​​‌‌​​‌​‍‍​​‌‌​​​​‍‍​​‌‌​​‌​‍‍​​‌‌​‌‌​⁠
+-->
 
-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.
+# IHUI AI CLI
+
+> 全栈 AI 编码代理命令行工具 — 对标 Claude Code / OpenAI Codex,9 种安装方式,跨平台运行。
+
+## 安装
+
+### 1. npm(全平台)
+
+```bash
+npm install -g ihui-cli
+```
+
+### 2. curl 一键安装(macOS / Linux)
+
+```bash
+curl -fsSL https://aizhs.top/install.sh | bash
+```
+
+指定版本:
+
+```bash
+curl -fsSL https://aizhs.top/install.sh | bash -s -- --version 1.0.0
+```
+
+### 3. PowerShell 一键安装(Windows)
+
+```powershell
+irm https://aizhs.top/install.ps1 | iex
+```
+
+指定版本:
+
+```powershell
+irm https://aizhs.top/install.ps1 | iex -Version 1.0.0
+```
+
+### 4. Homebrew(macOS / Linux)
+
+```bash
+brew install ihui
+```
+
+> 需先添加 tap:`brew tap ihui/ihui`
+
+### 5. Scoop(Windows)
+
+```bash
+scoop install ihui
+```
+
+> 需先添加 bucket:`scoop bucket add ihui https://github.com/IHUI-INF-AI/IHUI-AI`
+
+### 6. Winget(Windows)
+
+```bash
+winget install IHUI.IHUI
+```
+
+### 7. Docker(全平台)
+
+```bash
+docker run --rm -v "$(pwd):/workspace" ghcr.io/ihui/ai-cli
+```
+
+交互模式:
+
+```bash
+docker run --rm -it -v "$(pwd):/workspace" ghcr.io/ihui/ai-cli chat
+```
+
+### 8. Snap(Linux)
+
+```bash
+sudo snap install ihui --classic
+```
+
+### 9. AppImage(Linux)
+
+从 [GitHub Releases](https://github.com/IHUI-INF-AI/IHUI-AI/releases) 下载 `IHUI-x86_64.AppImage`:
+
+```bash
+chmod +x IHUI-x86_64.AppImage
+./IHUI-x86_64.AppImage --help
+```
+
+### 10. 单文件二进制(SEA,无 Node 依赖)
+
+由 Node 22 SEA(Single Executable Applications)打包:esbuild 单文件 bundle → SEA blob → postject 注入 node.exe。exe 内嵌构建期版本与 10 份 i18n 语言包 assets,部署到任意目录无需 Node 运行时、无需仓库文件。
+
+```bash
+# 从源码构建(本机需 node 22+ 与 esbuild/postject)
+pnpm --filter ihui-cli build:sea
+# 产物:apps/cli/dist-sea/ihui.exe(旁随带 package.json,可随 exe 一同分发以保留 engines 元信息,缺省亦可用)
+
+# 发布前强制烟雾测试:拷到仓库外空目录验收(版本/i18n/版本闸门都依赖内嵌数据)
+cp apps/cli/dist-sea/ihui.exe /tmp/sea-accept/ && cd /tmp/sea-accept
+./ihui.exe --version   # 必须输出真实版本(非 0.0.0)
+./ihui.exe --help      # 必须输出中文描述(非裸键名如 cliEntry.tagline)
+```
+
+分发与安装脚本(`scripts/install.sh` / `install.ps1`)的二进制下载通道按
+`releases/latest/download/ihui-<os>-<arch>.<ext>` 契约消费 GitHub Release 资产
+(由 `release-cli.yml` 的 build-binary 矩阵产出)。
+
+## 快速开始
+
+### 示例 1:启动交互式 REPL
+
+```bash
+ihui
+```
+
+不带参数即进入交互式 REPL;多轮对话也可显式写 `ihui chat`。
+
+### 示例 2:单次执行 agent 任务
+
+```bash
+ihui agent "为 src/utils.ts 添加单元测试"
+```
+
+### 示例 3:配置 API key 和模型
+
+```bash
+# 非交互:环境变量 + 启动参数
+export IHUI_API_KEY="ihui_your_api_key"
+ihui -m gpt-4o "为 src/utils.ts 添加单元测试"
+
+# 或落盘到统一配置文件(生成模板、查看路径)
+ihui settings init
+ihui settings path
+```
+
+改单个配置项在 REPL 内进行:`/config list` · `/config get <key>` · `/config set <key> <value>`。
+
+## 命令列表
+
+| 命令 | 说明 |
+| --- | --- |
+| `ihui agent [prompt]` | 启动 AI 编码代理,执行编码任务 |
+| `ihui` / `ihui chat` | 进入交互式 REPL(多轮对话) |
+| `ihui settings <init\|path>` | 创建 / 定位统一配置文件(改配置项用 REPL 内的 `/config`) |
+| `ihui undo [steps]` | 回滚最近 N 步文件改动(默认 1 步) |
+| `ihui redo [steps]` | 重做最近 N 步被 undo 的改动 |
+| `ihui share [session-id]` | 生成可分享的会话快照 |
+| `ihui mode [mode]` | 查看或切换交互模式:plan(只读调研)/ build(执行修改)/ review(审查 diff) |
+| `ihui hooks-auto <discover\|conflicts\|test>` | 自动发现多目录 hook 脚本 / 检测冲突 / 沙箱试跑 |
+| `ihui serve` | 启动 Agent 内核 HTTP/WS server(端口 8841),供远程驱动 |
+| `ihui connect <url>` | 作为客户端连接远程 Agent server |
+| `ihui capabilities remote list --server <url>` | 查询远程端的能力清单 |
+
+运行 `ihui --help` 查看完整命令列表和选项。
+
+## 配置说明
+
+### API Key
+
+支持多种 LLM 提供商,通过环境变量或配置文件设置:
+
+```bash
+# 环境变量(推荐)
+export IHUI_API_KEY="ihui_your_api_key"
+
+# 或写入统一配置文件(生成模板后编辑 apiKey 字段;也可 `ihui login` 换取 JWT)
+ihui settings init
+```
+
+配置文件路径:`~/.ihui/settings.json`
+
+### 模型选择
+
+```bash
+# 单次指定
+ihui -m gpt-4o "任务描述"
+
+# 持久化:REPL 内 /config set defaultModel gpt-4o,或直接改 settings.json 的 defaultModel 字段
+```
+
+支持的模型包括 OpenAI GPT 系列、Anthropic Claude 系列、国产大模型(智谱 GLM、百度文心、阿里通义等)。
+
+## 环境要求
+
+- **Node.js** >= 20.10.0(使用 npm / Homebrew / Snap / curl 安装方式时)
+- **Docker**(使用 Docker 安装方式时)
+- **操作系统**: macOS 12+ / Windows 10+ / Linux(Ubuntu 20.04+ / Debian 11+ / CentOS 8+)
+
+## 文档
+
+- [完整文档](https://github.com/IHUI-INF-AI/IHUI-AI#readme)
+- [架构设计](https://github.com/IHUI-INF-AI/IHUI-AI/blob/main/docs/architecture.md)
+- [变更日志](https://github.com/IHUI-INF-AI/IHUI-AI/releases)
+- [问题反馈](https://github.com/IHUI-INF-AI/IHUI-AI/issues)
+
+## Code signing policy
+
+Free code signing provided by SignPath.io, certificate by SignPath Foundation.
+
+- **Scope**: starting with the first SignPath-approved release, every distributed Windows binary (`ihui.exe` from GitHub Releases) is Authenticode-signed during the GitHub Actions release pipeline. Builds from before that release are unsigned.
+- **Team roles** (single-maintainer project): Authors / Committers: [@IHUI-INF-AI](https://github.com/IHUI-INF-AI); Reviewers: same; Approvers (signing approval for each release): same. All accounts interacting with the signing pipeline use multi-factor authentication.
+- **Builds**: every release artifact is produced by the GitHub Actions workflow in this repository from the release tag's source tree. The signing request for each release is approved manually by the Approver in the SignPath portal before artifacts are published.
+
+## Privacy statement
+
+This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it. The only outbound connections, each triggered by user-configured features, are:
+
+- **AI API calls**: sent to the user-configured IHUI API endpoint (default `https://api.aizhs.top`) when the user runs a chat/agent task;
+- **Version check**: contacts the user-configured API endpoint and `registry.npmjs.org` to check for CLI updates — disable entirely with the environment variable `IHUI_NO_UPDATE_CHECK=1`;
+- **Telemetry**: disabled by default (`settings.telemetry.enabled = false`, fully no-op). If explicitly enabled by the user, events go only to the user-configured endpoint.
+
+Crash logs are written locally to `~/.ihui/crash-logs` and never leave the machine automatically.
+
+## License
+
+Apache-2.0 — see [LICENSE](../../LICENSE).
+<!-- ⁠​‌​​‌​​‌‍‍​‌​​‌​​​‍‍​‌​‌​‌​‌‍‍​‌​​‌​​‌‍‍​​‌​‌‌​‌‍‍​‌​​​​​‌‍‍​‌​​‌​​‌‍‍‌​‌‌​‌‌‌‍‍‌‌​​‌‌​​‌‌‌‌​‌​‍‍‌‌​‌‌​​​‌​​​‌‌‌‍‍​‌​​​​​‌‍‍​‌​​‌​​‌‍‍‌​‌‌​‌‌‌‍‍‌‌​​‌‌‌​‌​​‌‌‌​‍‍‌‌​​‌‌​​​‌​​‌​‌‍‍‌​‌‌‌​‌‌‌​‌‌‌​‌‍‍‌​‌‌​‌‌‌‍‍​‌​​‌‌​​‍‍​‌​​​​‌‌‍‍‌​‌‌​‌‌‌‍‍​‌‌​​​​‌‍‍​‌‌​‌​​‌‍‍​‌‌‌‌​‌​‍‍​‌‌​‌​​​‍‍​‌‌‌​​‌‌‍‍​​‌​‌‌‌​‍‍​‌‌‌​‌​​‍‍​‌‌​‌‌‌‌‍‍​‌‌‌​​​​‍‍‌​‌‌​‌‌‌‍‍​‌​‌​​​​‍‍​‌​‌​​‌​‍‍​‌​​‌‌‌‌‍‍​‌​‌​‌‌​‍‍​‌​​​‌​‌‍‍​‌​​‌‌‌​‍‍​‌​​​​​‌‍‍​‌​​‌‌‌​‍‍​‌​​​​‌‌‍‍​‌​​​‌​‌‍‍​​‌​‌‌​‌‍‍​​‌‌​​‌​‍‍​​‌‌​​​​‍‍​​‌‌​​‌​‍‍​​‌‌​‌‌​⁠ -->