前言¶
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
