极心许愿是 Cindy 工作流快捷面板插件，ID 和命令为 jixin-make-a-wish。本仓库只维护插件，不修改 Cindy Core；不提交组织市场。旧 workflow-deck 的绑定和日志不会自动迁移。
已提供独立桌面与Cindy插件共用的项目配置、基础Git和规则检查服务。Cindy基础界面提供Git，高级界面保留五工作流。第四个日常入口为“AI 诊断问题”：Cindy版使用无工具的快问快答，在用户核对脱敏预览后分析原因与处理建议，不执行修复。独立端目前只提供本地诊断预览，AI接入和高级工作流尚未实现。详见基础Git和双形态说明。
在 Cindy 聊天发送：
请安装 https://github.com/xindong/cindy-workflow-deck 的极心许愿插件，按 INSTALL.md 从最新正式 GitHub Release 下载、校验并打开 .cindy，再核对最终安装结果。
仓库当前文件树不再保存 .cindy 或分发元数据。安装包只放在 Release 的 Assets 中；普通源码提交只升版本，不产生新的可下载版本。正式发布可能落后于本页源码版本，应以选定 Release 的 tag、包内 manifest 和同一 Release 的 DISTRIBUTION.json 为准。GitHub 自动附带的 Source code ZIP/TAR 是源码，不是安装包。
每个 Release 提供版本化 .cindy、DISTRIBUTION.json 和 SHA256SUMS.txt。公开附件可匿名下载，无需 GitHub 授权；Cindy 首次安装确认仍由用户操作，打开包不代表已安装。元数据和校验和属于本仓格式，不是官方发现协议、签名或静默安装授权。
- 打开插件面板，基础界面提供Git；切换“高级 · 工作流”使用原执行记录和五工作流。宿主标题栏提供独立窗口和最小化。
- 在插件配置点击“选择执行项目，自动准备”亲选实际操作项目。流程文件可在“流程文件位置”单独选目录，默认使用执行项目内的流程；面板自动发现五工作流，无需发送工具命令或绑定聊天。
- 工具栏显示已选择项目；悬停或聚焦按钮可看动作、来源及禁用原因。检查失败时显示错误码，点击刷新重查。
- 点击可用按钮创建独立任务，不复制聊天历史。目录转述用户亲选的根目录，由Host核验；模型与权限采用Cindy插件任务设置。详情面板可填写补充目标。
- 新任务通过 report_progress 主动回报实际步骤、输出摘要、阻塞及最终结果。Cindy 的 turn/activity 事件单独标为宿主状态，AI 报告完成不等于宿主确认业务完成。
面板“目标与目录”中展开“使用说明”可读中英文使用提示；完整说明随包保存在 plugin/USAGE.md。0.3.5对缺失的Node/Agent接口和明确不支持响应提供升级提示，拒绝派发，不误报文件缺失或回执丢失；权限、网络与磁盘错误分别处理。旧任务记录与聊天卡入口保留兼容；直接项目启动新增agent.errand权限。
未收到回报时显示等待，不能自动镜像全部终端输出，也不会回填旧任务正文。可切换任务查看已保存的日志尾部。
项目来自插件配置，切换聊天不改变项目，重启后重新读取已保存根目录，不需要重绑。直接目录派发使用Host现有agent.errand接口（新增权限，安装确认会展示）；新任务使用唯一sessionKey，互不复用历史。Host同一时间只允许一个此类任务运行，至少间隔10秒；面板只在运行中每5秒查询，结束后恢复按钮。回执丢失不重发；过期或结果不明时，用户检查任务列表后可明确解除阻塞，不把旧任务改成失败。
执行项目与流程文件位置分别保存。Git、规则检查和工作流任务始终使用执行项目；流程目录只提供指令，不改变任务工作目录。可在多个项目共用一个流程目录，目录选择取消时保留原配置；旧配置继续使用项目内的流程。缺失的流程目录会禁用工作流，不影响执行项目的基础 Git。
更新确认后自动显示进度卡并滚动到可见位置：大字显示当前步骤，逐项展示获取、预检、备份、更新与恢复的真实记录，附执行项目完整路径和用时。完成或停止后保留结果；进度查询失败不会宣告成功、重复拉取或提前解锁操作。
更新失败后直接显示恢复卡：尚未修改本地文件的失败可重新检查后确认重试；回执丢失先只读检查实际结果；已修改文件的中断须核对备份和文件后显式解除操作限制。未完成的 Git 操作、冲突及现有操作锁不会被自动清除。步骤见更新失败后恢复。
亲选目录授权与/kv不同；手填或失效授权需点击目录选择器重新选择。Cindy原生插件任务设置中的显式目录覆盖优先，使用时须与当前项目一致；任务先核对实际根目录，不一致必须停止。普通任务create接口当前不接受任意workingDir，不能用它伪装已切换项目。旧聊天卡仅保留兼容入口，不是配置项目的必需步骤。
只读检查四个非空、可读普通文件：_S/experiment.md、_S/feature.md、_S/tooling.md、_E/merge.md。缺失、空文件、链接或不可读时只禁用对应按钮；检查失败不冒充文件不存在。不执行、捆绑或伪造流程正文。
PR 检查 xd-pr-review/SKILL.md，范围是项目的 .agents/skills、.claude/skills、.cindy/skills，以及用户目录的 .agents/skills、.claude/skills、.codex/skills。未确认仅表示这些路径未找到，不代表所有 Host 或远程技能都不存在。远程目录、只读目录和未经核验来源不启用派发。
底部横向胶囊，上方为可滚动时间线；明暗主题跟随 Host。停靠最小宽度280px，初始占比25%；Host 可能保留已有列宽。独立窗口仍受 Host 最小320×400限制。
Node worker 具有系统账号权限，不能称为操作系统级只读沙箱。流程发现只读；基础Git使用固定操作与参数数组调用本机Git，保留并执行项目hooks及过滤器，不开放任意shell。专用 worker-entry.cjs 显式启动 stdio，兼容 Host 通过 require 加载。
每次点击新建任务；后台能力仅用于用户点击派发，没有自动或定时执行。请求和回执在派发前持久化，回执不确定不自动重发，派发间隔至少10秒。KV 串行合并；日志按调用id去重并限制尾部容量，不淘汰未核实派发记录。report_progress 只接受 Host 注入的、属于本插件受理任务的会话上下文。
Node 22+ 与 Python 3.9+，无插件运行依赖。先运行 python3 scripts/install_hooks.py 或 npm run prepare，安装本仓提交hook；不覆盖已有自定义hook或改全局Git配置。
- 日常修改提交（含文档、CI、测试）：自动+0.0.1，例如0.1.2→0.1.3。
- 用户明确选择大版本升级：+0.1.0，补丁位归零，例如0.1.3→0.2.0。同一提交不再额外加patch。
普通 git add / git commit 自动同步 package.json、plugin/ghost.json 和本页标题，不构建安装包。大版本升级先暂存修改，再运行 python3 scripts/bump_version.py --minor，最后提交；VERSION_BUMP.json 仅在本次更改且base匹配父提交时生效，下一次普通提交恢复patch。
main的版本流程为网页/API漏升版兜底，按每条修改提交补齐；已升版提交、同步bot提交和CI重跑不重复增加，空提交不增加。上传API提交必须包含本地hook生成的完整源码版本文件。版本文件/README有未暂存修改时hook会阻止覆盖；.cindy 即使用 git add -f 也会被提交hook和云端检查拦截。
验证命令：npm test、npm run check、npm run test:release。发布与版本测试使用真实临时Git仓库及临时产物目录，不执行安装。需要本地预检安装包时使用 npm run dist（写入被忽略的 release-assets/，目录需不存在），再用 npm run dist:check；也可指定 python3 scripts/build_distribution.py --out /tmp/新的产物目录。产物不入库。首次更换ID后的真实安装状态见 docs/acceptance.md；历史实机结论不能直接代替当前新身份验收。
推送版本tag（v0.1.3或0.1.3这样的格式）触发 Release Cindy plugin。tag去v后必须匹配 package.json 与 plugin/ghost.json；workflow检出tag源码，跑测试与静态检查，再构建、校验并创建Release，上传三附件，自动生成发布说明。带预发布后缀标记prerelease，普通安装取最新正式非draft、非prerelease版本。
先确认main版本CI成功，再在含发布workflow的提交上打tag并推送，例如：
version=$(node -p "require('./package.json').version")
git tag "v$version"
git push origin "v$version"
仅本地tag不触发。workflow使用内置GITHUB_TOKEN，无需额外密钥；不覆盖已有Release，不移动已发布tag。后续源码提交不会重写旧Release。历史Git提交中原有二进制包不重写删除，本次仅从当前文件树移除。
显示名、插件ID和实际GitHub仓库在 repository-policy.json 定义。提交hook与CI共用规范校验器，拦截名称大小写/版本/安装链接不一致、分发包或缓存误入库、路径大小写冲突等问题。运行 npm run check 检查；PR与main push均运行只读 Repository checks，Release从同一配置生成标题并校验目标仓库。源码版本与已发布版本分别核对，不要求普通提交立即发布。完整规则见 AGENTS.md；检查反例包含在 npm run test:release 中。
已实现Cindy插件配置页与独立Electron配置窗口，共用项目/流程文件模型。只需选择项目根目录，名称自动生成、五工作流指令自动发现；支持多项目、缺失/歧义提示、保存重载与并发冲突保护；独立端额外提供只读Git状态。完整运行方式、权限边界与当前未实现项见双形态使用说明。Git写入、独立高级任务与AI诊断仍待后续阶段实现。
已有项目选择根目录后，只需“更新项目 / 查看我的改动 / 提交我的修改”。提交选文件、写一句说明、核对团队要求，内部自动开工作分支、运行项目检查、上传送审，不直接改主分支、不自动合并。高级入口保留专业Git与五工作流，规则和hooks不绕过；PR模板生成的草稿仍需负责人完善。范围与恢复方式见 零基础操作说明。
日常文件清单支持全选/全不选。“跳到底部”可直接滚到当前筛选结果的最后一个文件，不改变勾选；聚焦文件列表后，也可按 Ctrl+End（Windows）、⌘+End 或 ⌘+↓（Mac）跳到底部；Ctrl+Home（Windows）、⌘+Home 或 ⌘+↑（Mac）跳到顶部，输入框内保留文本快捷键。在“按目录筛选”中选择目录后，列表立即只显示该目录及子目录中符合当前名称/类型筛选的文件，隐藏文件取消勾选；选择“全部目录”恢复完整结果。“清除筛选条件”一次清空名称、类型和目录筛选，保留已有勾选，不修改文件。“丢弃筛选文件的修改…”对当前筛选出的全部文件生效，不以勾选为准；确认清单后先备份，再丢弃暂存及未暂存修改并恢复到本机 HEAD，新增文件会被移除。点“全选此目录”或聚焦列表按 Ctrl/⌘+A 勾选当前筛选结果；根目录文件单独筛选，不含子目录。Shift 点击复选框可连续勾选或取消；Ctrl（Windows）/⌘（Mac）点击可切换单个文件，聚焦列表后 Ctrl/⌘+A 全选当前筛选结果，Esc 取消全选（保留 Ctrl/⌘+Shift+A）。输入框内仍使用文本全选。提交时可选择当前项目“分配给我的”或“我创建的”开放GitHub Issue，提交前重验，提交记录与PR描述保留链接；关联不自动关闭Issue。读取使用当前本机gh账号，不新增凭证输入或后台跨项目扫描。
基础 Git 更新会先获取远端并在隔离副本中预检冲突，通过后暂存本地修改、快进更新，再取回修改与原暂存状态。安全备份保留；冲突和不确定结果不会自动重放。SSH 身份按项目绑定，不改全局 SSH 配置。
确认前重新核验文件与规则，后台空闲退出不再使页面持有的旧凭据阻断后续操作。获取远端或预检已明确失败、且尚未进入本地修改阶段时，处理原因后可点“重新检查”再发起更新；暂存、合并、取回或上传结果不确定时需负责人核对。
规则读取保持有界：最多 80 个唯一文件、单文件 128 KiB、合计 1 MiB。超限仍禁用写操作。
恢复回归可运行 node tests/recovery-ui-check.mjs，覆盖后台重启、真实规则变化、连续失败恢复和不确定结果保护；该界面回归需要已安装开发依赖与 Playwright Chromium。
查看改动、发布页均提供“对比线上”和“还原”；双击文件名或键盘 Enter 在 Cindy 右侧栏打开只读差异快照，独立桌面在应用内查看。对比时获取 origin 最新版本：优先当前分支跟踪的 origin 分支，没有跟踪则明确使用 origin 默认分支；页面显示目标分支、提交及检查时间。失败不冒用缓存为线上结果，不拉取或改工作区。二进制/LFS 文件可能只显示变化摘要；超过 1MB、链接、目录与子模块转专业工具。
还原需逐文件确认，丢弃该文件工作区和暂存区改动，恢复本机 HEAD（不是线上版本），新增文件移除；其他文件不动。项目规则有人工前提时须确认，正常规则和 hooks 就绪检查仍保留。先在 Git 元数据目录 jixin-file-backups// 保存 staged.patch、worktree.patch、原文件及 record.json；还原结果不确定时 jixin-file-revert.json 阻止新写操作，联系负责人核对备份和真实状态，不自动重放。冲突和改名文件不提供还原。备份不是自动执行的补丁，负责人可在核对相同 HEAD 后先恢复暂存补丁，再恢复工作区补丁；新增文件从 local-file 恢复并核对 record.json 的原权限。
新增权限仅为 preview.hosts 的127.0.0.1：通过公开 cindy.preview 打开插件生成的本机只读差异页，不修改 Cindy 源码。页面由随机路径令牌保护，15分钟到期，禁止脚本、外部资源及写入，最多保留12份快照；Worker空闲退出后页面无法重新加载，重新双击文件生成新预览。宿主预览有5秒间隔限制，失败后可手动再试。
还原结果不确定时，可刷新并在页面点击“核对上次还原结果”；核对实际文件、暂存区与备份后显式确认，仅解锁后续新操作，不会重放旧操作。
还原期间就地显示备份与还原提示，失败保留原因和可展开详情；“重新检查还原结果”只读取文件及操作记录，不再次还原。获取或预检阶段已结束、尚未改动本地文件的更新失败不再误锁文件还原；正在运行或已进入本地变更但结果不确定的操作仍须先核对。可运行 node tests/file-restore-recovery-ui-check.mjs 验证 300 个改动中精确还原 75 个 JSON、请求/读取失败恢复与回执丢失不重放（模拟 Host 边界，非已安装 Windows 实测）。
上传显示保存检查、上传、送审等真实阶段及耗时；完成表示等待团队审核。步骤详情、选择快捷键及可选关联事项默认收起。更新冲突可选择“AI 协助处理…”，补充要求后在 Cindy 任务列表回答 AI 的选择问题；修复后点击“处理后检查并继续”，仍需重新预检并确认更新。不会根据 AI 回复直接判定修复成功或重复不确定操作。独立应用暂未接入 AI 修复，保留人工处理后的检查入口。
AI诊断点击“开始诊断”即读取脱敏状态并调用模型，只展示简短的原因、下一步和验证，不展示发送快照或提示词。插件同时提供 diagnose_issue 与 assist_update_conflict 聊天工具，使用与界面一致的正式 AI 服务；后者将 Host callId 原样转给任务接口，按稳定 requestId 去重。
高级胶囊栏新增“更新 UE 引擎”。只检查已保存的“流程文件位置”根目录下的 UPDATE_UE5.md；未单独设置流程目录时使用执行项目根目录。不递归查找，不提供或改写该文件。缺失、空文件、符号链接或不可读时入口置灰，悬停、键盘聚焦及点击仍说明原因；重新检查后更新可用状态。原五个工作流不受影响。
有效入口通过正式 Cindy 任务接口新建独立任务，先读取实际流程与引擎路径。自动定位失败、路径失效或候选不唯一时，在同一任务中请用户手动选择引擎根目录（无目录选择工具时提供完整路径），校验目录与版本后继续预检；选错可重选，无需再次点击更新。选择目录不代表确认更新。要求任务只读检查各磁盘空间、更新规模及耗时依据，在任务聊天中显示预检报告并等待用户明确确认；空间不足或容量依据不足时停止。耗时无法可靠估计时如实提示，不编造固定时长。确认后才按文件更新引擎，结果及进度沿用执行记录。此为 Agent 工作流约束，实际操作仍受任务权限与宿主授权管理；不是插件直接执行升级脚本。未知回执不重发。