cathead-coding 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；基本兼容但装前注意：未发布到 npm registry，仅可从源码安装

cathead-coding 兼容性怎么样？

基本兼容但装前注意：未发布到 npm registry，仅可从源码安装

cathead-coding 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

cathead-coding 还在维护吗？

GitHub 4 星。最近一次上游提交在 2026/9/11。

猫头编程 catyans/cathead-coding

DeepSeek Harness

catyans54 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

在终端里与编程智能体多轮对话并自动改代码

32.1/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/9/19 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

自动兼容检查有告警：未发布到 npm registry，仅可从源码安装。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add catyans/cathead-coding

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：需留意

是什么

dsh 原生插件 · ui

装得上吗

实装验证未通过（runtime_boot_failed），装前请到仓库确认最近更新与 issue

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

更新放缓：最近一次提交在 54 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

⚠︎ 实装验证未通过（runtime_boot_failed · 2026/10/30） ——可能是验证环境差异，装前建议到 GitHub 仓库确认最近更新与 issue。

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查⚠ 装前注意

未发布到 npm registry，仅可从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✗npm 包cathead-coding（未发布到 npm，仅可源码安装）

✓Node 引擎要求 >=22.19 · 基线 Node 22.19 满足

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/18 00:26:14

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件读取剪贴板或密钥环境变量发起外部网络请求

查看扫描证据（共 25 处，展示前 12 条）

