kixparadigm
Health Warn
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 8 GitHub stars
Code Fail
- exec() — Shell command execution in dsh/preset/plugins/kix-commands.js
- process.env — Environment variable access in dsh/preset/plugins/kix-commands.js
- fs module — File system access in dsh/preset/plugins/kix-commands.js
- process.env — Environment variable access in dsh/preset/plugins/kix-commands.test.js
- fs module — File system access in dsh/preset/plugins/kix-commands.test.js
- exec() — Shell command execution in dsh/preset/plugins/kix-guards.js
- process.env — Environment variable access in dsh/preset/plugins/kix-guards.js
- fs module — File system access in dsh/preset/plugins/kix-guards.js
- os.homedir — User home directory access in dsh/preset/plugins/kix-guards.test.js
- process.env — Environment variable access in dsh/preset/plugins/kix-guards.test.js
- fs module — File system access in dsh/preset/plugins/kix-guards.test.js
- network request — Outbound network request in dsh/preset/plugins/kix-guards.test.js
- network request — Outbound network request in dsh/vision-bridge/client.js
- process.env — Environment variable access in dsh/vision-bridge/index.js
- fs module — File system access in dsh/vision-bridge/index.js
- network request — Outbound network request in dsh/vision-bridge/index.js
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
kixparadigm — AI self-orchestrated minimal paradigm (resident cognition layer) + kixpower multi-agent orchestration · one-command import into DeepSeek Harness (npm i -g) / AI 自编排最小范式(认知层常驻)× kixpower 多智能体编排 · npm 一键导入 DeepSeek Harness
kixparadigm
AI 自编排最小范式(认知层常驻)× 多智能体编排 × 编码 Agent 预设 — 一个仓库装下 kix 全家桶,
npm一键导入 DeepSeek Harness,脚本导入 VS Code Copilot。
🌍 English: README.en.md · 中文: 本文件
🧭 为什么会有这个仓库:kix × DSH 的适配研究
kix 范式最初是 VS Code Copilot 定制包:常驻认知指令、17 个技能、6 个团队 Agent、5 个 slash 命令、机械门禁 hooks、方法论记忆——一套在 Copilot 生态里打磨出来的 AI 自编排体系。
后来我们研究了 DeepSeek Harness(DSH),发现两者是天然适配的——不是移植,而是"机制对上机制":
| kix 机制 | DSH 原生载体 | 适配结论 |
|---|---|---|
| 常驻认知指令(怎么思考) | preset persona(每次会话自动生效) | ✅ 直接等价 |
| PreToolUse 机械门禁 hooks(blast-radius / 源码保护 / 危险 git) | 自研 kix-guards 插件(tools/pre-execute 监听器)+ host sandbox/approval 栈 |
✅ 更强的门禁宿主 |
/kixpower-* slash 命令 |
自研 kix-commands 插件(DSH 原生命令,零 token 触发) |
✅ 命令即入口 |
| 团队 Agent(Producer/Dev/QA/Reviewer) | DSH subagent 分派(角色 prompt 模板) | ✅ 编排直接落地 |
| 技能体系(skills) | DSH skills(preset 内 customSkillDirs) | ✅ 原样挂载 |
| memory-tool 方法论记忆 | DSH memories/(persona 指引按需读取) | ✅ 原样挂载 |
| 跨厂商模型验证(kix 核心信念之一) | DSH llm-pi-ai providers + subagent_vision 视觉子代理 |
✅ 原生支持 |
| 无视觉主模型的识图补足 | 自研 dsh-vision-bridge 插件(GLM-4.6V 自动转描述) |
✅ UI 无缝 |
研究结论记录在 dsh/preset/DSH-ADAPTATION.md(权威机制映射)。这套适配带来了一个现实收益:kix 范式从"一个人本机的 Copilot 定制"变成了"一条命令可复现的公开资产"——这就是本仓库开源的契机:让任何 DSH 环境都能一键获得完整的 kix 认知层 + 执行层 + 门禁 + 识图补足。
🚀 快速开始(DSH,推荐)
方式一:npm 一键导入(npm i -g 自动完成全部安装)
npm i -g kixparadigm
安装过程自动完成:
- preset →
~/.dsh/.agent-presets/kixparadigm/(完整 preset:persona 认知层 + 17 技能 + 6 角色 + 5 命令 + 门禁/命令插件 + 6 记忆) - vision-bridge →
~/.dsh/profiles/web/plugins/dsh-vision-bridge/(自动建 junction、登记cordis.patch.yml挂载条目) - 检查清单:
settings.yaml缺zai-vision/zai-coding-cnprovider 时会提示(按DSH-ADAPTATION.md补齐)
然后重启 dsh web(Ctrl+C → dsh web),新会话模式列表里选择 kixparadigm 即可。
自定义 DSH 目录:
DSH_HOME=/path/to/dsh npm i -g kixparadigm(默认~/.dsh)
不想装 vision-bridge:kixparadigm install --preset-only
方式二:npx(不全局安装)
npx kixparadigm install
🌍 English edition
The resident cognition layer (persona / core instructions / glossary / main-entry agent) is fully translated — see the canonical terminology table in en/preset/instructions/glossary.md:
npm i -g kixparadigm-en # installs the kixparadigm-en preset (mode picker: kixparadigm-en)
kixparadigm-en doctor # self-check
Deep-mechanism docs (skills / prompts / memories / team roles) are still the Chinese originals while translation progresses — status tracked in en/preset/TRANSLATION-STATUS.md. Source of the EN edition: the en/ directory (npm package root) + en/preset/ (EN preset source of truth).
常用运维命令
kixparadigm doctor # 自检:preset/链接/挂载条目/插件单元回归
kixparadigm uninstall # 卸载全部安装内容
kixparadigm copilot # (可选)同时导入 VS Code Copilot 侧
🚀 快速开始(VS Code Copilot)
# Windows
.\install.ps1
# macOS / Linux
chmod +x install.sh && ./install.sh
详细说明见 INSTALL.md。装完重载窗口,/ 输入 /kixpower-new / /kixpower-import / /kixpower-continue / /kixpower-review。
📦 这是什么:两层结构
kix 体系分两层,本仓库把两层 + 生态依赖一次性装齐:
| 层 | 组件 | 作用 |
|---|---|---|
| 认知层(怎么思考) | kixparadigm |
常驻认知范式:三通道交叉验证、阶段二相性、规则是负债、需求三检(不迎合用户)、写码前决策链、AI 盲点补足。每个会话自动生效 |
| 执行层(怎么执行) | kixpower |
多智能体协作编排:Producer 规划 → Dev 实现 → QA 验证,Sprint 化、DAG 拓扑、4 层 loop、可验证 gate |
| 生态辅助 | handoff / write-a-skill / improve-codebase-architecture 等 17 技能 |
会话交接、技能创建、架构改进、TDD/教学/排查等通用方法论 |
| 机械门禁 | kix-guards 插件 |
commit budget、feature branch、force push、危险 SQL、控制面文件保护、人类确认点(128 组断言) |
| 原生命令 | kix-commands 插件 |
/kixpower-* 五命令注册为 DSH 原生命令(零 token 触发,读 prompts/ 注入流程) |
| 识图补足 | dsh-vision-bridge 插件 |
主模型无视觉时,粘贴/拖入图片自动转文本描述再提交(GLM-4.6V,服务端 HTTP + client dock) |
关系一句话:kixparadigm 给 AI「怎么思考」的自由度与盲点补足,kixpower 给「怎么执行」的结构化团队编排,门禁与识图插件把 DSH 变成 kix 的完整宿主。
📂 仓库结构
kixparadigm/
├── package.json ← npm 打包(postinstall 自动安装,bin 提供 CLI)
├── bin/kixparadigm.js ← CLI:install / uninstall / doctor / copilot
├── scripts/
│ ├── install-lib.js ← 跨平台安装器(preset + vision-bridge 挂载)
│ ├── sync-dsh-preset.ps1 ← 日常开发:镜像 dsh/preset → ~/.dsh(单向)
│ ├── ensure-vision-bridge.ps1 ← vision-bridge 自检/自愈
│ └── verify-*.js / .cjs ← 门禁与加载链验证
│
├── dsh/ ← DSH 侧(唯一事实源)
│ ├── preset/ ← → ~/.dsh/.agent-presets/kixparadigm/ 的镜像
│ │ ├── agent.cordis.yml ← 组成(persona 常驻认知层 + 全部能力行)
│ │ ├── preset.yml ← roster 显示元数据
│ │ ├── DSH-ADAPTATION.md ← 权威机制映射(工具名/门禁/编排/vision)
│ │ ├── skills/ agents/ prompts/ instructions/ memories/
│ │ └── plugins/ ← kix-guards.js + kix-commands.js + 测试
│ ├── vision-bridge/ ← dsh-vision-bridge 插件源码(client + server + package.json)
│ └── README-DSH.md ← DSH 部署说明
│
├── skills/ agents/ prompts/ memories/ instructions/ ← VS Code Copilot 分发版(原样保留)
├── plugins/ ← Copilot 侧 kix-guards 原件
├── install.ps1 / install.sh / INSTALL.md ← Copilot 安装脚本
├── vision-bench/ ← 识图链路基准资产(A/B 测速)
└── README.md LICENSE .gitignore
唯一事实源约定:
dsh/preset/是 DSH preset 的事实源;~/.dsh/.agent-presets/kixparadigm/只是安装副本。维护 preset = 改dsh/preset/再跑scripts/sync-dsh-preset.ps1 -Force。根目录skills/等是 Copilot 分发版,与 DSH 版刻意不同,不要互相覆盖。
🧪 开发与验证
npm test # 门禁 128 断言 + 命令 6 断言
node scripts/verify-guards.js # 已安装 preset 与 bundle 门禁对照
node scripts/verify-vision-bridge-resolution.cjs # vision-bridge 加载链全链路
pwsh -File .\scripts\sync-dsh-preset.ps1 -DryRun # 预览 preset 差异
kixparadigm doctor # 安装状态自检
preset 挂载校验(roster standingKeyFor)在 DSH 会话内用 cordis 工具集执行。
📢 发布
npm login # 首次
npm test && npm pack --dry-run # 发布前自检
npm publish # 发布(npm i -g kixparadigm 即一键导入)
📄 License
MIT © 2026 kixparadigm contributors
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found