dsh-tacit 0.2.2 → 0.2.3

package/README.md

@@ -85,6 +85,27 @@ reports. Dollar figures are estimates at list price; a cost plugin such as
 the honest list of limitations:
 [Privacy, cost & limitations](https://github.com/hackernotfound/dsh-tacit/blob/main/docs/privacy-and-cost.md).
 
+## Help shape Tacit
+
+Tacit works and I use it every day — but so far it has learned from one
+person's prompts. It gets better with more of them.
+
+- **Try it and say what feels wrong.** A directive that misfires, a cost that
+  surprised you, a label that reads oddly:
+  [open an issue](https://github.com/hackernotfound/dsh-tacit/issues/new/choose).
+  Two minutes of your time beats a week of my guessing.
+- **Pick up a task.** Issues tagged
+  [`good first issue`](https://github.com/hackernotfound/dsh-tacit/labels/good%20first%20issue)
+  are small and come with acceptance criteria;
+  [`help wanted`](https://github.com/hackernotfound/dsh-tacit/labels/help%20wanted)
+  ones are bigger and I will pair on the design.
+- **Ask anything** in
+  [Discussions](https://github.com/hackernotfound/dsh-tacit/discussions).
+
+PRs are welcome — the fork → branch → PR walkthrough is in
+[CONTRIBUTING.md](https://github.com/hackernotfound/dsh-tacit/blob/main/CONTRIBUTING.md).
+No API key is needed to run the tests.
+
 ## Documentation
 
 | | |

package/client/client.js

@@ -1,5 +1,6 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) 2026 hackernotfound — https://github.com/hackernotfound/dsh-tacit
+// GENERATED by scripts/build-client.mjs from client/src/ — edit the sources, not this file.
 /**
  * dsh-tacit — Client half (installed package bundle entry, zero-build).
  *
@@ -57,6 +58,10 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
       'trigger.correction': '纠正',
       'trigger.manual': '手动',
       'trigger.bootstrap': '引导',
+      'trigger.good': '做对了',
+      'report.strengths': '这次做对了什么',
+      'report.lesson': '经验',
+      'settings.learnGood': '也从混乱之后的顺利提示词中学习',
       'bootstrap.btn': '从我最近 20 轮中学习',
       'bootstrap.running': '学习中… {done}/{total}',
       'bootstrap.hint': '约 $0.02–0.05，一次性。已顺利完成的提示词会被跳过。',
@@ -74,6 +79,9 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
       'steer.active': '已生效',
       'steer.retired': '已淘汰 · {reason}',
       'steer.user': '你添加的',
+      'steer.workspace': '仅 {name}',
+      'steer.scope': '适用范围',
+      'steer.everywhere': '所有工作区',
       'settings.auto': '自动分析混乱轮次',
       'settings.budget': '每日自动分析上限',
       settings: '设置',
@@ -164,6 +172,10 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
       'trigger.correction': 'correction',
       'trigger.manual': 'manual',
       'trigger.bootstrap': 'bootstrap',
+      'trigger.good': 'what worked',
+      'report.strengths': 'What this prompt got right',
+      'report.lesson': 'Lesson',
+      'settings.learnGood': 'Also learn from a clean prompt right after a messy turn',
       'bootstrap.btn': 'Learn from my last 20 turns',
       'bootstrap.running': 'Learning… {done}/{total}',
       'bootstrap.hint': '≈ $0.02–0.05, one time. Skips prompts that already went fine on their own.',
@@ -181,6 +193,9 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
       'steer.active': 'active',
       'steer.retired': 'retired · {reason}',
       'steer.user': 'yours',
+      'steer.workspace': 'only {name}',
+      'steer.scope': 'Applies to',
+      'steer.everywhere': 'Everywhere',
       'settings.auto': 'Auto-analyze messy turns',
       'settings.budget': 'Daily cap on automatic analyses',
       settings: 'Settings',
@@ -346,13 +361,14 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
       return version
     }
 
-    // ── Root store (sidebar action + settings section + frame overlay) ─────
+    // ── Root store (settings section + bootstrap + directives editor) ──────
 
     const rootStore = {
       config: null,
       profile: null,
       auto: null,
       steering: null, // {enabled, text}
+      workspaces: [], // [{cwd, label}] from /state
       trend: null, // measured early-vs-recent trend
       bootstrap: null, // {running, done, total}
       coached: [], // cross-session coached-prompt entries
@@ -388,6 +404,7 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
           rootStore.profile = state.profile !== null && typeof state.profile === 'object' ? state.profile : null
           rootStore.auto = state.auto !== null && typeof state.auto === 'object' ? state.auto : null
           rootStore.steering = state.steering !== null && typeof state.steering === 'object' ? state.steering : null
+          rootStore.workspaces = Array.isArray(state.workspaces) ? state.workspaces : []
           rootStore.bootstrap = state.bootstrap !== null && typeof state.bootstrap === 'object' ? state.bootstrap : null
         }
         const coached = await api('/history', { limit: 50 })
@@ -415,6 +432,7 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
           rootStore.profile = state.profile !== null && typeof state.profile === 'object' ? state.profile : null
           rootStore.auto = state.auto !== null && typeof state.auto === 'object' ? state.auto : null
           rootStore.steering = state.steering !== null && typeof state.steering === 'object' ? state.steering : null
+          rootStore.workspaces = Array.isArray(state.workspaces) ? state.workspaces : []
           rootStore.bootstrap = state.bootstrap !== null && typeof state.bootstrap === 'object' ? state.bootstrap : null
         }
       } catch {
@@ -944,14 +962,21 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
       }
       return h('div', { className: 'tacit-report' },
         h('div', { className: 'tacit-report-title' },
-          t('report.problems'),
+          report.trigger === 'good' ? t('report.strengths') : t('report.problems'),
           ' ',
-          h('span', { className: 'tacit-chip tacit-chip-trigger' }, t('trigger.' + report.trigger))),
-        report.problems.length === 0
-          ? h('div', { className: 'tacit-report-note' }, '—')
-          : report.problems.map((problem, index) => ProblemRow(kit, problem, index)),
-        h('div', { className: 'tacit-report-title' }, t('report.improved')),
-        improved.length > 0
+          h('span', { className: 'tacit-chip tacit-chip-trigger' + (report.trigger === 'good' ? ' tacit-chip-ok' : '') }, t('trigger.' + report.trigger))),
+        report.trigger === 'good'
+          ? (Array.isArray(report.strengths) && report.strengths.length > 0
+            ? report.strengths.map((strength, index) => h('div', { key: index, className: 'tacit-problem' },
+              h('span', { className: 'tacit-chip tacit-chip-ok' }, String(strength.kind)),
+              ' ',
+              h('span', { className: 'tacit-problem-what' }, String(strength.what))))
+            : h('div', { className: 'tacit-report-note' }, '—'))
+          : report.problems.length === 0
+            ? h('div', { className: 'tacit-report-note' }, '—')
+            : report.problems.map((problem, index) => ProblemRow(kit, problem, index)),
+        report.trigger === 'good' ? null : h('div', { className: 'tacit-report-title' }, t('report.improved')),
+        report.trigger === 'good' ? null : improved.length > 0
           ? h('div', { className: 'tacit-report-improved' },
             h('div', { className: 'tacit-report-actions' },
               h('button', {
@@ -966,7 +991,7 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
           : h('div', { className: 'tacit-report-note' }, t('report.emptyImproved')),
         typeof report.explanation === 'string' && report.explanation.length > 0
           ? h('div', null,
-            h('div', { className: 'tacit-report-title' }, t('report.explanation')),
+            h('div', { className: 'tacit-report-title' }, report.trigger === 'good' ? t('report.lesson') : t('report.explanation')),
             h('div', { className: 'tacit-report-body' },
               MarkdownText !== null
                 ? h(MarkdownText, { text: report.explanation })
@@ -1063,6 +1088,7 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
       const [model, setModel] = useState(config !== null && typeof config.model === 'string' ? config.model : 'deepseek-v4-flash')
       const [budgetText, setBudgetText] = useState(config !== null && typeof config.autoDailyBudget === 'number' ? String(config.autoDailyBudget) : '30')
       const [auto, setAuto] = useState(config !== null && config.autoAnalyze !== false)
+      const [learnGood, setLearnGood] = useState(config !== null && config.learnFromGood !== false)
       const [live, setLive] = useState(config !== null && config.liveSuggestions !== false)
       const [notice, setNotice] = useState(null)
 
@@ -1071,6 +1097,7 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
           if (typeof config.model === 'string') setModel(config.model)
           if (typeof config.autoDailyBudget === 'number') setBudgetText(String(config.autoDailyBudget))
           if (typeof config.autoAnalyze === 'boolean') setAuto(config.autoAnalyze)
+          if (typeof config.learnFromGood === 'boolean') setLearnGood(config.learnFromGood)
           if (typeof config.liveSuggestions === 'boolean') setLive(config.liveSuggestions)
         }
       }, [config])
@@ -1084,6 +1111,11 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
         setBudgetText(String(number))
         updateConfig(store, { autoDailyBudget: number })
       }
+      const toggleLearnGood = () => {
+        const next = !learnGood
+        setLearnGood(next)
+        updateConfig(store, { learnFromGood: next })
+      }
       const toggleAuto = () => {
         const next = !auto
         setAuto(next)
@@ -1116,6 +1148,9 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
         h('div', { className: 'tacit-settings-row' },
           h('label', { className: 'tacit-settings-label' }, t('settings.auto')),
           h('input', { type: 'checkbox', checked: auto, onChange: toggleAuto })),
+        h('div', { className: 'tacit-settings-row' },
+          h('label', { className: 'tacit-settings-label' }, t('settings.learnGood')),
+          h('input', { type: 'checkbox', checked: learnGood, onChange: toggleLearnGood })),
         h('div', { className: 'tacit-settings-row' },
           h('label', { className: 'tacit-settings-label' }, t('settings.budget')),
           h('input', {
@@ -1259,7 +1294,7 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
       }
     }
 
-    // ── Feedback strip (under the composer, Improve enabled only) ───────────
+    // ── Feedback strip (above the composer, Improve enabled only) ───────────
 
     function FeedbackStrip(kit) {
       const { t } = kit
@@ -1329,13 +1364,19 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
       }
     }
 
-    // ── Global panel (settings section, sidebar action, frame overlay) ─────
+    // ── Global panel (Settings → Tacit section) ────────────────────────────
 
     function DirectivesEditor(kit) {
       const { t } = kit
       return function DirectivesEditorView(props) {
         const { config, directives, steering } = props
+        const workspaces = Array.isArray(props.workspaces) ? props.workspaces : []
         const [draft, setDraft] = useState('')
+        const [scope, setScope] = useState('')
+        const labelOf = (cwd) => {
+          const parts = String(cwd).split(/[\\/]+/).filter((part) => part.length > 0)
+          return parts.length > 0 ? parts[parts.length - 1] : String(cwd)
+        }
         const [steerOn, setSteerOn] = useState(config !== null && config.steerAgent !== false)
         const [enrichOn, setEnrichOn] = useState(config !== null && config.enrichPrompts === true)
         useEffect(() => {
@@ -1356,7 +1397,7 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
           const text = draft.trim()
           if (text.length === 0) return
           setDraft('')
-          editDirectives({ action: 'add', text: text.slice(0, 300) })
+          editDirectives({ action: 'add', text: text.slice(0, 300), ...(scope.length > 0 ? { workspace: scope } : {}) })
         }
         return h('div', { className: 'tacit-panel-section', 'data-testid': 'tacit-steering' },
           h('div', { className: 'tacit-report-title' }, t('steer.title')),
@@ -1380,6 +1421,9 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
                 }),
                 h('span', { className: 'tacit-directive-text' }, String(entry.text)),
                 h('span', { className: 'tacit-chip' }, entry.source === 'user' ? t('steer.user') : t('steer.distilled')),
+                typeof entry.workspace === 'string' && entry.workspace.length > 0
+                  ? h('span', { className: 'tacit-chip tacit-chip-scope', title: entry.workspace }, t('steer.workspace', { name: labelOf(entry.workspace) }))
+                  : null,
                 entry.status === 'candidate'
                   ? h('span', { className: 'tacit-chip tacit-chip-trial' }, t('steer.trial', {
                     n: String(entry.trial !== null && typeof entry.trial === 'object' && typeof entry.trial.turns === 'number' ? entry.trial.turns : 0),
@@ -1402,6 +1446,16 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
                 if (event.key === 'Enter') onAdd()
               },
             }),
+            workspaces.length > 0
+              ? h('select', {
+                className: 'tacit-input tacit-select',
+                'aria-label': t('steer.scope'),
+                value: scope,
+                onChange: (event) => setScope(event.target.value),
+              },
+              h('option', { value: '' }, t('steer.everywhere')),
+              ...workspaces.map((entry) => h('option', { key: entry.cwd, value: entry.cwd }, entry.label)))
+              : null,
             h('button', { type: 'button', className: 'tacit-btn tacit-btn-sm', disabled: draft.trim().length === 0, onClick: onAdd }, t('steer.add'))),
           steering !== null && typeof steering === 'object' && typeof steering.text === 'string' && steering.text.length > 0
             ? h('details', { className: 'tacit-preview' },
@@ -1425,6 +1479,7 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
         const [model, setModel] = useState(config !== null && typeof config.model === 'string' ? config.model : 'deepseek-v4-flash')
         const [budgetText, setBudgetText] = useState(config !== null && typeof config.autoDailyBudget === 'number' ? String(config.autoDailyBudget) : '30')
         const [auto, setAuto] = useState(config !== null && config.autoAnalyze !== false)
+        const [learnGood, setLearnGood] = useState(config !== null && config.learnFromGood !== false)
         const [live, setLive] = useState(config !== null && config.liveSuggestions !== false)
 
         useEffect(() => {
@@ -1432,6 +1487,7 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
             if (typeof config.model === 'string') setModel(config.model)
             if (typeof config.autoDailyBudget === 'number') setBudgetText(String(config.autoDailyBudget))
             if (typeof config.autoAnalyze === 'boolean') setAuto(config.autoAnalyze)
+            if (typeof config.learnFromGood === 'boolean') setLearnGood(config.learnFromGood)
             if (typeof config.liveSuggestions === 'boolean') setLive(config.liveSuggestions)
           }
         }, [config])
@@ -1445,6 +1501,11 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
           setBudgetText(String(number))
           updateRootConfig({ autoDailyBudget: number })
         }
+        const toggleLearnGood = () => {
+          const next = !learnGood
+          setLearnGood(next)
+          updateRootConfig({ learnFromGood: next })
+        }
         const toggleAuto = () => {
           const next = !auto
           setAuto(next)
@@ -1484,6 +1545,9 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
             h('div', { className: 'tacit-settings-row' },
               h('label', { className: 'tacit-settings-label' }, t('settings.auto')),
               h('input', { type: 'checkbox', checked: auto, onChange: toggleAuto })),
+            h('div', { className: 'tacit-settings-row' },
+              h('label', { className: 'tacit-settings-label' }, t('settings.learnGood')),
+              h('input', { type: 'checkbox', checked: learnGood, onChange: toggleLearnGood })),
             h('div', { className: 'tacit-settings-row' },
               h('label', { className: 'tacit-settings-label' }, t('settings.budget')),
               h('input', {
@@ -1502,7 +1566,8 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
           error !== null && typeof error === 'object'
             ? h('div', { className: 'tacit-error' }, t('err.' + String(error.code), { detail: String(error.detail || '') }))
             : null,
-          h(DirectivesEditorView, { config, directives, steering: rootStore.steering }),
+          h(DirectivesEditorView, {
+            workspaces: rootStore.workspaces, config, directives, steering: rootStore.steering }),
           h('div', { className: 'tacit-panel-section' },
             h('div', { className: 'tacit-report-title' }, t('panel.styleRules')),
             styleRules.length === 0
@@ -1594,13 +1659,13 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
       + '.tacit-modal-col-title{font-size:11px;font-weight:600;color:var(--dsw-alias-label-secondary);margin-bottom:6px}'
       + '.tacit-modal-rationale-text{font-size:12px;color:var(--dsw-alias-label-primary);line-height:1.6}.tacit-modal-savings{color:var(--dsw-alias-state-success-primary);font-size:12px;font-weight:600}'
       + '.tacit-modal-actions{display:flex;gap:8px;justify-content:flex-end}'
-      + '.tacit-feedback{display:flex;justify-content:center;align-items:center;margin:8px 2px 0;font-size:12px;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:6px 10px;gap:8px;transition:opacity .35s ease}.tacit-feedback-fading{opacity:0}'
+      + '.tacit-feedback{display:flex;justify-content:center;align-items:center;margin:0 2px 8px;font-size:12px;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:6px 10px;gap:8px;transition:opacity .35s ease}.tacit-feedback-fading{opacity:0}'
       + '.tacit-feedback-row{display:flex;align-items:center;gap:8px;flex-wrap:wrap}.tacit-feedback-title{color:var(--dsw-alias-label-secondary)}'
       + '.tacit-feedback-vote{font:inherit;font-size:14px;line-height:1;cursor:pointer;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);border-radius:999px;padding:3px 8px}.tacit-feedback-vote:hover{border-color:var(--dsw-alias-brand-primary)}.tacit-feedback-vote-active{border-color:var(--dsw-alias-state-warn-primary);background:color-mix(in srgb, var(--dsw-alias-state-warn-primary) 12%, transparent)}'
       + '.tacit-feedback-reason{display:flex;align-items:center;gap:6px;flex-wrap:wrap}.tacit-feedback-input{width:260px;max-width:60vw}'
       + '.tacit-feedback-noted{color:var(--dsw-alias-state-success-primary);font-weight:600}'
       + '.tacit-trend{display:flex;flex-wrap:wrap;align-items:center;gap:6px;margin-top:6px}.tacit-chip-trigger,.tacit-coached-trigger{text-transform:uppercase;letter-spacing:.04em;font-size:10px}.tacit-coached-trigger{margin-left:auto}.tacit-row-enrichment{margin-top:8px;border-left:3px solid var(--dsw-alias-brand-primary);padding:4px 10px;background:var(--dsw-alias-bg-layer-2);border-radius:6px}'
-      + '.tacit-chip-trial{color:var(--dsw-alias-brand-primary)}.tacit-chip-ok{color:var(--dsw-alias-state-success-primary)}'
+      + '.tacit-chip-trial{color:var(--dsw-alias-brand-primary)}.tacit-chip-ok{color:var(--dsw-alias-state-success-primary)}.tacit-chip-scope{color:var(--dsw-alias-brand-primary)}.tacit-select{max-width:11rem}'
       + '.tacit-directive{display:flex;align-items:center;gap:8px}.tacit-directive-text{flex:1;min-width:0}.tacit-directive-off .tacit-directive-text{opacity:.5;text-decoration:line-through}.tacit-directive-input{width:min(420px,100%);flex:1}.tacit-preview summary{cursor:pointer;font-size:11px;color:var(--dsw-alias-label-secondary)}.tacit-preview pre{margin-top:6px;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);border-radius:6px;padding:8px 10px}'
       + '.tacit-rules-list{display:flex;flex-direction:column;gap:6px}.tacit-rule{background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);border-left:3px solid var(--dsw-alias-brand-primary);border-radius:6px;padding:6px 10px;font-size:12px;line-height:1.55;color:var(--dsw-alias-label-primary);white-space:pre-wrap;word-break:break-word}'
 
@@ -1650,11 +1715,12 @@ if (typeof window === 'undefined' || window.__ModuleLoader__ === undefined || ty
         inject: (sessionId) => ({ tacitStore: storeFor(sessionId) }),
       }, (props) => h(PreviewOverlayView, props)))
 
-      // The post-apply 👍/👎 strip lives in the band UNDER the composer card
-      // (composer.dock), only while the Improve button is enabled.
+      // The post-apply 👍/👎 strip lives in the full-width row ABOVE the composer
+      // card (input.dock). Not composer.dock: the harness hides that one until a
+      // conversation has content, which is exactly when a first draft is improved.
       const FeedbackStripView = FeedbackStrip(kit)
-      ctx.slots.inject('conversation.composer.dock', () => ctx.slots.register({
-        name: 'conversation.composer.dock',
+      ctx.slots.inject('conversation.input.dock', () => ctx.slots.register({
+        name: 'conversation.input.dock',
         id: 'tacit-feedback',
         order: 10,
         locale: NS,

package/docs/README.md

@@ -9,13 +9,13 @@ Pick the question you have:
 
 | I want to… | Read |
 | --- | --- |
-| Install it and see it working in five minutes | [Getting started](getting-started.md) |
+| Install it and see it working in five minutes | [Getting started](getting-started.md) ([中文](getting-started.zh.md)) |
 | Understand what it does, step by step, and what the words mean | [How it works](how-it-works.md) |
 | Know what leaves my machine, what it costs, and what it can't do yet | [Privacy, cost & limitations](privacy-and-cost.md) |
 | Change a setting | [Configuration](configuration.md) |
-| Read or change the code | [Architecture](architecture.md) · [Contributing](../CONTRIBUTING.md) |
+| Read or change the code | [Architecture](architecture.md) · [Contributing](../CONTRIBUTING.md) ([中文](CONTRIBUTING.zh.md)) |
 | See what changed between versions | [Changelog](../CHANGELOG.md) |
 
 Reading order for a newcomer: Getting started → How it works → Privacy & cost.
 
-中文：[README.zh.md](README.zh.md)（仅 README 有中文版）。
+中文：[README.zh.md](README.zh.md) · [快速开始](getting-started.zh.md) · [贡献指南](CONTRIBUTING.zh.md)（其余文档为英文）。

package/docs/README.zh.md

@@ -68,15 +68,16 @@ Tacit 从不接触你的 API Key（所有调用都经过 harness 自己的模型
 完整的数据流与成本表、以及坦白的限制清单（英文）：
 [Privacy, cost & limitations](https://github.com/hackernotfound/dsh-tacit/blob/main/docs/privacy-and-cost.md)。
 
-## 文档（均为英文）
+## 文档（除标注外均为英文）
 
 | | |
 | --- | --- |
-| [Getting started](https://github.com/hackernotfound/dsh-tacit/blob/main/docs/getting-started.md) | 安装、确认已启用、快速起步、界面各处在哪、排障 |
+| [快速开始](https://github.com/hackernotfound/dsh-tacit/blob/main/docs/getting-started.zh.md)（[English](https://github.com/hackernotfound/dsh-tacit/blob/main/docs/getting-started.md)） | 安装、确认已启用、快速起步、界面各处在哪、排障 |
 | [How it works](https://github.com/hackernotfound/dsh-tacit/blob/main/docs/how-it-works.md) | 逐步流程，带图和术语表 |
 | [Privacy, cost & limitations](https://github.com/hackernotfound/dsh-tacit/blob/main/docs/privacy-and-cost.md) | 什么留在本地、什么会发出去、每次调用的花费、目前做不到的事 |
 | [Configuration](https://github.com/hackernotfound/dsh-tacit/blob/main/docs/configuration.md) | 所有设置项、默认值和取值范围 |
 | [Architecture](https://github.com/hackernotfound/dsh-tacit/blob/main/docs/architecture.md) | 面向贡献者：模块、钩子、路由、存储 |
-| [Contributing](https://github.com/hackernotfound/dsh-tacit/blob/main/CONTRIBUTING.md) · [Changelog](https://github.com/hackernotfound/dsh-tacit/blob/main/CHANGELOG.md) | |
+| [贡献指南](https://github.com/hackernotfound/dsh-tacit/blob/main/docs/CONTRIBUTING.zh.md)（[English](https://github.com/hackernotfound/dsh-tacit/blob/main/CONTRIBUTING.md)） | fork → 分支 → PR 的流程、测试、基本规则；欢迎提 issue 和 PR |
+| [Changelog](https://github.com/hackernotfound/dsh-tacit/blob/main/CHANGELOG.md) | 各版本的变更 |
 
 MIT © hackernotfound