团队项目上下文共享dataelement/dsh-plugin-coaligne

dsh-plugin-coaligne

English

把团队在  上共享的项目上下文接入 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__ 出现):
- 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 工作区同步的团队项目

安装与接入

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

npm install dsh-plugin-coaligne

2. 注册账号:。

3. 安装 CoAligne Desktop(macOS 和 Windows,下载见 ),登录并导入本地项目。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 写入连接并保持有效。本插件不含任何凭证,也不发起网络请求。

开发

pnpm install
pnpm typecheck
pnpm test
pnpm build

许可证

BSD-3-Clause。基于  脚手架。