Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ jobs:
uses: actions/checkout@v6
with:
repository: deepseek-ai/deepseek-harness
ref: 687f282e8625c6b8d11ff58211a90524be2e4317
ref: b830ec950faba0a46dda564be3e2d854afed94f1
path: upstream/deepseek-harness
persist-credentials: false

Expand Down
20 changes: 11 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ Work/Chat spaces, file delivery, sidebar workbench and session map.
> DeepViewer is a community project. It is not affiliated with or endorsed by DeepSeek.

> [!IMPORTANT]
> The current release is **DeepViewer 0.7.3 / Build 93**, based on DeepSeek Harness `0.2.1-rc.2`, for **Apple Silicon arm64 only**. The freshly built DMG is Developer ID signed and Apple-notarized. Automated checks cover native Figma tools and the private companion; real Figma pairing/edit/export in DeepViewer, real-account flows and full interaction acceptance remain separate manual checks.
> The published release is **DeepViewer 0.7.3 / Build 93**, for **Apple Silicon arm64 only**. That DMG is Developer ID signed and Apple-notarized and bundles DeepSeek Harness `0.2.1-rc.2`. This source targets **DeepViewer 0.8.0** (committed build number 93) and bundles DeepSeek Harness `0.2.1-rc.5` (`dsh-v0.2.1-rc.5`). 0.8.0 is not signed, notarized, or published. Automated checks cover native Figma tools and the private companion; real Figma pairing/edit/export in DeepViewer, real-account flows and full interaction acceptance remain separate manual checks.

