add-coder 0.3.20-0 → 0.3.20
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
CHANGED
|
@@ -263,7 +263,7 @@ npx add-coder init
|
|
|
263
263
|
|
|
264
264
|
| 命令 | 说明 |
|
|
265
265
|
|------|------|
|
|
266
|
-
| `init` | 初始化 ADD 模板，支持 `--adapter claude\|qoder\|vscode\|auto` |
|
|
266
|
+
| `init` | 初始化 ADD 模板，支持 `--adapter claude\|qoder\|vscode\|trae\|codex\|auto` |
|
|
267
267
|
| `sync` | 增量同步缺失文件 |
|
|
268
268
|
| `status` | 检查模板完整性 |
|
|
269
269
|
|
|
@@ -283,7 +283,7 @@ npx add-coder init
|
|
|
283
283
|
|
|
284
284
|
| 选项 | 说明 |
|
|
285
285
|
|------|------|
|
|
286
|
-
| `--adapter <type>` | 目标 IDE：claude / qoder / vscode / auto
|
|
286
|
+
| `--adapter <type>` | 目标 IDE：claude / qoder / vscode / trae / codex / auto（自动检测，默认） |
|
|
287
287
|
| `--config <path>` | 指定配置文件 |
|
|
288
288
|
| `--yes` | 跳过交互，只创建新文件 |
|
|
289
289
|
| `--force` | 覆盖已有文件 |
|
|
@@ -297,6 +297,8 @@ npx add-coder init
|
|
|
297
297
|
| `.claude/` | Claude Code 适配（hooks、settings.json） |
|
|
298
298
|
| `.qoder/` | Qoder 适配（hooks、settings.json、mcp.json） |
|
|
299
299
|
| `.vscode/` | VS Code 适配（settings.json、tasks.json） |
|
|
300
|
+
| `.trae/` | Trae 适配（hooks.json、settings.json） |
|
|
301
|
+
| `.codex/` | Codex 适配（hooks.json、settings.json） |
|
|
300
302
|
|
|
301
303
|
## MCP 审计工具链
|
|
302
304
|
|
|
@@ -590,7 +592,7 @@ npx add-coder init
|
|
|
590
592
|
|
|
591
593
|
| Command | Description |
|
|
592
594
|
|---------|-------------|
|
|
593
|
-
| `init` | Initialize ADD templates, supports `--adapter claude\|qoder\|vscode\|auto` |
|
|
595
|
+
| `init` | Initialize ADD templates, supports `--adapter claude\|qoder\|vscode\|trae\|codex\|auto` |
|
|
594
596
|
| `sync` | Incrementally sync missing files |
|
|
595
597
|
| `status` | Check template integrity |
|
|
596
598
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "add-coder",
|
|
3
|
-
"version": "0.3.20
|
|
3
|
+
"version": "0.3.20",
|
|
4
4
|
"private": false,
|
|
5
5
|
"description": "[codein2027](https://github.com/xiaomingming92/codein2027) - A complete scaffolding for building the ADD programming paradigm, the implementation layer for AI code governance. Core principle: Audit as Infrastructure. Breaks the black-box programming process and cross-session amnesia, evolving programming paradigms into an auditable, traceable, and convergent new era. npx-ready.\n\n[codein2027](https://github.com/xiaomingming92/codein2027) 快速构建 ADD 编程范式的完整脚手架——AI 代码治理的落地方案。以「审计即基础设施」为核心，彻底打破编程过程黑盒与跨轮失忆，让编程范式进化为可审计、可追溯、可收敛的新时代。npx 即用，人人可体验。",
|
|
6
6
|
"repository": {
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
{
|
|
2
|
-
"_version": "0.3.20
|
|
2
|
+
"_version": "0.3.20",
|
|
3
3
|
"adapters/claude/hooks/doc-format-guard.sh": "ec59ad3f",
|
|
4
4
|
"adapters/claude/hooks/lib/common.sh": "4f3e64ad",
|
|
5
5
|
"adapters/claude/hooks/lib/context-inject.sh": "cfc8c65e",
|
|
@@ -135,6 +135,7 @@
|
|
|
135
135
|
"adapters/vscode/launch.json": "f2b79855",
|
|
136
136
|
"adapters/vscode/settings.json": "7cabd00e",
|
|
137
137
|
"adapters/vscode/tasks.json": "654d7fbd",
|
|
138
|
+
"core/DEPENDENCIES.md": "88d01954",
|
|
138
139
|
"core/agents/add-flow-guardian.md": "c3e650d2",
|
|
139
140
|
"core/docs/ADD-governance-claude-code.md": "0f582a7e",
|
|
140
141
|
"core/docs/ADD-governance-codex.md": "289e8b71",
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
# 模板运行时依赖清单（Template Runtime Dependencies）
|
|
2
|
+
|
|
3
|
+
> 本文件随 `sync` 同步到项目的 `.add/`（或对应 magic 目录）。**基建依赖必须在安装期解决，不要等到运行时（如 DPS 评分）才发现缺失。**
|
|
4
|
+
>
|
|
5
|
+
> 两类资源的责任边界：
|
|
6
|
+
>
|
|
7
|
+
> | 类别 | 解决时机 | 负责方 |
|
|
8
|
+
> |------|---------|--------|
|
|
9
|
+
> | **基建依赖（npm 包）** | 项目安装期 `npm i` | 本清单（DEPENDENCIES.md） |
|
|
10
|
+
> | **运行时资源（模型权重）** | 首次 DPS 调用或 `model:download` 预下载 | `check_dps` 降级提示 + CLI 下载命令 |
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## 一、基建依赖（必须随项目安装）
|
|
15
|
+
|
|
16
|
+
以下 npm 包是模板脚本（`.add/scripts/mcp-server/` 等）的运行时基建，缺失时对应功能**静默降级或直接报错**：
|
|
17
|
+
|
|
18
|
+
| 依赖 | 版本 | 用途 | 缺失后果 |
|
|
19
|
+
|------|------|------|---------|
|
|
20
|
+
| `@huggingface/transformers` | `^3.8.1` | DPS `check_dps` 语义延续性 embedding（`getEmbeddings` 动态 import） | **check_dps 延续性静默降级为 0**（语义分 ×0.6 丢失，不易察觉） |
|
|
21
|
+
| `vector-cosine-similarity` | `^1.8.0` | DPS 余弦相似度计算 | check_dps 直接报错 |
|
|
22
|
+
| `@modelcontextprotocol/server` | `2.0.0` | MCP 服务器运行 | MCP 工具全部不可用 |
|
|
23
|
+
| `zod` | `^4.4.3` | MCP 工具输入 schema（`zod/v4`） | MCP 注册失败 |
|
|
24
|
+
| `dotenv` | `*` | 环境变量加载 | 配置缺失、连接失败 |
|
|
25
|
+
| `@prisma/client` | `^7.0.0` | ADD-7 审计落库（`shared/prisma.ts`） | 审计不可用 |
|
|
26
|
+
| `prisma` | `^7.0.0` | Prisma CLI（generate） | 客户端生成失败 |
|
|
27
|
+
| `smol-toml` | `^1.7.0` | caijuehub TOML 转录（`npm run generate`） | 策略转录失败 |
|
|
28
|
+
| `tsx` | `>=4` | TS 脚本直接执行（sync/转录/benchmark） | 脚本不可运行 |
|
|
29
|
+
|
|
30
|
+
> 以上依赖与 add-coder 包本体 `dependencies` 对齐——**安装 add-coder 包即默认获得全部基建**（`npm i add-coder` 自动安装）。本清单服务于**未安装 add-coder 包、仅同步模板脚本**的消费项目。
|
|
31
|
+
|
|
32
|
+
### 安装命令
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
# 消费项目（未安装 add-coder 包本体）：
|
|
36
|
+
npm i @huggingface/transformers@^3.8.1 vector-cosine-similarity@^1.8.0 \
|
|
37
|
+
@modelcontextprotocol/server@2.0.0 zod@^4.4.3 dotenv \
|
|
38
|
+
@prisma/client@^7.0.0 prisma@^7.0.0 smol-toml@^1.7.0 tsx@>=4
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## 二、已知版本冲突：onnxruntime 解析错位（pnpm overrides）
|
|
44
|
+
|
|
45
|
+
**场景**：升级到新版 `@huggingface/transformers`（^3.8.x，依赖 `onnxruntime-node@1.21.0`）后，若项目同时存在 langchain 生态的 optional 依赖（其声明 `onnxruntime-node/web@1.14.0`），pnpm 会同时解析出 `onnxruntime-common@1.14.0` 与 `1.21.0` 两套——transformers 加载时拿到错位的 `common@1.14.0`，导致 embedding 初始化异常。
|
|
46
|
+
|
|
47
|
+
**症状**：`check_dps` 延续性降级为 0（embedding pipeline 初始化抛错进 catch，现象与模型未下载相同，不易区分）。
|
|
48
|
+
|
|
49
|
+
**解决**：用 pnpm overrides 将 1.14.0 强制替换为 1.21.0。
|
|
50
|
+
|
|
51
|
+
```json
|
|
52
|
+
// package.json
|
|
53
|
+
{
|
|
54
|
+
"pnpm": {
|
|
55
|
+
"overrides": {
|
|
56
|
+
"onnxruntime-node@1.14.0": "1.21.0",
|
|
57
|
+
"onnxruntime-web@1.14.0": "1.21.0",
|
|
58
|
+
"onnxruntime-common@1.14.0": "1.21.0"
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
```yaml
|
|
65
|
+
# pnpm-workspace.yaml（等效，pnpm 9+ 推荐）
|
|
66
|
+
packages:
|
|
67
|
+
- .
|
|
68
|
+
overrides:
|
|
69
|
+
onnxruntime-node@1.14.0: 1.21.0
|
|
70
|
+
onnxruntime-web@1.14.0: 1.21.0
|
|
71
|
+
onnxruntime-common@1.14.0: 1.21.0
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
验证：`pnpm install` 后 `pnpm list onnxruntime-node onnxruntime-common` 应只见 1.21.x，无 1.14.0。
|
|
75
|
+
|
|
76
|
+
---
|
|
77
|
+
|
|
78
|
+
## 三、运行时资源（非基建，可延迟）
|
|
79
|
+
|
|
80
|
+
| 资源 | 获取方式 | 缺失时的行为 |
|
|
81
|
+
|------|---------|-------------|
|
|
82
|
+
| embedding 模型权重（约 90MB） | `add-coder model:download` 预下载；或首次 DPS 调用自动补下载 | check_dps 降级为纯结构分并提示下载入口（**不阻断**） |
|
|
83
|
+
|
|
84
|
+
> 基建依赖缺失 ≠ 运行时资源缺失：前者应通过安装解决（本清单），后者通过 `model:download` 解决。check_dps 的降级提示只针对后者。
|
|
85
|
+
|
|
86
|
+
---
|
|
87
|
+
|
|
88
|
+
## 四、新增依赖的维护规则
|
|
89
|
+
|
|
90
|
+
- 模板脚本引入新的 npm 包时，**必须同步更新本清单**（依赖 / 版本 / 用途 / 缺失后果四列）
|
|
91
|
+
- 版本号与 add-coder 根 `package.json` 保持一致（`dependencies` 是权威来源，本清单是消费项目视图）
|