@zhiman_innies/innies-codex 0.122.32 → 0.122.33
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/README.md +269 -38
- package/package.json +5 -5
package/README.md
CHANGED
|
@@ -1,60 +1,291 @@
|
|
|
1
|
-
<
|
|
2
|
-
|
|
3
|
-
<
|
|
4
|
-
<
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
<picture>
|
|
4
|
+
<source media="(prefers-color-scheme: dark)" srcset=".github/innies-banner-dark.svg">
|
|
5
|
+
<img alt="Innies Codex · 知满科技 AI Coding Agent" src=".github/innies-banner.svg" width="600">
|
|
6
|
+
</picture>
|
|
7
|
+
|
|
8
|
+
<p>
|
|
9
|
+
<b>知满科技 AI 编码助手</b><br>
|
|
10
|
+
<sub>基于 OpenAI Codex 深度定制 · 模型替换为知满自研 <code>qwen35_35b</code></sub>
|
|
11
|
+
</p>
|
|
12
|
+
|
|
13
|
+
<p>
|
|
14
|
+
<img alt="license" src="https://img.shields.io/badge/license-Apache--2.0-1f6feb?style=flat-square">
|
|
15
|
+
<img alt="node" src="https://img.shields.io/badge/node-%E2%89%A516-3fb950?style=flat-square">
|
|
16
|
+
<img alt="platform" src="https://img.shields.io/badge/platform-macOS_%7C_Windows_%7C_Linux-8b949e?style=flat-square">
|
|
17
|
+
<img alt="model" src="https://img.shields.io/badge/model-qwen35__35b-01d280?style=flat-square">
|
|
18
|
+
<img alt="ctx" src="https://img.shields.io/badge/context-272k-01d280?style=flat-square">
|
|
5
19
|
</p>
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
npm install -g @zhiman_innies/innies-codex@latest
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
<sub>
|
|
26
|
+
<a href="#速览">速览</a> ·
|
|
27
|
+
<a href="#安装">安装</a> ·
|
|
28
|
+
<a href="#配置">配置</a> ·
|
|
29
|
+
<a href="#快速上手">快速上手</a> ·
|
|
30
|
+
<a href="#与原生-codex-的差异">差异</a> ·
|
|
31
|
+
<a href="#-迭代路线">🛣️ 路线</a> ·
|
|
32
|
+
<a href="#-已知限制与风险">⚠️ 风险</a> ·
|
|
33
|
+
<a href="#文档">文档</a>
|
|
34
|
+
</sub>
|
|
35
|
+
|
|
36
|
+
</div>
|
|
10
37
|
|
|
11
38
|
---
|
|
12
39
|
|
|
13
|
-
##
|
|
40
|
+
## 速览
|
|
41
|
+
|
|
42
|
+
> 把官方 Codex CLI 的"大脑"换成知满自研模型 `qwen35_35b`，骨架（Agent 编排、TUI、MCP、沙箱、SDK）原样保留。
|
|
43
|
+
|
|
44
|
+
| 维度 | 内容 |
|
|
45
|
+
| :--- | :--- |
|
|
46
|
+
| **为什么换** | 数据不出境 · 无需 ChatGPT 账号 · 可私有化部署到客户机房 · 与原版 Codex 配置完全隔离 |
|
|
47
|
+
| **核心取舍** | `qwen35_35b` 综合推理弱于 GPT-5 · 不支持并行工具调用 · 长链路重构需更多人工拆解 |
|
|
48
|
+
| **谁该用** | 合规优先、内网部署、可接受"能力换主权"的团队 |
|
|
49
|
+
| **谁不该用** | 追求最强模型能力、复杂长链路推理、不要求数据驻留的场景——请继续用官方 Codex / Claude Code |
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## 安装
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
npm install -g @zhiman_innies/innies-codex@latest
|
|
57
|
+
innies --version
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
> 要求：Node.js ≥ 16 · macOS 12+ / Windows 10/11 / Linux x64 或 arm64
|
|
61
|
+
>
|
|
62
|
+
> 源码构建参见 [`docs/install.md`](docs/install.md)。
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## 配置
|
|
67
|
+
|
|
68
|
+
首次运行 `innies` 会在 `~/.inniescoder/config.toml`（Windows: `%USERPROFILE%\.inniescoder\config.toml`）写入默认配置：
|
|
69
|
+
|
|
70
|
+
```toml
|
|
71
|
+
model_provider = "zhiman_35b"
|
|
72
|
+
model = "qwen35_35b"
|
|
73
|
+
|
|
74
|
+
[model_providers.zhiman_35b]
|
|
75
|
+
name = "zhiman_35b"
|
|
76
|
+
base_url = "http://101.237.37.116:7380/v1"
|
|
77
|
+
wire_api = "responses"
|
|
78
|
+
env_key = "ZHIMAN_35B_API_KEY"
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
> ℹ️ **默认 `base_url` 仅用于评估与 POC**。
|
|
82
|
+
> 正式落地通常将模型私有化部署到客户机房内网，部署完成后请**新增**一个供应商节并把 `model_provider` 指向它（默认段会被启动器周期性校正，请勿直接改）：
|
|
83
|
+
|
|
84
|
+
```toml
|
|
85
|
+
model_provider = "my_zhiman"
|
|
86
|
+
model = "qwen35_35b"
|
|
87
|
+
|
|
88
|
+
[model_providers.my_zhiman]
|
|
89
|
+
name = "my_zhiman"
|
|
90
|
+
base_url = "https://your-internal-host/v1" # 内网地址，由实施团队提供
|
|
91
|
+
wire_api = "responses"
|
|
92
|
+
env_key = "ZHIMAN_35B_API_KEY"
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
API Key 通过环境变量注入，**不要**写进 `config.toml`：
|
|
96
|
+
|
|
97
|
+
```bash
|
|
98
|
+
export ZHIMAN_35B_API_KEY="你的密钥" # 写入 ~/.zshrc 或 ~/.bashrc 后持久化
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
完整步骤：[`docs/Inniescoder用户使用手册.md`](docs/Inniescoder用户使用手册.md)
|
|
102
|
+
|
|
103
|
+
---
|
|
14
104
|
|
|
15
|
-
|
|
105
|
+
## 快速上手
|
|
16
106
|
|
|
17
|
-
|
|
107
|
+
```bash
|
|
108
|
+
cd /path/to/your/project
|
|
18
109
|
|
|
19
|
-
|
|
20
|
-
#
|
|
21
|
-
|
|
110
|
+
innies # 交互式 TUI
|
|
111
|
+
innies exec "运行所有测试并总结失败用例" # 非交互执行，适合 CI
|
|
112
|
+
innies review --base main # 代码审查
|
|
113
|
+
innies app-server # JSON-RPC + WebSocket，供 IDE/系统集成
|
|
22
114
|
```
|
|
23
115
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
## 与原生 Codex 的差异
|
|
119
|
+
|
|
120
|
+
<table>
|
|
121
|
+
<thead>
|
|
122
|
+
<tr>
|
|
123
|
+
<th width="180">维度</th>
|
|
124
|
+
<th width="320">Innies Codex</th>
|
|
125
|
+
<th width="280">官方 OpenAI Codex</th>
|
|
126
|
+
</tr>
|
|
127
|
+
</thead>
|
|
128
|
+
<tbody>
|
|
129
|
+
<tr>
|
|
130
|
+
<td><b>默认模型</b></td>
|
|
131
|
+
<td><code>qwen35_35b</code>（知满自研 35B）</td>
|
|
132
|
+
<td><code>gpt-5.4</code> / <code>gpt-5.3-codex</code></td>
|
|
133
|
+
</tr>
|
|
134
|
+
<tr>
|
|
135
|
+
<td><b>数据流向</b></td>
|
|
136
|
+
<td>知满网关（评估）/ 客户机房内网（生产）</td>
|
|
137
|
+
<td>OpenAI 海外</td>
|
|
138
|
+
</tr>
|
|
139
|
+
<tr>
|
|
140
|
+
<td><b>接入门槛</b></td>
|
|
141
|
+
<td>API Key</td>
|
|
142
|
+
<td>ChatGPT 订阅或 OpenAI API</td>
|
|
143
|
+
</tr>
|
|
144
|
+
<tr>
|
|
145
|
+
<td><b>配置目录</b></td>
|
|
146
|
+
<td><code>~/.inniescoder/</code>（独立）</td>
|
|
147
|
+
<td><code>~/.codex/</code></td>
|
|
148
|
+
</tr>
|
|
149
|
+
<tr>
|
|
150
|
+
<td><b>TUI 品牌</b></td>
|
|
151
|
+
<td>Zhiman ASCII 字 + 中文文案</td>
|
|
152
|
+
<td>OpenAI 原版</td>
|
|
153
|
+
</tr>
|
|
154
|
+
<tr>
|
|
155
|
+
<td><b>备选模型</b></td>
|
|
156
|
+
<td>DashScope <code>qwen3.6-plus</code>（百炼）</td>
|
|
157
|
+
<td>—</td>
|
|
158
|
+
</tr>
|
|
159
|
+
<tr>
|
|
160
|
+
<td><b>稳定性补丁</b></td>
|
|
161
|
+
<td>qwen streaming · 命令中断 · 首启报错等 10+ 项</td>
|
|
162
|
+
<td>—</td>
|
|
163
|
+
</tr>
|
|
164
|
+
<tr>
|
|
165
|
+
<td><b>Agent / MCP / 沙箱 / SDK</b></td>
|
|
166
|
+
<td colspan="2" align="center"><b>与上游完全一致</b></td>
|
|
167
|
+
</tr>
|
|
168
|
+
</tbody>
|
|
169
|
+
</table>
|
|
170
|
+
|
|
171
|
+
> **设计原则**：*只换大脑，不换骨架。* 上游 Codex 每个 release 都会跟进，定制点仅落在模型层、品牌层、稳定性补丁层。
|
|
172
|
+
|
|
173
|
+
---
|
|
174
|
+
|
|
175
|
+
## 🛣️ 迭代路线
|
|
176
|
+
|
|
177
|
+
| 阶段 | 状态 | 内容 |
|
|
178
|
+
| :--- | :---: | :--- |
|
|
179
|
+
| **v1 · CLI Agent** | ✅ 已发布 | 稳定的 TUI / `exec` / `review` / `app-server` 入口，知满 `qwen35_35b` 适配，14 项 Superpowers 技能 |
|
|
180
|
+
| **v2 · 私有化部署套件** | 🟢 进行中 | 推理服务镜像、Helm Chart、模型权重交付、客户机房一键部署 |
|
|
181
|
+
| **v3 · InniesCoding 端到端工作流** | 🟡 内测 | 由自然语言需求自动驱动的五阶段管线，详见下文 |
|
|
182
|
+
| **v4 · IDE 插件 / Web 控制台** | ⚪ 规划中 | 基于现有 App Server 能力延伸 |
|
|
183
|
+
|
|
184
|
+
### InniesCoding 端到端工作流（v3 预览）
|
|
185
|
+
|
|
186
|
+
`InniesCoding` 是建在 Innies Codex 之上的**研发自动化管线**，由 RAG（检索增强）与 KG（知识图谱）MCP server 驱动，将一个自然语言需求拆解为五个可追溯阶段：
|
|
187
|
+
|
|
27
188
|
```
|
|
189
|
+
需求分析 → 代码定位与影响评估 → Spec 生成 → 代码变更 → 测试用例补全
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
| 阶段 | 输入 | 输出 |
|
|
193
|
+
| :--- | :--- | :--- |
|
|
194
|
+
| `requirement_analysis` | 原始需求 | PRD 草稿（含 RAG 证据 + KG 影响范围） |
|
|
195
|
+
| `code_search_and_assessment` | PRD + 项目代码 | 受影响文件、调用链、风险点 |
|
|
196
|
+
| `spec_generation` | 影响范围 | 技术 Spec |
|
|
197
|
+
| `code_change` | Spec | 代码补丁 |
|
|
198
|
+
| `test_case_lookup_and_generation` | 变更 | 单元 / 集成测试用例 |
|
|
199
|
+
|
|
200
|
+
> 当前以 `INNIES_CODING_STAGE` 环境变量内部触发，公开版本将以 `innies coding <stage>` 子命令形式暴露。实现入口见 [`codex-cli/bin/innies-coding-runtime.js`](codex-cli/bin/innies-coding-runtime.js)。
|
|
201
|
+
|
|
202
|
+
---
|
|
203
|
+
|
|
204
|
+
## ⚠️ 已知限制与风险
|
|
205
|
+
|
|
206
|
+
> 以下内容**基于代码与配置事实**列出，落地前请完整阅读。
|
|
28
207
|
|
|
29
|
-
|
|
208
|
+
### 1. 模型能力差距是真实存在的
|
|
30
209
|
|
|
31
|
-
|
|
32
|
-
<summary>You can also go to the <a href="https://github.com/openai/codex/releases/latest">latest GitHub Release</a> and download the appropriate binary for your platform.</summary>
|
|
210
|
+
`qwen35_35b` 在以下维度**可被代码直接证实**地弱于 GPT-5 系列：
|
|
33
211
|
|
|
34
|
-
|
|
212
|
+
<table>
|
|
213
|
+
<thead>
|
|
214
|
+
<tr>
|
|
215
|
+
<th width="220">能力</th>
|
|
216
|
+
<th width="280"><code>qwen35_35b</code></th>
|
|
217
|
+
<th width="280"><code>gpt-5.4</code> / Claude 4.7</th>
|
|
218
|
+
</tr>
|
|
219
|
+
</thead>
|
|
220
|
+
<tbody>
|
|
221
|
+
<tr>
|
|
222
|
+
<td>并行工具调用</td>
|
|
223
|
+
<td>❌ <code>supports_parallel_tool_calls: false</code></td>
|
|
224
|
+
<td>✅</td>
|
|
225
|
+
</tr>
|
|
226
|
+
<tr>
|
|
227
|
+
<td>推理强度档位</td>
|
|
228
|
+
<td>❌ <code>supported_reasoning_levels: []</code>（无 high/medium/low）</td>
|
|
229
|
+
<td>✅</td>
|
|
230
|
+
</tr>
|
|
231
|
+
<tr>
|
|
232
|
+
<td>输出截断阈值</td>
|
|
233
|
+
<td>10 000 tokens（较激进）</td>
|
|
234
|
+
<td>同</td>
|
|
235
|
+
</tr>
|
|
236
|
+
<tr>
|
|
237
|
+
<td>综合代码任务</td>
|
|
238
|
+
<td colspan="2">主观体验：复杂多文件重构、长链路调试明显落后</td>
|
|
239
|
+
</tr>
|
|
240
|
+
</tbody>
|
|
241
|
+
</table>
|
|
35
242
|
|
|
36
|
-
|
|
37
|
-
- Apple Silicon/arm64: `codex-aarch64-apple-darwin.tar.gz`
|
|
38
|
-
- x86_64 (older Mac hardware): `codex-x86_64-apple-darwin.tar.gz`
|
|
39
|
-
- Linux
|
|
40
|
-
- x86_64: `codex-x86_64-unknown-linux-musl.tar.gz`
|
|
41
|
-
- arm64: `codex-aarch64-unknown-linux-musl.tar.gz`
|
|
243
|
+
**实际影响**：
|
|
42
244
|
|
|
43
|
-
|
|
245
|
+
- 一次 turn 里需要"读 5 个文件 + grep 3 次"时，`qwen35_35b` 会**串行**逐个发起，整体延迟约为 GPT-5 的 2-3 倍
|
|
246
|
+
- 跨 10+ 文件的架构级重构需要更多人工拆解和多轮迭代，**不要期望一次到位**
|
|
247
|
+
- 不能通过 `model_reasoning_effort` 让模型"想久一点"——这个开关对 `qwen35_35b` 无效
|
|
44
248
|
|
|
45
|
-
|
|
249
|
+
> 上述特征可通过 [`codex-cli/assets/innies-catalog.json`](codex-cli/assets/innies-catalog.json) 中各模型的字段直接对比。
|
|
46
250
|
|
|
47
|
-
###
|
|
251
|
+
### 2. 上游跟随有滞后与冲突风险
|
|
48
252
|
|
|
49
|
-
|
|
253
|
+
- 仓库跟随官方 Codex 每个 release（最近一次 `rust-v0.122.32`）
|
|
254
|
+
- 上游做 breaking change 时，定制点（品牌、模型目录、隔离逻辑）需要手动 cherry-pick，**预期延迟 1~2 周**
|
|
255
|
+
- 上游 OpenAI 一旦移除 Responses API 或调整工具调用 schema，`qwen35_35b` 适配需追加工作量
|
|
50
256
|
|
|
51
|
-
|
|
257
|
+
### 3. 治理边界仅覆盖到本机
|
|
52
258
|
|
|
53
|
-
|
|
259
|
+
- macOS 沙箱基于 Seatbelt（`sandbox-exec`），Linux 基于 landlock，Windows 沙箱能力受限（仅文件系统 ACL）
|
|
260
|
+
- 没有组织级 IAM、角色、审计后台——多人协作的合规治理需对接外部系统
|
|
261
|
+
- API Key 是单 token、无作用域、无过期——一旦泄露需手动轮换全员
|
|
54
262
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
-
|
|
58
|
-
-
|
|
263
|
+
### 4. 许可与权属
|
|
264
|
+
|
|
265
|
+
- 仓库代码遵循 **Apache-2.0**（见 [`LICENSE`](LICENSE)）
|
|
266
|
+
- `qwen35_35b` 模型权重**不在本仓库**，使用知满推理服务即受其商务条款约束；客户机房私有化部署的权重交付由知满实施团队处理
|
|
267
|
+
- TUI 品牌字、`Zhiman` 商标属知满科技
|
|
268
|
+
|
|
269
|
+
---
|
|
270
|
+
|
|
271
|
+
## 文档
|
|
272
|
+
|
|
273
|
+
| 文档 | 内容 |
|
|
274
|
+
| :--- | :--- |
|
|
275
|
+
| [`docs/Inniescoder用户使用手册.md`](docs/Inniescoder用户使用手册.md) | 面向最终用户的安装 / 配置 / 升级 / 卸载 / FAQ |
|
|
276
|
+
| [`docs/Inniescoder能力支持说明.md`](docs/Inniescoder能力支持说明.md) | 代码辅助能力逐项对照表 |
|
|
277
|
+
| [`docs/install.md`](docs/install.md) | 从源码构建 |
|
|
278
|
+
| [`docs/config.md`](docs/config.md) | `config.toml` 字段参考 |
|
|
279
|
+
| [`docs/sandbox.md`](docs/sandbox.md) | 沙箱与审批策略 |
|
|
280
|
+
| [`docs/skills.md`](docs/skills.md) | Skill 注入机制 |
|
|
281
|
+
| [`docs/innies-qwen35-*.md`](docs/) | qwen35 全链路 / 稳定性 / 高并发测试报告 |
|
|
282
|
+
| [`AGENTS.md`](AGENTS.md) | 贡献者必读（Rust 规范、测试约定） |
|
|
283
|
+
| [`SECURITY.md`](SECURITY.md) | 安全披露流程 |
|
|
284
|
+
|
|
285
|
+
---
|
|
59
286
|
|
|
60
|
-
|
|
287
|
+
<div align="center">
|
|
288
|
+
<sub>问题反馈、定制需求请联系 <a href="https://zhiman.tech/">知满科技</a></sub>
|
|
289
|
+
<br>
|
|
290
|
+
<sub><i>Zhiman · intent in motion</i></sub>
|
|
291
|
+
</div>
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@zhiman_innies/innies-codex",
|
|
3
|
-
"version": "0.122.
|
|
3
|
+
"version": "0.122.33",
|
|
4
4
|
"license": "Apache-2.0",
|
|
5
5
|
"bin": {
|
|
6
6
|
"innies": "bin/innies.js"
|
|
@@ -23,9 +23,9 @@
|
|
|
23
23
|
"postinstall": "node bin/innies-init.js"
|
|
24
24
|
},
|
|
25
25
|
"optionalDependencies": {
|
|
26
|
-
"@zhiman_innies/innies-codex-darwin-x64": "0.122.
|
|
27
|
-
"@zhiman_innies/innies-codex-darwin-arm64": "0.122.
|
|
28
|
-
"@zhiman_innies/innies-codex-win32-x64": "0.122.
|
|
29
|
-
"@zhiman_innies/innies-codex-win32-arm64": "0.122.
|
|
26
|
+
"@zhiman_innies/innies-codex-darwin-x64": "0.122.33-darwin-x64",
|
|
27
|
+
"@zhiman_innies/innies-codex-darwin-arm64": "0.122.33-darwin-arm64",
|
|
28
|
+
"@zhiman_innies/innies-codex-win32-x64": "0.122.33-win32-x64",
|
|
29
|
+
"@zhiman_innies/innies-codex-win32-arm64": "0.122.33-win32-arm64"
|
|
30
30
|
}
|
|
31
31
|
}
|