@chengzhao-dev/dsh-cpp-workflow 0.6.2 → 0.6.4

package/README.en.md

@@ -19,13 +19,13 @@ The exception material follows the C++ Core Guidelines' Error handling section a
 Pinned npm install:
 
 ```bash
-dsh plugin --profile web add npm:@chengzhao-dev/dsh-cpp-workflow@0.6.2
+dsh plugin --profile web add npm:@chengzhao-dev/dsh-cpp-workflow@0.6.4
 ```
 
 The matching Git tag:
 
 ```bash
-dsh plugin --profile web add github:chengzhao-dev/dsh-cpp-workflow#v0.6.2
+dsh plugin --profile web add github:chengzhao-dev/dsh-cpp-workflow#v0.6.4
 ```
 
 The desktop app owns the `desktop` profile. If the command-line `add` is rejected, add the plugin in the app settings and use the same pinned npm version. A Git tag install uses the prebuilt `lib/` committed in the repository and runs no build on the target machine; the package has no install script that needs approval.

package/README.md

@@ -19,13 +19,13 @@
 npm 安装钉死版本：
 
 ```bash
-dsh plugin --profile web add npm:@chengzhao-dev/dsh-cpp-workflow@0.6.2
+dsh plugin --profile web add npm:@chengzhao-dev/dsh-cpp-workflow@0.6.4
 ```
 
 同版本的 Git 标签：
 
 ```bash
-dsh plugin --profile web add github:chengzhao-dev/dsh-cpp-workflow#v0.6.2
+dsh plugin --profile web add github:chengzhao-dev/dsh-cpp-workflow#v0.6.4
 ```
 
 桌面应用独占 `desktop` profile。命令行 `add` 被拒绝时，在应用设置里添加插件，地址填同一个 npm 版本。Git 标签安装使用仓库内已构建的 `lib/`，不在目标机器上重新构建；包内也不含需要授权执行的安装脚本。

package/lib/client.js