执行外部命令来自配置/变量
src/bridge/client.ts:37
this.child = spawn(process.execPath, [runtimePath, resolve(options.configPath)], {
发起网络请求
src/bridge/client.ts:90
await this.request('shutdown')
读取本地文件
src/bridge/client.ts:153
return candidates.find((candidate) => existsSync(candidate)) ?? candidates[0]!
发起网络请求
src/controller/session-controller.ts:200
await this.client.request('session.prompt', {
发起网络请求
src/controller/session-controller.ts:221
this.client.request('session.models', { sessionId: this.state.sessionId }),
发起网络请求
src/controller/session-controller.ts:222
this.client.request('subagent.list', { parentSessionId: this.state.sessionId }),
发起网络请求
src/controller/session-controller.ts:284
await this.client.request('session.search', { query: query.trim() }),
发起网络请求
src/controller/session-controller.ts:288
await this.client.request('session.list'),
发起网络请求
src/controller/session-controller.ts:294
await this.client.request('session.rename', {
读取密钥环境变量
src/doctor.ts:16
const hasGemini = Boolean(process.env.GEMINI_API_KEY || process.env.GOOGLE_GENERATIVE_AI_API_KEY)
读取本地文件
src/doctor.ts:27
await access(path, constants.R_OK)
读取本地文件
src/runtime-config.ts:12
return candidates.find((candidate) => existsSync(candidate)) ?? candidates[0]!

扫描于 2026/11/4（0 天前） · 范围全包扫描（包内未声明入口） · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/cordis@deepseek-ai/dsh-agent-default-model@deepseek-ai/dsh-agent-spine-demo@deepseek-ai/dsh-app-boot@deepseek-ai/dsh-attachment-local@deepseek-ai/dsh-bash-sandbox@deepseek-ai/dsh-command-compact@deepseek-ai/dsh-command-feedback@deepseek-ai/dsh-commands@deepseek-ai/dsh-compaction-basic@deepseek-ai/dsh-compaction-tool-result-pruner@deepseek-ai/dsh-fs-observation-policy

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

功能亮点

终端多轮对话
自动修改代码
持久化编码智能体

一款好用的持久化编码智能体命令行，由 DeepSeek Harness 驱动。

README

由 DeepSeek 最新模型翻译生成

Cathead Coding 一个能力出众的编程智能体，爪子柔软，工具锋利。 Cathead Coding 是一个开源、支持 Gemini 的编程智能体 CLI，由 DeepSeek Harness 驱动。它让产品体验保持小巧友好，同时将困难的部分——智能体执行、工具、会话、沙箱和模型路由——委托给 DSH。 [!IMPORTANT] Cathead Coding 是一个早期的开发者预览版。请在受版本控制的工作区中运行它，并审查生成的更改。它为何会发出呼噜声 - 交互式多轮终端聊天 - 智能体工作时可排队输入，并在下一个工具边界进行引导 - 按 Esc 取消可停止当前回合而不离开会话 - 用于脚本和 CI 的非交互式 run 模式 - 通过 /auto 实现有边界的自主目标（16 轮或 30 分钟） - 通过 DSH 的提供商中立 llm-pi-ai 适配器使用 Gemini - 工作区写入的文件和 shell 沙箱 - 使用 --resume 和感知工作区的 --continue 实现持久化本地会话 - 实时流式输出、工具活动、审批和用户提问 - 终端原生 Markdown，支持标题、代码块、列表、任务列表、表格和链接 - 计划模式，带渲染审查、Todo 进度、token/上下文压力和自动压缩

展开完整文档（README 剩余 1 节）

Cathead Coding
一个能力出众的编程智能体，爪子柔软，工具锋利。

Cathead Coding 是一个开源、支持 Gemini 的编程智能体 CLI，由 DeepSeek Harness 驱动。它让产品体验保持小巧友好，同时将困难的部分——智能体执行、工具、会话、沙箱和模型路由——委托给 DSH。

[!IMPORTANT]
Cathead Coding 是一个早期的开发者预览版。请在受版本控制的工作区中运行它，并审查生成的更改。

它为何会发出呼噜声

- 交互式多轮终端聊天
- 智能体工作时可排队输入，并在下一个工具边界进行引导
- 按 Esc 取消可停止当前回合而不离开会话
- 用于脚本和 CI 的非交互式 run 模式
- 通过 /auto 实现有边界的自主目标（16 轮或 30 分钟）
- 通过 DSH 的提供商中立 llm-pi-ai 适配器使用 Gemini
- 工作区写入的文件和 shell 沙箱
- 使用 --resume 和感知工作区的 --continue 实现持久化本地会话
- 实时流式输出、工具活动、审批和用户提问
- 终端原生 Markdown，支持标题、代码块、列表、任务列表、表格和链接
- 计划模式，带渲染审查、Todo 进度、token/上下文压力和自动压缩
- 模型切换、会话搜索/重命名/分叉、Git worktree 状态和后台任务视图
- 进程内和分叉的子智能体，带实时“猫咪团队”状态
- 工作区指令和本地 Skill 发现

环境要求

- Node.js 22.19 或更新版本
- pnpm 10 或更新版本
- 一个 Gemini API 密钥
- 当前沙箱化 Bash 运行时需要 macOS 或 Linux

让猫进来

git clone https://github.com/catyans/cathead-coding.git
cd cathead-coding
pnpm install
pnpm build
npm link

export GEMINI_API_KEY="your-key"
node dist/cli.js doctor
cathead --cwd /path/to/project

从一个任务开始：

cathead "fix the failing tests"

不使用交互式 UI 运行：

cathead run --cwd /path/to/project "review the current diff"

流式输出机器可读事件：

cathead --cwd /path/to/project run --output jsonl "run the tests"

恢复某个工作区的最新会话，或恢复指定会话：

cathead --cwd /path/to/project --continue
cathead --cwd /path/to/project --resume session-abc123
GOOGLE_GENERATIVE_AI_API_KEY 可作为 GEMINI_API_KEY 的别名使用。密钥由私有 DSH 运行时子进程继承，绝不会写入 Cordis 配置。

配置

| 环境变量 | 默认值 | 用途 |
| GEMINI_API_KEY | — | Gemini 身份验证 |
| CATHEAD_PROVIDER | google | DSH 提供商路由 |
| CATHEAD_MODEL | gemini-2.5-flash | 模型 ID |
| CATHEAD_SESSION_ROOT | ~/.cathead/sessions | 持久化 DSH 会话 |
| CATHEAD_QUERY_PATH | ~/.cathead/*.sqlite | 派生的本地会话搜索索引 |
| CATHEAD_DSH_CONFIG | 捆绑配置 | 备用 Cordis 运行时组合 |

默认运行时在 config/cordis.yml 中声明。这一显式组合是 Cathead Coding 与 DSH 之间的产品边界；部署可以替换它，而无需分叉任一项目。

交互控制

| 输入 | 行为 |
| 输入 | 行为 |
| Enter | 立即发送，或在 Cathead 忙碌时排队作为下一轮 |
| Shift-Enter / Ctrl-Enter | 在编辑器中插入换行 |
| Alt-Enter | 在下一个工具边界处进行引导 |
| ↑ / ↓ | 浏览提示历史 |
| PageUp / PageDown | 在最新 Markdown 回答中按块翻页 |
| Esc | 取消当前轮次；交互会话保持打开 |
| Ctrl-C | 忙碌时取消；空闲时按两次退出 |
| Ctrl-D | 输入为空时退出 |
| /plan [task] / /plan off | 进入规划模式（可选带任务），或退出该模式 |
| /compact | 压缩符合条件的对话历史 |
| /auto | 启动一个上限为 16 轮或 30 分钟的目标 |
| /continue [guidance] | 再添加一个有界目标批次 |
| /pause / /cancel | 暂停自动目标或取消当前轮次 |
| /queue / /steer | 查看排队的工作或注入引导 |
| /sessions [query] | 列出或搜索持久会话 |
| /rename / /fork | 重命名或分叉当前会话 |
| /models / /model | 列出模型，或切换提供商/模型及推理强度 |
| /context / /diff / /agents | 检查 token 用量、Git 状态或子代理团队 |
| /clear / /exit | 清空视图或关闭 Cathead |

助手回复和计划审查以终端原生 Markdown 渲染。图像不会尝试绘制 sixel 或 Kitty 图形；Cathead 会显示其替代文本和路径/URL，从而保持输出的可移植性。

交互模式有意要求真实的 TTY。对于管道、任务运行器、日志和 CI，请使用 cathead run；Cathead 绝不会将交互式调用静默转换为一次性请求。

架构

Terminal UI / run command
│
▼
Cathead session controller
│ private NDJSON bridge over stdio
▼
DSH Host ApiProxy + Cordis composition
│
├── Gemini provider
├── agent spine
├── workspace sandbox
├── filesystem + Bash tools
├── plans, goals, Todo, compaction, and token meter
├── background jobs + subagent providers
├── approval/question providers
└── durable sessions + projection cache

控制器拥有一个长期存活的 DSH 会话，并将其事件流折叠为持久转录状态、临时流式状态、工具活动、队列状态、目标和交互。模型回合进入空闲状态不会卸载 UI 或关闭运行时。有关生命周期和净室设计边界，请参阅 docs/architecture.md。

安全模型

内置策略将文件系统和 shell 写入限制在选定的工作区内。更广泛访问的请求会以显式交互式批准的形式呈现。无头运行会拒绝交互式请求并以状态码 2 退出。自动目标是有界的，且必须显式续期。会话默认存储在 ~/.cathead 下；API 密钥由私有运行时进程继承，不会持久化到项目配置中。

开发

pnpm install
pnpm dev
pnpm check

在提交拉取请求之前，请参阅 CONTRIBUTING.md。安全报告遵循 SECURITY.md。

路线图

- 全屏差异查看器和更丰富的逐工具卡片
- 键盘驱动的会话/模型选择器浮层
- 在超大代码块和子代理转录窗格内进行细粒度滚动
- Windows PowerShell 组合

许可证

MIT