# dsh-plugin-coaligne

[English](./README.md)

把团队在 <https://www.coaligne.com> 上共享的项目上下文接入 DeepSeek Harness。

CoAligne 是一个"人和 Agent 共享项目上下文"的协作平台:CoAligne Desktop 将本地项目文件和 Agent 会话同步到云端项目,并把本地 Agent(包括 DSH)接入这些云端上下文。

## 插件提供什么

- **`coaligne-workflow` skill**,插件激活时自动安装到 agents home(`$DSH_AGENTS_HOME` 下的 `skills/`,默认为用户主目录的 `.agents`):教会 Agent 何时、如何使用 CoAligne 工具——协作查询、长内容检索策略、评论回复、分享流程、单项目 AI 使用报告。
- **CoAligne MCP 工具**,在连接 CoAligne Desktop 后可用(见下方"安装与接入";工具以 `mcp__coaligne__<tool>` 出现):
  - `list_projects`、`me`、`get_project_activity` — 项目发现与最近动态
  - `search` — 在同步的文件与 Agent 会话日志上执行沙箱只读 shell(`grep`、`cat`、`find` 等)
  - `download_file`、`list_file_comments`、`reply_file_comment` — 文件下载与评论讨论
  - `create_file_link`、`resolve_file_link`、`resolve_session_link` — 私有 `app.coaligne.com/f/{code}`、`app.coaligne.com/s/{code}` 定位链接
  - `list_project_reviewers`、`create_review_request` — 把文件或 Agent 会话发送给队友

![CoAligne Desktop:从本地 Agent 工作区同步的团队项目](docs/screenshots/coaligne-desktop-team-projects.png)

## 安装与接入

1. **安装本插件**(或在 dsh-market 一键安装):

   ```bash
   npm install dsh-plugin-coaligne
   ```

2. **注册账号**:<https://www.coaligne.com>。

3. **安装 CoAligne Desktop**(macOS 和 Windows,下载见 <https://www.coaligne.com>),登录并导入本地项目。Desktop 会为你完成两件事:
   - **同步**:把你的项目文件和 Agent 会话持续同步到团队共享的云端项目;
   - **接入**:自动为 DSH 配置 CoAligne MCP 连接(一行 `@deepseek-ai/dsh-mcp-client`,serverName 为 `coaligne`,凭证自动带上)。全程无需手工处理 token。

完成后重启 DSH 会话,`mcp__coaligne__*` 工具即可使用,skill 会引导 Agent 在合适的时机调用它们。

> **不安装 CoAligne Desktop 则本插件不可用**:插件本身只安装 workflow skill,skill 依赖的全部工具都来自 Desktop 配置的 MCP 连接。未检测到 Desktop 接入时,插件会在激活时输出明确警告。

## bundle patch 组合了什么

bundle patch(`cordis.patch.yml`)向 profile 组合两行配置:

| 行 | 包 | 作用 |
| --- | --- | --- |
| `coaligne-skill` | `dsh-plugin-coaligne` | 把内置 `coaligne-workflow` skill 安装到 `$DSH_AGENTS_HOME`(默认为用户主目录的 `.agents`) |
| `coaligne-skill-invariant` | `dsh-plugin-coaligne/invariant` | 包级 invariant 伴生插件 |

MCP 连接**有意不在这里声明**——它由 CoAligne Desktop 负责写入和维护,本包不接触、不存储任何凭证。

## 配置项

`coaligne-skill` 行支持:

| 选项 | 默认值 | 说明 |
| --- | --- | --- |
| `installSkill` | `true` | 激活时安装/刷新内置 skill |
| `agentsHome` | `''` | 覆盖 agents home;为空时依次取 `$DSH_AGENTS_HOME`、用户主目录的 `.agents` |

## 工作原理

- skill 安装是插件激活时的幂等拷贝;若你自行管理 skills,设 `installSkill: false` 关闭。
- MCP 连接由 CoAligne Desktop 全权管理:它用你的账号登录、为 DSH 写入连接并保持有效。本插件不含任何凭证,也不发起网络请求。

## 开发

```bash
pnpm install
pnpm typecheck
pnpm test
pnpm build
```

## 许可证

[BSD-3-Clause](./LICENSE)。基于 <https://github.com/omdsh-dev/plugin-template> 脚手架。