jira-tasks-dsh-plugin

1. 将本仓库（仓库根目录即包目录）复制为 ~/.dsh/profiles/web/packages/dsh-jira-tasks/（可忽略 .git/）
2. 编辑 ~/.dsh/profiles/web/package.json：
   • dependencies 增加："dsh-jira-tasks": "file:./packages/dsh-jira-tasks"
   • dsh.profile.bundles 追加："dsh-jira-tasks"
3. 在 profile 目录执行 pnpm install
4. 重启 DSH

注：pnpm install 会把包复制到 node_modules/（非符号链接），改动源码后需同步 node_modules/dsh-jira-tasks 或重跑 install。

在 DSH 会话中用 Cordis 工具执行：cordis_define（kind: new，idPrefix: "jira"，源码见仓库 plugin/host.js / plugin/client.js）→ cordis_run 激活。动态插件只存在于进程内存，重启后消失，仅适合临时试用。

面板中的提示位于「查询失败：」之后，与下列文案对应：

能。 卡片把令牌保存到插件自有引用 JIRA_TASKS_TOKEN，而不是直接写环境变量用的 JIRA_API_TOKEN。DSH 只拒绝写入「会被启动环境遮蔽的同名引用」，插件自有引用不受影响，所以哪怕 shell / 系统里已导出 JIRA_API_TOKEN，设置页也能正常输入并保存，并且 Host 解析时优先用它：

JIRA_TASKS_TOKEN（设置页） > JIRA_API_TOKEN > JIRA_TOKEN

• 卡片会显示当前生效来源：已保存设置页令牌时提示「优先于环境变量 JIRA_API_TOKEN」；未保存时提示「当前使用环境变量 JIRA_API_TOKEN，填写并保存即可覆盖」
• 保存后自动重测连接；点「清除设置页令牌（回退到环境变量）」可删除覆盖值
• 唯一仍会报 is supplied read-only by the launching environment 的情况：有人把 JIRA_TASKS_TOKEN 本身也导出到了启动环境——那种情况下该引用确实只读，需先移除它（Windows：系统属性 → 环境变量，或 PowerShell [Environment]::SetEnvironmentVariable('JIRA_TASKS_TOKEN', $null, 'User')）并重启 DSH

• 确认已安装并重启 DSH；新会话面板位于输入框下方
• 检查 DSH 启动日志中 profile 插件是否加载成功

┌────────────────────────────────────────┐   ┌────────────────────────────────────┐
│ conversation.composer.dock（活跃会话）  │   │ webServer 路由 /jira/api/search     │
│ conversation.input.dock（新会话）       │   │ ↓                                   │
│   面板 hero 布局（flex order:99）       │   │ settings.get("jira-tasks").baseUrl   │
│   ↓ 挂载 / 刷新时 fetch POST            │   │ credentials.resolve(TOKEN_REFS)     │
│ 渲染：任务列表 / 错误 / 未配置          │   │ subprocess.spawn(curl …)            │
│ localStorage 按工作区存取项目 Key/JQL   │   │ ↓ stdout JSON                       │
│ settings.plugin.item（设置页卡片）      │   │ 解析 issues → 返回 {ok,issues}      │
└────────────────────────────────────────┘   └────────────────────────────────────┘

• Host：注册 settings 命名空间 jira-tasks（baseUrl，可读）与 webServer 路由 POST /jira/api/search；地址优先读设置文档，令牌经 credentials 服务按 JIRA_TASKS_TOKEN（设置页写入）→ JIRA_API_TOKEN → JIRA_TOKEN 的顺序解析（$DSH_HOME/.credentials.yaml / 环境变量，热加载），因此设置页保存的令牌能覆盖环境变量；查询用 subprocess 直接 spawn curl，认证头经 stdin（--config -）传入，令牌不进入命令行参数。
• Client：window.__ModuleLoader__.load({ id, factory }) 标准 web bundle；注册 conversation.composer.dock（活跃会话，注册 order: 5）与 conversation.input.dock（新会话，注册 order: 10）。新会话面板走 hero 布局：面板元素自身 flex order: 99 排在输入框之后下方，并以 --dsh-composer-side-clearance / --dsh-composer-card-max-width 与输入卡等宽。另注册 settings.plugin.item（key: "jira-tasks"）作为设置页卡片：地址经 settingsScope 写入命名空间，令牌经 remote.credentials 写入 JIRA_TASKS_TOKEN。
• 为什么不用 shell 服务：shell 会套 sandbox-exec，部分 macOS 上不可用（sandbox_apply: Operation not permitted）；subprocess 是原始进程缝，无此问题。
• 新会话显示：DSH 壳在 hero（空白会话）阶段不渲染 composer.dock，故额外注册 input.dock，并用「会话是否已有消息」去重（新版 DSH 依据 SessionSnapshot.blank），避免双份面板。

与动态插件版的差异