@xmanrui/dsh-im 0.4.0 → 0.6.0

package/README.md

@@ -63,6 +63,24 @@ QQ 扫码接入使用腾讯 QQBot v2 官方流程。默认腾讯授权页会把
 
 飞书扫码绑定会把扫码者作为允许使用者；手动凭据同样无法识别扫码人，因此使用飞书应用的可见范围作为入站访问范围。请在飞书开放平台中只向信任的租户、群或成员开放应用。
 
+每个机器人维护独立的 Harness 工作区。新接入机器人会把 Harness Host 进程当时的工作目录（`process.cwd()`）记录为默认值；该路径会持久化，不会因为以后从其他目录重启 Host 而改变。设置页的机器人卡片会显示当前路径，并可直接修改。
+
+## 机器人命令
+
+| 命令 | 作用 |
+| --- | --- |
+| `/workspace <工作区绝对路径>` | 切换当前机器人的 Harness 工作区。 |
+| `/workspacelist` | 列出当前 Harness Host 上仍然存在的工作区绝对路径。 |
+
+示例：`/workspace /Users/alice/projects/my-app`
+
+- 只接受已经存在的绝对目录；路径无效时机器人会返回具体提示和正确用法。
+- `/workspacelist` 不需要参数。它合并 Harness 全局登记项与当前机器人的路径；当前路径仍存在且可安全显示时会排在首位并标记为“当前”。结果可直接复制到 `/workspace` 命令。
+- 任何已在对应平台可见范围内、能够正常向机器人发消息的用户都可以执行，不区分管理员和普通用户。
+- 工作区列表来自 Harness Host 的全局登记信息，可能包含其他机器人、其他渠道或非 IM 项目的本机绝对路径。请将机器人可见范围限制给可信用户。
+- 切换成功后只清除当前机器人的旧 Harness 会话映射，不影响其他机器人。
+- 新工作区对后续消息生效；已经开始生成的回复会继续完成。
+
 ## 设计
 
 - Harness 中只注册一个「IM机器人」设置页；
@@ -150,6 +168,24 @@ 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. |
+| `/workspacelist` | List workspace absolute paths that still exist on the current Harness Host. |
+
+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.
+- `/workspacelist` takes no arguments. It combines the Harness global registry with the current bot's path. When that current path still exists and is safe to display, it appears first and is marked as current. Any listed path can be copied directly into `/workspace`.
+- 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.
+- The list comes from the Harness Host's global registry and can include local absolute paths for other bots, other channels, or non-IM projects. Restrict the bot's visibility to trusted users.
+- 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.