dsh-talebook-plugin

配置

插件可以在没有连接信息时正常加载。安装并启动 DSH 后，打开 设置 → 插件 → 插件配置 → Talebook，在展开的卡片中配置：

• Talebook 地址：已保存的地址会显示在输入框里，可直接修改；留空并保存会清除它。
• 用户名（可选）：已保存的用户名会显示在输入框里，可直接修改；只改用户名会保留原密码。留空并保存会清除整个登录信息（用户名和密码一起清除，之后以 guest 身份访问）。
• 密码：隐藏字段，只写入 DSH 凭据存储，浏览器无法读回原值；留空表示保持当前密码，输入新值并保存才会更新。

首次设置账号（尚无已存密码）时，输入用户名需要同时输入密码。只读浏览可以完全省略用户名和密码。

地址和用户名保存在 DSH 设置文档中（可读、可回填、可直接编辑）；密码是唯一的机密，只存在于凭据存储中，不会进入聊天记录或插件配置文件。未配置（或环境变量缺失/为空）时插件仅在被调用时给出配置提示，不会影响 DSH 启动。

原有环境变量方式继续兼容，适合无 UI、容器和 CI 部署：

export TALEBOOK_URL="https://books.example.com"
export TALEBOOK_USERNAME="your-username"
export TALEBOOK_PASSWORD="your-password"

生效值按 设置文档 → 插件配置 → 环境变量 的顺序解析；由环境变量提供的字段会在配置界面显示「由环境变量提供」。

插件 schema 还提供 timeoutSeconds、pythonExecutable、maxOutputBytes 和 checkUpdates 配置项。默认值适合常规部署；Windows 如果未安装 py launcher，可把 pythonExecutable 覆盖为 python。需要覆盖这些运行参数时，在 profile 自己的 cordis.patch.yml 中重写完整的 talebook 行，因为 DSH patch 对同一行的 config 是整体替换而不是深合并。