前言¶

在 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。