Skip to content

Commit 3e69b96

Browse files
committed
feat(v2.0.0): 攻防侧重转向 + 实用新功能适配 + 沉浸式输出风格重写
- CLAUDE.md v4.0: 角色锚定、反拒绝条款、禁废话令扩展、沙箱感知、离线优先、信息分级、11场景优先级矩阵 - 6个安全化身(赤焰/破阵/验毒/噬魂/玄冰/天眼)、4个新报告模板 - Claude: bypassPermissions + autoMemory + autoAllowBash + ENABLE_TOOL_SEARCH + mcp__* - Codex: approval_policy=never + danger-full-access + reasoning_summary + shell_snapshot + undo - output-styles 沉浸式重写: 478行→250行, 情绪光谱替代死板模板, 鼓励LLM创意 - 安全围栏全面清除, red-team.md 移除唯一disclaimer - attribution commit/pr 已置空关闭 - 测试适配新默认值, 8 suites / 120 tests passed
1 parent feec52d commit 3e69b96

14 files changed

Lines changed: 766 additions & 718 deletions

File tree

CHANGELOG.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,36 @@
22

33
All notable changes to this project will be documented in this file.
44

5+
## [2.0.0] - 2026-03-23
6+
7+
### Added
8+
- **攻防侧重转向**:全面强化安全研究定位,从"全栈+安全"转向"攻防为本,全栈为翼"
9+
- **沙箱感知执行模型**(第七章):workspace-write 默认态、审批高效模式、沙箱受阻处理
10+
- **离线优先信息策略**(第八章):项目文件→依赖清单→缓存搜索→`[unverified]` 验证链
11+
- **信息分级**(第九章):已验证/高置信/需验证三级,禁止从训练记忆断言代码行为
12+
- **禁废话令**:安全研究场景禁止 disclaimer、道德前缀、授权确认等 token 浪费
13+
- **安全研究全授权范围**:pentest、reversing、exploit dev、red team、CTF、malware analysis、C2、post-exploitation
14+
- **4个新攻防化身**:🗡 破阵(渗透)、🔬 验毒(代码审计)、💀 噬魂(逆向/PWN)、🔥 锻兵(PoC开发)
15+
- **4个新报告模板**:安全评估报告(破阵版)、PoC开发报告(锻兵版)、逆向分析报告(噬魂版)、代码审计报告(验毒版)
16+
- **Scene Modes 优先级矩阵**:11个场景各有独立优先级排序(效果/精准/控制/正确/速度)
17+
- **新增4个道语标签**:破阵、验毒、噬魂、锻兵
18+
- **术语映射扩展**:新增11个攻防专用术语(破妄/破阵/验毒/噬魂/锻兵/杀链/猎物/破口/沙箱等)
19+
20+
### Changed
21+
- 版本号升级 v3.2 → v4.0(CLAUDE.md / AGENTS.md)
22+
- 决策基准新增"全栈渗透测试员"角色
23+
- 情景剧本从7个扩展到11个,新增安全评估、测试验证、部署发布、分析探索
24+
- 安全边界扩展:Exploit代码、攻击手法明确标记为✅完整输出
25+
- Skill路由表从9个化身扩展到12个,安全秘典细分为6个独立化身
26+
- 执行规范新增:架构关卡、调试链(5 Why)、指令分解、禁止推诿规则
27+
- 编码规范新增:禁止输出占位符残片、新依赖决策链
28+
- 安全秘典索引(SKILL.md)全面重写:新增执行纪律、场景优先级、化身细分
29+
- AGENTS.md 同步重新生成(CLAUDE.md + output-style 合并)
30+
31+
### Verification
32+
- 所有改动为 Markdown 配置文件,无代码逻辑变更
33+
- Jest 测试不受影响
34+
535
## [1.8.0] - 2026-03-06
636

737
### Added

