AI4XE/Parallax
AI4XE/Parallax has 136 GitHub stars and 0 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-19 07:55 UTC. Last push 2026-11-17.
实测星标增长
- 24小时
- 0
- 7天
- 正在收集历史
- 15天
- 正在收集历史
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
A lightweight workflow plugin for hands-off AI coding with DeepSeek Harness, Claude Code, GitHub Copilot, and more.
开发工具README.zh-CN.md
原文Parallax 是编码智能体 Harness 之上的一层轻量增强。你负责目标,智能体负责干活、上下文管理和独立验收。
安装 Parallax 后,体验更省心的「许愿创造」模式。说想做什么,做几个选择题,然后放手——智能体团队在独立审查和干净会话下把活干完,独立对账,最后干净提交。
三个安装徽章都跳转到本 README 的安装章节,不是一键安装。
三步
插件触发词:
wish·Parallax·qstart·许愿创造·许愿编程
- 许愿 —— 随口说你想做什么,不用想清楚。可以分多次说,说完发一句「没有了」。
- 做选择题 —— 智能体先调研,再和你一次一问地对齐;你只拍板。
- 放手 —— 其余交给智能体团队:方案 → 独立审查 → 新会话执行 → 独立对账 → scoped 提交 → 收尾。
两种模式
- solo(默认):你直接面对执行会话,当前会话就是执行者,适合日常使用。
- team:你的对话始终与编排者进行,执行者在独立会话中运行,适合大型和超长任务。
上下文自动管理
- 任务开始:计划通过审查后,自动新会话执行。
- 长程任务(team 档):默认在上下文约 60% 时自动交接,保持 AI 头脑清醒,任务不中断。
https://github.com/user-attachments/assets/6dd03b96-7a3a-44d4-85a4-78c70508a4c0
支持平台
- Claude Code —— Linux ✓ · Windows(WSL)✓ · macOS ?
- DeepSeek Harness —— Linux ✓ · Windows ✓ · macOS ?
- GitHub Copilot (VS Code) —— Windows ✓ · Linux ? · macOS ?。目前暂时只支持 solo 档。
? 表示代码按兼容性/移植性编写,但未实际测试;发现问题欢迎提 issue。
安装
Claude Code
以下任选一种方式即可——技能就是 platforms/claude-code/skills/ 下的普通文件夹:
- 方式一:安装脚本(推荐):
把七个技能装进git clone https://github.com/AI4XE/Parallax.git bash Parallax/install.sh /path/to/your-project<project>/.claude/skills/,原子交换,升级/重装时保留本地*.conf修改。 - 方式二:手动拷贝:把
platforms/claude-code/skills/下各文件夹拷入<your-project>/.claude/skills/。无需安装脚本即可工作;以后再手动拷贝会覆盖本地*.conf修改。 - 方式三:Claude Code 插件市场:
/plugin marketplace add AI4XE/Parallax,然后/plugin install parallax。斜杠命令带命名空间(/parallax:qstart);自然语言触发(说「qstart」)照样可用。该路径已在仓库内做结构校验(插件清单、技能路径、市场技能列表),但未对远端市场做端到端实测。
然后在那个项目里打开 Claude Code,只需说:qstart(或 wish / Parallax)。
权限:team 档会启动一个独立的 headless 执行者进程。请使用你原本就信任的自主执行权限档;Parallax 不会自行提升权限,也绝不把「放手」当成权限批准。
建议:在 tmux 中运行 Claude Code 并配合插件使用最兼容;也可用 cc-connect 等工具把会话接入聊天软件,方便远程跟进。
DeepSeek Harness
以下任选一种方式即可:
- 方式一:插件 bundle(首选——一条命令、零拷贝、升级重跑即可):
要求 dsh 自带的 Node,且git clone https://github.com/AI4XE/Parallax.git node Parallax/platforms/deepseek-harness/bundle/build.mjs dsh plugin --profile <profile> add "file:<Parallax 绝对路径>/platforms/deepseek-harness/bundle"dsh进程 PATH 上能找到 pnpm(如经 corepack 提供)。Windows 可原生执行上述两条命令,含空格路径须加引号。卸载:dsh plugin --profile <profile> remove parallax-dsh;安装更新后重启所选 profile 加载新版。装完零额外设置:bundle 注册技能与原生交接 hook,自带subagent.maxDepth: 3;交接不要求编辑规则、profile、patch 或权限配置。 - 方式二:安装脚本(skills 兜底):
bash install.sh --platform deepseek-harness <你的项目目录>—— 把七个技能拷进<project>/.agents/skills/(原子交换,保留本地*.conf)。DSH 按目录扫描发现(热加载,无需重启)。此形态仅有技能文字,不等价于完整 bundle:没有原生交接 hook 或深度 patch,完整qgo交接链不支持。 - 方式三:手动拷贝:把
platforms/deepseek-harness/skills/下各文件夹拷入<your-project>/.agents/skills/。
使用普通 workspace-write 权限,不用 bypass/full access。使用普通 shell:会拦截 named-pipe 捕获的受限环境无法运行部分子进程工具。
然后在以你的项目为工作目录的 DSH 会话里,只需说:qstart(或 wish / Parallax)。
构建安全:
build.mjs为跨平台单源,build.sh仅为便捷包装。只复制显式技能资源,用经校验的 manifest 保护生成文件;未知文件、链接或被改动的受管输出会中止构建,不会被删除。
Copilot
以下任选一种方式即可:
- 方式一:安装脚本(推荐):
git clone https://github.com/AI4XE/Parallax.git bash Parallax/install.sh --platform copilot /path/to/your-project - 方式二:手动拷贝:把
platforms/copilot/skills/*拷入<your-project>/.github/skills/,把platforms/copilot/agents/*与platforms/copilot/instructions/copilot-instructions.md拷入对应.github/目录。已有copilot-instructions.md时不要覆盖,请合并。
然后在 VS Code 里打开那个文件夹:
- 执行一次 Developer: Reload Window(技能与 agent 在 reload 时被发现)。
- 首次提示时信任 workspace 一次(按文件夹记住)。
- 建议:把聊天权限档设为 Allow all(或 Autopilot)——设置键
chat.defaultConfiguration——跨会话交接与子代理审查即零确认全自动。默认 Manual 档也能用,只是每种工具每会话首次要批一次。
之后只需说:qstart(或 wish / Parallax)。
技能
七个技能,把「帮我做个东西」变成一条有人监督、自我审查的循环流水线:
| 技能 | 角色 |
|---|---|
| qstart | 讨论入口:需求 → 调研 → 一次一问对齐 → 完整总览。 |
| qgo | 放手执行:复核讨论、写方案、过 bcheck 门禁(评分 ≥ 4/5),然后干净上下文的 agent 自主执行 → rcheck 对账 → scoped 提交。 |
| bcheck | 执行前的独立对抗审查。干活的人不给自己批作业。 |
| gclear | 落盘精炼交接内容,交给干净模型上下文并验证投递;具体机制由各平台适配。 |
| rcheck | 执行后的独立对账审查:每条「已完成」都要对着实际结果核一遍。 |
| xwrap | 收尾:明显问题报告、todo 更新、wrapup 文档、智能 scoped git 提交。 |
| wish | 一句话许愿入口,转发 qstart。 |
一行话:qstart(对齐愿望)→ qgo(放手;方案过 bcheck 门 → 干净上下文执行 → rcheck 对账 → 提交)→ xwrap(收尾)。
两条执行档位:solo 为默认(交接后一个 agent 干到底);说 team 加一个编排者照看独立执行者。ver / nover 选择版本任务与非版本任务。
各 harness 上的交接方式:
- Claude Code:
gclear驱动/clear并对着会话 transcript 验证注入;team 档在独立进程中运行 headless stream-json 执行者,由套件自带的驱动拉起与守护。下文的 CLItmux依赖仍然适用于gclear的分离式启动器。 - DeepSeek Harness:完整 bundle 提供
parallax_handoff,在原生安全点用精炼交接替换模型可见历史。SID、agent、用户可见的追加式历史、Web tab/composer 与子代理归属不变,并自动续作。solo 原窗直接面对执行者;team 原窗仍是编排者,通过list_agents/send_message/interrupt_agent管理原生执行者子代理。bundle 设置subagent.maxDepth: 3,执行者可自派独立审查者。
实测版本
- Claude Code 2.1.322、2.1.140
- DeepSeek Harness(dsh)0.2.2-rc.1
- VS Code 1.146.0,内置 GitHub Copilot Chat 0.74.0
理念
- Harness 才是关键。 真正的质量来自 harness 约束下的智能体协作——不靠魔法提示词,也不靠更大的模型。
- 三步、一次放手。 许愿 → 做选择题 → 放手。你负责目标与边界;智能体执行、管理上下文并独立验收、交叉审查,你掌舵,不必盯每一步。
- 循环。 输入 → 分析 → 方案 → 执行 → 验收 → 交付。每一步都有独立审查、评分与迭代——干活的和检查的永远不是同一个实体、上下文相互隔离。
- 三大支柱:阶段隔离(战略/战术分层)· 对抗式验收(反谄媚:审查员的职责就是拆台)· TDD(先看到红,再看到绿)。
名字:源自希腊语 parallaxis — para-「旁边」+ allassein「改变」。从旁边看,位置就变了:换一个视角,才能看见内部自查看不见的东西。
兼容性
- Git:建议安装——流程使用 Git 根、scoped 提交与交接检查点;
qstart调研时会执行一次git --version,缺失则询问是否安装(不阻塞)。 - Claude Code:Linux · macOS · Windows WSL。Bash 4+、Python ≥ 3.11(纯标准库,无第三方依赖),CLI 交接启动器需要
tmux。 - DeepSeek Harness:运行时只使用 dsh 自带 Node 与注入的原生服务——不需要 Python、Bash、zstd CLI、tmux,也不修改 harness。
- GitHub Copilot:纯 Markdown 技能,零运行时依赖。仅 solo 档。
配置
零配置即可工作。可选开关,各是一个小的本地文件(升级时安装脚本会保留):
skills/bcheck/skill.conf、skills/rcheck/skill.conf——review_model=:独立审查子代理所用模型。留空 = 会话默认模型(不升档、不降档)。- 仅 Claude Code:
skills/gclear/gclear.conf——MODEL_ALIASES="":空格分隔的别名=完整模型ID对,供gclear --model使用;另有超时/重试调优项。 - 每个技能的默认回复语言(触发消息语言与口头指定优先):Claude Code 读 frontmatter
display_lang键;DeepSeek Harness 读metadata.display_lang。
升级
重跑安装脚本(bash install.sh [--platform <p>] <项目>)——原子交换,保留本地 *.conf。Claude Code 插件安装:/plugin update parallax。DeepSeek Harness bundle:重跑 node platforms/deepseek-harness/bundle/build.mjs,再次 dsh plugin --profile <profile> add "file:<bundle 路径>",再重启该 profile。每个技能版本见其 SKILL.md frontmatter。
联系
问题或反馈:欢迎提 issue,或邮件 [email protected]。
MIT — 详见 LICENSE。