前言¶
DSH 插件可以把上下文、工具和界面能力接到本机 agent。团队规范如果只放在 Aloof 网页里，agent 在执行任务时无法稳定读取，也无法把新摸清的规则交回团队。
dsh-aloof 用于把 Aloof 的团队红线和团队手册同步到 DSH agent：红线进系统提示，手册进技能目录；同时提供 /aloof 命令、右下角状态按钮和提交待确认的入口。
它依赖一台跑着的 Aloof 和 dsh 接入令牌。没有 Aloof 实例时，插件只会提示没配 ALOOF_TOKEN。
这是什么¶
aloof-ai/dsh-aloof 是 DSH 客户端插件，用于在 DSH agent 中同步 Aloof 上的团队规则。
- 仓库 owner：aloof-ai
- 许可证：MIT
- 运行要求：Node ≥ 22、DSH、一台跑着的 Aloof、dsh 接入令牌
- 服务端不在本仓库且不公开
下面介绍它能做什么、怎么装、怎么配。
核心功能¶
团队规则下发¶
- 把团队红线同步到 dsh 系统提示（
ctx.systemPrompt）。 - 把团队手册注册到 dsh 技能目录（
ctx.skills.register），agent 判断相关时读取。 - 每五分钟拉取 Aloof 的
/api/context。 - 拉不到时保持上一次内容，不清空。
状态查看¶
- 提供
/aloof命令，直接查看连接地址、票前几位和 Aloof 识别身份。 - 提供右下角可拖动悬浮按钮与红绿灯状态，支持换票/清票。
插件工具¶
aloof_whoamialoof_devicesaloof_contribute
其中 aloof_contribute 是唯一写操作，用于提交待确认。
凭据配置¶
- 接入令牌整串配置并自带地址，无需单独配置服务器地址。
- 支持
.credentials.yaml热更新凭据。 - 环境变量
ALOOF_TOKEN在进程启动时冻结，且优先级高于.credentials.yaml。
安装与启用¶
先确认环境：
- Node ≥ 22
- DSH
- 一台跑着的 Aloof
- dsh 接入令牌
安装命令：
dsh plugin --profile web add dsh-aloof
如果要做本地开发，先拉仓库，再按本地路径加入：
git clone https://github.com/aloof-ai/dsh-aloof.git
dsh plugin --profile web add /绝对路径/dsh-aloof
典型用法¶
配置接入令牌¶
- 在 Aloof 网页生成 dsh 接入令牌。
- 把整串令牌放入环境变量
ALOOF_TOKEN，或写入$DSH_HOME/.credentials.yaml。 - 接入令牌自带服务器地址，通常不需要再单独配置地址。
如果环境变量 ALOOF_TOKEN 已经存在，后续修改 $DSH_HOME/.credentials.yaml 可能不生效，因为进程启动时冻结的环境变量优先级更高。
查看连接¶
在 DSH 中运行：
/aloof
它会显示这台 DSH 连到的地址、票前几位，以及 Aloof 识别出的身份。
交回团队¶
在会话里说：
把这个存成团队手册
插件会调用 aloof_contribute 提交待确认。提交后还需要管理员放行才下发；agent 不能直接改红线或手册。
换票¶
可以先做第一种：在右下角卡片保存新票，不重启 DSH。
也可以改文件：修改 $DSH_HOME/.credentials.yaml 后热更新。
适用场景与注意¶
这个插件适合已经有 Aloof 实例、希望把团队规则接入本机 DSH agent 的开发者。
注意以下边界：
- 发新票、吊销令牌、接受提案只能在 Aloof 网页操作，插件不提供对应工具。
- 接入令牌不是网页登录票。
- 改 Aloof 密码会吊销名下所有令牌。
- 令牌可以设置有效期，到期需重新生成。
- 可选配置包括
tokenEnv（默认ALOOF_TOKEN）、timeoutMs（默认20000）、baseUrl（默认空，跟着票走）。 - 包没有构建步骤，
npm pack出来即源码；改client.js后重启 DSH。
插件以当前 DSH 进程权限运行。安装前应先检查源码与许可证。
链接¶
经过上面的步骤，dsh-aloof 可以把 Aloof 的团队规则接到本机 DSH agent：红线进系统提示，手册进技能目录，状态可以用 /aloof 和右下角按钮查看，知识可以提交待确认。
- 目录页：
https://www.skillhub.cn/plugins/aloof-ai/dsh-aloof - GitHub：
https://github.com/aloof-ai/dsh-aloof
