ChainlessChain 文档

主题

CLI / IDE 与桌面目标草稿互通（开发源码快照） ​

概述 ​

2026-10-18，核对开发源码快照 f21eac547e；本次远端主线文档基线尚不包含该快照的互通代码。现在可以在 CLI、VS Code 或 JetBrains 选择目标、查看已授权插件面板，并把任务说明建议交给桌面审核。公开 CLI 0.166.106、Open VSX 0.37.151、JetBrains 0.4.167 和产品 v5.0.3.140 尚未包含本轮全部互通能力。以下命令供使用匹配该快照构建的开发与验收人员参考；日常安装见升级指南。

核心特性 ​

  • CLI 文件目标独立保存；桌面连接只开放明确选择的项目目标。
  • 摘要与历史证据连接只读，待审草稿连接需要单独授权。
  • 可以导出请求文件后在桌面逐份采纳，也可以授权在线保存待审草稿。
  • 采纳或“已保存”只表示进入待审队列；修改任务仍需原生预览与逐次确认。
  • 结果未知时保留请求引用，查询原请求回执，避免重复提交。

系统架构 ​

桌面保存项目、授权、草稿、转换与任务动作回执。CLI 和 IDE 通过桌面生成的临时本地连接访问指定目标。在线待审连接与原有只读连接相互独立；关闭连接、撤销来源授权和撤销单份采纳分别影响对应的能力与记录。

配置参考 ​

需要匹配的 Session Core、CLI、IDE 与桌面源码构建，Node.js 22.12.0+、npm 10.0.0+。新 Session Core 出口尚未公开，不能仅安装当前 npm .106 获得本页功能。

先在桌面登录当前项目所有者账号，打开项目目标与风险建议面板，选择目标并创建所需连接。插件必须已安装、可信且已获所需能力同意。参数中的目标、插件、安装范围和来源 ID 必须来自当前面板；user、project、local 是不同的安装范围。

使用示例 ​

先确认命令可用，再选择目标。以下使用 PowerShell；大写示例值需替换为实际内容，命令不调用模型。

powershell
cc goal --help
cc goal catalog --limit 20 --json
cc goal catalog --connection .\goal-connection.json --json
cc goal panels GOAL_ID --plugin PLUGIN_NAME --scope user --connection .\goal-connection.json --json

离线移交：准备 UTF-8 的 description.txt，从桌面复制当前风险建议 ID，导出到尚不存在的文件。

powershell
cc goal draft-request GOAL_ID --connection .\goal-connection.json --plugin PLUGIN_NAME --scope user --source PROPOSAL_ID --request-id request-001 --title "任务说明建议" --description-file .\description.txt --out .\draft-request.json --json

在桌面的草稿导入面板选择 draft-request.json，核对完整正文和来源后采纳。然后打开已保存草稿，生成当前预览，核对差异并完成原生确认。导出文件、采纳和创建预览是不同步骤。

在线提交：先导出插件来源请求，在桌面逐项核对并单独授权待审草稿连接；使用桌面返回的 v3 连接文件。

powershell
cc goal draft-access --plugin PLUGIN_NAME --scope user --out .\draft-access.json --json
cc goal draft-sources GOAL_ID --connection .\draft-connection.json --plugin PLUGIN_NAME --scope user --json
cc goal draft-send GOAL_ID --connection .\draft-connection.json --plugin PLUGIN_NAME --scope user --source PROPOSAL_ID --request-id request-002 --title "任务说明建议" --description-file .\description.txt --record .\submission.json --json
cc goal draft-receipt GOAL_ID --connection .\draft-connection.json --plugin PLUGIN_NAME --scope user --record .\submission.json --json

draft-send 在发送前保存 submission.json。出现 unknown 或断连时保留该文件，用最后一条命令查询；已有引用只查询，不自动重发。not-found 只表示查询当时未找到，不能据此删除引用重新发送。IDE 插件管理面板也提供对应目标、面板、文件导出和待审提交入口，仍需相同桌面授权。

性能指标 ​

目标目录及在线来源每页最多扫描 20 个候选；使用返回游标继续读取。说明正文最多 8192 UTF-8 字节，离线请求信封最多 16 KiB。这些是边界限制；尚无真实 GUI 延迟、任务成功率或业务效果改善结论。

测试覆盖 ​

已验证授权、撤权、幂等、冲突正文、断连回执恢复、SQLite 事务及打包出口。在线批次记录 52 个独立文件、943 项通过、3 项 Windows 符号链接用例跳过，与其他批次重叠，不累计求和。登录、窗口和部分界面使用替身，不能视为真实 Electron / IDE GUI 验收或公开版本准入。

安全考虑 ​

请求文件和插件标签属于不可信输入，digest 不证明插件代码身份。不要共享连接文件；连接含访问凭据。撤销待审来源后旧草稿和未执行意图失效，已完成动作保留按权限可读的历史。原生确认仍由桌面当前身份完成，CLI 或插件不能代为批准。

故障排查 ​

  • 找不到新命令：当前公开 .106 尚无本页全部能力，确认使用匹配源码构建，勿把候选号当作已发布版本安装。
  • 没有可用面板：检查目标所属存储、插件安装范围、信任和能力同意；只读摘要授权不包含历史证据或待审写入。
  • 已保存但不能继续：来源、目标版本或授权已变化，回到桌面重新读取当前风险建议；旧结果不能覆盖当前状态。
  • 来源授权过期或已撤销：重新核对并由桌面显式授权，原连接不会自动获得新权限。
  • 提交结果未知：保留原引用并查询回执。勿换 request ID 重发；勿把未找到等同于从未保存。

关键文件 ​

packages/cli/src/commands/goal.js 定义命令；Session Core 的 project-goal-external-drafts.js 与 project-goal-draft-imports.js 保存在线和离线草稿；桌面 project-goal-ipc.js 及目标面板执行原生审核；两个 IDE 的插件管理器提供相同操作入口。

相关文档 ​

参见项目目标与独立验收、组织项目、当前升级指南和本轮设计。

基于 MIT 许可发布

Copyright © 2024-2026 ChainlessChain Team