@tomjerrygit/dsh-workspace-audit 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TomJerryGit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,29 @@
-# Temporary Holding Version
+# @tomjerrygit/dsh-workspace-audit
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Local-first workspace health audit for DeepSeek Harness. Read-only by design; no code is uploaded and no LLM call is required.
+
+## What it checks
+
+- Git: repository, remote, branch, dirty count, last commit, tags
+- Project: README, LICENSE, .gitignore, manifests, lockfiles, tests, docs, CI
+- Size: source/scan size and known build/cache directories
+- Security hotspots: self-hosted runner triggered by `pull_request`, suspected key filenames (names only), `shell=True`/`exec`/`pickle.load` patterns
+- Risks: P0/P1/P2 list and a Markdown handover report
+
+## Install
+
+```sh
+dsh plugin --profile web add @tomjerrygit/dsh-workspace-audit
+```
+
+Market index:
+
+```text
+https://tomjerrygit.github.io/dsh-workspace-audit/index.json
+```
+
+## Usage
+
+Open **Workspace Audit** in the left sidebar, add workspace paths if needed, and run the audit. The report can be copied or downloaded as Markdown.
+
+> This is an engineering hygiene check, not a professional security audit. Suspected secret files are reported by filename only; contents are not read.

package/client.js

@@ -0,0 +1,174 @@
+window.__ModuleLoader__.load({
+  id: '@tomjerrygit/dsh-workspace-audit',
+  factory(require) {
+    const React = require('react');
+    const h = React.createElement;
+    const PANEL_ID = 'workspace-audit';
+    const NS = 'workspaceAudit';
+    const zh = {
+      panel: '工作区体检',
+      title: '工作区体检',
+      subtitle: '本地只读扫描：Git、测试、CI、体积、安全与交接报告',
+      scan: '开始体检',
+      scanning: '扫描中…',
+      refresh: '刷新',
+      addRoot: '添加工作区路径',
+      rootPlaceholder: '例如 D:\\MyProject',
+      add: '添加',
+      empty: '暂无工作区。先添加一个目录，或等待 DSH 工作区注册表出现。',
+      score: '综合评分',
+      workspaces: '工作区',
+      p0: 'P0 风险',
+      risks: '风险',
+      dimensions: '维度',
+      report: '交接报告',
+      copy: '复制报告',
+      copied: '已复制',
+      download: '下载 Markdown',
+      failed: '扫描失败',
+      loading: '正在准备…',
+      path: '路径',
+      git: 'Git',
+      size: '体积',
+      tests: '测试文件',
+      todo: 'TODO',
+      noRisk: '未发现阻塞风险',
+      commands: '启动/测试入口见各项目 README 与报告。',
+    };
+    const en = {
+      panel: 'Workspace Audit',
+      title: 'Workspace Audit',
+      subtitle: 'Read-only local scan: Git, tests, CI, size, security, handover report',
+      scan: 'Run audit',
+      scanning: 'Scanning…',
+      refresh: 'Refresh',
+      addRoot: 'Add workspace path',
+      rootPlaceholder: 'e.g. D:\\MyProject',
+      add: 'Add',
+      empty: 'No workspaces yet. Add a directory or wait for the DSH workspace registry.',
+      score: 'Overall score',
+      workspaces: 'Workspaces',
+      p0: 'P0 risks',
+      risks: 'Risks',
+      dimensions: 'Dimensions',
+      report: 'Handover report',
+      copy: 'Copy report',
+      copied: 'Copied',
+      download: 'Download Markdown',
+      failed: 'Scan failed',
+      loading: 'Preparing…',
+      path: 'Path',
+      git: 'Git',
+      size: 'Size',
+      tests: 'Test files',
+      todo: 'TODO',
+      noRisk: 'No blocking risks found',
+      commands: 'See each project README and report for run/test commands.',
+    };
+    const page = { display: 'flex', flexDirection: 'column', gap: '14px', padding: '24px 32px', minHeight: '100%', overflow: 'auto', color: 'var(--dsw-alias-label-primary)' };
+    const card = { border: '1px solid var(--dsw-alias-border-l1)', borderRadius: '14px', padding: '14px', background: 'var(--dsw-alias-bg-layer-1)' };
+    const money = (bytes) => {
+      const value = Number(bytes) || 0;
+      if (value < 1024 * 1024) return Math.round(value / 1024) + 'KB';
+      if (value < 1024 * 1024 * 1024) return (value / 1024 / 1024).toFixed(1) + 'MB';
+      return (value / 1024 / 1024 / 1024).toFixed(1) + 'GB';
+    };
+    const grade = (score) => (score >= 85 ? 'A' : score >= 70 ? 'B' : score >= 55 ? 'C' : 'D');
+    const color = (score) => (score >= 85 ? 'var(--dsw-alias-state-success-primary)' : score >= 70 ? 'var(--dsw-alias-state-warn-primary)' : 'var(--dsw-alias-state-error-primary)');
+
+    function Panel() {
+      const t = (key) => { const dict = /^zh/i.test(String(window.navigator && window.navigator.language)) ? zh : en; return dict[key] || key; };
+      const [token, setToken] = React.useState('');
+      const [scan, setScan] = React.useState(null);
+      const [state, setState] = React.useState('loading');
+      const [rootDraft, setRootDraft] = React.useState('');
+      const [copied, setCopied] = React.useState(false);
+      const auth = () => token.length > 0 ? Promise.resolve(token) : fetch('/api/workspace-audit/auth').then((res) => res.json()).then((payload) => { setToken(payload.token); return payload.token; });
+      const headers = (value) => ({ 'x-workspace-audit-token': value, accept: 'application/json' });
+      const load = () => {
+        auth().then((value) => fetch('/api/workspace-audit/scan', { headers: headers(value), cache: 'no-store' }))
+          .then((res) => { if (!res.ok) throw new Error(String(res.status)); return res.json(); })
+          .then((payload) => { setScan(payload); setState('ready'); })
+          .catch(() => setState('failed'));
+      };
+      const addRoot = () => {
+        auth().then((value) => fetch('/api/workspace-audit/settings', { method: 'POST', headers: { ...headers(value), 'content-type': 'application/json' }, body: JSON.stringify({ add: rootDraft.trim() }) }))
+          .then(() => { setRootDraft(''); return load(); })
+          .catch(() => {});
+      };
+      const copy = () => { if (!scan) return; navigator.clipboard.writeText(scan.report).then(() => { setCopied(true); setTimeout(() => setCopied(false), 1500); }).catch(() => {}); };
+      const download = () => {
+        if (!scan) return;
+        const blob = new Blob([scan.report], { type: 'text/markdown;charset=utf-8' });
+        const link = document.createElement('a');
+        link.href = URL.createObjectURL(blob);
+        link.download = 'workspace-audit.md';
+        link.click();
+        URL.revokeObjectURL(link.href);
+      };
+      React.useEffect(() => { load(); }, []);
+      if (state === 'loading') return h('div', { style: page }, h('h1', { style: { margin: 0, fontSize: '22px' } }, t('title')), h('p', { style: { color: 'var(--dsw-alias-label-secondary)' } }, t('scanning')));
+      if (state === 'failed' || scan === null) return h('div', { style: page }, h('h1', { style: { margin: 0, fontSize: '22px' } }, t('title')), h('p', { style: { color: 'var(--dsw-alias-label-secondary)' } }, t('failed')), h('button', { type: 'button', onClick: load }, t('scan')));
+      const workspaces = Array.isArray(scan.workspaces) ? scan.workspaces : [];
+      const avg = workspaces.length > 0 ? Math.round(workspaces.reduce((sum, workspace) => sum + workspace.score, 0) / workspaces.length) : 0;
+      const p0 = workspaces.reduce((sum, workspace) => sum + workspace.risks.filter((risk) => risk.severity === 'P0').length, 0);
+      return h('div', { style: page },
+        h('header', { style: { display: 'flex', gap: '12px', alignItems: 'center', flexWrap: 'wrap' } },
+          h('div', { style: { flex: '1 1 auto' } }, h('h1', { style: { margin: 0, fontSize: '22px' } }, t('title')), h('p', { style: { margin: '4px 0 0', color: 'var(--dsw-alias-label-secondary)', fontSize: '13px' } }, t('subtitle'))),
+          h('button', { type: 'button', onClick: load, style: { padding: '6px 12px', borderRadius: '8px' } }, t('scan')),
+        ),
+        h('div', { style: { display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(150px, 1fr))', gap: '10px' } },
+          h('div', { style: card }, h('div', { style: { fontSize: '24px', fontWeight: 700, color: color(avg) } }, avg + ' / ' + grade(avg)), h('div', { style: { fontSize: '12px', color: 'var(--dsw-alias-label-secondary)' } }, t('score'))),
+          h('div', { style: card }, h('div', { style: { fontSize: '24px', fontWeight: 700 } }, String(workspaces.length)), h('div', { style: { fontSize: '12px', color: 'var(--dsw-alias-label-secondary)' } }, t('workspaces'))),
+          h('div', { style: card }, h('div', { style: { fontSize: '24px', fontWeight: 700, color: 'var(--dsw-alias-state-error-primary)' } }, String(p0)), h('div', { style: { fontSize: '12px', color: 'var(--dsw-alias-label-secondary)' } }, t('p0'))),
+        ),
+        h('div', { style: { display: 'flex', gap: '8px', alignItems: 'center', flexWrap: 'wrap' } },
+          h('input', { value: rootDraft, placeholder: t('rootPlaceholder'), onChange: (event) => setRootDraft(event.target.value), style: { flex: '1 1 260px', padding: '6px 8px' } }),
+          h('button', { type: 'button', onClick: addRoot, disabled: rootDraft.trim().length === 0 }, t('add')),
+          h('button', { type: 'button', onClick: copy }, copied ? t('copied') : t('copy')),
+          h('button', { type: 'button', onClick: download }, t('download')),
+        ),
+        workspaces.length === 0 ? h('p', { style: { color: 'var(--dsw-alias-label-secondary)' } }, t('empty')) : null,
+        ...workspaces.map((workspace) => {
+          const risks = workspace.risks || [];
+          return h('section', { key: workspace.path, style: card },
+            h('div', { style: { display: 'flex', gap: '10px', alignItems: 'baseline', flexWrap: 'wrap' } },
+              h('h2', { style: { margin: 0, fontSize: '16px', flex: '1 1 auto' } }, workspace.title),
+              h('strong', { style: { fontSize: '20px', color: color(workspace.score) } }, workspace.score + ' ' + grade(workspace.score)),
+            ),
+            h('div', { style: { fontSize: '11px', color: 'var(--dsw-alias-label-secondary)', margin: '4px 0 8px' } }, t('path') + '：' + workspace.path),
+            h('div', { style: { display: 'flex', gap: '14px', flexWrap: 'wrap', fontSize: '12px' } },
+              h('span', null, t('git') + ': ' + (workspace.git.isRepo ? workspace.git.branch || 'repo' : 'none')),
+              h('span', null, t('size') + ': ' + money(workspace.size.bytes)),
+              h('span', null, t('tests') + ': ' + workspace.testFiles),
+              h('span', null, t('todo') + ': ' + workspace.todo),
+            ),
+            h('div', { style: { display: 'flex', gap: '4px', flexWrap: 'wrap', marginTop: '8px' } },
+              Object.entries(workspace.dimensions || {}).map(([key, value]) => h('span', { key, style: { fontSize: '10px', padding: '1px 6px', borderRadius: '999px', background: 'var(--dsw-alias-bg-layer-2)' } }, key + ' ' + value)),
+            ),
+            h('div', { style: { marginTop: '10px' } },
+              risks.length === 0 ? h('div', { style: { fontSize: '12px', color: 'var(--dsw-alias-state-success-primary)' } }, t('noRisk')) : risks.map((risk, index) =>
+                h('div', { key: index, style: { fontSize: '12px', marginTop: '4px', color: risk.severity === 'P0' ? 'var(--dsw-alias-state-error-primary)' : risk.severity === 'P1' ? 'var(--dsw-alias-state-warn-primary)' : 'var(--dsw-alias-label-secondary)' } }, '[' + risk.severity + '] ' + risk.text),
+              ),
+            ),
+          );
+        }),
+        h('p', { style: { fontSize: '11px', color: 'var(--dsw-alias-label-secondary)' } }, t('commands')),
+      );
+    }
+
+    function SidebarIcon(props) {
+      return h('svg', { width: props.size || 18, height: props.size || 18, viewBox: '0 0 24 24', fill: 'none', stroke: 'currentColor', strokeWidth: 1.8, strokeLinecap: 'round', strokeLinejoin: 'round', 'aria-hidden': true },
+        h('path', { d: 'M4 19V5' }), h('path', { d: 'M4 12h5l2 3h9' }), h('path', { d: 'M9 7h5' }), h('path', { d: 'M9 10h7' }));
+    }
+
+    function apply(ctx) {
+      ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'workspace-audit: dictionaries');
+      const t = ctx.locale.bind(NS);
+      ctx.slots.inject('main', () => ctx.slots.register({ name: 'main', key: PANEL_ID, locale: NS }, Panel));
+      ctx.slots.inject('sidebar.panellist', () => ctx.slots.register({ name: 'sidebar.panellist', id: PANEL_ID, order: 22, label: () => t('panel'), locale: NS }, SidebarIcon));
+    }
+
+    return { inject: ['slots', 'locale', 'layout'], apply };
+  },
+});

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: workspace-audit
+      name: '@tomjerrygit/dsh-workspace-audit'