> [!TIP]
> The [0.7.3 release](https://github.com/Duoasa/DeepViewer/releases/tag/v0.7.3) provides a [SHA-256 checksum list](https://github.com/Duoasa/DeepViewer/releases/download/v0.7.3/SHA256SUMS.txt). Installed and development data use separate, version-independent directories; back up existing data before a major upgrade. The previous [0.7.1 release](https://github.com/Duoasa/DeepViewer/releases/tag/v0.7.1), [0.5.1 release](https://github.com/Duoasa/DeepViewer/releases/tag/v0.5.1), historical [0.3.3 / Build 75 release](https://github.com/Duoasa/DeepViewer/releases/tag/v0.3.3), with its SHA-256 checksum, and [0.2.5 release](https://github.com/Duoasa/DeepViewer/releases/tag/v0.2.5-preview.1) remain available.
Expand All @@ -64,6 +64,8 @@ See the [0.7.3 release record](docs/sdd/releases/v0.7.3.md) for package verifica

## Native DSH-to-Figma

This source bundles [DSH-to-Figma 0.3.1](https://github.com/Duoasa/DSH-to-Figma/releases/tag/v0.3.1), a GitHub prerelease whose peer range includes 0.2.1-rc.5.

[DSH-to-Figma](https://github.com/Duoasa/DSH-to-Figma) connects the agent to Figma's
native Plugin API. Read design context, create and edit frames, text, auto layout,
components and variables, capture screenshots and export assets. Generated designs
Expand All @@ -76,14 +78,14 @@ with native layers and a 1440 × 900 frame. This is an upstream example, not a n
DeepViewer acceptance screenshot.*

1. Open a **Work** session with a local workspace. Ask: “Set up Figma and show me the companion manifest path.” The agent calls `figma_setup`.
2. In Figma Desktop, choose **Plugins → Development → Import plugin from manifest**, select the generated `manifest.json`, then run **DSH to Figma · Local** in the target Design file. Keep its window open.
2. In Figma Desktop, choose **Plugins → Development → Import plugin from manifest**, select the generated `manifest.json` under `DSH_HOME/figma`, then run **DSH to Figma · Local** in the target Design file. Keep its window open. Do not import the generic template; that template still names port 3055.
3. Ask DeepViewer to check the connection (`figma_status`) and describe the intended edit. One connected file is selected automatically; multiple files require an explicit choice.

The paired companion stays in the current app profile's `harness-home/figma` folder.
It contains a local credential: keep it private and keep the folder in place.
Installed DeepViewer uses loopback port **3065**, development uses **3066**,
separate from standalone DSH's **3055**. Existing explicit plugin settings take
precedence. A port conflict keeps diagnostics available without stopping the
The generated companion and token live under `DSH_HOME/figma`, never in the application payload.
The folder contains a local credential: keep it private and keep the folder in place.
Installed DeepViewer uses loopback port **3065**. The dev build uses **3066**.
Existing explicit configuration wins. **3055** is only the generic template default; DeepViewer does not use that port.
A port conflict keeps diagnostics available without stopping the
agent; close the conflicting instance or change `bridgePort` on the
`deepviewer-figma` row in the desktop profile patch and restart.
`DEEPVIEWER_DISABLE_FIGMA=1` disables the module and preserves that selection;
Expand Down Expand Up @@ -154,10 +156,10 @@ Office conversion may wait while scanning protected font directories in a real u

| Component | Source and license | What DeepViewer changes |
| --- | --- | --- |
| Core agent and native shell | [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness), MIT, pinned to `687f282e8625c6b8d11ff58211a90524be2e4317` (`0.2.1-rc.2`) | Official Electron/DesktopHost with the [DeepViewer adapter](apps/deepviewer-adapter) and checked compatibility contracts. The agent loop remains upstream-owned. |
| Core agent and native shell | [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness), MIT, pinned to `b830ec950faba0a46dda564be3e2d854afed94f1` (`0.2.1-rc.5`, tag `dsh-v0.2.1-rc.5`) | Official Electron/DesktopHost with the [DeepViewer adapter](apps/deepviewer-adapter) and checked compatibility contracts. The agent loop remains upstream-owned. |
| Desktop source baseline | [Duoasa/scoder](https://github.com/Duoasa/scoder), `0.7.0 / Build 43`, pinned to `e277adc6ce512655095e6f65c63bdc72d24bae95`; original notices retained | Restore DeepViewer branding, package/update identities and data isolation, retain native features, and fix metadata-driven renderer replacement. Scoder's release history and user data are not imported. |
| Subscriptions and image tools | [V1ki/dsh-plugin-subscriptions](https://github.com/V1ki/dsh-plugin-subscriptions), MIT, `0.3.1` | Built-in DSH 0.2.1 compatibility module, scoped RPC/loopback checks, remaining-usage display, and image-generation status styling. |
| Native Figma tools | [Duoasa/DSH-to-Figma](https://github.com/Duoasa/DSH-to-Figma), MIT, `0.2.1` | Native Host module, private companion and separate bridge defaults. [Pinned source and file hashes](vendor/dsh-to-figma/UPSTREAM.json). |
| Native Figma tools | [Duoasa/DSH-to-Figma](https://github.com/Duoasa/DSH-to-Figma), MIT, `0.3.1` ([GitHub prerelease v0.3.1](https://github.com/Duoasa/DSH-to-Figma/releases/tag/v0.3.1)) | Native Host module, private companion and separate bridge defaults. [Pinned source and file hashes](vendor/dsh-to-figma/UPSTREAM.json). |
| Sidebar provenance | [omdsh-dev/DSH-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar), MIT | The standalone plugin is retired; Harness native panels take over the workbench. Attribution is retained for reused workflow code. |
| Model capabilities | [DeepViewer model-capabilities module](apps/dsh-plugin-model-capabilities), MIT, `1.0.2` | Provider/model scanning and reasoning/multimodal configuration, replacing the old `dsh-plugin-reasoning` activation while preserving supported settings. |
| Session map | [Vendored Synapse source](apps/deepviewer-adapter/workflows/vendor/synapse), with its original license and source record | Built-in session-map integration within the DeepViewer adapter. |
Expand Down
16 changes: 9 additions & 7 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ DeepViewer 是针对设计师优化的开源专用 Agent 工作台,基于
> DeepViewer 是独立社区项目,与 DeepSeek 没有从属或官方背书关系。

> [!IMPORTANT]
> 当前正式版本为 **DeepViewer 0.7.3 / Build 93**,内置 DeepSeek Harness `0.2.1-rc.2`,**仅支持 Apple Silicon arm64**。DMG 已从源码全新构建,完成 Developer ID 签名和 Apple 公证。自动检查覆盖原生 Figma 工具和私有配套插件;DeepViewer 中真实 Figma 配对、编辑与导出,以及真实账户和完整交互仍需人工验收。
> 已发布的安装包仍是 **DeepViewer 0.7.3 / Build 93**,**仅支持 Apple Silicon arm64**。该 DMG 已从源码全新构建,完成 Developer ID 签名和 Apple 公证,内置 DeepSeek Harness `0.2.1-rc.2`。当前源码目标版本为 **DeepViewer 0.8.0**(提交中的 Build 号仍为 93),内置 DeepSeek Harness `0.2.1-rc.5`(`dsh-v0.2.1-rc.5`)。0.8.0 尚未签名、公证或发布。自动检查覆盖原生 Figma 工具和私有配套插件;DeepViewer 中真实 Figma 配对、编辑与导出,以及真实账户和完整交互仍需人工验收。

> [!TIP]
> [0.7.3 Release](https://github.com/Duoasa/DeepViewer/releases/tag/v0.7.3) 提供 [SHA-256 校验清单](https://github.com/Duoasa/DeepViewer/releases/download/v0.7.3/SHA256SUMS.txt)。安装版和开发版使用相互独立、与版本号无关的数据目录;重大升级前请备份。上一版本 [0.7.1](https://github.com/Duoasa/DeepViewer/releases/tag/v0.7.1), [0.5.1](https://github.com/Duoasa/DeepViewer/releases/tag/v0.5.1)、历史 [0.3.3 / Build 75](https://github.com/Duoasa/DeepViewer/releases/tag/v0.3.3) 及其 SHA-256 清单、历史 [0.2.5 版本](https://github.com/Duoasa/DeepViewer/releases/tag/v0.2.5-preview.1) 仍可下载。
Expand All @@ -62,6 +62,8 @@ DeepViewer 是针对设计师优化的开源专用 Agent 工作台,基于

## 原生 DSH-to-Figma

当前源码内置 [DSH-to-Figma 0.3.1](https://github.com/Duoasa/DSH-to-Figma/releases/tag/v0.3.1),这是 GitHub 预发布,其 peer 范围包含 0.2.1-rc.5。

[DSH-to-Figma](https://github.com/Duoasa/DSH-to-Figma) 将 Agent 接入 Figma 原生
Plugin API,可读取设计上下文,创建和编辑画板、文本、自动布局、组件与变量,获取截图并导出素材。
生成的设计保留为 Figma 可编辑图层。
Expand All @@ -72,12 +74,12 @@ Plugin API,可读取设计上下文,创建和编辑画板、文本、自动
这是上游实例,不是本次 DeepViewer 集成的验收截图。*

1. 打开带本地工作区的 **Work** 会话,告诉 Agent:“帮我设置 Figma,给出配套插件的 manifest 路径。”Agent 会调用 `figma_setup`。
2. 在 Figma Desktop 中选择 **Plugins → Development → Import plugin from manifest**,导入生成的 `manifest.json`,在目标 Design 文件中运行 **DSH to Figma · Local**,保持插件窗口打开。
2. 在 Figma Desktop 中选择 **Plugins → Development → Import plugin from manifest**,导入 `DSH_HOME/figma` 下生成的 `manifest.json`,在目标 Design 文件中运行 **DSH to Figma · Local**,保持插件窗口打开。不要导入通用模板;该模板仍写着端口 3055。
3. 让 DeepViewer 检查连接(`figma_status`)并描述想要的修改。只有一个连接文件时自动选用,多个文件时需要明确选择。

配对文件保存在当前应用数据目录的 `harness-home/figma`,其中含本机凭证,请勿分享或移动该文件夹。
安装版使用本机回环端口 **3065**,开发版使用 **3066**,与独立 DSH 默认的 **3055** 分开;
已有显式端口和后端设置优先。端口冲突时保留诊断工具,不阻断 Agent 启动;可关闭冲突实例,
生成的配套插件和配对凭证位于 `DSH_HOME/figma`,不在应用安装包内。其中含本机凭证,请勿分享或移动该文件夹。
安装版使用本机回环端口 **3065**,开发版使用 **3066**。已有显式配置优先。**3055** 只是通用模板的默认端口,DeepViewer 不使用该端口。
端口冲突时保留诊断工具,不阻断 Agent 启动;可关闭冲突实例,
或在 desktop profile patch 的 `deepviewer-figma` 行设置其他 `bridgePort` 后重启。
`DEEPVIEWER_DISABLE_FIGMA=1` 可停用模块;停用选择会保存在 profile 中,恢复时移除对应的 `disabled: true` 覆盖。

Expand Down Expand Up @@ -145,7 +147,7 @@ Work 按项目组织会话,Chat 可以脱离工作区保存对话。两种模

| 组件 | 来源与许可证 | DeepViewer 的修改 |
| --- | --- | --- |
| Agent 内核与原生壳 | [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness),MIT,固定在 `687f282e8625c6b8d11ff58211a90524be2e4317`(`0.2.1-rc.2`) | 官方 Electron/DesktopHost 加 [DeepViewer adapter](apps/deepviewer-adapter) 与经过检查的兼容契约;Agent Loop 仍由上游维护。 |
| Agent 内核与原生壳 | [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness),MIT,固定在 `b830ec950faba0a46dda564be3e2d854afed94f1`(`0.2.1-rc.5`,标签 `dsh-v0.2.1-rc.5`) | 官方 Electron/DesktopHost 加 [DeepViewer adapter](apps/deepviewer-adapter) 与经过检查的兼容契约;Agent Loop 仍由上游维护。 |
| 桌面源码基线 | [Duoasa/scoder](https://github.com/Duoasa/scoder),`0.7.0 / Build 43`,固定在 `e277adc6ce512655095e6f65c63bdc72d24bae95`;保留原始版权说明 | 恢复 DeepViewer 品牌、包名/更新目标和数据隔离,保留原生功能,修复元数据变化引发的界面热卸载;不导入 Scoder 发布记录与用户数据。 |
| 订阅与图片工具 | [V1ki/dsh-plugin-subscriptions](https://github.com/V1ki/dsh-plugin-subscriptions),MIT,`0.3.1` | 内置 DSH 0.2.1 兼容模块,限定范围 RPC/loopback 检查、剩余额度显示及图片生成状态样式。 |
| 侧栏来源 | [omdsh-dev/DSH-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar),MIT | 独立插件退出挂载,工作台由 Harness 原生面板承接;复用工作流代码保留来源与版权。 |
Expand Down Expand Up @@ -177,4 +179,4 @@ pnpm desktop:dev

问题反馈请到 [GitHub Issues](https://github.com/Duoasa/DeepViewer/issues),不要附带凭据、私有文件或未脱敏日志。

DSH-to-Figma 0.2.1(MIT):[上游源码](https://github.com/Duoasa/DSH-to-Figma),[固定提交与文件校验记录](vendor/dsh-to-figma/UPSTREAM.json)。
DSH-to-Figma 0.3.1(MIT,GitHub 预发布 [v0.3.1](https://github.com/Duoasa/DSH-to-Figma/releases/tag/v0.3.1)):[上游源码](https://github.com/Duoasa/DSH-to-Figma),[固定提交与文件校验记录](vendor/dsh-to-figma/UPSTREAM.json)。
2 changes: 1 addition & 1 deletion apps/deepviewer-adapter/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# DeepViewer native adapter

DeepViewer 0.5.0 uses DSH 0.2.0-rc.2 (`639ed015397290b3745d163aafe02ffee4aa3f84`) and its Electron/private DesktopHost. The upstream checkout is disposable build input. Product adaptations live here; the old 0.1.5 whole-file overlays are not replayed.
DeepViewer 0.8.0 uses DSH 0.2.1-rc.5 (`b830ec950faba0a46dda564be3e2d854afed94f1`, tag `dsh-v0.2.1-rc.5`) and its Electron/private DesktopHost. The upstream checkout is disposable build input. Product adaptations live here; the old 0.1.5 whole-file overlays are not replayed.

| Directory | Ownership |
| --- | --- |
Expand Down
2 changes: 1 addition & 1 deletion apps/deepviewer-adapter/client/build-info.ts
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
// The staging pipeline stamps its copy from the product manifest for each build.
export const buildInfo = { version: '0.7.1', build: 'development', kernel: '0.2.1-rc.2' }
export const buildInfo = { version: '0.8.0', build: 'development', kernel: '0.2.1-rc.5' }
2 changes: 1 addition & 1 deletion apps/deepviewer-adapter/desktop/bootstrap.ts
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ export function initializeDeepViewer(): boolean {
if (process.env.DEEPVIEWER_DISABLE_FIGMA === '1') disabledIntegrations.push('dsh-to-figma')
prepareDesktopProfile(process.env.DSH_HOME, runtime, [
{ name: '@deepviewer/adapter', version: product.version, directory: join(runtime, 'node_modules', '@deepviewer', 'adapter') },
{ name: 'dsh-to-figma', version: '0.2.1', directory: join(runtime, 'node_modules', 'dsh-to-figma') },
{ name: 'dsh-to-figma', version: '0.3.1', directory: join(runtime, 'node_modules', 'dsh-to-figma') },
{ name: 'dsh-plugin-subscriptions', version: '0.3.1', directory: join(runtime, 'node_modules', 'dsh-plugin-subscriptions') },
{ name: '@deepviewer/dsh-plugin-model-capabilities', version: '1.0.2', directory: join(runtime, 'node_modules', '@deepviewer', 'dsh-plugin-model-capabilities') },
], disabledIntegrations)
Expand Down
2 changes: 1 addition & 1 deletion apps/deepviewer-adapter/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@deepviewer/adapter",
"version": "0.7.3",
"version": "0.8.0",
"private": true,
"type": "module",
"license": "MIT",
Expand Down
17 changes: 16 additions & 1 deletion apps/deepviewer-adapter/presentation/SidebarRoot.module.css
Original file line number Diff line number Diff line change
Expand Up @@ -484,7 +484,7 @@
flex: none;
display: flex;
flex-direction: column;
gap: 4px;
gap: 2px;
margin-bottom: 12px;
}

Expand Down Expand Up @@ -522,6 +522,21 @@
outline-offset: -2px;
}

/* The More launcher keeps the panel rows' geometry inside the menu's anchor wrapper. */
.moreAnchor {
display: flex;
flex-direction: column;
}

.panelRow[aria-expanded='true'] {
background: var(--dsw-alias-interactive-bg-hover);
}

.moreMenu {
width: 288px;
max-width: calc(100vw - 24px);
}

.panelGlyph {
flex: none;
display: inline-flex;
Expand Down
Original file line number Diff line number Diff line change
@@ -1,12 +1,13 @@
inject: (sessionId: SessionId, actions: BoundActions<typeof conversationStore>): ConversationSessionHeaderInjected => {
bindSessionViewActions(sessionId, actions)
return {
hooks: { conversationViews },
hooks: { conversationViews, entryPins: viewPins.unpinned, entryActions: viewActions },
setPinned: viewPins.setPinned,
open: (id) => { workspaceNavigation.openSession(id) },
selectView: (view) => {
activateView(sessionId, view)
actions.setView(view)
selectedView(sessionId).set(view)
},
}
},
},
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
inject: (sessionId: SessionId, actions: BoundActions<typeof conversationStore>): ConversationSessionHeaderInjected => ({
hooks: { conversationViews },
hooks: { conversationViews, entryPins: viewPins.unpinned, entryActions: viewActions },
setPinned: viewPins.setPinned,
open: (id) => { workspaceNavigation.openSession(id) },
selectView: (view) => {
activateView(sessionId, view)
actions.setView(view)
},
}),
}),
Original file line number Diff line number Diff line change
@@ -1,2 +1,32 @@
const visibleTabs = hideChrome ? tabs.filter(tab => tab.id === 'chat' || tab.id === 'deepviewer-map') : tabs
const showTabs = visibleTabs.length > 1
const showTabs = hideChrome
? tabs.filter(tab => tab.id === 'chat' || tab.id === 'deepviewer-map').length > 1
: tabs.length > 1
const tabRow = useRef<HTMLDivElement>(null)
const [visibleViewLimit, setVisibleViewLimit] = useState(1)
// Observe only the available row width; individual tabs are not measured.
useLayoutEffect(() => {
const row = tabRow.current
if (row === null || !hasEntryActions) return
const updateLimit = (): void => {
setVisibleViewLimit(Math.max(1, Math.floor((row.clientWidth - 48) / 120)))
}
updateLimit()
if (typeof ResizeObserver === 'undefined') return
const observer = new ResizeObserver(updateLimit)
observer.observe(row)
return () => { observer.disconnect() }
}, [showTabs, hasEntryActions])
const { visibleTabs, moreTabs } = useMemo(() => {
// Synapse blank chrome keeps Chat and Map outside More truncation.
if (hideChrome) {
const mapTabs = tabs.filter(tab => tab.id === 'chat' || tab.id === 'deepviewer-map')
return { visibleTabs: mapTabs, moreTabs: [] as typeof tabs }
}
const preferred = [
...tabs.filter(tab => tab.id === FIXED_VIEW_ID),
...tabs.filter(tab => tab.id !== FIXED_VIEW_ID && !unpinned.includes(tab.id)),
]
const shown = hasEntryActions ? preferred.slice(0, visibleViewLimit) : preferred
const visibleIds = new Set(shown.map(tab => tab.id))
return { visibleTabs: shown, moreTabs: tabs.filter(tab => !visibleIds.has(tab.id)) }
}, [tabs, unpinned, hasEntryActions, visibleViewLimit, hideChrome])
Loading
Loading