dsh-worktable: Instructions file for Codex

dsh-worktable 项目规则

工作台容器插件：侧边栏里收纳 agent 级项目的「应用抽屉」。纯增量，不替换官方插件。

协作方式（用户定案，最高优先级）

• 设计先给最小版：任何 UI/文案/方案先交「最少元素」版本给用户拍板，确认后再增量； 默认克制——没有存在理由的元素不放；不一次搭「完整版」再返工。
• 长任务拆 checkpoint：每个可验收阶段完成后停下汇报，等用户确认再进下一段； 不一口气跑完长任务。
• 对外动作永远先审：发布、评论、给观众的内容、任何公开操作，一律先给用户过目， 用户不点头不执行。
• 改完必读回：每次编辑后读回改动处的完整行/段落，确认无残留、无断尾 （包含命令与 URL）。
• 验收用最终产物，不用中间信号：任何交付物（tgz、命令、文档、UI）的验收动作必须是 「解包 / 复制 / 实跑用户路径」；「构建成功」「bundle 里有字符串」「退出码 0」不算验收。
• 发布前自跑最终产物清单：干净目录安装、最终包逐文件核对、双资产哈希、关键行逐字 grep —— 先自查再报告，不等外部复审来抓。
• 发布包验收=结构检查 + 真实安装：标准 package/ 前缀、白名单精确 7 文件（无 src/、.map）， 再独立目录 npm install + import() 断言；仅核对文件存在不能证明包可安装。
• 声明可证伪：只写已验证范围；安装/导入不是端到端验收，版本比较正常不等于通知覆盖所有用户。
• 同 tag 资产不可覆盖（用户已拍板）：坏包处理 = 发新版本号 + 旧 Release 正文标注问题， 默认不替换旧资产；仅经用户明确批准的紧急补救例外，且须：不改名（保持原 URL 名）、 用已验证包、不删不盖现有资产、上传后从完整 URL 下载核对、旧 Release 注明补救经过。

边界

• 插件包根目录 = 01_content/；本仓库其余目录是项目文档与本地工具。
• 不替换、不禁用任何官方插件（ui-sidebar / ui-workspace / ui-layout）。
• 项目/布局/绑定存 localStorage，媒体存 IndexedDB；文件窗、mkdir 与产物握手会读写用户配置的项目目录，权限边界见 01_content/README.md。
• dsh-travelatlas 是入驻项目而非本仓库的一部分；协议见 02_process/PRD.md §5.3/5.4。
• 平台边界：Windows 网页端已测范围见 01_content/README.md，不宣称全功能验收；桌面已测版本与候选边界同包内 README；macOS 为实验性支持（核心文件路径代码已做跨平台适配， 尚未真机端到端验证）。路径拼接必须走 pathutil.ts helper 或 Node path API，不手写分隔符。

当前 0.5.1 发布批次

• 用户于2026-10-31明确授权：统一0.5.1版本/公告/安装链接，重新打包验收，通过后提交、推送并发布；不覆盖旧Release资产。公开状态以GitHub Release为准。
• rc.5 的dev.1隔离GUI 15项通过；dev.2修正中性结束提醒与助手摘要，dev.3修复更新误报。用户已在本机官方Desktop确认dev.3误报消失、看起来正常；正式0.5.1另按最终包验收，不称正式包全功能GUI验证。本机仍装dev.3（SHA 620b3bc8b798…），发布不自动替换或重启正式宿主。临时测试环境已清理。
• rc.5 claimed command 是单字符 chip，但 0.2.0 mainView 仍是显示文本，不能只据 mainView 判断命令坐标；本轮保持既有安全剪贴板降级，后续需明确能力契约再适配。
• 兼容目标精确增加 DSH 0.2.1-rc.5；不得以通配或真实环境豁免代替隔离验证。
• rc.5 适配日志位于 E:/AI_Workspace/DeepseekHarness/log/2026-10-30_worktable-rc5兼容适配；dev.2 显示修正与最终包检查见 log/2026-10-31_worktable控制室显示修正/2026-10-31_控制室显示修正与候选检查报告.md（相对 DeepseekHarness 根）。更新误报修正与dev.3安装见同目录2026-10-31_更新误报修复与dev3安装报告.md。先看实测记录再描述完成范围。
• 保留任务开始前 index.tsx 的一行任务标题文案修改，不能将其说成本轮接口修复；旧 0.5.0 发布资产不覆盖。
• 以下 0.5.0 条目是既有安全边界与历史证据，rc.5 以本轮候选验收记录为准。