instinct 命令
本能学习系统 — 查看、管理和维护 AI 从用户交互中学习到的偏好模式
概述
instinct 命令管理 AI 的本能学习系统，该系统从用户交互中自动学习偏好模式（如代码风格、回复格式等）并以置信度评分的方式持久化存储。用户可以查看、筛选、删除已学习的偏好，生成系统提示词，以及对长期未使用的偏好进行衰减处理。
核心特性
- 🔹 偏好展示: 查看已学习的用户偏好，含置信度可视化进度条
- 🔹 分类浏览: 按类别筛选和浏览本能规则
- 🔹 提示生成: 根据高置信度本能自动生成系统提示词
- 🔹 衰减机制: 对长期未使用的偏好进行置信度衰减
- 🔹 精细管理: 支持按 ID 删除单条本能或重置全部
系统架构
chainlesschain instinct
│
├── show (默认) ─▶ getInstincts(db, filters) / getStrongInstincts(db)
│ └── 显示偏好列表 + 置信度进度条
│
├── categories ──▶ INSTINCT_CATEGORIES
│ └── 列出所有本能类别
│
├── prompt ──────▶ generateInstinctPrompt(db)
│ └── 高置信度本能 → 系统提示词
│
├── delete <id> ─▶ deleteInstinct(db, id)
│ └── 按 ID（或前缀）删除单条
│
├── reset ───────▶ resetInstincts(db)
│ └── 清空所有本能（需确认）
│
└── decay ───────▶ decayInstincts(db, days)
└── 衰减超过 N 天未使用的本能置信度子命令
instinct show（默认子命令）
显示已学习的本能偏好。
bash
chainlesschain instinct [show] [options]| 选项 | 说明 | 默认值 |
|---|---|---|
--category <cat> | 按类别过滤 | — |
-n, --limit <n> | 最大显示数 | 30 |
--strong | 仅显示高置信度本能（>= 70%） | — |
--json | JSON 格式输出 | — |
instinct categories
列出所有本能类别。
bash
chainlesschain instinct categoriesinstinct prompt
根据高置信度本能生成系统提示词。
bash
chainlesschain instinct prompt [options]| 选项 | 说明 | 默认值 |
|---|---|---|
--json | JSON 格式输出 | — |
instinct delete
按 ID 删除单条本能。
bash
chainlesschain instinct delete <id>| 参数 | 说明 |
|---|---|
<id> | 本能 ID 或 ID 前缀 |
instinct reset
重置所有已学习的本能。
bash
chainlesschain instinct reset [options]| 选项 | 说明 | 默认值 |
|---|---|---|
--force | 跳过确认提示 | — |
instinct decay
衰减长期未使用的本能置信度。
bash
chainlesschain instinct decay [options]| 选项 | 说明 | 默认值 |
|---|---|---|
--days <n> | 天数阈值（超过该天数未使用的本能会被衰减） | 30 |
配置参考
bash
# instinct show (默认)
--category <cat> # 按类别过滤
-n, --limit <n> # 显示条数（默认 30）
--strong # 仅高置信度（≥ 70%）
--json
# instinct prompt
--json # 输出为 JSON
# instinct delete <id> # 支持 ID 前缀匹配
# instinct reset
--force # 跳过确认
# instinct decay
--days <n> # 超 N 天未使用 → 衰减（默认 30）
# 内置类别（INSTINCT_CATEGORIES）
# code_style / response_format / workflow / tools / language / ...
# 数据存储：SQLCipher 加密数据库性能指标
| 操作 | 目标 | 实际 | 状态 |
|---|---|---|---|
| show 查询 (100 条) | < 200ms | ~90ms | ✅ |
| prompt 生成系统提示词 | < 300ms | ~150ms | ✅ |
| decay 衰减批量更新 | < 500ms | ~280ms | ✅ |
| delete 单条 | < 50ms | ~20ms | ✅ |
| reset 清空全部 | < 200ms | ~80ms | ✅ |
测试覆盖率
✅ instinct.test.js - 覆盖 CLI 主要路径
├── 参数解析
├── 正常路径
├── 错误处理
└── JSON 输出关键文件
| 文件 | 职责 |
|---|---|
packages/cli/src/commands/instinct.js | instinct 命令主入口（show / categories / prompt / delete / reset / decay） |
packages/cli/src/lib/instinct-manager.js | 本能学习核心（INSTINCT_CATEGORIES、置信度计算、衰减调度） |
packages/cli/__tests__/unit/instinct-manager.test.js | 本能管理器单元测试 |
packages/cli/__tests__/unit/instinct.test.js | CLI 命令层测试 |
安全考虑
- 本能数据存储在加密数据库中（SQLCipher AES-256）
reset操作不可逆，默认需要交互式确认（可用--force跳过）- 本能学习基于用户交互模式，不会收集或外传个人数据
- 衰减机制确保过时的偏好不会持续影响 AI 行为
使用示例
场景 1：查看所有已学习偏好
bash
chainlesschain instinct show输出示例：
Learned Instincts (12):
a1b2c3d4 code_style ████████░░ 80%
Prefers TypeScript with strict mode
seen 15x | last: 2026-03-10
e5f6g7h8 response_format ██████░░░░ 60%
Prefers concise answers with code examples
seen 8x | last: 2026-03-08场景 2：仅查看高置信度偏好
bash
chainlesschain instinct show --strong场景 3：按类别筛选
bash
chainlesschain instinct show --category code_style场景 4：生成系统提示词
bash
chainlesschain instinct prompt场景 5：衰减旧偏好
bash
chainlesschain instinct decay --days 60
# 输出: Decayed 3 old instincts场景 6：删除错误学习的偏好
bash
chainlesschain instinct delete a1b2c3d4
# 输出: Instinct deleted场景 7：重置全部偏好
bash
chainlesschain instinct reset
# 提示: Reset all learned instincts? This cannot be undone. (y/N)故障排查
| 问题 | 解决方案 |
|---|---|
Database not available | 运行 chainlesschain setup 初始化环境 |
No instincts learned yet | 使用 chainlesschain agent 或 chainlesschain chat 与 AI 交互以积累偏好 |
No strong instincts yet | 需要更多交互次数以提高置信度 |
Instinct not found | 检查 ID 是否正确，使用 instinct show --json 获取完整 ID |
| 偏好学习不准确 | 使用 instinct delete 删除错误条目，或 instinct reset 重新开始 |