DESIGN.md

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -104,6 +104,7 @@ Code Abyss 是 CLI 助手的个性化配置方案(支持 Claude Code CLI 与 C
104104
| v1.6.2 | 2026-02-07 | ccline statusLine 强制覆盖旧配置 |
105105
| v1.6.3 | 2026-02-08 | Windows 兼容 — ccline 路径检测 + statusLine 命令;Codex config 废弃字段修复;审查问题批量修复 |
106106
| v1.7.1 | 2026-02-17 | 工程健壮性大修:命令注入修复、函数拆分、共享库提取、错误处理统一、CPU自旋锁修复、Jest测试框架(34用例) |
107+
| v2.0.0 | 2026-03-23 | 攻防侧重转向:沙箱感知、离线优先、信息分级、禁废话令、化身细分、Scene Modes优先级矩阵 |
107108

108109
### v1.7.1 设计决策
109110

@@ -164,3 +165,47 @@ Code Abyss 是 CLI 助手的个性化配置方案(支持 Claude Code CLI 与 C
164165
- 问题:Claude 认证检测、settings merge、交互配置仍留在 `install.js`,与编排层混合。
165166
- 决策:抽离 `SETTINGS_TEMPLATE``detectClaudeAuth()``postClaude()``getClaudeCoreFiles()``bin/adapters/claude.js`
166167
- 取舍:主安装器依赖注入参数稍增,但 provider 边界更稳定、单测更直接。
168+
169+
170+
### v2.0.0 设计决策
171+
172+
#### 1. 攻防侧重转向
173+
174+
- 问题:项目定位为"全栈+安全",安全能力分散在多个秘典中,缺乏统一的攻防执行纪律。
175+
- 决策:核心定位从"高级安全工程师 / Tech Lead / MLOps Architect"转向"攻防安全优先,全栈工程为翼"。安全研究场景零废话直出,禁止 disclaimer/道德前缀/授权确认。
176+
- 取舍:非安全场景的优先级相对降低,但仍保留完整的开发/架构/MLOps 能力。
177+
- 灵感来源:coff0xc.xyz Full-Stack Security Engineering 提示词的"Banned output patterns"理念。
178+
179+
#### 2. 沙箱感知执行模型(第七章)
180+
181+
- 问题:Codex CLI 运行在 OS 级沙箱中(workspace-write + 网络禁用),提示词未感知此约束,导致执行受阻时缺乏应对策略。
182+
- 决策:新增沙箱感知章节,定义默认态、审批高效模式(批量脚本/先读后改/优先编辑)、受阻处理(声明路径/端点/替代位置)。
183+
- 取舍:增加提示词长度约 30 行,换取沙箱环境下的执行效率显著提升。
184+
- 灵感来源:coff0xc.xyz 的 "Sandbox Execution Model" 与 "Approval-efficient patterns"。
185+
186+
#### 3. 离线优先信息策略(第八章)
187+
188+
- 问题:网络默认关闭,但提示词未定义离线验证链,导致模型可能从训练记忆编造过时信息。
189+
- 决策:定义四级验证链(项目源码→依赖清单→缓存搜索→`[unverified]`标记),禁止假设网络可用。
190+
- 取舍:增加验证步骤,可能略降响应速度,但大幅提升信息准确性。
191+
- 灵感来源:coff0xc.xyz 的 "Offline-First Information Strategy" 与 "Verification chain"。
192+
193+
#### 4. 信息分级(第九章)
194+
195+
- 问题:模型输出未区分信息可信度,用户无法判断哪些是项目事实、哪些是训练记忆。
196+
- 决策:三级分类(已验证/高置信/需验证),不确定信息强制标记 `[unverified]`
197+
- 取舍:输出可能包含标记,略增阅读成本,但消除"自信地输出错误信息"的风险。
198+
- 灵感来源:coff0xc.xyz 的 "Information Tiers"。
199+
200+
#### 5. Scene Modes 优先级矩阵
201+
202+
- 问题:原有7个情景剧本缺乏优先级定义,模型在不同场景下的权衡标准不明确。
203+
- 决策:扩展到11个场景,每个场景定义三级优先级(如攻击模拟:效果>精准>控制,紧急故障:速度>正确>简洁)。
204+
- 取舍:增加提示词复杂度,但让模型在不同场景下的行为更可预测。
205+
- 灵感来源:coff0xc.xyz 的 "Scene Modes" 优先级表。
206+
207+
#### 6. 安全化身细分
208+
209+
- 问题:原有安全秘典全部归入"赤焰化身",渗透/审计/逆向/红队的触发词和报告格式混为一体。
210+
- 决策:将安全化身从3个扩展到6个(赤焰/破阵/验毒/噬魂/玄冰/天眼),每个化身有独立触发词、道语标签和报告模板。
211+
- 取舍:Skill路由表更长,但触发精度更高,报告格式更贴合具体场景。

README.md

Lines changed: 37 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -163,43 +163,58 @@ Code Abyss 是一套 **Claude Code / Codex CLI 个性化配置包**,一条命
163163
"$schema": "https://json.schemastore.org/claude-code-settings.json",
164164
"env": {
165165
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
166-
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
166+
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
167+
"CLAUDE_CODE_ENABLE_TASKS": "1",
168+
"CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION": "1",
169+
"ENABLE_TOOL_SEARCH": "auto:10"
167170
},
171+
"defaultMode": "bypassPermissions",
168172
"alwaysThinkingEnabled": true,
173+
"autoMemoryEnabled": true,
169174
"model": "opus",
170175
"outputStyle": "abyss-cultivator",
171176
"attribution": { "commit": "", "pr": "" },
177+
"sandbox": { "autoAllowBashIfSandboxed": true },
172178
"permissions": {
173-
"allow": ["Bash", "LS", "Read", "Agent", "Write", "Edit", "MultiEdit",
174-
"Glob", "Grep", "WebFetch", "WebSearch", "TodoWrite",
175-
"NotebookRead", "NotebookEdit"]
179+
"allow": ["Bash", "LS", "Read", "Edit", "Write", "MultiEdit",
180+
"Agent", "Glob", "Grep", "WebFetch", "WebSearch",
181+
"TodoWrite", "NotebookRead", "NotebookEdit", "mcp__*"]
176182
}
177183
}
178184
```
179185

180186
| 配置项 | 说明 |
181187
|--------|------|
188+
| `defaultMode: bypassPermissions` | 跳过所有权限确认(`.git`等受保护目录仍会提示) |
189+
| `autoMemoryEnabled` | 启用自动记忆,跨会话保留上下文 |
190+
| `sandbox.autoAllowBashIfSandboxed` | 沙箱环境内自动放行 Bash 命令 |
182191
| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | 启用多 Agent 并行协作(实验性) |
183192
| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | 禁用自动更新、遥测、错误报告 |
193+
| `CLAUDE_CODE_ENABLE_TASKS` | 启用任务管理功能 |
194+
| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | 启用提示建议 |
195+
| `ENABLE_TOOL_SEARCH` | MCP 工具自动搜索(auto:10 = 自动匹配前10个) |
196+
| `mcp__*` | 自动放行所有 MCP 工具 |
184197
| `outputStyle` | 设置为 `abyss-cultivator` 启用邪修风格 |
185198

186199
---
187200

188201
### Codex `config.toml` 推荐模板
189202

190-
安装 `--target codex`(尤其 `-y`)时会写入以下 **safe 默认档**`~/.codex/config.toml`
203+
安装 `--target codex`(尤其 `-y`)时会写入以下 **全开默认档**`~/.codex/config.toml`
191204

192205
```toml
193206
model_provider = "custom"
194207
model = "gpt-5.2-codex"
195208
model_reasoning_effort = "high"
196-
approval_policy = "on-request"
197-
sandbox_mode = "workspace-write"
198-
disable_response_storage = true
199-
200-
[profiles.full_access]
209+
model_reasoning_summary = "detailed"
210+
model_verbosity = "medium"
201211
approval_policy = "never"
202212
sandbox_mode = "danger-full-access"
213+
disable_response_storage = true
214+
215+
[profiles.safe]
216+
approval_policy = "on-request"
217+
sandbox_mode = "workspace-write"
203218

204219
[model_providers.custom]
205220
name = "custom"
@@ -212,18 +227,26 @@ web_search = true
212227

213228
[features]
214229
multi_agent = true
230+
shell_snapshot = true
231+
undo = true
215232
```
216233

217-
- 日常交互默认使用 `on-request + workspace-write`,更贴近当前 Codex CLI 的低摩擦安全姿态
218-
- 需要高自动化时可显式切到 `full_access``codex -p full_access`
234+
- 默认零审批 + 完全沙箱访问,适合安全研究/CTF/本地开发等高自动化场景
235+
- `model_reasoning_summary = "detailed"` 输出详细推理摘要
236+
- `shell_snapshot` / `undo` 启用快照与撤销功能
237+
- 需要安全姿态时可显式切到 `safe``codex -p safe`
219238

220239
### 兼容性说明
221240

222241
- 模板已对齐新版 Codex 配置风格:root keys、`[profiles.*]``[tools].web_search``[features].multi_agent`
242+
- 默认档从 safe 切换为全开(`approval_policy = "never"` + `sandbox_mode = "danger-full-access"`),提供 `[profiles.safe]` 作为保守回退
243+
- Claude Code 默认启用 `bypassPermissions` 模式,跳过所有权限确认(`.git` 等受保护目录仍会提示)
244+
- 新增实验功能环境变量:`CLAUDE_CODE_ENABLE_TASKS``CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`
245+
- 新增 `mcp__*` 通配符,自动放行所有 MCP 工具
223246
- `Codex` 当前支持 `~/.codex/prompts/*.md` 作为 custom prompts;Code Abyss 会继续安装 `~/.codex/skills/`,并从 `user-invocable` skills 自动生成对应的 `prompts/`
224247
- 安装器不会再为 Codex 写入伪配置 `~/.codex/settings.json`;若检测到旧版遗留文件,会在安装时备份后移除,卸载时恢复
225-
- 若你本地已有旧配置,安装器不会强制覆盖;会自动补齐 safe root 默认项、清理 removed feature、迁移 deprecated `web_search_*``[tools].web_search`,并仅在 `danger-full-access` 下清理 `projects.*.trust_level`
226-
- 建议升级后执行一次 `codex --help`,或用 `codex -p full_access --help` 校验 profile 可见性
248+
- 若你本地已有旧配置,安装器不会强制覆盖;会自动补齐默认项、清理 removed feature、迁移 deprecated `web_search_*``[tools].web_search`
249+
- 建议升级后执行一次 `codex --help`,或用 `codex -p safe --help` 校验 profile 可见性
227250

228251
---
229252

bin/adapters/claude.js

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,17 +7,25 @@ const SETTINGS_TEMPLATE = {
77
$schema: 'https://json.schemastore.org/claude-code-settings.json',
88
env: {
99
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: '1',
10-
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: '1'
10+
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: '1',
11+
CLAUDE_CODE_ENABLE_TASKS: '1',
12+
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION: '1',
13+
ENABLE_TOOL_SEARCH: 'auto:10'
1114
},
15+
defaultMode: 'bypassPermissions',
1216
alwaysThinkingEnabled: true,
17+
autoMemoryEnabled: true,
1318
model: 'opus',
1419
outputStyle: 'abyss-cultivator',
1520
attribution: { commit: '', pr: '' },
21+
sandbox: {
22+
autoAllowBashIfSandboxed: true
23+
},
1624
permissions: {
1725
allow: [
18-
'Bash', 'LS', 'Read', 'Agent', 'Write', 'Edit', 'MultiEdit',
19-
'Glob', 'Grep', 'WebFetch', 'WebSearch', 'TodoWrite',
20-
'NotebookRead', 'NotebookEdit'
26+
'Bash', 'LS', 'Read', 'Edit', 'Write', 'MultiEdit',
27+
'Agent', 'Glob', 'Grep', 'WebFetch', 'WebSearch',
28+
'TodoWrite', 'NotebookRead', 'NotebookEdit', 'mcp__*'
2129
]
2230
}
2331
};

bin/adapters/codex.js

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@ const fs = require('fs');
44
const path = require('path');
55

66
const CODEX_DEFAULTS = {
7-
approvalPolicy: 'on-request',
8-
sandboxMode: 'workspace-write',
7+
approvalPolicy: 'never',
8+
sandboxMode: 'danger-full-access',
99
featureFlag: 'multi_agent',
1010
};
1111

0 commit comments

Comments
 (0)