Skip to content

v0.2.0 — 工作文档与规范

Choose a tag to compare

@ThinkofRain1213 ThinkofRain1213 released this 13 Oct 07:56
· 132 commits to main since this release

新增「工作文档」能力,并修掉若干数据丢失问题。

新增

  • 工作文档:每个项目一份 markdown 文档,统一存放在 $DSH_HOME/project-groups/,
    随会话注入。文档记录的是项目在做什么、做到哪、下一步,因此需要一套结构。
  • 文档规范,三种来源,可在设置页选择:
    • 无——不更新格式:无既定格式则自由书写,有既定格式则在其基础上书写;
    • 默认——插件内置规范,随包分发,插件升级即自动生效;
    • 自定义——上传你自己的 md 规范,可逐个上传 / 切换 / 删除,大小不限。
  • 规范变更检测:规范的身份是内容哈希,所以覆盖同名规范、或插件升级改动内置规范,
    都会被检出。发现文档按旧规范写时,注入要求模型先问你:
    「按新规范重写 / 本次忽略 / 在规范再次变更前忽略」。选重写则按
    spec/REWRITE-FLOW.md 执行,其唯一硬约束是不得因格式迁移而丢失信息。
  • 每项目规范覆盖:开启「为每项目单独调整文档规范」后,新建与编辑项目对话框多出一行
    下拉栏(跟随全局 / 无 / 默认 / 各已上传规范),让单个项目偏离全局选择。
  • 注入开关:「注入项目信息」「注入项目文档」两个开关,关闭后规范组整体禁用。

修复

  • 新建项目时选的规范不再丢失——之前下拉栏能选、能显示,但保存时被静默丢弃
    (客户端动作只解构了 title 与 directories)。同时给两条写入路径加上同一个校验器,
    避免"同一个值能不能存取决于开的是哪个对话框"。
  • 「默认」可作为项目规范存入——之前被文件名校验拦下,选它保存会静默保留原值;
    即使写进去,解析时也没有对应分支,会退到全局选择,与对话框显示的正好相反。
  • 「无」不再触发重写询问——之前会要求模型按一个不存在的规范重构文档。
    「无」的含义是不更新格式,没有迁移目标。
  • 并发写入不再丢字段——同时切换规范模式与文件名时,实测 12/12 次丢失一个字段,现已串行化。
  • 新建项目只出现一次——之前会从列表底部滑入(记录写入与顺序写入之间的中间帧可见)。
  • 门控卡片改按颜色变暗,不再用透明度——透明度会让卡片成为独立合成层,
    点任意开关时闪一下。

变更

  • 新建项目现在会同时打开一个会话,与官方「添加工作区」流程一致。
  • 「自定义」卡片在无可用规范时显示橙色说明,且颜色随高亮变化:只有当你正在用这一格时,
    它的空才值得警告。
  • 未选中规范时的提示改为行内一行,不再弹出第二层对话框(原先那个弹窗的「取消」
    会把整个对话框一起关掉)。

内部

  • vendored 上游客户端源码现有 60 条登记 patch、涉及 11 个文件。
  • pnpm check 覆盖 652 条断言(11 个校验脚本 + 探针);
    另有 pnpm probe:doc-spec(131 条浏览器端到端断言)需要真实 DSH 与可用端口,
    故不在默认链上。
  • 新增 verify:release:守住发布事实——版本号三处一致、locale 描述与功能同步、
    两版 README 结构对等、files 覆盖新增文件。