@@ -42,6 +42,7 @@ const TAG_TEXT = {
 };
 /** 开关型标签在设置页的标题。 */
 const TAG_LABEL = {
+    file: '@file',
     brief: '@brief',
     author: '@author',
     date: '@date',
@@ -194,10 +195,7 @@ function snapshotText(raw) {
 
 // 客户端半侧：设置导航里的「C++ 工程流程」页与插件页的配置卡片共用同一个组件。
 // 标签策略在本文件上方内联（由 scripts/building-client.mjs 从 src/comment-policy.js
-// 拼进来），所以预览、默认值与服务端快照永远同源；这里只做表单与排版。
-//
-// 版式参照 VS Code 设置页：左侧标签与说明、右侧控件，行间细分隔线；
-// 修改过默认值的行在标签前加一个圆点，底部固定一条保存栏。
+// 拼进来），所以预览、默认值与服务端快照永远同源；这里只做表单与外观。
 const React = require('react')
 const h = React.createElement
 
@@ -206,67 +204,75 @@ const PACKAGE_NAME = '@chengzhao-dev/dsh-cpp-workflow'
 const STRINGS = {
   zh: {
     nav: 'C++ 工程流程',
-    title: '文档注释',
-    intro: '设置文件头与函数声明注释里默认写出的 Doxygen 标签；改动影响之后写出的注释，已有源码保持原样。',
+    eyebrow: '文档注释',
+    title: '注释默认带哪些标签',
+    intro: '这里只决定代理新写注释时的默认值。源码里已有的注释不会被改写；保存后，下一次读取技能时生效。',
     header: '文件头',
-    headerHint: '每个手写源文件开头的一段 /// 注释。',
-    contract: '函数契约',
-    contractHint: '函数声明注释里要求的参数与失败信息。',
+    headerHint: '每个手写源文件开头的 /// 注释块。',
+    briefHint: '一句话说明这个文件定义或实现什么。留空时，每个文件自己写。',
+    authorHint: '作者署名。默认不写；打开并填写后才写进文件头。',
+    dateHint: '创建或最后修改日期。默认不写。',
+    copyrightHint: '版权声明。默认不写。',
+    versionHint: '文件版本号。默认不写。',
+    paramHint: '函数参数的含义、范围或所有权。',
+    returnHint: '返回值在什么条件下成立。返回类型自明时可以省略。',
+    throwsHint: '抛出的异常类型与条件。不抛异常的函数不写。',
+    contractHint: '函数声明的注释里必须交代的参数与失败信息。',
     extra: '更多标签',
-    extraHint: '需要时在单个函数上补写。',
-    file: '@file',
-    fileHint: '取自当前文件名。',
-    briefHint: '一句话说明这个文件定义或实现什么；留空则由文件自述。',
-    authorHint: '作者署名；留空不写。',
-    dateHint: '创建或修改日期；留空不写。',
-    copyrightHint: '版权声明；留空不写。',
-    versionHint: '文件版本号；留空不写。',
-    emptyValue: '留空不写',
-    briefEmpty: '留空则由文件自述',
+    extraHint: '默认关闭，需要时在单个函数上补写。',
     preview: '预览',
-    previewHint: '按当前开关生成；文件名以占位符表示。',
+    previewHint: '按当前开关生成，文件名用占位符表示。',
     save: '保存',
-    reset: '重置',
+    reset: '恢复出厂值',
     saved: '已保存，下一次读取技能时生效。',
-    rejected: '宿主拒绝了这次保存：配置可能已在别处修改，请重置后再试。',
-    unsaved: '有未保存的改动。',
+    rejected: '保存被拒绝：配置可能已在别处修改，请恢复出厂值后再试。',
+    unsaved: '有未保存的改动',
     loading: '正在读取配置…',
     unreadable: '当前账户不能修改这份配置。',
-    readOnly: '此处显示出厂值；修改在「插件」页的配置卡片里进行。',
+    readOnly: '这里显示出厂值。要改，请到「插件」页打开 dsh-cpp-workflow 的配置卡片。',
     openSettings: '打开插件配置',
-    modified: '与出厂值不同',
+    fixed: '跟随文件名',
+    fixedHint: '值由实际文件决定，不写进配置。',
+    emptyValue: '留空则由文件自己写',
+    blankBrief: '留空则文件自述',
+    on: '写出',
+    off: '不写',
   },
   en: {
     nav: 'C++ Workflow',
-    title: 'Documentation comments',
-    intro: 'Choose the Doxygen tags written by default in file headers and declaration comments. Changes affect new comments; existing sources stay as they are.',
+    eyebrow: 'Doxygen comments',
+    title: 'Which tags comments carry by default',
+    intro: 'These defaults apply to comments the agent writes from now on. Existing sources are never rewritten; saving takes effect on the next skill read.',
     header: 'File header',
-    headerHint: 'The /// block at the top of every hand-written source.',
-    contract: 'Function contract',
-    contractHint: 'Parameter and failure tags required in declaration comments.',
+    headerHint: 'The /// block at the top of each hand-written source file.',
+    briefHint: 'One sentence saying what the file defines or implements. Leave the value to each file.',
+    authorHint: 'Author name. Off by default; written only when filled.',
+    dateHint: 'Created or last modified date. Off by default.',
+    copyrightHint: 'Copyright notice. Off by default.',
+    versionHint: 'File version. Off by default.',
+    paramHint: 'Meaning, range, or ownership of a parameter.',
+    returnHint: 'When the returned value holds. Optional when the type is self-evident.',
+    throwsHint: 'Exception type and condition. Omitted when the function does not throw.',
+    contractHint: 'Parameters and failure information every function comment must carry.',
     extra: 'More tags',
-    extraHint: 'Add them per function when needed.',
-    file: '@file',
-    fileHint: 'Taken from the current file name.',
-    briefHint: 'One sentence about what this file defines; leave empty and the file writes its own.',
-    authorHint: 'Author credit; left empty, omitted.',
-    dateHint: 'Creation or change date; left empty, omitted.',
-    copyrightHint: 'Copyright notice; left empty, omitted.',
-    versionHint: 'File version; left empty, omitted.',
-    emptyValue: 'Empty means omit',
-    briefEmpty: 'Empty: the file writes its own',
+    extraHint: 'Off by default; add them per function when needed.',
     preview: 'Preview',
-    previewHint: 'Generated from the switches; the file name is a placeholder.',
+    previewHint: 'Generated from the switches above; the file name is a placeholder.',
     save: 'Save',
-    reset: 'Reset',
+    reset: 'Restore defaults',
     saved: 'Saved; the next skill read uses it.',
-    rejected: 'The host rejected the save: the config changed elsewhere. Reset and try again.',
-    unsaved: 'Unsaved changes.',
+    rejected: 'The host rejected the save: the config changed elsewhere. Restore defaults and try again.',
+    unsaved: 'Unsaved changes',
     loading: 'Reading configuration…',
     unreadable: 'This account cannot edit the configuration.',
-    readOnly: 'Factory values are shown here; edit them on the Plugins page.',
+    readOnly: 'Showing factory defaults. Edit the dsh-cpp-workflow card on the Plugins page.',
     openSettings: 'Open plugin settings',
-    modified: 'Differs from the factory value',
+    fixed: 'Follows the file name',
+    fixedHint: 'Derived from the file itself, never stored in the config.',
+    emptyValue: 'Leave empty and each file writes its own',
+    blankBrief: 'Leave empty for each file',
+    on: 'Write',
+    off: 'Omit',
   },
 }
 
@@ -279,201 +285,183 @@ function t() {
   return STRINGS[language()]
 }
 
-const palette = {
-  label: 'var(--dsw-alias-label-primary, inherit)',
-  muted: 'var(--dsw-alias-label-secondary, #6b7280)',
-  line: 'var(--dsw-alias-border-l2, rgba(127, 127, 127, 0.24))',
-  surface: 'var(--dsw-alias-bg-layer-2, rgba(127, 127, 127, 0.06))',
-  field: 'var(--dsw-alias-bg-layer-1, rgba(127, 127, 127, 0.04))',
-  brand: 'var(--dsw-alias-brand-primary, #4f6bed)',
-  mono: 'ui-monospace, SFMono-Regular, Menlo, Consolas, monospace',
-}
+const STYLE_ID = 'dsh-cpp-workflow-settings'
 
-const descriptionStyle = () => ({ margin: '2px 0 0', fontSize: 12, lineHeight: 1.55, color: palette.muted })
-const sectionTitleStyle = () => ({ margin: '0 0 2px', fontSize: 13, fontWeight: 600, color: palette.label })
+// 外观只用宿主变量与两档中性色；没有变量时回落到浅色主题的一组合法颜色。
+const CSS = `
+.dcw-page{--dcw-fg:var(--dsw-alias-label-primary,#1f2328);--dcw-muted:var(--dsw-alias-label-secondary,#69707d);--dcw-faint:var(--dsw-alias-label-tertiary,#8a919c);--dcw-border:var(--dsw-alias-border-l2,rgba(31,35,40,.14));--dcw-bg1:var(--dsw-alias-bg-layer-1,#fff);--dcw-bg2:var(--dsw-alias-bg-layer-2,rgba(31,35,40,.035));--dcw-accent:var(--dsw-alias-brand-primary,#2f6fed);--dcw-danger:var(--dsw-alias-state-error-primary,#c0392b);color:var(--dcw-fg);max-width:760px;padding:2px 0 12px;font-size:13px;line-height:1.6}
+.dcw-head{margin:0 0 14px}
+.dcw-eyebrow{margin:0 0 4px;color:var(--dcw-muted);font-size:11.5px;letter-spacing:.02em}
+.dcw-title{margin:0 0 6px;font-size:16px;font-weight:620;letter-spacing:.005em}
+.dcw-lede{margin:0;color:var(--dcw-muted);font-size:12.5px;line-height:1.65;max-width:64ch}
+.dcw-note{display:flex;gap:8px;align-items:center;margin:12px 0 0;padding:9px 11px;border:1px solid var(--dcw-border);border-radius:8px;background:var(--dcw-bg2);color:var(--dcw-muted);font-size:12px;line-height:1.55}
+.dcw-note[data-tone="warn"]{color:var(--dcw-danger);border-color:color-mix(in srgb,var(--dcw-danger) 35%,transparent)}
+.dcw-note-dot{flex:none;width:6px;height:6px;border-radius:50%;background:currentColor;opacity:.55}
+.dcw-card{margin:14px 0 0;border:1px solid var(--dcw-border);border-radius:10px;background:var(--dcw-bg1);overflow:hidden}
+.dcw-card-head{display:flex;flex-wrap:wrap;align-items:baseline;gap:4px 10px;padding:11px 14px 9px;border-bottom:1px solid var(--dcw-border);background:var(--dcw-bg2)}
+.dcw-card-title{margin:0;font-size:12.5px;font-weight:620;letter-spacing:.01em}
+.dcw-card-hint{margin:0;color:var(--dcw-muted);font-size:11.5px;line-height:1.5}
+.dcw-row{display:grid;grid-template-columns:88px minmax(0,1fr);gap:2px 14px;padding:9px 14px;border-top:1px solid var(--dcw-border)}
+.dcw-row:first-of-type{border-top:0}
+.dcw-row-label{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:12px;color:var(--dcw-fg);padding-top:3px}
+.dcw-row-control{display:flex;flex-wrap:wrap;align-items:center;gap:6px 10px;min-width:0}
+.dcw-row-hint{flex-basis:100%;margin:0;color:var(--dcw-muted);font-size:11.5px;line-height:1.55}
+.dcw-row-fixed .dcw-row-control{gap:8px}
+.dcw-static{display:inline-flex;align-items:center;gap:6px;height:26px;padding:0 9px;border:1px dashed var(--dcw-border);border-radius:6px;background:var(--dcw-bg2);color:var(--dcw-muted);font-size:12px}
+.dcw-static svg{flex:none;opacity:.7}
+.dcw-switch{position:relative;display:inline-flex;align-items:center;flex:none;width:34px;height:20px;cursor:pointer}
+.dcw-switch input{position:absolute;inset:0;margin:0;opacity:0;cursor:pointer}
+.dcw-track{position:absolute;inset:0;border-radius:999px;background:color-mix(in srgb,var(--dcw-fg) 18%,transparent);transition:background .16s ease}
+.dcw-knob{position:absolute;top:2px;left:2px;width:16px;height:16px;border-radius:50%;background:#fff;box-shadow:0 1px 2px rgba(0,0,0,.25);transition:transform .16s ease}
+.dcw-switch input:checked + .dcw-track{background:var(--dcw-accent)}
+.dcw-switch input:checked + .dcw-track .dcw-knob{transform:translateX(14px)}
+.dcw-switch input:focus-visible + .dcw-track{outline:2px solid var(--dcw-accent);outline-offset:2px}
+.dcw-switch input:disabled + .dcw-track{opacity:.4}
+.dcw-switch input:disabled{cursor:default}
+.dcw-state{color:var(--dcw-faint);font-size:11.5px;min-width:28px}
+.dcw-input{flex:1 1 220px;min-width:0;height:28px;padding:0 9px;border:1px solid var(--dcw-border);border-radius:6px;background:transparent;color:var(--dcw-fg);font:inherit;font-size:12.5px}
+.dcw-input::placeholder{color:var(--dcw-faint)}
+.dcw-input:focus{outline:none;border-color:var(--dcw-accent);box-shadow:0 0 0 3px color-mix(in srgb,var(--dcw-accent) 18%,transparent)}
+.dcw-input:disabled{background:var(--dcw-bg2);color:var(--dcw-faint)}
+.dcw-flags{display:grid;grid-template-columns:repeat(auto-fit,minmax(150px,1fr));gap:0 16px;padding:4px 14px 8px}
+.dcw-flag{display:flex;flex-direction:column;gap:3px;padding:7px 0}
+.dcw-flag .dcw-row-label{padding-top:0;display:flex;align-items:center;gap:8px;justify-content:space-between}
+.dcw-card>summary{display:flex;align-items:center;justify-content:space-between;gap:8px;padding:11px 14px;cursor:pointer;list-style:none}
+.dcw-card details>summary::-webkit-details-marker{display:none}
+.dcw-card details>summary::marker{content:''}
+.dcw-card>summary:hover{background:var(--dcw-bg2)}
+.dcw-chevron{transition:transform .16s ease;color:var(--dcw-muted)}
+.dcw-card[open] .dcw-chevron{transform:rotate(90deg)}
+.dcw-preview{margin:0;padding:11px 14px 13px;border-top:1px solid var(--dcw-border);overflow-x:auto;background:var(--dcw-bg2);font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:12px;line-height:1.7;white-space:pre;color:var(--dcw-fg)}
+.dcw-actions{display:flex;flex-wrap:wrap;align-items:center;gap:10px;margin-top:14px;padding:11px 2px 4px;border-top:1px solid var(--dcw-border)}
+.dcw-btn{height:30px;padding:0 13px;border:1px solid var(--dcw-border);border-radius:7px;background:var(--dcw-bg1);color:var(--dcw-fg);font:inherit;font-size:12.5px;cursor:pointer}
+.dcw-btn:hover:enabled{border-color:color-mix(in srgb,var(--dcw-fg) 32%,transparent)}
+.dcw-btn:focus-visible{outline:2px solid var(--dcw-accent);outline-offset:1px}
+.dcw-btn:disabled{opacity:.45;cursor:default}
+.dcw-btn-primary{background:var(--dcw-accent);border-color:transparent;color:var(--dsw-alias-label-primary-foreground,#fff)}
+.dcw-btn-primary:hover:enabled{filter:brightness(1.06)}
+.dcw-status{flex:1 1 200px;margin:0;color:var(--dcw-muted);font-size:12px}
+.dcw-status[data-tone="warn"]{color:var(--dcw-danger)}
+.dcw-status[data-tone="ok"]{color:var(--dsw-alias-state-success-primary,#1a7f37)}
+@media (max-width:640px){.dcw-row{grid-template-columns:1fr;gap:4px}.dcw-row-label{padding-top:0}.dcw-flags{grid-template-columns:1fr}.dcw-flag:nth-child(2){border-top:1px solid var(--dcw-border)}}
+`
 
-function Section(props) {
+function ensureStyles() {
+  if (typeof document === 'undefined' || !document.createElement) return
+  if (document.querySelector && document.querySelector(`style[data-plugin-css="${STYLE_ID}"]`)) return
+  const style = document.createElement('style')
+  style.dataset.pluginCss = STYLE_ID
+  style.textContent = CSS
+  if (document.head && document.head.appendChild) document.head.appendChild(style)
+}
+
+function Switch(props) {
   return h(
-    'section',
-    {
-      style: {
-        marginTop: props.first ? 16 : 22,
-        paddingTop: props.first ? 0 : 14,
-        borderTop: props.first ? 'none' : `1px solid ${palette.line}`,
-      },
-    },
-    h('h4', { style: sectionTitleStyle() }, props.title),
-    props.description ? h('p', { style: descriptionStyle() }, props.description) : null,
-    h('div', { style: { marginTop: 6 } }, props.children),
+    'span',
+    { className: 'dcw-switch' },
+    h('input', {
+      type: 'checkbox',
+      checked: Boolean(props.checked),
+      disabled: Boolean(props.disabled),
+      'aria-label': props.label,
+      onChange: (event) => props.onChange(event.target.checked),
+    }),
+    h('span', { className: 'dcw-track' }, h('span', { className: 'dcw-knob' })),
   )
 }
 
-function Row(props) {
+function LockIcon() {
   return h(
-    'div',
-    {
-      style: {
-        display: 'grid',
-        gridTemplateColumns: 'minmax(0, 1fr) minmax(160px, 240px)',
-        columnGap: 24,
-        alignItems: 'start',
-        padding: '10px 0',
-        borderBottom: `1px solid ${palette.line}`,
-      },
-    },
-    h(
-      'div',
-      { style: { minWidth: 0 } },
-      h(
-        'div',
-        { style: { display: 'flex', alignItems: 'center', gap: 6, minHeight: 20 } },
-        props.modified
-          ? h('span', {
-              key: 'dot',
-              title: props.modifiedLabel,
-              'aria-label': props.modifiedLabel,
-              style: { width: 6, height: 6, borderRadius: '50%', background: palette.brand, flex: 'none' },
-            })
-          : null,
-        h('span', { style: { fontSize: 13, lineHeight: '20px', color: palette.label, fontFamily: props.mono ? palette.mono : 'inherit' } }, props.label),
-      ),
-      props.description ? h('p', { style: descriptionStyle() }, props.description) : null,
-    ),
-    h(
-      'div',
-      { style: { display: 'flex', alignItems: 'center', justifyContent: 'flex-end', gap: 8, minHeight: 20 } },
-      props.control,
-    ),
+    'svg',
+    { width: 12, height: 12, viewBox: '0 0 16 16', 'aria-hidden': 'true', focusable: 'false' },
+    h('path', {
+      fill: 'currentColor',
+      d: 'M8 1a3 3 0 0 0-3 3v2H4.5A1.5 1.5 0 0 0 3 7.5v5A1.5 1.5 0 0 0 4.5 14h7a1.5 1.5 0 0 0 1.5-1.5v-5A1.5 1.5 0 0 0 11.5 6H11V4a3 3 0 0 0-3-3Zm2 5H6V4a2 2 0 1 1 4 0v2Z',
+    }),
   )
 }
 
-function Checkbox(props) {
+function Chevron() {
   return h(
-    'button',
-    {
-      type: 'button',
-      role: 'checkbox',
-      'aria-checked': Boolean(props.checked),
-      'aria-label': props.label,
-      disabled: Boolean(props.disabled),
-      onClick: () => props.onChange(!props.checked),
-      style: {
-        flex: 'none',
-        width: 16,
-        height: 16,
-        padding: 0,
-        borderRadius: 4,
-        border: `1px solid ${props.checked ? palette.brand : palette.line}`,
-        background: props.checked ? palette.brand : 'transparent',
-        display: 'inline-flex',
-        alignItems: 'center',
-        justifyContent: 'center',
-        cursor: props.disabled ? 'default' : 'pointer',
-        opacity: props.disabled ? 0.55 : 1,
-        transition: 'background-color 0.12s ease, border-color 0.12s ease',
-      },
-    },
-    h(
-      'svg',
-      { width: 11, height: 11, viewBox: '0 0 12 12', 'aria-hidden': 'true' },
-      h('path', {
-        d: 'M2.6 6.3 5 8.7l4.4-5.2',
-        fill: 'none',
-        stroke: '#fff',
-        strokeWidth: 1.7,
-        strokeLinecap: 'round',
-        strokeLinejoin: 'round',
-        opacity: props.checked ? 1 : 0,
-      }),
-    ),
+    'svg',
+    { className: 'dcw-chevron', width: 12, height: 12, viewBox: '0 0 16 16', 'aria-hidden': 'true', focusable: 'false' },
+    h('path', { fill: 'currentColor', d: 'M6 3.5 10.5 8 6 12.5 4.9 11.4 8.3 8 4.9 4.6Z' }),
   )
 }
 
+const HINT_KEY = {
+  brief: 'briefHint',
+  author: 'authorHint',
+  date: 'dateHint',
+  copyright: 'copyrightHint',
+  version: 'versionHint',
+  param: 'paramHint',
+  returns: 'returnHint',
+  throws: 'throwsHint',
+}
+
 function ValueRow(props) {
   const s = props.strings
   const entry = props.entry
-  return h(Row, {
-    label: TAG_LABEL[props.tag],
-    mono: true,
-    description: props.hint,
-    modified: props.modified,
-    modifiedLabel: s.modified,
-    control: [
-      h(Checkbox, {
-        key: 'check',
+  return h(
+    'div',
+    { className: 'dcw-row' },
+    h('div', { className: 'dcw-row-label' }, TAG_LABEL[props.tag]),
+    h(
+      'div',
+      { className: 'dcw-row-control' },
+      h(Switch, {
         label: TAG_LABEL[props.tag],
         checked: entry.enabled,
         disabled: props.disabled,
         onChange: (enabled) => props.onChange({ ...entry, enabled }),
       }),
+      h('span', { className: 'dcw-state', 'aria-hidden': 'true' }, entry.enabled ? s.on : s.off),
       h('input', {
-        key: 'input',
+        className: 'dcw-input',
         type: 'text',
         value: entry.value,
-        placeholder: props.tag === 'brief' ? s.briefEmpty : s.emptyValue,
+        placeholder: props.tag === 'brief' ? s.blankBrief : s.emptyValue,
         disabled: props.disabled || !entry.enabled,
-        'aria-label': TAG_LABEL[props.tag],
+        'aria-label': `${TAG_LABEL[props.tag]} 的值`,
         onChange: (event) => props.onChange({ ...entry, value: event.target.value }),
-        style: {
-          width: '100%',
-          minWidth: 0,
-          fontSize: 13,
-          lineHeight: '18px',
-          padding: '3px 7px',
-          borderRadius: 4,
-          border: `1px solid ${palette.line}`,
-          background: entry.enabled && !props.disabled ? palette.field : 'transparent',
-          color: entry.enabled ? 'inherit' : palette.muted,
-          fontFamily: palette.mono,
-          boxSizing: 'border-box',
-        },
       }),
-    ],
-  })
+      h('p', { className: 'dcw-row-hint' }, s[HINT_KEY[props.tag]] || ''),
+    ),
+  )
 }
 
-function FlagRow(props) {
-  return h(Row, {
-    label: TAG_LABEL[props.tag],
-    mono: true,
-    description: props.hint,
-    modified: props.modified,
-    modifiedLabel: props.strings.modified,
-    control: h(Checkbox, {
-      label: TAG_LABEL[props.tag],
-      checked: Boolean(props.checked),
-      disabled: props.disabled,
-      onChange: (value) => props.onChange(value),
-    }),
-  })
+function Flag(props) {
+  return h(
+    'div',
+    { className: 'dcw-flag' },
+    h(
+      'div',
+      { className: 'dcw-row-label' },
+      TAG_LABEL[props.tag],
+      h(Switch, {
+        label: TAG_LABEL[props.tag],
+        checked: props.checked,
+        disabled: props.disabled,
+        onChange: props.onChange,
+      }),
+    ),
+    h('p', { className: 'dcw-row-hint' }, props.hint || ''),
+  )
 }
 
 function Preview(props) {
   const s = props.strings
   return h(
     'section',
-    { 'aria-label': s.preview, style: { marginTop: 22, paddingTop: 14, borderTop: `1px solid ${palette.line}` } },
-    h('h4', { style: sectionTitleStyle() }, s.preview),
-    h('p', { style: descriptionStyle() }, s.previewHint),
+    { className: 'dcw-card', 'aria-label': s.preview },
     h(
-      'pre',
-      {
-        style: {
-          margin: '8px 0 0',
-          padding: '10px 12px',
-          borderRadius: 6,
-          background: palette.surface,
-          border: `1px solid ${palette.line}`,
-          overflowX: 'auto',
-          fontSize: 12.5,
-          lineHeight: 1.65,
-          fontFamily: palette.mono,
-          whiteSpace: 'pre',
-          color: palette.label,
-        },
-      },
-      previewText(props.config),
+      'div',
+      { className: 'dcw-card-head' },
+      h('h4', { className: 'dcw-card-title' }, s.preview),
+      h('p', { className: 'dcw-card-hint' }, s.previewHint),
     ),
+    h('pre', { className: 'dcw-preview' }, previewText(props.config, SAMPLE_FILE)),
   )
 }
 
@@ -487,12 +475,9 @@ function diffOperations(draft, base) {
   return operations
 }
 
-function isModified(key, draft) {
-  return JSON.stringify(draft[key]) !== JSON.stringify(DEFAULT_CONFIG[key])
-}
-
 function ConfigPage(props) {
   const s = t()
+  ensureStyles()
   const form = props.form
   const initial = React.useMemo(() => normalizeConfig(form && form.state ? form.state.value : undefined), [])
   const [draft, setDraft] = React.useState(initial)
@@ -500,8 +485,11 @@ function ConfigPage(props) {
   const [dirty, setDirty] = React.useState(false)
   const [busy, setBusy] = React.useState(false)
   const [message, setMessage] = React.useState('')
+  const [tone, setTone] = React.useState('')
   const revision = form && form.state ? form.state.revision : undefined
-  const ready = Boolean(form && form.state && form.state.status === 'ready' && form.state.writable && form.state.mode === 'host')
+  const ready = Boolean(
+    form && form.state && form.state.status === 'ready' && form.state.writable && form.state.mode === 'host',
+  )
   const status = form && form.state ? form.state.status : 'missing'
 
   React.useEffect(() => {
@@ -515,12 +503,14 @@ function ConfigPage(props) {
     setDraft((current) => ({ ...current, ...patch }))
     setDirty(true)
     setMessage('')
+    setTone('')
   }
 
   const reset = () => {
     setDraft(base)
     setDirty(false)
     setMessage('')
+    setTone('')
   }
 
   const save = async () => {
@@ -534,190 +524,167 @@ function ConfigPage(props) {
         setBase(draft)
         setDirty(false)
         setMessage(s.saved)
+        setTone('ok')
       } else {
         setMessage(s.rejected)
+        setTone('warn')
       }
     } catch (error) {
       setMessage(error instanceof Error ? error.message : String(error))
+      setTone('warn')
     } finally {
       setBusy(false)
     }
   }
 
   const editable = Boolean(form)
-  const headerHints = {
-    brief: s.briefHint,
-    author: s.authorHint,
-    date: s.dateHint,
-    copyright: s.copyrightHint,
-    version: s.versionHint,
-  }
+  const disabled = !ready
+  const navigation = props.pluginNavigation
 
   return h(
     'div',
-    { style: { display: 'flex', flexDirection: 'column', padding: '2px 0 8px', maxWidth: 760, color: palette.label } },
-    h('h3', { style: { margin: '0 0 2px', fontSize: 15, fontWeight: 600 } }, s.title),
-    h('p', { style: descriptionStyle() }, s.intro),
+    { className: 'dcw-page' },
+    h(
+      'header',
+      { className: 'dcw-head' },
+      h('p', { className: 'dcw-eyebrow' }, s.eyebrow),
+      h('h3', { className: 'dcw-title' }, s.title),
+      h('p', { className: 'dcw-lede' }, s.intro),
+    ),
     !editable
       ? h(
           'div',
-          {
-            role: 'status',
-            style: {
-              display: 'flex',
-              alignItems: 'center',
-              gap: 10,
-              flexWrap: 'wrap',
-              marginTop: 10,
-              padding: '8px 10px',
-              borderRadius: 6,
-              background: palette.surface,
-              border: `1px solid ${palette.line}`,
-            },
-          },
-          h('p', { style: { ...descriptionStyle(), margin: 0, flex: '1 1 200px' } }, s.readOnly),
-          props.openPluginPage
-            ? h('button', { type: 'button', onClick: props.openPluginPage, style: secondaryButton(true) }, s.openSettings)
+          { className: 'dcw-note', role: 'status' },
+          h('span', { className: 'dcw-note-dot' }),
+          h('span', null, s.readOnly),
+          navigation && typeof navigation.openBundle === 'function'
+            ? h(
+                'button',
+                {
+                  type: 'button',
+                  className: 'dcw-btn',
+                  onClick: () => navigation.openBundle(PACKAGE_NAME),
+                },
+                s.openSettings,
+              )
             : null,
         )
       : null,
     editable && !ready && status !== 'missing'
-      ? h('p', { role: 'status', style: descriptionStyle() }, status === 'loading' ? s.loading : s.unreadable)
+      ? h(
+          'div',
+          { className: 'dcw-note', role: 'status' },
+          h('span', { className: 'dcw-note-dot' }),
+          h('span', null, status === 'loading' ? s.loading : s.unreadable),
+        )
       : null,
     h(
-      Section,
-      { title: s.header, description: s.headerHint, first: true },
-      h(Row, {
-        label: s.file,
-        mono: true,
-        description: s.fileHint,
-        control: null,
-      }),
+      'section',
+      { className: 'dcw-card', 'aria-labelledby': 'dcw-header-title' },
+      h(
+        'div',
+        { className: 'dcw-card-head' },
+        h('h4', { className: 'dcw-card-title', id: 'dcw-header-title' }, s.header),
+        h('p', { className: 'dcw-card-hint' }, s.headerHint),
+      ),
+      h(
+        'div',
+        { className: 'dcw-row dcw-row-fixed' },
+        h('div', { className: 'dcw-row-label' }, TAG_LABEL.file),
+        h(
+          'div',
+          { className: 'dcw-row-control' },
+          h('span', { className: 'dcw-static' }, h(LockIcon), s.fixed),
+          h('p', { className: 'dcw-row-hint' }, s.fixedHint),
+        ),
+      ),
       ...HEADER_TAGS.map((tag) =>
         h(ValueRow, {
           key: tag,
           tag,
-          hint: headerHints[tag],
           strings: s,
-          disabled: !editable,
-          modified: editable && isModified(tag, draft),
           entry: draft[tag],
+          disabled,
           onChange: (entry) => update({ [tag]: entry }),
         }),
       ),
     ),
     h(
-      Section,
-      { title: s.contract, description: s.contractHint },
-      ...CONTRACT_TAGS.map((tag) =>
-        h(FlagRow, {
-          key: tag,
-          tag,
-          hint: TAG_TEXT[tag],
-          strings: s,
-          disabled: !editable,
-          modified: editable && isModified(tag, draft),
-          checked: draft[tag],
-          onChange: (value) => update({ [tag]: value }),
-        }),
+      'section',
+      { className: 'dcw-card', 'aria-labelledby': 'dcw-contract-title' },
+      h(
+        'div',
+        { className: 'dcw-card-head' },
+        h('h4', { className: 'dcw-card-title', id: 'dcw-contract-title' }, s.contract),
+        h('p', { className: 'dcw-card-hint' }, s.contractHint),
+      ),
+      h(
+        'div',
+        { className: 'dcw-flags' },
+        ...CONTRACT_TAGS.map((tag) =>
+          h(Flag, {
+            key: tag,
+            tag,
+            checked: draft[tag],
+            disabled,
+            hint: s[HINT_KEY[tag]],
+            onChange: (value) => update({ [tag]: value }),
+          }),
+        ),
       ),
     ),
     h(
-      Section,
-      { title: s.extra, description: s.extraHint },
-      ...EXTRA_TAGS.map((tag) =>
-        h(FlagRow, {
-          key: tag,
-          tag,
-          hint: TAG_TEXT[tag],
-          strings: s,
-          disabled: !editable,
-          modified: editable && isModified(tag, draft),
-          checked: draft[tag],
-          onChange: (value) => update({ [tag]: value }),
-        }),
+      'details',
+      { className: 'dcw-card' },
+      h('summary', null, h('span', { className: 'dcw-card-title' }, s.extra), h(Chevron)),
+      h('p', { className: 'dcw-card-hint', style: { margin: '0 14px 2px' } }, s.extraHint),
+      h(
+        'div',
+        { className: 'dcw-flags' },
+        ...EXTRA_TAGS.map((tag) =>
+          h(Flag, {
+            key: tag,
+            tag,
+            checked: draft[tag],
+            disabled,
+            onChange: (value) => update({ [tag]: value }),
+          }),
+        ),
       ),
     ),
     h(Preview, { config: draft, strings: s }),
     editable
       ? h(
           'div',
-          {
-            style: {
-              display: 'flex',
-              alignItems: 'center',
-              gap: 10,
-              marginTop: 20,
-              paddingTop: 12,
-              borderTop: `1px solid ${palette.line}`,
-              flexWrap: 'wrap',
-            },
-          },
+          { className: 'dcw-actions' },
           h(
             'button',
             {
               type: 'button',
+              className: 'dcw-btn dcw-btn-primary',
               onClick: save,
               disabled: busy || !ready || !dirty,
-              style: primaryButton(dirty && ready && !busy),
             },
             s.save,
           ),
+          h('button', { type: 'button', className: 'dcw-btn', onClick: reset, disabled: busy || !dirty }, s.reset),
           h(
-            'button',
-            {
-              type: 'button',
-              onClick: reset,
-              disabled: busy || !dirty,
-              style: secondaryButton(dirty && !busy),
-            },
-            s.reset,
+            'p',
+            { className: 'dcw-status', role: 'status', 'data-tone': tone },
+            message || (dirty ? s.unsaved : ''),
           ),
-          h('p', { role: 'status', style: { ...descriptionStyle(), margin: 0, flex: '1 1 200px' } }, message || (dirty ? s.unsaved : '')),
         )
       : null,
   )
 }
 
-function primaryButton(enabled) {
-  return {
-    fontSize: 13,
-    lineHeight: '20px',
-    padding: '4px 12px',
-    borderRadius: 4,
-    border: '1px solid transparent',
-    background: enabled ? palette.brand : 'var(--dsw-alias-bg-layer-3, rgba(127, 127, 127, 0.2))',
-    color: enabled ? '#fff' : palette.muted,
-    cursor: enabled ? 'pointer' : 'default',
-  }
-}
-
-function secondaryButton(enabled) {
-  return {
-    fontSize: 13,
-    lineHeight: '20px',
-    padding: '4px 12px',
-    borderRadius: 4,
-    border: `1px solid ${palette.line}`,
-    background: 'transparent',
-    color: enabled ? palette.label : palette.muted,
-    cursor: enabled ? 'pointer' : 'default',
-  }
-}
-
-function page(ownerProps, openPluginPage) {
+function page(ownerProps, pluginNavigation) {
   const props = ownerProps || {}
-  return h(ConfigPage, { ...props, openPluginPage })
+  return h(ConfigPage, { ...props, pluginNavigation })
 }
 
 function apply(ctx) {
-  let openPluginPage
-  try {
-    const navigation = typeof ctx.get === 'function' ? ctx.get('pluginNavigation') : undefined
-    if (navigation && typeof navigation.openBundle === 'function') {
-      openPluginPage = () => navigation.openBundle(PACKAGE_NAME)
-    }
-  } catch {}
+  const navigation = typeof ctx.get === 'function' ? ctx.get('pluginNavigation') : undefined
   ctx.slots.inject('settings.section', () =>
     ctx.slots.register(
       {
@@ -726,7 +693,7 @@ function apply(ctx) {
         order: 60,
         label: () => t().nav,
       },
-      (ownerProps) => page(ownerProps, openPluginPage),
+      (ownerProps) => page(ownerProps, navigation),
     ),
   )
   ctx.slots.inject('plugins.bundle.config', () =>
@@ -736,7 +703,7 @@ function apply(ctx) {
         key: PACKAGE_NAME,
         label: () => t().nav,
       },
-      (ownerProps) => (ownerProps && ownerProps.view === 'summary' ? null : page(ownerProps, undefined)),
+      (ownerProps) => (ownerProps && ownerProps.view === 'summary' ? null : page(ownerProps, navigation)),
     ),
   )
 }

package/lib/comment-policy.js

@@ -35,6 +35,7 @@ export const TAG_TEXT = {
 };
 /** 开关型标签在设置页的标题。 */
 export const TAG_LABEL = {
+    file: '@file',
     brief: '@brief',
     author: '@author',
     date: '@date',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chengzhao-dev/dsh-cpp-workflow",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "description": "写 C++ 源码、配 CMake、用 Clang 构建；文档注释统一为 /// Doxygen，文件头标签可在设置里改。 · Write C++ sources, configure CMake, and build with Clang; /// Doxygen comments, with file-header tags you can change in Settings.",
   "type": "module",
   "main": "./lib/index.js",

package/skills/developing-cpp/examples/comments-implementation.md

@@ -24,15 +24,15 @@ for (const auto& position : empty_cells) {
 **好**：
 
 ```cpp
-// 先找能立刻赢的格子：启发式只在「马上赢」和「马上挡」之间做选择，
-// 不在这里做更深的前瞻，深搜留给 MinimaxAi。
+/// 先找能立刻赢的格子：启发式只在「马上赢」和「马上挡」之间做选择，
+/// 不在这里做更深的前瞻，深搜留给 MinimaxAi。
 for (const auto& position : empty_cells) {
   if (game.CompletesLine(position, CellType::kX)) {
     return position;
   }
 }
 
-// 没有必胜格，交给下一层策略；这里不猜后续几步。
+/// 没有必胜格，交给下一层策略；这里不猜后续几步。
 return std::nullopt;
 ```
 

package/skills/developing-cpp/examples/structure.md

@@ -115,7 +115,7 @@ constexpr std::array<std::array<CellPosition, 3>, 8> kLines{{
 
 ## 推演一步读原数据
 
-**差**：先复制整盘，再在副本上落子，最后判断成线；调用方看不出副本只是中间量。
+**差**：先复制整个棋盘，再在副本上落子，最后判断成线；调用方看不出副本只是中间量。
 
 ```cpp
 Board hypothetical = *this;