前言¶

在 DeepSeek Harness（DSH）裏同時推進多個小項目時，目錄、工時和「下一步」往往散落在筆記或記憶裏，側欄又缺少一塊專門用來「掃一眼最近做了什麼」的區域。Project Atlas 是維護者 zmy1006-sudo 發佈的客戶端插件：在側欄全局面板區掛一塊彩色標籤牆，每個項目一條膠囊標籤，懸停或鍵盤聚焦時展開成卡片，展示日期、摘要、工時、成本和待辦。倉庫自帶 7 條示例數據、無構建步驟，UI 集中在 client.js。下面介紹它做什麼、怎麼裝、怎麼換成自己的項目列表。

這是什麼¶

Project Atlas（npm 包名 dsh-project-atlas，版本 1.0.0，MIT）面向 DSH 側欄：用編號 + 類型圖標 + 標題組成藥丸形標籤，五種類型配色區分數據與模型、Web 應用、文檔與演示、插件與工具、可視化等類別。摺疊時單條高度約 46–66px，整牆可在一屏內瀏覽；懸停（或 Tab 聚焦）時圓角從膠囊 morph 到卡片，標籤略上浮，約 0.26s 內展開日期、摘要、項目路徑與 plans 清單。

主機端 index.js 幾乎無邏輯，界面全部在客戶端實現；啓用後側欄全局面板區會出現 Project Atlas 圖標。插件索引與源碼見 SkillHub 目錄頁 與 GitHub 倉庫。

核心功能¶

資料中明確列出的能力如下，均可在 README 中核對。

佈局與視圖

• 標籤結構：01 → [類型 logo] → 標題 → chevron；網格（標籤牆）與列表（單行）兩種視圖，分段控件切換；S / M / L 三檔調節列寬、內邊距與標題行數。
• 類型篩選：每個類別一個 chip，帶色點與數量統計。
• 容器查詢：按面板自身寬度（≤760px、≤620px）排版，而非整窗寬度。

主題與持久化

• 明暗模式：容器與文字使用宿主主題 token（--dsw-alias-*），僅五種類型色由插件定義（如 blue #4C8DFF、mint #22C58B 等）。
• 視圖與尺寸選擇寫入 localStorage，刷新後保留。

無障礙與實現

• 卡片與行可聚焦，:focus-visible 與 hover 表現一致；支持 prefers-reduced-motion 與觸摸環境（hover: none）。
• 零運行時依賴，無需 build；圖標爲內聯 SVG。engines.dsh 要求 >=0.2.0-rc.1 <0.3.0-0。

安裝與啓用¶

官方 README 給出三種方式，任選其一。

1. 插件市場

將本倉庫的 market-index.json 託管在任意 http(s) URL，在 DSH 的 Plugins 頁添加該索引 URL，再從 Discover 安裝。

2. npm

在 DSH profile 目錄內執行：

pnpm add dsh-project-atlas

隨後在 Plugins 頁啓用。

3. 本地目錄

在 Plugins 頁使用「Install from directory」，或將 plugin_manager 的 install_bundle 指向本插件文件夾。

啓用後，側欄全局面板區會出現 Project Atlas 入口。

典型用法：編輯 PROJECTS 數組¶

項目數據寫在 client.js 頂部的 PROJECTS 數組。保存後刷新 DSH 頁面即可。面板按 date 字段從新到舊排序；標籤編號 01.. 與數組順序一致。

{
  id: 'forecast-web',        // 唯一 id
  category: 'web',           // model | web | deck | plugin | viz
  date: '2025-10-14',        // YYYY-MM-DD
  title: 'Forecast workbench: wrap a CLI model in a web UI',
  path: 'forecast-web/',     // 項目目錄，可爲空
  summary: '…',              // 一兩句，懸停卡片約兩行
  hours: 34,                 // 工時，可小數
  cost: 178,                 // 成本，單位爲 CNY
  plans: ['…'],              // 下一步，每項一行
}

若要新增類別：在 CATEGORIES 追加 { id, tone }（tone 爲 TONES 的鍵），在 GLYPHS 增加 SVG path，並在 zh、en 詞典中補充 cat.<id>。

適用場景與注意¶

適合誰

• 希望在 DSH 側欄快速瀏覽近期 side project、插件或實驗，而不打開外部筆記或表格的開發者。
• 願意維護一份靜態 PROJECTS 列表、接受改代碼後刷新頁面生效的使用方式。

使用前請知悉

• DSH 社區插件目錄（如 SkillHub）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；安裝前請自行閱讀倉庫源碼與 MIT 許可證。
• 插件在當前 DSH 進程權限下運行；從市場、npm 或本地目錄安裝前，建議覈對 client.js 與 cordis.patch.yml 是否符合你的安全預期。
• 倉庫示例含 7 條記錄、不含個人數據；星標等目錄頁元數據以各站點展示爲準。

結尾¶

Project Atlas 把「最近項目」收成側欄裏一塊可篩選、可切換視圖與尺寸的標籤牆，懸停即見工時、成本與 next steps，適合作爲個人項目地圖的輕量面板。更多信息見 SkillHub 插件頁 與 GitHub：zmy1006-sudo/dsh-project-atlas。