@xmanrui/dsh-im 0.3.0 → 0.5.0

package/README.md

@@ -1,5 +1,12 @@
 # dsh-im
 
+<p align="center">
+  <img src="assets/logo.png" alt="dsh-im logo" width="160">
+</p>
+
+<p align="center"><strong>让聊天机器人轻松接入 DeepSeek Harness</strong></p>
+<p align="center"><strong>Connect IM bots to DeepSeek Harness with ease</strong></p>
+
 ## 中文
 
 通过扫码、App Manifest 或已有机器人凭据把 IM 机器人接入 DeepSeek Harness。一个插件、一个设置入口，统一管理飞书、微信、钉钉、企业微信、QQ、Slack、Telegram、Discord 和 WhatsApp 机器人。
@@ -56,6 +63,21 @@ QQ 扫码接入使用腾讯 QQBot v2 官方流程。默认腾讯授权页会把
 
 飞书扫码绑定会把扫码者作为允许使用者；手动凭据同样无法识别扫码人，因此使用飞书应用的可见范围作为入站访问范围。请在飞书开放平台中只向信任的租户、群或成员开放应用。
 
+每个机器人维护独立的 Harness 工作区。新接入机器人会把 Harness Host 进程当时的工作目录（`process.cwd()`）记录为默认值；该路径会持久化，不会因为以后从其他目录重启 Host 而改变。设置页的机器人卡片会显示当前路径，并可直接修改。
+
+## 机器人命令
+
+| 命令 | 作用 |
+| --- | --- |
+| `/workspace <工作区绝对路径>` | 切换当前机器人的 Harness 工作区。 |
+
+示例：`/workspace /Users/alice/projects/my-app`
+
+- 只接受已经存在的绝对目录；路径无效时机器人会返回具体提示和正确用法。
+- 任何已在对应平台可见范围内、能够正常向机器人发消息的用户都可以执行，不区分管理员和普通用户。
+- 切换成功后只清除当前机器人的旧 Harness 会话映射，不影响其他机器人。
+- 新工作区对后续消息生效；已经开始生成的回复会继续完成。
+
 ## 设计
 
 - Harness 中只注册一个「IM机器人」设置页；
@@ -143,6 +165,21 @@ QQ QR binding uses Tencent's official QQBot v2 flow. Tencent's default authoriza
 
 Feishu QR binding records the scanner as an allowed user. Manual credentials cannot identify a scanner, so the Feishu application's visibility becomes its inbound access scope. Restrict the application to trusted tenants, groups, or members.
 
+Each bot maintains an independent Harness workspace. A newly connected bot records the Harness Host process's current working directory (`process.cwd()`) as its default; the path is persisted and does not change when the Host is later restarted from another directory. Every bot card shows the current path and lets it be edited.
+
+## Bot commands
+
+| Command | Description |
+| --- | --- |
+| `/workspace <absolute workspace path>` | Switch the current bot's Harness workspace. |
+
+Example: `/workspace /Users/alice/projects/my-app`
+
+- The path must be an existing absolute directory. The bot returns an actionable error and the correct usage when validation fails.
+- Any user who is already within the platform bot's visibility scope and can normally message it can run the command; there is no additional administrator/ordinary-user distinction.
+- A successful switch clears only the current bot's old Harness session mappings and does not affect other bots.
+- The new workspace applies to subsequent messages; a reply that has already started generating is allowed to finish.
+
 ## Design
 
 - Registers a single **IM Bot** settings page in Harness.
@@ -171,3 +208,30 @@ IM management RPCs accept loopback browsers by default. When a Web profile is de
 ```
 
 `trusted-host` reuses Harness's Host/Origin fence; it is not user authentication. Anyone who can reach that LAN authority can inspect bot status, scan or submit application credentials, reconnect bots, and remove bots. Enable it only on a trusted network.
+
+---
+
+## 联系方式 / Contact
+
+欢迎通过邮箱、微信或小红书联系我。
+
+You can reach me by email, WeChat, or Xiaohongshu.
+
+<table>
+  <tr>
+    <th align="center">邮箱 / Email</th>
+    <th align="center">微信 / WeChat</th>
+    <th align="center">小红书 / Xiaohongshu</th>
+  </tr>
+  <tr>
+    <td align="center" valign="middle">
+      <a href="mailto:longmanr307@gmail.com">longmanr307@gmail.com</a>
+    </td>
+    <td align="center" valign="top">
+      <a href="docs/images/weixin.jpg"><img src="docs/images/weixin.jpg" alt="微信二维码 / WeChat QR code" width="240"></a>
+    </td>
+    <td align="center" valign="top">
+      <a href="docs/images/xhs.jpg"><img src="docs/images/xhs.jpg" alt="小红书二维码 / Xiaohongshu QR code" width="240"></a>
+    </td>
+  </tr>
+</table>