Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

fix(docs): add DeepSeek Harness to installation table (#231)

Wang Hao199360cc6687
diff --git a/README.md b/README.md
index 94d05de6..ffbb93e6 100644
--- a/README.md
+++ b/README.md
@@ -262,7 +262,7 @@ The complete generation and viewer contract lives in [`archify/SKILL.md`](archif
| **opencode** | `~/.config/opencode/skills/`, `.opencode/skills/`, or `.agents/skills/` | Full renderer + validation workflow |
| **Claude.ai** | Upload `archify.zip` under Settings → Capabilities → Skills | Depends on Node.js access in the sandbox |
| **Project Knowledge** | Upload `archify.zip` to the project | Prompt-driven architecture fallback |
-**DeepSeek Harness:** Community integration, not an official DeepSeek product; developer-preview `@deepseek-ai/[email protected]`, Node `^22.19.0 || >=24.0.0`. Install: `dsh plugin --profile web add @tt-a1i/[email protected]`; invoke: `Use the archify skill to map this repository's runtime architecture.`; remove: `dsh plugin --profile web remove @tt-a1i/archify-dsh`. No telemetry. Shell files need exact workspace paths, not Web Produced Files. [Details](integrations/deepseek-harness/README.md).
+| **DeepSeek Harness** | Opt-in: `dsh plugin --profile web add @tt-a1i/[email protected]`. Invoke: `Use the archify skill to map this repository's runtime architecture.` Remove: `dsh plugin --profile web remove @tt-a1i/archify-dsh`. | Community integration for developer-preview `@deepseek-ai/[email protected]`; Node `^22.19.0 \|\| >=24.0.0`; not an official DeepSeek product. No telemetry. Shell files need exact workspace paths, not Web Produced Files. [Details](integrations/deepseek-harness/README.md). |
## Reference and scope
diff --git a/README_EN.md b/README_EN.md
index 94d05de6..ffbb93e6 100644
--- a/README_EN.md
+++ b/README_EN.md
@@ -262,7 +262,7 @@ The complete generation and viewer contract lives in [`archify/SKILL.md`](archif
| **opencode** | `~/.config/opencode/skills/`, `.opencode/skills/`, or `.agents/skills/` | Full renderer + validation workflow |
| **Claude.ai** | Upload `archify.zip` under Settings → Capabilities → Skills | Depends on Node.js access in the sandbox |
| **Project Knowledge** | Upload `archify.zip` to the project | Prompt-driven architecture fallback |
-**DeepSeek Harness:** Community integration, not an official DeepSeek product; developer-preview `@deepseek-ai/[email protected]`, Node `^22.19.0 || >=24.0.0`. Install: `dsh plugin --profile web add @tt-a1i/[email protected]`; invoke: `Use the archify skill to map this repository's runtime architecture.`; remove: `dsh plugin --profile web remove @tt-a1i/archify-dsh`. No telemetry. Shell files need exact workspace paths, not Web Produced Files. [Details](integrations/deepseek-harness/README.md).
+| **DeepSeek Harness** | Opt-in: `dsh plugin --profile web add @tt-a1i/[email protected]`. Invoke: `Use the archify skill to map this repository's runtime architecture.` Remove: `dsh plugin --profile web remove @tt-a1i/archify-dsh`. | Community integration for developer-preview `@deepseek-ai/[email protected]`; Node `^22.19.0 \|\| >=24.0.0`; not an official DeepSeek product. No telemetry. Shell files need exact workspace paths, not Web Produced Files. [Details](integrations/deepseek-harness/README.md). |
## Reference and scope
diff --git a/README_ZH.md b/README_ZH.md
index ffc404b4..1676447e 100644
--- a/README_ZH.md
+++ b/README_ZH.md
@@ -258,12 +258,12 @@ node bin/archify.mjs deliver workflow examples/agent-tool-call.workflow.json /tm
| **opencode** | `~/.config/opencode/skills/`、`.opencode/skills/` 或 `.agents/skills/` | 完整 Renderer + Validation 工作流 |
| **Claude.ai** | Settings → Capabilities → Skills 中上传 `archify.zip` | 取决于沙箱是否提供 Node.js |
| **Project Knowledge** | 把 `archify.zip` 上传到项目 | Prompt 驱动的 Architecture Fallback |
+| **DeepSeek Harness** | 显式启用:`dsh plugin --profile web add @tt-a1i/[email protected]`;调用:`Use the archify skill to map this repository's runtime architecture.`;卸载:`dsh plugin --profile web remove @tt-a1i/archify-dsh`。 | 面向开发者预览版 `@deepseek-ai/[email protected]` 的社区集成;Node `^22.19.0 \|\| >=24.0.0`;不是 DeepSeek 官方产品。没有遥测;shell 文件不会自动进入 Web Produced Files,请返回精确工作区路径。[详情](integrations/deepseek-harness/README.md)。 |
+
Claude.ai 中的上传入口:
![Claude Skills 设置](docs/assets/claude-skills-settings.png)
-**DeepSeek Harness:** 面向开发者预览版 `@deepseek-ai/[email protected]` 的社区集成,不是 DeepSeek 官方产品;Node `^22.19.0 || >=24.0.0`。安装:`dsh plugin --profile web add @tt-a1i/[email protected]`;调用:`Use the archify skill to map this repository's runtime architecture.`;卸载:`dsh plugin --profile web remove @tt-a1i/archify-dsh`。没有遥测;shell 文件不会自动进入 Web Produced Files,请返回精确工作区路径。[详情](integrations/deepseek-harness/README.md)。
-
## 参考与边界
- [Schema 说明](archify/schemas/README.md)
diff --git a/archify/test/readme-showcase.test.mjs b/archify/test/readme-showcase.test.mjs
index 708ab27a..cff3055f 100644
--- a/archify/test/readme-showcase.test.mjs
+++ b/archify/test/readme-showcase.test.mjs
@@ -135,6 +135,27 @@ test('all README languages keep the product hero and retain the verified animate
);
});
+test('README installation tables contain a complete DeepSeek Harness row', () => {
+ for (const filename of ['README.md', 'README_EN.md', 'README_ZH.md']) {
+ const readme = fs.readFileSync(path.join(repoRoot, filename), 'utf8');
+ const row = readme.split('\n').find((line) => line.startsWith('| **DeepSeek Harness** |'));
+ assert.ok(row, `${filename}: DeepSeek Harness must be an installation table row`);
+ assert.equal(
+ (row.match(/(?<!\\)\|/g) || []).length,
+ 4,
+ `${filename}: DeepSeek Harness must have exactly three table cells`,
+ );
+ assert.ok(
+ row.includes('Node `^22.19.0 \\|\\| >=24.0.0`'),
+ `${filename}: Node version pipes must be escaped inside the table row`,
+ );
+ assert.ok(
+ readme.includes(`${row}\n\n`),
+ `${filename}: installation table must end after the DeepSeek Harness row`,
+ );
+ }
+});
+
test('README demos use checked-in captures and live deep links below the existing hero', () => {
const demos = [
{
diff --git a/integrations/deepseek-harness/test/docs-contract.test.mjs b/integrations/deepseek-harness/test/docs-contract.test.mjs
index 49231baa..a878c3b4 100644
--- a/integrations/deepseek-harness/test/docs-contract.test.mjs
+++ b/integrations/deepseek-harness/test/docs-contract.test.mjs
@@ -29,7 +29,7 @@ test('English and Chinese docs cover install, invoke, uninstall, community wordi
for (const source of [english, chinese, read('README.md'), read('README_ZH.md')]) {
assert.match(source, /@tt-a1i\/archify-dsh@0\.1\.0/);
assert.match(source, /@deepseek-ai\/dsh@0\.1\.0-rc\.6/);
- assert.match(source, /\^22\.19\.0 \|\| >=24\.0\.0/);
+ assert.match(source.replaceAll('\\|', '|'), /\^22\.19\.0 \|\| >=24\.0\.0/);
assert.match(source, /dsh plugin --profile web add @tt-a1i\/archify-dsh@0\.1\.0/);
assert.match(source, /dsh plugin --profile web remove @tt-a1i\/archify-dsh/);
assert.match(source, /Use the archify skill to map this repository's runtime architecture/);