package/icon.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M4 19V5"/><path d="M4 12h5l2 3h9"/><path d="M9 7h5"/><path d="M9 10h7"/>
+</svg>

package/index.js

@@ -0,0 +1,410 @@
+/**
+ * dsh-workspace-audit Host half.
+ * Read-only, local-first workspace health checks with a Markdown handover report.
+ */
+import { randomBytes } from 'node:crypto';
+import { promises as fs } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+
+const execFileAsync = promisify(execFile);
+const ROUTE = '/api/workspace-audit';
+const AUTH_PATH = ROUTE + '/auth';
+const SCAN_PATH = ROUTE + '/scan';
+const SETTINGS_PATH = ROUTE + '/settings';
+const MAX_WORKSPACES = 20;
+const SKIP_NAMES = new Set(['.git', 'node_modules', '.venv', 'venv', '__pycache__', '.pytest_cache', '.ruff_cache', '.mypy_cache', 'dist', 'build', 'target', '.next', '.nuxt', 'coverage']);
+const ARTIFACT_NAMES = new Set(['node_modules', '.venv', 'venv', '__pycache__', '.pytest_cache', '.ruff_cache', '.mypy_cache', 'dist', 'build', 'target', '.next', '.nuxt', 'coverage', 'release-archive', 'test+files', 'BeeOffice-v5.2.3-windows', 'BeeOffice_logs']);
+let authToken = null;
+
+function resolveDshHome() {
+  if (typeof process.env.DSH_HOME === 'string' && process.env.DSH_HOME.trim().length > 0) return process.env.DSH_HOME.trim();
+  return path.join(os.homedir(), '.dsh');
+}
+
+function settingsFile() {
+  return path.join(resolveDshHome(), 'workspace-audit', 'settings.json');
+}
+
+async function loadSettings() {
+  try {
+    const raw = JSON.parse(await fs.readFile(settingsFile(), 'utf8'));
+    return { roots: Array.isArray(raw.roots) ? raw.roots.filter((entry) => typeof entry === 'string').slice(0, 30) : [] };
+  } catch (error) {
+    return { roots: [] };
+  }
+}
+
+async function saveSettings(settings) {
+  await fs.mkdir(path.dirname(settingsFile()), { recursive: true });
+  await fs.writeFile(settingsFile(), JSON.stringify(settings, null, 2) + '\n', 'utf8');
+}
+
+function sendJson(res, status, payload) {
+  res.writeHead(status, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' });
+  res.end(JSON.stringify(payload));
+}
+
+function matchesPath(req, expected) {
+  try {
+    return new URL(req.url || '/', 'http://localhost').pathname === expected;
+  } catch (error) {
+    return false;
+  }
+}
+
+function isLoopback(req) {
+  const address = String(req.socket && req.socket.remoteAddress || '');
+  return address === '127.0.0.1' || address === '::1' || address === '::ffff:127.0.0.1';
+}
+
+function requireToken(req, res) {
+  const provided = req.headers['x-workspace-audit-token'];
+  if (typeof provided === 'string' && authToken !== null && provided === authToken) return true;
+  sendJson(res, 401, { error: 'unauthorized' });
+  return false;
+}
+
+function createAuthRoute() {
+  return async (req, res) => {
+    if (!matchesPath(req, AUTH_PATH)) {
+      sendJson(res, 404, { error: 'not found' });
+      return;
+    }
+    if (!isLoopback(req)) {
+      sendJson(res, 403, { error: 'loopback only' });
+      return;
+    }
+    if (authToken === null) authToken = randomBytes(24).toString('hex');
+    sendJson(res, 200, { token: authToken });
+  };
+}
+
+function createReadRoute(endpoint, build) {
+  return async (req, res) => {
+    if (req.method !== 'GET') {
+      sendJson(res, 405, { error: 'method not allowed' });
+      return;
+    }
+    if (!matchesPath(req, endpoint)) {
+      sendJson(res, 404, { error: 'not found' });
+      return;
+    }
+    if (!requireToken(req, res)) return;
+    try {
+      sendJson(res, 200, await build(req));
+    } catch (error) {
+      sendJson(res, 500, { error: String((error && error.message) || error) });
+    }
+  };
+}
+
+async function readJsonBody(req) {
+  const chunks = [];
+  for await (const chunk of req) chunks.push(chunk);
+  return JSON.parse(Buffer.concat(chunks).toString('utf8') || '{}');
+}
+
+async function discoverWorkspaces(settings) {
+  const roots = new Set(settings.roots);
+  try {
+    const parsed = JSON.parse(await fs.readFile(path.join(resolveDshHome(), 'storages', 'workspace.json'), 'utf8'));
+    const table = parsed && parsed.tables && parsed.tables.workspaces;
+    for (const workspace of table && typeof table === 'object' ? Object.values(table) : []) {
+      if (workspace && typeof workspace.path === 'string' && workspace.path.length > 0) roots.add(workspace.path);
+    }
+  } catch (error) {
+    // workspace registry is optional
+  }
+  const result = [];
+  const seen = new Set();
+  const addRoot = (root) => {
+    if (result.length >= MAX_WORKSPACES) return;
+    const resolved = path.resolve(root);
+    if (seen.has(resolved)) return;
+    seen.add(resolved);
+    result.push({ path: resolved, title: path.basename(resolved) || resolved });
+  };
+  for (const root of roots) {
+    if (result.length >= MAX_WORKSPACES) break;
+    try {
+      const stat = await fs.stat(root);
+      if (!stat.isDirectory()) continue;
+    } catch (error) {
+      continue;
+    }
+    addRoot(root);
+    // A multi-project container (for example D:\DSTools) is useful as a parent,
+    // and its immediate Git repositories are useful as individual workspaces.
+    if (!(await fs.stat(path.join(root, '.git')).catch(() => null))) {
+      const children = await fs.readdir(root, { withFileTypes: true }).catch(() => []);
+      for (const child of children) {
+        if (result.length >= MAX_WORKSPACES) break;
+        if (!child.isDirectory() || SKIP_NAMES.has(child.name) || child.name.startsWith('.')) continue;
+        const gitPath = path.join(root, child.name, '.git');
+        const isRepo = await fs.stat(gitPath).catch(() => null);
+        if (isRepo) addRoot(path.join(root, child.name));
+      }
+    }
+  }
+  return result;
+}
+
+async function gitInfo(root) {
+  const run = async (args) => {
+    try {
+      const result = await execFileAsync('git', ['-C', root, ...args], { timeout: 8000, windowsHide: true, maxBuffer: 2 * 1024 * 1024 });
+      return String(result.stdout || '').trim();
+    } catch (error) {
+      return '';
+    }
+  };
+  const isRepo = (await run(['rev-parse', '--is-inside-work-tree'])) === 'true';
+  if (!isRepo) return { isRepo: false };
+  const remote = await run(['remote', 'get-url', 'origin']);
+  const branch = await run(['branch', '--show-current']);
+  const status = await run(['status', '--porcelain']);
+  const last = await run(['log', '-1', '--format=%h|%ad|%s', '--date=short']);
+  const tags = await run(['tag', '--sort=-v:refname']);
+  const tracked = await run(['ls-files']);
+  return {
+    isRepo: true,
+    remote,
+    branch,
+    dirty: status.length === 0 ? 0 : status.split(/\r?\n/).filter(Boolean).length,
+    last,
+    tags: tags.split(/\r?\n/).filter(Boolean).slice(0, 5),
+    tracked: tracked.length === 0 ? [] : tracked.split(/\r?\n/),
+  };
+}
+
+async function fileSize(file) {
+  try {
+    return (await fs.stat(file)).size;
+  } catch (error) {
+    return 0;
+  }
+}
+
+async function directorySize(root, maxEntries) {
+  let total = 0;
+  let entries = 0;
+  const stack = [root];
+  while (stack.length > 0 && entries < maxEntries) {
+    const current = stack.pop();
+    let items;
+    try {
+      items = await fs.readdir(current, { withFileTypes: true });
+    } catch (error) {
+      continue;
+    }
+    for (const item of items) {
+      if (entries >= maxEntries) break;
+      entries += 1;
+      const full = path.join(current, item.name);
+      if (item.isDirectory()) {
+        if (SKIP_NAMES.has(item.name)) continue;
+        stack.push(full);
+      } else if (item.isFile()) {
+        total += await fileSize(full);
+      }
+    }
+  }
+  return { total, entries };
+}
+
+function isTextFile(name) {
+  return /\.(py|js|mjs|cjs|ts|tsx|jsx|json|ya?ml|toml|md|txt|cfg|ini|sh|ps1|bat|cmd|go|rs|c|h|cpp|java|kt|rb|php|sql|css|html)$/i.test(name);
+}
+
+function testFilePattern(name) {
+  return /(^|\/)(tests?\/|test_[^/]+\.py$|[^/]+\.(test|spec)\.(js|ts|jsx|tsx|mjs)$|.*_test\.(go|rs|py)$)/i.test(name);
+}
+
+async function scanWorkspace(workspace) {
+  const root = workspace.path;
+  const git = await gitInfo(root);
+  const tracked = Array.isArray(git.tracked) ? git.tracked : [];
+  const rootEntries = await fs.readdir(root, { withFileTypes: true }).catch(() => []);
+  const markers = {
+    readme: rootEntries.some((entry) => /^readme(\.|$)/i.test(entry.name)),
+    license: rootEntries.some((entry) => /^licen[cs]e(\.|$)/i.test(entry.name)),
+    gitignore: rootEntries.some((entry) => entry.name === '.gitignore'),
+    docker: rootEntries.some((entry) => /^(dockerfile|docker-compose\.ya?ml)$/i.test(entry.name)),
+    manifest: rootEntries.some((entry) => /^(package\.json|pyproject\.toml|requirements\.txt|cargo\.toml|go\.mod|pom\.xml|build\.gradle)$/i.test(entry.name)),
+    lockfile: rootEntries.some((entry) => /^(package-lock\.json|pnpm-lock\.yaml|yarn\.lock|poetry\.lock|uv\.lock|cargo\.lock|go\.sum)$/i.test(entry.name)),
+    tests: rootEntries.some((entry) => /^tests?$/i.test(entry.name)),
+    ci: rootEntries.some((entry) => entry.name === '.github'),
+    docs: rootEntries.some((entry) => /^docs?$/i.test(entry.name)),
+  };
+  const artifacts = [];
+  for (const entry of rootEntries) {
+    if (entry.isDirectory() && ARTIFACT_NAMES.has(entry.name)) {
+      const size = await directorySize(path.join(root, entry.name), 5000);
+      artifacts.push({ name: entry.name, bytes: size.total });
+    }
+  }
+  const size = await directorySize(root, 20000);
+  const sourceFiles = tracked.filter((file) => isTextFile(file) && !file.includes('node_modules/')).slice(0, 400);
+  let todo = 0;
+  let dangerous = 0;
+  let secretFiles = [];
+  const readmeText = rootEntries.some((entry) => /^readme/i.test(entry.name)) ? await fs.readFile(path.join(root, rootEntries.find((entry) => /^readme/i.test(entry.name)).name), 'utf8').catch(() => '') : '';
+  for (const file of sourceFiles) {
+    const full = path.join(root, file);
+    const basename = path.basename(file).toLowerCase();
+    const sourceLike = /\.(py|js|mjs|cjs|ts|tsx|jsx|go|rs|c|h|cpp|java|kt|rb|php|sql)$/i.test(file);
+    const secretLike = !sourceLike && (
+      /(^|\/)\.env(\.|$)/i.test(file) ||
+      /\.(pem|key|p12|pfx|jks|keystore)$/i.test(file) ||
+      /(^|\/)(secrets?|credentials?)(\.(json|ya?ml|txt|ini|cfg)|$)/i.test(file) ||
+      basename === '.npmrc' || basename === '.pypirc'
+    );
+    if (secretLike) secretFiles.push(file);
+    if (!/\.(py|js|mjs|cjs|ts|tsx|jsx|sh|ps1|bat|cmd|yml|yaml)$/i.test(file)) continue;
+    const text = await fs.readFile(full, 'utf8').catch(() => '');
+    if (text.length === 0) continue;
+    todo += (text.match(/\b(TODO|FIXME|XXX|HACK)\b/g) || []).length;
+    dangerous += (text.match(/shell\s*=\s*True|\bexec\s*\(|pickle\.load\s*\(/g) || []).length;
+  }
+  const workflowsDir = path.join(root, '.github', 'workflows');
+  const workflowFiles = await fs.readdir(workflowsDir, { withFileTypes: true }).catch(() => []);
+  const workflows = [];
+  for (const file of workflowFiles.filter((entry) => entry.isFile()).slice(0, 30)) {
+    const text = await fs.readFile(path.join(workflowsDir, file.name), 'utf8').catch(() => '');
+    workflows.push({
+      name: file.name,
+      pullRequest: /pull_request/.test(text),
+      selfHosted: /self-hosted/.test(text),
+      permissions: /permissions:/.test(text),
+      publish: /npm publish|twine upload|upload-release|gh release|docker push/.test(text),
+    });
+  }
+  const testFiles = tracked.filter((file) => testFilePattern(file)).length;
+  const dimensions = {
+    documentation: (markers.readme ? 35 : 0) + (markers.docs ? 25 : 0) + (readmeText.length > 4000 ? 20 : readmeText.length > 1000 ? 10 : 0) + (markers.license ? 20 : 0),
+    development: (markers.manifest ? 25 : 0) + (markers.lockfile ? 20 : 0) + (markers.gitignore ? 20 : 0) + (markers.ci ? 25 : 0) + (markers.docker ? 10 : 0),
+    debugging: Math.min(100, testFiles * 6 + (markers.tests ? 20 : 0) + (markers.ci ? 20 : 0)),
+    performance: Math.max(0, 100 - Math.min(80, Math.round(size.total / (1024 * 1024 * 50) * 10)) - (artifacts.length > 0 ? 20 : 0)),
+    functionality: (markers.readme ? 30 : 0) + (tracked.length > 50 ? 35 : tracked.length > 10 ? 20 : 0) + (markers.tests ? 20 : 0) + (markers.ci ? 15 : 0),
+    security: Math.max(0, 100 - (git.isRepo && git.dirty > 0 ? 15 : 0) - Math.min(40, dangerous * 5) - (workflows.some((wf) => wf.selfHosted && wf.pullRequest) ? 40 : 0) - (secretFiles.length > 0 ? 20 : 0) - (git.isRepo && !git.remote ? 10 : 0)),
+    github: (git.isRepo ? 30 : 0) + (git.remote ? 30 : 0) + (git.dirty === 0 ? 20 : 0) + (git.tags && git.tags.length > 0 ? 20 : 0),
+  };
+  const score = Math.round(Object.values(dimensions).reduce((sum, value) => sum + value, 0) / 7);
+  const risks = [];
+  if (!git.isRepo) risks.push({ severity: 'P2', text: '目录未初始化 Git，无法追踪变更、回滚或协作。' });
+  if (git.isRepo && git.dirty > 0) risks.push({ severity: 'P1', text: `工作区有 ${git.dirty} 个未提交变更，发布前需确认。` });
+  if (git.isRepo && !git.remote) risks.push({ severity: 'P2', text: '仓库没有 origin 远端，缺少异地备份/协作。' });
+  if (!markers.readme) risks.push({ severity: 'P1', text: '缺少 README，后来开发者难以启动项目。' });
+  if (!markers.ci) risks.push({ severity: 'P1', text: '缺少 CI，测试/构建容易回归。' });
+  if (workflows.some((wf) => wf.selfHosted && wf.pullRequest)) risks.push({ severity: 'P0', text: '自托管 Runner 被 pull_request 触发，公开仓库存在不可信代码执行风险。' });
+  if (secretFiles.length > 0) risks.push({ severity: 'P1', text: `发现疑似密钥文件：${secretFiles.slice(0, 5).join(', ')}（只检查了文件名，未读取内容）。` });
+  if (dangerous > 10) risks.push({ severity: 'P1', text: `发现 ${dangerous} 处 shell=True/exec/pickle.load 高危模式，需确认输入来源。` });
+  else if (dangerous > 0) risks.push({ severity: 'P2', text: `发现 ${dangerous} 处 shell=True/exec/pickle.load 模式，建议人工确认。` });
+  const significantArtifacts = artifacts.filter((item) => item.bytes >= 1024 * 1024);
+  if (significantArtifacts.length > 0) {
+    const huge = significantArtifacts.some((item) => item.bytes >= 1024 * 1024 * 1024);
+    risks.push({ severity: huge ? 'P1' : 'P2', text: `发现构建/缓存目录：${significantArtifacts.map((item) => item.name + ' ' + Math.round(item.bytes / 1024 / 1024) + 'MB').join(', ')}。` });
+  }
+  if (!markers.lockfile && markers.manifest) risks.push({ severity: 'P2', text: '有依赖清单但没有锁文件，构建不可复现。' });
+  if (todo > 20) risks.push({ severity: 'P2', text: `源码中约 ${todo} 处 TODO/FIXME，建议建立清理计划。` });
+  return {
+    path: root,
+    title: workspace.title,
+    git,
+    markers,
+    workflows,
+    size: { bytes: size.total, scannedEntries: size.entries, artifacts },
+    testFiles,
+    todo,
+    dangerous,
+    secretFiles,
+    dimensions,
+    score,
+    risks,
+  };
+}
+
+function grade(score) {
+  if (score >= 85) return 'A';
+  if (score >= 70) return 'B';
+  if (score >= 55) return 'C';
+  return 'D';
+}
+
+function renderReport(workspaces) {
+  const lines = ['# Workspace Audit Report', '', `Generated: ${new Date().toISOString()}`, ''];
+  for (const workspace of workspaces) {
+    lines.push(`## ${workspace.title}`, '', `- Path: \`${workspace.path}\``, `- Score: **${workspace.score}/100 (${grade(workspace.score)})**`, `- Git: ${workspace.git.isRepo ? workspace.git.branch + ' · ' + (workspace.git.remote || 'no remote') : 'not a repository'}`, `- Size: ${Math.round(workspace.size.bytes / 1024 / 1024)}MB`, `- Test files: ${workspace.testFiles}`, `- TODO/FIXME: ${workspace.todo}`, '');
+    lines.push('### Dimensions', '');
+    for (const [key, value] of Object.entries(workspace.dimensions)) lines.push(`- ${key}: ${value}/100`);
+    lines.push('', '### Risks', '');
+    if (workspace.risks.length === 0) lines.push('- No blocking risks found.');
+    for (const risk of workspace.risks) lines.push(`- **${risk.severity}** ${risk.text}`);
+    lines.push('');
+  }
+  return lines.join('\n');
+}
+
+async function runScan() {
+  const settings = await loadSettings();
+  const discovered = await discoverWorkspaces(settings);
+  const workspaces = [];
+  const failures = [];
+  for (const workspace of discovered) {
+    try {
+      workspaces.push(await scanWorkspace(workspace));
+    } catch (error) {
+      failures.push({ path: workspace.path, error: String((error && error.message) || error) });
+    }
+  }
+  workspaces.sort((left, right) => left.score - right.score);
+  return { generatedAt: Date.now(), workspaces, failures, discovered: discovered.length, report: renderReport(workspaces) };
+}
+
+function createSettingsRoute() {
+  return async (req, res) => {
+    if (!matchesPath(req, SETTINGS_PATH)) {
+      sendJson(res, 404, { error: 'not found' });
+      return;
+    }
+    if (req.method === 'GET') {
+      if (!requireToken(req, res)) return;
+      sendJson(res, 200, { settings: await loadSettings(), workspaces: await discoverWorkspaces(await loadSettings()) });
+      return;
+    }
+    if (req.method !== 'POST') {
+      sendJson(res, 405, { error: 'method not allowed' });
+      return;
+    }
+    if (!requireToken(req, res)) return;
+    try {
+      const body = await readJsonBody(req);
+      const current = await loadSettings();
+      const requested = [
+        ...(Array.isArray(body.roots) ? body.roots : []),
+        ...(typeof body.add === 'string' ? [body.add] : []),
+      ];
+      const roots = [...new Set([...current.roots, ...requested])]
+        .map((entry) => String(entry).trim())
+        .filter((entry) => entry.length > 0)
+        .slice(0, 30);
+      const next = { roots };
+      await saveSettings(next);
+      sendJson(res, 200, { ok: true, settings: next });
+    } catch (error) {
+      sendJson(res, 400, { error: 'invalid json' });
+    }
+  };
+}
+
+function apply(ctx) {
+  ctx.effect(() => ctx.webServer.register({ kind: 'prefix', path: AUTH_PATH, handler: createAuthRoute() }), 'workspace-audit: auth');
+  ctx.effect(() => ctx.webServer.register({ kind: 'prefix', path: SCAN_PATH, handler: createReadRoute(SCAN_PATH, () => runScan()) }), 'workspace-audit: scan');
+  ctx.effect(() => ctx.webServer.register({ kind: 'prefix', path: SETTINGS_PATH, handler: createSettingsRoute() }), 'workspace-audit: settings');
+}
+
+export { apply };
+export const inject = ['webServer'];

package/locale/en.json

@@ -0,0 +1,3 @@
+{
+  "panel": "Workspace Audit"
+}

package/locale/zh.json

@@ -0,0 +1,3 @@
+{
+  "panel": "工作区体检"
+}

package/package.json

@@ -1,6 +1,64 @@
 {
   "name": "@tomjerrygit/dsh-workspace-audit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "private": false,
+  "description": "Local-first workspace health audit for DeepSeek Harness: Git, tests, CI, size, security hotspots, and a Markdown handover report.",
+  "type": "module",
+  "engines": {
+    "dsh": ">=0.2.0-rc.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./icon": "./icon.svg",
+    "./locale/*.json": "./locale/*.json"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "icon.svg",
+    "locale/*.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "dsh": {
+    "manifestVersion": 1,
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-sidebar",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-locale"
+      ]
+    }
+  },
+  "author": {
+    "name": "TomJerryGit"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TomJerryGit/dsh-workspace-audit.git"
+  },
+  "homepage": "https://github.com/TomJerryGit/dsh-workspace-audit#readme",
+  "bugs": {
+    "url": "https://github.com/TomJerryGit/dsh-workspace-audit/issues"
+  },
+  "keywords": [
+    "dsh-plugin",
+    "deepseek-harness",
+    "workspace",
+    "audit",
+    "health",
+    "handover",
+    "security"
+  ]
+}